本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
建立自訂複合模型 (元件)
自訂複合模型或元件 (如果您使用主控台) 可為您的資產模型和元件模型提供另一個層級的組織。您可以透過群組性質或參考其他模型來使用它們來建構模型。如需使用自訂複合模型的更多資訊,請參閱〈〉自訂複合模型 (元件)。
您可以在現有的資產模型或元件模型中建立自訂複合模型。有兩種類型的自訂複合模型。若要群組模型中的相關屬性,您可以建立內嵌自訂複合模型。若要參考資產模型或元件模型中的元件模型,您可以建立component-model-based自訂複合模型。
以下幾節說明如何使用建 AWS IoT SiteWise API立自訂複合模型。
主題
創建一個內聯組件(控制台)
您可以使用主 AWS IoT SiteWise 控台來建立定義其本身屬性的內嵌元件。
注意
由於這是內嵌元件,因此這些屬性僅適用於目前的資產模型,而不會在其他任何地方共用。
如果需要產生可重複使用的模型 (例如,要在多個資產模型之間共用,或在一個資產模型中包含多個例證),則應改為根據元件模型建立元件。有關詳細信息,請參見以下部分。
若要建立元件 (主控台)
導覽至 AWS IoT SiteWise 主控台
。 在導覽窗格中,選擇 Models (模型)。
-
選擇您要新增元件的資產模型。
-
在 [屬性] 索引標籤上選擇 [元件]。
-
選擇 [建立元件]。
-
在「建立元件」頁面上,執行下列動作:
-
輸入元件的「名稱」,例如
ServoMotor
或ServoMotor Model
。此名稱在此區域中您帳戶中的所有元件中必須是唯一的。 -
(選擇性) 新增模型的 Attribute definitions (屬性定義)。屬性代表很少變更的資訊。如需詳細資訊,請參閱定義靜態數據(屬性)。
-
(選擇性) 新增模型的 Measurement definitions (衡量值定義)。測量值代表來自您設備的資料串流。如需詳細資訊,請參閱定義來自設備的資料流(測量)。
-
(選擇性) 新增模型的 Transform definitions (轉換定義)。轉換是將資料從一種表單對映到另一個表單的公式。如需詳細資訊,請參閱轉換資料 (轉換)。
-
(選擇性) 新增模型的 Metric definitions (指標定義)。指標是隨時間間隔彙總資料的公式。指標可以從關聯資產輸入資料,因此您可以計算代表作業或作業子集的值。如需詳細資訊,請參閱彙總屬性和其他資產 (量度) 的資料。
-
選擇 [建立元件]。
-
建立內嵌自訂複合模型 (AWS CLI)
您可以使用 AWS Command Line Interface (AWS CLI) 建立定義其本身屬性的內嵌自訂複合模型。
使用此CreateAssetModelCompositeModel作業建立具有屬性的內嵌模型。此操作預期會有具備下列結構的承載。
注意
由於這是內嵌複合模型,因此這些屬性僅適用於目前的資產模型,而不會在其他任何地方共用。使它「內聯」的原因是它不為composedAssetModelId
字段提供值。
如果您需要產生可重複使用的模型 (例如,要在多個資產模型之間共用,或在一個資產模型中包含多個例項),則應改為建立component-model-based複合模型。有關詳細信息,請參見以下部分。
{ "assetModelCompositeModelName": "CNCLathe_ServoMotorA", "assetModelCompositeModelType": "CUSTOM", "assetModelCompositeModelProperties": [ { "dataType": "DOUBLE", "name": "Servo Motor Temperature", "type": { "measurement": {} }, "unit": "Celsius" }, { "dataType": "DOUBLE", "name": "Spindle speed", "type": { "measurement": {} }, "unit": "rpm" } ] }
建立 component-model-based 元件 (主控台)
您可以使用 AWS IoT SiteWise 主控台根據元件模型建立元件。
若要建立 component-model-based 元件 (主控台)
導覽至 AWS IoT SiteWise 主控台
。 在導覽窗格中,選擇 Models (模型)。
-
選擇您要新增元件的資產模型。
-
在 [屬性] 索引標籤上選擇 [元件]。
-
選擇 [建立元件]。
-
在「建立元件」頁面上,執行下列動作:
-
選取您要以元件為基礎的元件模型。
-
輸入元件的「名稱」,例如
ServoMotor
或ServoMotor Model
。此名稱在此區域中您帳戶中的所有元件中必須是唯一的。 -
選擇 [建立元件]。
-
建立 component-model-based自訂複合模型 (AWS CLI)
您可以使用在 AWS CLI 資產模型中建立 component-model-based 自訂複合模型。 component-model-based 自訂複合模型是您已在其他地方定義的元件模型的參考。
使用此CreateAssetModelCompositeModel作業建立 component-model-based 自訂複合模型。此操作預期會有具備下列結構的承載。
注意
在此範例中,的值composedAssetModelId
為現有元件模型的資產模型 ID 或外部 ID。如需詳細資訊,請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部參考物件 IDs。如需如何建立元件模型的範例,請參閱建立元件模型 (AWS CLI)。
{ "assetModelCompositeModelName": "CNCLathe_ServoMotorA", "assetModelCompositeModelType": "CUSTOM", "composedAssetModelId":
component model ID
]
由於它只是一個參考,因此除了名稱之外, component-model-based 自定義複合模型沒有自己的屬性。
如果要將同一元件的多個例證增加到資產模型中(例如,具有多個伺服馬達的CNC機器),您可以新增多個自 component-model-based 訂複合模型,每個模型都有自己的名稱,但都參照相同composedAssetModelId
。
您可以在其他零組件中巢狀元件。若要這樣做,您可以將 component-model-based 複合模型 (如本範例所示) 新增至其中一個元件模型。