×

Please give details of the problem

Docs

Find

    Developer Guide

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

    Task Delegation

    Delegating your tasks means that for a certain period of time, you will grant a colleague the authority to validate, cancel and save tasks that are assigned to you. This can be particularly useful if you are unavailable for some time (e.g. holiday leave, sick leave, maternity leave and so on).

    1 Overview and Definition of Terms

    A delegation from user A to user B gives user B the right to validate, cancel and save manual tasks that are assigned to user A for a specific time period.

    If a manual task is assigned to a user that has an active delegation in place, the manual task will be accessible to the representative. Email / Nofication tasks will also be sent to the representative. The representative, however, will not be able to launch requests on behalf of the delegator.

    A delegation can be set at a project level or at a global level. A project delegation is only effective for a chosen project whereas a global delegation is effective for all projects that do not have an active project delegation. Only one delegation can be active per scope at any specific time although many can be scheduled for different time periods.

    Definition of Terms

    Term Explanation
    Delegator The user to whom the tasks were originally assigned. This user has created a delegation to give the representative authority to action these tasks.
    Representative The user that has been granted authority to action the delegator's tasks (the delgatee).
    Pending Delegation A delegation that has been created but is not yet in effect (set for a future date).

    2 Delegation Lifecycle

    2.1 Creating a Delegation

    You can create a delegation using the User Management or My Settings application and navigating to the Delegations tab.

    By creating a delegation a user nominates a representative to action their manual tasks for a set period of time. When a user creates a delegation, he can specify whether to start it immediately or at a future date. The user can also specify the delegation's end date and time.

    2.2 Delegation Status

    A delegation will have one of three status:

    Status Explanation
    Pending The delegation has been created but is not yet active.
    Active The delegation is currently active - the representive can action the delegator's tasks.
    Deactivated The delgation is no longer active.

    2.3 Activation

    Delegations are automatically activated by the server: - Delegations starting in the past or now are automatically activated after creation. - Delegations starting in the future are pending after creation and will be automatically activated by the server within five minutes on the start date.

    Delegation is retroactive - tasks created before the activation of a delegation and assigned to the delegator become accessible to the representative as soon as the delegation is activated.

    A delegation that is created to begin immediately or in the past will be activated imminently (within five minutes).

    2.4 Ending a Delegation

    An active delegation ends when its end date is reached or it can be ended manually by the delegator himself. When the delegation is inactivated, the representative will no longer be able to access the delegator's tasks.

    Whilst a delegation is pending (created but not yet activated), it can be deleted and it will not appear in the user's delegation history. Once a delegation has been activated, it can no longer be deleted - only stopped and it will appear in the user's delegation history. This distinction means that a user can have a reliable record of whether or not his tasks were available to someone else at a certain time.

    3 Rights Management

    3.1 Task Configuration

    Manual and email/notification tasks are configured as delegable by default. It is possible to configure tasks to be non-delegable in the process design; this means that even if the assigned user has an active delegation, the task will remain assigned to him/her and inaccessible to the representative.

    3.2 Validation of a Task by a Representative

    When a representative validates a manual task on behalf of the delegator, the representative does not have to be part of the correct lanes (project and process) to be able to update a request, the delegation itself will provide sufficient rights to validate a task.

    The representative will become the P_user of the request and the request will run in the representative's name. Each time a representative update a manual task, the P_user.delegators value will be set with the list of delegators of the representative.

    If the web interface contains a history widget, both the delegator and the representative's names will be shown (e.g. "Jane Doe on behalf of John Doe").

    3.3 Access rigths of the Representative

    The representative inherits the delegator's access rights at project level (apart from Process instances).

    4 Reporting

    A user can access a list of tasks that have been delegated to him/her by using a specific appinstance report. To do this, the report should use the filter Delegated to associated with the value Connected User.

    A representative only needs to be a USER on the project containing the report in order to see the list of tasks that are delegated to him, but only via a report with the Delegated to filter.

    The filter Delegated to can also be used to filter on users other than the connected user.

    A report can also display to whom an appinstance is delegated by displaying the column Delegated to.

    5 Deactivated Users

    Before deactivating a user it is good practice to consider creating a delegation for his tasks. If no delegation is in place, the user's tasks, and subsequently the whole request, will become blocked. If a delegation is in place, the representative will be able to execute the delegator's tasks and hence prevent the request becoming blocked.