Modelos compuestos personalizados (componentes) - AWS IoT SiteWise
Modelos compuestos personalizados en líneaComponent-model-based modelos compuestos personalizadosUso de rutas para hacer referencia a propiedades de modelos compuestos personalizados

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Modelos compuestos personalizados (componentes)

Al modelar un activo industrial especialmente complejo, como una pieza de maquinaria complicada que consta de muchas piezas, mantener los modelos de activos organizados y fáciles de mantener puede convertirse en un desafío.

En esos casos, puede añadir modelos compuestos personalizados, o componentes si utiliza la consola, a sus modelos de activos y componentes existentes. Esto le ayuda a mantenerse organizado agrupando propiedades relacionadas y reutilizando definiciones de subcomponentes.

Hay dos tipos de modelos compuestos personalizados:

  • Los modelos compuestos personalizados en línea definen un conjunto de propiedades agrupadas que se aplican al modelo de activos o al modelo de componentes al que pertenece el modelo compuesto personalizado. Sirven para agrupar propiedades relacionadas. Constan de un nombre, una descripción y un conjunto de propiedades del modelo de activos. No son reutilizables.

  • Los modelos compuestos omponent-model-based personalizados en C hacen referencia a un modelo de componentes que desee incluir en su modelo de activos o modelo de componentes. Se utilizan para incluir subconjuntos estándar en el modelo. Constan de un nombre, una descripción y el ID del modelo de componentes al que hacen referencia. No tienen propiedades propias; el modelo de componentes al que se hace referencia proporciona las propiedades asociadas a los activos creados.

Las siguientes secciones ilustran cómo utilizar modelos compuestos personalizados en sus diseños.

Modelos compuestos personalizados en línea

Los modelos compuestos personalizados en línea proporcionan una forma de organizar el modelo de activos agrupando propiedades relacionadas.

Por ejemplo, supongamos que desea modelar un activo de robot. El robot incluye un servomotor, una fuente de alimentación y una batería. Cada una de esas partes constituyentes tiene sus propias propiedades que conviene incluir en el modelo. Puede definir un modelo de activos denominado robot_model que tenga propiedades como las siguientes.

  • robot_model

    • servo_status (entero)

    • servo_position (doble)

    • powersupply_status (entero)

    • powersupply_temperature (doble)

    • battery_status (entero)

    • battery_charge (doble)

Sin embargo, en algunos casos es posible que haya muchos subconjuntos o que los propios subconjuntos tengan muchas propiedades. En estos casos, es posible que haya tantas propiedades que resulte difícil hacer referencia a ellas y mantenerlas en una sola lista sin formato en la raíz del modelo, como en el ejemplo anterior.

Para hacer frente a estas situaciones puede utilizar un modelo compuesto personalizado en línea para agrupar propiedades. Un modelo compuesto personalizado en línea es un modelo compuesto personalizado que define sus propias propiedades. Por ejemplo, puede modelar su robot de la siguiente manera.

  • robot_model

    • servo

      • status (entero)

      • position (doble)

    • powersupply

      • status (entero)

      • temperature (doble)

    • battery

      • status (entero)

      • charge (doble)

En el ejemplo anterior, servo, powersupply y battery son los nombres de los modelos compuestos personalizados en línea definidos en el modelo de activos de robot_model. A continuación, cada uno de estos modelos compuestos define sus propias propiedades.

nota

En este caso, cada modelo compuesto personalizado define sus propias propiedades, de modo que todas las propiedades forman parte del propio modelo de activos (robot_model en este caso). Estas propiedades no se comparten con ningún otro modelo de activos o de componentes. Por ejemplo, si ha creado algún otro modelo de activos que también tuviera un modelo compuesto personalizado en línea denominado servo, realizar un cambio en el servo dentro de robot_model no afectaría a la definición de servo del otro modelo de activos.

Si desea implementar este tipo de compartición (por ejemplo, tener solo una definición para un servo que puedan compartir todos sus modelos de activos), debería crear un modelo de componentes para él y, a continuación, crear modelos component-model-basedcompuestos que hagan referencia a él. Consulte la siguiente sección para obtener más información.

Para obtener información sobre cómo crear modelos compuestos personalizados en línea, consulte Creación de modelos compuestos personalizados (componentes).

Component-model-based modelos compuestos personalizados

Puede crear un modelo de componente AWS IoT SiteWise para definir un subensamblaje estándar y reutilizable. Una vez creado un modelo de componentes, puede añadirle referencias en otros modelos de activos y modelos de componentes. Para ello, añada un modelo compuesto component-model-based personalizado a cualquier modelo en el que desee hacer referencia al componente. Puede añadir referencias al componente desde numerosos modelos o varias veces dentro del mismo modelo.

