有关配置“任务”的信息,请参阅
项列表组件。此外,下列 JSON 属性是特定于“任务”的。
属性名称 | 说明 | 属性类型 | 默认值 | 必需或可选 |
---|
taskTypeFilter | 根据 activityName 和 workItemProcessTemplate 名称的组合 (可定义一组特有的任务),确定要获取并显示在“任务”中的任务类型。用于筛选要显示的任务。当其值为空时,将显示具有 PTC.Workflow.WorkItem 对象类型的所有任务。 格式:字符串化 JSON 对象数组,其中每个 JSON 对象均代表一个单一任务类型,这种单一任务类型由 activityName 和 workItemProcessTemplate 字段组合而成。 此配置属性位于组件配置中 implementationConfiguration 属性的下方。 示例: "taskTypeFilter": { "value": "[{\"activityName\": \"Conduct Online CRB Review\", \"workItemProcessTemplate\": \"Change Request Workflow\"}]" } | | 不适用 | 可选 |
linkToMashup | 将指定属性转换为超链接,并定义在单击此属性时打开的目标混搭。用于打开任务的详细视图。 这是 attributes 配置属性的子属性。指定的混搭会通过混搭参数以及相应任务的任务 ID 一起传递。生成的 URL 中的查询参数为 TaskID=<任务 ID>。 此属性的容器键为 implementationAttributesDefinition。 示例: { "implementationAttributesDefinition":{ "linkToMashup":{ "mashupName":"PTC.CRDetailedReviewAppMashup" } } } 生成的混搭 URL:/Thingworx/Runtime/index.html?mashup=PTC.CRDetailedReviewAppMashup&TaskID=<任务 ID> | | 不适用 | 可选 |
attributes | 接受 PTC.Workflow.WorkItem 对象类型的属性。 此外,还接受具有 PTC.Workflow.WorkItem.Custom.Implementation 对象类型的 TaskProgress 属性。TaskProgress 属性显示已对更改请求作出响应的成员数。 | | 不适用 | 必需 |
defaultSortField | 接受 PTC.Workflow.WorkItem 对象类型的属性。 | | 不适用 | 可选 |
filterFields | 接受 PTC.Workflow.WorkItem 对象类型的属性。 | | 不适用 | 可选 |
{
"actionBarConfiguration":{
"value":{
"actionBarConfigurationJSON":{
"value":"{\"maxItemsToShow\": {\"value\": 2},\"modelThingName\": {\"entityName\": \"PTC.ActionBarModel.Thing\"},\"actions\": {\"selectedValues\": {\"data\": [{\"itemListsData\": [{\"items\": [{\"id\": \"Reassign\",\"additionalData\": {\"actionConfiguration\": {\"iconWhenDisabled\": {\"entityName\": \"PTC.ActionBar.ReassignDisabledIcon\"},\"iconWhenHovered\": {\"entityName\": \"PTC.ActionBar.ReassignHoverIcon\"},\"overrideLabel\": {\"value\": \"[[PTC.Nav.TaskList.TaskReassignLabel]]\"},\"popupHeight\": {\"value\": 579},\"inputConstraints\": {\"selectedKey\": \"InputRequired\"},\"actionButtonVisibility\": {\"selectedKey\": \"AlwaysShown\"},\"buttonStyle\": {\"selectedKey\": \"transparent\"},\"mashupName\": {\"mashupName\": \"PTC.AccessApp.WindchillServices.ReassignActionMashup\"},\"fireEventOnFinish\": {\"value\": false},\"activityType\": {\"selectedKey\": \"popup\"},\"iconWhenEnabled\": {\"entityName\": \"PTC.ActionBar.ReassignIcon\"},\"popupWidth\": {\"value\": 600}}},\"ordinal\": 0}],\"objectType\": \"WT.WorkItem.Actions\"}],\"adapter\": {\"instanceName\": \"windchill\",\"thingName\": \"PTC.WCAdapter\"}}]}}}"
}
}
},
"attributes":{
"inTailoring":true,
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"implementationAttributesDefinition":{
"linkToMashup":{
"mashupName":"PTC.CRDetailedReviewAppMashup"
}
},
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Name",
"ordinal":0
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Subject|SubjectName",
"ordinal":1
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Deadline",
"ordinal":2
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Status#Display",
"ordinal":3
},
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":""
}
}
},
"id":"Activity|Context|Name",
"ordinal":4
}
],
"objectType":"PTC.Workflow.WorkItem"
},
{
"items":[
{
"additionalData":{
"itemListAttributesDefinition":{
"fieldTitleOverride":{
"value":"PTC.Nav.TaskList.TaskProgress"
}
}
},
"id":"TaskProgress",
"ordinal":5
}
],
"objectType":"PTC.Workflow.WorkItem.Custom.Implementation"
}
]
}
]
}
},
"defaultSortFields":{
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"itemListDefaultSortFieldDefinition":{
"defaultSortDirection":{
"selectedKey":"asc"
}
}
},
"id":"Activity|Deadline"
}
],
"objectType":"PTC.Workflow.WorkItem"
}
]
}
]
}
},
"enableSearch":{
"additionalData":{
"itemListSearchDefinition":{
"searchHintText":{
"value":"[[PTC.Nav.TaskList.FindHintText]]"
}
}
},
"value":true
},
"filterFields":{
"selectedValues":{
"data":[
{
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
},
"itemListsData":[
{
"items":[
{
"additionalData":{
"itemListFilterFieldDefinition":{
"defaultSelectedFilterValues":{
"filters":{
"filters":[
{
"fieldName":"",
"type":"EQ",
"value":"POTENTIAL"
},
{
"fieldName":"",
"type":"EQ",
"value":"ACCEPTED"
}
],
"type":"Or"
}
},
"filterLabelOverride":{
"value":"[[PTC.Nav.TaskList.Status]]"
}
}
},
"id":"Status#Display",
"ordinal":0
}
],
"objectType":"PTC.Workflow.WorkItem"
}
]
}
]
}
},
"implementationConfiguration":{
"value":{
"taskTypeFilter":{
"value":"[{\"activityName\": \"Conduct Online CRB Review\",\"workItemProcessTemplate\": \"Change Request Workflow\"}]"
}
}
},
"label":{
"value":"[[PTC.Nav.TaskList.Label]]"
},
"maxNumberOfRowsInGrid":{
"inTailoring":true,
"value":50
},
"selectionType":{
"selectedKey":"multi"
},
"showExportAction":{
"inTailoring":true,
"value":true
},
"waitForInput":{
"value":false
},
"baseConfigurationVersion":{
"value":"9.0.0"
},
"implementationConfigurationVersion":{
"value":"9.0.0"
}
}
除配置外,每个组件还支持通过扩展其业务逻辑来自定义组件。每个组件的业务逻辑在事物模板中都包含可改写服务,您可以对这些服务进行扩展和改写。下表对此组件的可改写服务进行了详细说明。
有关每个服务的返回值和参数的示例,请参阅
自定义服务的输入/输出示例。
名称 | 说明 |
---|
GetConfigurations | 返回“任务”的可用配置。 参数:无 返回:JSON |
GetImplementationLabel | 返回此组件的本地化名称或可用于获取此本地化名称的标记。此本地化名称显示在 Mashup Builder 用户界面中。 参数:无 返回:字符串 |
GetItems | 返回后端系统中用户任务的列表及其属性和值。 参数: input (可选) - CCO 格式的 JSON,其中包含要从后端系统获取的数据的输入 ID,以及后端系统的适配器信息。 configuration (必需) - JSON,其中包含从“定制管理器”资源获得的最终合并配置。 |
InitializeFilters | 返回配置中筛选器字段的筛选器类型定义。对配置的 filterFields 键下第一个筛选器字段项的筛选器 enum 选项数据进行初始化。筛选器字段的 enum 选项检索自 Adapter API。 参数: input (可选) - CCO 格式的 JSON,其中包含要从后端系统获取的数据的输入 ID,以及后端系统的适配器信息。 configuration (必需) - JSON,其中包含从“定制管理器”资源获得的最终合并配置。 |
DefHookImplementationConfigurationDefinitionGroup | 返回“任务”实施定义,其中包含可用的自定义配置。包括 taskTypeFilter 配置属性的定义。 参数:无 返回:JSON:Array |
DefHookImplementationAttributesDefinition | 返回选定属性的“任务”实施定义。包括 linkToMashup 配置属性的定义。 参数:无 返回:JSON:Array |
[
...
// Tasks injections to the Definition:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"directDefinition": [ // Tasks specific:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"hintText": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "taskTypeFilter"
}
]
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.DefinitionGroup"
},
"mandatory": true,
"key": "implementationConfiguration"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListAttributesDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"hintText": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "fieldTitleOverride"
}
]
},
{
"key": "implementationAttributesDefinition",
"directDefinition": [ // Tasks specific:
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.MashupSelector"
},
"mandatory": false,
"key": "linkToMashup"
}
]
}
],
"updateServiceName": "UpdateAvailableAttributes",
"addServiceName": "GetCustomAttributes",
"maximumSelectedAttributes": null,
"minimumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": true,
"key": "attributes"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListFilterFieldDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"type": {},
"dynamiclySetTypeServiceName": "GetFilterTypeDefinitionForFilterField"
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.FieldFilter"
},
"mandatory": false,
"key": "defaultSelectedFilterValues"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.Textbox"
},
"mandatory": false,
"key": "filterLabelOverride"
}
]
}
],
"updateServiceName": "UpdateAvailableFilterAttributes",
"addServiceName": "GetCustomFilterAttributes",
"maximumSelectedAttributes": 1,
"minimumSelectedAttributes": 0
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "filterFields"
},
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"supportedTypes": {
"data": [ // Tasks specific:
{
"adapter": {
"thingName": "PTC.WCAdapter",
"instanceName": "windchill"
},
"itemListsData": [
{
"objectType": "PTC.Workflow.WorkItem",
"selectionGroupIds": ["1"]
}
]
}
],
"allowSubsetForTailoring": false
},
"additionalDefinition": [
{
"key": "itemListDefaultSortFieldDefinition",
"directDefinition": [
{
"property": {},
"value": {
"initializationData": {
"constraints": {},
"properties": {
"options": [
{
"key": "asc",
"label": "[[PTC.Nav.ItemList.SortOrder.Asc]]",
"description": "",
"additionalDefinition": []
},
{
"key": "dsc",
"label": "[[PTC.Nav.ItemList.SortOrder.Dsc]]",
"description": "",
"additionalDefinition": []
}
],
"updateServiceName": "",
"addServiceName": ""
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.RadioButton"
},
"mandatory": false,
"key": "defaultSortDirection"
}
]
}
],
"updateServiceName": "UpdateAvailableSortAttributes",
"addServiceName": "GetCustomSortAttributes",
"maximumSelectedAttributes": null,
"minimumSelectedAttributes": null
}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.AttributesSelector"
},
"mandatory": false,
"key": "defaultSortFields"
}
...
]