Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This feature is currently in beta. Please Get in Touch if you are interested in using it.

Expand
titleOn This Page
Table of Contents

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

Email

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

Email

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:

Note

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

Info

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.

...