De esta forma, puede evitar la duplicación de las mismas definiciones en todos los modelos. También se simplifica el mantenimiento de los modelos, ya que cualquier cambio que realice en un modelo de componentes se reflejará en todos los modelos de activos que lo utilicen.

Por ejemplo, supongamos que su instalación industrial tiene muchos tipos de equipos y todos utilizan el mismo tipo de servomotor. Algunos de ellos tienen muchos servomotores en un solo equipo. Cree un modelo de activos para cada tipo de equipo, pero no conviene duplicar la definición de servo cada vez. Es mejor modelarlo solo una vez y usarlo en los distintos modelos de activos. Si más adelante cambia la definición de servo, se actualizará en todos los modelos y los activos.

Para modelar el robot del ejemplo anterior de esta manera puede definir servomotores, fuentes de alimentación y baterías como modelos de componentes, de este modo.

  • servo_component_model

    • status (entero)

    • position (doble)

  • powersupply_component_model

    • status (entero)

    • temperature (doble)

  • battery__component_model

    • status (entero)

    • charge (doble)

A continuación, puede definir modelos de activos, por ejemplo robot_model, que hagan referencia a estos componentes. Varios modelos de activos pueden hacer referencia al mismo modelo de componentes. También puede hacer referencia al mismo modelo de componentes varias veces en un modelo de activos, por ejemplo, si el robot tiene varios servomotores.

  • robot_model

    • servo1 (referencia: servo_component_model)

    • servo2 (referencia: servo_component_model)

    • servo3 (referencia: servo_component_model)

    • powersupply (referencia: powersupply_component_model)

    • battery (referencia: battery_component_model)

Para obtener información sobre cómo crear modelos de componentes, consulte Creación de modelos de componentes de .

Para obtener información sobre cómo hacer referencia a sus modelos de componentes en otros modelos, consulte Creación de modelos compuestos personalizados (componentes).

Uso de rutas para hacer referencia a propiedades de modelos compuestos personalizados

Al crear una propiedad en un modelo de activos, un modelo de componentes o un modelo compuesto personalizado, puede hacer referencia a ella desde otras propiedades que utilizan su valor, como transformaciones y métricas.

AWS IoT SiteWise proporciona diferentes formas de hacer referencia a su propiedad. La forma más sencilla suele ser utilizar su ID de propiedad. Sin embargo, si la propiedad a la que desea hacer referencia está en un modelo compuesto personalizado, puede que le resulte más útil hacer referencia a ella mediante una ruta.

Una ruta es una secuencia ordenada de segmentos de ruta que especifica una propiedad en términos de su posición entre los modelos compuestos anidados dentro de un modelo de activos y un modelo compuesto.

Obtención de rutas de propiedades

Puede obtener la ruta de una propiedad desde el path campo de su propiedad AssetModelProperty.

Por ejemplo, supongamos que tiene un modelo de activos robot_model que contiene un modelo compuesto personalizado servo, que tiene una propiedad position. Si DescribeAssetModelCompositeModelllamasservo, la position propiedad mostrará un path campo similar al siguiente: 

"path": [
    {
       "id": "asset model ID",
       "name": "robot_model"
    },
    {
       "id": "composite model ID",
       "name": "servo"
    },
    {
       "id": "property ID",
       "name": "position"
    }
]

Uso de rutas de propiedades

Puede usar una ruta de propiedad al definir una propiedad que haga referencia a otras propiedades, como una transformación o una métrica.

Una propiedad usa una variable para hacer referencia a otra propiedad. Para obtener más información sobre cómo trabajar con variables, consulte Uso de variables en expresiones de fórmula.

Al definir una variable para hacer referencia a una propiedad, puede utilizar el ID de la propiedad o su ruta.

Para definir una variable que utilice la ruta de la propiedad a la que se hace referencia, especifique el campo propertyPath de su valor.

Por ejemplo, para definir un modelo de activos que tenga una métrica que haga referencia a una propiedad mediante una ruta, podrías pasar una carga útil como esta a CreateAssetModel:

{
    ...
    "assetModelProperties": [
        {
            ...
            "type": {
                "metric": {
                    ...
                    "variables": [
                        {
                            "name": "variable name",
                            "value": {
                                "propertyPath": [
                                    path segments
                                ]
                            }
                        }
                    ],
                    ...
                }
            },
            ...
        },
        ...
    ],
    ...
}