将自定义属性添加到磁贴
“磁贴”可重用组件显示以 Windchill 作为其后端系统的属性。您还可以添加由磁贴显示的自定义属性。这些属性可能不是将 Windchill 作为其后端系统，或者需要自定义逻辑来衍生其值。
要将自定义属性添加到磁贴组件，请按照以下各节中的步骤进行操作。
为磁贴创建自定义属性
1. 在 ThingWorx Composer 中创建新的事物模板。将“基本事物模板”指定为 PTC.TileAttributeModelThingTemplate。
2. 在
“服务”选项卡下，单击
GetCustomAttributes 行中的
。
3. 添加逻辑以创建一个或多个自定义属性。ObjectType 必须以 .Custom 结尾。此 API 的输出格式为 JSON 格式的公用通信对象。以下是输出示例：
{
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": ""
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"version": "1.0.0"
}
4. 将更改保存到事物模板。
5. 在 ThingWorx Composer 中创建新的事物。将“基本事物模板”设置为您先前创建的事物模板。保存该事物。
将自定义属性添加到“我的任务”定制页面
如果要在“我的任务”的定制页面中显示您的自定义属性，请按以下步骤操作：
1. 在 ThingWorx Composer 中搜索名为 PTC.ViewMyTasks.TailoringPage.TilesAttributesThing 的事物。选择该事物。
2. 在
“属性和警报”选项卡下，单击
modelThing 行中的
。
3. 输入您先前创建的事物的名称。保存 PTC.ViewMyTasks.TailoringPage.TilesAttributesThing。
现在，您的自定义属性将显示在“我的任务”定制页面中。
获取自定义属性的值
1. 打开先前创建的事物模板。
2. 在
“服务”选项卡下，单击
GetCustomAttributesValues 行中的
。其将采用以下输入：
◦ input - 需要获取数据的输入 ID。
◦ configuration - 从定制页面中选择的属性。
◦ OOTBResponse - OOTB 定制属性的响应。
3. 如果需要，使用上述参数可以添加逻辑，以获取自定义属性的值。响应应采用与以下示例类似的格式：
{
"timeStamp": "2019-08-14 15:40:45.175",
"data": [
{
"itemListsData": [
{
"metadata": {
"AffectedObjects": {
"label": "Affected Objects",
"type": "STRING"
}
},
"items": [
{
"AffectedObjects": {
"value": "5"
}
}
],
"objectType": "PTC.ChangeMgmt.ChangeRequest.Custom"
}
],
"adapter": {
"instanceName": "windchill",
"thingName": "PTC.WCAdapter"
}
}
],
"statusMessage": "OK",
"status": "200"
}
4. 保存事物模板。
将自定义属性添加到混搭
1. 创建混搭或打开现有混搭。
2. 将“磁贴”组件插入到混搭中，然后单击
以配置组件。
3. 编辑属性 modelThing 的值，使其值与先前创建的事物的名称相同。
4. 单击“完成”并保存混搭。
| “磁贴”组件支持挂接自定义模型，以便在定制“我的任务”时添加自定义属性。如果在定制时选择了自定义属性，然后更改定制事物上的模型以添加新的自定义属性，则先前选择的自定义属性仍将显示在“更改管理任务集合”的“更改请求”详细信息页面中。为了确保先前选择的属性不会显示在详细信息页面上，请在更新定制事物后保存定制页面。 |
