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.
# Creación de modelos compuestos personalizados (componentes)
Los modelos compuestos personalizados, o los 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 acerca de cómo trabajar con modelos compuestos personalizados, consulte [Modelos compuestos personalizados (componentes)](custom-composite-models.md).
Puede crear un modelo compuesto personalizado dentro de un modelo de activos o modelo 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 modelos de componentes**.
En las siguientes secciones se describe cómo utilizar la AWS IoT SiteWise API para crear modelos compuestos personalizados.
**Topics**
+ [Creación de un componente en línea (consola)](#create-inline-component-console)
+ [Cree un modelo compuesto personalizado en línea (AWS CLI)](#create-inline-composite-models-cli)
+ [Creación de un componente basado en el modelo de componentes (consola)](#create-component-console)
+ [Cree un modelo compuesto personalizado basado en un modelo de componentes (AWS CLI)](#create-component-based-composite-model-cli)
## Creación de 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**
Dado que 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.
**Creación de un componente (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, elija **Models (Modelos)**.
1. Elija el modelo de activos al que desea añadir un componente.
1. En la pestaña **Propiedades**, elija **Componentes**.
1. Seleccione **Crear componente**.
1. En la página **Crear componente**, haga lo siguiente:
1. Escriba un **Nombre** para el componente, por ejemplo, **ServoMotor** o **ServoMotor Model**. Este nombre debe ser único en todos los componentes de su cuenta en esta región.
1. (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)](attributes.md).
1. (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)](measurements.md).
1. (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 [Datos de transformación (transformaciones)](transforms.md).
1. (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 desde propiedades y otros activos (métricas)](metrics.md).
1. Seleccione **Crear componente**.
## Cree 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 [CreateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html)operación para crear un modelo en línea con propiedades. Esta operación espera una carga con la siguiente estructura.
**nota**
Dado que 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 campo `composedAssetModelId`.
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 modelos 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 componente basado en el modelo de componentes (consola)
Puede utilizar la AWS IoT SiteWise consola para crear un componente a partir de un modelo de componentes.
**Creación de un componente basado en el modelo de componentes (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, elija **Models (Modelos)**.
1. Elija el modelo de activos al que desea añadir un componente.
1. En la pestaña **Propiedades**, elija **Componentes**.
1. Seleccione **Crear componente**.
1. En la página **Crear componente**, haga lo siguiente:
1. Seleccione el modelo de componentes en el que desee basar el componente.
1. Escriba un **Nombre** para el componente, por ejemplo, **ServoMotor** o **ServoMotor Model**. Este nombre debe ser único en todos los componentes de su cuenta en esta región.
1. Seleccione **Crear componente**.
## Cree un modelo compuesto personalizado basado en un modelo de componentes (AWS CLI)
Puede usarlo AWS CLI para crear un modelo compuesto personalizado basado en un modelo de componentes dentro de su modelo de activos. Un modelo compuesto personalizado basado en modelos de componentes es una referencia a un modelo de componentes que ya ha definido en otro lugar.
Utilice la [CreateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html)operación para crear un modelo compuesto personalizado basado en un modelo de componentes. Esta operación espera una carga con la siguiente estructura.
**nota**
En este ejemplo, el valor de `composedAssetModelId` es el ID del modelo de activos o el ID externo de un modelo de componentes existente. Para obtener más información, consulte [Objetos de referencia con ID externos](object-ids.md#external-id-references) en la *Guía del usuario de AWS IoT SiteWise*. Para ver un ejemplo de cómo crear un modelo de componentes, consulte [Cree un modelo de componentes (AWS CLI)](create-component-models.md#create-component-model-cli).
```
{
"assetModelCompositeModelName": "CNCLathe_ServoMotorA",
"assetModelCompositeModelType": "CUSTOM",
"composedAssetModelId": {{component model ID}}
]
```
Como es solo una referencia, un modelo compuesto personalizado basado en modelos de componentes 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 que tenga varios servomotores), puede añadir varios modelos compuestos personalizados basados en modelos de componentes, cada uno con su propio nombre, pero todos ellos haciendo referencia al mismo `composedAssetModelId`.
Puede anidar componentes dentro de otros componentes. Para ello, puede añadir un modelo compuesto basado en modelos de componentes, como se muestra en este ejemplo, a uno de sus modelos de componentes.