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 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.
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.