Integrations (PTC products, 3rd party products and code) > Managing product traceability when working with external systems > OSLC Integrations > OSLC Integration for IBM Rational Doors Next Generation > Creating OSLC Surrogates for DOORS Next Generation data
  
Creating OSLC Surrogates for DOORS Next Generation 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 DOORS Next Generation project or folder.
3. Select a DOORS Next Generation item, such as a requirement, requirement diagram or folder.
4. Drag the DOORS Next Generation 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 DOORS Next Generation 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 model item 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 DOORS Next Generation item.
10. Select the tab to view the URL and a small preview for the linked DOORS Next Generation item. Select the View… button to view the large preview for the linked DOORS Next Generation 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 diagram where you will create the new OSLC Surrogate.
3. Select the OSLC browser and navigate to the appropriate DOORS Next Generation project or folder.
4. Select a DOORS Next Generation item, such as a requirement or requirement diagram.
5. Drag the DOORS Next Generation 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 DOORS Next Generation 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 DOORS Next Generation item. The OSLC Surrogate Description property can be updated and supports rich text.
11. Select the tab to view the URL and a small preview for the linked DOORS Next Generation item. Select the View… button to view the large preview for the linked DOORS Next Generation 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 DOORS Next Generation item.
3. Drag a remote DOORS Next Generation 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 DOORS Next Generation item in the OSLC browser and then paste onto an existing Modeler OSLC Surrogate.
4. In the pop-dialog, select the Update Surrogate checkbox.
* 
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.