Skip to main content

Task 2: Create the Workflow

After the basics, we create the person with the fields we already implemented. Before the welcome present can be sent the gender must be validated. Next a person of a group confirms the shipping and the activity will be created.

Step 1: Adding a Workflow_process​

To continue the workflow, a new process has to be added to the code. Therefore we need to implement the logic the task has to perform.

  1. Open the ADITO Designer and create a new process and call it "SetPrimaryContact_workflowService"

  2. Set the property 'title' to "Set Primary Contact" because this title will be shown in the Flowable Modeler after everything is done.

  3. Select "workflow" for the property 'variants'

  4. Set "Data_alias" for the property 'alias'

  5. Copy this code to the property 'serviceTaskParameterProcess' under "Workflow engine":

import("Workflow_lib");
import("system.result");

result.object([
    new WorkflowServiceTaskParameter("contactPosition", "Position", WorkflowServiceTaskParameter.STRING())
]);

The result set will be the parameters that can be selected in the Flowable Modeler. In this example you can enter a string for the value.

And add this code to your process:

import("Sql_lib");
import("system.result");
import("system.workflow");
import("system.datetime");
import("KeywordRegistry_basic");
import("system.db");
import("system.util");
import("system.vars");

var variables = JSON.parse(vars.get("$local.value"));

var contact_orgID = variables.targetId;
var target = variables.targetContext;
var firstname = variables.firstname;
var lastname = variables.lastname;
var gender = variables.gender;
var position = variables.contactPosition;
var salutation = variables.salutation;
var contactID = util.getNewUUID();
var personID = util.getNewUUID();

var orgID = newSelect("CONTACT.ORGANISATION_ID")
.from("CONTACT")
.where("CONTACT.CONTACTID", contact_orgID)
.and("PERSON_ID IS NULL")
.cell();

var personObj = {
    "PERSONID": personID,
    "FIRSTNAME": firstname,
    "LASTNAME":  lastname,
    "GENDER": gender,
    "SALUTATION": salutation,
    "USER_NEW": "Admin",
    "DATE_NEW": datetime.date()
}

new SqlBuilder().insertFields(personObj, "PERSON");

var contactObj = {
    "STATUS": $KeywordRegistry.contactStatus$active(),
    "ISOLANGUAGE": "deu",
    "ORGANISATION_ID":  orgID,
    "PERSON_ID": personID,
    "CONTACTID": contactID,
    "CONTACTPOSITION": position,
    "USER_NEW" : "Admin",
    "DATE_NEW": datetime.date()
}

new SqlBuilder().insertFields(contactObj, "CONTACT");

var processVariables = {
    "contactID": contactID,
    "personID" : personID
}

result.object(processVariables);

Deploy the project.

Step 2: Use the new process​

Now the new process will be added via a 'Service-Task'. Go back to the Flowable Modeler and open the process with the 'Visual Editor'. Delete the 'End-Event' and the connection towards it.

Drag a new 'Service-Task' in and place it in between the 'User-Task' and the 'Service-Task'. Remove the connection between them and fill the properties:

  1. Name: Insert Contact Person

  2. Id: insertContactPerson

  3. jDito process:

    1. jdito process: Set Primary Contact

    2. Parameters:

      1. Position: Contact Person

Connect it again between the existing two tasks with the flow towards the end.

Step 3: Setting up a Gateway​

As a decision is approaching a 'gateway' has to be inserted. Gateways are used to control how the process flows through Sequence Flows as they converge and diverge within a process.

This is how it can be used (This just a example, not our process):

gateway

Drag an 'Exclusive gateway' in and connect it from the 'Service-Task' to the 'Gateway'.

Step 4: Using Script-Tasks​

To select the appropriate present, which will be sent to the new employee, 2 'Script-Tasks' have to be entered.

Drag 2 'Script-Tasks' in and fill the properties (the pipe describes differences between them):

  1. Name: Send Flowers | Send Wine

  2. Script format: javascript

  3. Script: execution.setVariable("present", "Flowers"); | execution.setVariable("present", "Wine");

