PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • How to proceed?
  • Defining a check-in policy
  • Operating mode of check-in policy
  • Storing and handling the check-in policy
  • Details of the different rules
  • General tab
  • Automatic Tests tab
  • Code Metrics tab
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
The SCM gives you the ability to define a check-in policy. All you have to do is define the criteria that must be complied with in order for a project element to be checked back in into the SCM database. Among the possible criteria:
  • No compilation error,
  • Run at least one test of the element, ...
These rules can be mandatory or not. If a rule is not complied with, the developer may be required to provide an explanation.
How to proceed?

Defining a check-in policy

To define a check-in policy:
  1. Select "SCM .. Check-in policy".On the "SCM" pane, in the "Database" group, expand "Manage" and select "Check-in policy".
  2. Select the rules that must be respected by the checked-in elements. These rules are grouped in three tabs: "General", "Automatic tests" and "Code metrics".
  3. Specify the options of the check-in policy:
    • Versions 19 and later
      Always ignore the rules on the project (wdp): Used to ignore the rules when handling the project file (wdp file).
      New in version 19
      Always ignore the rules on the project (wdp): Used to ignore the rules when handling the project file (wdp file).
      Always ignore the rules on the project (wdp): Used to ignore the rules when handling the project file (wdp file).
    • Ability to ignore the rules
    • Mandatory input of a comment in case of broken rule.
  4. Validate. The check-in policy is automatically taken into account for the current project.
Note: The check-in policy can also be defined from the SCM administrator ("Check-in policy" from the popup menu of a project).

Operating mode of check-in policy

The following screen is displayed if the checked-in element does not comply with the check-in policy defined for the project:
This screen lists the criteria that are not fulfilled by the checked-in element.
If the user is allowed to ignored the rules, he has the ability to check "Check in even so".
If an explanation must be entered, the validation button of this window will be ungrayed only when the comment is entered in the corresponding area.
The "Edit the policy" button allows you to edit and modify (if necessary) the rules defined for the check-in policy.

Storing and handling the check-in policy

The check-in policy is stored in the "CheckInPolicy.scm" file found at the root of the project directory. This file is found in the SCM as all the project files. This file can be shared among several projects.
Specific rights can be assigned to the file corresponding to the check-in policy (to allow the project manager to modify this file for example).
If the "CheckInPolicy.scm" file is found in the parent directory, all the newly created projects will use this check-in policy.
Tip: For a branch, you have the ability to define a more restrictive check-in policy.
Details of the different rules

General tab

The check-in rules proposed by the "General" tab are as follows:
  • No compilation error: To be checked-in, the element must include no compilation error.
  • No compilation warning: To be checked-in, the element must include no compilation warning.
  • No compilation information: To be checked-in, the element must include no compilation information.
  • The checked-in element must be associated with a task or with an incident.
  • A comment must be entered during the check-in operation.
  • The project test (GO) must have been run at least once after a modification.

Automatic Tests tab

The check-in rules proposed by the "Automatic tests" tab are as follows:
  • Each element must include at least 1 automatic test. Caution: if this option is selected, it applies to all the elements, even to the project file (".WDP") that contains the initialization code of the project.
  • No automatic test in error.

Code Metrics tab

The "Code metrics" tab is used to enter the minimum percentage level to respect for code comments.
Minimum required version
  • Version 12
This page is also available for…
Comments
Click [Add] to post a comment