项标识
定义和用法
“项标识”组件是一个小组件，用于显示特定项的基本信息，也称为标识信息。信息显示在面板中，通常位于项页面的顶部。相应的面板中提供项的图像、主要标题、次要标题、次要图标和各种标识属性。次要图标用于指示项类型，可配置为使用 Windchill 图标。“项标识”组件还提供嵌入式操作栏，其中包含可对该项执行的操作。
下面的示例图示为“项标识”组件：
可通过以下方式配置“项标识”组件：
• 定义主要和次要标题
• 配置嵌入式操作栏中提供的操作
• 定义要显示的标识属性
• 选取是否显示图像并定义默认的图像路径
• 选取是否显示次要图标
• 选取是否可以折叠面板
绑定特性
输入 | ||||
|---|---|---|---|---|
特性名称 | 说明 | 特性类型 | ||
Input | 用于标识要从后端系统中获取的数据。示例如下： JSON 示例： { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] }
| CCO 格式的 JSON | ||
TailoringName | 用于唯一标识“项标识”组件的实例。此值在内部使用，可供查找此特定实例的定制信息。 只有在自定义任务存在专用的定制页面时，才使用此绑定特性。 | 字符串 | ||
配置特性
以下表格和图像显示用于配置此组件的 JSON 特性。
有关详情，请参阅组件配置结构。
有关子特性的详情，请参阅子特性和容器键。
特性名称 | 说明 | 特性类型 | 默认值 | 必需或可选 | |||
|---|---|---|---|---|---|---|---|
actionBarConfiguration | 在用户界面的操作栏中显示的操作。有关详情，请参阅操作栏组件。 | 不适用 | 可选 | ||||
attributes | 从后端系统获取其数据的属性的列表。
| 不适用 | 可选 | ||||
defaultImagePath | 用于获取图像的默认路径。 此特性为 showImage 的子特性，只有在 showImage 设置为 true 时，此特性才相关。其容器键为 itemIdentityShowImageDefinition。 | 不适用 | 如果 showImage 设置为 true，则此特性为必需特性。 | ||||
enableExpandCollapse | 用于控制：在用户界面中是否可以折叠或展开“项标识”面板。 如果此特性设置为 true，则可以展开该面板来显示全部信息，或者折叠该面板以仅显示主要标题和相关的操作栏。 如果此特性设置为 false，则无法展开和折叠该面板。该面板是展开还是折叠，这取决于为 expanded 特性设置的值。 | true | 必需 | ||||
expanded | 用于控制：“项标识”面板的默认状态是展开还是折叠。 如果此特性设置为 true，则该面板默认处于展开状态。 如果此特性设置为 false，则该面板默认处于折叠状态。 | true | 必需 | ||||
primaryTitle | 主要标题，显示在“项标识”面板的顶部。 | 不适用 | 必需 | ||||
secondaryTitle | 次要标题，显示在“项标识”面板中的主要标题下方。 | 不适用 | 必需 | ||||
showImage | 用于控制：是否在“项标识”面板中显示图像。 选项：true 和 false。 如果此特性设置为 true，则会在该面板中显示图像。使用 defaultImagePath 特性定义图像路径。 如果此特性设置为 false，则不会在该面板中显示任何图像。 | 不适用 | 必需 | ||||
showSecondaryIcon | 用于控制：是否显示次要图标。 选项：true 和 false。 如果此特性设置为 true，则会在相应的面板中显示次要图标。如果此特性设置为 false，则不会在相应的面板中显示任何次要图标。 | false | 必需 | ||||
配置示例
自定义服务
除了配置外，每个组件还支持通过扩展其业务逻辑来自定义组件。每个组件的业务逻辑在事物模板中都包含可改写服务，您可以对这些服务进行扩展和改写。下表对此组件的可改写服务进行了详细说明。
有关每个服务的返回值和参数的示例，请参阅自定义服务的输入/输出示例。
名称 | 说明 |
|---|---|
GetConfigurations | 返回组件实施的可用配置。 参数：无 返回：JSON |
GetImplementationLabel | 返回此组件的本地化名称，或返回可用于获取此本地化名称的标记。此本地化名称显示在 Mashup Builder 用户界面中。 参数：无 返回：字符串 |
ProcessAttributesConfiguration | 处理属性配置，并将属性分为预设属性和附加属性。 返回 JSON，其中包含下列形式的键值对： • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON 系统会根据对象类型将属性拆分为预设属性和附加属性。对象类型以 .Custom.Adapter 或 .Custom.Implementation 结尾的属性将被视为附加属性。而所有其他属性都将被视为预设属性。 “项标识”组件不支持仅使用以 .Custom.Implementation 结尾的对象类型的属性。请确保至少使用一个具有不同对象类型的属性。 参数： attributes (必需) - JSON，其中包含预设属性和附加属性的列表。 configuration (可选) - JSON，其中包含从“定制管理器”资源获得的最终合并配置。 返回：CCO 格式的 JSON |
GetItemIdentityAttributes | 检查配置并添加所需的任何附加属性，然后调用 GetAttributeValues 以从后端系统获取所有属性值。 参数： input (必需) - CCO 格式的 JSON，其中包含要从后端系统获取的数据的输入 ID，以及后端系统的适配器信息。 configuration (可选) - JSON，其中包含从“定制管理器”资源获得的最终合并配置。 attributes (必需) - JSON，其中包含在配置中指定或通过定制方式设置的预设属性列表。 返回：JSON |
GetAttributesValues | 返回具有属性及其值的 JSON。 参数： input (必需) - CCO 格式的 JSON，其中包含要从后端系统获取的数据的输入 ID，以及后端系统的适配器信息。 configuration (可选) - JSON，其中包含从“定制管理器”资源获得的最终合并配置。 attributes (必需) - JSON，其中包含预设属性和附加属性的列表。 返回：CCO 格式的 JSON |
GetAdditionalAttributes | 返回要添加至可用预设属性列表中的附加属性的列表。 参数：无 返回：JSON |
实施定义