Crie modelos compostos personalizados (componentes) - AWS IoT SiteWise
Crie um componente embutido (console)Crie um modelo composto personalizado em linha ()AWS CLICriar um component-model-based componente (console)Crie um modelo composto component-model-based personalizado ()AWS CLI

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á.

Crie modelos compostos personalizados (componentes)

Modelos compostos personalizados, ou componentes, se você estiver usando o console, fornecem outro nível de organização para seus modelos de ativos e modelos de componentes. Você pode usá-los para estruturar seus modelos agrupando propriedades ou referenciando outros modelos. Para obter mais informações sobre como trabalhar com modelos compostos personalizados, consulteModelos compostos personalizados (componentes).

Você cria 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 em um modelo, você pode criar um modelo composto personalizado em linha. Para referenciar um modelo de componente em seu modelo de ativo ou modelo de componente, você pode criar um modelo composto component-model-basedpersonalizado.

As seções a seguir descrevem como usar o AWS IoT SiteWise API para criar modelos compostos personalizados.

Crie um componente embutido (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 embutido, essas propriedades se aplicam somente 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 ativos ou incluir várias instâncias em um modelo de ativo), crie um componente com base em um modelo de componente. Consulte a seção a seguir para obter detalhes.

Para criar um componente (console)

  1. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, selecione Modelos.

  3. Escolha o modelo de ativo ao qual você deseja adicionar um componente.

  4. Na guia Propriedades, escolha Componentes.

  5. Escolha Criar componente.

  6. Na página Criar componente, faça o seguinte:

    1. Insira um nome para o componente, como ServoMotor ouServoMotor Model. Esse nome deve ser exclusivo em todos os componentes da sua conta nessa região.

    2. (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).

    3. (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 Defina fluxos de dados do equipamento (medições).

    4. (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 Transforme dados (transformações).

    5. (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 Dados agregados de propriedades e outros ativos (métricas).

    6. 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 CreateAssetModelCompositeModeloperação para criar um modelo em linha com propriedades. Essa operação espera uma carga útil com a seguinte estrutura.

nota

Como esse é um modelo composto em linha, essas propriedades se aplicam somente ao modelo de ativo atual e não são compartilhadas em nenhum outro lugar. O que o torna “embutido” é que ele não fornece um valor para o composedAssetModelId campo.

Se você precisar produzir um modelo reutilizável (por exemplo, para compartilhar entre vários modelos de ativos ou incluir várias instâncias em um modelo de ativo), crie um modelo component-model-basedcomposto. Consulte a seção a seguir para obter detalhes.

{
    "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 component-model-based componente (console)

Você pode usar o AWS IoT SiteWise console para criar um componente com base em um modelo de componente.

Para criar um component-model-based componente (console)

  1. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, selecione Modelos.

  3. Escolha o modelo de ativo ao qual você deseja adicionar um componente.

  4. Na guia Propriedades, escolha Componentes.

  5. Escolha Criar componente.

  6. Na página Criar componente, faça o seguinte:

    1. Selecione o modelo de componente no qual você deseja basear o componente.

    2. Insira um nome para o componente, como ServoMotor ouServoMotor Model. Esse nome deve ser exclusivo em todos os componentes da sua conta nessa região.

    3. Escolha Criar componente.

Crie um modelo composto component-model-based personalizado ()AWS CLI

Você pode usar o AWS CLI para criar um modelo composto component-model-based personalizado dentro do seu modelo de ativo. Um modelo composto component-model-based personalizado é uma referência a um modelo de componente que você já definiu em outro lugar.

Use a CreateAssetModelCompositeModeloperação para criar um modelo composto component-model-based personalizado. Essa operação espera uma carga útil com a seguinte estrutura.

nota

Neste exemplo, o valor de composedAssetModelId é a ID do modelo de ativo ou a ID externa de um modelo de componente existente. Para obter mais informações, consulte Objetos de referência com objetos externos IDs no Guia de Usuário AWS IoT SiteWise . Para obter um exemplo de como criar um modelo de componente, consulteCrie um modelo de componente (AWS CLI).

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

Como é apenas uma referência, um modelo composto component-model-based personalizado não tem propriedades próprias, além de um nome.

Se você quiser adicionar várias instâncias do mesmo componente ao seu modelo de ativos (por exemplo, uma CNC máquina com vários servomotores), você pode adicionar vários modelos compostos component-model-based personalizados, cada um com seu próprio nome, mas que fazem referência ao mesmo. composedAssetModelId

Você pode agrupar componentes em outros componentes. Para fazer isso, você pode adicionar um modelo component-model-based composto, conforme mostrado neste exemplo, a um dos seus modelos de componentes.