Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Description: In this topic you , the user will learn about message templates. Message Templates are automated messages and notifications that are sent to DCI users based on specific events or triggers in DCI. Message Templates can only be edited by a Super User.

Role Required: Superuser

Permission Required: N/A

Message Templates are split into two categories, messages and notifications.

  • Messages are sent to the user’s inbox in the DCI messaging module. Because messages are housed completely within DCI, they contain more detailed information than notifications. Messages will include hyperlinks to specific objects in DCI, such as a profile or a punch entry. When active, all message templates will send a message.
  • Notifications are sent to a user’s email address and/or as a text message. Because notifications are sent outside of DCI, they contain limited information

...

  • to protect confidentiality. The user must log into DCI to view the details.

...

  • For a user to receive a text message notification, they must verify their mobile phone number under employee settings on their

...

  • profile.

*Please note: There are many different Message Template types. To view the complete list, follow the View Message Templates steps below. 

Role Required: Super User

Permission Required: N/A

View Message Templates

  1. Log in to DCI with your personal profile.
  2. Select Settings from the Main Menu.
  3. Select Message Templates from the Submenu.
  4. Use the Search functionality to find the holiday schedule you would like to view.
  5. Click anywhere on the Message Template you would like to view to open the Message Template Details screen.

...

  1. Click Settings on the main menu
  2. Click Message Templates on the submenu
  3. Scroll through the list (click the Load More button at the bottom until all records have loaded) or use the filters to locate specific message templates
  4. Select a message template to view the details by clicking anywhere on the row

