Share via

Create Related Object

  • Article

Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator

The Create Related Object activity is used to create a new Service Manager object that is related to other existing objects either by membership or by a hosted relationship.

The following published data elements are specific to Create Related Object. Additional published data is generated based on the class that you select when you define the activity. For a list of the data elements published by each class, see Service Manager Published Data.

Certain classes contain a mandatory ID property which requires a GUID. Generating a GUID is the responsibility of the workflow author, and can be generated using a .NET scripting activity:

  1. Create a Run .NET Script activity using the following method: $GUID = [guid]::NewGUID().

  2. On the Published Data tab, define the GUID variable using the following settings:

    • Name: guid

    • Type: String

    • Variable: GUID

When the .NET Script Activity runs, it will generate a GUID that you can subscribe to in the ID property of the object you are creating.

Element Description

Relationship Type

Describes how the source class and target class are related to each other

Source Class

The name of the source class used to build the relationship

Source Object GUID

The unique identifier (GUID) of a single source object used to build the relationship

Target Class

The name of the target class used to build the relationship

Target Object GUID

The unique identifier (GUID) of a single target object used to build the relationship

Object GUID

The unique identifier (GUID) for the object

Number of Objects

The number of objects returned by Create Related Object

  1. From the Activities pane, drag a Create Related Object icon to the active runbook. Double-click the Create Related Object icon.

  2. On the Details tab, in the Properties section, click the ellipsis button (...), and then select the Connection to the Service Manager computer that you want to use for this activity.

  3. Click the ellipsis button (...), and then select the Source Class that you want to use to define this object. For a list of the available classes and their respective fields, see Service Manager Classes, Fields, and Filters.

  4. Click the ellipsis button (...), and then select the Target Class that you want to use to define this object.

  5. Click the ellipsis button (...), and then select the Relationship Type that describes the relationship between the Source Class and the Target Class. The required fields for this relationship appear in the Fields section.

  6. To create the relationship between the items, enter the Source Object GUID. If applicable, to automatically populate the value for the Source Object GUID from the data published by a previous activity in the workflow, right-click the property box, point to Subscribe, and then click Published data. Click the published data element you want to use, and then click OK.

    The published data for each activity depends on the class that was selected when the activity was created. For a list of the data elements published by each class, see Service Manager Published Data. For information about the Common Published Data items, see Published Data in the System Center Orchestrator 2012 Runbook Guide.

  7. To enter values for additional fields, click Select Optional Fields. In the Add/Remove Property dialog box, select the properties you want to apply to this activity from the Available list, and then click the right arrow button (>>). The properties appear in the Selected list. To remove a property from the Selected list, click the property, and then click the left arrow button (<<). Click OK.

  8. Assign a value to each of the fields. Or, to automatically populate the value for the additional fields from the data published by the previous activity in the workflow, right-click the field box, point to Subscribe, and then click Published data. Click the published data element you want to use, and then click OK.

  9. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Activities.

  10. Click Finish.

Other Activities

The Integration Pack for System Center Service Manager contains the following additional activities: