建立自訂複合模型 (元件) - AWS IoT SiteWise
創建一個內聯組件（控制台）建立內嵌自訂複合模型 (AWS CLI)建立 component-model-based 元件 (主控台)建立 component-model-based自訂複合模型 (AWS CLI)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立自訂複合模型 (元件)

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

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

以下幾節說明如何使用建 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) 建立定義其本身屬性的內嵌自訂複合模型。

使用此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 元件 (主控台)

  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 自訂複合模型是您已在其他地方定義的元件模型的參考。

使用此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 複合模型 (如本範例所示) 新增至其中一個元件模型。