屬性
定義與用法
「屬性」元件是顯示名稱值對的小器具。值始終顯示在名稱下方。您可以顯示不同資料類型的值。可使用群組名稱將屬性集顯示為群組。
以下是顯示屬性元件的範例圖像：
您可以透過下列方式配置屬性元件：
• 定義要顯示的屬性
• 設定版面配置與相關顯示設定
• 定義屬性群組的標題；此選項僅適用於具有垂直版面配置的屬性群組
泛用屬性是可用於屬性元件的泛用預先定義的組態。
繫結內容
輸入 | ||
|---|---|---|
屬性名稱 | 描述 | 內容類型 |
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 | 唯一識別屬性元件的實例。此值可在內部用於尋找特定實例的調整資訊。 只有為自訂任務提供了專用調整頁的情況下，才可使用此繫結內容。 | 字串 |
SubComponentConfiguration | 當此元件作為其他元件或已包含混搭內的子元件使用時，將組態繫結至此內容。 範例 JSON： { "implementationThingName":"PTC.Nav.AttributesGenericBusinessLogicThing", "configuration":{ "layout":{ "selectedKey":"horizontal", "additionalData":{ }, "version":"1.0.0" }, "attributes":{ "sets":[ { "data":{ "selectedValues":{ "data":[ { "itemListsData":[ { "items":[ { "id":"Role#Display", "ordinal":0 }, { "id":"Activity|Deadline", "ordinal":5 }, { "id":"Status#Display", "ordinal":4 } ], "objectType":"PTC.Workflow.WorkItem" }, { "items":[ { "id":"Category#Display", "ordinal":1 }, { "id":"RequestPriority#Display", "ordinal":3 } ], "objectType":"PTC.ChangeMgmt.ChangeRequest" } ], "adapter":{ "instanceName":"windchill", "thingName":"PTC.WCAdapter" } } ] } } } ] } } } | JSON |
組態內容
下表顯示用來配置此元件的 JSON 內容。
如需有關組態結構的詳細資訊，請參閱元件組態結構。
如需有關子內容的詳細資訊，請參閱子內容與容器金鑰。
屬性名稱 | 描述 | 內容類型 | 預設值 | 必要或選用 | |
|---|---|---|---|---|---|
attributes | 需要從後端系統擷取其資料之屬性的清單。 針對 Windchill，這些內容名稱必須與 Windchill REST Services EDM 所定義的名稱相符。 | N/A | 必要 | ||
isMultiLine | 決定是否應將內容換行。選項：true、false。 此內容是 layout 的子內容，且僅在 layout 設定為 vertical 時相關。其容器金鑰為 isMultilineDefinition。 | N/A | 必要 | ||
layout | 用於確定屬性在使用者介面中的排列方式。可用選項有： • vertical：不同的屬性會彼此堆疊在一起。 • horizontal：屬性會並排排列。 | N/A | 必要 | ||
maxHeight | 使用者介面中屬性名稱與值的高度上限。 如果內容超過 maxHeight 內容值，則「顯示更多/顯示更少」連結或按鈕即變為可用。 此內容僅適用於以下兩種情況： • 當 layout 設定為 horizontal 時。在此情況下，它是 layout 的子內容。 • 當 layout 設定為 vertical，且 isMultiLine 設定為 true 時。在此情況下，它是 isMultiLine 的子內容。 其容器金鑰為 dimensionDefinition。 | N/A | 必要 | ||
maxWidth | 使用者介面中屬性名稱與值的寬度上限。 此內容僅適用於以下兩種情況： • 當 layout 設定為 horizontal 時。在此情況下，它是 layout 的子內容。 • 當 layout 設定為 vertical，且 isMultiLine 設定為 false 時。在此情況下，它是 isMultiLine 的子內容。 其容器金鑰為 dimensionDefinition。 | N/A | 必要 | ||
範例組態
如需屬性元件的範例組態，請參閱泛用屬性組態。
自訂服務
除組態以外，每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明：
如需每個服務的傳回結果與參數範例，請參閱自訂服務的輸入/輸出範例。
名稱 | 描述 |
|---|---|
GetConfigurations | 傳回元件實行的可用組態。 參數：無 傳回：JSON |
GetImplementationLabel | 傳回元件的當地語系化名稱或可用於取得當地語系化名稱的權杖。此當地語系化名稱會顯示在 Mashup Builder 使用者介面中。 參數：無 傳回：字串 |
ProcessAttributesConfiguration | 處理屬性組態，並將屬性分為現成屬性與其他屬性。 以下列格式傳回 JSON，其中包含金鑰值對： • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON 屬性會根據其物件類型分為現成屬性與其他屬性。物件類型以 .Custom.Adapter 或 Custom.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。 傳回：CCO 格式的 JSON |
GetAdditionalAttributes | 傳回要新增至可用現成屬性清單的其他屬性清單。 參數：無 傳回：JSON |
UpdateAvailableAttributes | 更新屬性清單中的一或多個屬性，並傳回最終清單。 參數： attributes (必要) - 包含現成屬性與其他屬性清單的 JSON。 傳回：JSON |
實行定義
如需屬性元件的實行定義，請參閱泛用屬性組態。