22 June 2023

How to move applications to folders

The following procedure describes how to build an example workflow that moves applications to folders.

How it works

The image Example workflow shows a workflow that runs when an application completes a clearance check. If applications have passed the academic clearance check, the workflow moves the applications to the folder Ready for decision as shown below.

Example workflow
workflow designer example

Build the workflow

Build the workflow as follows:

  1. Create a new scheme: in Business Entities, on the Workflow Service Code of ADMISSIONS with the Business Entity Code of APPLICATION go to the business entity scheme menu button and then selectview schemesView Schemesand thenthe create new scheme button. Then, define the following:

    • On Scheme details, in Custom event, select Application clearance check completed.
    • Select add scheme button, and Save and view scheme.
    Scheme details
    the scheme information section highlighting custom name set to application clearance check
  2. On the workflow designer, check that the initial Start activity is present. To add an initial activity, select create activity and then drag the activity to the required position.

    Then, edit the activity: double-click the activity or select the activity and theneditand edit the activity as follows:

    • Enter Start in Name and State. Note that when you enter text in Name, the State changes to the same text.

    • Select Initial and For set state.

    • Do not Create any actions.

    Initial activity
    the workflow designer create activity pop up
  3. Add the activity that moves applications to the Ready for Decision folder: select the initial activity, then to add the transition and activity, select add transition and activity.

    Transition and activity
    workflow designer example with transition and activity
  4. Edit the transition as follows:

    • Set the Trigger to Auto.

    • Set the Condition to Conditional?

    • Set the condition Type to Action and, in Action, select HasClearedAcademicClearance so that if the application has passed academic clearance the activity moves the applications.

    The image Conditional transition shows the transition is conditional and the defined condition.

    Conditional transition
    workflow designer example with conditional transition of admissions dot application dot has cleared academic clearance check set
  5. Edit the activity to move applications to the Ready for Decision folder as follows:

    • In Name, enter Move to Ready for Decision. Note that the State automatically becomes the same as the name.

    • Select Create and then, in Action, select MoveToFolder.

    • Set the Action parameter: select the button set and set the Folder code to Ready for Decision.

    Settings for the activity to move to ready for decision
    the workflow designer create activity pop up with name set to move to ready for decsision and action set to move to folder
  6. Add the final activity that ends the workflow process: in Name, enter End and then select Final as shown in the image Settings for the final activity.

    Settings for the final activity
    the workflow designer create activity pop up with the name set to end
  7. Add a transition Otherwise from the initial activity to the final activity: to add a transition, select the initial activity button add transition and drag the transition arrow to the final transition. Then, edit the transition as follows:

    • Set the Trigger to Auto.

    • Set the Condition to Otherwise

    Transition otherwise
    workflow designer example with conditional transition set from the inital activity to the end activity
  8. Add a transition from the move to folder transition to the final activity: to add a transition, select the initial activity button add transition and drag the transition arrow to the final transition. Then, edit the transition as follows:

    • Set the Trigger to Auto.

    • Set the Condition to Always

    Final transition
    workflow designer example with conditional transition set from move to ready for decision activity to the end activity