Adding version control labels to objects

You can add version control labels to any object listed in the object modification log (the AR System Version Control: Object Modification Log form).

You can add version control labels only to the current version of the object. You cannot add them to earlier versions, even if those versions are listed in the log.

Each version of an object can have multiple version control labels.

Each version control label can be added to multiple objects.

To enable version control labeling

1. On the Version Control tab of the AR System Administration: Server Information form, set the following options:
   • Set Object Modification Log to Enabled.
   • Set Save Definition Files to Yes.
     See Setting version control options.
2. Click OK.

To add a version control label to a new object

When you save an object for the first time, enter a version control label name and, optionally, a label description in the Save objectType As dialog box:

(Click the image to expand it.)


To use an existing label, select it from the Version Control Label list.

To add a version control label to one or more existing objects

1. In BMC Remedy Developer Studio, open the appropriate object list.
2. Select one or more objects.
3. Right-click one of the selected objects, and select Add Version Control Label.
4. In the Add Version Control Label dialog box, enter the label name in the Version Control Label field.
   The name can have up to 254 characters. It must be unique on the server.
5. (Optional) In the Label Description field, enter a description that explains why objects are grouped under this label.
   For example, they might be part of a particular product build.
6. Click OK.
7. Click OK in the confirmation message.

To add a version control label to all objects on a server

1. In BMC Remedy Developer Studio, right-click the appropriate server in the AR System Navigator, and select Add Version Control Label.
2. In the Add Version Control Label dialog box, enter the label name in the Version Control Label field.
   The name can have up to 254 characters. It must be unique on the server.
3. (Optional) In the Label Description field, enter a description that explains why objects are grouped under this label.
   For example, they might be part of a particular product build.
4. Click OK.
5. Click OK in the warning message.

   Warning

   If an object on the server does not have at least one entry in the AR System Version Control: Object Modification Log form, a version control label is not added to it.

To add a version control label to all objects imported in a definition file

During the import process, enter a label name and, optionally, a label description in the Import File page of the Import wizard:

(Click the image to expand it.)


To use an existing label, select it from the Version Control Label list.
For more information about importing definition files, see Importing and exporting object definitions and locking objects.

Label name limitations

If you use the following characters in a version control label name, the search results for the label might be inaccurate.