项标识
定义和用法
“项标识”组件属于小组件，用于显示特定项的基本信息，也称为标识信息。信息显示在面板中，通常位于项页面的顶部。相应的面板中包含项的图像、主要标题、次要标题、次要图标和各种标识属性。次要图标指示项类型，可将其配置为使用 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 时，此属性为必需属性。 | ||||
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 |
实施定义