|
|
|
|
|
|
|
|
|
|
- Overview
- Opening the project from SCM (1st project opening only)
- Working on a project found in the Source Code Manager
- Project options related to the SCM
- Working on a shared project in the SCM
- The different check-out modes
- Management mode of project
- Managing the project in Master/Guest mode
- Managing the project in automatic mode
- Special cases
- Modifying the analysis
- Changing computer
SCM: Working with the Source Code Manager
The principle for working with the Source Code Manager is as follows: - All the developers work on a local copy of the project. This project and all its elements are read-only by default.
- By default, when a project element is opened, it is read-only.. To modify it, it must be checked out from the Source Code Manager, modified and checked back in.
- Only the master can modify the characteristics of the project (analysis, project description, etc.).
Note: The SCM can only be used with operating systems that support data files larger than 4 GB. If the SCM repository is in HFSQL Client/Server mode, the SCM can be used with these operating systems (on the client computers). This help page explains how to work with a project found in the SCM. For more details on the SCM, see Creating a repository. Opening the project from SCM (1st project opening only) Working on a project found in the Source Code Manager To work on a project found in the Source Code Manager: - You must get a local copy of the project found in the Source Code Manager. To do so, open the project from the Source Code Manager.
This operation must be performed once only by each developer who uses the project. The developer who added the project to the Source Code Manager has no operation to perform.
Important: do not locally copy all the files using Windows explorer. - Expand
 in the quick access buttons and select "Open a project from the SCM".
Note: You can also open a project hosted in the SCM from the home page. - In the wizard, specify:
- the path of the repository (network computer or shared directory)
- the username and password (if necessary).
- Select the directory of the repository that corresponds to the desired project.
- Specify the local directory into which the project will be copied.
- Confirm. The project is copied locally and it is automatically opened according to the mode specified when it was checked into the repository.
Note: Projects hosted in the SCM only require these operations the first time. To open the project afterwards, simply open the project file (".WDP" file) corresponding to the local copy. Project options related to the SCM Several options are available to configure a project handled by the Source Code Manager. These options can be found in the "SCM" tab of the project description. These options are checked by default.
Reminder: To open the project description, go to the "Project" tab, "Project" group and click "Description". - Suggest getting the latest version of the elements when the project is opened:
When opening a project located in the SCM, this option prompts you to get the latest version of the project elements. By default, the latest version of the elements is automatically retrieved. - Suggest checking the elements back in when the project is closed:
When the project is closed, this option displays a list of the checked out elements to check some or all of them back in.
By default, when the project is closed, the checked out elements are not checked back in. - Check out/Check in the project automatically:
This option is used to automatically manage the "project file". This option removes the need to manage the project using "Master/Guest" roles.
If this option is checked: - The project file is checked out only if the action performed requires it.
- Once the action was performed on the project, the check-in of the project file is automatically proposed.
If the option "Automatically check the project back in at the end of operation" was checked during the check-out, the project file is automatically checked back in (without confirmation window).
Tip: Alternatively, you can go the "SCM" tab, "Project" group, expand "Master/Guest" and select "Manage project check-out automatically".
Working on a shared project in the SCM To handle the elements of a project found in the SCM, you must: The different check-out modes The SCM includes two modes to check out the project elements: - Standard mode: If you view an element from the SCM that has not been checked out, a message indicates that this element must be checked out in order to be modified. The element can be checked out immediately (check-out button found in the dialog box).
- Automatic mode: When you try to modify an element that has not been checked out, the SCM automatically prompts you to check it out. Once the check-out is validated, the element can be modified.
Note: this mode is not recommended when using the SCM with a slow Internet connection.
The check-out mode of the SCM elements is an option of WINDEV, WEBDEV and WINDEV Mobile. To change the check-out mode: - On the "Home" tab, in the "Environment" group, expand "Options" and select "WINDEV/WEBDEV/WINDEV Mobile general options".
- Select the "General" tab. The "Check out elements during the first modification" option is used to switch all the projects opened from the current product to the automatic mode.
Note: In this version, automatic mode is supported for windows, pages, queries and reports. Management mode of project Two management modes are available with the SCM: Managing the project in Master/Guest mode The Source Code Manager distinguishes between 2 types of users: - the master: the master is the user who placed the project in the Source Code Manager.
- the guests: the guests are the developers who handle the project from the Source Code Manager.
There is no need to be connected in master mode on a project. The "Master" mode is only required to: - change the project characteristics and check these changes back into the repository.
- check in all the elements to create the executable and the setup program of the application.
To switch from master mode to guest mode, go to the "SCM" tab, "Project" group, expand ""Master/Guest"" and select "Become guest on the project (and check all in)".
In this case, the Source Code Manager proposes to check in all the elements of the project (including the .WDP file). To switch from guest mode to master mode, go to the "SCM" tab, "Project" group, expand "Master/Guest" and select "Become master on the project". Changing the project options
All project users (master or guests) can change the project characteristics (first window of the project, animation, code style, etc.).
However, only the project master will be able to check these changes back into the Source Code Manager.
Changes made by a guest will be lost when the project is updated from the repository. Managing the project in automatic mode With the automatic mode, the project file is checked out only if the action performed requires it (regardless of the user). Once the actions have been completed in the project, the project file is automatically checked back in. This mode removes the need to manage the project using "Master/Guest" roles. To enable the automatic mode: - Open the project description: On the "Project" tab, in the "Project" group, click "Description".
- On the "SCM" tab, check "Check out/Check in the project automatically".
Modifying the analysis The analysis is opened in read-only mode by default. Therefore, it cannot be modified. To modify the analysis, it must be checked out. To check out the analysis: - Open the analysis in the data model editor.
- Click the "Check out" button in the SCM toolbar.
- Validate the analysis check-out. The analysis is opened in modification mode. It can be modified.
Changes made to the analysis may affect different elements in the project (pages, windows, reports, etc.). Before generating the analysis, we recommend that you get the latest version of all the project elements. Indeed, the checked-out elements cannot be modified and therefore they cannot be synchronized with the analysis. Therefore, make sure that: - all the project elements are checked in,
- the latest version of the project elements is found on the computer where the analysis is generated.
Changing computer If you have to change your computer (or the name of your computer), everything must be checked back in via the SCM administrator BEFORE changing computer.
To start the SCM administrator, go to the "SCM" tab, "Repository" group, expand "Manage" and select "SCM administrator".
This page is also available for…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|