Create Relationship operation

Creates a relationship between two documents that are present in a Documentum repository.

For information about the General and Route Evaluation property groups, see Common operation properties .

Login Settings properties

Login settings for invoking the Content Repository Connector for EMC Documentum service.

Login Mode

A com.adobe.livecycle.emcdocumentumcontentrepositoryconnector.client.type.impl.LoginSettings value that represents how the operation will be authenticated with Documentum. Valid values are INVOCATION_CONTEXT (Use Credentials from process context), USER_CREDENTIALS (Use User Credentials), and TOKEN (Use Documentum Login Ticket).

If you provide a literal value, select one of the following options:

Use Credentials from process context:
Uses the AEM forms User Management credential from the process context for the Documentum authentication.

Use User Credentials:
Uses the User Name and Password properties to authenticate with Documentum. Ensure that the user name is valid for the repository that is specified in the Repository Name property in the Relationship Information property group for this operation.

Use Documentum Login Ticket:
Uses the Documentum Login Ticket and User Name properties to authenticate with Documentum. This login ticket must be valid in the current Documentum Foundation Class (DFC) session, and the user name must be set to the correct user of the DFC session.

User Name

(Optional) A string value that specifies the user name to use when this operation is authenticated with Documentum. No default is provided.

This field is used only when the Login Mode property is set to USER_CREDENTIALS (Use User Credentials) or TOKEN (Use Documentum Login Ticket).

Password

(Optional) A string value that specifies the password associated with the user name that is specified in the User Name property to use when this operation is authenticated with Documentum. No default is provided.

This field is used only when the Login Mode property is set to USER_CREDENTIALS (Use User Credentials).

Documentum Login Ticket

(Optional) A string value that specifies the value of an existing Documentum login ticket for a valid DFC session. No default is provided.

This field is used only when the Login Mode property is set to TOKEN (Use Documentum Login Ticket).

Relationship Creation Settings properties

Specifies the properties for the relationship you want to establish.

Repository Name

A string value that represents the name of the Documentum repository. You can choose from the list of available repositories from your current connection broker defined in administration console. (See AEM forms administration help.)

Relationship Type

A string value that specifies the type of relationship to create between the parent document and the child document.

Parent Document ID Or Path

A string value that indicates either the parent document ID number or the folder location within the repository where the parent document exists.

If you provide a literal value, type the path or the ID, or click Browse to select the folder from the Documentum repository.

When typing the folder path, use the following rules:

  • Do not include the repository name in the folder path.

  • Use a forward slash (/) to separate folder names, as shown in this example:

    /[CabinetName]/[FolderPath]/[documentName]

Child Document ID Or Path

A string value that indicates either the child document ID number or the folder location within the repository where the child document exists.

If you provide a literal value, type the path or the ID, or click Browse to select the folder from the Documentum repository.

When typing the folder path, use the following rules:

  • Do not include the repository name in the folder path.

  • Use a forward slash (/) to separate folder names, as shown in this example:

    /[CabinetName]/[FolderPath]/[documentName]

Child Version Label

(Optional) A string value that specifies the version label of the child document. If set, the child document's chronicle ID is used as the child in the relationship.

Is Permanent Link?

(Optional) A boolean value that indicates whether the parent-child relationship should be maintained across versions of the parent document.

Description

(Optional) A string value that specifies the text description for the relationship.

Exceptions

This operation can throw a RepositoryException exception.

// Ethnio survey code removed