Mapeie fluxos de dados industriais para propriedades de ativos - AWS IoT SiteWise
Definir um alias de propriedade (console)Definir um alias de propriedade ()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á.

Mapeie fluxos de dados industriais para propriedades de ativos

Você pode definir um alias de propriedade na 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. /

    exemplo

    Se o caminho para sua variável forcompany/windfarm/3/turbine/7/temperature, então seu alias de propriedade é/company/windfarm/3/turbine/7/temperature.

    Para obter mais informações sobre a arquitetura de informações do OPC UA, consulte Modelo de informações e mapeamento do espaçamento de endereços na Referência Online do OPC UA.

    Observações

    • Se você configurar um prefixo de fluxo de dados para sua fonte de OPC UA, deverá incluir esse prefixo no alias da propriedade para todos os fluxos de dados dessa fonte.

      exemplo

      Se /RentonWA for um prefixo, o alias anterior será. /RentonWA/company/windfarm/3/turbine/7/temperature

    • Os apelidos de propriedades podem conter até 1.000 bytes. OPCOs caminhos das variáveis UA podem conter até 4.096 bytes. Atualmente, AWS IoT SiteWise não oferece suporte à ingestão de dados de variáveis de OPC UA com caminhos longos.

  • Se você ingerir dados de servidores Modbus usando uma fonte de TCP dados Modbus em um gateway SiteWise Edge, o alias de sua propriedade é:

    Modbus register set tag name

    Use esse valor para enviar dados desse conjunto de registros para uma propriedade do ativo.

  • Se você ingerir dados de outras fontes, como o uso de AWS IoT regras ou o API, deverá definir seus aliases de 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 fluxo de dados idênticos, adicione um prefixo aos caminhos de cada fonte para formar aliases exclusivos. Para obter mais informações, consulte OPCFontes de dados UA.

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 Mapeie fluxos externos de estado de alarme.

Definir um alias 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.

    AWS IoT SiteWise Captura de tela da página “Editar ativo” com um alias de propriedade destacado.

  6. Escolha Salvar.

Definir um alias de propriedade ()AWS CLI

Use 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 e não o conheceassetId, use o ListAssetsAPIpara listar todos os ativos de um modelo específico. Use a DescribeAssetoperação para visualizar as propriedades do seu ativo, incluindo propriedadesIDs.

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

  • assetId— O ID do ativo ou o ID externo. Para obter mais informações, consulte Objetos de referência com objetos externos IDs 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 Interaja com outros AWS serviços.

Para definir um alias de propriedade ()AWS CLI

  1. Execute o seguinte comando para recuperar o estado da notificação atual da propriedade. Substituir asset-id e property-id com a propriedade do ativoIDs.

    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 de notificação da propriedade está assetProperty.notification.state no JSON objeto.

    {
  "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: Substituir property-alias com o alias da propriedade e notification-state com o estado da notificação ou omita --property-notification-state para desativar as notificações. Opcionalmente, você pode atualizar a unidade do ativo com uma nova unit --property-unite.

    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: Substituir asset-id e property-id com a propriedade do ativoIDs.

    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 alias da propriedade está assetProperty.alias no JSON objeto 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": {}
    }
  }
}