Supporting Source Control Software

Nexacro Platform supports the connectivity with revision control software. Features may differ depending on programs.

Subversion (SVN)

Settings for Subversion

If you install a Subversion client, you can select SVN by accessing [Tools > Options > Source Control].

The Subversion client that is supported by Nexacro Studio is "Subversion for Windows." If you use different clients of Subversion, your Nexacro Studio will not activate the SVN option. If you want to learn more about Subversion for Windows, click the below URL.

https://sourceforge.net/projects/win32svn/

Nexacro Studio supports the following options for the use of Subversion.

Option

Description

Check SVN status when opened project

Check file statuses automatically when opening a project.

Update file(s) when opening the project

Load files of latest versions automatically when opening a project.

Commit file(s) when closing the project

Commit checked-out files automatically when closing a project.

Get lock file(s) when edited

Lock files automatically while you are editing the file so that other users are not allowed to make a modification.

Prompt to add file when inserted

Perform the Add command whenever a client creates a file.

Program used for diff

Adopt an external program for comparison of file versions.

You must install a Subversion client to make the SVN option activated. Nexacro Studio identifies the installation of a Subversion client by checking the related entries in Windows Registry.

If the version of Subversion is earlier than 1.6.0, either the SVN option does not appear in Nexacro Studio or some features do not work.

This documentation does not provide a guide for the installation of a Subversion client. You can get related information by following the below link.

http://subversion.apache.org/packages.html

Toolbar

The toolbar in Nexacro Studio provides the below features for Subversion.


Item

Description

Update

Load files of latest versions from the repository.

Commit

Apply modifications to the original files in the repository.

Get Lock

Lock a file while you are editing the file to prevent other users from making a modification.

Release Lock

Release a lock.

Add

Add a new file. You can apply the added file to the repository by performing the Commit command.

Delete

Change the status of a file to "deleted." You can delete the relevant file in the repository by performing the Commit command. The actual file stored in your PC will not be deleted.

Rename

Change a file name. SVN does not have a Rename feature--it indeed deletes the existing file and adds a new file.

Show Log

See the modification history.

Diff with Previous version

Compare two versions. The program adopted as a 'Program used for diff' in [Options] will be executed.

Revert

Return to former status of a file by cancelling the previous task.

Refresh

Refresh the status of a file.

Repository Browser

Execute Repository Browser.

Entering Access Information

Authentication

Enter the information for accessing the repository in order to use Subversion

Item

Description

Username

Enter a user name registered in the server of Subversion.

Password

Enter the user's password.

Repository

Enter the location of the repository.

Save authentication

Save the access information to Windows Registry.

If checked, Nexacro Studio will not ask the access information for the same project.

When loading a project that is not registered in Subversion, the below pop-up will appear to ask you whether to import the project to the repository.

Basic Features

Import

This feature is used to register a new project in the Subversion repository. Import is available only when you select "Yes" at the pop-up dialogue asking you whether to import a new project.

Item

Description

URL of repository

Specify the location of the repository.

Import message

Leave a message concerning the imported project.

Include ignored files

Include files that Subversion is set to ignore.

An imported project will be automatically checked out for the connectivity with Subversion.

Commit

This feature is used to apply user-made modifications to the relevant file in the repository.

Item

Description

Message

Leave a message concerning the committed files.

Changes made

Show a list of files to commit.

Select / deselect all

Select/deselect all the files to commit.

Keep locks

Keep the files to commit locked.

This feature is activated only when the relevant files are in a locked state.

Add

This feature is used to add new files to the repository.

Item

Description

Path

Show a list of files to add.

Select /deselect all

Select/deselect all the files to add.

Performing Add merely puts selected files on the waiting list. Those files are actually added to the repository through the Commit command.

Delete

This feature is used to delete files from the repository.

Item

Description

Item

Show a file to delete.

Keep local item from working copy

Delete the relevant working copy in the user’s PC simultaneously.

Performing Delete merely puts selected files on the waiting list. Those files are actually deleted from the repository through the Commit command.

Rename

This feature is used to change a file name. Rename in fact entails creating a copy of an existing file with a new name and then deleting the original file. Therefore, you cannot see past history of a renamed file. Rename is conducted without any dialogue box appearing.

Update

This feature is used to update working copies in a user's PC based on the latest versions in the repository. The Update command is activated only after SVN statuses of files are verified. This feature does not need extra inputs, only presenting the results of the execution.

