Create Relationship Nodes in Policy Designer

A Create Relationship node represents an action to create one or more new records in any baseline or custom relationship family. Each new record creates a relationship between a specified predecessor and successor entity record.

The outputs of the Create Relationship node are the following system fields for the record that the node creates: Content GUID, Entity KeyThe Entity Key output can be used in subsequent action nodes, such as the Create Relationship node, but will return a value of 0 if used in a calculation or a Return Value node, since the Entity Key is not available until the record is saved at the end of policy execution., Entity ID, and Site Key.

Node Properties

The Properties window for a Create Relationship node contains the items that are described in the following table.

Item	Description	Notes
Family ID list	Specifies the type of record that the Create Relationship node will create.	The Family ID list contains all of the baseline and custom relationship families in GE Digital APM for which you have insert privileges.
Predecessor Entity Key(s) section	Specifies the key(s) of the predecessor entity record(s) in the relationship.	You can create relationships in the following ways depending on how you specify values in the Predecessor Entity Key(s) and Successor Entity Key(s) sections: Single one-to-one relationship: Specify a single key in each section. Multiple one-to-one relationships: Specify the same number of keys in each section. A relationship will be added between each pair of keys. One-to-many relationship: Specify one key in the one section and multiple keys in the other section. In each section, you can select the icon to specify the output of a predecessor node. Tip: You can specify the Entity Key output from an action node that creates records (such as the Create Entity node) in order to use the newly created records as either predecessors or successors of a relationship. Relationships will not be created in the following scenarios: If the relationship you specify already exists. If no relationship definition is defined for the records you specify. When attempting to create multiple one-to-one relationships, if the number of keys in each section do not match.
Successor Entity Key(s) section	Specifies the key(s) of the successor entity record(s) in the relationship.

Item

Description

Notes

Family ID list

Specifies the type of record that the Create Relationship node will create.

The Family ID list contains all of the baseline and custom relationship families in GE Digital APM for which you have insert privileges.

Predecessor Entity Key(s) section

Specifies the key(s) of the predecessor entity record(s) in the relationship.

You can create relationships in the following ways depending on how you specify values in the Predecessor Entity Key(s) and Successor Entity Key(s) sections:

Single one-to-one relationship: Specify a single key in each section.
Multiple one-to-one relationships: Specify the same number of keys in each section. A relationship will be added between each pair of keys.
One-to-many relationship: Specify one key in the one section and multiple keys in the other section.

In each section, you can select the icon to specify the output of a predecessor node.

Tip: You can specify the Entity Key output from an action node that creates records (such as the Create Entity node) in order to use the newly created records as either predecessors or successors of a relationship.

Relationships will not be created in the following scenarios:

If the relationship you specify already exists.
If no relationship definition is defined for the records you specify.
When attempting to create multiple one-to-one relationships, if the number of keys in each section do not match.

Successor Entity Key(s) section

Specifies the key(s) of the successor entity record(s) in the relationship.

Hint: Click here to see an example of this node used within a complete policy model.