×

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. Execution Path
          2. Measuring
          3. Parameters
          4. Runtime Users
        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

    Validation of set of Manual Tasks

    Goal : Create a 'my tasks' report and a button to automatically validate the selected tasks.

    2012-05-25_164109

    Technically, when you validate a RMP manual task, this performs a PUT on the manual task url to change its status and inject the new parameters. After the task is approved the associated process is awaken.

    To make this multi-approval feature, we have to inject in the report the manual task urls (different from the name column), and when we'll click on the 'approve selected requests' button, this will trigger a javascript code that
    gets the selected rows of the report (including manual tasks links)
    updates each manual task (passing a parameter choice="approved' in our example) via ajax calls
    * reloads the report when this is done

    1) Build the manual task link

    Go into your process, click on the manual task activity (1) and open functional tab

    2012-05-25_165224

    You get the id of the activity : "1" (2). Now click on Input Variables (3):

    2012-05-25_165550

    create a variable name = task_url (4) and value = https://live.runmyprocess.com/live/${P_customer}/request/${P_request}/task/ACTIVITY_ID/0 (5)

    where ACTIVITY_ID is the id of the activity = 1 in our example.
    So the url becomes :
    https://live.runmyprocess.com/live/${P_customer}/request/${P_request}/task/1/0

    this variable will be automatically computed when the process reaches this step. To make this variable appear in reports, click on Measures (1)

    2012-05-25_170756

    Add a new measure (2) and create a new measure task_url = ${task_url} (3)

    2012-05-25_170909

    Click on OK and save your process.

    2) Configure the report

    As the measure has been created, you can add a new column task_url in your tasks report:

    2012-05-25_171150

    Note : do check your report displays only manual tasks that are PENDING (="start') in the right approval screen ('Validation' in this example)

    If you click on 'Search results', you should see:

    2012-05-25_171615

    Save your report as 'My Tasks - TEST'.

    3) Configure the webinterface containing the report

    3.1) Configure the report widget

    Now your report is well configured, add it to the 'Report' web interface (1). Put the identifier 'id_report_my_tasks' to the widget (2).

    2012-05-25_174340

    Then click on the configuration key (3) and untick the task_url column to make it unvisible (4):

    2012-05-25_174608

    3.2) Configure the javascript

    We'll perform ajax calls to update the manual tasks. Let's add the jquery library to our webinterface. Go to the 'Javascript' tab (1) and add in the footer https://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js (2):

    2012-05-25_173025

    Now come back to the design tab and add a hidden javascript widget at the bottom of the webinterface (1). Then click on 'View or edit script' (2):

    2012-05-25_174047

    2012-05-25_173324

    And copy paste source code below:

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    function approve_request(my_task_url){
    
     string_feed = '<feed xmlns="http://www.w3.org/2005/Atom" xmlns:p="http://www.runmyprocess.com/live/" xml:base="https://live.runmyprocess.com/"><title>Process update request</title><link rel="self" href="' + my_task_url + '"/><rights>(c) RunMyProcess</rights><category term="event" label="COMPLETE"/><entry> <title>New parameters</title><id>0</id><category term="computed"/><content type="text/base64">eyJjaG9pY2UiOiJhcHByb3ZlZCJ9</content></entry> </feed>';
    
     $.ajax({
      type:"PUT" 
      ,url: my_task_url
      ,data:string_feed
      ,cache:true
      ,async: false
      ,headers:{"RMPData-Version":"v1_0"}
      ,contentType: "application/xml"
      ,error: function(){alert('Error while approving request : ' + my_task_url);}
     });
    
    }
    

    Note : This function will perform a PUT call on the manual task url, passing a xml as content (string_feed). You can pass any variable as BASE64 encoded in the content tag. Here the BASE64 content is eyJjaG9pY2UiOiJhcHByb3ZlZCJ9. Decoded value is {"choice":"approved"}

    To encode/decode strings, you can use http://www.motobit.com/util/base64-decoder-encoder.asp

    3.3) Configure the button 'Approve selected requests'

    Add a button (1) Action 'Execute script' (2) and click on 'View or edit script' (3):

    2012-05-25_174839

    Then copy paste the code below:

    1
    2
    3
    4
    5
    var a_selected_tasks = id_report_my_tasks.getSelectedLinesValues();  
    for(i=0;i<a_selected_tasks.length;i++) {  
    approve_request(a_selected_tasks[i].measure_9);  
    }  
    setTimeout("id_report_my_tasks.refresh();",2000);
    

    Note :
    This code will get the selected rows of the id_report_my_tasks widget, then will make a loop and call the approve_request function previously defined.

    You're done, give it a try!