Configurar e testar a integração com a Aveva PI Web API

Pré-requisitos

• Servidor de integração implantado e registrado na plataforma que possa se conectar à PI Web API

• PI System com PI AF (se for recuperar ativos) com a PI Web API instalada e configurada

Tipos de consulta suportados

• Obter o último valor de um ou vários PI Points

• Obter o valor atual das propriedades de um PI AF Asset

Recursos suportados

• Suporte automático de UoM

• Filtrar propriedades de PI AF por categorias. Várias categorias podem ser especificadas em um único parâmetro, separando-as por vírgulas.

Etapas de configuração

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

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

1. Registrar a fonte de dados da Aveva PI no RealityPlatform

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

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

Registrar a fonte de dados da Aveva PI no servidor de integração

1. Adicione a nova fonte de dados

2. Selecione o tipo Aveva_PI_WEB_API

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

Parâmetros da fonte de dados Aveva PI Web API

{
  "baseUrl": "https://example.avevapiwebapi.com",
  "authenticationMethod": "Basic",
  "ignoreSslCertificateErrors": false,
  "username": "johnDoe",
  "password": "password"
}

baseUrl

A URL base da PI Web API.

username (Opcional)

Nome de usuário para autenticação básica

password (Opcional)

Senha para autenticação básica

authenticationMethod

O método de autenticação que será usado para autenticar na PI Web API.

Valores possíveis

• disable

• basic

Vincular propriedades de Asset Type à Aveva PI WEB API

Antes de vincular, certifique-se de ter:

• Um Asset Type existente com uma propriedade para armazenar os valores de parâmetro exigidos pela Aveva PI WEB API (por exemplo, PI AF Path). Deve ser uma propriedade do tipo “Short text”.

• Um servidor de integração configurado com uma fonte de dados e consultas da Aveva PI WEB API.

Para vincular uma propriedade de Asset Type à Aveva PI WEB API:

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 a Aveva PI WEB API.

4. Escolha a fonte de dados apropriada

5. Escolha a consulta desejada**:**

   -Get PI AF asset properties
   Recupera os atributos de um PI AF asset e seus valores mais recentes.

   Parâmetros:

   • PiAssetPath

   • CategoryName (Opcional)

   -Get PI Points values
   Recupera o valor mais recente de um PI Point especificado.

   Parâmetros:

   • WebID

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

   

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

Enviar uma consulta de teste para validar a conectividade entre o RealityPlatform e a Aveva PI WEB API

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 da Aveva PI WEB API. Isso abrirá o menu de consulta de teste.

2. Insira um PI AF Asset Path (ou um PI Point path, dependendo da consulta selecionada) na configuração de Parameters e clique em Test query para ver o resultado. A integração usa o formato de path padrão da PI e eles podem ser encontrados diretamente no PI System Explorer ou nas PI System Management Tools.

Nota

• CategoryName é opcional; várias categorias podem ser especificadas em um único parâmetro, separando-as por vírgulas.

• 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, PI AF Path) é preenchida. Use qualquer PI AF Path ou PI Point válido da Aveva PI para validar a conectividade.