PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • 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, all you have to do is include this project in the SCM database.

Answer

If you did not perform the operations in the previous lessons, you can follow this lesson by opening a corrected project: on the "Home" pane, in the "Online help" group, expand "Tutorial" and select "Full WEBDEV site (Answer)"
  • We are now going to include the "Full_WEBDEV_Site" project in the SCM database:
    1. In the ribbon, on the "SCM" pane, in the "Project" group, click "Add the project". The wizard for adding projects into the SCM starts:
      The SCM database was not created yet. We are going to create one.

      Note

      We are going to create a “Client/Server” SCM database on the server that was installed in part 10. If you did not follow this part, you must follow the part!
    2. Click the "Create a database" button.
    3. The screen used to create the database is displayed.
      The SCM database can be in HFSQL Classic format (local or network) or in HFSQL Client/Server format. We are going to create a SCM database in HFSQL Client/Server format.

      Note

      If the SCM database is in HFSQL Client/Server format, then this SCM database can be used remotely.
    4. Select "Creation in HFSQL Client/Server mode".
    5. Specify the parameters of the 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 SCM database ("Create the database" button). This operation can take quite a long time in Client/Server mode.
    7. The SCM database is now created. We are going to include our project in this SCM database.
    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 place the project in the "WEBDEV projects" sub-directory of SCM database.
      Accept this location. Go to the next step.
    10. The wizard asks you to select the project elements that will be added into the SCM database.
      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 SCM database. These dependencies correspond to all external elements required by the project (images, style sheets, ...).
      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 SCM database.

Note

Sharing project elements
When the projects that share the same resources (same analysis, same windows, ...) 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 SCM".
  2. Specify the location parameters of SCM database 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:
    Note: 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 found in SCM, the element must be checked out from the SCM database before it can be modified, then it must be checked back in once the modifications have been performed. 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.
    Note: 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 23
Comments
Click [Add] to post a comment