Process Step Details - Create and Update Jobs

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.

Pro Plan Elite Plan

The following is an example of the Create Job step for practices on the Pro plan.

1342_Create_Job_Process_Step.gif

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. 

3469_Merge_Fields_icon.png

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.

Pro Plan Elite Plan

The following is an example of the Update Job step for practices on the Pro plan.

4002_Update_Job_Step_Pro.gif

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.

4267_Clear_eraser_icon.gif

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.

4268_Client_Bulk_Update_Field_Clear.gif

Note: If the field is a date and set to Current Date, you must click the to ensure "Clear" is displayed in the field, otherwise, the current value will not be removed from the client.

4270_Job_Bulk_Update_Clear_Field_Date.gif

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
The Update Job Step can also be used to convert Standard Jobs to Workflow Jobs in bulk.

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
For practices integrated with Xero Practice Manager, select from a list of Templates synchronised from XPM.

Elite Plan
Select a Job Template that matches the Job Type selected. 

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
Workflow Job States are maintained in FYI, and not synchronised back to XPM.

Elite Plan
Workflow Jobs are maintained in FYI only. When a Billing Job is marked as CompletedArchived, or Cancelled, the associated Workflow Jobs will also be updated to a matching status. For example, if a Billing Job is marked as completed, all Workflow Jobs will also be completed. 

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
For practices integrated with XPM, select a Category if required. The list will display the Job Categories set up in XPM.

If a template is selected, the Category from the template will not be added to the job.

Elite Plan
Select a Job Category from the drop-down. Only active Job Categories will be displayed.

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.

4787_Automation_Step_Update_Job_Comment.gif

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. @[{{ TriggerJobPartnerName }}] .

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.
3469_Merge_Fields_icon.png

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.

3630_Process_Step_Merge_Field_Trigger_Job.gif

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.

4068_CSV_Import_Create_Job_Job_Template_Merge_Field.gif

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.

4275_Update_Job_Merge_Field_Editor_Retain.gif

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 }}] 

4786_Automation_Step_Create_Job_Comment_Merge_Field_Notification.gif
Was this article helpful?
0 out of 1 found this helpful

Stay Up-To-Date

  • Events

    We host a range of product demos, training webinars, workshops and more.

  • Service Status

    Check for updates on the FYI Platform

  • What's New

    Round-up of new features, fixes, and other important announcements.