Process Step Details - Create Email

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 available in the Create Email step of an Automation Process.

Create Email Step

The following is an example of a Create Email step.

503_Automation_Create_Email.gif

Create Email Details

Action

Field Details
Recipients

The Recipients field is initially set to "Client Email" as the To recipient. This uses the email address held for the Client selected for the Process and can be changed if required. Additional Recipients can be added as the To, CC, or BCC recipient(s). These are added similarly to when creating an email directly in FYI.

Click the drop-down under the Recipients field and select the required option. For details on each option, refer to Selecting an Email Recipient below.

If the selected Recipient field value is missing when the process runs, the Process creates the email as Draft, a warning message is displayed in the Process Activity, and a Comment is added to the email in FYI.

To, CC or BCC

After selecting a recipient, use the drop-down next to the To option to select To, CC, or BCC.

1915_Process_Step_Recipients_To_in_Create_Email.gif

Template

Select the Email Template to use. The Template can include Merge Fields to create the email text. Click the Open Template button to open the Template in a new window.

0005

Note: Any changes made to the Template after the automation has been created will be automatically reflected in the process.

Attachments

Add an attachment to the email. This can be a document created by a preceding step within the Process, or select Trigger Document to attach the document from the document Filter.

The Attachments drop-down displays Trigger Documents and relevant preceding steps that generate a document, including Create Word, Create Spreadsheet, Create Presentation, or Create PDF steps.

For practices on the Elite plan, invoices and credit notes can be attached once they have been assigned an invoice number or credit note number and the PDF file has been generated. It's recommended to set up an Invoice View filtered by Invoice Status and any other relevant filters to ensure only invoices that are ready to send are included.

Sender

The Sender defaults to the person creating the Process. If the email is configured to be sent immediately, the Sender can be set as:

If the email is set to Draft, once the automation creates the drafted emails, the Sender will be the user who clicks "Send" on the email.

If the value for the Sender is missing, the Process creates the email as Draft, a warning message is displayed in the Process Activity, and a Comment is added to the email in FYI.

Send attachment(s) Determines how email attachments are sent, either by email or using Collaborate.
Attachments as PDFs Set Attachments as PDFs to "On" to send the attachments as PDF files, or "Off" to send them in their original file format.
Co-edit with client Co-edit with client is available only when sending attachments by Collaborate, and the option Attachments as PDFs is set to No.
Save or Send

Select whether to save the email as "Draft in FYI", "Draft in Outlook", or "Send Immediately".

Note: Emails saved as "Draft in Outlook" are marked as "Sent" in FYI immediately and should be managed from Outlook directly from that point onwards. The Workflow Status will be set to "Completed".

Filing

The Filing section controls the name of the email and where it is filed in FYI.

Field Details
Name

The name of the email created in FYI.

When selecting a Template, the name can be set as "Default from template" to use the name of the template for the email. Alternatively, type directly into the field to set the Name.

Merge Fields can be used in the Filing Name field. For example, select Name from the Merge Field Filter Trigger Client and add "- Monthly Reporting" to create an email named "Frank Marshall - Monthly Reporting". Refer to Including Merge Fields in Automations.

AutoFile

AutoFile can be enabled or disabled as required.

  • Disabled - The email will be filed using the Cabinet and Categories selected in the Automation Process step.
  • Enabled - The Cabinet and Categories are selected based on the order defined in Email AutoFile Filing Defaults. For example, Filing Defaults may be applied from the Client, the User, or the Practice. Refer to Managing Email AutoFile Filing Defaults.
Cabinet and Categories Available when AutoFile is set to Disabled. Select the Cabinet and Categories required for the email.
Filing

The Filing Status defaults to Filed.

If set to Unfiled, the email will be displayed in the Owner's In Tray. If an Owner is selected in the Workflow section, that user is used. If the Owner is not selected, the owner of the Automation Process is used.

Workflow

The Workflow section can be used for information purposes, to set email approval, or to make the email read-only. 

Field Details
Owner

Used to select the owner of the email. This can be set to a specific user, or Merge Fields can be used to automatically select the user.

When selecting a Custom Field, only Custom Fields with the Type set to "User" are available. Refer to Custom User Roles.

When a drop-down option is used to select the Owner:

  • For a Process run for a Client, the Manager, Partner, or Custom User Role is taken from the Client Details.
  • For a Process run for a Job, the Manager, Partner, or Custom User Role is taken from the Job Details.

If there is no Partner or Manager assigned to the Client, the Process Owner is added as the Owner of the email created in the step.

Approver

Used to select the Approver of the email. This can be set to a specific user, or Merge Fields can be used to dynamically select the user.

