Working with Resource Shapes
Resource shapes specify a standard way of describing resources and constraints on resources. For more information on resource shapes, refer to the OSLC
specification.
The Windchill RV&S OSLC server is resource-shape compliant for supported domains and resources.
A sample resource shape URI for the requirement resource is as follows:
GET https://localhost:3001/oslc/r/ns/shapes/requirement
For fields with an allowed-values list, such as multivalued fields, picklist fields, IBPL fields, user fields, and group fields, the available values can be accessed using a separate URI with the oslc:allowedValues property.
Allowed values example for the state field
To obtain the allowed values for the state field, the URI will be:
GET https://localhost:3001/oslc/r/ns/shapes/allowedvalues/requirement/wrvs/state
In this example, a sample response for allowed values is as follows:
<oslc:allowedValue>Reviewed</oslc:allowedValue><oslc:allowedValue>Retired</oslc:allowedValue><oslc:allowedValue>In Review</oslc:allowedValue><oslc:allowedValue>Draft</oslc:allowedValue><oslc:allowedValue>Published</oslc:allowedValue>
Allowed values example for fields in the domain mapping file (Change Management domain)
To obtain the allowed values for the fields present in the mapping file (Change Management domain) such as severity, priority, and state, the URI will be:
GET https://localhost:3001/oslc/r/ns/shapes/allowedvalues/defect/oslc_cm/priority
In this example, a sample response for allowed values is as follows:
<oslc:allowedValue>oslc_cm:Low</oslc:allowedValue><oslc:allowedValue>oslc_cm:Medium</oslc:allowedValue><oslc:allowedValue>oslc_cm:High</oslc:allowedValue><oslc:allowedValue>wrvs:Critical</oslc:allowedValue>
To query for the priority field, only use the values present in the allowed values list. For instance, oslc_cm:Low.
Allowed values example for the user field
To obtain the allowed values for the user field, the URI will be:
GET https://localhost:3001/oslc/r/ns/shapes/allowedvalues/users
In this example, a sample response for allowed values is as follows:
<oslc:allowedValue>administrator</oslc:allowedValue><oslc:allowedValue>user1 (Fullname1)</oslc:allowedValue><oslc:allowedValue>user2</oslc:allowedValue>
Fullname is not a mandatory field so it might not appear for every allowed value entry.