Lock

Get Lock

This feature is used to lock selected files in order to grant editing permission only to the user who accesses the files.

Item

Description

Message

Leave a message concerning the locked files.

List

Show a list of files to lock.

Select /deselect all

Select/deselect all the files to lock.

Release Lock

This feature is used to unlock files.

Item

Description

Path

Show a list of files to unlock.

Select /deselect all

Select/deselect all the files to unlock.

Utilizing Log

Log Messages

This feature is used to display a modification log.

Diff with previous version

This feature compares a working copy with one of the previous revisions stored in the repository and shows the differences. This feature will execute a program adopted as a 'Program used for diff' in [Options].

Revert

This feature is used to go back to the former state of a working copy by undoing the previous task.

Item

Description

Path

Show a list of files to revert.

Select /deselect all

Select/deselect all the files to revert.

Refresh

This feature is used to refresh the SVN statuses of working copies.

Repository Browser

This is a tool for a SVN client, which is used to display file lists in the repository and support SVN's features.

Item

Description

URL

Show the path of a repository.

You can access to another repository by specifying the relevant path.

Folder Tree

Show folders in the repository in the form of a tree

File List

Show a list of files located in the current folder.

Right-clicking a repository will display the following context menu.

Item

Description

Show Log

Show a history of the modifications to the repository.

Export

Export selected files to the designated folder in the client PC. The exported files are not checked out yet and thus not connected to the repository.

Checkout

Check out selected files and send them to the designated folder in the client PC.

Refresh

Refresh the information on the folder.

Create Folder

Create a folder under the current repository.

Add File

Add a file from the client PC to the repository.

Add Folder

Add all the files in a selected folder from the


client PC to the designated repository.

Rename

Change the name of a selected repository.

Delete

Delete a selected repository.

Right-clicking a file will display the following context menu.

Item

Description

Show Log

Show a history of the modifications to the file.

Rename

Change the name of a selected file.

Delete

Delete a selected file.

Save as

Create a copy of a selected file.

Subversion Status

Depending on Subversion statuses, Nexacro Studio presents the following overlay icons in the Project Explorer.


Item

Description

No modification

No modification yet to the file

scheduled for addition

Set to be added to the repository

modified

The file has been modified.

scheduled for deletion

Set to be deleted from the repository

Conflict

A conflict has occurred during the process of “Update.”

Ignored

This file type is ignored by Subversion.

Not under version control

Not registered in the repository

CVS

Settings for CVS

If you install a CVS client, you can select CVS by accessing [Tools > Options > Source Control].

Nexacro Studio supports the following options for the use of CVS.

Option

Description

Check CVS status when opened project

Check file statuses automatically when opening a project.

Update file(s) when opening the project

Load files of latest versions automatically when opening a project.

Commit file(s) when closing the project

Commit checked-out files automatically when closing a project.

Prompt to add file when inserted

Perform the Add command whenever a client creates a file.

Program used for diff

Adopt an external program for comparison of file versions.

Toolbar

The toolbar in Nexacro Studio provides the below features for CVS.


Item

Description

Update

Load files of latest versions from the repository.

Commit

Apply modifications to the original files in the repository.

Add

Add a new file or directory.

Diff

Compare two versions. The program adopted as a 'Program used for diff' in [Options] will be executed.

Revert

Return to former status of a file by cancelling the previous task.

Edit

Release a lock.

Unedit

Lock a file while you are editing the file to prevent other users from making a modification.

Editors

Show the current editor of a selected file.

History

Show a log of file modifications as well as user statuses.

Annotate

Show a log of modifications for each line of a source code.

Refresh status

Refresh the status of a file.

Rename

Change a file name.

Remove

Delete a file from the repository.

Import project

Register a project source in the repository.

Checkout

Fetch source codes from the repository to modify them.

Entering Access Information

Authentication

Enter the information for accessing the repository in order to use CVS.

Item

Description

Previous CVSROOTs

Addresses of the repositories that have been accessed

Protocol

Access type

Protocal parameters

Protoco type

User name

User account

Server

Server address

Port

Access port

Repository folder

Repository name

Module name

Module name

Modules on CVS

Clicking the “Fetch list” button will prompt Nexacro Studio to access the server and fetch a list of the files in the repository.

CVS requires authentication when a user imports a new project.

Basic Features

Import Project

