Modelos compostos personalizados (componentes) - AWS IoT SiteWise
Modelos compostos personalizados em linhaC: omponent-model-based modelos compostos personalizadosUse caminhos para referenciar propriedades personalizadas do modelo composto

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

Modelos compostos personalizados (componentes)

Quando você está modelando um ativo industrial especialmente complexo, como uma peça de maquinário complicada que tem muitas peças, pode ser um desafio manter seus modelos de ativos organizados e sustentáveis.

Nesses casos, você pode adicionar modelos compostos personalizados, ou componentes, se estiver usando o console, aos seus modelos de ativos e modelos de componentes existentes. Isso ajuda você a se manter organizado agrupando propriedades relacionadas e reutilizando definições de subcomponentes.

Há dois tipos de modelos compostos personalizados:

  • Os modelos compostos personalizados embutidos definem um conjunto de propriedades agrupadas que se aplicam ao modelo de ativo ou modelo de componente ao qual o modelo composto personalizado pertence. Você os usa para agrupar propriedades relacionadas. Eles consistem em um nome, uma descrição e um conjunto de propriedades do modelo de ativos. Eles não são reutilizáveis.

  • Os modelos compostos omponent-model-based personalizados em C fazem referência a um modelo de componente que você deseja incluir em seu modelo de ativo ou modelo de componente. Você os usa para incluir submontagens padrão em seu modelo. Eles consistem em um nome, uma descrição e o ID do modelo de componente ao qual ele faz referência. Eles não têm propriedades próprias; o modelo de componente referenciado fornece suas propriedades associadas a qualquer ativo criado.

As seções a seguir ilustram como usar modelos compostos personalizados em seus designs.

Modelos compostos personalizados em linha

Modelos compostos personalizados em linha fornecem uma maneira de organizar seu modelo de ativos agrupando propriedades relacionadas.

Por exemplo, suponha que você queira modelar um ativo robótico. O robô inclui um servomotor, uma fonte de alimentação e uma bateria. Cada uma dessas partes constituintes tem suas próprias propriedades que você deseja incluir no modelo. Você pode definir um modelo de ativo chamado robot_model que tenha propriedades como as seguintes.

  • robot_model

    • servo_status(inteiro)

    • servo_position(duplo)

    • powersupply_status(inteiro)

    • powersupply_temperature(duplo)

    • battery_status(inteiro)

    • battery_charge(duplo)

No entanto, em alguns casos, pode haver muitos subconjuntos ou os próprios subconjuntos podem ter muitas propriedades. Nesses casos, pode haver tantas propriedades que se torne difícil referenciá-las e mantê-las em uma única lista simples na raiz do modelo, como no exemplo anterior.

Para lidar com essas situações, você pode usar um modelo composto personalizado embutido para agrupar propriedades. Um modelo composto personalizado em linha é um modelo composto personalizado que define suas próprias propriedades. Por exemplo, você pode modelar seu robô da seguinte forma.

  • robot_model

    • servo

      • status(inteiro)

      • position(duplo)

    • powersupply

      • status(inteiro)

      • temperature(duplo)

    • battery

      • status(inteiro)

      • charge(duplo)

No exemplo anterior,, servopowersupply, e battery estão os nomes dos modelos compostos personalizados em linha definidos no robot_model modelo de ativo. Cada um desses modelos compostos então define suas próprias propriedades.

nota

Nesse caso, cada modelo composto personalizado define suas próprias propriedades, de forma que todas as propriedades façam parte do próprio modelo de ativo (robot_modelnesse caso). Essas propriedades não são compartilhadas com nenhum outro modelo de ativo ou modelo de componente. Por exemplo, se você criasse algum outro modelo de ativo que também tivesse um modelo composto personalizado em linha chamadoservo, fazer uma alteração servo no interior não robot_model afetaria a definição do outro modelo de servo ativo.

Se você quiser implementar esse compartilhamento (por exemplo, ter apenas uma definição para um servo, que todos os seus modelos de ativos possam compartilhar), crie um modelo de componente para ele e, em seguida, crie modelos component-model-basedcompostos que façam referência a ele. Consulte a seção a seguir para obter detalhes.

Para obter informações sobre como criar modelos compostos personalizados em linha, consulte. Crie modelos compostos personalizados (componentes)

