Extending the Windchill Schema

The connection between Windchill™ Containers (Products and Libraries) and one or more IBM Rational Team Concert Project Areas are stored within an additional Windchill attribute of the Product or Library instance. Therefore the Windchill schema is altered.

Likewise, links from Windchill ChangeRequests to RTC Work Items are stored into an attribute of each ChangeRequest instance.

The type for these additional Windchill Product and ChangeRequest attributes is defined using a new Windchill Global Attribute. (Windchill’s global attributes can easily be added to the Windchill schema of various resources).

Note that as you perform these steps, some Windchill pages use Java applets. Make sure to review the tips in the Configuring Java Settings section to successfully follow the procedures. As of Windchill 11, these Windchill Java applets are fewer in appearance yet a few do still remain.

The process steps are:

Create the Global Attribute

  1. Log into Windchill as Site admin (typically named wcadmin in Windchill).
  2. Browse to the home screen of an installed Windchill web application http://windchill.acme/Windchill/app/.
  3. Expand the menu on the left hand side, click on the Site icon, and then click Utilities
  4. Click Type and Attribute Management
  5. In the Type and Attribute Management page, click on Manage Reusable Attributes
  6. Click on the “New Organizer” icon to create a New Attribute Organizer (Advice: Use capital letters for name, e.g. “RLIA ORGANIZER”)
  7. Click OK
  8. Click on the “New Attribute” icon to add a reusable attribute.
  9. Enter required details including:
  10. Click OK.
  11. Close the window to return to the Type and Attribute Management page.

Create the Product Attribute

  1. Select the type Product in the Manage Types list.
  2. Click on Actions > Edit.
  3. In the Attributes tab, click Create a new attribute
  4. Choose an Internal name [ * ] and select Type: Global
  5. Click Next
  6. Scroll down to select the global attribute you created in previous step, then click Next
  7. Input Field type must be set to Multiple Lines.
  8. Click Finish.

[ * ] Important: It is mandatory that the Internal name chosen here matches the value you enter in the Servlet Manager’s context property oslc-windchill.windchill.attribute.product.relatedResource. See Configuring the Windchill adapter properties for more details.

The Product Screen for a new Product within the Windchill web application as seen in a typical browser window.

OSLC Resource Manage Attributes Screen for Windchill in a Browser Window
Figure: Windchill’s OSLC Resource Manage Attributes Screen

Modifying Attribute Constraints
  1. In the Product Attributes tab, click on the newly created attribute name.
  2. In the attribute details pane, click the Constraints tab and delete the Single Valued Constraint element.
  3. Click the “Create a new constraint” button, choose String Length from the list proposed and click OK.
  4. Set the string length to a large number of characters, e.g. 2500.
  5. Click on SAVE.

The Product and Attribute Screen for a new constraint within the Windchill web application as seen in a typical browser window.


Figure: Windchill’s Attributes Screen Constraints

Hiding the new Attribute for General Users

The Windchill Adapter provides extensions to Windchill enabling the display of OSLC links to ALM Project Areas and ALM Work Items within the forms of the PLM system. The Adapter extends Windchill’s data schema and introduces appropriate user interface custom widgets for the new data attributes. Therefore the underlying information stored in the created attribute should be hidden to the end user, as the default display would be irrelevant.

Attribute visibility can currently be set for the Create New and Edit operations.
One can view and set the visibility for the attribute for a particular operation. If an attribute is inherited from a parent type, its visibility can only be made more restrictive than the attribute visibility on the parent type; it cannot be made less restrictive. Changes made are immediately reflected in the Visibility by Operation view of the type information page Attributes tab.

To hide the created attribute in end user views, use the following procedure:

  1. In the Product attributes view, click on Actions> Edit.
  2. In Attributes tab, select Visibility by Operation (drop down menu where Properties is selected by default)
  3. In the Visibility Tab, select Value Hidden for both Create New and Edit operations.
  4. In the Layouts tab, visit all layouts to ensure the attribute is not listed as displayed in any of them.
  5. Click the button Done to save the changes and return to view mode, or click Save to save the changes and remain in edit mode.

Create the ChangeRequest Attribute

  1. Select the type Change Request in the Manage Types list.
  2. Click on Actions > Edit.
  3. In the Attributes tab, click Create a new attribute
  4. Choose an Internal name [ * ] and select Type: Global
  5. Click Next
  6. Scroll down to select the global attribute you created in previous step (E.g., “RLIA RESOURCE”), then click Next
  7. Input Field type must be set to Multiple Lines.
  8. Click Finish.

[ * ] Important: It is mandatory that the Internal name chosen here matches the value you enter in the Servlet Manager’s context property oslc-windchill.windchill.attribute.changeRequest.relatedResource. See Configuring the Windchill adapter properties for more details.

Follow the steps performed for the Product attribute to finalize the Change Request attribute creation as described in the previous sections: Modifying the constraints and Hiding the attribute.