Creating custom relationships

Required permissions

Copy link to section

You must have the following user permissions:

• Manage glossary for relationships including artifacts
• Manage catalogs for relationships including assets

Custom relationship metadata

Copy link to section

Custom relationships contain the following metadata:

Labels

Character limit of 255. Relationship name for the artifact, asset, or column type at the source end and the target end of the relationship.

Both labels must be unique for the artifact, asset, or column type.

Source and target types

Use Specific item types to create a relationship type between specific artifacts and asset types.

Use Any columns to create a relationship type on column level.

Use Any item to create a relatioship type beetwen any items.

Cardinality

Number of artifacts, assets, or columns that can be on the source end and the target end of the relationship.

Restrict by condition

Enable this option to restrict a custom relationship type on the source or target by a primary category. Then, a custom relationship type can only be applied to artifacts in the specified category and all its subcategories.

The restriction can't be edited after creating the custom relationship type.

Name

Character limit of 255. Must be unique for the artifact, asset, or column type.

A new custom relationship can't be created with the same name between the same artifact, asset, or column type if a custom relationship with the same name between the same artifact, asset, or column type was created before.

Description (Optional)

Character limit of 255.

Creating a custom relationship

Copy link to section

To create a custom relationship:

1. Go to Administration > Configuration and settings > Asset and artifact definitions.
2. On the Custom relationships page, click Add relationship type > New relationship type.
3. Specify the source and target label of the relationship.
4. Select which items are allowed for this relationship type.
5. Add the source and target artifact types, asset types or columns for the relationship from the list. You can select one or many types.
6. Select the cardinality.
7. Optionally, restrict the relationship types on source or target end by a category.
8. Specify the name and optionally a description. The new relationship is available immediately.

Learn more

Copy link to section

• Creating custom asset types
• Creating custom properties
• Importing custom properties or relationships from a file
• Managing custom properties, relationships and asset types

Parent topic: Custom properties, relationships, and asset types