This feature is used to register a new project in the CVS repository. This feature is activated only when opening a project that is not registered in the repository. The module name to be entered will be the same as the project name.

You will be prompted to enter your password after entering the access information and clicking the 'OK' button. If you are successfully connected and the project is imported, Nexacro Studio will output the result value on the screen.

If successful, the Import feature will become inactive in the toolbar or menu.

Commit

This feature is used to apply user-made modifications to the relevant file in the repository.

Item

Description

Changes made

Show a list of files to commit.

Message

Leave a message concerning the committed files.

Select / deselect all

Select/deselect all the files to commit.

Add

This feature is used to add new files to the repository.

Item

Description

Path

Show a list of files to add.

Select /deselect all

Select/deselect all the files to add.

Performing Add merely puts selected files on the waiting list. Those files are actually added to the repository through the Commit command.

Remove

This feature is used to delete files from the repository. You must delete the files located in the working folder in your PC to remove the relevant files from the repository.

Rename

This feature is used to change a file name. Rename in fact entails creating a copy of an existing file with a new name and then deleting the original file. Therefore, you cannot see past history of a renamed file. Rename is conducted without any dialogue box appearing.

Update

This feature is used to update working copies in a user's PC based on the latest versions in the repository. This feature does not need extra inputs, only presenting the results of the execution.

Edit

Edit

This feature is used to lock selected files in order to grant editing permission only to the user who accesses the files. The lock will be released automatically after conducting a Commit command.

Unedit

This feature is used to unlock files.

Editors

You can verify who locked certain files.

Utilizing Log

History

This feature is used to display a modification log.

Diff

This feature compares a working copy with one of the previous revisions stored in the repository and shows the differences. This feature will execute a program adopted as a 'Program used for diff' in [Options].

Annotate

This feature allows you to verify latest revisions made to each code line.

Revert

This feature is used to go back to the former state of a working copy by undoing the previous task.

Refresh status

This feature is used to refresh the SVN statuses of working copies.

Check Out

Nexacro Studio displays the file lists in the CVS repository. You can fetch selected projects to the working folder in your PC.

SourceSafe

Settings for SourceSafe

If you install a SourceSafe client, you can select SourceSafe by accessing [Tools > Options > Source Control].

Nexacro Studio supports the following options for the use of SourceSafe.

Option

Description

Check SourceSafe status when opened project

Check file statuses automatically when opening a project.

Get Last Version everything when opening a project

Load files of latest versions automatically when opening a project.

Check in everything when closing a project

Check in all the files automatically when closing a project.

Checked-in item behavior On file open check out automatically

Check out a file automatically when opening the file or view.

Don't automatically login, If you have record the last SourceSafe connect

Log in automatically by saving log-in information for SourceSafe.

Program used for diff

Adopt an external program for comparison of file versions.

You must install Visual SourceSafe to make the SourceSafe option activated. Nexacro Studio identifies the installation of SourceSafe by checking the related entries in Windows Registry.

The SourceSafe option will become active if the installation is successful and the TiScmAdpSourceSafe.dll file is present in the installation folder.

Toolbar

The toolbar in Nexacro Studio provides the below features for SourceSafe.


Item

Description

Change to SourceSafe Database

Enter the path to the db.ini file and create access information.

If there is existing access information, an alert appears asking you to change the information.

Add Project

Add a project to the SourceSafe server.

After adding a project, an xpjscc file whose name is same as the project name ([project name].xpjscc) will be created under the project folder.

Get Last Version

Obtain the latest versions of selected files from the SourceSafe server.

Check Out

Check out selected files in the SourceSafe server.

When executing the check-out command, the server will verify whether other users are working on the selected files. If files are occupied, those files will not be checked out with the presentation of the information on who are working on them.

Check-out comments will be automatically entered again as check-in comments later.

Check In

Check in selected files in the SourceSafe server.

The check-in command will verify the modifications made after the check-out command and apply those changes to the relevant files in the SourceSafe server.

Check Undo

Revert selected files in a user's PC to the states before the check-out. The relevant files in the SourceSafe server will also return to the states before the check-out.

Add To

Add selected files to the SourceSafe server.

Files that are already registered in the server cannot be added.

For instance, newly-created forms or files must be added to the SourceSafe server.

Remove

Delete selected files from the SourceSafe server.

Show History

Show the check-in history of the files registered in the SourceSafe server.

