任务进度
“任务进度”是“进度”组件的预定义配置。“任务进度”组件属于小组件，用于显示任务的进度信息，且专门用于显示更改请求任务的进度。该小组件包括进度条、已完成任务的成员的总计、成员投票汇总等信息。
以下示例图像显示“任务进度”的预定义配置：
绑定属性
有关绑定“任务进度”的信息，请参阅进度组件。
 | 对于“任务进度”，输入绑定属性支持 PTC.Workflow.WorkItem 对象类型。 |
配置属性
有关配置“任务进度”的信息，请参阅进度组件。
配置示例
{
"progressBarMessage":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.ProgressBarMessage]]"
},
"title":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.Title]]"
},
"baseConfigurationVersion": {
"value": "nav.1"
},
"implementationConfigurationVersion": {
"value": "nav.1"
}
}
"progressBarMessage":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.ProgressBarMessage]]"
},
"title":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.Title]]"
},
"baseConfigurationVersion": {
"value": "nav.1"
},
"implementationConfigurationVersion": {
"value": "nav.1"
}
}
自定义服务
除配置外，每个组件还支持通过扩展其业务逻辑来自定义组件。每个组件的业务逻辑在事物模板中都包含可改写服务，您可以对这些服务进行扩展和改写。下表对此组件的可改写服务进行了详细说明。
有关每个服务的返回值和参数的示例，请参阅自定义服务的输入/输出示例。
名称 | 说明 |
|---|---|
CalculateProgress | 计算并返回进度数据。它具有以下逻辑： 1. 对于给定的 WorkItem ID，从后端系统获取 UserEventList 属性的值。 2. 对于给定的 WorkItem ID，从后端系统获取所有参与者 workitems 的 WorkItemRoutingChoices 和 Status 属性。参与者 workitems 是指参与此工作项所属活动的用户的任务。 3. 使用获取的值，根据下列信息构造 CCO 格式的 JSON： a. 路由选择列表，以及针对各个路由选择，通过选择操作来完成的任务数。其中还包含待处理任务。待处理任务的状况为 Potential。 b. 每个路由选择的以下元数据信息： a. label (必需) - 在用户界面中显示为路由选择名称的字符串。 b. icon (可选) - 显示在路由选择名称旁边的图标的 ThingWorx 媒体实体路径。 c. isVisible (可选) - 用于确定是否在用户界面中显示路由选择的布尔值。即使路由选择的值设置为 false，也仍会使用它进行计算。在“任务进度”中，如有路由选择尚未选择任务，则这些路由选择会将此键设置为 false。待处理任务始终会将此键设置为 true。 d. ordinal (可选) - 此键用于确定用户界面中类别的排序。如果未指定序数，则无法保证类别的排序。 e. step (必需) - 用于指示此路由选择的任务是否已完成的数字。 ▪ 0 指示任务尚未启动。 ▪ 1 指示任务已完成。 “进度”组件仅支持值 0 和 1。在“任务进度”中，“待处理”是值为 0 时的唯一路由选择。 参数： input (必需) - CCO 格式的 JSON，其中包含要从后端系统获取的数据的输入 ID，以及后端系统的适配器信息。 configuration (可选) - JSON，其中包含从“定制管理器”资源获得的最终合并配置。 返回：JSON |
实施定义
{
"array": [
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "title"
},
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "progressBarMessage"
}
]
}
"array": [
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "title"
},
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "progressBarMessage"
}
]
}