PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
New WEBDEV 24 feature!
  • This lesson will teach you the following concepts
  • Integrating a project in SCM
  • Adding the project into SCM
  • Opening a project from SCM
  • Configuring SCM
Lesson 12.2. Integrating a project in SCM
This lesson will teach you the following concepts
  • Adding a project into SCM.
  • Opening a project from SCM.
  • Configuring SCM.

Estimated time: 15 mn
Previous LessonTable of contentsNext Lesson
Integrating a project in SCM

Adding the project into SCM

To use an existing project with the Source Code Manager, simply include it in the repository.

Answer

If you did not perform the operations in the previous lessons, you can follow this lesson by opening a corrected project: in the WEBDEV home page (Ctrl + <), click "Tutorial" and select "Full WEBDEV Site (Answer)".
  • We are now going to include the "Full_WEBDEV_Site" project in the repository:
    1. In the ribbon, go to "SCM", "Add the project" and click "Add the project into SCM". The wizard for adding projects into a repository starts:
      The repository was not created yet. We are going to create one.

      Note

      We are going to create a “Client/Server” repository on the server that was installed in part 11. Please read this part carefully if you haven't already!
    2. Click on "Create a repository".
    3. The repository creation screen is displayed.
      The repository can be in HFSQL Classic format (local or network) or in HFSQL Client/Server format. We are going to create a repository in HFSQL Client/Server format.

      Note

      If the repository is in HFSQL Client/Server format, it can be used remotely.
    4. Select "Creation in HFSQL Client/Server mode".
    5. Specify the parameters of the HFSQL server that was installed beforehand:
      • The name of the server, its port.
      • The name of the administrator, his possible password.
    6. Validate the creation of the repository ("Create the repository"). This operation can take quite a long time in Client/Server mode.
    7. The repository has now been created. We are going to include our project in this repository.
    8. Go to the next step. The current user is not saved in the database of users of HFSQL server.
      We are going to create this user: click the "Create the account" button.
    9. The wizard proposes to locate the project in the "WEBDEV projects" subdirectory of the repository.
      Accept this location. Go to the next step.
    10. The wizard asks you to select the project elements that will be added into the repository.
      We want to add all project elements. Go to the next step.
    11. The wizard asks you to select the project dependencies that will be added into the repository. These dependencies correspond to all external elements required by the project (images, style sheets, etc.).
      We want to add all project dependencies. Go to the next step.
    12. Validate the project integration in the SCM. The project and its elements have now been added into our repository.

Note

Sharing project elements
When the projects that share the same resources (same analysis, same windows, etc.) are included in the SCM, the relevant elements can be shared between the different projects. Therefore, the same element is checked in once only into the SCM and the modifications are automatically applied to the other projects.

Opening a project from SCM

In our example, the project is integrated in the SCM and it can be used directly.
In a real case, in order for other developers to work on a project found in the Source Code Manager, they must get a copy of this project locally.
To do so, the following operations must be performed:
  1. Open the project from the Source Code Manager: on the "Home" pane, in the "General" group, expand "Open" and select "Open a project from the SCM".
  2. Specify the location parameters of the repository and validate (this step is required only if the current project in the editor does not belong to the SCM):
  3. In the screen that is displayed, specify (if necessary) the connection and the local directory:
    Remark: If the project was already opened from SCM, the SCM proposes to open the project as usual or to overwrite the content (to retrieve the entire project).
This operation must be performed once only by each developer who is using the project.
The developer who added the project into the Source Code Manager (you in this case!) has no operation to perform.

Note

The next openings of a project managed by SCM are identical to the openings of a project not managed by SCM: all you have to do is open the project (".WWP" file) corresponding to the local copy.

Configuring SCM

Before you start working on the elements of project found in the SCM, you must configure the mode for checking out the project elements.
When working on the elements of a project in the SCM, the element must be checked out from the repository before it can be modified, then it must be checked back in once the changes have been made. Therefore, the modified element becomes available to all SCM users.
WEBDEV proposes two modes for checking out the project elements:
  • the standard mode: if you display a SCM element that is not checked out, a panel indicates that the element must be checked out before it can be modified. The element can be checked out immediately (check-out button found in the dialog box).
  • the automatic mode: if you try to modify a SCM element that is not checked out, the SCM automatically proposes to check out this element. Once the check-out is validated, the element can be modified.
    Remark: this mode is not recommended when using SCM with a slow Internet connection.
The automatic check-out will be used in this tutorial.
  • To make sure that the automatic check-out is enabled, on the "Home" pane, in the "Environment" group, expand "Options" and select "General options of WEBDEV". In the "General" tab, check (if necessary) "Check out elements during the first modification".
Previous LessonTable of contentsNext Lesson
Minimum version required
  • Version 24
Comments
Click [Add] to post a comment