Workflow step types
Select from a variety of workflow step types to build workflows from.
Inventory Record Stage Change
- Transitions a record into another stage.
- Requires available record stages associated with the workflow.1
| Field | Description |
|---|---|
| when these conditions are met (optional) | Add conditional requirements to qualify for this step.2 |
| set inventory record stage to | Select the record stage to transition to. |
Artifact Status Change
- Transitions an artifact into another status.
- Requires available artifact type statuses associated with the workflow.3
| Field | Description |
|---|---|
| when these conditions are met (optional) | Add conditional requirements to qualify for this step.4 |
| set artifact status to | Select the artifact type status to transition to. |
Workflow State Change
Transitions the workflow into another workflow state.5
| Field | Description |
|---|---|
| set workflow state to | Select or add6 the workflow state to transition the workflow to. |
| progress | Indicate the progress of the workflow at this transition into the next state. |
6 Click Add New State to create a new state unique to this workflow.
User Action
Creates a button that performs an action on behalf of the user.
| Field | Description |
|---|---|
| display action button when (optional) | Add conditional requirements for displaying this step.7 |
| step title (optional) | Text that displays at the top of the modal that opens when users click the action button. |
| action button label | Text that displays on your action button. |
| requested fields (optional) | Include record or artifact fields alongside your action.8 |
| user action deadline (optional) | Include a deadline for when users should complete this action by.9 |
8 Select a field from the the drop-down to add it to your User Action step — click Add All to add all fields in that group. Users must have write permissions for the field in order to enter values.
9 Toggle Enable deadline on to configure a deadline.
Approval
Display a preconfigured message to users in the selected approval group.
- Select from either User Roles, Inventory Record Stakeholder Types, or either User Role or User Type inventory field.10
- Must be connected to both a rejection and approval Inventory Record Stage Change step.11
- Configure two Inventory Record Stage Change steps for your associated rejection and approval stages.
- Then, from the bottom of your Approval step:
- Connect the left (red) to your rejection step.
- Connect the right (green) to your approval step.
| Field | Description |
|---|---|
| approval group | Select the roles, stakeholders, or user fields responsible for approval. |
| fields to review (optional) | Select the record or artifact fields shown to approvers for read-only review.12 |
| Approval Message | When your workflow reaches this Approval step, the selected approval group is shown this message.13 |
13 Enter a title and a message to display.
Broadcast
- Send email notifications to users in selected groups.
- Select from either User Roles or Inventory Record Stakeholder Types.14
| Field | Description |
|---|---|
| Select roles | Select the Inventory Record Stakeholder Types or User Roles to receive the email. |
| subject | Enter the subject of the email.15 |
| message | Enter the body of the email. |
15 Use the rich text editor to compose your subject and message:
- Include optional details about the record or artifact the workflow is running on using the { } Insert Variable drop-down.
- Click on the Preview tab and choose a record or artifact under select {inventory record/artifact} for preview to confirm how the notification will appear when rendered.
Condition Branch
- Allows diverging paths based on conditional requirements.
- A
defaultbranch will be automatically included as a catch-allelsepath to ensure that your conditional logic is complete.
Workflows cannot be saved until condition branches are connected to other steps.
To configure a condition branch:
On the Configure Condition Branch modal, click Add Branch.
Enter the path name and designate the conditions16 that apply to this path.
Continue with steps 1 and 2 until your conditional branch logic is complete.
To remove a path, click and select Remove Path.
When you are finished setting up all your branch paths, click Update Step to save your step.
Proceed with linking the Condition Branch with your subsequent steps.17
Wait
- Creates a time condition for displaying next available action.18
- Used to enforce a time delay or a calendar date milestone.
To configure a wait step, select when you would like to resume workflow
| Option | Required field(s) | Description |
|---|---|---|
| After Time Interval | wait duration | Wait for a set amount of time. Applies to all records or artifacts under the workflow. |
| At Specified Date | wait until | Wait until a specific timestamp. Applies to all records or artifacts under the workflow. If the milestone date inputted is in the past, the next workflow step will display immediately. |
| At Specified Date on Custom Field | custom field19 | Wait until a specific timestamp as defined by a record or artifact field on a per record or per artifact basis. If the selected field is empty20 or the milestone date inputted is in the past, the next workflow step will display immediately. |
| Time Delta from Specified Date on Custom Field | custom field, time delta direction, wait duration | Wait for a calculated time relative to a date in a record or artifact field on a per record or per artifact basis. If the selected field is empty21 or the milestone date inputted is in the past, the next workflow step will display immediately. |
20 Make record or artifact fields required on registration to ensure necessary fields have valid values.
21 Make record or artifact fields required on registration to ensure necessary fields have valid values.
Run Workflow
Triggers another workflow indicated by select workflow to run, allowing you to chain workflows.
Webhook
When a workflow reaches a webhook step, the workflow will pause. Listen for a POST request to resume the workflow:
Click Copy to the right of URL to copy the webhook URL to your clipboard.
This webhook URL is where you should send your
POSTrequest.
Under select target {record-type} record for payload, choose a record from your inventory22 to populate the target for the payload.
Click Copy to the right of Payload to copy the payload to your clipboard.
Include this payload when you send your
POSTrequest to the webhook URL.
Click to the right of the
x-api-keyand its value to copy them to your clipboard.Click to the right of the
x-api-secretand its value to copy them to your clipboard.
Send your POST request to the webhook URL and include these headers with your request to authenticate your call.
HTTP Request
Sends a HTTP request with optional additional conditions.23
| Field | Description |
|---|---|
| url | Enter the URL to send the HTTP request to. |
| method | Select the HTTP request method: GET, POST, PUT, DELETE24 |
| timeout (seconds) | Enter a request timeout in seconds.25 |
| fail on non-2xx (optional) | Toggle whether or not the request will be considered failed if the response status code is not in the 2xx range. |
| allow invalid certificates (optional) | Toggle whether or not the request will be allowed to use invalid certificates. |
| follow redirects (optional) | Toggle whether or not the request will follow redirects. |
| require https (optional) | Toggle whether or not the request will require HTTPS. |
| headers (optional) | Include headers with your request.26 |
24 PUT and POST requests have additional configuration fields:
- body type — Select whether the body is
JSONorText. - body — Enter your payload.
25 Max 300 seconds, or enter 0 to disable timeout.
- 26
- Click Add Header to enter a header.
- Provide a Header Name and Header Value.
To avoid storing credentials in plaintext, use webhook secrets: enter {secret:name} as the header value. At runtime, the workflow engine replaces the placeholder with the stored secret value. See Manage secrets.
End
- Designates the end of your workflow.
- Use this step when all of your other steps have been configured and linked together.27