项标识
定义和用法
“项标识”可重用组件是一个小组件，用于显示特定项的基本信息，也称为标识信息。信息显示在面板中，通常位于项页面的顶部。面板包含项的主标题、二级标题和各种标识属性。它还包含嵌入的操作栏，其中包含可对该项执行的操作。您可以使用面板左上角的箭头展开或折叠项标识面板。折叠后，只有主要标题和操作栏可见。
您可以通过以下方式配置“项标识”可重用组件：
• 定义要显示的标识属性
• 配置嵌入操作栏中可用的操作
• 定义主要和次要标题
下面是一个显示“项标识”可重用组件的示例图像：
“任务标识”是“项标识”可重用组件的唯一预定义配置。有关详细信息和示例配置，请参阅“任务标识”。
绑定属性
项标识组件具有两个可用于绑定的属性：
• Input - 此 JSON 是需要从后端系统获取数据的输入 ID。此信息以 CCO (公用通信对象) 格式提供。以下是示例：
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.ChangeMgmt.ChangeRequest",
"items":[
{
"id":{
"value":"OR:wt.change2.WTChangeRequest2:439476"
}
}
]
}
]
}
]
}
• TailoringName - 此字符串是组件的实例名称。它与定制紧密相关。TailoringName 用于获取每个组件的已保存定制信息。
配置字段
下表显示了用于配置此组件的 JSON 字段。
属性名称 | 说明 | 类型 | 默认值 | 必需或可选 |
attributes | 其数据来自后端系统的属性的名称。请参阅子属性： | MultiValueSelector | 不适用 | 可选 |
id | 后端系统中属性的属性-名称标识符。例如，“Category#Display”。 | 字符串 | "" | 必需 |
ordinal | 属性在组件中出现的顺序。0 指示初始最左侧的位置。 | 整数 | 不适用 | 可选 |
objectType | 要获取其属性的对象类型。 | 字符串 | "" | 必需 |
adapter | 后端系统的源配置。请参阅子属性： | JSON | 不适用 | 必需 |
instanceName | 连接器实例，即，使有何种连接器连接到后端系统。 | 字符串 | "" | 必需 |
thingName | 从中检索数据的后端系统或适配器的名称。 | 字符串 | "" | 必需 |
inTailoring | “项标识”组件在定制页面中是否可定制。选项：true、false。 | 布尔型 | false | 可选 |
title | 出现在项标识面板顶部的主标题。请参阅子属性： | 不适用 | 不适用 | 必需 |
pattern | 在组件用户界面中显示为主标题的字符串。模式包含将动态替换的数字标识符。字符串中的每个数字标识符都对应于 id 字段中的一个属性名称。 | 字符串 | "" | 必需 |
id | 后端系统中属性的属性-名称标识符。例如，“Subject|SubjectName”。 | 字符串 | "" | 必需 |
numericIdentifier | 每个 id 都有一个数字标识符。模式字符串中的数字标识符被替换为 id 的检索值。 | 整数 | 1 | 必需 |
objectType | 要获取其属性的对象类型。 | 字符串 | "" | 必需 |
adapter | 后端系统的源配置。请参阅子属性： | adapter | 不适用 | 必需 |
instanceName | 连接器实例，即，使有何种连接器连接到后端系统。 | 字符串 | "" | 必需 |
thingName | 从中检索数据的后端系统或适配器的名称。 | 字符串 | "" | 必需 |
secondaryTitle | 二级标题，显示在项标识面板中的主标题下方。请参阅子属性： | 不适用 | 不适用 | 必需 |
pattern | 在组件用户界面中显示为次要标题的字符串。模式包含将动态替换的数字标识符。字符串中的每个数字标识符都对应于 id 字段中的一个属性名称。 | 字符串 | "" | 必需 |
id | 后端系统中属性的属性-名称标识符。例如，“Activity|Name”。 | 字符串 | "" | 必需 |
numericIdentifier | 每个 id 都有一个数字标识符。模式字符串中的数字标识符被替换为 id 的检索值。 | 整数 | 1 | 必需 |
objectType | 要获取其属性的对象类型。 | 字符串 | "" | 必需 |
adapter | 后端系统的源配置。请参阅子属性： | adapter | 不适用 | 必需 |
instanceName | 连接器实例，即，使有何种连接器连接到后端系统。 | 字符串 | "" | 必需 |
thingName | 从中检索数据的后端系统或适配器的名称。 | 字符串 | "" | 必需 |
modelThing | 请参阅子属性： | 不适用 | 不适用 | 必需 |
entityName | 获取数据的模型事物的名称。 | 字符串 | "PTC.ItemIdentity ModelThing" | 必需 |
version | 配置版本。 | 字符串 | “1.0.0” | 可选 |
actions | 在用户界面的操作栏中显示的操作。有关详细信息和子属性，请参阅 操作栏可重用组件。 | 不适用 | 不适用 | 可选 |
配置示例
以下示例 JSON 配置适用于其默认配置中的项标识。
{
"secondaryTitle": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"attributes": {
"selectedValues": {
"data": [
{
"itemListsData": [
{
"items": [
{
"id": ""
}
],
"objectType": ""
},
{
"items": [
{
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
},
"inTailoring": true
},
"title": {
"pattern": "",
"fields": {
"data": [
{
"itemListsData": [
{
"items": [
{
"numericIdentifier": 1,
"id": ""
}
],
"objectType": ""
}
],
"adapter": {
"instanceName": "",
"thingName": ""
}
}
]
}
},
"actions": {
"maxItemsToShow": {
"value": 2
},
"modelThingName": {
"entityName": "PTC.ActionBarModel.Thing"
},
"actions": {
"selectedValues": {
"data": [
{
"itemListsData": [],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
]
}
}
},
"modelThing": {
"entityName": "PTC.ItemIdentityModelThing",
"version": "1.0.0"
}
}
