Templates

 

[For info/instructions on Template Folders, click HERE.]

 

To Add a Template:

 

1. Expand your project in the Workbench, and then expand the Connected Field Service node.

 

2. Right-click on the Templates branch or on a Template Folder, then select Add Template from the pulldown menu, as shown below.

Add Template from the Project Explorer

 

-OR-

 

Select the Templates branch or a Template Folder in the Project Explorer then click on the Add Template button, shown below, in the Edit section of the Home ribbon in the Workbench.

 

Add Template Button

 

3. This opens the Template properties, as shown below, within the Workbench. Enter a name for this configuration in the Name text entry field.

Template Properties

Template Diagram Tab

Template Properties - Template Diagram Tab

Activity Library

The Activity Library allows you to drag listed elements into the Diagram Editor. Each Activity brings up its own set of properties that appear to the right of the Diagram Editor when the Activity has been added.

 

Activities in the Activity Library include:

You can select from the following items and set (or read) each Activity's individual properties.

 

NOTE: For Connected Field Service provider Template configurations requiring use of the Expression Editor, note that are specific additions to ease expression construction. Click HERE for more info.

Start

Start Activity

 

The Start activity is the starting activity of the workflow. It cannot be deleted and is unique in the whole workflow.

 

The Start activity has the following settings:

 

General Settings

Return to Top of Activity Library List

Dynamic Tag Writer

Dynamic Tag Writer Activity

 

The Dynamic Tag Writer activity writes a value into a Dynamic DA Tag.

 

The Dynamic Tag Writer activity has the following settings:

 

General Settings

Timeout Settings

Destination Dynamic Tags

Retry Settings

Return to Top of Activity Library List

Worker Lookup

Worker Lookup Activity

 

The Worker Lookup activity utilizes a Dynamic Worker List.

 

The Worker Lookup activity has the following settings:

 

General Settings

Timeout Settings

Worker Lookup

Retry Settings

Return to Top of Activity Library List

Fixed Contact List

Fixed Contact List Activity

 

The Fixed Contact List activity uses a List of Workers. This block only supports name and destination. Use the Worker Lookup Block if the transaction requires additional information, such as location, scheduling, filter, acknowledgement, etc.

 

The Fixed Contact List activity has the following settings:

 

General Settings

Timeout Settings

Fix List

 

The Fix List allows for creation of a list worker/contacts for a specific user and alert destination.

 

Destination Dynamic Tags - Click on the + Click here to add new item link to enter the following information:

Retry Settings

Return to Top of Activity Library List

 

Dynamics Work Order

Dynamics Work Order Activity

 

The Dynamics Work Order activity creates a Dynamics Work Order.

 

The Dynamics Work Order activity has the following settings:

 

General Settings

Timeout Settings

Dynamics Work Order

Retry Settings

Return to Top of Activity Library List

 

Salesforce Work Order

 

Salesforce Work Order Activity

 

The Salesforce Work Order activity creates a SalesForce Work Order.

 

The Salesforce Work Order activity has the following settings:

 

General Settings

Timeout Settings

Salesforce Work Order

Retry Settings

Return to Top of Activity Library List

Condition

Condition Activity

 

The Condition activity evaluates the expression and, depending on the expression, redirects the workflow.

 

The Condition activity has the following settings:

 

General Settings

Timeout Settings

Condition Settings

Retry Settings

Return to Top of Activity Library List

Ack

Ack Activity

 

The Ack activity is set as True if the current alarm state is Ack. Acknowledge is any state that is only acknowledge or disabled. Alarm can be either active or inactive.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Ack activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Alarm

Alarm Activity

 

The Alarm activity is set at True if the current alarm state is Alarm. Alarm is any state that is only enabled and active.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Alarm activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Normal

Normal Activity

 

The Normal activity is set as True if the current alarm state is Normal. Normal is any state that is only acknowledge and no longer in alarm OR disabled. Note: Normal can be expanded to include not in alarm by ORing  '|| {{triggerVariable:NewState}} == 0x0001' within the ')' to the existing condition.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Normal activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Reject

Reject Activity

 

The Reject activity is set as True if the current CFS state is Reject.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Reject activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Busy

Busy Activity

 

The Busy activity is set as True if current CFS state is Busy.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Busy activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Assign

Assign Activity

 

The Assign activity is set as True if the current CFS state is Assign.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Assign activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

Accept

Accept Activity

 

The Accept activity is set as True if the current CFS state is Accepted.

 

NOTE: This block causes the workflow to update the workflow with the latest alarm data for the specific alarm that triggered the workflow.

 

The Accept activity has the following settings:

 

General Settings

Timeout Settings

Alarm Update Condition

Retry Settings

Return to Top of Activity Library List

 

Send Email

Send Email Activity

 

The Send Email activity sends an email using the server specified in the tag.

 

The Send Email activity contains the following settings:

 

General Settings

Timeout Settings

Email Settings

The following shortcuts can also be used in the message field:

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

 

Note: The email is sent using ICONICS AlertWorX Server. Please make sure that a default email node is configured correctly and that the email server is running.

 

Retry Settings

Return to Top of Activity Library List

 

Send Sms

Send Sms Activity

 

The Send Sms activity sends a Sms using the server specified in the tag.

 

The Send Sms activity contains the following settings:

 

