Creating OSLC Surrogates for Windchill RV&S data
There are two ways to create an OSLC Surrogate which are described below. Update of OSLC Surrogates is also explained.
Convert an existing item to be an OSLC surrogate
1. Launch Modeler and open a model in which you wish to create OSLC Surrogates.
2. Select the OSLC browser and navigate to the appropriate Windchill RV&S project or folder.
3. Select a Windchill RV&S item, such as a requirement, requirement diagram or folder.
4. Drag the Windchill RV&S item and drop onto the Modeler item that you wish to convert to be an OSLC Surrogate. You can drop onto an item displayed on an open diagram, or an item displayed in a browser (e.g. Packages browser).
* 
You can also use copy and paste to convert an item to be an OSLC Surrogate. Copy the remote Windchill RV&S item in the OSLC browser and then paste onto a local Modeler item.
5. In the pop-up dialog, select the Convert To Surrogate checkbox.
6. Click OK to confirm. The item's symbol now displays the text <<Surrogate>>.
* 
When converting an item to be an OSLC Surrogate, the model item name is changed to match the remote OSLC item. If that name is already used in the current package, then the existing name is retained
7. The Properties pane for the new OSLC Surrogate is displayed. The General tab displays standard properties for the OSLC Surrogate. Note that an OSLC Surrogate is a special type of OSLC Link with distinct behavior.
8. Select the Options tab to view Server Type, Resource Type, and Link Type properties. Note that the Link Type is disabled as this is not a valid property for an OSLC Surrogate.
9. Select the Text tab to view additional properties for the OSLC Surrogate and the linked Windchill RV&S item. The OSLC Surrogate Description property can be updated and supports rich text.
10. Select the URL tab to view the URL and a small preview for the linked Windchill RV&S item. Select the View… button to view the large preview.
Create a new item as an OSLC Surrogate
1. Launch Modeler and open a model you wish to create OSLC Surrogates in.
2. Open a diagram where you will create the new OSLC Surrogate.
3. Select the OSLC browser and navigate to the appropriate Windchill RV&S project.
4. Select a DOORS Next Generation item, such as a requirement or requirement diagram.
5. Drag the Windchill RV&S item and drop it onto empty space in the diagram.
* 
You can also use copy and paste to create a new item as an OSLC Surrogate. Copy the remote Windchill RV&S item in the OSLC browser and then paste onto empty space in a diagram.
6. If required, choose the Modeler item type that will be created as the base item for the new OSLC Surrogate from the popup menu that appears.
7. The new item is created as an OSLC Surrogate and the item's symbol displays the text <<Surrogate>>.
8. The Properties pane for the new OSLC Surrogate is displayed. The General tab displays standard properties for the OSLC Surrogate.
* 
An OSLC Surrogate is a special type of OSLC Link with distinct behavior.
9. Select the Options tab to view Server Type, Resource Type and Link Type properties.
* 
The Link Type is disabled as this is not a valid property for an OSLC Surrogate.
10. Select the Text tab to view additional properties for the OSLC Surrogate and the linked Windchill RV&S item. The OSLC Surrogate Description property can be updated and supports rich text.
11. Select the URL tab to view the URL and a small preview for the linked Windchill RV&S item. Select the View… button to view the large preview for the linked Windchill RV&S item.
Updating an OSLC Surrogate
1. Launch Modeler and open a model with OSLC Surrogates you wish to update.
2. Select the OSLC browser and navigate to the appropriate remote Windchill RV&S item.
3. Drag a remote Windchill RV&S item and drop onto the local Modeler OSLC Surrogate that you wish to update.
* 
You can also use copy and paste to update an OSLC Surrogate. Copy the remote item in the OSLC browser and then paste onto an existing Modeler OSLC Surrogate.
4. In the popup dialog, select the Update Surrogate check box.
* 
It is also possible to update an OSLC Surrogate to be a HTML Surrogate. To do this, create a new HTML Link for the existing OSLC Surrogate and select the Update Surrogate option.