Create Relationship with RelationshipTemplate

This use case intends to create a Relationship based on a RelationshipTemplate, which was previously received. The Relationship will be established with the RelationshipTemplate’s creator. This use case must always be applied if the content of the RelationshipTemplate is an ArbitraryRelationshipTemplateContent. However, if it is a RelationshipTemplateContent, it usually does not have to be executed manually anymore. Instead, the Request Module, which is enabled by default, takes care of this automatically. For information on how to establish a Relationship based on a RelationshipTemplate with RelationshipTemplateContent and an enabled Request Module, refer to the corresponding scenario documentation.

Parameters

• templateId references the RelationshipTemplate that was received from its creator.
• creationContent is usually an ArbitraryRelationshipCreationContent if the RelationshipTemplate’s content is an ArbitraryRelationshipTemplateContent and the use case is applied manually. It is a RelationshipCreationContent if the RelationshipTemplate’s content is a RelationshipTemplateContent and the Request Module automatically takes care of the execution of the use case. It will be stored inside the Relationship and can be analyzed by the creator of the RelationshipTemplate to decide whether to accept the Relationship.

On Success

• Creates and returns the Relationship.

On Failure

• The templateId does not resolve to a RelationshipTemplate.

How to execute this use case with the Connector?

The Connector is our first-class citizen, thus we provide you with a detailed API description for every use case. This use case can be executed with the REST API of the Connector which you can Access the Connector.

Corresponding interactive API docs excerpt: