This feature is currently in beta. Please Get in Touch if you are interested in using it.
When you Create a New Action for a learner Workflow Transition, you will need to choose the Action Type, which controls the type of action that will take place. Each of these types works differently and affects the rest of the creation process.
This page explains each of the codes and how they work.
Set Database Field Value
The Set Database Field Value allows you to set a value for a data field in the record or a linked child record. You can set the field to either an absolute value or to match the value in another data field. This process is made up of the following steps:
Source Options
This is where you identify the field that you want to be changed. This is referred to as the Source Field.
The first step allows you to specify the Record Type where you want to find the source field. This could be the main record linked to the workflow, or a child record attached to that main record. Depending on the workflow type, the following options are available:
Workflow Type | Record Type | Location |
---|---|---|
Learner | Learner | The entire Learner Record |
Review | Reviews tab in the Delivery Plan | |
Component | Components tab in the Delivery Plan | |
Appointment | Calendar in the Delivery Plan | |
Call | Communications tab in the Learner Summary | |
Communications tab in the Learner Summary | ||
Applicant | Applicant | The entire Applicant Record |
Appointment | Calendar in the Applicant Summary | |
Call | Communications tab in the Applicant Summary | |
Communications tab in the Applicant Summary |
Once you have chosen the record type, you can then search for the specific Field Name from the drop-down menu.
Select Target Type
Once you have identified the field you want to change, you then need to specify how you want to change the value. The following options are available:
Static Value – This allows you to set the field to a fixed value.
Lookup Field – This allows you to set the field to match another field in the record or a linked child record.
Built In Function – This should only be used if the source field is a date value. It allows you to set the source field to a date relative to the day that the action takes place.
The Target Options for each type are explained below.
Target Options
The final step allows you to specify the actual value that will be used to populate the source field.
If the Target Type is set to Static Value, a field will be available for you to enter the value.
If the Target Type is set to Lookup Field, fields will be available to locate the field which you want the source field to match. The Record Types and Field Names available here are the same as those for the source field, as shown in the table above.
If the Target Type is set to Built in Function, a field is available to specify the function. Currently, the only available option here is Today, which will set the target value as the date that the action takes place.
For each target type, the following fields are also available for date values or fields:
Add Days – Here you can choose a number of days to add on to the target. This means that the source field will be set to this modified value rather than the original target value.
Working Days – If this is ticked, the Add Days number above will add on working days only, rather than all 7 days of the week.
Date Only – If this is ticked, any fields that include both a date and time will only have the date included when used to set the value for the source field.
Add Tag
The Add Tag type allows you to add Tags to the record when the transition is enacted. This process is made up of only one step, Source Options, where you can search the drop-down menu for any tags to attach to the record. You can use the X icon to remove tags from the field.
Remove Tag
The Remove Tag type allows you to remove Tags from the record when the transition is enacted, provided that those tags were attached before. This process is made up of only one step, Source Options, where you can search the drop-down menu for any tags to remove from the record. You can use the X icon to remove tags from the field.
Create Form
The Create Form type allows you to create a WebForm Instance linked to the record. Depending on the workflow type, the following WebForm Type will be created:
For an Applicant, a Learner Signup form.
For a Learner, a Learner Change Request or Learner File form.
This process is made up of only one step, Source Options, where you can specify the following details:
Form – Here you can choose which WebForm you want to create the instance from.
Form Option – Here you can choose what happens to the WebForm instance when the action takes place. There are two options:
Create Form – This will Create a New Instance of the form ready for you to either fill yourself or send out. The instance will be available in the Forms List with a Live status.
Create and Send – If you have set up a Default Form Owner and Signature Defaults in the WebForm Builder, this will Create a New Instance of the form and automatically send it for Remote Filling and Signing. The instance will be available in the Forms List with an Awaiting Remote Signatures status.
For the Create and Send option to work, you will need to make sure that the following is true for the form in the WebForm Builder:
The Default Form Owner is set to an officer role that is valid for the learner or applicant.
A valid Default Remote Signature address has been entered for all signature fields.
Any mandatory questions which do not have a To be filled by user specified have a Default Value entered.
Create bksb Account
This option is only available if you are licensed for bksb Integration. If you are already licensed, you will need to Contact Us to have the integration enabled in PICSWeb.
The Create bksb Account type allows you to create an account in bksb for the Learner or Applicant on the workflow. This process is made up of only one step, Select Source Type, where you can choose whether the account will be Active or Dormant upon creation.