Workflow Definition

This article explains how to create a workflow definition and set its properties.

Data-Driven Workflows, available in Semarchy xDM 2023.1 and later, are subject to specific licensing requirements; please confirm your eligibility to use such new functionality by consulting your license agreement or by contacting your Semarchy account representative prior to use.
All customers can still use the workflow feature available in previous versions (now known as legacy workflows). Refer to Workflows (Legacy) for more information.

The first step in designing a workflow involves creating a workflow definition for a specific model. In a workflow definition, you need to:

  1. Define the data scope by selecting the entities on which you wish to create the workflow definition.

  2. Specify the attachment properties.

Create a Workflow Definition

To create a workflow definition:

  1. On the welcome page, click Workflow Builder.

  2. In the Model Editions section, select the model for which you wish to create a workflow definition.

  3. In the bottom right-hand corner, click the Create item Create item button.
    The Add a Workflow Definition dialog appears.

  4. Enter a name for the workflow definition.

    The name can only contain letters, digits, or underscores (_). It must start with a letter, and contain at least 2 and at most 128 characters.
  5. Click Create. The custom editor displays a blank workspace.

  6. Click anywhere in the blank workspace. The side panel sweeps in from the right.

    workflow workspace

  7. Optionally, set the Administrator Role required to administer instances of this workflow definition.

  8. Set the attachement properties and declare the entities to include in the workflow.

Attachment Properties

The Attachment Properties section allows you to specify the properties of the attachments that business users can add in a workflow instance at all steps.

Attachment properties
Property Required Description

Attachment Max File Size

Required

Maximum size of an attachment in KB. Only enter a numerical value in this field.

By default, the attachment size is set to 10,000 KB.

Attachment Max File Count

Required

Maximum number of attachments that can be uploaded in the workflow. Only enter a numerical value in this field.

By default, this number is set to 5.

Attachment Mime Types

Optional

Formats in which business users can upload attachments. The formats should be specified as MIME types and separated by commas.

By default, all mime types are allowed. This is indicated by an asterisk (*).

Attachments allowed in PDF, XML, and CSV formats
application/pdf,application/xml,text/csv

Entities

All entities and child entities manipulated in a workflow must be declared in the Entities section. You need to add at least one entity in the workflow definition.

To add an entity:

  1. Click the Create Create button next to the Entities section header.

  2. Select an entity from the model.

  3. Click Create.

  4. Set the entity’s properties.

  5. Add the Child Entities that are manipulated in the workflow. To add a child entity:

    1. Click Create Create button next to the Child Entities section header.

    2. Select the role of the child entity in the reference relationship that links it to its parent entity in the model.

    3. Click Create.

Entities
Property Required Description

Cardinality

Required

Determines how many records can be authored in instances of this workflow definition. Possible values are:

  • Single Record (default): allows authoring a single root record in each instance of this workflow.

  • Multi Record: allows authoring a set (or basket) of records with one workflow instance.

When Multi Record is selected, all user task instances from this workflow definition start with a collection step that shows the current basket of records and allows end-users to add, edit, or delete records from the basket.

SemQL Alias

Optional

Name used to refer to the entity in SemQL expressions.

Display Card

Optional

Display card used to represent records in My Tasks in the application and in email notifications.

If the display card is set to <None>, then the entity’s default display card is used.

Child Entities

Optional

Child entities of the current entity, if any.

Child entities need to be specified so that the hierarchy of entities covers the entities processed in steppers and integration jobs.

Copy a Workflow Definition

To create a copy of an existing workflow definition:

  1. Access the Workflow Definitions page of the Workflow Builder.

  2. In the list of workflow definitions, select the checkbox next to the name of the workflow definition you want to copy, open the action menu, and then select Copy Copy.

  3. The Add a Workflow Definition dialog appears.

  4. Enter a name for the workflow definition and click Create.

  5. The selected workflow definition is copied with the name provided and the workflow definition editor opens automatically.

This feature is useful to create versions of workflow definitions. To perform non-cosmetic changes (such as adding or removing steps) on a workflow definition that has running instances, it is usually recommended to copy this definition, keep it unmodified and make the changes on the new definition.