Send an email reminder

Use this option to send a reminder email to someone on, before, or after a specific period of time or on a specific date. You can create multiple email reminders on the same step.

  1. With the Task step selected, click the Reminders tab.
  2. Click the Email Reminder link.
  3. The Task Recipient Email reminder shows.

    The following table explains the reminder options available:

    OptionExplanationHow to Use
    Task Recipient Email TitleUse this to edit the title of the reminder.
    Click the Task Recipient Email title to edit it.
    Within Working Hours Only

    Within working hours only allows you to set the reminder to take the specified working hours into account when calculating when the reminder should occur. This function applies when either the On Date or After option is selected. If you select one of these options, the reminder will execute on a specific date or after the set time, but take working hours into consideration. If you don't select the Within Working Hours only option, the reminder does not take working hours into consideration (so in some cases, the reminder actions could occur sooner, which may not be when people are in the office).

    For example: suppose that you want to send an email reminder, and you configured the reminder to run 30 minutes After. You also configure this reminder to happen within working hours, and you selected the Sales team working hours zone, which is set up as Monday through Friday, 8 am - 5 pm.

    • Suppose the task starts at 2PM on a Friday. Since this is still within working hours for the Sales team, K2 will send the reminder email at 2:30PM, because 30 minutes of working time have elapsed.
    • Now suppose that the task starts at 10AM on a Saturday. Since this time falls outside of working hours for the sales team, K2 waits until working hours start at 8AM on Monday, and then starts counting down. This means that K2 sends the reminder email at 8:30AM on Monday, once 30 minutes of working time have passed.

    To define the working hours for your organization, click the working hours link. You must have access to, and admin permissions in, K2 Management to set the working hours. For more information on how to set your working hours see Work Hours. Keep in mind that working hours are based on static time zones because you select a specific time zone when defining the working hours. If you want the time zone to be dynamic and change depending on some condition (such as a user's geographical location), select the Type/Construct my own option to add logic that determines which working hours configuration to use when calculating the time limit.

    Select the Type/Construct my own option to configure which working hours should apply to your reminder. You can use this approach to specify a dynamic value for the working hours, based on some logic. This option is useful when you have global users across multiple time zones. You can, for example, use the result of a SmartObject method and/or functions to determine where a specific user is based, return the name of that working hours zone, and then use the returned working hours zone value in the Within working hours only option to match their location.

    Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.

    The Default working hours menu has a list of working hours defined by your K2 administrator. If you have not defined any working hours, the Default working hours option is selected.

    By default, the Within Working Hours Only option is not checked.

    Check the Within Working Hours Only box.

    Click the working hours link to edit or add the working hours parameters.

    Click the Default working hours menu to select a preconfigured set of work hours or select Type/Construct my own to configure a dynamic time zone.

    After

    Use this to configure a deadline after a task is assigned such as 7 days. After is the default option and allows you to set days, hours, minutes, and seconds. You can use a single field or multiple fields, such as two days or one hour and 30 minutes. You cannot use decimal values such as 9.5 hours. Instead use 9 hours and 30 minutes.

    Click the After option. Enter values in days, hours, minutes, and seconds.

    Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.

    On Date

    Use this to add a deadline on a specific or calculated date. Use the calendar picker to set a date or use a function such as Tomorrow.

    Select the On Date option. Click the calendar picker to show the date picker then select a date using the calendar control.

    Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.

    Before Deadline

    Use this to set the reminder some time before the task is due.

    Set days, hours, minutes, and seconds. You can use a single field of multiple fields, such as two days or one hour and 30 minutes. You cannot use decimal values such as 9.5 hours. Instead use 9 hours and 30 minutes.

    This option is only available if a deadline is defined on the Deadline tab of the step.

    The Within working hours option does not apply when you select the Before Deadline option. When you configure the task reminder to send an email to someone else before the deadline, Work Hours are not taken into consideration. If your company's working hours are, for example, Monday through Friday, 8 am - 5 pm, and the task reminder is due outside of those hours, the reminder is sent at that time and does not wait until the next working hour.

    Select the Before Deadline option.

    Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.

     

    Repetitions / Intervals

    Use this to specify reminder intervals and repetitions, select the repeat icon to show:

    • Interval - Enter values in the Days, Hours, Minutes or Seconds fields. Enter values individually or in combination.

    • Repetitions - Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields. Select the infinity icon to set infinite repetitions.

    When you configure On Date or Before Deadline, make sure to specify both an interval and a repetition value.
    Click the repeat icon to set reminder intervals and repetitions.
    Edit Email...

    Use this to send the reminder email to the task recipients. The reminder email is sent to all recipients configured on the Recipients tab. Use the Subject, Body, and Attachment fields to customize the email message. For more information see the Task Recipient Email panel section in this topic.

    You can copy content from an external source such as a web page or a Microsoft Office document (Word or Outlook) and paste it into the Body field. When you paste the content, it is sanitized and stripped from any malicious or unsupported content. This improves performance and the security and integrity of the configuration.

    Click the Edit Email... button to customize the email reminder.
    Add / Toggle / Trash bin buttons

    Use the Add (+) button to add more reminders.

    Use the Toggle button to open the menu and add a different reminder type.

    Use the Trash bin button to delete added reminders.

    Click the Add button to add more reminders.

    Click the toggle button to toggle between the different reminders. Click the Trash bin to delete reminders.

  4. Check the Within working hours check box to enable this feature. This allows you to set the reminder to occur within specified working hours. If you select one of these options (On Date or After), the task expires on a specific date or after the set time within the specified working hours. If you don't select this option, the deadline does not take these hours into consideration (and in most cases the deadline or reminder occurs sooner).
  5. You can define working hours on your K2 environment to store the working hours for your organization, or to create different zones for different departments and offices in the organization. To configure them, click the working hours link. You must have access and admin permissions in K2 Management to set the working hours. For more information on how to set your working hours see Work Hours. In this example, five different working hours are available in your organization.
  6. To view and set the predefined working hours in the reminder, click the Default working hours link menu. By default, the Default working hours option is selected. In this example, select Central Daylight Time from the menu.
  7. To create a dynamic time zone, select the Type/Construct my own option. Here you can specify a dynamic value for the working hours. This option is useful when you have global users across multiple time zones.
  8. You can use a combination of SmartObject calls and functions to determine where a specific user is based, and then use a variable in the Within working hours only option that matches their location.

    Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.

  9. To revert to static working hours, select one from the Choose Time Zone link menu.
  10. From the menu, select one of the following options; On Date, After, or Before Deadline. In this example the On Date option is selected. Use the calendar picker to select a date or drag a dynamic SmartField into the field. When you select the After or Before Deadline option, you can enter values into the field. Enter values in days, hours, minutes, and seconds. You can use a single field or multiple fields, such as two days, or one hour and 30 minutes.
  11. Click the repeat icon to configure the repetitions or intervals. Click the infinity icon to set an infinite repetition.
  12. Interval is not available when selecting the After option.
  13. Use the infinity icon to toggle between edit and infinite mode.
  14. Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.
  15. Click Edit Email... to expand the email panel.
  16. For more information on how to use SmartFields, see the SmartField Composer topic.

  17. The Task Recipient Email panel displays.
  18. The following table explains the available options:

    Option Explanation How to Use
    Send email to task participants Use this to send the reminder email to the task recipients. The reminder email is sent to all recipients configured on the Recipients tab. To send the reminder email to different recipients, uncheck the check box and add alternative recipients. By default, this option is selected.

    Check the check box to enable this option.

    Send email to workflow originator Use this to send the reminder email to the workflow originator.

    Check the check box to enable this option.

    To Allows you to specify additional users or groups to receive the reminder email.

    Select a user or group from the menu. Click the Edit button to type / construct your own user.

    Click the Add link to add additional recipients.

    If you want to specify multiple email addresses in the same line, use a semicolon as the separator, for example: codi@denallix.com;bob@denallix.com

    Subject

    Specify a subject for the email. You can type text and drag and drop values from the Context Browser to create a unique subject line.

    Type a descriptive subject line for the email, and/or drag and drop inline functions and field properties from the Context Browser into the field to create dynamic content.

    Email Send Types menu
    ( From, Cc and/or Bcc)

    Click the menu icon next to the Subject label to include From, Cc and/or Bcc recipients for the task reminder email.

    You can only specify one sender in the From field.

    If you specify a sender's email address in the From field, ensure that the K2 service account has permission to send email on that address's behalf. This is typically done by granting Delegate Rights for the K2 service account to send the email on behalf of the other email address. For more information on Delegate Rights see the Allow someone else to manage your mail and calendar article from the Microsoft Office support site. If you use an alternate From email, note that SmartActions will not function since reply emails are sent to the alternate From email and not to the one configured for SmartActions.

    Select a user or group from the menu. Click Edit to type, construct or drag and drop an email address, username or group from the Context Browser into the field.

    Click the Add link to add additional recipients.

    If you want to specify multiple email addresses in the same line, use a semicolon as the separator, for example: codi@denallix.com;bob@denallix.com

    To add From, Cc or Bcc properties, click the drop icon next to the label, and check the relevant check boxes for the email properties that you want to add. To remove a property from the email, uncheck the check box.

    Body

    Manually type the email message, and/or drag and drop values from the Context Browser into the body to create dynamic content.

    Click the Insert Field link to expand the Context Browser.

    Click the Clear link to clear all text, inline functions, and field properties from the body.

    Attachment

    Add attachments to the email. You can use a reference, a function, or a SmartObject that returns a file in the Attachment field.

    Click the Add button to add attachments fields.

    Drag and drop a document reference, function that returns a file, or a SmartObject property that returns a file to add the attachment to the email.

  19. To select a recipient click the To menu. By default, the workflow originator is selected. Other options in this menu include Originator Manager, Browse, and Type/Construct my own.



    For more information on dynamic recipients, see the Create a Dynamic Recipient topic.
  20. To add another recipient, click the Add link.
  21. From the menu, select the Browse option.

    For more information about the different browse states and errors, see the Browse States topic.

  22. The Select User page displays. In the Search Items field, type the name of the user. Use the menu to choose which label to search.

    Use any of these methods to search for a user, role and group:

    Search methodDescription
    Display name

    Use the display name to search.

    Example: Type par in the search area to return results.

    Group

    Use the display name to search for a group of users.

    Example: Type Human in the search area to return Human Resources.

    Click the See Users link to view all members of the group.

    FQN

    Use the Fully Qualified Name (FQN) to search.

    Example: Type denallix\bob in the search area to return Bob.

    When you type a user name into the field, make sure it is a valid user and you've not made any spelling mistakes as they are not validated. Typing an invalid user may result in orphaned workflow instances. If you think you have orphaned workflow instances, go to K2 Management and redirect tasks to a valid user.

    Email

    Use the Email address to search.

    Example: Type bob@denallix.com in the search area to return Bob.

    You can drag a SmartObject or variable from the Context Browser into the To, CC and BCC fields to add a user or group.

    For more information about sending an email to users based on a Get List SmartObject, see the How to: Use the All items as a collection topic.

  23. Select the user and click OK.
  24. To remove a recipient, select one and click the Trash bin icon.
  25. Click the send email type menu icon to select and add From, Cc or Bcc recipients to the email.
  26. Click the Subject field and type a value, use inline functions, or use dynamic fields by clicking the expand or collapse toggle to expand the Context Browser. Within the Context Browser, select inline functions from the Functions, Fields, SmartObjects or the Workflow categories to define your function. Click and drag the function on to the field.
  27. Type content into the Body field to customize the body of the email. Type values or create dynamic values by dragging Functions, Fields, SmartObjects and Workflow-related items from the Context Browser into the fields.
  28. To clear the formatting from the body of the mail click the Clear link. Click the Insert Field link to expand the Context Browser.
  29. To link attachments to the email notification, click Add Attachment.
  30. You can use a reference, a function, or a SmartObject method that returns a file in the Attachment field. Click Add to add more attachments. To remove an attachment, select it and click the Trash bin. In this example a document, such as a sick note, is attached to the email notification using an Employee Details reference.

    For more information on how to use SmartFields, see the SmartField Composer topic.

  31. Click Add to add additional reminders. Click the Trash bin to delete reminders.
  32. Click the toggle button to add a redirect reminder.
  33. Your changes are automatically saved.