Integrations (PTC products, 3rd party products and code) > Managing product traceability when working with external systems > OSLC Integrations > OSLC Integration for Integrity Modeler > Creating OSLC Surrogates for Integrity Modeler data
  
Creating OSLC Surrogates for Integrity Modeler 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 remote Modeler model.
3. Drag a remote Modeler item and drop onto the local 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 Modeler item in the OSLC browser and then paste onto a local Modeler item.
4. In the pop-dialog, select the Convert To Surrogate checkbox.
5. Click on 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 model item existing name is retained.
6. 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.
7. 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.
8. Select the Text tab to view additional properties for the OSLC Surrogate and the linked DOORS Next Generation item. The OSLC Surrogate Description property can be updated and supports rich text.
9. Select the URL tab to view the URL and a small preview for the linked Modeler item. Select the View… button to view the large preview for the linked Modeler item.
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 Modeler diagram where you will create the new OSLC Surrogate.
3. Select the OSLC browser and navigate to the appropriate remote Modeler model.
4. Drag a remote Modeler item and drop 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 Modeler item in the OSLC browser and then paste onto empty space in a diagram.
5. 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.
6. Click on OK to confirm. The new item will be created as an OSLC Surrogate and the item's symbol displays the text <<Surrogate>>.
7. The Properties pane for the new OSLC Surrogate is displayed. The General tab displays standard properties for the 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 Modeler 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 Modeler item. Select the View... button to view the large preview for the linked Modeler 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 Modeler model.
3. Drag a remote Modeler 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 Modeler item in the OSLC browser and then paste onto an existing Modeler OSLC Surrogate.
4. In the pop-dialog, select the Update Surrogate checkbox.
5. Click on OK to confirm. The item's symbol now displays the text <<Surrogate>>.
* 
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.
For more information, see the chapter OSLC Integrations.