General Settings

Timeout Settings

Sms Settings

The following shortcuts can also be used in the message field:

 

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

 

Note: The Sms is sent using ICONICS AlertWorX Server. Please make sure that a default Sms node is configured correctly and that the Alert Sms server is running.

 

Retry Settings

Return to Top of Activity Library List

 

 

Send Voice Message Activity

 

Send Voice Message Activity

 

The Send Voice message activity sends a Voice message using the server specified in the tag.

 

The Send Voice message activity contains the following settings:

 

General Settings

Timeout Settings

Voice Settings

The following shortcuts can also be used in the message field:

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

 

Note: Please make sure that the selected provider is configured correctly.

 

Retry Settings

Return to Top of Activity Library List

 

 

Send WhatsApp

 

Send WhatsApp Activity

 

The Send WhatsApp activity sends a message to WhatsApp using the server specified in the tag.

 

The Send WhatsApp activity contains the following settings:

 

General Settings

 

Timeout Settings

WhatsApp Settings

The following shortcuts can also be used in the message field:

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

 

Note: Please make sure that the selected provider is configured correctly.

 

Retry Settings

Return to Top of Activity Library List

 

 

Teams IM

 

Teams IM

 

Send Teams IM Activity

 

The Send Teams IM activity sends a message using Microsoft Teams.

 

The Send Teams IM activity contains the following settings:

 

General Settings

Timeout Settings

 

Teams Instant Messaging Settings

 

The following shortcuts can also be used in the message field:

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

 

Note: The TeamslM is sent using ICONICS AlertWorX Server. Please make sure that a default Team node is configured correctly and that the AlertRest server is running.

 

Retry Settings

 

Return to Top of Activity Library List

 

GenEvent Output

GenEvent Output Activity

 

The GenEvent Output activity writes a message to the GenEvent Server.

 

The GenEvent Output activity has the following settings:

 

General Settings

Event Settings

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

Retry Settings

Return to Top of Activity Library List

Alarm Event Output

Alarm Event Output Activity

 

The Alarm Event Output activity writes a message to the GenEvent Server that sources alarm data.

 

The Alarm Event Output activity has the following settings:

 

General Settings

Alarm Event Settings

/T - current workflow name

/B - activity in which last error occurred

/E - last error

/L - last executed activity name

/C - current activity name

/D - current activity description

Retry Settings -

Return to Top of Activity Library List

 

Generate Report

 

Generate Report Activity

 

 

The Generate Report activity generates a new report using the report tag and the parameters specified.

 

The Generate Report Activity contains the following settings:

 

General Settings

Data Source

Input Parameters

Timeout Settings

Retry Settings

Return to Top of Activity Library List

 

Repeat Contact List

Repeat Contact List Activity

 

The Repeat Contact List activity repeats the list of workers selected and processed by the previous Worker Block (Worker Lookup, Fixed Contact Blocks).   Workers are added to list when processed and only added once.  List is reset when accessing a new Worker Block.

 

The Repeat Contact List activity has the following settings:

 

General Settings

 

Timeout Settings

 

Fix List

Return to Top of Activity Library List

 

 

ServiceNow Work Order

ServiceNow Work Order Activity

 

The ServiceNow Work Order activity creates a ServiceNow Work Order.

 

The ServiceNow Work Order activity has the following settings:

 

General Settings

Timeout Settings

ServiceNow Work Order

Retry Settings

Return to Top of Activity Library List

 

Alarm Delay

Alarm Delay Activity

 

The Alarm Delay activity adds a delay to workflow execution. The activity updates alarm information.

 

The Alarm Delay expressions containing alarms are periodically re-evaluated.

 

The Alarm Delay activity has the following settings:

 

 

General Settings

 

Delay Settings

Data Schema

Data Filter

Retry Settings

Return to Top of Activity Library List

 

 

Delay

Delay Activity

 

The Delay activity adds a delay to workflow execution.

 

Delays of 10 seconds (10000 milliseconds) or greater will cause the workflow to enter Dehydration. In Dehydration, workflow pauses for the entire delay time. The paused workflow thread(s) are released for other tasks. The current state of the paused workflow is saved to memory.  This prevents long delays from locking out other work.

Delay is best used just before a condition check.

 

The Delay activity has the following settings:

 

General Settings

 

Delay Settings

 

Data Schema

 

Data Filter

 

Retry Settings

Return to Top of Activity Library List

 

 

Diagram Editor

The Diagram Editor, when first opened, will display a Start Action. This is the starting activity of the workflow. It cannot be deleted and is a unique element within the workflow.

 

You can expand the Diagram Editor window in order to provide more room to create your workflow Diagram. You can also use the following tools from the toolbar that first appears by default:

 

Snaps the items to the grid.

Toggles labels.

Toggles the Activity Library.

Autofit

Zoom in.

Zooms out.

Validation Log

The Validation Log provides immediate validating of the most recently added elements (activities, etc.) to the diagram.

Settings and Parameters Tab

Template Properties - Settings and Parameters Tab

 

Generic Properties

Conifigure the list of parameters in the workflow

To Add a Template:

 

4. You can click Apply to save your template properties and Close to return to the Workbench. Your new template will now appear in the Project Explorer, beneath the Templates node or template folder.

 

See Also:

Templates Folder

About CFSWorX