×

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

    Collection

    Note: First read How to: Create a backoffice to manage collections tutorial.
    Note2: WI = Web Interface

    Example

    Here's a Car Booking application. There's a section to select a car. You want end users to be able to find the desired car in a proper RunMyProcess report then automatically inject corresponding car details in the booking form.

    View of Car Booking WI:

    2012-12-21_125914

    The end user will click on 'SELECT A CAR' button. That will open a new tab:

    2012-12-21_130116

    In this tab, we can use filter bar, pagination, sorting, to find the desired car. Then we select the corresponding row (1), and hit 'SELECT THIS CAR' button (2).
    The tab will be automatically shut down and information regarding selected row will be passed to the Car Booking WI (3):

    2012-12-21_130205

    How to configure this widget

    Configure 'Car Booking' WI

    First plug the collection cars to the web interface (id : col_cars):
    2012-12-21_132149

    Then switch to Design tab:
    2012-12-21_131841

    (1) : Create a button action 'Execute script'. Enter js code below:

    Code

    1
    window.open("https://live.runmyprocess.com/live/621199258/appli/67197?P_mode=${P_mode}&lookup=yes");
    

    the url of the WI mentioned above (https://live.runmyprocess.com/live/621199258/appli/67197) will have to be replaced by your own one. This WI wil display the nice collection report to select a car.

    (2) You have to create the text/number/date fields you want to display. You have to think about what field/keys from the collection will have to be passed to the WI.

    Best Practice is to use the same names for the widget variables as for the keys in the collection.

    (3) Create a hidden split widget

    (4) Create a js widget. Enter code below (definitions of js functions)

    Code

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    function load_ok(json) {  
    //inject details from collection to the webinterface  
    for (var i in json[0]) {  
    RMPApplication.setVariable(i, json[0][i]);  
    }  
    }  
    function load_ko(result) {  
    alert("Error while loading car");  
    }  
    function load_car_details() {  
    var my_pattern = {};  
    my_pattern.car_id = RMPApplication.get("car_id");  
    col_cars.listCallback(my_pattern, {}, load_ok, load_ko);  
    }
    

    (5) Create a js widget that listens js_load_car_details. Enter js code below:

    Code

    1
    load_car_details();
    

    The expect behaviour is: when js_load_car_details variable changes, load_car_details() function is executed, and will retrieve all details regarding car_id value from collection.

    Configure 'Car lookup report' WI

    You can extend your existing Backoffice WI to configure the lookup feature. See How to: Create a backoffice to manage collections tutorial.

    2012-12-21_134305

    In that WI, ensure you put id_report as identifier for the report widget:

    2012-12-21_134456

    Above the report widget, you'll configure a 'SELECT THIS CAR' button:

    2012-12-21_134608

    This button has action 'Execute Script'. JS code below:

    Code

    1
    2
    3
    4
    5
    6
    7
    8
    var my_selection = id_report.getSelectedLinesValues();  
    if (my_selection.length > 0) {  
    window.opener.RMPApplication.set("car_id", my_selection[0].car_id);  
    window.opener.RMPApplication.set("js_load_car_details", Math.random());  
    window.close();  
    } else {  
    alert("Please select a car!");  
    }
    

    This code will:
    get car_id field of the selected row (my_selection[0].car_id). You'll have to replace car_id by the field containing the unique identifier for items in your collection.
    inject car_id variable into the father WI Car Booking: window.opener.RMPApplication.set("car_id",...)
    * inject js_load_car_details variable with a random value in the father WI

    Let's make this button visible only if the WI is used as lookup widget. Enter as visibility rule:

    Code

    1
    "[[lookup]]" == "yes"
    

    Note: if you open 'Car report / lookup' WI directly from its url, 'SELECT THIS CAR' button will be hidden since lookup variable doesn't exist.

    Save the 2 WIs, you're done!