×

Please give details of the problem

Docs

Find

    Developer Guide

        1. Todo Validation
      1. Release Your User Login
      1. Process Reporting API
        1. CSS Examples
        2. CSS Personalization
      1. Performance
        1. List Reinitialization
        2. Holidays
        3. Number Currency Format
        4. Label Modification
        5. Array From WS
        6. Launch Process JQuery
        7. Column Inactivation
        8. Date
        9. Print JSONObject
        10. ArrayJSON to JSONArray
        11. Invalid Fields
        12. Round
        13. Initialization Widget Date
        14. JQuery
        15. Inject JSONObject
        16. Google Tables
        1. Summing Array
        2. API Listener
        3. User Lane Picker
        4. Retrieving Variables Values
          1. Chart Dashboard
          2. Report Chart
          3. Google Visualization
          4. Chart Dashboard Collection
        5. Tags
        6. Collection
        7. File Preview
        8. Dynamic List
        9. Dialog Window
        10. JavaScript Report
        11. Autocomplete Widget
          1. homepage.js
          2. homepage.css
        1. Logout
        2. Custom Login Page
        3. Header
        4. Mobile Devices
        5. Basket
        6. Redirection ExecutionMode
        7. Menu Bar
        8. Information Tags
      1. Composite API Example
      1. Markdown Template
        1. Task Reminder Email
        2. SubProcess
        3. PDF
        4. JavaScript Inclusion
        5. Variable Mapping
        6. Backloop
      2. Trigger
        1. File Visibility
        2. Number Currency Format
        3. Error Handling
        4. JSONObject Concatenation
        5. Loop
        6. Dynamic Variable
        7. List 1000+ Objects
        8. Metadata
        9. Freemarker Container Test
        10. JSONObject Keys Values
        11. List Hash Sequence
        12. Special Freemarker Characters
        13. Salesforce Computation
        14. Array To List
        15. JSONArray Conversion
        16. Lock
        17. JSONObject Creation
        18. Number Test
      1. Customer Management
        1. Messages
        2. Scheduled Process
        1. Custom Lists
          1. Web Interface Stylesheet Tab
          2. Web Interface Analytics Tab
          3. Web Interface Implementation Tab
          4. Web Interface Collection Tab
          5. Web Interface API Tab
          6. Web Interface Design Tab
          7. Web Interface JS Tab
            1. Report Widget
            2. List Widget
            3. JavaScript Widget
            4. History Widget
            5. RadioButton Widget
            6. FileUpload Widget
            7. StaticText Widget
            8. HTML Editor Widget
            9. ProgressBar Widget
            10. Section Widget
            11. Spinner Widget
            12. Image Widget
            13. Multi Checkbox Widget
            14. Tab Widget
            15. Tree Widget
            16. HTML Widget
            17. Checkbox Widget
            18. Button Widget
            19. Custom Widget
            20. URLInput Widget
            21. TextInput Widget
            22. Array Widget
            23. Captcha Widget
            24. Geolocation Widget
          1. Version
          2. Project Version Tab
          3. Project Definition Tab
          4. Project Description Tab
          5. Project Rights Tab
          6. Project Versioned Files Tab
          7. Project Collection Tab
          8. Project Files Tab
        2. Collections
          1. Providers
          2. Processes
          3. Connectors
        3. Revision
          1. Composite API Configuration Tab
          2. Composite API Design Tab
          1. Process Input Tab
          2. Process General Tab
          3. Process Measures Tab
          4. Process Variables Tab
            1. Gate
            2. Process Step Output Variables
              1. Process Task Functional Tab
              2. Process Task Connector Tab
              3. Process Task Script Tab
              4. Process Task Loop Tab
              5. Process Task SubProcess Tab
              6. Process Task Manual Tab
              7. Process Task Email Tab
            3. Process Step Input Variables
            4. Process Step Testing Variables
              1. Process Intermediary Event
              2. Process Start Event
              3. Process Timer Event
          5. Process Design
          1. Organization
          2. Roles entities
        1. My Applications
        2. Files
        3. Home
        1. Process Examples
        2. Connectors
        1. Web Interface Reports
          1. Parameters
          2. Runtime Users
          3. Execution Path
          4. Measuring
        1. Configuration
        2. Users
        3. Usage
      1. Mobile
      2. Offline
      1. Collections BackOffice
      2. Collections To List
      3. Collections To Array
      4. Collection JS Freemarker
      1. Access Rights
      2. Delegation
      3. Compound Organization Hierarchy
      4. Dynamic Lanes
      5. Scripted Lanes
      6. Runtime Lanes

    Configure a task reminder email (for advanced designers)

    When you assign a manual task to a user or a group of users, you may want to send a reminder email until the task is completed. Let's go through its configuration.

    Your main process

    Let's take the following example: you configured a manual task assigned to a Manager + email notification:

    main_process_v1

    What you shouldn't do

    To configure a reminder, you may want to configure a timer/overdue handler on the task and loop back to send again the email with the task link:

    bad_design_main_process

    With this design, it will not only send an email with the task link again, but also GENERATE a new task link and CANCEL the previous link you've sent.

    What you should do

    Our goal is to keep the SAME task link to only have 1 task generated, and to send several reminder emails with the SAME task link.

    Let's go through 2 examples:

    • How to split manual task + email notification into 2 different activities, with no reminder
    • How to split and add a reminder

    Split manual task assignation and email notification with no reminder

    You can split the activity manual task + email notification into 2 different activities:

    split_process

    Since you will send the email before assigning the task, you have to generate its link.

    You have to use this freemarker function:

    1
    ${get_next_url(activityid,ispublic)}
    

    activityid is the id of the activity where you've configured the manual task, and ispublic=true only if you generate a public task link. You can get activityid in Functional tab > ID

    split_process_activityid

    So, forour example, activityid=2 and ispublic=false. Let's configure email sending activity:

    split_process_config_email

    As an input create a task_url variable with value

    1
    ${get_next_url(2,false)}
    

    You'll have to configure To and Message fields. Note that we used ${task_url} in Message.

    You may want to use this design anytime you'd like to notify less people than the task is assigned to (ex: the task is assigned to managers and super managers, but you only want to notify the managers).

    Split manual task assignation and email notification + add a reminder

    Our goal is to assign a task, send an email notification, and keep sending emails every 5min until the task is completed.

    Architecture

    We'll split the activity manual task + email notification into 2 different activities (cf previous section), but instead of sending an email, we'll start a process as a connector that will manage the reminder emails.

    The Main process:

    reminder_process_main

    The Main process will pass ${task_url} to the connector that will start the reminder process:

    reminder_connector_kick_process_reminder

    The reminder process will send the email notification, wait 5min, then check if the task is completed/validated. If not, then loop back to email notification:

    reminder_process_reminder

    The reminder process will call a connector to check if the task is completed or not:

    reminder_connector_check_task_status

    Configuration

    • Main process

    Add a new measure

    1
    task_url = ${task_url}
    

    reminder_process_main_measure

    Note the position of the measure: here it's #1.

    Modify this input variable value to call the connector:

    1
    task_url = ${get_next_url(2,false)}
    

    reminder_process_main_call_connector

    reminder_plug_connector_kick_task_reminder_process

    • Get task status connector

    Since we configured task_url as a measure, we are able to retrieve the webinterface instance status (the task status) from the task_url.

    Use a standard RunMyProcess provider:

    rmp_provider

    And create a new connector, that will send a GET request to the following url:

    1
    live/${P_customer}/applistate?nb=20&first=0&filter=PROJECT%20MODE%20MEASURE_1%20APPLI%20SUB_STATE&operator=EE%20EE%20EE%20EE%20EE&column=name%20published%20state%20measure_1&value=${project_id}%20${P_mode}%20${task_url?url}%20${webinterface_id}%20START
    

    project_id: to be replaced by the id of your project.

    P_customer: leave it as it is.

    P_mode : leave it as it is.

    webinterface_id: to be replaced by the id of the webinterface you used to generate a task.

    MEASURE_1 and measure_1 : remplace 1 by the position id of task_url measure.

    task_url: input parameter.

    Accept media type must be application/atom+xml

    reminder_connector_check_task_status

    • Task reminder process

    reminder_process_reminder_fig

    (1) Plug an email notification, and pass the ${task_url} link in the content of the email

    (2) Configure a timer/waiter to wait 5min (frequency to be customized)

    reminder_process_timer

    (3) Call the Get task status connector

    Pass as input:

    reminder_process_get_status_input

    As output create a is_task_active parameter:

    reminder_process_get_status_output

    As value use this script:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    <#function get_array my_father my_son>
        <#if my_father?is_hash>
            <#if my_father[my_son]?exists>
                <#if my_father[my_son]?is_sequence>
                    <#assign my_array = my_father[my_son]>
                <#else>
                    <#assign my_array = [my_father[my_son]?eval]>
                </#if>
            <#else>
                <#assign my_array = []>
            </#if>
        <#else>
            <#assign my_array = []>
        </#if>
        <#return my_array>
    </#function>
    
    <#assign entries = get_array(P_result.feed,"entry")>
    <#if (entries?size == 0)>
        <#assign is_task_active = "no">
    <#else>
        <#assign is_task_active = "yes">
    </#if>
    ${is_task_active}
    

    Then you can configure the gateway condition:

    reminder_process_gateway

    Add task_url as input parameter for this process:

    reminder_process_input_params

    Then you can save your process and click on Open corresponding connector

    reminder_process_open_corresponding_connector1

    reminder_process_open_corresponding_connector_preview

    • Connector to kick the reminder process

    Under the RunMyProcess provider, create a new connector with the exact configuration you see when clicking on Open corresponding connector in the reminder process.

    reminder_process_connector_kick_process

    This connector has to be plugged to the Main process

    Congratulations, you've configured an automatic task reminder email!

    Note: you can use the same connector to trigger the reminder process at several places in the Main process, you just have to pass the frequency and the recipients logins as input parameters.