Step 1: Check if the join date matches the current date
To check if the join date matches the current date, follow the steps below.
To go to the Process template, select “Process” under the Background processes menu on the left side panel.
In the Background processes>Process tab, click the [+ Process] button.
To label the Process and enable it, go to the “Details” tab. In the “Details” tab:
Enter the Process name as “CustomerJoinDateAnniversaryNotification”.
Optionally enter the description for the Process.
Ensure the Process is enabled.
To disallow multiple requests simultaneously, leave the toggle button enabled for “skip execution while in progress”. Enabling this toggle button defines that the execution of this Process will be skipped when there is one already in progress.
The default value for Process execution is selected as “Immediate”. For this exercise, keep it as is.
To define the shared variables, go to the “Variables” tab. This tab consists of the shared variable “StartupParameters” with the data type “List”.
To add a variable, click the [+ Variable] button.
Add and define (2) shared variables:
To have a variable to hold the day and month of the current date, define the first variable as follows: Variable Name: ”strDayMonthToday”, Data Type: “string”.
To have a variable to hold the current date, define the second variable as follows: Variable Name: “currentDate”, Data Type: “DateTime” and initialize it to “DateTime.Now()” (Navigate to Functions>DateTime>Now).
To create a new Target Entity, go to the “Target Entities” tab and click [+ Target Entity]. This Target entity is where the Process will update the records.
To define the target entity, select the “Target Entity” from the drop-down menu as “UserName_Acc_Activities”.
To add the sequence of actions to check if the current date matches the customer's join date, go to the “Code” tab. To create a new “Action box”, click the [+ Action box] button.
To calculate the day and month of today, label the Action box as “Calculate DayMonth of today”. This is the first “Action box” in which the value for the “DayMonthJoinDate” (field in the entity “UserName_Acc_customer”) for the current day will be evaluated and stored in the record to be updated.
To define variables for the actions in this Action box, go to the Action box>Variables tab. To create a new variable, click the [+ Variable] button. Create three (3) variables.
To store the value of the current date as a string, define a variable as follows: Variable Name: “current_daymonth”, Data Type: select “string”.
To store the value for the month in the current date, define a variable as follows: Variable Name: “current_month”, Data Type: “string”.
To store the value for the day in the current date, define a variable as follows: Variable Name: “current_day”, Data Type: “string”.
To add an action, go to the Action box>Code tab of the “Action box” and click the (+) button.
To update the variable with the “current_day” with the day's value in the current date, define the added Action as follows:
Select Action as “Update Variable”.
Select the Target variable as “current_day”.
Select Value by navigating the dropdown Functions>DateTime>Now()>Day()>toString(). It will display as “DateTime.Now().Day().toString()”. The current day's value is first converted to string and then updated to the variable “current_day”.
To update the variable with the “current_month” with the month's value in the current date, add and define another Action as follows:
Select Action as “Update Variable”.
Select the Target variable as “current_month”.
Select Value by navigating the dropdown Functions>DateTime>Now()>Month()>toString(). It will display as “DateTime.Now().Month().toString()”. The current month's value is first converted to string and then updated to the variable “current_month”.
To add a zero in case the month is of 1 digit, add and define an Action as follows:
Select Action as “Condition action”.
Enter the label as “if month is 1 digit, add a zero”.
To check if the length of the month's value is equal to 1, add and define a Criteria bar as follows:
Select Source as Variables>current_month>length(). It displays as current_month.length().
Select Operator as “Is Equal”.
Enter Value as ‘1’ and press Enter.
If the Criteria is returned as true, define an Action in the Code tab>On True section as follows:
Select Action as “Update Variable”.
Select the Target variable as “current_month”.
Define Source as follows:
In the Source, type ‘0’ without quotes and press Enter.
Navigate the dropdown and select Variables>current_month.
To update the variable with the “current_daymonth” with the month's value in the current date, add another Action after Condition action and define it as follows:
Select Action as “Update Variable”.
Select the Target variable to be “current_daymonth”.
Select Value as follows:
Navigate and select the “current_day” variable.
Navigate and select the “current_month” variable.
To traverse the entity “UserName_Acc_customers” for comparing the values of the customer's join date with the current date, define the Action as follows:
Select Action as “Traverse Entity”. This action will traverse an entity.
Select entity “UserName_Acc_customers”. This entity will be traversed.
In the field “Treat element in the list as”, the variable named “item” is automatically created and populated. This item contains the value of each element in the list of the records read from the “UserName_Acc_customers” entity.
To set up the criteria for Traverse Entity selected as “UserName_Acc_customers”, click the "Criteria Setup" icon.
To define settings for the traverse such that the entity can be traversed in order by the “DayMonthJoinDate” in the entity in ascending manner, set the criteria as follows:
Order By: “Join_Date”. This defines that the records to be traversed will be ordered by the Join_Date field of the entity.
Ascending: the records to be traversed will be ordered in an ascending manner, i.e., the joining date of the oldest value will be displayed first.
To add a Match Key, click the [+ Match key] button.
To define a Match key:
Select the field as “DayMonthJoinDate”.
Select Variables>current_daymonth. It displays as “current_daymonth”. The field “DayMonthJoinDate” will be matched with the variable “current_daymonth”. This match key defines that only those records will be traversed in which the DayMonthJoinDate's value is the same as the values of day and month in the current date.
To save the settings, click the [Save] button.
To define Variables for Actions in the Traverse Entity Action, go to Variables. A variable “item” is already created.
Add two (2) more Variables.
To store the value for the existing anniversary, define the first variable as follows:
Variable Name: “existing_anniversary”
Data Type: “UserName_Acc_Activities”
To send a response, define the second variable as follows:
Variable Name: “new_anniversary”
Data Type: “UserName_Acc_Activities”
To define the actions for the Traverse Entity Action, go to the Code tab and add a new Action.
To find the first item in the list of entity records, define the first Action as follows:
Select Action as “Find first List item”
Select Target variable as “existing_anniversary”
Select Source List as Variables>item>Customer_Activities. It displays as “item.Customer_Activities”.
To define the criteria for the “Find first List item” Action, click on the “Setup criteria” icon.
Based on the Filter Settings, if a record for an Anniversary is already created for a customer and the record creation date is the current date, then that record (in the variable “itemActivities”) will be updated into the variable “JoinDateAnniversaryList”. If by the end of this traverse, “JoinDateAnniversaryList” is empty, a new record will need to be created. If it has any record, the new record will not be created. To set up the Filter Settings, add two (2) Criteria bars by clicking the (+) button.
To check if the Activity Type in the traversed record is equal to “Anniversary”, define the first Criteria bar as follows:
Select item>Activity_Type. It displays as “item.Activity_Type”.
Select Operator as “Is Equal”.
Type the text “Anniversary” and press Enter. The text displays in a blue bubble. This Criteria bar checks if the value of the “Activity_Type” in the traversed record matches the type “Anniversary”.
To check if the Activity_Type in the traversed record is created today, define the second Criteria bar as follows:
Select item>Activity_DateTime. It displays as “item.Activity_DateTime”.
Select Operator as “Is today”.
To set the criteria such that both the Criteria bars must return “True”, keep the logical operator as “AND”. If both of the Criteria bars return “True”, no new record will be created. To save the Filter Settings, click the [Save] button.
Add a new action in the Traverse entity action and define it as follows:
Select Action as “Condition action”.
Enter the description as “if the anniversary exists, skip the customer”.
To check if the value for the “existing_anniversary” is received, in the Criteria tab add a new Criteria bar:
Select Source as Variables>existing_anniversary. It displays as “existing_anniversary”.
Select the Operator as “Is Set”.
To define the action if the criteria is True, in the Code tab>On True section add an Action “Continue List Traverse”.
To add a group of actions for assigning values to the record fields, a new Action after the Condition action and define it as follows:
Select Action as “Group action”.
Enter the description as “updating the anniversary fields”.
In this Group action, the actions will be configured to update the values of the fields of the target entity “UserName_Acc_Activities” through the variable “new_anniversary”. Add six (6) actions.
To update the variable “new_anniversary” with a value for the field “Activity_AssignedTo” in the entity, define the first Action as follows:
Select Action as “Update Variable”.
Select Target variable as new_anniversary>Activity_AssignedTo and press Enter. It will display as “new_anniversary.Activity_AssignedTo”.
Enter Value as “sales team” (without quotes) as constant text. This text will be displayed in the field for the record.
To update the variable “new_anniversary” with a value for the field “Activity_Type” in the entity, define the second Action as follows:
Select Action as “Update Variable”.
Select Target variable as new_anniversary>Activity_Type and press Enter. It will display as “new_anniversary.Activity_Type”.
Add the Value as “Anniversary” (without quotes) and press Enter. This text will be displayed in the field for the record.
To update the variable “new_anniversary” with a value for the field “Activity_CreatedBy” in the entity, define the third Action as follows:
Select Action as “Update Variable”.
Select Target Variable as new_anniversary>Activity_CreatedBy and press Enter. It will display as “new_anniversary.Activity_CreatedBy”.
Enter Value as “anniversary process” (without quotes) and press Enter. This text will be displayed in the field for the record.
To update the variable “new_anniversary” with a value for the field “Activity_Description” in the entity, define the fourth Action as follows:
Select Action as “Update Variable”.
Select Target variable as new_anniversary>Activity_Description. It will display as “new_anniversary.Activity_Description”.
Add the Value as “this is the anniversary of the customer’s joining date.” (without quotes) and press Enter. This text will be displayed in the field for the record.
To update the variable “new_anniversary” with a value for the field “Activity_DateTime” in the entity, define the fifth Action as follows:
Select Action as “Update Variable”.
Select Target variable as new_anniversary>Activity_DateTime. It will display as “new_anniversary.Activity_DateTime”.
Select the Value as Functions>DateTime>Now(). It will display as “DateTime.Now()”. This will update the field for the record with current date information.
To update the variable “new_anniversary” with a value for the field “Customer_ID” in the entity, define the sixth Action as follows:
Select Action as “Update Variable”.
Select Target variable as new_anniversary>Customer_ID and press Enter. It will display as “new_anniversary.Customer_ID”.
Select the Value as Variables>item>Customer_ID. It will display as “item.Customer_ID”.
The Group action will look as per the image below.
To create a new record, add a new Action after the Group action. To update the values of the fields updated in the variable (by the first six actions) into a variable createRecord and create the record in the target entity, define the Action as follows:
Select Action as “Create Entity record”. This action creates a new record in the Target Entity and its related entities.
Add a new variable by clicking [+] and name it “anniversary_response”. To save this variable, click the [Save] button. This variable will be the data type JXPResponse variable and will display the success or failure of the record creation.
Select Entity variable as “new_anniversary”. The information of the fields stored in this variable will be populated in the newly created record in the target entity.
To save the Process, click the [Save] button.
To publish the Process, click the [Publish] button.
For this exercise, skip the upcoming steps with the “Trigger Flow” action as these are a part of exercises in Introduction to Flows & Flow components. Save and publish the Process, and proceed to Test the Process section.
Triggering Flow
To trigger a flow, add a new action after "Create Entity record" and follow the steps below:
To check if the record is created successfully, add and define an Action as follows:
Select Action as “Condition action”.
Enter the description as “check if creation is successful”.
To check if the error code is equal to “0”, in the Criteria tab, add a Criteria bar as follows:
Select Variables>anniversary_response>errorcode. It displays as “anniversary_response.errorcode”.
Select Operator as “Is Equal”.
Type the Integer value as “0” and press Enter. The text displays in a blue bubble.
To configure the Flow “CustomerActivityCreated” to be triggered when this Process is executed, in the Code tab>On True section, add and define an Action as follows:
Select Action as “Trigger Flow”.
Select Flow as “CustomerActivityCreated”.
Select Entity variable as Variables>new_anniversary. It is displayed as “new_anniversary”.
Details Json field is empty.
To display the Activity_ID of the created record on the Test Console, add the last Action and define it as follows:
Select Action as “Display on test console”.
Select Variables>new_anniversary>Activity_ID. It will display as “new_anniversary.Activity_ID”.
To save the Process, click the [Save] button.
To publish the Process, click the [Publish] button.
Last updated