Configurar e testar a integração com o Aveva Connect

Pré-requisitos

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

• Acesso ao Aveva Connect Data Services

Tipos de consulta suportados

• Obter o último valor de um ou vários SDS Stream

Recursos suportados

• Suporte automático de UoM

Etapas de configuração

Este guia descreve como configurar a integração com o Aveva Connect para recuperar dados em um RealityAsset.

As principais etapas para configurar a integração com o Aveva Connect são as seguintes:

1. Obter um token de autenticação de cliente do Aveva Connect

2. Registrar a fonte de dados do Aveva Connect no RealityPlatform

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

4. Enviar uma consulta de teste para validar a conexão com o Connect

Obter um token de autenticação de cliente do Aveva Connect

1. Faça login no Aveva Connect e navegue até o Aveva Data Services

2. Navegue até Security → Clients e clique no botão Add Client no canto superior direito

3. Selecione as permissões apropriadas e gere um token de cliente. A integração precisará de pelo menos acesso de leitura aos streams que serão acessados.

Registrar a fonte de dados do Aveva Connect no servidor de integração

1. Adicione a nova fonte de dados

2. Selecione o tipo AVEVA_CONNECT

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

Parâmetros da fonte de dados Aveva Connect

{
  "baseUrl": "https://example.avevaconnect.com",
  "namespaceId": "exampleNamespaceId",
  "tenantId": "exampleTenantId",
  "communityId": "exampleCommunityId",
  "clientId": "exampleClientId",
  "clientSecret": "exampleClientSecret"
}

baseUrl

A URL base do serviço Aveva Connect.

nameSpaceId

O ID de namespace do serviço Aveva Connect.

tenantId

O tenantId do serviço Aveva Connect.

CommunityId (Opcional)

O id da comunidade que hospeda os dados, se aplicável.

clientId

O Id do cliente atribuído à instalação do serviço de integração.

clientSecret

O client secret atribuído à instalação do serviço de integração.

Vincular propriedades de Asset Type ao Aveva Connect

Antes de vincular, certifique-se de ter:

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

• Um servidor de integração configurado com uma fonte de dados e consultas do Aveva Connect.

Para vincular uma propriedade de Asset Type ao Aveva Connect:

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 Aveva Connect.

4. Escolha a fonte de dados e a consulta apropriadas do Aveva Connect.

5. Para cada parâmetro obrigatório (por exemplo, StreamId), selecione a propriedade do Asset Type que deve fornecer seu valor (por exemplo, Stream Ids).

   

6. 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 Aveva Connect ao executar a integração.

Enviar uma consulta de teste para validar a conectividade entre o RealityPlatform e o Aveva Connect

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 Aveva Connect. Isso abrirá o menu de consulta de teste.

2. Insira um ou vários IDs de stream, separados por vírgulas, na configuração de Parameters e clique em Test query para ver o resultado. Os IDs de stream podem ser obtidos diretamente no Aveva Connect.

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, Stream Ids) é preenchida. Use qualquer ID de stream válido do Aveva Connect para validar a conectividade.