Saltar al contendio prinicipal

SLA Setup

Advertencia

Esta página aún no se encuentra traducida al español.

Tutorial on how to set up a reminder to finish a task.

Time: 15 minutes

Company Requirements

Ruanda really liked what you did with the Task Manager. But they are worried that, with so many tasks, some team members might forget to finish them or might extend reply time too long. To solve this problem, you are to set up the service-level agreement (SLA) option in the workflow. As we had seen before, the best way to contact Ruanda's workers was through email. So we will create an email reminder when the SLA is overdue.

Pre-Requisites

Access Role

  • User with the admin-*-write permission, which allows full access to the admin.
  • User with the read admin access role.

Workflows

Steps

  1. Access the Administrator and open Workflows.

  1. Press the Task Manager workflow-group and then the Task Manager Flow workflow.

  1. Scroll down the settings panel and in the SLAs section, press the + icon to create a new SLA.
create sla

A new settings panel will open up.

create sla

  1. Set up General information:
    • Name: Reminder
    • Code: reminder_00

    Start section
    • State Type: in-progress
    • States: Doing

    End section
    • State Type: in-progress
    • States: Ready

    Time section
    • Time Type: Dynamic
    • Time: DATE|endDate

    • Activate the Reset button.
    • Deactivate the Repeat button.

  1. Set up the Routine builder:

    1. Press the + Add Stage button. New fields appear. Set the following:
      • code: email
      • type: Send email

      • Subject: Task Reminder

      • Data: {"recipientName":"($CODE#users#_id#($OUTPUT#task_request#data|assignee))|name|names","recipientEmail":"","companyName":"Ruanda","title":["Pending Task"],"action":"","code":"","messageA":"$JOIN# #(Task number)#($OUTPUT#task_request#data|serial)#($OUTPUT#task_request#data|name)#is still pending.","messageB":"Please complete the task or modify its end-date."}

      • In the To section, press + Add Itemand set the following:
        • Item: ($CODE#users#_id#($OUTPUT#task_request#data|assignee))|email

      • Activate the Individual send button.

    Cotlang script descriptions
    • $OUTPUT#task_request#data|assignee: Get the task assignee Id
    • ($CODE#users#_id#($OUTPUT#task_request#data|assignee))|name|names: Get the name of the assignee
    • $OUTPUT#task_request#data|serial: unique number of the task
    • $OUTPUT#task_request#data|name: get the name of the task

    1. Scroll back up and press + Add Stage again. Set the following:

      • code: task_request
      • type: Network Request

      • URL: $JOIN#/#($ENV#BASEURL)#api#tasks#($VALUE#taskGroupId)#task#($VALUE#taskId)
      note

      The Cotlang script gets the task's URL.


      • Method: GET

      • Activate the Default authentication button.
      note

      This option needs to be active in order for it to work with the Cotalker API.


      • Success: email

    1. Max. Iterations: 10

    1. Initial Stage: task_request

    The routine should look like this:

    sla routine

  1. Save the SLA.

  1. Save the workflow.

Ta-da! All done!

Now go and create or edit a task. Set the end-date to today's date, and set its state to Doing. In a matter of minutes, you should be receiving an email reminding you to finish the task.


Result

The SLA will be saved in the SLAs section of the workflow configuration:

sla in workflow config

The task reminder email will look something like this :

email