組態內容的變更範例
當透過延伸現成實行來建立自訂元件時，您可能會想要自訂元件的組態。欲執行此操作，請用您自己的組態取代自訂「物範本」中的
GetConfigurations 服務，如
建立自訂元件主題所述。當您自訂組態時，支援變更組態內容的值，而不支援對組態結構進行任何變更，例如新增或移除欄位。相較之下，當透過延伸現成基礎元件來建立自訂元件時，也支援變更組態 JSON 物件的整體結構
本主題提供的範例將變更組態內容值而不會變更整體組態結構。
變更組態內容值
我們將使用「屬性」元件作為範例來展示當您透過延伸泛用屬性實行建立自訂元件時，可以對組態進行的變更類型。如需有關這些組態內容的詳細資訊，請參閱
屬性主題中的組態內容表。假設我們從
泛用屬性主題中具有垂直版面配置的範例組態開始。然後我們新增內容
baseConfigurationVersion 與
implementationConfigurationVersion。當取代
GetConfigurations 服務時，應始終新增以上內容。組態將如此處所示：
屬性的初始組態
{
"baseConfigurationVersion":{
"value":"nav.1"
},
"implementationConfigurationVersion":{
"value":"nav.1",
"layout":{
"selectedKey":"vertical",
"additionalData":{
"isMultilineDefinition":{
"isMultiLine":{
"additionalData":{
"dimensionDefinition":{
"maxHeight":{
"version":"1.0.0",
"value":300
}
}
},
"version":"1.0.0",
"value":true
}
}
},
"version":"1.0.0"
},
"attributes":{
"sets":[
{
"data":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"Description",
"ordinal":0
},
{
"id":"ProposedSolution",
"ordinal":1
}
],
"objectType":"PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
},
"inTailoring":true,
"version":"1.0.0"
},
"name":""
}
],
"inTailoring":true,
"filteredValues":{
"data":[
{
"itemListsData":[
{
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
},
"version":"1.0.0"
}
}
}
受支援變更的範例
以下是您可以對組態進行的一些不同類型的變更：
• 變更個別內容值：您可以變更個別組態內容的值，例如 maxHeight、maxWidth、isMultiLine、id、ordinal 及其他內容。
• 新增或移除屬性：您可透過變更 items 下的屬性數目，來變更顯示在使用者介面中的屬性數目。
• 變更元件的版面配置：您可以將
layout 的值從
vertical 變更為
horizontal，然後變更
layout 下的子內容來變更版面配置，如
屬性元件相關主題所述。
為了說明這些變更，以下為您提供了屬性組態的修改版本，其中顯示了某些支援的變更：
屬性的已修改組態
{
"baseConfigurationVersion":{
"value":"nav.1"
},
"implementationConfigurationVersion":{
"value":"nav.1",
"layout":{
"selectedKey":"horizontal",
"additionalData":{
"dimensionDefinition":{
"maxHeight":{
"version":"1.0.0",
"value":150
},
"maxWidth":{
"version":"1.0.0",
"value":400
}
}
},
"version":"1.0.0"
},
"attributes":{
"sets":[
{
"data":{
"selectedValues":{
"data":[
{
"itemListsData":[
{
"items":[
{
"id":"Name",
"ordinal":0
},
{
"id":"Number",
"ordinal":1
},
{
"id":"Description",
"ordinal":2
},
{
"id":"LastModified",
"ordinal":3
}
],
"objectType":"PTC.ChangeMgmt.ChangeRequest"
}
],
"adapter":{
"instanceName":"windchill",
"thingName":"PTC.WCAdapter"
}
}
]
},
"inTailoring":true,
"version":"1.0.0"
},
"name":""
}
],
"inTailoring":true,
"filteredValues":{
"data":[
{
"itemListsData":[
{
"objectType":""
}
],
"adapter":{
"instanceName":"",
"thingName":""
}
}
]
},
"version":"1.0.0"
}
}
}