取代實體、內容與服務
從 ThingWorx 9.5.0 開始，您可以取代實體與特徵。您可以取代實體，其可在接下來的幾個發行版本中移除。所有實體及其特徵都可以取代。
可透過三種方式取代實體與特徵。
取代實體與特徵
您可以使用下列其中一種方法取代項目：
• 使用 Composer 選取「已取代」核取方塊。
• 透過使用 REST 呼叫。
• 透過 XML 或延伸功能匯入。
• 透過執行 EntityServices 下的 SetDeprecated 服務。此服務可大量設定多個實體與特徵的已取代屬性。
 |
必須以 major.minor.patch 格式新增版本。或者，也可以新增註解。
|
會顯示項目的取代指示器，如下圖所示。取代指示器可協助使用者識別最終可能會逐步淘汰的項目，進而選擇其他項目來取代。
檢視對實體或特徵設定的已取代
透過執行 EntityServices 資源下的 GetAspects 服務，您可以檢視已取代的實體或特徵。
透過已取代篩選實體
可使用 Composer 中的 
，根據已取代物件篩選實體。依預設，不會選取「顯示已取代物件」核取方塊。因此，選取核取方塊可查看已取代物件。
，根據已取代物件篩選實體。依預設，不會選取「顯示已取代物件」核取方塊。因此，選取核取方塊可查看已取代物件。
| | 重新整理瀏覽器時，會清除「顯示已取代物件」核取方塊。 |
記錄已取代
如果使用者建立、更新或刪除實體或特徵的已取代屬性，則記錄檔會保留在「稽核記錄」中。
如需詳細資訊，請參閱稽核子系統。
| | 不會稽核其他實體、成員或服務呼叫對實體或特徵的修改。 |
取代相關服務
下列服務適用於取代功能。
服務 | 資源 | 描述 |
|---|---|---|
SetDeprecated | EntityServices | 此服務會將實體設定為已取代。此服務可用來大量設定多個實體與特徵的已取代屬性。 以下是適用於服務的輸入參數： • Entity Name • Entity Type • Characteristic Type and Name (Property、Service、ConfigurationTable) 選用 • Deprecated (JSON 中的 Since 與 Comment) |
ListDeprecatedUsage | 此服務會列出目前實體內已取代實體與特徵的所有用法。 此服務可從各實體的「服務」標籤中存取。 • 執行此服務後，會收到下列參數： ◦ entityName ◦ entityType ◦ dependentEntityName ◦ dependentEntityType ◦ whereUsed ◦ characteristicsType ◦ characteristicsName |