Relationship path specification

TypeScript type: RelationshipPathSpecification.

Relationship path specification is used to define a relationship path to an ECClass.

The specification is always used in a context where source class already exists, so it only requires the relationship and direction. The target class can be inferred from the two required attributes or specified with the targetClass attribute. In case of a multi-step path, target of the current step is used as the source of the next step.

Attributes

Attribute: relationship

This attribute specifies the ECRelationship that should be used to traverse to target class.

Attribute: direction

This attribute specifies the direction in which the relationship should be followed:

• "Forward" - the relationship is traversed from source to target of the relationship.
• "Backward" - the relationship is traversed from target to source of the relationship.

Attribute: targetClass

This attribute may be used to specialize the target of the relationship. E.g. when relationship points to a class like bis.Element, this attribute allows specializing it to bis.PhysicalElement or some other bis.Element subclass.

Examples

Using single-step relationship path

// This ruleset defines a specification that returns content for given `bis.Model` instances. The
// content is created for model elements found by following the `bis.ModelContainsElements`
// relationship and picking only `bis.PhysicalElement` type of elements.
const ruleset: Ruleset = {
  id: "example",
  rules: [
    {
      ruleType: "Content",
      condition: `SelectedNode.IsOfClass("Model", "BisCore")`,
      specifications: [
        {
          specType: "ContentRelatedInstances",
          relationshipPaths: [
            {
              relationship: { schemaName: "BisCore", className: "ModelContainsElements" },
              direction: "Forward",
              targetClass: { schemaName: "BisCore", className: "PhysicalElement" },
            },
          ],
        },
      ],
    },
  ],
};

Input	Result
bis.PhysicalModel instance
bis.DefinitionModel instance

Using multi-step relationship path

// This ruleset defines a specification that returns content for given `bis.GeometricModel3d` instances. The
// content is created for categories of model elements found by following the `bis.ModelContainsElements` and
// `bis.GeometricElement3dIsInCategory` relationships.
const ruleset: Ruleset = {
  id: "example",
  rules: [
    {
      ruleType: "Content",
      condition: `SelectedNode.IsOfClass("GeometricModel3d", "BisCore")`,
      specifications: [
        {
          specType: "ContentRelatedInstances",
          relationshipPaths: [
            [
              {
                relationship: { schemaName: "BisCore", className: "ModelContainsElements" },
                direction: "Forward",
              },
              {
                relationship: { schemaName: "BisCore", className: "GeometricElement3dIsInCategory" },
                direction: "Forward",
              },
            ],
          ],
        },
      ],
    },
  ],
};