Configurar e testar a integração com o AWS SiteWise

Pré-requisitos

• Servidor de integração implantado e registrado na plataforma

• AWS SiteWise configurado

• Um perfil IAM configurado na máquina cliente ou diretamente no servidor de integração com as permissões necessárias para acessar o AWS SiteWise.

Tipos de consulta suportados

• Obter os valores atuais das propriedades de um ativo do AWS SiteWise

Recursos suportados

• Suporte automático de UoM

Etapas de configuração

Este guia descreve como configurar a integração com o AWS SiteWise para recuperar dados em um RealityAsset. Este guia pressupõe que um perfil IAM com as permissões corretas já esteja disponível.

As principais etapas para configurar a integração com o AWS SiteWise são as seguintes:

1. Registrar a fonte de dados do AWS SiteWise no RealityPlatform

2. Vincular a integração a um Asset Type

3. Enviar uma consulta de teste para validar a conexão com a AWS

Registrar a fonte de dados do AWS SiteWise no servidor de integração

1. Adicione a nova fonte de dados

2. Selecione o tipo AWS_IOT_SITEWISE

3. Preencha os parâmetros obrigatórios para estabelecer a conexão

Parâmetros da fonte de dados AWS IoT SiteWise

{
  "profile": "exampleProfile",
  "region": "us-west-2"
}

profile (opcional)

O perfil IAM que será usado para autenticar no AWS IoT SiteWise. Se nenhum for selecionado, o perfil padrão será usado.

region (opcional)

O nome da região da AWS à qual a integração se conectará.

Valores possíveis

A lista de regiões suportadas está disponível aqui.

Vincular propriedades de Asset Type ao AWS IOT SiteWise

Antes de vincular, certifique-se de ter:

• Um Asset Type existente com uma propriedade para armazenar os valores de parâmetro exigidos pelo AWS IOT SiteWise (por exemplo, Asset ID). Deve ser uma propriedade do tipo “Short text”.

• Um servidor de integração configurado com uma fonte de dados e consultas do AWS IOT SiteWise.

Para vincular uma propriedade de Asset Type ao AWS IOT SiteWise:

1. Em Asset Settings → Asset Types, abra o Asset Type que deseja vincular.

2. No painel Integration Links (lado direito), clique em Create Integration Link.

   

3. Insira um nome de link e selecione o servidor de integração configurado para o AWS IOT SiteWise.

4. Escolha a fonte de dados apropriada

5. Escolha a consulta desejada**:**
   -Get AWS SiteWise Asset attributes values
   Recupera os atributos do ativo.

   Parâmetros:

   • AssetId

6. Para cada parâmetro obrigatório (por exemplo, AssetId), selecione a propriedade do Asset Type que deve fornecer seu valor (por exemplo, Asset ID).

   

7. Clique em Save para criar o link.

Quando este Asset Type for atribuído a ativos, os valores das propriedades vinculadas serão automaticamente passados para o AWS SiteWise ao executar a integração.

Enviar uma consulta de teste para validar a conectividade entre o RealityPlatform e o AWS IOT SiteWise

1. Na página de configurações do Asset Type, clique no botão de reprodução ao lado do link de integração que aponta para a fonte de dados do AWS IOT SiteWise. Isso abrirá o menu de consulta de teste.

2. Insira um Asset ID na configuração de Parameters e clique em Test query para ver o resultado. O asset id pode ser obtido diretamente no AWS SiteWise.

Nota

• Os valores inseridos aqui são apenas para fins de teste. Eles não são salvos no Asset Type nem nos ativos vinculados. Este teste simula o que o RealityTwin fará quando um ativo é criado, recebe este Asset Type e a propriedade correspondente (por exemplo, Asset ID) é preenchida. Use qualquer Asset ID válido para validar a conectividade.