进度
定义和用法
“进度”组件属于小组件，用于以图形的形式显示进度状况。此组件会将整体进度显示为水平进度栏，并将相应的详细信息显示在水平进度栏的下方。
下面是一个示例图像，其中显示了“进度”组件：
可通过以下方式配置“进度”组件：
• 定义标题
• 配置进度栏下方的消息
任务进度是适用于“进度”组件的预定义配置。
绑定属性
输入 | ||
|---|---|---|
属性名称 | 说明 | 属性类型 |
Input | 用于标识要从后端系统中获取的数据。 JSON 示例： { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.Workflow.WorkItem", "items":[ { "id":{ "value":"OR:wt.workflow.work.WorkItem:566231" } } ] } ] } ] } | CCO 格式的 JSON |
配置属性
下表显示了用于配置此组件的 JSON 属性。
有关详细信息，请参阅组件配置结构。
有关子属性的详细信息，请参阅子属性和容器键。
属性名称 | 说明 | 属性类型 | 默认值 | 必需或可选 | ||
|---|---|---|---|---|---|---|
title | 在组件中显示为标题的字符串。 | 不适用 | 可选 | |||
progressBarMessage | 显示在进度栏下方的字符串。这是一条指示进度的消息，按活动测量。 在进度栏消息中显示的占位符有 %0 和 %1。在预设组件中，这些值会分别替换为待处理项和已完成项。%total 也可用作占位符，将被替换为总项数。 例如，如果总共 7 项中已完成 5 项，而另外 2 项仍处于待处理状态，则字符串“已完成 %1 项，共 %total 项”将在用户界面中显示为“已完成 5 项，共 7 项”。字符串“%total 项中有 %0 项处于待处理状态”将在用户界面中显示为“7 项中有 2 项处于待处理状态”。请注意，无论字符串为何，蓝色进度条都会始终反映已完成任务的百分比。 | 不适用 | 可选 | |||
配置示例
有关“进度”组件的配置示例，请参阅任务进度。
自定义服务
除配置外，每个组件还支持通过扩展其业务逻辑来自定义组件。每个组件的业务逻辑在事物模板中都包含可改写服务，您可以对这些服务进行扩展和改写。下表对此组件的可改写服务进行了详细说明。
有关每个服务的返回值和参数的示例，请参阅自定义服务的输入/输出示例。
名称 | 说明 |
|---|---|
GetConfigurations | 返回组件实施的可用配置。 参数：无 返回：JSON |
GetImplementationLabel | 返回此组件的本地化名称或可用于获取此本地化名称的标记。此本地化名称显示在 Mashup Builder 用户界面中。 参数：无 返回：字符串 |
CalculateProgress | 计算并返回进度数据。创建自定义实施时，请使用自定义逻辑覆盖此服务。 有关适用于此服务的自定义逻辑的示例，请参阅任务进度。 参数： input (必需) - CCO 格式的 JSON，其中包含要从后端系统获取的数据的输入 ID，以及后端系统的适配器信息。 configuration (可选) - JSON，其中包含从“定制管理器”资源获得的最终合并配置。 返回：JSON |
实施定义
有关“进度”组件的实施定义，请参阅任务进度。