磁贴
定义和用法
“磁贴”组件属于小组件,可以磁贴格式显示名称值对,也称为属性。“磁贴”组件的用途是突出显示关键信息,以便用户能够一目了然。属性值显示在磁贴的上半部分,属性名称显示在磁贴的下半部分。值最多可占用两行,而名称最多可占用一行。如果值或名称太长而无法放在磁贴中,则会被截断,并以省略号表示。磁贴通常在一行中排列。如果一行中的磁贴过多,则磁贴尺寸会相应缩小加以适合。如果一行中的磁贴仍然过多,则磁贴显示会扩展至第二行。
下面是一个示例图像,其中显示了“磁贴”组件:
可通过以下方式配置“磁贴”组件:
设置要显示的磁贴的最大数量
添加附加属性
磁贴通用是适用于“磁贴”组件的通用预定义配置。
绑定属性 
输入
属性名称
说明
属性类型
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 属性。
有关详细信息,请参阅组件配置结构
有关子属性的详细信息,请参阅子属性和容器键
属性名称
说明
属性类型
默认值
必需或可选
attributes
需要从后端系统获取其数据的属性的名称。这些属性可以从后端系统中检索,也可以是附加属性。
不适用
必需
maxTileCount
显示为磁贴的属性的最大数量。如果设置为空字符串,则不会对所示磁贴的数量进行约束。
不适用
可选
配置示例 
有关“磁贴”组件的配置示例,请参阅磁贴通用配置。
自定义服务 
除配置外,每个组件还支持通过扩展其业务逻辑来自定义组件。每个组件的业务逻辑在事物模板中都包含可改写服务,您可以对这些服务进行扩展和改写。下表对此组件的可改写服务进行了详细说明。
有关每个服务的返回值和参数的示例,请参阅自定义服务的输入/输出示例
名称
说明
GetConfigurations
返回组件实施的可用配置。
参数:
返回:JSON
GetImplementationLabel
返回此组件的本地化名称或可用于获取此本地化名称的标记。此本地化名称显示在 Mashup Builder 用户界面中。
参数:
返回:字符串
ProcessAttributesConfiguration
处理属性配置,并将属性拆分为预设属性和附加属性。
返回 JSON,其中包含下列形式的键值对:
OOTBAttributes : OOTB Attributes configuration CCO JSON
additionalAttributes : Additional Attributes configuration CCO JSON
系统会根据对象类型将属性拆分为预设属性和附加属性。对象类型以 .Custom.AdapterCustom.Implementation 结尾的属性将被视为附加属性。而所有其他属性都将被视为预设属性。
参数:
attributes (必需) - JSON,其中包含预设属性和附加属性的列表。
configuration (可选) - JSON,其中包含从“定制管理器”资源获得的最终合并配置。
返回:CCO 格式的 JSON
GetAttributesValues
返回具有属性及其值的 JSON。
参数:
input (必需) - CCO 格式的 JSON,其中包含要从后端系统获取的数据的输入 ID,以及后端系统的适配器信息。
configuration (可选) - JSON,其中包含从“定制管理器”资源获得的最终合并配置。
attributes (必需) - JSON,其中包含预设属性和附加属性的列表。
返回:CCO 格式的 JSON
GetAdditionalAttributesValues
返回具有其他属性值的 JSON。此服务应通过组件实施来实现。
参数:
input (必需) - CCO 格式的 JSON,其中包含要从后端系统获取的数据的输入 ID,以及后端系统的适配器信息。
configuration (可选) - JSON,其中包含从“定制管理器”资源获得的最终合并配置。
attributes (必需) - JSON,其中包含附加属性的列表。
OOTBAttributesValues (可选) - CCO 格式的 JSON,其中包含由 GetAttributesValues 返回的预设属性的值。这些值可用于计算附加属性的值。
返回:CCO 格式的 JSON
GetAdditionalAttributes
返回要添加至可用预设属性列表中的附加属性的列表。
参数:
返回:JSON
实施定义 
有关“磁贴”组件的实施定义,请参阅磁贴通用配置。
这对您有帮助吗?