Connect these 2 'Script-Tasks' from the 'Gateway' to them.

Click on the Sequence Flow between 'Script-Task' "Send Flowers" and the 'Gateway' and fill the property 'Flow condition' with

${gender == "f"}

Click on the Flow direction between 'Script-Task' "Send Wine" and the 'Gateway' and fill the property 'Flow condition' with

${gender != "f"}

Step 5: Simple User Task​

Now we want to confirm the shipping of the welcome present. A simple User Task will be added with no Form Properties. Only people with the role "Marketing" & "Human Resources" can confirm this task. If one does complete this task, everyone else won’t see it anymore. So drag an 'User-Task' in and fill the properties:

  1. Name: Confirm

  2. Assignments:

    1. Type: Identity store

    2. Assignment: Candidate groups

    3. Search: Marketing & Human Resources

Connect the 2 'Script-Tasks' to this 'User-Task'.

Step 6: Adding activity Statement​

Again we need a new process to achieve our goal to create this Workflow. Open your ADITO Designer and create a new process called "CreatePresentActivity_workflowService". Like before set the property 'title' to "Create Present Activity" and select "workflow" for the property 'variants' and "Data_alias" for the property 'alias'

Copy this code to the property 'serviceTaskParameterProcess' under "Workflow engine":

import("KeywordData_lib");
import("KeywordRegistry_basic");
import("Workflow_lib");
import("system.result");

result.object([
    new WorkflowServiceTaskParameter("activityDirection", "Direction", WorkflowServiceTaskParameter.ENUM(), _getKeywords($KeywordRegistry.activityDirection())),
    new WorkflowServiceTaskParameter("activityCategory", "Category", WorkflowServiceTaskParameter.ENUM(), _getKeywords($KeywordRegistry.activityCategory())),
    new WorkflowServiceTaskParameter("activityTitle", "Title", WorkflowServiceTaskParameter.STRING())
]);

function _getKeywords (pContainer)
{
    return KeywordData.getSimpleData(pContainer).map(function (item) {return {id : item[0], name : item[1]};});
}

Like the last parameter process, this object will display all parameters and the corresponding values in the Flowable Modeler.

You also have to add this code to your process:

import("system.tools");
import("Employee_lib");
import("system.result");
import("ActivityTask_lib");
import("system.vars");

var variables = JSON.parse(vars.get("$local.value"));

var targetID = variables.targetId;
var target = variables.targetContext;
var category = variables.activityCategory;
var direction = variables.activityDirection;
var name = variables.firstname + " " + variables.lastname;
var contactID = variables.contactID

var obj = {
    responsibleContactId : tools.getUserByAttribute(tools.NAME, [variables.USER_ID], tools.PROFILE_DEFAULT)[tools.PARAMS][tools.CONTACTID],
    directionKeywordId : direction,
    categoryKeywordId : category,
    content : name + " has received the present " + variables.present,
    subject : variables.activityTitle + " " + name
}

var links = [[target, targetID], ["Person", contactID]];
var activity = ActivityUtils.insertNewActivity(obj, links);

This process will do almost the same as the existing 'CreateActivity_workflowService' but here you can tweak a few more settings that are necessary for this example.

Deploy the project. The rest-webservices will directly intergrate this new added process to the selection.

Step 7: Using the activity process​

After deploying the new process, we can add a new 'Service-Task' to the canvas and use "Create Present Activity" for our new activity. The properties look like this:

  1. Id: createActivity

  2. Name: create Personal Activity

  3. jDito process:

    1. jDito process: Create Present Activity

    2. Parameters:

      1. Direction: ausgehend (outgoing)

      2. Category: Besuch (visit)

      3. Title: Present to

and again connect it via a Sequence Flow with the last task.

Step 8: Adding End Event​

Connect to a new 'End Event' like in the first task.

Step 9: Testing and Summary​

And redo step 5 from task 1 and try to create a new person again.

After you filled in your data for the new employee, the person will be created and a notification will appear. After this you will get asked if you want to send the present. When you accept it, a new activity will be created with the right information and will be linked with the company and the corresponding person.