Show Diff

Compare two versions. The program adopted as a 'Program used for diff' in [Options] will be executed.

Refresh status

Verify the database of the SourceSafe server and fetch statuses of selected files. The file statuses will change overlay file icons accordingly while also altering the activated items of the toolbar, menu, and context menu.

Run SourceSafe

Launch a Visual SourceSafe client.

Entering Access Information

Entering Information for Accessing Database

To use SourceSafe, enter information for accessing the relevant database.

Item

Description

User Name

Enter a user name registered in the SourceSafe server.

The user must be also registered in the database connected to SourceSafe.

Password

Enter a password.

The password will not be saved.

DataBase

Enter the path to the SourceSafe database.

You must select the srcsafe.ini file located in the root folder of the database path.

Contents of

Location of a project folder

A project folder will be generated in the root folder of the database path, and you cannot designate a sub- folder under a project folder.

A working folder must correspond to the relevant project path. If not, you cannot obtain the desired result during the editing process.

The information on the last database you accessed will be saved in the [project name].sprjscc file. If the file does not exist, Nexacro Studio will display the database saved in the Windows registry.

Basic Features

Add Project

This feature is used to register a new project in the SourceSafe server. When opening a project, a window appears prompting you to enter database information.

If you are successfully connected to the server, the overlay icons of each file will turn to "+," and the 'Add Project' icon in the toolbar will become activated.

Upon clicking 'Add Project,' you can see a list of files to register in the server. If those files are successfully applied to the server, the overlay icons will turn to check marks.

If you select 'Checkout After Adding to Source Control,' the files will be checked out after being added to the server.

You can find the project added through Visual SourceSafe Explorer.

Check Out

This feature is used to verify whether another user is using a certain file. If not, Nexacro Studio will allow you to work on the relevant file. Before check-out, you can open a file from Nexacro Studio, but not allowed to edit it.

Click the 'OK' button after selecting the files to check out.

You can verify the information on checked-out files through Visual SourceSafe Explorer.

Check In

This feature is used to apply modified files to the SourceSafe server. After check-in, you can open a file from Nexacro Studio, but not allowed to edit it.

Before check-in, you can verify changes that have been made. Clicking the "Differences" button will execute the program adopted as a 'Program used for diff' in [Options] and enable you to compare two file versions.

Add To Source Control

This feature is used to add newly-created files to the SourceSafe server.

If you select 'Checkout After Adding to Source Control,' the added files will be automatically checked out.

Remove

This feature is used to delete selected files from the server. The relevant files in the user's PC will not be deleted, leaving those files unregistered in the server.

Get Last Version

This feature is used to update working copies in a user's PC based on the latest versions in the server. Click the 'OK' button after selecting files to update.

Utilizing Log

Show History

This feature is used to show a log of file modifications. You can adjust the search range by adding search conditions.

Item

Description

Include Labels

Search for items with labels.

Labels Only

Search for items with labels only.

From

Specify the beginning date on the basis of check-in.

To

Specify the end date on the basis of check-in.

User

Specify a user who performed check-in.

You can see the information of each version including modification details and comments. You also can check out a certain version.

Item

Description

Close

Close the window to show a history.

Get

Fetch a selected version from the server.

mDetails

Search for details

Check Out

Fetch a selected version from the server and check it out.

Diff

Compare a selected version with the file in the working folder.

If you select two versions, comparison will be made between the two.

View

Show a selected file in the form of text.

Show Diff

This feature compares a working copy with the corresponding file stored in the server and shows the differences. It will execute a program adopted as a 'Program used for diff' in [Options]. This feature also can be performed by clicking the 'Differences' button seen in the Check In and Check Undo features.

If the working copy and the corresponding file in the server are identical, Nexacro Studio will not execute the linked program.

If there is any difference, you can verify the modifications through the linked program.

Check Undo

This feature is used to revert selected files to the states before the check-out. You cannot leave a comment.

Refresh status

This feature is used to obtain values of the current statuses of selected files. The status values will change overlay file icons accordingly while also altering the activated items of the toolbar, menu, and context menu.

The overlay icons appear as below according to the status values.


Description

The file is in the check-in status.

The file is in the check-out status.

This file is not registered in the SourceSafe server.

You need to register the file through the 'Add To Source Control' feature.

SourceSafe Client

Run SourceSafe

This feature is used to launch a Visual SourceSafe client.