Task List
The Task List is a predefined configuration of the Item List reusable component that displays a list of the user’s tasks in Windchill. For each task, the Task List displays attributes which you can choose through tailoring. Each attribute is shown as a column in the Task List. The default attributes that are shown are the NAME, SUBJECT NAME, DUE DATE, STATUS, CONTEXT NAME, and TASK PROGRESS. You can click a task name to navigate to the details page for that task. Note that the out-of-the-box Task List supports the details page only for Conduct Online CRB Review tasks.
The Task List has similar search, sort, filter, and restore defaults capabilities as Item List.
There is an Action Bar reusable component integrated into the Task List. By default, it includes the Reassign action, which opens a prompt that allows you to reassign one or more tasks to a different user.
The following is a sample image showing the Task List predefined configuration:
For information on binding properties for the Task List, see the
Item List reusable component.
Configuration Fields
For information on configuring the Task List, see the
Item List. In addition to the JSON fields listed on that page, there are a few more JSON fields that can be configured for the Task List, which are shown in the following table.
Property Name | Description | Type | Default Value | Required or Optional |
modelAttributeDefinitions | Using this field, you can add definitions specific to the model. See subproperty: | JSON | N/A | Optional |
targetMashupName | If set, values of this attribute acts as hyperlink in the grid's column. The mashup name here is the mashup that is opened when clicking the hyperlink. | String | "PTC.CRDetailedReviewAppMashup" | Optional |
modelConfigurations | Entry point for the application builder to pass in additional values to the model, in order to further customize the component. See subproperty: | JSON | N/A | Optional |
taskTypeFilter | Determines which type of tasks are fetched and displayed in the Task List, based on a combination of activityName and workItemProcessTemplate, which define a unique set of tasks. The format is a stringified JSON object array. Each JSON object represents a single task type that consist of a combination of the activityName and workItemProcessTemplate fields. The following is an example: "[{\"activityName\": \"Conduct Online CRB Review\",\"workItemProcessTemplate\": \"Change Request Workflow\"}]" | JSON | N/A | Optional |
Sample Configuration
{
"modelConfigurations": {
"value": {
"taskTypeFilter": {
"value": "[{\"activityName\": \"Conduct Online CRB Review\",\"workItemProcessTemplate\": \"Change Request Workflow\"}]"
}
}
},
"filterFieldId": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "Status#Display"
}
],
"objectType": "PTC.Workflow.WorkItem"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"defaultSortField": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "Activity|Deadline"
}
],
"objectType": "PTC.Workflow.WorkItem"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"actionBarConfiguration": {
"maxItemsToShow": {
"value": 2
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "Reassign",
"additionalData": {
"actionConfiguration": {
"overrideLabel": {
"value": "Reassign"
},
"inputConstraints": {
"selectedKey": "InputRequired"
},
"actionButtonVisibility": {
"selectedKey": "AlwaysShown"
},
"buttonStyle": {
"selectedKey": "transparent"
},
"mashupName": {
"mashupName": "PTC.AccessApp.WindchillServices.ReassignActionMashup"
},
"fireEventOnFinish": {
"value": false
},
"activityType": {
"selectedKey": "popup"
}
}
},
"ordinal": 0
}
],
"objectType": "WT.WorkItem.Actions"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThingName": {
"entityName": "PTC.TaskListModelThing"
},
"label": {
"value": "[[PTC.TaskListLabel]]"
},
"showExportAction": {
"inTailoring": true,
"value": true
},
"findHintText": {
"value": "[[PTC.TaskListFindHintText]]"
},
"selectionType": {
"selectedKey": "multi"
},
"waitForInput": {
"value": false
},
"filterLabelOverride": {
"value": "Status"
},
"defaultSortDirection": {
"selectedKey": "asc"
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "Activity|Name",
"additionalData": {
"fieldTitleOverride": {
"value": ""
},
"modelAttributeDefinitions": {
"linkToMashup": {
"targetMashupName": "PTC.CRDetailedReviewAppMashup"
}
}
},
"ordinal": 0
},
{
"id": "Subject|SubjectName",
"additionalData": {
"fieldTitleOverride": {
"value": ""
}
},
"ordinal": 1
},
{
"id": "Activity|Deadline",
"additionalData": {
"fieldTitleOverride": {
"value": ""
}
},
"ordinal": 2
},
{
"id": "Status#Display",
"additionalData": {
"fieldTitleOverride": {
"value": ""
}
},
"ordinal": 3
},
{
"id": "Activity|Context|Name",
"additionalData": {
"fieldTitleOverride": {
"value": ""
}
},
"ordinal": 4
},
{
"id": "TaskProgress",
"additionalData": {
"fieldTitleOverride": {
"value": "PTC.TaskProgress"
}
},
"ordinal": 5
}
],
"objectType": "PTC.Workflow.WorkItem"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"defaultSelectedFilterValue": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": "POTENTIAL"
},
{
"id": "ACCEPTED"
}
],
"objectType": "PTC.Workflow.WorkItem"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"enableSearch": {
"value": true
},
"maxNumberOfRowsInGrid": {
"inTailoring": true,
"value": 50
}
}
