Displaying additional data in ToDo list displaying-additional-data-in-todo-list

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

By default, the AEM Forms workspace To-do list displays the task display name and description. However, you can add other information such as creation date, deadline date. You can also add icons and change the style of the display.

A look at the HTML Workspace To-do tab showing default configuration

This article details the steps to add information to display for each task in the ToDo list.

What can be added what-can-be-added

You can add the information available in task.json sent by the server. The information can be added as plain text or you can use styles to format the information.

For more information about the JSON Object description, see this article.

Displaying information on a task displaying-information-on-a-task

  1. Follow the Generic steps for AEM Forms workspace customization.

  2. To display additional information for a task, the corresponding key-value pairs must be added within the task block of translation.json.

    For example change /apps/ws/locales/en-US/translation.json for English:

    code language-none
    
    "task" : {
            "reminder" : {
                "value" : "Reminder",
                "tooltip" : "This is reminder __reminderCount__, for this task."
            },
            "deadlined" : {
                "value" : "Deadlined",
                "tooltip" : "This task has deadlined"
            },
            "save" : {
                "message" : "Task has been saved successfully"
            },
            "status" : {
                "deadlined" : "Deadlined",
                "created" : "Created",
                "assignedsaved" : "Draft from assigned task",
                "terminated" : "Terminated",
                "assigned" : "Assigned",
                "unknown" : "Unknown",
                "createdsaved" : "Draft from created task",
                "completed" : "Completed"
            },
            "draft" : {
                "value" : "Saved",
                "tooltip" : "This task is marked as a draft"
            },
            "escalated" : {
                "value" : "Escalated",
                "tooltip" : "This task has been escalated"
            },
            "forward" : {
                "value" : "Forwarded",
                "tooltip" : "This task was forwarded"
            },
            "priority" : {
                "highest" : "Highest priority",
                "normal" : "Normal priority",
                "high" : "High priority",
                "low" : "Low priority",
                "lowest" : "Lowest priority"
            },
            "claimed" : {
                "value" : "Claimed",
                "tooltip" : "This task has been claimed"
            },
            "locked" : {
                "value" : "Locked",
                "tooltip" : "This task is locked"
            },
            "consulted" : {
                "value" : "Consulted",
                "tooltip" : "This task has been consulted"
            },
            "returned" : {
                "value" : "Returned",
                "tooltip" : "This task was returned back"
            },
            "multiplesubmitbuttons" : {
                "message" : "The form associated with this task has multiple submit buttons so the Workspace Complete button will be disabled. Click the appropriate button on the form to submit it."
            },
            "nosubmitbutton" : {
                "message" : "The form associated with this task does not appear to have submit buttons. You may need to upgrade your Adobe Reader version to 9.1 or greater and enable the Reader Submit option in your process."
            },
            "icon" : {
                "tooltip" : "open the task __taskName__"
            }
        }
    
    note note
    NOTE
    Add corresponding key-value pairs for all supported languages.
  3. For example, add information inside the task block:

    code language-none
    
    "stepname" : {
                "value" : "Step Name",
                "tooltip" : "This task belongs to __stepName__ step"
    }
    

Defining CSS for the new property defining-css-for-the-new-property

  1. You can apply style to the information (property) added to a task. To do this, you need to add style information for the new property added to /apps/ws/css/newStyle.css.

    For example add:

    code language-css
    
    .task .taskProperties .stepname{
        width: 25px;
        background: url(../images/stepname.png) no-repeat; /*-------- Or just reuse background image / image-sprite defined .task .taskProperties span of style.css---------------------*/
        background-position: 0px 0px; /*-------- Dummy values, need to be configured as per user background image / image-sprite ---------------------*/
    }
    

Adding entry in the HTML Template adding-entry-in-the-html-template

Finally, you need to include an entry in the dev package for each property that you want to add to the task. To create one refer to Building AEM Forms workspace code.

  1. Copy task.html:

    • from: /libs/ws/js/runtime/templates/
    • to: /apps/ws/js/runtime/templates/
  2. Add the new information to /apps/ws/js/runtime/templates/task.html.

    For example, add under div class="taskProperties":

    code language-none
    
    <span class="stepname" alt="<%= $.t('task.stepname.value')%>" title = '<%= $.t("task.stepname.tooltip",{stepName:stepName})%>'/>
    
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da