For the condition node to check for a particular status, you must add a statement to the Expression field in the node properties.
For example, if you want the node to check when candidates are declined, you must copy and paste the following text in the Expression field:
<<CandidateCommunicationData.JobPostingApplicationStatusXrefCode>> EQUALS "DECLINED"
The text in quotations marks at the end of the statement is the reference code for the candidate status. You can obtain the reference codes for candidate statuses from the Reference Code column in Recruiting Setup > Candidate Status.
Important: The reference code entered in the Expression field must match the code in the Candidate Status feature exactly. If, at any point, the reference code is changed in the Candidate Status feature, the workflow will not work.
To add an expression to check candidate status:
- Go to Workflow Administration > Workflow Designer.
- Select the workflow that you want to edit.
- Click the Diagram tab.
- Select the node to open the Node Properties panel.
- In the Expression field, click Create Expression. The Create Expression dialog box opens.
- Expand the CandidateCommunicationData section in the side panel, and then click the JobPostingApplicationStatusXrefCode token to insert it in the text editor.
- Place the cursor at the end of the token in the text editor, and then do the following:
- Enter a space.
- Enter EQUALS
- Enter a space.
- Enter the reference code of the required status in quotation marks.
- Notes:
- You must include a space before and after EQUALS. If you fail to do so, the workflow will end in error.
- You must ensure that the quotation marks surrounding the candidate status are straight quotes rather than curly quotes (or, smart quotes). Curly quotes can result from when you type the expression in programs like Microsoft Word and then copy and paste it to the Expression field. Including curly quotes will cause the workflow to end in error.
- Incorrect: <<CandidateCommunicationData.JobPostingApplicationStatusXrefCode>> EQUALS “DECLINED”
- Correct: <<CandidateCommunicationData.JobPostingApplicationStatusXrefCode>> EQUALS "DECLINED"
- Click X to close the dialog box.
- Click Save.