項目標識
定義與用法
「項目標識」元件是一個小器具，可讓您顯示特定項目的基本資訊，也稱為標識資訊。資訊會顯示在面板中，通常位於項目頁的頂部。此面板包含項目的圖像、主要標題、次要標題、次要圖示及各種標識屬性。次要圖示指示項目類型，可以配置為使用 Windchill 圖示。「項目標識」元件也包含內嵌的動作列，其中包含您可以針對項目執行的動作。
以下是顯示「項目標識」元件的範例圖像：
您可以透過下列方式配置「項目標識」元件：
• 定義主要標題與次要標題
• 配置內嵌動作列中的可用動作
• 定義要顯示的標識屬性
• 選擇是否要顯示圖像並定義預設圖像路徑
• 選擇是否顯示次要圖示
• 選擇面板是否可以摺疊
繫結內容
輸入 | ||||
|---|---|---|---|---|
內容名稱 | 描述 | 內容類型 | ||
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 內容。
如需有關組態結構的詳細資訊，請參閱元件組態結構。
如需有關子內容的詳細資訊，請參閱子內容與容器金鑰。
內容名稱 | 描述 | 內容類型 | 預設值 | 必要或選用 | |||
|---|---|---|---|---|---|---|---|
actionBarConfiguration | 要在使用者介面的動作列中顯示的動作。如需詳細資訊，請參閱動作列元件。 | N/A | 選用 | ||||
attributes | 資料獲取自後端系統的屬性清單。
| N/A | 選用 | ||||
defaultImagePath | 用來擷取圖像的預設路徑。 此內容是 showImage 的子內容，且僅在 showImage 設定為 true 時相關。其容器金鑰為 itemIdentityShowImageDefinition。 | N/A | 當 showImage 設定為 true 時為必要。 | ||||
enableExpandCollapse | 決定項目標識面板是否可在使用者介面中摺疊與展開。 當設定為 true 時，可以摺疊面板以僅顯示主要標題以及動作列 (如果相關)。 當設定為 false 時，面板無法摺疊且始終完全展開。 | true | 必要 | ||||
primaryTitle | 顯示在項目標識面板頂部的主要標題。 | N/A | 必要 | ||||
secondaryTitle | 次要標題，顯示在「項目標識」面板中主要標題的下方。 | N/A | 必要 | ||||
showImage | 決定是否要在「項目標識」面板中顯示圖像。 選項：true、false。 若設定為 true，圖像會顯示在面板中。使用 defaultImagePath 內容定義圖像路徑。 若設定為 false，不會顯示任何圖像。 | N/A | 必要 | ||||
showSecondaryIcon | 是否顯示次要圖示。 選項：true、false。 若設定為 true，會在面板中顯示次要圖示。若設定為 false，不會顯示次要圖示。 | false | 必要 | ||||
範例組態
自訂服務
除組態以外，每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明：
如需每個服務的傳回結果與參數範例，請參閱自訂服務的輸入/輸出範例。
名稱 | 描述 |
|---|---|
GetConfigurations | 傳回元件實行的可用組態。 參數：無 傳回：JSON |
GetImplementationLabel | 傳回元件的當地語系化名稱或可用於取得當地語系化名稱的權杖。此當地語系化名稱會顯示在 Mashup Builder 使用者介面中。 參數：無 傳回：字串 |
ProcessAttributesConfiguration | 處理屬性組態，並將屬性分為現成屬性與其他屬性。 以下列格式傳回 JSON，其中包含金鑰值對： • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON 屬性會根據其物件類型分為現成屬性與其他屬性。物件類型以 .Custom.Adapter 或 .Custom.Implementation 結尾的屬性會被視為其他屬性。其他所有屬性都被視為現成屬性。 「項目標識」元件不支援僅使用物件類型以 .Custom.Implementation 結尾的的屬性。請務必至少使用一個具有不同物件類型的屬性。 參數： attributes (必要) - 包含現成屬性與其他屬性清單的 JSON。 configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。 傳回：CCO 格式的 JSON |
GetItemIdentityAttributes | 檢查組態並新增所需的其他任何屬性，然後調用 GetAttributeValues 來從後端系統擷取所有屬性值。 參數： input (必要) - CCO 格式的 JSON，其中包括要從後端系統擷取之資料的輸入 ID，以及後端系統的轉接器資訊。 configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。 attributes (必要) - 包含現成屬性清單的 JSON，如在組態中所定義或透過調整所設定。 傳回：JSON |
GetAttributesValues | 傳回 JSON，其中包含屬性及其值。 參數： input (必要) - CCO 格式的 JSON，其中包括要從後端系統擷取之資料的輸入 ID，以及後端系統的轉接器資訊。 configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。 attributes (必要) - 包含現成屬性與其他屬性清單的 JSON。 傳回：CCO 格式的 JSON |
GetAdditionalAttributes | 傳回要新增至可用現成屬性清單的其他屬性清單。 參數：無 傳回：JSON |
實行定義