Mapeamento de fluxos de dados industriais para propriedades de ativos

Você pode definir um alias de propriedade em qualquer tipo de propriedade do ativo. Isso ajuda você a identificar uma propriedade do ativo ao ingerir ou recuperar dados do ativo. Se o ativo tiver propriedades de medição, será possível definir os apelidos das propriedades para mapear os fluxos de dados para essas propriedades de medição.

Esse processo requer conhecer o apelido da sua propriedade.

• Se você ingerir dados de servidores OPC-UA usando uma fonte de dados OPC-UA em um gateway SiteWise Edge, seu alias de propriedade é o caminho para uma variável no nó Objetos, começando com. / Por exemplo, se o caminho para a variável for company/windfarm/3/turbine/7/temperature, o apelido da propriedade será /company/windfarm/3/turbine/7/temperature. Para obter mais informações sobre a arquitetura de informações OPC-UA, consulte mapeamento Modelo de Informação e Espaçamento de Endereços na Referência Online OPC UA.

  Observações

  • Se você configurar um prefixo do fluxo de dados para a origem do OPC-UA, será necessário incluir esse prefixo no apelido da propriedade em todos os fluxos de dados dessa origem. Por exemplo, se você usar /RentonWA como prefixo, o apelido anterior será /RentonWA/company/windfarm/3/turbine/7/temperature.

  • Os apelidos de propriedades podem conter até 1.000 bytes. Os caminhos de variáveis do OPC-UA podem conter até 4.096 bytes. Atualmente, AWS IoT SiteWise não suporta a ingestão de dados de variáveis OPC-UA com caminhos longos.

• Se você ingerir dados de servidores Modbus usando uma fonte de dados Modbus TCP em um gateway SiteWise Edge, o alias de sua propriedade é Modbus. register set tag name Você pode usar esse valor para enviar dados desse conjunto de registros para uma propriedade do ativo.

• Se você ingerir dados de outras fontes, por meio do uso de regras AWS IoT ou da API, defina os apelidos da propriedade. É possível definir um sistema de nomenclatura de apelido de propriedade aplicável à configuração do seu dispositivo. Por exemplo, se você ingerir dados de coisas AWS IoT , será possível incluir o nome da coisa nos apelidos de propriedade para identificar os fluxos de dados de forma exclusiva. Para obter mais informações sobre esse exemplo, consulte o tutorial Como ingerir dados de AWS IoT coisas.

Os aliases de propriedade devem ser exclusivos dentro de uma região e AWS conta. AWS IoT SiteWise retornará um erro se você definir um alias de propriedade como um que já existe em outra propriedade do ativo.

Se você tiver várias fontes de OPC-UA com caminhos de fluxos de dados idênticos, será possível adicionar um prefixo aos caminhos de cada fonte para criar apelidos exclusivos. Para ter mais informações, consulte Configurar fontes de dados.

nota

Esta seção descreve como definir apelidos de propriedades para propriedades de medição. Para obter mais informações sobre como definir apelidos de propriedades para propriedades externas de estado de alarme, consulte Mapear fluxos externos de estado de alarme.

Definir um apelido de propriedade (console)

Você pode usar o AWS IoT SiteWise console para definir um alias para uma propriedade do ativo.

Como definir um apelido de propriedade (console)

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

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

3. Escolha o ativo para o qual deseja definir um apelido de propriedade.

   dica

   Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

4. Selecione a opção Editar.

5. Localize a propriedade para a qual você deseja definir um apelido e insira o apelido da propriedade.

   

6. Escolha Salvar.

Definindo um alias de propriedade ()AWS CLI

Você pode usar o AWS Command Line Interface (AWS CLI) para definir um alias para uma propriedade do ativo.

Para executar este procedimento, é necessário saber quais são o assetId do ativo e o propertyId da propriedade. Você também pode usar o ID externo. Se você criou um ativo, mas não o conheceassetId, use a ListAssetsAPI para visualizar todos os seus ativos de um modelo específico. Em seguida, use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo os IDs da propriedade.

Para mapear um fluxo de dados para a propriedade do seu ativo, use a UpdateAssetPropertyoperação. Especifique os seguintes parâmetros:

• assetId— O ID do ativo ou ID externo. Para obter mais informações, consulte Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .

• propertyId— O ID da propriedade do ativo ou o ID externo.

• propertyAlias – O caminho do fluxo de dados para o apelido para a propriedade.

• propertyNotificationState – O estado de notificação do valor da propriedade: ENABLED ou DISABLED. Especifique o estado de notificação existente da propriedade ao atualizar o apelido da propriedade. Você pode recuperar o estado de notificação existente com a DescribeAssetPropertyoperação.

  Se você omitir esse parâmetro, o novo estado de notificação será DISABLED. Para obter mais informações sobre notificações de propriedade, consulte Interagir com outros serviços da AWS.

Para definir um alias de propriedade ()AWS CLI

1. Execute o seguinte comando para recuperar o estado da notificação atual da propriedade. Substitua asset-id e property-id pelas IDs da propriedade do ativo.

   aws iotsitewise describe-asset-property \
     --asset-id asset-id \
     --property-id property-id

   A operação retorna uma resposta que contém os detalhes da propriedade do ativo no formato a seguir. O estado da notificação da propriedade está em assetProperty.notification.state no objeto JSON.

   {
     "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
     "assetName": "Wind Turbine 7",
     "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
     "assetProperty": {
       "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
       "name": "Wind Speed",
       "notification": {
         "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "state": "ENABLED"
       },
       "dataType": "DOUBLE",
       "unit": "m/s",
       "type": {
         "measurement": {}
       }
     }
   }

2. Execute o seguinte comando para definir o apelido da propriedade do ativo: Substitua property-apelido pelo apelido da propriedade e notification-state pelo estado da notificação ou omita --property-notification-state para desabilitar as notificações. Opcionalmente, você pode atualizar a unidade do ativo com uma nova unidade e. --property-unit

   aws iotsitewise update-asset-property \
     --asset-id asset-id \
     --property-id property-id \
     --property-alias property-alias \
     --property-notification-state notification-state \
     --property-unit unit

3. Para verificar se o apelido foi definido, execute o comando a seguir para recuperar os detalhes da propriedade: Substitua asset-id e property-id pelas IDs da propriedade do ativo.

   aws iotsitewise describe-asset-property \
     --asset-id asset-id \
     --property-id property-id

   A operação retorna uma resposta que contém os detalhes da propriedade do ativo no formato a seguir. O apelido da propriedade é assetProperty.alias no objeto JSON e está definido como myAlias neste exemplo.

   {
     "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
     "assetName": "Wind Turbine 7",
     "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
     "assetProperty": {
       "alias": "myAlias",
       "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
       "name": "Wind Speed",
       "notification": {
         "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
         "state": "ENABLED"
       },
       "dataType": "DOUBLE",
       "unit": "m/s",
       "type": {
         "measurement": {}
       }
     }
   }