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. Click Settings on the main menu

  9. Click Message Templates on the submenu

  10. 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

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

  12. Click Actions

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

  14. Edit the template - part 1, Messages

    1. Message Template Type - The

  15. Message Template Type: This is the
    1. 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

  23. the message. 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
    1. the message.

  24. For example, a Macro can be used to add the employee or client's name to a message or notification.
    1. Macros - Macros

  25. Macros: Message Templates Macros
    1. display dynamic information in the body of the message. Text wrapped in < > will display the dynamic data for that macro.

  26. 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

  27. to the message body. The macro will appear in the message body wherever your cursor is located when you click the macro.
      1. .

        1. Example:

  28. For example:
        1. To add a name

  29. : Enter
        1. , enter a greeting

  30. and
        1. then click on

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

  32. in this example
        1. :

        1. Hello

  33.  
        1. <Profile Fullname>

  34. Notification Type: Click the Notification Type dropdown
  35. 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.

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

  37. with
  38. will receive

  39. this notification picking one of the following options:
  40. the notification

    1. None

    1. - No notification is sent

  41. .
    1. Email

    1. - Sends an email to the

  42. email
    1. address

  43. in
    1. on the

  44. users
    1. user profile

  45. .
    1. SMS

  46. 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

  47. to receive SMS text messagesSends an
      1. .

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

  49. a
    1. SMS text

  50. to the user.
  51. Message Priority

  52. : 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)
  53. - Select low, normal, or high from the drop-down

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

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

      1. All

  55. : Send
      1. - Sends to all

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

  57. Manual.
      1. manual

      2. Creator

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

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

      2. Supervisor

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

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

  62. .
      1. Manual

  63. :
      1. - Manually enter

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

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

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

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

  68. If Manual is selected, Macro for Recipients Macros will appear on the screen. This allows the user to select multiple recipient groups
      1. .

        1. Click the desired macro(s) to add to the recipient group

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

    1. Supervisor
    2. Employer
    3. Client
    4. Case Worker
    5. Guardian
    6. Employee
  71. Template Status - Select Active or Inactive from the drop-down  
  72. Click Save and Yes to confirm
  73. Template Status: Click the dropdown to select either Active or Inactive. Active is the default.
  74. Click the Save button.
  75. Select Yes in the confirmation alert window.

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.

...

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

...