When selecting a Custom Field, only Custom Fields with the Type set to "User" are available. Refer to Custom User Roles.

When a drop-down option is used to select the Approver:

  • For a Process run for a Client, the Manager, Partner, or Custom User Role is taken from the Client Details.
  • For a Process run for a Job, the Manager, Partner, or Custom User Role is taken from the Job Details.
Workflow Status Can be set for information purposes, to set the approval of the email, or to set it as read-only. This is set to Not Started by default.

Task

The Task section is used to create a task for the email when the Process runs. The Start Date of the task is automatically set to the current date. 

Field Details
Create a task Controls whether a task is created by the Automation Process. If set to Yes, additional fields are displayed.
Template

Select a Task Template, if required, to prepopulate the remaining fields, for example, Assignee.

Advanced Task Fields, for example, Priority, Job Category, or Work Type, can only be populated using the selected Task Template.

Subject Enter a brief subject for the task. Merge Fields can be selected to add relevant Client or Job information.
Assignee

Select a specific user, or use Merge Fields to assign the task automatically. Depending on the Automation Filter, this can include roles such as the Job Manager or Partner. For manual processes, the task can be assigned to the Automation Initiator User. Custom User Roles can also be selected from the Merge Fields window.

When using the drop-down option to select the Assignee:

  • For a Process run for a Job, the Manager or Partner is taken from the Job Details.
  • If there is no Partner or Manager assigned to the Job, the Assignee is set to Unassigned.
Delegator Select a specific user, use Merge Fields, or select an available role based on the Automation Filter. When unassigned, the Delegator is set to System. The Delegator receives a notification when the task is completed.
Due date

Select the number of days before the task is due. Set this to 0 days to make the task due immediately.

If Custom is selected, the Days field is displayed, allowing a value up to 365 days.

Status Defaults to Not started. The Status can be changed to In Progress.
Cabinet If Task Security is set in Practice Settings, select a Cabinet to apply Cabinet Security to the task. Refer to Managing Practice Settings.
Blocking

Set Blocking to On to stop the Process until the task created by the Automation Process is set to Completed. When the task is completed, the next step in the Process commences.

Note: If the Process only contains one step, do not set a task created with Blocking to On, as the Process will remain outstanding until the task Status is set to Complete.

AutoComplete Allows Tasks created by an Automation Process to be automatically set to Complete when the selected condition is met. Refer to AutoComplete Tasks.
Details Enter brief details of the task. Merge Fields can be selected to add relevant Client or Job information.

Time

This feature is available to practices on the Elite plan.

The Time section in the drawer is automatically displayed when the Create a task option is enabled.

Time in Task Automation Process steps is used in Capacity Planning and AutoTime.

By adding time, practices can forecast the time required for users to complete tasks and create draft timesheets when the task is complete.

When Time has been configured in the Automation Process step, a clock icon is displayed in the drawer next to the Time heading.

Field Details
Allocation

The method used to calculate the time assigned to the task.

Fixed - The Default Time entered is always used when the time entry is created, regardless of the size of the Client or the Job Time Budget.

Relative - Calculates the time relative to all Tasks on the Job. The total Default Time for all Tasks in the Process is compared to the Estimated Hours for the Job, and Relative times are proportionately increased or decreased.

For example:

  • The total Default Time for all Tasks in the Process is 10 hours.
  • A Task is set to Relative and has a Default Time of 30 minutes.
  • If the Estimated Hours for a Job is 30 hours, the allocated time for the Task is increased to 1 hour 30 minutes.
  • If the Estimated Hours for a Job is 2 hours, the allocated time for the Task is reduced to 6 minutes.
Default Time

Set the estimated time that the action or Task will take.

Time can be entered using hours and minutes (hh:mm), a whole number, or a decimal. Decimals are converted using 6-minute increments. Once entered, the time is displayed using the hours and minutes format. Refer to Time Overview.

For example, to add 12 minutes, enter:

  • 00:12
  • 12
  • 0012
  • 0.2
Custom Fields

Used to update Custom Fields when a time entry is created after completing a task.

When a Custom Field is selected, a new field is added to the drawer and the selected field is removed from the available options. Additional Custom Fields can be selected from the drop-down.

Update the added Custom Field by selecting a value from the drop-down or clicking the Merge Field icon. When updating a Custom Field that is a Date, it is set to Current Date by default.

Custom Fields on the time entry are updated using the selections made in the Automation Process step, along with any values inherited from the Job.

Note: To inherit from the Job, the Custom Fields must be enabled for both Job and Time.

Comment

