CLion 2018.3 Help

TFS Check-in Policies

A check-in policy is a rule that is executed before every check-in to ensure that the selected changeset is OK to commit. Standard policies are stored on the server and are executed on the client machines.

Custom policies are implemented as custom plugins to CLion. The IDs of these plugins are stored on the server, while the policies themselves are applied locally. Therefore, to enable the use of a policy in a team, all the team members should install the corresponding plugin.

To define the default policy settings to be applied at the CLion level

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), click TFS under Version Control.

  2. On the TFS page, that opens, select the applicable checkboxes in the Checkin policies compatibility area.
    • Evaluate Team Explorer policies: select this checkbox to have the Microsoft Team Explorer policy definitions installed and executed on the client machine.

    • Evaluate Teamprise policies: select this checkbox to have the Teamprise policy definitions installed and executed on the client machine.

    • Warn about not installed policies: select this checkbox to have warnings displayed in case the specified policy definition is not installed.

To suppress applying the default check-in policy settings to a project

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), click TFS under Version Control.

  2. On the TFS page, that opens, click the Manage button in the Servers and Workspaces area.

  3. In the dialog box, that opens, select the project in question from the Team project drop-down list.

  4. In the Compatibility area, select the Override default settings for team project <project name> checkbox.

  5. Re-define the default settings by selecting or clearing the corresponding checkboxes below.
    • Evaluate Team Explorer policies: select this checkbox to have the Microsoft Team Explorer policy definitions installed and executed on the client machine.

    • Evaluate Teamprise policies: select this checkbox to have the Teamprise policy definitions installed and executed on the client machine.

    • Warn about not installed policies: select this checkbox to have warnings displayed in case the specified policy definition is not installed.

To manage the list of available policies

The list of available policies consists of standard third-party policies and custom, user-defined policies.

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), click TFS under Version Control.

  2. On the TFS page, that opens, click the Manage button in the Servers and Workspaces area.

  3. In the dialog box, that opens, select the required workspace and click the Checkin Policies button.

  4. In the dialog box, that opens, configure the list of policies:
    • To activate a policy, select the Enabled checkbox next to it.

    • To suppress a policy, clear the Enabled checkbox next to it.

    • To discard a policy permanently, select it in the list and click the Remove button.

To introduce a custom check-in policy

  1. Implement the required policy as a custom plugin.

  2. Download, install, and enable the plugin as described in Plugins.

Last modified: 14 February 2019

See Also