建立自訂複合模型 (零組件)

自訂複合模型或元件 (如果您使用主控台) 可為您的資產模型和元件模型提供另一個層級的組織。您可以透過群組性質或參考其他模型來使用它們來建構模型。如需使用自訂複合模型的更多資訊，請參閱〈〉自訂複合模型 (零組件)。

您可以在現有的資產模型或元件模型中建立自訂複合模型。有兩種類型的自訂複合模型。若要群組模型中的相關屬性，您可以建立內嵌自訂複合模型。若要參考資產模型或元件模型中的元件模型，您可以建立以元件模型為基礎的自訂複合模型。

以下各節說明如何使用 AWS IoT SiteWise API 建立自訂複合模型。

創建一個內聯組件（控制台）

您可以使用主 AWS IoT SiteWise 控台來建立定義其本身屬性的內嵌元件。

注意

由於這是內嵌元件，因此這些屬性僅適用於目前的資產模型，而不會在其他任何地方共用。

如果需要產生可重複使用的模型 (例如，要在多個資產模型之間共用，或在一個資產模型中包含多個例證)，則應改為根據元件模型建立元件。有關詳細信息，請參見以下部分。

若要建立元件 (主控台)

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 Models (模型)。

3. 選擇您要新增元件的資產模型。

4. 在「屬性」標籤上，選擇「元件」。

5. 選擇 [建立元件]。

6. 在「建立元件」頁面上，執行下列動作：

   1. 輸入元件的「名稱」，例如ServoMotor或ServoMotor Model。此名稱在此區域中您帳戶中的所有元件中必須是唯一的。

   2. (選擇性) 新增模型的 Attribute definitions (屬性定義)。屬性代表很少變更的資訊。如需詳細資訊，請參閱 定義靜態數據（屬性）。

   3. (選擇性) 新增模型的 Measurement definitions (衡量值定義)。測量值代表來自您設備的資料串流。如需詳細資訊，請參閱 從設備定義資料流 (測量)。

   4. (選擇性) 新增模型的 Transform definitions (轉換定義)。轉換是將資料從一種表單對映到另一個表單的公式。如需詳細資訊，請參閱 轉換資料 (轉換)。

   5. (選擇性) 新增模型的 Metric definitions (指標定義)。指標是隨時間間隔彙總資料的公式。指標可以從關聯資產輸入資料，因此您可以計算代表作業或作業子集的值。如需詳細資訊，請參閱 彙總屬性和其他資產 (量度) 的資料。

   6. 選擇 [建立元件]。

建立內嵌自訂複合模型 (AWS CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 建立定義其本身屬性的內嵌自訂複合模型。

使用「CreateAssetModelComposite模型」操作來建立具有屬性的內嵌模型。此操作預期會有具備下列結構的承載。

注意

由於這是內嵌複合模型，因此這些屬性僅適用於目前的資產模型，而不會在其他任何地方共用。使它「內聯」的原因是它不為composedAssetModelId字段提供值。

如果需要產生可重複使用的模型 (例如，要在多個資產模型之間共用，或在一個資產模型中包含多個例證)，則應改為建立以元件模型為基礎的複合模型。有關詳細信息，請參見以下部分。

{
    "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 元件 (主控台)

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 Models (模型)。

3. 選擇您要新增元件的資產模型。

4. 在「屬性」標籤上，選擇「元件」。

5. 選擇 [建立元件]。

6. 在「建立元件」頁面上，執行下列動作：

   1. 選取您要以元件為基礎的元件模型。

   2. 輸入元件的「名稱」，例如ServoMotor或ServoMotor Model。此名稱在此區域中您帳戶中的所有元件中必須是唯一的。

   3. 選擇 [建立元件]。

建立 component-model-based 自訂複合模型 (AWS CLI)

您可以使用在 AWS CLI 資產模型中建立 component-model-based 自訂複合模型。 component-model-based 自訂複合模型是您已在其他地方定義的元件模型的參考。

使用「CreateAssetModelComposite模型」操作建立 component-model-based 自訂複合模型。此操作預期會有具備下列結構的承載。

注意

在此範例中，的值composedAssetModelId為現有元件模型的資產模型 ID 或外部 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部 ID 參考物件。如需如何建立元件模型的範例，請參閱建立元件模型 (AWS CLI)。

{
    "assetModelCompositeModelName": "CNCLathe_ServoMotorA",
    "assetModelCompositeModelType": "CUSTOM",
    "composedAssetModelId": component model ID
]

由於它只是一個參考，因此除了名稱之外， component-model-based 自定義複合模型沒有自己的屬性。

如果要將同一元件的多個例證增加到資產模型中（例如，具有多個伺服馬達的 CNC 機床），您可以加入多個自 component-model-based 訂複合模型，每個模型都有自己的名稱，但都參照相同composedAssetModelId。

您可以在其他零組件中巢狀元件。若要這樣做，您可以將 component-model-based 複合模型 (如本範例所示) 新增至其中一個元件模型。