Edit a Message Template

  1. Log in to

    DCI with your

    DCI with personal profile

    .

  2. Select Settings from the Main Menu.
  3. Select Message Templates from the Submenu.
  4. Use the Search functionality to find the holiday schedule you would like to edit.
  5. Click anywhere on the Message Template you would edit to view to open the Message Template Details screen.
  6. Click Actions
  7. Click Edit Message Template and update the details using the following:
  8. Message Template Type: This is the
  9. Click Settings on the main menu

  10. Click Message Templates on the submenu

  11. Scroll through the list (click the Load More button at the bottom until all records have loaded) or use the filters to locate a specific message template to edit

  12. Select a message template by clicking anywhere on the row

  13. Click Actions

  14. Select Edit Message Template from the drop-down menu

  15. Edit the template - part 1, Messages

    1. Message Template Type - The event in DCI that triggers the message to be sent. This field is grayed

  16. -
    1. out and cannot be edited.

    2. Message Template Subject

  17. : This
    1. - Subject text will appear in the subject line

  18. for
    1. of the message.

  19. You can keep the default subject or replace the text with a subject line that you want your users to see when they receive the message or notification.
    1.  

    2. Message Template Body

  20. : This is the
    1. - The body of the message.

  21. Here you can type
    1. Enter the text that

  22. your user
    1. users will see when they open the message.

  23. Remember, these are system generated messages, so we want the body text to be appropriate for any user who triggers the event in the system. In addition to body text, the user can add Macros, which can pull in system information to be displayed in the message. For example, a Macro can be used to add the employee or client's name to a message or notification.Macros: Message Templates Macros
    1. Macros - Macros display dynamic information in the body of the message. Text wrapped in < > will display the dynamic data for that macro.

  24. Macro buttons are located below the body text field, but will be inserted in the body text field when clicked.
    1.  

      1. Place the cursor in the message body where the macro should be inserted. Click the desired macro(s) to add

  25. to the message body. The macro will appear in the message body wherever your cursor is located when you click the macro.
  26. For example:
      1. .

        1. Example: To add a name

  27. : Enter
        1. , enter a greeting

  28. and
        1. then click on

  29. the <Profile Fullname> macro
        1. the <Profile Fullname> macro. The body text box would display the following

  30. in this example
        1. :

        1. Hello

  31.  
        1. <Profile Fullname>

  32. Notification Type: Click the Notification Type dropdown
  33. Edit the template - part 2, Notifications

    1. Notification Template Subject - Subject text will appear in the subject line of the notification.

    2. Notification Template Body - The body of the notification. Text that users will see when they open the notification. 

    3. Macros - Notifications have only one macro to select. This is the Message Details Link macro, which users will click to log in to DCI and view.

      1. Place the cursor in the message body where the macro should be inserted. Click the desired macro to add.

  34. Notification Type - Select from the drop-down to choose how the user

  35. with
  36. will receive

  37. this notification picking one of the following options:
  38. the notification

    1. None

    1. - No notification is sent

  39. .
    1. Email

    1. - Sends an email to the

  40. email
    1. address

  41. in
    1. on the

  42. users
    1. user profile

  43. .
    1. SMS

  44. Users
    1. - Sends a text message to the number on the user profile

      1. Please note: To receive SMS text notifications, the user must verify their mobile number in their profile settings

  45. to receive SMS text messagesSends an
      1. .

  46. Both
    1. All - Sends the notification via email and

  47. a
    1. SMS text

  48. to the user.
  49. Message Priority

  50. : Click the Message Priority dropdown to select Low, Normal or High priority.
    1. NOTE: High priority messages display a Red Alert bar below the Main Menu on the a users profile. The user can click on the Red Alert bar to open the Message Center.
    Message Recipients: This dropdown will determine the user(s)
  51. - Select low, normal, or high from the drop-down

    1. High priority will display a red banner on the user's dashboard

  52. Message Recipients - Select from the drop-down to determine the users who will receive the message or notification. The options are:

      1. All

  53. : Send
      1. - Sends to all

  54. Message Recipient types listed below,
      1. message recipient types except for

  55. Manual.
      1. manual

      2. Creator

  56. : The
      1. - Sends to the creator of the object that triggered the message. For example, the creator of the punch entry for the

  57. “Punch Created”
      1. Punch Created message template.

      2. Supervisor

  58. : Users
      1. - Sends to users with the

  59. Supervisor Role over the Cost Center
      1. supervisor role for the cost center in which the event occurred

  60. .
      1. Manual

  61. :
      1. - Manually enter

  62. in
      1. the names of the DCI users.

  63. Here you can enter
      1. Enter a specific user

  64. or multiple user, or
      1. (s) or use the

  65. Macros the
      1. macros that open when Manual is selected

  66. If Manual is selected, Macro for Recipients Macros will appear on the screen
      1. .

  67. This allows the user to select multiple recipient groups.
        1. Click the desired macro(s) to add to the recipient group

  68. .
  69. The macro
        1. Macro options include the following, all of which must be in the same cost center to receive the notification or message:

  70. Supervisor
  71. Employer
  72. Client
  73. Case Worker
  74. Guardian
  75. Employee
  76. Template Status
  77. : Click the dropdown to select either Active or Inactive. Active is the default.
  78. Click the Save button.
  79. Select Yes in the confirmation alert window.
  80. - Select Active or Inactive from the drop-down  
  81. Click Save and Yes to confirm

Preferred Language Message Templates

DCI has the ability to can send messages and notifications in the user's preferred language. In order to To use this feature, an instance-level setting must be enabled. Please contact your authorized DCI representative to learn more. The languages currently support supported by DCI are as follows:

  • English
  • Spanish
  • Vietnamese
  • Russian
  • Mandarin
  • Somali
  • Arabic

Translate a Message Template to a Preferred Language

To translate a Message Templatemessage template, follow the steps to Edit.

...

above to edit, clicking the blue Translate button for each language. The following fields can be translated:

  • Message Template Subject
  • Message Template Body
  • Notification Template Subject
  • Notification Template Body

...

  1. For example, if your program has English and Spanish speakers only, click on the blue Translate button for all the fields labeled Spanish.

...

Filter by label
showLabelsfalse
max5
spacesDCI
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("message","message_templates") and type = "page" and space = "DCI"
labelsmessage message_templates

...