Affected Items List
The Affected Items List is a predefined configuration of the Item List reusable component. The Affected Items List shows items affected by a change request. For each affected item, the Affected Items List displays attributes which you can choose through tailoring. The default attributes are item NAME, NUMBER, OBJECT TYPE INDICATOR, VERSION, STATE, and DESCRIPTION.
Each item name is a link to the ThingWorx Navigate page for that item. If there is no ThingWorx Navigate page for that item type, it is a link to the Windchill Details page for that item. The link only works properly if you have permission to access the linked ThingWorx Navigate or Windchill page.
The Affected Items List has similar search, sort, filter, and restore defaults capabilities as Item List. In My Tasks, searching is only available under the Affected Items tab in a change request review task, and not under the Details tab.
The Affected Items List contains an Export button which allows you to export all list items to a CSV file. By default, the button is enabled, but you can be disable it through tailoring.
The following is a sample image showing the Affected Items List predefined configuration:
For information on binding properties for the Affected Items List, see the
Item List reusable component..
Configuration Fields
For information on configuring the Affected Items List, see the
Item List reusable component. In addition to the JSON keys listed on that page, there are a few more JSON fields that can be configured for the Affected Items List, which are shown in the following table.
Property Name | Description | Type | Default Value | Required or Optional |
attributes | Property names for which the data is expected from backend system. See subproperties: | MultiValueSelector | N/A | Required |
modelAttributeDefinitions | See subproperties: | N/A | N/A | Optional |
isLink | Whether the attribute is configured to be a link in the Affected Items List. Options: true, false. | Boolean | N/A | Optional |
value | Options: true, false. When set to true, the column is configured as links in Affected Items List. When set to false, it appears as plain text. | Boolean | N/A | Required |
Sample Configuration
{
"modelConfigurations": {
"value": {}
},
"filterFieldId": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"defaultSortField": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"actionBarConfiguration": {
"maxItemsToShow": {
"value": 1
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{}
],
"objectType": "WT.WorkItem.Actions"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThingName": {
"entityName": "PTC.AffectedItemListModelThing"
},
"label": {
"value": "[[PTC.AffectedItemsLabel]]"
},
"showExportAction": {
"inTailoring": true,
"value": true
},
"selectionType": {
"selectedKey": "multi"
},
"waitForInput": {
"value": true
},
"filterLabelOverride": {
"value": ""
},
"defaultSortDirection": {
"selectedKey": "asc"
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"additionalData": {
"modelAttributeDefinitions": {
"isLink": {
"value": true
}
}
},
"id": "AffectedObjects|Name",
"ordinal": 0
},
{
"id": "AffectedObjects|Number",
"ordinal": 1
},
{
"id": "AffectedObjects|TypeIcon#Tooltip",
"ordinal": 2
},
{
"id": "AffectedObjects|Version",
"ordinal": 3
},
{
"id": "AffectedObjects|State#Display",
"ordinal": 4
},
{
"id": "Description",
"ordinal": 5
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
},
"inTailoring": true
},
"defaultSelectedFilterValue": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
},
"enableSearch": {
"value": true
},
"maxNumberOfRowsInGrid": {
"inTailoring": true,
"value": 50
}
}
