Creación de modelos compuestos personalizados (componentes)

Los modelos compuestos personalizados, o componentes si utiliza la consola, proporcionan otro nivel de organización para sus modelos de activos y modelos de componentes. Puede utilizarlos para estructurar sus modelos agrupando propiedades o haciendo referencia a otros modelos. Para obtener más información sobre cómo trabajar con modelos compuestos personalizados, consulte. Modelos compuestos personalizados (componentes)

Puede crear un modelo compuesto personalizado dentro de un modelo de activos o de componentes existente. Hay dos tipos de modelos compuestos personalizados. Para agrupar propiedades relacionadas dentro de un modelo, puede crear un modelo compuesto personalizado en línea. Para hacer referencia a un modelo de componentes dentro de su modelo de activos o modelo de componentes, puede crear un modelo compuesto personalizado basado en un modelo de componentes.

En las siguientes secciones se describe cómo utilizar la AWS IoT SiteWise API para crear modelos compuestos personalizados.

Crear un componente en línea (consola)

Puede usar la AWS IoT SiteWise consola para crear un componente en línea que defina sus propias propiedades.

nota

Como se trata de un componente en línea, estas propiedades solo se aplican al modelo de activos actual y no se comparten en ningún otro lugar.

Si necesita crear un modelo reutilizable (por ejemplo, para compartirlo entre varios modelos de activos o para incluir varias instancias en un modelo de activos), debe crear un componente basado en un modelo de componentes. Consulte la siguiente sección para obtener más información.

Para crear un componente (consola)

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, elija Models (Modelos).

3. Elija el modelo de activo al que desea añadir un componente.

4. En la pestaña Propiedades, elija Componentes.

5. Seleccione Crear componente.

6. En la página Crear componente, haga lo siguiente:

   1. Introduzca un nombre para el componente, como ServoMotor oServoMotor Model. Este nombre debe ser único en todos los componentes de su cuenta en esta región.

   2. (Opcional) Agregue Definiciones de atributos para el modelo. Los atributos representan información que rara vez cambia. Para obtener más información, consulte Definición de datos estáticos (atributos).

   3. (Opcional) Agregue Definiciones de mediciones para el modelo. Las mediciones representan flujos de datos de su equipo. Para obtener más información, consulte Definición de flujos de datos procedentes del equipo (mediciones).

   4. (Opcional) Agregue Definiciones de transformación para el modelo. Las transformaciones son fórmulas que asignan datos de un formulario a otro. Para obtener más información, consulte Transformación de datos (transformaciones).

   5. (Opcional) Agregue Definiciones de métricas para el modelo. Las métricas son fórmulas que agregan datos a lo largo de intervalos de tiempo. Las métricas pueden agregar datos de entrada de activos asociados, de modo que puede calcular valores que representan la operación o un subconjunto de la operación. Para obtener más información, consulte Agregación de datos de propiedades y otros activos (métricas).

   6. Seleccione Crear componente.

Crear un modelo compuesto personalizado en línea ()AWS CLI

Puede usar el AWS Command Line Interface (AWS CLI) para crear un modelo compuesto personalizado en línea que defina sus propias propiedades.

Utilice la operación CreateAssetModelCompositeModelo para crear un modelo en línea con propiedades. Esta operación espera una carga con la siguiente estructura.

nota

Como se trata de un modelo compuesto en línea, estas propiedades solo se aplican al modelo de activos actual y no se comparten en ningún otro lugar. Lo que lo convierte en «integrado» es que no proporciona un valor para el composedAssetModelId campo.

Si necesita crear un modelo reutilizable (por ejemplo, para compartirlo entre varios modelos de activos o para incluir varias instancias dentro de un modelo de activos), debe crear un modelo compuesto basado en un modelo de componentes. Consulte la siguiente sección para obtener más información.

{
    "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"
        }
    ]
}

Creación de un component-model-based componente (consola)

Puede utilizar la AWS IoT SiteWise consola para crear un componente a partir de un modelo de componentes.

Para crear un component-model-based componente (consola)

1. Vaya a la consola de AWS IoT SiteWise.

2. En el panel de navegación, elija Models (Modelos).

3. Elija el modelo de activo al que desea añadir un componente.

4. En la pestaña Propiedades, elija Componentes.

5. Seleccione Crear componente.

6. En la página Crear componente, haga lo siguiente:

   1. Seleccione el modelo de componente en el que desee basar el componente.

   2. Introduzca un nombre para el componente, como ServoMotor oServoMotor Model. Este nombre debe ser único en todos los componentes de su cuenta en esta región.

   3. Seleccione Crear componente.

Crear un modelo compuesto component-model-based personalizado (AWS CLI)

Puede usarlo AWS CLI para crear un modelo compuesto component-model-based personalizado dentro de su modelo de activos. Un modelo compuesto component-model-based personalizado es una referencia a un modelo de componentes que ya ha definido en otro lugar.

Utilice la operación CreateAssetModelCompositeModelo para crear un modelo compuesto component-model-based personalizado. Esta operación espera una carga con la siguiente estructura.

nota

En este ejemplo, el valor de composedAssetModelId es el ID del modelo de activo o el ID externo de un modelo de componente existente. Para obtener más información, consulte Hacer referencia a objetos con identificadores externos en la Guía del usuario de AWS IoT SiteWise . Para ver un ejemplo de cómo crear un modelo de componentes, consulteCrear un modelo de componentes (AWS CLI).

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

Como es solo una referencia, un modelo compuesto component-model-based personalizado no tiene propiedades propias, salvo un nombre.

Si desea añadir varias instancias del mismo componente a su modelo de activos (por ejemplo, una máquina CNC con varios servomotores), puede añadir varios modelos compuestos component-model-based personalizados, cada uno con su propio nombre, pero que hagan referencia al mismo composedAssetModelId nombre.

Puede anidar componentes dentro de otros componentes. Para ello, puede añadir un modelo component-model-based compuesto, como se muestra en este ejemplo, a uno de sus modelos de componentes.