创建自定义复合模型（组件） - Amazon IoT SiteWise
创建内联组件（控制台）创建内联自定义复合模型 (Amazon CLI)创建组 component-model-based 件（控制台）创建 component-model-based 自定义复合模型 (Amazon CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建自定义复合模型（组件）

自定义复合模型或组件（如果您使用的是控制台）可以为您的资产模型和组件模型提供另一个层次的组织。您可以使用它们通过对属性进行分组或引用其他模型来构造模型。有关使用自定义复合模型的更多信息，请参阅自定义复合模型（组件）。

您可以在现有资产模型或组件模型中创建自定义复合模型。有两种类型的自定义复合模型。要对模型中的相关属性进行分组，可以创建内联自定义复合模型。要在资产模型或组件模型中引用组件模型，可以创建component-model-based自定义复合模型。

以下各节介绍如何使用 Amazon IoT SiteWise API 创建自定义复合模型。

创建内联组件（控制台）

您可以使用 Amazon IoT SiteWise 控制台创建定义其自身属性的内联组件。

注意

由于这是一个内联组件，因此这些属性仅适用于当前的资产模型，不会在其他任何地方共享。

如果您需要生成可重复使用的模型（例如，在多个资产模型之间共享，或者在一个资产模型中包含多个实例），则应改为基于组件模型创建一个组件。有关详细信息，请参阅以下部分。

创建组件（控制台）

  1. 导航到 Amazon IoT SiteWise 控制台。

  2. 在导航窗格中，选择 模型。

  3. 选择要向其添加组件的资产模型。

  4. 在 “属性” 选项卡上，选择 “组件”。

  5. 选择创建组件。

  6. 在 “创建组件” 页面上，执行以下操作：

    1. 输入组件的名称，例如ServoMotor或ServoMotor Model。该名称在该地区您账户的所有组成部分中必须是唯一的。

    2. （可选）为模型添加 属性定义。属性表示很少更改的信息。有关更多信息，请参阅 定义静态数据（属性）。

    3. （可选）为模型添加 测量值定义。测量值代表来自您的设备的数据流。有关更多信息，请参阅 定义来自设备的数据流（测量）。

    4. （可选）为模型添加 转换定义。转换是将数据从一种表单映射到另一种表单的公式。有关更多信息，请参阅 转换数据（转换）。

    5. （可选）为模型添加 指标定义。指标是按时间间隔汇总数据的公式。指标可以从关联资产的指标中输入数据，这样您可以计算统计信息，从而提供对整个操作或部分操作的见解。有关更多信息，请参阅 聚合来自属性和其他资产（指标）的数据。

    6. 选择创建组件。

创建内联自定义复合模型 (Amazon CLI)

您可以使用 Amazon Command Line Interface (Amazon 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 件（控制台）

您可以使用 Amazon IoT SiteWise 控制台基于组件模型创建组件。

创建组 component-model-based 件（控制台）

  1. 导航到 Amazon IoT SiteWise 控制台。

  2. 在导航窗格中，选择 模型。

  3. 选择要向其添加组件的资产模型。

  4. 在 “属性” 选项卡上，选择 “组件”。

  5. 选择创建组件。

  6. 在 “创建组件” 页面上，执行以下操作：

    1. 选择要作为组件基础的组件模型。

    2. 输入组件的名称，例如ServoMotor或ServoMotor Model。该名称在该地区您账户的所有组成部分中必须是唯一的。

    3. 选择创建组件。

创建 component-model-based 自定义复合模型 (Amazon CLI)

您可以使用在 Amazon CLI 资产模型中创建 component-model-based 自定义复合模型。 component-model-based 自定义复合模型是对已在其他地方定义的组件模型的引用。

使用CreateAssetModelCompositeModel操作创建 component-model-based 自定义复合模型。此操作需要具有以下结构的负载。

注意

在此示例中，的值composedAssetModelId是现有组件模型的资产模型 ID 或外部 ID。有关更多信息，请参阅《Amazon IoT SiteWise 用户指南》中的 使用外部 ID 引用对象。有关如何创建组件模型的示例，请参见创建组件模型 (Amazon CLI)。

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

由于它只是一个参考，因此 component-model-based 自定义复合模型除了名称之外没有自己的属性。

如果要将同一组件的多个实例添加到资产模型中（例如，具有多个伺服电动机的数控机床），则可以添加多个 component-model-based 自定义复合模型，每个模型都有自己的名称，但所有模型的引用都相同composedAssetModelId。

您可以将组件嵌套在其他组件中。为此，您可以向其中一个组件模型添加 component-model-based 复合模型，如本示例所示。