C: omponent-model-based modelos compostos personalizados

Você pode criar um modelo de componente AWS IoT SiteWise para definir uma submontagem padrão reutilizável. Depois de criar um modelo de componente, você pode adicionar referências a ele em seus outros modelos de ativos e modelos de componentes. Você faz isso adicionando um modelo composto component-model-based personalizado a qualquer modelo em que você queira referenciar o componente. Você pode adicionar referências ao seu componente de vários modelos ou várias vezes no mesmo modelo.

Dessa forma, você pode evitar a duplicação das mesmas definições nos modelos. Isso também simplifica a manutenção de seus modelos, porque todas as alterações feitas em um modelo de componente serão refletidas em todos os modelos de ativos que o utilizam.

Por exemplo, suponha que sua instalação industrial tenha muitos tipos de equipamentos que usam o mesmo tipo de servomotor. Alguns deles têm muitos servomotores em um único equipamento. Você cria um modelo de ativo para cada tipo de equipamento, mas não quer duplicar a definição de servo cada vez. Você deseja modelá-lo apenas uma vez e usá-lo em seus vários modelos de ativos. Se, posteriormente, você fizer uma alteração na definição deservo, ela será atualizada em todos os seus modelos e ativos.

Para modelar o robô do exemplo anterior dessa forma, você pode definir servomotores, fontes de alimentação e baterias como modelos de componentes, assim.

  • servo_component_model

    • status(inteiro)

    • position(duplo)

  • powersupply_component_model

    • status(inteiro)

    • temperature(duplo)

  • battery__component_model

    • status(inteiro)

    • charge(duplo)

Você poderia então definir modelos de ativosrobot_model, como os que fazem referência a esses componentes. Vários modelos de ativos podem referenciar o mesmo modelo de componente. Você também pode referenciar o mesmo modelo de componente várias vezes em um modelo de ativo, como se seu robô tivesse vários servomotores.

  • robot_model

    • servo1(referência:servo_component_model)

    • servo2(referência:servo_component_model)

    • servo3(referência:servo_component_model)

    • powersupply(referência:powersupply_component_model)

    • battery(referência:battery_component_model)

Para obter informações sobre como criar modelos de componentes, consulteCrie modelos de componentes.

Para obter informações sobre como referenciar seus modelos de componentes em outros modelos, consulteCrie modelos compostos personalizados (componentes).

Use caminhos para referenciar propriedades personalizadas do modelo composto

Ao criar uma propriedade em um modelo de ativo, modelo de componente ou modelo composto personalizado, você pode referenciá-la a partir de outras propriedades que usam seu valor, como transformações e métricas.

AWS IoT SiteWise fornece maneiras diferentes para você referenciar sua propriedade. A maneira mais simples geralmente é usar o ID da propriedade. No entanto, se a propriedade que você deseja referenciar estiver em um modelo composto personalizado, talvez seja mais útil referenciá-la por caminho.

Um caminho é uma sequência ordenada de segmentos de caminho que especifica uma propriedade em termos de sua posição entre os modelos compostos aninhados em um modelo de ativo e modelo composto.

Obtenha caminhos de propriedades

Você pode obter o caminho de uma propriedade a partir do path campo dela AssetModelProperty.

Por exemplo, suponha que você tenha um modelo de ativo robot_model que contém um modelo composto personalizadoservo, que tem uma propriedadeposition. Se você DescribeAssetModelCompositeModelligarservo, a position propriedade listará um path campo parecido com este: 

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

Usando caminhos de propriedades

Você pode usar um caminho de propriedade ao definir uma propriedade que faz referência a outras propriedades, como uma transformação ou métrica.

Uma propriedade usa uma variável para referenciar outra propriedade. Para obter mais informações sobre como trabalhar com variáveis, consulteUse variáveis em expressões de fórmulas.

Ao definir uma variável para referenciar uma propriedade, você pode usar o ID da propriedade ou seu caminho.

Para definir uma variável que usa o caminho da propriedade referenciada, especifique o propertyPath campo de seu valor.

Por exemplo, para definir um modelo de ativo que tenha uma métrica que faça referência a uma propriedade usando um caminho, você pode passar uma carga útil como essa para CreateAssetModel:

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