Learn About Configuring Assets for Consoldating Tasks Into a Unified List

This article describes how to acquire the assets required to consoldate tasks into a unified list and then configure those assets to obtain optimal results.

Acquire the Necessary Assets

Before you can start, ensure that you have acquired all asset necessary to consolidate tasks into a single list. Oracle provides, through GitHub, a downloadable code sample you will use to complete this solution.

1. Clone the GitHub respository to your local folder. You can access that repository by clicking Download Code and then Git Repo in the left navigation bar.
2. On your hard drive, create a .zip file called UnifiedTaskList_VBCS.zip and add to it all files from the repository except highlevel.png and .gitignore.
3. Import UnifiedTaskList_VBCS.zip as an application into your Oracle Visual Builder instance.

Configure the Task Sources

Once you've imported the UnifiedTaskList_VBCS.zip as an application to your Oracle Visual Builder instance, you need to configure the applications, or task sources, providing the tasks that will be consolidated into a single list.

The necessary applications appear as a JSON array of objects in the javaScript variable constTaskSourceList under worklist flow, with one configuration object for each task source; for example, this listing shows the configuration for two task sources, Fusion and OCI-Process:

[
    {
        "name": "Fusion",
        "epTaskListApi": "saaSBPMAPI/getTasks",
	    "epTaskListApiTasksRoot":"items",
        "epTaskListApiAttributeMap":{ 
		"Status":"state",
		"TaskID":"taskId",
		"Subject":"title",
		"DateAssigned":"assignedDate",
		"AssignedBy":"fromUserName"
	    },
	    "epTaskDetailUrl": "https://adc2-zjnf-fa-ext.oracledemos.com/fscmUI/faces/adf.task-flow?taskId="
    },
    {
       "name": "OCI-Process",
        "epTaskListApi": "oICProcessBPMTasks/getTasks",
	    "epTaskListApiTasksRoot":"items",
        "epTaskListApiAttributeMap": { 
		"Status":"state",
		"TaskID":"number",
		"Subject":"title",
		"DateAssigned":"assignedDate",
		"AssignedBy":"fromUserName"
	},
	    "epTaskDetailUrl": "/ic/pub/components/pages/taskdetail.html?taskNumber="
    }
]

To configure the task sources, in each object array, update these key/value pairs:

• name: This identifies the specific task source and appears on the list of tasks sources in the application.
• epTaskListApi: This value identifies the endpoint inside service connection and is used to fetch the list of tasks from that service. Format is ServiceConnectionName/Endpoint.
• epTaskListApiAttributeMap: This value is mapped to specify fields from the payload returned by a task source for each attribute shown on the task list.
• epTaskDetailUrl: This is a direct URL for the task in the source application. It is essential for enabling users to act on tasks in the displayed lsit of tasks.