Get Relationship

  • Article

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

The Get Relationship activity is used to generate a list of objects from two different classes that are related by the criteria you specify.

The following published data elements are specific to Get Relationship. 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.

Get Relationship Published Data

Element Description

Number of Objects

The number of objects returned by the Get Relationship activity

Object Class

The name of a class for which you want to define a relationship to the related class

Object GUID

The unique identifier (GUID) of a single object in the object class that is used to define the relationship to another class

Related Class

The name of a class for which you want to define a relationship to the object class

Related Object GUID

The unique identifier (GUID) of a single object in the second class that is used to define the relationship

Relationship Object GUID

The unique identifier (GUID) of the items returned by the Get Relationship activity

Configuring the Get Relationship Activity

To configure the Get Relationship activity

  1. From the Activities pane, drag a Get Relationship activity to the active runbook. Double-click the Get Relationship activity.

  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 Object Class that you want to use as the starting point to define this activity. For a list of the available classes see Service Manager Classes, Fields, and Filters.

  4. To limit the retrieval activity to only those records that are related to a single item in the object class, enter the Object GUID of the item. If applicable, to automatically populate the value for the 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.

  5. Click the ellipsis button (...), and then select the Related Class from which you want to retrieve the records that are related to the Object Class, and, if entered in the previous step, that are specifically related to the Object GUID.

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

  7. Click Finish.

Other Activities

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