Communication
Contents
Communication
1.1 Activities
1.1.1 HTML Composer
1.1.2 Send Email
1.2 Workflow
1.3 Parameters
1.3.1 General Guidelines
1.3.2 HTML Composer
1.3.3 Send Email
1.4 On Execution Workflow
Activities
HTML Composer
This activity substitutes a visual HTML editor.
Send Email
This activity sends an email according to given specifications.
Workflow
Workflow name: Communication_workflow
Workflow description:
Activities are the building blocks of WF , they are a unit of work in WF. Activities can be composed together into larger Activities. When an Activity is used as a top-level entry point, it is called a "Workflow".
In WF4, the root activity is called „Sequence". This activity is added by default in WF Designer panel when a new workflow is created. All activities that are placed inside of a sequence are called child activities.
Parameters
General Guidelines
Variables and Arguments
In general terms of parameters in WF4, there are two main concepts: Variables and Arguments. The definitions for each are that Variables are used to store data within a workflow and Arguments are used to passing data in/out of a workflow. The concept of „binding" parameters has been replaced with the usage of variables and arguments.
Variables are to be used in a workflow whenever the need to store data is limited to the current workflow and the output/input of the workflow is not used anywhere else (for example in Admin Suite).
Arguments are to be used whenever the input parameters of an activity are given by the user using for instance a web-based application, (for example when running a workflow in Admin Portal) and if the output of an activity is to be returned and used outside of DesignStudio application . (for example Admin Portal)
All parameters that have an Expression editor in Activity Properties panel can be used for value storage and passing, through variables and arguments.
Example: Collection From String activity
Defined IN arguments, with default value to be filled in by the user when running the workflow:
Defined variables to store the output of the Collection From String activity:
Parameters with different editors, like Folder editors or ComboBox cannot be bound to variables nor arguments.
Activity Properties
In general terms of activities properties, there are two main concepts: „Stop On Error" and „Enabled".
The concept of „Stop on error" and „Enabled"mechanisms are defined for runtime purposes.
„Stop on error" Property
On runtime (nn. Start button), if the Stop on error property is set to Yes for an activity and an error or exception is thrown, the execution of the workflow stops on the activity that caused the error /exception to be thrown.
If set to No, the error message is displayed in Tracking Data panel, but the execution of the workflow continues.
„Enabled" Property
On runtime, if the Enabled property is set to Yes for an activity,the activity is executed.
If set to No, the activity will not be executed on runtime.
WF Designer panel view:
Tracking Data panel view:
Activites Parameters
HTML Composer
The Content parameter is given by the user via In argument defined in the Parameters Area from WF Designer panel:
The output returned by this activity is stored into the variable HTML_Output and will be used as imput for Content parameter from Send Email activity.
Send Email
This activity has three categories of parameters: Authentication, Message and Addresses.
For Authentication parameters, an exchange server is used with proper credentials given by the user via defined IN arguments in the Parameters area from WF Designer panel:
For Message parameters:
- Content: the value stored in HTML_Output it is used for this parameter
- Subject: the value for this parameter is passed via IN argument Subject
- File attachments: 1.jpeg has been attached to the email:
Click on Add button and fill the Value field in the right side of the panel to attach a new file.
For Addresses parameters values are passed via IN arguments :
On Execution Workflow
Execution Result: