Plan: Not Available: Intermediate Available: Pro or Elite
Users: Not Available: All users Available: FYI Admins or User Group permissions
Practice Management Source: Available: All sources
This article gives details and examples of the functions that are available in steps used to create and update Jobs.
Process Steps
Create Job
The Create Job step is used to create a new job in FYI. For practices integrated with Xero Practice Manager, the Job is synced to Xero Practice Manager where the job number will be applied.
The fields displayed in the Create Job step will depend on whether the practice is on the FYI Pro or Elite plan. Refer to Job Fields below for details on each field. For information on using Merge Fields to insert data from other sources, refer to Using Merge Fields with Jobs below.
The following is an example of the Create Job step for practices on the Pro plan.
The following is an example of the Create Job step for practices on the Elite plan.
If data is entered directly into a field, it will be applied to all jobs created by the automation process. For example, if the Manager selected was "Anna Jordan", all jobs created using this Automation Process step would be set to "Anna Jordan".
Merge Fields can be used to insert data from a CSV Import file or another source of data in FYI, by clicking the Merge Field icon.
Update Job
The Update Job step is used to update the Current Job (the Job that triggered the automation or a Job created from another step). You can alternatively select a specific Job to update by searching in the Job field. For practices on the Elite plan, this step can also be used to convert Standard Jobs to Workflow Jobs.
The fields displayed in the Update Job step will depend on whether the practice is on the FYI Pro or Elite plan. Refer to Job Fields below for details on each field. For information on using Merge Fields to insert data from other sources, refer to Using Merge Fields with Jobs below.
The following is an example of the Update Job step for practices on the Pro plan.
The following is an example of the Update Job step for practices on the Elite plan.
The Update Job step includes the ability to clear fields currently populated for the job. Where the Eraser icon is displayed, the field can be set back to blank when the Automation Process is run, for example, to remove the value selected for a Custom Field.
When the Eraser icon has been selected, the icon will turn red, and Clear will be displayed in the selected field. If you don't want the field to be reset to blank, click the red icon to reset the field back to Unchanged.
Note: If the field is a date and set to Current Date, you must click the X to ensure "Clear" is displayed in the field, otherwise, the current value will not be removed from the client.
Create Job and Update Job Details
Job Fields
| Field | Details |
| Client | The job can be created for the "Current Client" (the client that triggered the process) or for a specific client by searching in the client field. |
| Type Elite Plan |
Selects the Job Type, either Standard, Billing, or Workflow. If Workflow is selected, an additional Billing Job field will be displayed. When importing data from a CSV Import file, separate processes must be created for each Job Type. Elite Plan To update the Job Type to Workflow, select "Workflow" from the Type dropdown. Once selected, a Workflow Job Template and associated Billing Job must be selected. When selecting a Billing Job, Merge Fields can be used to select the Billing Job. Consider the Billing Job in your selection to avoid allocating Workflow Jobs to the incorrect Billing Job. Note: Billing Jobs cannot be converted to Workflow Jobs. If a Billing Job or Workflow Job are selected in the Process View Filter, an error message will display in the Process History tab. Refer to Process History and Activity. |
| Template |
Pro Plan Elite Plan The Template defines the billing details for invoicing, including selecting the Xero Ledger. Key Job Details, such as Job Name, will be populated automatically unless already filled. |
| Name |
The name of the Job. If a Job Template has been selected, the name will be filled in automatically, but can be overwritten if required. Note: If your practice has enabled the XPM Workflow Jobs setting, the Name cannot be updated for XPM Workflow Jobs, only for Billing Jobs. |
| State |
Select the relevant Job State, for example, Planned, In Progress, or On Hold. If a Job Template has been selected, the State will be populated but can be overwritten if required. When importing data from a CSV Import file, Merge Fields can be used to select the Job State listed in the CSV file. Job States are mandatory when creating jobs, and optional when updating jobs. Pro Plan with XPM Workflow Jobs Enabled Elite Plan Workflow Jobs can be manually updated to a different status if required. Note: Billing and Workflow jobs must be updated separately when changing their state to Cancelled, Completed, or Archived. To update their state to one of these types, the filter view must include only Billing jobs or only Workflow jobs. |
| Cabinet | Displayed if the practice has Job Cabinet Security enabled. Only users with access to the selected Cabinet can view the Job. |
| Category |
Pro plan If a template is selected, the Category from the template will not be added to the job. Elite Plan |
| Primary |
Used to nominate the job as the Primary Job. This will display in the Primary column of the Jobs list, and act as your lead job for the client. Merge Fields cannot be used to select whether the Primary option is toggled on or off. When importing data from a CSV Import file, separate import files must be created for Primary jobs. |
| Budget Pro Plan |
Can be entered as a specific amount, for example, 1,200, or as a Merge Field. |
| Budget Amount Elite Plan |
Can be entered as a specific amount, for example, 1,200, or as a Merge Field. |
| Budget Hours Elite Plan |
Displayed only for Standard and Workflow Jobs. Enter the number of hours for the job. For Billing Jobs, the Budget Hours is calculated based on the Budget Hours for the Workflow Jobs linked to the Billing Job. |
| Start Date | The date the job commenced. The Start Date can be set to the Current Date, a specific date, or using a Merge Field, set to a date based on another field. |
| Due Date | Must be dated after the Start Date. If a Merge Field is used to calculate the Due Date, and the date is before the Start Date, when the Automation Process is run, the Due Date will be updated to match the Start Date. A warning in the Process History will be displayed to advise that the Due Date was changed. |
| Assigned User Pro Plan |
Displayed when FYI as Primary for Client Maintenance is disabled. Select the user assigned to the Job. Only one user can be assigned when creating a job in FYI. If the automation was triggered by another job, you can select the same User from the Job that triggered the automation. For practices on the Elite plan, users are assigned via Custom User Roles. Refer to Custom Fields to select the role, and assign the user accordingly. Refer to Assigning Users to Jobs. |
| Manager | Select the Manager assigned to the Job. |
| Partner | Select the Partner assigned to the Job. |
| Description |
The description for the job. If you select a Template with a Description in the Create Job, the Description from the Template will not be added to the Job that is created. If relevant, you can add the Description directly in the Create Job step. |
| Custom Fields |
If you select a Custom Field, a new field will be added to the drawer. Once a Custom Field has been selected, it will be removed from the options available in the Custom Field drop-down list. You can add additional Custom Fields by selecting them from the drop-down. Update the added Custom Field by selecting a value from the drop-down, or clicking the Merge Field. When updating a Job Custom Field that is a Date, this is set as the "Current Date" by default. If importing data from a CSV Import file, Custom Fields must have a separate column in the file. Use Merge Fields to select the relevant column for the Custom Field from the Trigger Data section. Columns must have the correct Type selected in the Automation Filter to be available to select. For example, a "Date" Custom Field will only show columns with "Date" selected as the Type in the filter. |
Comments
Automatic notifications can be defined and triggered by an Automation Process using Comments. For example, a comment could be created tagging the Job Manager Name when the job is updated.
Note: If the Automation Process is unable to create or update the job, a comment will not be created.
Changes to the Automation step comment fields will be displayed in the Process - Activity tab.
When the process is run, comments will be displayed on the Job - Comments tab.
| Field | Details |
| Create a Comment |
By default, a comment will not be created. Set the option to Yes; the Your Comment field will be displayed to customise the comment added to the job. |
| Your Comment |
Enter the details of a comment, using the @ symbol to notify a specific user. Click the Merge Field icon to use Merge Fields in the comment. Refer to Using Merge Fields with Jobs below. To use a Merge Field with a user notification, add the square brackets, [ ], to the outside of the Merge Field e.g. |
Using Merge Fields with Jobs
Data can be inserted from other sources using Merge Fields by clicking the Merge Field icon. Refer to Including Merge Fields in Automations. For advanced formatting options, refer to Formatting Merge Fields.
For example, if a job triggered the automation process, you can automatically select the same values as the original job. This is particularly useful when you create the same job every year, for example, End of Financial Year Job Rollover. You can also use this feature to add a final Create Job step at the end of the Automation Process for Compliance, for example, when a job is marked as Completed, create a new job for the next financial year.
Available Merge Fields will be displayed in the Trigger Job section. If a Client View has been selected for the Automation Process, Trigger Job will not be available.
Data imported from a CSV Import file will be displayed in the Trigger Data section, excluding the Job Name, which is available in the Trigger Job section.
If the field has the Clear button available on the Update Job step, when selecting a Merge Field, an additional option will be available from the Merge Field Editor. If the data sourced by the Merge Field is blank, you can choose whether to retain the existing field value on the job or to clear it. For example, if you're updating the Job Manager to match the Client Manager, and no Manager is set, you can either keep the current Job Manager or set it to blank.
When using Merge Fields with Comments, you can use the Merge Field to select the relevant user to send a notification. For example, to tag the Job Partner in the comment, type the left square bracket [ and @ symbol, select the Merge Field, and type the right square bracket ]:
@[{{ Step1JobPartnerName }}]