As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Criar modelos compostos personalizados (componentes)
Os modelos compostos personalizados, ou componentes se você estiver usando o console, oferecem outro nível de organização para os modelos de ativo e modelos de componente. Você pode usá-los para estruturar os modelos, agrupando propriedades ou fazendo referência a outros modelos. Para ter mais informações sobre como trabalhar com modelos compostos personalizados, consulte [Modelos compostos personalizados (componentes)](custom-composite-models.md).
Crie um modelo composto personalizado dentro de um modelo de ativo ou modelo de componente existente. Há dois tipos de modelos compostos personalizados. Para agrupar propriedades relacionadas dentro de um modelo, você pode criar um modelo composto personalizado **em linha**. Para fazer referência a um modelo de componente dentro do modelo de ativo ou modelo de componente, você pode criar um modelo composto personalizado **baseado em modelo de componente**.
As seções a seguir descrevem como usar a AWS IoT SiteWise API para criar modelos compostos personalizados.
**Topics**
+ [Criar um componente em linha (console)](#create-inline-component-console)
+ [Crie um modelo composto personalizado em linha (AWS CLI)](#create-inline-composite-models-cli)
+ [Criar um componente baseado em modelo de componente (console)](#create-component-console)
+ [Crie um modelo composto personalizado baseado em modelo de componente (AWS CLI)](#create-component-based-composite-model-cli)
## Criar um componente em linha (console)
Você pode usar o AWS IoT SiteWise console para criar um componente embutido que define suas próprias propriedades.
**nota**
Como esse é um componente *em linha*, essas propriedades só se aplicam ao modelo de ativo atual, e não são compartilhadas em nenhum outro lugar.
Se você precisar produzir um modelo reutilizável (por exemplo, para compartilhar entre vários modelos de ativo ou para incluir várias instâncias em um modelo de ativo), crie um componente com base em um modelo de componente. Para conferir detalhes, consulte a seção a seguir.
**Como criar um componente (console)**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação, selecione **Modelos**.
1. Escolha o modelo de ativo ao qual você deseja adicionar um componente.
1. Na guia **Propriedades**, escolha **Componentes**.
1. Escolha **Criar componente**.
1. Na página **Criar componente**, faça o seguinte:
1. Insira um **Nome** para o componente, como **ServoMotor** ou **ServoMotor Model**. Esse nome deve ser exclusivo entre todos os componentes da conta nessa região.
1. (Opcional) Adicione **Definições de atributo** ao modelo. Os atributos representam informações que raramente mudam. Para obter mais informações, consulte [Definir dados estáticos (atributos)](attributes.md).
1. (Opcional) Adicione **Definições de medição** ao modelo. As medições representam fluxos de dados do seu equipamento. Para obter mais informações, consulte [Definir fluxos de dados de equipamentos (medições)](measurements.md).
1. (Opcional) Adicione **Definições de transformação** ao modelo. As transformações são fórmulas que mapeiam dados de um formulário para outro. Para obter mais informações, consulte [Transformar dados (transformações)](transforms.md).
1. (Opcional) Adicione **Definições de métrica** ao modelo. Métricas são fórmulas que agregam dados em intervalos de tempo. As métricas podem inserir dados de entrada de ativos associados, para que você possa calcular valores que representem sua operação ou um subconjunto de sua operação. Para obter mais informações, consulte [Agregar dados de propriedades e outros ativos (métricas)](metrics.md).
1. Escolha **Criar componente**.
## Crie um modelo composto personalizado em linha (AWS CLI)
Você pode usar o AWS Command Line Interface (AWS CLI) para criar um modelo composto personalizado em linha que define suas próprias propriedades.
Use a [ CreateAssetModelCompositeModel ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html) operação para criar um modelo em linha com propriedades. Essa operação espera uma carga útil com a seguinte estrutura.
**nota**
Como trata-se de um componente composto *em linha*, essas propriedades só se aplicam ao modelo de ativo atual, e não são compartilhadas em nenhum outro lugar. O que faz dele “em linha” é que ele não fornece um valor para o campo `composedAssetModelId`.
Se você precisar produzir um modelo reutilizável (por exemplo, para compartilhar entre vários modelos de ativo ou para incluir várias instâncias em um modelo de ativo), crie um modelo composto *baseado em modelo de componente*. Para conferir detalhes, consulte a seção a seguir.
```
{
"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"
}
]
}
```
## Criar um componente baseado em modelo de componente (console)
Você pode usar o AWS IoT SiteWise console para criar um componente com base em um modelo de componente.
**Como criar um componente baseado em modelo de componente (console)**
1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. No painel de navegação, selecione **Modelos**.
1. Escolha o modelo de ativo ao qual você deseja adicionar um componente.
1. Na guia **Propriedades**, escolha **Componentes**.
1. Escolha **Criar componente**.
1. Na página **Criar componente**, faça o seguinte:
1. Selecione o modelo de componente no qual você deseja basear o componente.
1. Insira um **Nome** para o componente, como **ServoMotor** ou **ServoMotor Model**. Esse nome deve ser exclusivo entre todos os componentes da conta nessa região.
1. Escolha **Criar componente**.
## Crie um modelo composto personalizado baseado em modelo de componente (AWS CLI)
Você pode usar o AWS CLI para criar um modelo composto personalizado baseado em modelo de componente dentro do seu modelo de ativo. Um modelo composto personalizado baseado em modelo de componente é uma referência a um modelo de componente que você já definiu em outro lugar.
Use a [ CreateAssetModelCompositeModel ](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_CreateAssetModelCompositeModel.html) operação para criar um modelo composto personalizado baseado em modelo de componente. Essa operação espera uma carga útil com a seguinte estrutura.
**nota**
Neste exemplo, o valor de `composedAssetModelId` é o ID ou o ID externo do modelo de ativo de um modelo de componente existente. Consulte mais informações em [Fazer referência a objetos com IDs externos](object-ids.md#external-id-references) no *Guia de Usuário AWS IoT SiteWise *. Para conferir um exemplo de como criar um modelo de componente, consulte [Crie um modelo de componente (AWS CLI)](create-component-models.md#create-component-model-cli).
```
{
"assetModelCompositeModelName": "CNCLathe_ServoMotorA",
"assetModelCompositeModelType": "CUSTOM",
"composedAssetModelId": {{component model ID}}
]
```
Como é apenas uma referência, um modelo composto personalizado baseado em modelo de componente não tem propriedades próprias, além de um nome.
Se quiser adicionar várias instâncias do mesmo componente ao modelo de ativo (por exemplo, uma máquina CNC com vários servomotores), você poderá adicionar vários modelos compostos personalizados baseados em modelo de componente, cada um com o próprio nome, mas todos fazendo referência ao mesmo `composedAssetModelId`.
Você pode aninhar componentes dentro de outros componentes. Para isso, você pode adicionar um modelo composto baseado em modelo de componente, conforme mostrado neste exemplo, a um dos modelos de componente.