Automatic notifications can be defined and triggered by an Automation Process using Comments. Refer to Automation Notifications.

Field Details
Create a Comment Set the option to Yes to display the Comment field.
Comment

Enter the details of a comment, using the @ symbol to notify a specific user.

Note: The following Merge Fields do not work in the Name field or Comments in Processes.

  • Original File Name, except in the Alter Document step.
  • Upload Folder.
  • Share Folder.

Working with Create Email

Selecting an Email Recipient

The Recipients field is initially set to the "Client Email". When clicking the drop-down, the recipient can be changed to any of the following options: 

1914_Process_Step_Recipients_in_Create_Email.gif

Recipient Option Details
Search for internal user Select from Internal Users to be included on the email.
Enter a new email Enter a valid new email address.
Client Email

Selected by default.

When there is no valid email address on the Client Summary workspace:

  • If Client Email is the only recipient, the email will not be sent.
  • If Client Email is selected together with Enter a new email, the email will be sent to the valid address entered in the new email field.
Partner Email Send the email to the relevant Partner for the Client or Job.
Manager Email Send the email to the relevant Manager for the Client or Job.
Custom Field Select from a Custom Field that has the Type set to "Email". The name of the Custom Field will be displayed in the list.

Note: For Partner Email and Manager Email:

  • For a Process that uses a Client View in the Filter, the relative Partner or Manager is taken from the Client.
  • For a Process that uses a Job View in the Filter, the relative Partner or Manager is taken from the Job. If this does not exist for the Job, it is taken from the Client.
  • For a Process that uses a Document View in the Filter, when Inherit Job is enabled, the relative Partner or Manager is taken from the Job selected for the Document. If there is no Partner or Manager held for the Job, the relative Partner or Manager is taken from the Client selected for the Document. When Inherit Job is disabled, the value is taken from the selected Client.
  • For a Process that uses a Document View in the Filter, if a Template is being used that has Merge Fields for Job Custom Fields, the Process must have Inherit Job enabled to pick up the value from the Job.

Selecting a Sender as Partner, Manager, or Custom User Role

For Partner, Manager, or Custom User Roles, Merge Fields can be used on the Sender Filter to select the appropriate User. Click the Merge Field icon and select from the available Merge Fields. For example, select the Merge Field Filter Trigger Client and select "Accountant". This ensures the Custom User Role associated with the Client is selected as the Sender. Refer to Including Merge Fields in Automations.

When using a Merge Field to select the Sender:

  • A Filter must be selected on the Automation to use Custom Fields.
  • Only Custom Fields that have the Type set to "User" are included in the list of what can be selected for the Sender. Refer to Custom User Roles.

3629_Process_Step_Sender_Create_Email_Merge_Field_Accountant.gif

When a drop-down option has been used to select the Sender:

  • For a Process that uses a Client View in the Filter, the relative Partner, Manager, or Custom User Role is taken from the Client.
  • For a Process that uses a Job View in the Filter, the relative Partner, Manager, or Custom User Role is taken from the Job. If this does not exist for the Job, it is taken from the Client.
  • For a Process that uses a Document View in the Filter, when Inherit Job is enabled, the relative Partner, Manager, or Custom User Role is taken from the Job selected for the Document. If there is no Partner, Manager, or Custom User Role held for the Job, the value is taken from the Client selected for the Document. When Inherit Job is disabled, the value is taken from the selected Client.

Using Merge Fields with Email

Merge Fields can be used in the Create Email step to insert data dynamically when the Automation Process runs. Merge Fields can insert data from:

  • The selected Filter, for example, trigger Clients or Jobs.
  • Steps earlier in the Process.
  • A CSV Import file, where relevant to the Automation Process.

Click the Merge Field icon to select from the available Merge Fields. Refer to Including Merge Fields in Automations and Merge Fields Glossary - Automation Fields. For advanced formatting options, refer to Formatting Merge Fields.

For the Create Email step, Merge Fields can be used in the Email Template, Recipient and Sender selections, the Name in the Filing section, and supported fields in the Workflow, Task, and Comment sections.

If you are importing a CSV file, the Trigger Data section in the Merge Fields window displays the CSV file columns that can be selected.

Note: The following Merge Fields do not work in the Name field or Comments in Automation Process steps.

  • Original File Name, except in the Alter Document step.
  • Upload Folder.
  • Share Folder.

Merge Fields that do not work in the Name or Comments in Process Steps

Note: The following Merge Fields do not work in the Name field or the Comments in Processes.

  • Original File Name (except in the Alter Document step)
  • Upload Folder
  • Share Folder
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.