Integration with Other Applications > Integrated Software Management > Software Configuration Management Integrations > Adapters Configuration Management for Users > Adapters Administration Utility > Working with IBM Rational ClearCase Adapters > Managing Context Associations > Customizing Context Associations to an Adapter
  
Customizing Context Associations to an Adapter
This procedure explains how to customize the context associations to an IBM Rational ClearCase adapter.
For information about the type of context associations adapters can have, see Managing Context Associations to Adapters.
1. From Products > Utilities, Projects > Utilities, or Libraries > Utilities select Adapters Administration in the System Administration section of the page to open the Adapters Administration window.
2. In the Adapter Definition table, select the IBM Rational ClearCase adapter and click Associate Objects to open the Adapter Associations window.
* 
The Adapter Associations window lists the Adapter Name and Adapter Type of the adapter. The Adapter Associations table lists the context associations of the adapter that your Windchill Site or Organization administrator set up for the IBM Rational ClearCase adapter.
3. In the Adapter Associations table, click the Reference Type pull-down list for a selected context.
a. Select All to associate all available views of the adapter for this context. Go to step 5 if you want to configure a view or a config spec. Otherwise, go to step 6.
b. Select View to associate one or more views of the adapter for this context. Go to step 4.
c. Select Config Spec, if you want to add, customize, or remove the config spec for the adapter. Go to step 5.
4. If you selected View in step 3:
a. Click Configure Views in the Default reference Object field of the selected context to open the Views Specification window.
b. Select one or more views you want to associate with this context.
c. When finished, click OK to load and save your selections. The Adapter Associations window opens.
d. Click OK to load and save the selections. The Adapters Administration window opens.
5. If you selected All in step 3, or if you selected Config Spec in step 3:
a. Click Configure Views in the Default reference Object field of the selected context to open the Configuration Specifications window.
b. To add a new Config Spec:
a. In the Configuration Specifications table, click Add a Config Spec to open the New Configuration Specification window.
b. Enter the following information:
Action
Description
Name
Enter a unique name for the configuration specification. The configuration specification name can have alphanumeric, dot, dash, and underscore characters only.
* 
When creating multiple adapter config specs, do not use identical config spec names. This results in not being able to differentiate between multiple config specs in the system.
Description
Enter a description for the config spec.
Label
Add IBM Rational ClearCase adapter version labels by typing the name of the label in the Labels table and clicking Add . Repeat for each label you want to assign to this configuration specification.
* 
The Labels table is essentially an ordered list of labels. You enter which labels you want to use for the adapter config spec.
The system does not currently check with IBM Rational ClearCase to ensure that the entered label names are valid. Therefore you must verify that the entered label names are correct. An incorrectly entered label name possibly returns no results when browsing IBM Rational ClearCase from Windchill
If you are working with multiple labels, the labels towards the top of the list take precedence over the labels toward the bottom of the list. If several labels reference different versions of the same object, then the object version referenced by the highest label on the list is used.
c. To change the order of the labels in the list, select the label to reposition. Click the action in the Labels table.
Label Table
Action
Description
Moves the label to the top of the table.
Moves the label to the bottom of the table.
Moves the label up one row in the table.
Moves the label down one row in the table.
d. When finished, click OK to load and save the changes. The Configuration Specifications window opens.
e. If finished, click Close to return to the Adapter Associations window. Click Close to exit.
c. To edit a Config Spec:
a. In the Configuration Specifications table, click Edit Config Spec to open the Edit Configuration Specification window.
b. To add or update the description, type the information in the Description field.
c. To delete an unwanted version label, click Remove in the Labels table.
d. Add version labels by typing the name of the label in the Labels table and clicking Add. Repeat for each label you want to assign to this configuration specification.
* 
The Labels table is essentially an ordered list of labels. You enter which labels you want to use for the adapter config spec.
The system does not currently check with IBM Rational ClearCase to ensure that the entered label names are valid. Therefore you must verify that the entered label names are correct. An incorrectly entered label name possibly returns no results when browsing IBM Rational ClearCase from Windchill
If you are working with multiple labels, the labels towards the top of the list take precedence over the labels toward the bottom of the list. If several labels reference different versions of the same object, then the object version referenced by the highest label on the list is used.
e. To change the order of the labels in the list, select the label to reposition. Click the action in the Labels table.
Label Table
Action
Description
Moves the label to the top of the table.
Moves the label to the bottom of the table.
Moves the label up one row in the table.
Moves the label down one row in the table.
f. When finished, click OK to load and save the changes. The Configuration Specifications window opens.
g. If finished, click Close to return to the Adapter Associations window. Click Close to exit.
d. To delete a Config Spec:
a. In the Configuration Specifications table, click Delete to remove the selected configuration specification.
b. The system responds with the message, “Are you sure you want to remove this config spec?”
c. Click OK to delete the config spec, or Cancel to abort the request.
d. If finished, click Close to return to the Adapter Associations window. Click Close to exit.
e. If you have additional contexts to configure, go to step 3 to configure the Reference Type and to follow the instructions in this step.
f. If you do not have additional contexts to configure, click Close to exit. The Adapter Associations window opens.
6. Click Close to exit. The Adapters Administration window opens.