Workflow designer elements overview - Documentation for BMC Digital Workplace Advanced 20.02

Process workflow designer palette groupsElementIconDescriptionReference topicsEventsStart

Indicates the start of a process or subprocess. By default, the Start event is available on the palette when you start drawing a workflow. It is required for any workflow.

If a workflow contains a Sub-process or a Call activity event, the event must start with the Start event.

Designing a simple workflow

End

Indicates the end of a process or a subprocess (Sub-Process or Call Activity). A process can have multiple End events in a process (for example, in a process with gateways, or with error events). Error Boundary 

Captures errors and exceptions within a process and identifies the path that should be executed after a business error or exception is captured. Handling errors in processesError End

Indicates that a process or a subprocess represented by Sub-Process or Call Activity event ends up with an error.Timer

The Timer event can be attached only to the Receive Task.

This event interrupts a wait step represented by the Receive Task, and indicates how to continue a workflow after the wait step times out.

Setting up a timer for a Receive TaskAnnotation Annotation text

Provides additional information for anyone reading the process diagram.N/AActivities Call activity

Calls for an external workflow. This external workflow is a subprocess (or child process) that can call for one or more other processes, for example, a request approval process.

Calling external workflowsSub-Process

Indicates a type of a subprocess that describes a detailed sequence of actions in a workflow. This subprocess cannot be called from multiple processes, and belongs only to the included process. It is used to hide or show additional levels of process details.

When the Sub-Process element is collapsed, a plus sign appears against the bottom line of the rectangle. When the Sub-Process element is expanded, the rounded rectangle expands to show all workflow actions and sequence flows.

Embedding sub-process workflowsReceive Task

Suspends the process until the the external system sends a response back to BMC Digital Workplace Catalog. The Receive Task element waits for the response in the form of a signal. This signal can contain signal parameters to pass into a process.

The external system (such as Remedy IT Service Management, Atrium Orchestrator, or Active Directory) must be configured to return a message packaged in the same name as the Signal Parameter expected by the Receive Task.

If the external system is a Remedy application, see Integrating Remedy applications with BMC Digital Workplace Catalog.

Waiting for a responseConnector

Is a generic element used for calling an external activity of any connector that is enabled in the BMC Integration Service and configured for use with BMC Digital Workplace Catalog.

Setting up workflow to open a JIRA issue through a BMC Integration Service connectorGatewaysParallel

Branches the sequence flow to execute multiple activities concurrently.

When a parallel gateway is used as a join gateway to streamline multiple sequence flows into one, the join gateway waits until all the threads are complete before proceeding with the next step in the sequence.

Control of workflow with gatewaysExclusive

Branches the sequence flow to define the workflow execution paths. For a given instance of a process, only one path can be taken based on the conditions placed on the sequence flows coming out of the gateway.

Approval request Create Approval Stub Entry

Although this element is available for selection on the palette, it cannot be used directly. This element is a part of an out-of-the-box Approval Process that can be called (by using the Call Activity element) from a process.

Workflow to request approvalString utilsIndex Of

Returns the first index within a search string in a specified text.Index OfLast Index Of

Returns the last index within a search string in a specified text.Last Index OfInsert

Inserts a string in specified text.InsertSubstring

Retrieves a string from a specified Json.

Substring

Length

Counts character length of a specified text.LengthMatches

Counts how many times a string appears in a specified text.

Matches

Json Parser

Retrieves a string from a specified Json.Json ParserReplace

 Replaces all occurrences of a string within another string.ReplaceReplace All

Replaces every substring of text that matches a given regular expression with a given replacement.

Replace All

To Lower Case

Converts an input text string to lowercase text.

To Lower Case

To Upper Case

Converts an input text string to uppercase text.

To Upper Case

Epoch To String

Converts the epoch/UNIX timestamp to a formatted date.Epoch To StringExpressionsCompute Value

Is used to build an expression and use its output in multiple actions.Compute ValueDigital Workplace Catalog

Build Input Set

Creates custom parameters to send to an activity.

Building a custom input map in a workflow

Send In App Notification

Sends out In App notifications to BMC Digital Workplace Catalog.

Designing a workflow to send notification

Send Email

Sends an email to a defined email address.

Note: The Send Email element works in runtime only if the SMTP settings are configured for BMC Digital Workplace Catalog.

Set Service Request Status

Updates the status shown to end users in the requesting user's activity timeline in the BMC Digital Workplace end user console.

Setting the service request status

Track External Activity

Records that an external activity is ongoing, or checks the status of that activity.

Track External Activity can be used with connectors that have an external activity that can be tracked. You can use it with service connectors such as BMC Helix Platform, Remedy, AWS Marketplace, and AWS Service Catalog.

Track External Activity

My Stuff Remove Service

Removes a provisioned service asset from the My Stuff page when executed in a process. For more details about service actions, see Managing service actions.

Designing a workflow to remove a service request from the My Stuff pageCreate Activity Log For Service Request

Automatically posts comments to service requests (for native BMC Digital Workplace Catalog services and bundles, and imported SRDs). Under different names, this element can be used several times and in any place in a workflow.

Designing a workflow to create a request activity logUpdate Service Request

Allows you to set the summary of a service request that can override the default summary of the request.

Specify values for the following properties in this element:

• Request Id—ID of the service request that you want to modify.
• Summary—Text that you want to add in the summary. If you keep this property blank, the system ignores the property.

Add External Activity Attachments

When the system calls this action, the specified attachments are sent to a remote connector during the com.bmc.dsm.catalog:addActivityAttachments call.

Important: You cannot send questionnaire attachments to custom process actions. For example, the attachments that you provide through the remote connector framework.

Specify values for the following properties in this element:

• Internal Connection—The connection associated with the external activity.
• External Activity Type—Type of the external activity.
• External Activity ID—The ID of the external activity.
• Author Login ID—The login name of the author of the attachments. For example, a requester.
• Attachment IDs—The IDs of the attachments to add to the external activity as specified by attachment questions in the questionnaire.