PI DataLink 2013 Guia do Usuário

(1)

PI DataLink 2013

Guia do Usuário

(2)

OSIsoft, LLC.

777 Davis St., Suite 250 San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Site: http://www.osisoft.com OSIsoft Australia • Perth, Austrália

OSIsoft Europe GmbH • Frankfurt, Alemanha OSIsoft Asia Pte Ltd. • Cingapura

OSIsoft Canada ULC • Montreal & Calgary, Canadá

OSIsoft, LLC Representative Office • Xangai, República Popular da China OSIsoft Japan KK • Tóquio, Japão

OSIsoft Mexico S. De R.L. De C.V. • Cidade do México, México OSIsoft do Brasil Sistemas Ltda. • São Paulo, Brasil

OSIsoft France EURL • Paris, França

PI DataLink 2013 Guia do Usuário

Nenhuma parte desta publicação pode ser reproduzida nem armazenada em um sistema do qual possa ser recuperada ou transmitida, de qualquer forma ou por qualquer meio, mecânico, por fotocópia, gravação ou qualquer outro meio, sem a autorização por escrito da OSIsoft, LLC.

A OSIsoft, a logomarca e o logotipo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são marcas comerciais da OSIsoft, LLC. Todos os outros nomes ou marcas comerciais usados neste documento são de seus respectivos proprietários.

DIREITOS DO GOVERNO DOS EUA.

O uso, a duplicação ou divulgação pelo Governo dos EUA. estão sujeitos às restrições definidas no contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC. Versão: 5.0.0

(3)

PI DataLink 2013 Guia do Usuário iii

Índice

Capítulo 1 Introdução...1

Visão geral do PI DataLink...1

Sobre esta versão ...2

Processo de configuração do PI Datalink ...4

Microsoft Excel: configuração de suplementos...7

Sobre este Documento ...9

Capítulo 2 Fundamentos...11

Interface do usuário...11

Visão Geral das funções do PI DataLink ...14

Pesquisar itens de dados...18

Gerenciar configurações de preferência...23

Gerenciar conexões com servidores...25

Construção de planilhas...26

Capítulo 3 Funções do PI DataLink ...31

Função Valor Atual...31

Função Valor de Arquivo...33

Função Dados Compactados...35

Função Dados de Amostragem ...39

Função Dados Temporizados ...42

Função Dados Calculados ...44

Função Hora Filtrada...49

Função Propriedades...51

Capítulo 4 Planilhas...53

Matrizes de função ...53

Frequência de cálculo ...56

Compartilhamento de planilhas...59

Capítulo 5 Tópicos avançados...61

Horário PI ...61

Expressões...65

Entrada manual de funções ...68

Funções para gravar dados ...73

Capítulo 6 Funções Tag ...75

(4)

iv

Pesquisar tags...78

Capítulo 7 Tendências ...79

Criar uma tendência...79

Menu de atalhos de Tendências ...82

Capítulo 8 Objetos do PI Module Database ...85

O PI Module Database e as planilhas...85

Inserir objetos do PI Module Database na sua planilha...86

Funções Module Database ...87

Capítulo 9 Notificações...89

Pesquisar e inserir notificações ...90

Notificações inseridas ...93

Configurações de exibição de notificações...94

Anexo A Referência de função...97

Funções de valores únicos ...97

Funções de valores múltiplos...100

Funções de cálculo ...110

Funções Tag ...127

Funções Module Database ...128

Funções de entrada ...131

Anexo B Solução de problemas...133

Arquivos de Log ...133

Guia PI DataLink não disponível...133

Limites de matrizes e células ...134

Limites de recuperação de dados ...134

Item de dados não suportado por função ...134

Segurança ...135

Problemas de conexão com o PI Server...135

Não é possível conectar ao PI OLEDB Enterprise Agent...137

Exceção de tempo de espera ...137

Anexo C Suporte técnico e outros recursos ...139

Índice ...141

(5)

PI DataLink 2013 Guia do Usuário 1

Bem-vindo ao PI DataLink! Essa seção fornece uma visão geral do PI DataLink, descreve características dessa versão, e discute a sua instalação e configuração.

Visão geral do PI DataLink

O PI DataLink é um suplemento do Microsoft Excel que permite recuperar informações do seu PI Server diretamente para uma planilha. Em combinação com os recursos

computacionais, gráficos e de formatação do Microsoft Excel, o PI DataLink oferece poderosas ferramentas para coletar, monitorar, analisar e relatar dados do PI System. Com o PI DataLink, você pode:

• Recuperar valores de pontos de um PI Server

• Recuperar valores de atributos de um PI Asset Framework (PI AF) Server

• Recuperar metadados do sistema para criar uma visão estruturada de dados do PI System:

ο Nomes e atributos de pontos PI

ο Caminhos, apelidos e propriedades do PI Module Database

ο Atributos e elementos do PI AF

• Referenciar esses itens usando funções do PI DataLink para calcular e filtrar dados

• Atualizar os valores recuperados quando a planilha recalcular

• Recuperar notificações que você subscreveu com PI Notifications

O PI DataLink fornece uma interface de usuário para ajudar você a criar funções e recuperar dados . O PI DataLink incorpora funções nas células da planilha e pode fornecer atualizações ativas de dados em tempo real do seu PI System.

Você pode também usar os ricos recursos de cálculo e formatação do Excel para organizar e apresentar dados do PI System de acordo com o seu propósito ou audiência.

Existem duas maneiras de trabalhar com funções PI DataLink em planilhas do Excel:

• Instale uma versão stand-alone do PI DataLink em um PC local.

• Use um navegador da Web para exibir a planilha com o PI DataLink Server (página 2), um produto separado que permite visualizar planilhas criadas com o PI DataLink. Contate seu representante de vendas OSIsoft para maiores informações.

Capítulo 1

(6)

2

PI DataLink Server (DLS)

O PI DataLink Server é uma versão de servidor do PI DataLink para uso com o Microsoft SharePoint Server 2007 ou posterior. O PI DataLink Server suporta todas as funções

DataLink PI e PI BatchView fornecidas pelos suplementos Excel em uma configuração típica do cliente PI.

Com o PI DataLink Server, você pode usar um navegador da Web para recuperar e exibir dados do PI Server contidos em uma planilha do Microsoft Excel. Você pode expandir o acesso a dados em tempo real do PI System para vários consumidores diferentes, independentemente da localização ou da familiaridade com o Microsoft Excel ou com funções PI DataLink.

Esta versão de servidor do PI DataLink usa tecnologias do Microsoft SharePoint, incluindo o Excel Services e Excel Web Access web part. Juntos, esses componentes da Microsoft oferecem suporte à maioria dos recursos padrão de planilha. O PI DataLink Server expande esses serviços, acrescentando conectividade e suporte a funções PI DataLink.

Pastas de trabalho do Excel publicadas nas bibliotecas de documentos do SharePoint podem ser acessadas de forma independente, ou adicionadas à páginas web parts. O Excel Web Access web part suporta conexões que permitem a troca de parâmetros entre uma pasta de trabalho e outras web parts, integrando planilhas com funções PI DataLink no ambiente PI WebParts.

Contate seu representante de vendas OSIsoft para informações adicionais sobre o PI DataLink Server.

Sobre esta versão

Esta versão do PI DataLink instala um suplemento para o Microsoft Excel 2007 SP3 ou posterior. Este suplemento não pode ser executado em versões anteriores do Excel. Os tópicos nessa seção descrevem os requisitos do sistema, compatibilidade de atualização com versões anteriores, e os tipos de dados suportados.

Requisitos do sistema

Para obter os requisitos atualizados do sistema, consulte o site do Suporte Técnico da OSIsoft:

(7)

Sobre esta versão

Compatibilidade de atualização

O PI DataLink é compatível com versões anteriores. Essa versão do PI DataLink pode ler pastas de trabalho criadas em versões mais antigas, sem qualquer conversão. No entanto, o inverso não é necessariamente verdadeiro. Uma vez que você modifique uma planilha na versão atual, ela pode não funcionar em versões mais antigas do PI DataLink.

O PI DataLink 2013 usa o PI AF SDK, enquanto as versões anteriores utilizam o PI SDK ou o PI API. Comportamentos diferentes podem exigir que você altere planilhas existentes:

• Mensagens de erro retornadas podem ser diferentes. Você pode precisar alterar planilhas que procuram por determinados strings (por exemplo, em código Excel VBA ou em macros).

• O PI DataLink não cria conexões para o PI SDK ou PI API. Talvez seja necessário alterar o código VBA em pastas de trabalho que dependam de uma conexão PI SDK ou PI API existente, para criar uma nova conexão explícita a PI SDK ou PI API.

• Alguns formatos de tempo, tais como 10:, não são mais suportados. Você precisa mudar todas as entradas de tempo que usam formatos não suportados.

• Conexões de usuário padrão com o PI Server não são mais suportadas. Se for solicitado, você pode digitar um nome de usuário e senha. No entanto, a OSIsoft recomenda que você configure o mapeamento PI para se conectar ao PI Server.

A versão de 64 bits do PI DataLink 2013 não permite que você crie um objeto de tendência ActiveX. A versão de 64 bits apenas irá mostrar uma imagem da última tendência em uma planilha existente, e não irá atualizar essas tendências.

Tipos de dados suportados

O PI DataLink suporta os seguintes tipos de dados de ponto do PI:

• Digital (estados definidos)

• Int (16 e 32)

• Float (16, 32 e 64)

• String (texto)

• Timestamp

O PI DataLink não suporta o tipo blob.

O PI DataLink suporta os seguintes tipos de atributos de valor PI AF:

• Byte

• Int (16, 32, e 64)

• Single

• Double

(8)

4

• Boolean*

• Enumeration*

* Não suportado pela função Dados Calculados

O PI DataLink não suporta os tipos de atributo de valor do PI AF Guid, Attribute, Element, File, ou Array.

Processo de configuração do PI Datalink

Para preparar seu computador para usar o PI DataLink, você deve instalar o PI DataLink a partir de um CD de distribuição ou de um kit de instalação baixado da OSIsoft. Se desejar, você pode usar uma instalação silenciosa. Você pode também instalar o pacote de idiomas para habilitar o suporte para outros idiomas. Além disso, você deve considerar a configuração do seu PI Server e garantir que você tenha um acesso adequado aos pontos do PI.

Istalar o PI DataLink

Inicie o programa de instalação para instalar o PI DataLink. Em sistemas operacionais de 64 bits, o programa de instalação instala automaticamente tanto a versão 32-bit quanto a 64-bit do PI DataLink. Você pode modificar o arquivo setup.ini se desejar instalar apenas uma versão. Se você tiver uma versão anterior do PI DataLink instalada em seu computador, o programa de instalação atualiza automaticamente a sua instalação e mantém as configurações de preferência das versões anteriores.

Antes de iniciar

Encontre o kit de instalação. Você pode:

• Fazer o download do kit de http://techsupport.osisoft.com.

• Inserir o CD de distribuição.

Procedimento

1. Extraia os arquivos para o seu computador.

2. Se você deseja instalar somente uma versão (32-bit ou 64-bit), modifique o arquivo setup.ini.

3. Execute o programa setup.exe.

O programa de instalação instala o PI DataLink sob o diretório raiz PIPC, tipicamente em:

C:\Program Files\PIPC\Excel

O programa instala o arquivo de ajuda on-line no diretório de idioma adequado sob o diretório ../PIPC/Help. Você pode baixar a versão em PDF e notas de lançamento de http://techsupport.osisoft.com.

(9)

Processo de configuração do PI Datalink

Depois de terminar

• Instale o PI DataLink MUI Language Pack se você quiser ver o PI DataLink em um idioma diferente do Inglês. Veja Ver PI DataLink em um idioma suportado (página 5).

• Ative manualmente o suplemento DataLink PI (Legacy) se você precisa usar as funções de tags, funções do Module Database ou tendências. Veja Microsoft Excel: configuração de suplementos (página 6).

Instalação silenciosa

Você pode instalar PI DataLink com o recurso de instalação silenciosa do Windows. Às vezes chamada de instalação automática, a instalação silenciosa não requer feedback durante o processo de configuração. Administradores de sistemas com um aplicativo automatizado de distribuição de software pode usar a instalação silenciosa para implantar software

automaticamente para um grande número de desktops corporativos. Para iniciar uma instalação silenciosa, digite:

Setup.exe –f silent.ini

O arquivo silent.ini está incluído no kit de configuração. É possível fazer alterações específicas do site no arquivo conforme necessário. Consulte o arquivo setup.ini do PI SDK para obter informações adicionais e descrições dos argumentos disponíveis.

Ver PI DataLink em um idioma suportado

PI DataLink suporta vários idiomas. Instale o pacote de idiomas PI DataLink MUI (Multilingual User Interface) para ver a interface de usuário do PI DataLink no mesmo idioma do Microsoft Excel. Se o PI DataLink não suporta um idioma, a interface de usuário do PI DataLink aparecerá em Inglês.

Procedimento

1. Defina o idioma desejado no Microsoft Excel: a. Instale o pacote de idiomas do Microsoft Office.

a. Use a ferramenta de configuração de idioma do Microsoft Office para alterar o idioma do Microsoft Excel.

2. Faça o download do pacote de idiomas PI DataLink MUI de http://techsupport.osisoft.com.

(10)

6

Preferências de conexão para PI Server coletivos

Se o PI DataLink se conecta a um PI Server coletivo, o PI DataLink define uma preferência de conexão na primeira conexão com o coletivo. A preferência depende do componente que inicia a conexão:

• As funções PI DataLink definem a preferência para Qualquer.

• Pesquisar define a preferência para Qualquer.

• O Connection Manager (acessado a partir da janela Configurações) define a preferência para Qualquer.

• Objetos de controle legados do Trend definem a preferência para Preferir Primário.

• Tag Search (acessado a partir das funções de tag legadas) define a preferência para Preferir Primário.

• O PI Connection Manager (acessado a partir de Tag Search legado) define a preferência para Preferir Primário.

Veja o High Availability Administrator Guide para maiores informações sobre conexões de cliente para o PI Server.

Configuração do PI Server

O PI DataLink pode recuperar dados de um PI Server 3.4.375.91 e posterior. No entanto, o PI DataLink deve se conectar ao PI Server e ter acesso adequado aos pontos. Isso pode exigir alterações de configuração para:

• Banco de dados do firewall. O banco de dados do firewall em cada computador executando o PI Server deve ser configurado para permitir o acesso a partir de computadores cliente que executam o PI DataLink.

• Autenticação e autorização. Aqueles que utilizam o PI DataLink devem ser capazes de autenticar a sua identidade com o PI Server e ter acesso ao PI Server. A OSIsoft recomenda que você use mapeamentos PI (disponível no PI Server versão 3.4.380 e posteriores). Você também pode usar PI trusts ou autenticação de senha PI. A OSIsoft não recomenda autenticação de senha PI, porque esse método é menos seguro.

• Definições de ponto. Os pontos devem ser definidos para dar aos usuários autorizados acesso de leitura e, se necessário, de escrita.

Para informações adicionais, consulte a documentação do PI Server, incluindo o guia Configurando a Segurança do PI Server. Você pode baixar a documentação do Site de Suporte Técnico da OSIsoft (http://techsupport.osisoft.com/downloadcenter.aspx).

(11)

Microsoft Excel: configuração de suplementos

PI DataLink tem três suplementos de aplicativo para o Microsoft Excel.

Nome Localização Tipo

PI DataLink ..\PIPC\Excel\OSIsoft.PIDataLink.UI.vsto COM Add-in

PI DataLink (Legacy) ..\PIPC\Excel\OSIsoft.PIDataLink.UI(Legacy).vsto COM Add-in PI DataLink Notifications ..\PIPC\Excel\OSIsoft.PIDataLink.Notifications2007.UI.vsto COM Add-in

Para usar todos os recursos do PI DataLink, esses suplementos de aplicação devem estar ativos. O programa de instalação instala todos os suplementos e ativa o suplemento DataLink PI. Se PI Notifications está instalado em sua máquina, o programa de instalação também ativa o suplemento PI DataLink Notifications. Se não, você deve ativar esse suplemento depois de instalar o PI Notifications. O programa de instalação não ativa o suplemento PI DataLink (Legacy). Você deve ativar o suplemento se você quiser usar as funções de tags, objetos Module Database, ou tendências.

Em casos raros, o Microsoft Excel pode desabilitar um suplemento. Você deve habilitar um suplemento para poder ativá-lo.

Observação: Para ativar um suplemento de aplicativo você deve ter privilégios de

administrador no computador. Se você não for um administrador, clique com botão direito em Excel.exe no Windows Explorer e, então, clique em Run as

administrator para executar o Microsoft Excel como um administrador.

Veja também...

• Funções Tag (página 75)

• Objetos Module Database (página 85) • Tendências (página 79)

(12)

8

Ver status dos suplementos

Verifique o status de um suplemento para saber se ele está ativo, inativo ou desabilitado.

Procedimento

1. Clique na guia Arquivo e então clique em Opções. (No Microsoft Excel 2007, clique no Botão do Microsoft Office e, em seguida, clique em Opções do Excel.)

2. Na janela Opções do Excel, clique em Suplementos.

3. Pesquise a lista de suplementos para ver o status atual de um suplemento. Cada suplemento será listado sob:

ο Suplementos de Aplicativo Ativos ο Suplementos de Aplicativo Inativos ο Suplementos de Aplicativo Desabilitados.

Habilitar um suplemento desabilitado

Se um suplemento estiver desabilitado, você deve habilitar o suplemento antes de poder ativá-lo.

Procedimento

2. Na janela Opções do Excel, clique em Suplementos.

3. Na lista Gerenciar, selecione Itens desabilitados, e então clique em Ir. 4. Marque a caixa de seleção próxima ao suplemento.

5. Clique em Habilitar.

Ativar um suplemento inativo

Ative um suplemento inativo para torná-lo disponível no Microsoft Excel.

Observação: Para ativar um suplemento de aplicativo você deve ter privilégios de

administrador no computador. Se você não for um administrador, clique com botão direito em Excel.exe no Windows Explorer e, então, clique em Run as

administrator para executar o Microsoft Excel como um administrador.

Procedimento

(13)

Sobre este Documento

3. Na lista Gerenciar, selecione Suplementos COM e, então, clique em Ir. 4. Marque a caixa de seleção próxima ao suplemento.

5. Clique em OK.

Sobre este Documento

O Guia do Usuário do PI DataLink fornece uma descrição detalhada das características do produto e uma referência completa para as funções do PI DataLink. O conteúdo das versões PDF e Help do guia é idêntico.

Este documento presume que você tenha conhecimento sobre os conceitos do PI System. Consulte a documentação do PI Server e do PI AF para obter informações adicionais sobre esses produtos. Conhecimento do PI Server e do PI AF irá ajudá-lo a entender os termos usados no PI DataLink.

Você também poderá achar útil os materiais de treinamento. Eles incluem os exercícios que a OSIsoft usa em cursos de treinamento no PI DataLink.

Você pode baixar o material de treinamento e a documentação para outros produtos da OSIsoft do Site de Suporte Técnico da OSIsoft

(14)

(15)

Quando você usa o PI DataLink, você define funções de PI DataLink que extraem dados do PI System em matrizes de função em uma planilha do Excel. Uma matriz de função é um conjunto de células que contém a saída de uma única função do PI DataLink. As seções seguintes apresentam características e conceitos básicos do PI DataLink. Familiarize-se com estas seções antes de usar o PI DataLink para construir uma planilha e recuperar dados do PI System.

Essas seções descrevem:

• Recursos de interface do usuário

• Principais recursos para trabalhar com o PI DataLink

• Diferentes abordagens para construir uma planilha de PI DataLink, dependendo de seus objetivos, necessidades e recursos

Interface do usuário

PI DataLink adiciona comandos de menu específicos, janelas e painéis de tarefas ao Microsoft Excel.

As seções seguintes descrevem os elementos principais da interface do PI DataLink.

Guia PI DataLink

O PI DataLink insere a guia PI DataLink na faixa de opções do Microsoft Excel.

• Clique na guia PI DataLink para acessar os comandos do PI DataLink.

• Clique em um comando para abrir o painel de tarefas ou janela correspondente.

• Coloque o cursor sobre um comando para exibir uma dica descritiva da ferramenta.

Capítulo 2

(16)

12

Utilize os painéis de tarefas de função para definir funções do PI DataLink.

Um painel de tarefas é um painel de controles que você pode mover e encaixar. Você pode continuar a trabalhar em uma planilha enquanto um painel de tarefas estiver aberto. Para abrir um painel de tarefas de função:

• Clique na célula de saída desejada e clique em um comando de função na guia PI DataLink para adicionar uma função.

• Clique em uma célula em uma matriz de função existente para abrir o painel de tarefas correspondente e editar as entradas da função.

Observação: Você pode desligar a exibição automática (página 23) dos painéis de

tarefas se você preferir.

• Clique com o botão direito do mouse em uma célula de matriz de função e, em seguida, clique no nome da função para abrir manualmente o painel de tarefas.

Em um painel de tarefas de função aberto:

• Insira ou altere os valores de entrada e então:

ο Clique em OK para salvar os valores de entrada, escrever a matriz de função resultante e fechar o painel de tarefas.

ο Clique em Aplicar para salvar os valores de entrada e escrever a matriz de função resultante sem fechar o painel de tarefas.

• Clique no botão X na barra de título do painel de tarefas para fechar o painel de tarefas sem salvar as alterações.

(17)

Interface do usuário

• Clique no botão de seta para selecionar os comandos Mover, Tamanho, ou Fechar.

• Arraste a barra de título para desencaixar o painel de tarefas.

• Clique duas vezes na barra de título para encaixar o painel de tarefas.

• Coloque o cursor na borda e arraste para redimensionar o painel.

Menu de atalhos

O PI DataLink adiciona vários comandos ao menu de atalhos padrão do Microsoft Excel. Você pode usar esses comandos para gerenciar matrizes de função em uma planilha.

Para abrir o menu de atalhos com os comandos do PI DataLink, clique com o botão direito do mouse em qualquer lugar em uma matriz de funções do PI DataLink.

PI DataLink adiciona os seguintes comandos ao menu de atalhos:

• Selecionar Função DataLink Seleciona a matriz de funções inteira.

Antes de copiar, cortar ou colar uma matriz para um novo local na planilha, você deve selecionar a matriz inteira.

• Recalcular (Redimensionar) Função

Reescreve a matriz de funções inteira. O PI DataLink recupera novos valores do PI Server ou PI AF Server e automaticamente redimensiona a matriz para conter os dados retornados.

• Nome da Função

Abre o painel de tarefas de função correspondente e mostra as entradas para a matriz de função.

Tendências apresenta um menu de atalho alternativo.

Veja também...

• Menu de atalhos de Tendências (página 82) • Painéis de tarefas de função (página 12)

(18)

14

Visão Geral das funções do PI DataLink

As funções do PI DataLink extraem dados do PI System para o Excel. Você pode usar um painel de tarefas de função para inserir facilmente as entradas que definem a função. Como alternativa, na medida em que você se torna mais experiente, você pode digitar uma função diretamente na barra de fórmulas do Excel.

As seções seguintes descrevem:

• Características comuns aos painéis de tarefas de função do PI DataLink

• Como os dados em tempo real são adquiridos e apresentados

• Como as funções do PI DataLink podem ser usadas dentro de uma planilha

Veja também...

• Painéis de tarefas de função (página 12) • Entrada manual de funções (página 68)

Item de dados

As funções PI DataLink retornam dados a respeito de itens de dados específicos do PI System, sejam eles pontos do PI ou atributos PI AF. As funções podem retornar valores registrados em um banco de dados ou valores calculados com base em critérios ou expressões especificadas.

Quando você define uma função, você especifica os caminhos para os itens de dados através dos campos Item de dados, Expressão, e Expressão de filtro juntamente com o campo opcional Caminho raiz. Você pode especificar:

• Caminhos totalmente qualificados nos campos Item de dados, Expressão, ou Expressão de filtro. Um caminho totalmente qualificado começa com duas barras invertidas (\\) e representa um ponto do PI ou um atributo do PI AF.

• Caminhos parciais nos campos Item de dados, Expressão, ou Expressão de filtro e o caminho-base comum no campo Caminho raiz. Nomes de ponto do PI ou atributos PI AF são exemplos de caminhos parciais. O PI DataLink combina o caminho-base comum com o caminho parcial para definir o caminho completo que representa um ponto do PI ou atributo do PI AF.

O PI DataLink requer um caminho completo para localizar o item de dados. Para localizar um ponto do PI, o PI DataLink deve conhecer o PI Server a ser pesquisado e o nome do ponto. Para localizar um atributo do PI AF, o PI DataLink deve conhecer o PI AF Server, o banco de dados, o elemento, e quaisquer subelementos ou atributos-pai. Use um pipe (|) para separar os atributos dos elementos ou atributos-pai.

Você pode deixar o campo Caminho raiz em branco se os campos Item de dados, Expressão, e Expressão de filtro contiverem um caminho totalmente qualificado ou um ponto do PI no PI Server padrão.

(19)

Visão Geral das funções do PI DataLink

Se especificado, o campo Caminho raiz indica o caminho comum para os itens de dados especificados.

Tipo de item de dados Conteúdo do campo caminho raiz

Ponto do PI O PI Server que armazena o ponto ou um espaço em branco para indicar o PI Server padrão. As entradas válidas incluem:

PIServer \\PIServer

Atributo do PI AF O PI AF Server e o banco de dados, juntamente com quaisquer elementos, subelementos e atributos-pai não especificados em Item de dados. As entradas válidas incluem:

\\PIAFserver\database \\PIAFserver\database\element

\\PIAFserver\database\element\subelement \\PIAFserver\database\element|ParentAttribute

\\PIAFserver\database\element|ParentAttribute1|ParentAttribute2 Observação: O PI AF Server e o banco de dados devem estar no mesmo campo. Você não pode especificar o PI AF Server no campo Caminho raiz e o banco de dados no campo Item de dados.

Veja também...

Expressões (página 65)

Entrada de dados

Entradas rotuladas nos painéis de tarefas da função aceitam valores apropriados para a função. Para várias entradas, você pode inserir um valor ou uma referência a uma célula da planilha que contém o valor. Algumas entradas têm um valor padrão mostrado quando o painel de tarefas é aberto. Entradas marcadas (opcional) são opcionais e não exigem um valor.

Para entradas com campos de edição , você pode:

• Digitar o texto diretamente no campo de edição, como um nome de atributo do PI AF ou o endereço de uma célula de saída.

• Clicar no campo de edição e, em seguida, clicar em uma célula ou intervalo de células da planilha que contenha os valores apropriados, tais como nomes de atributo do PI AF, horários (time stamps), ou localizações de células de saída.

• Clicar para abrir a ferramenta Pesquisar (Search) e, então, selecionar os itens de dados encontrados em uma pesquisa a um PI Server ou PI AF Server conectado.

(20)

16

Para entradas com listas , você pode:

• Selecionar uma opção na lista, como um método de cálculo ou de amostragem.

• Clicar e então clicar em uma célula ou intervalo que contém os valores apropriados, como um modo, unidade de tempo, tipo de limite, ou propriedade.

Observação: Nos campos de edição, digite strings sem quaisquer aspas. No entanto,

em células da planilha, digite strings com uma aspa simples (') para forçar o Excel a interpretar o conteúdo como um string.

Por exemplo, para especificar um ponto do PI no campo Item(ns) de dado(s) você pode:

• Digitar o string para o nome do ponto.

• Clicar para abrir a ferramenta Pesquisar, e pesquisar por um ponto no PI Server.

• Entrar uma referência a uma célula de planilha que contenha o nome do ponto: a. Clique no campo Item(ns) de dado(s).

b. Clique na célula na planilha.

O PI DataLink entra automaticamente a referência de célula no campo de edição.

Entradas de tempo

Muitas funções do PI DataLink requerem entradas de Hora Inicial e Hora Final para recuperar uma matriz de valores de eventos ao longo de um período de tempo específico. Outras funções do PI DataLink requerem uma entrada de Horário para recuperar valores em um horário específico. Siga essas orientações ao especificar as entradas de tempo:

• Insira um tempo determinado, tal como 10-Dez-99 19:12, ou uma expressão de tempo do PI que especifica um tempo relativo, como -3h. Por exemplo, você pode inserir um tempo fixo para definir um período de tempo no passado, ou você pode digitar uma expressão de tempo relativo para definir um período de tempo que inclui o tempo atual.

• Se a hora inicial é mais recente que a hora final, o PI DataLink exibe os resultados em ordem cronológica inversa.

• Preceda expressões de tempo entradas em células de planilha com uma aspas simples para indicar uma string (por exemplo, '10-Dez-99 19:12 ou '-3h).

• Referências de célula também podem usar o formato de tempo absoluto do Excel (como 39299,6146, equivalente a 05/08/2007 14:45:00). O Excel armazena data e hora nesse formato, que representa o número cumulativo de dias desde 1900. Excel pode exibir o mesmo horário usando qualquer formato de data e hora atribuído à célula.

(21)

Visão Geral das funções do PI DataLink

• Algumas entradas de tempo, tais como 9:45, podem representar um horário válido ou um intervalo válido de linhas da planilha. Em um campo do painel de tarefas, preceda essas entradas com uma aspa simples, como '9:45, para forçar o PI DataLink a interpretá-las como hora.

Algumas funções do PI DataLink requerem uma entrada de Intervalo de tempo, que você especifica com um único valor:

• Insira um valor e uma unidade de tempo, como 1d ou 30m; nunca inclua um tempo de referência. Por exemplo, para especificar um intervalo de 32 minutos, digite 32m ou referencie uma célula que contenha esse string.

• Para inserir intervalos em termos de freqüência, converta a freqüência em segundos equivalentes. Por exemplo, insira uma freqüência de 25 Hz como um intervalo de 0,04s (= 1/25 de segundo).

Observação: O PI DataLink suporta apenas o sistema de data 1900 padrão suportado

pelo Excel. O PI DataLink não suporta o sistema de data 1904 do Excel e retorna data e hora incorretos se este sistema for usado.

Veja também...

• Especificação de horário (página 62)

• Especificação de intervalo de tempo (página 64)

Dados anexados

PI DataLink pode anexar informações sobre os valores recuperados. Esses dados anexados podem fornecer o contexto para valores recuperados. Dados anexados podem incluir:

• Horário de eventos

• Horários que mostram a hora inicial e final de um intervalo

• Horários que mostram quando os valores mínimo e máximo ocorreram

• A percentagem de valores bons ao longo de um intervalo de amostragem

• Atributos de valor

• Anotações introduzidas manualmente nos eventos

• Nomes do servidor de origem

O PI DataLink exibe os dados anexados especificados nas colunas (ou linhas) adjacentes aos valores primários que a função retorna:

• Os dados de tempo são apresentados nas colunas à esquerda (ou linhas acima) dos valores primários.

• Outros dados relacionados são exibidos em colunas à direita (ou linhas abaixo) dos valores primários.

(22)

18

Use a janela Configurações (página 23) para especificar os formatos de número e de tempo que o PI DataLink usa para formatar dados em matrizes de função. Existem duas

configurações:

• Formato de número

O formato para números na saída da função. A configuração padrão, Geral, formata números (e todos os dados que não são horários) para corresponder à formatação da categoria Geral na janela Formatar Células do Excel.

• Formato de Data e Hora

O formato para horários na saída da função. A configuração padrão, dd-mmm-yy hh:mm:ss, corresponde ao formato padrão do PI para data e hora. Você pode

acrescentar :000 ao final da string (dd-mmm-yy hh:mm:ss:000) para mostrar os subsegundos no horário. Observe que o Excel não suporta formatos de precisão de microssegundo.

Você pode personalizar essas strings de formato utilizando os códigos de formato válidos do Excel através da janela Formatar Células no Excel.

Você também pode aplicar uma formatação individual de tempo e de data a qualquer célula da planilha, incluindo aquelas contendo funções do PI DataLink, com a janela Formatar Células. Consulte a documentação do Excel para obter informações adinionais sobre formatação de datas e horas.

Pesquisar itens de dados

Use a ferramenta Pesquisar para pesquisar itens de dados em qualquer PI Server ou PI AF Server especificado. Você pode inserir itens de dados em sua planilha e depois referenciar esses itens de dados em funções PI DataLink. Você também pode inserir um item de dados diretamente em um painel de tarefas de função.

Antes de iniciar

Conecte a qualquer PI Server ou PI AF Server que você deseje pesquisar. Veja Gerenciar conexões com servidores (página 25).

Procedimento

1. Abra a ferramenta Pesquisar:

ο Para inserir um ou mais itens em uma planilha, selecione a célula superior esquerda do intervalo na planilha onde você deseja inserir os itens de dados e, em seguida, na guia PI DataLink , no grupo Pesquisar , clique em Pesquisar.

ο Para inserir um ou mais itens em um painel de tarefas da função, clique no botão ao lado do campo Item(ns) de dado(s).

(23)

Pesquisar itens de dados

2. Defina o escopo da pesquisa, mostrado no caminho no alto.

Inicialmente, a ferramenta define o escopo da pesquisa para Home, o que significa todos os PI Servers (indicados por ) e PI AF Servers (indicados por ) listados no

Gerenciador de Conexão. Você pode limitar a pesquisa a um único PI Server ou PI AF Server, e mais ainda para um único banco de dados em um servidor AF PI, e depois para elementos e atributos-pai específicos. Você pode:

ο Usar o painel de navegação para limitar a pesquisa (página 21) ο Usar o caminho de escopo para limitar a pesquisa (página 22)

Se você definir o escopo da pesquisa para um elemento ou atributo, o painel de resultados lista os atributos-filho imediatamente abaixo desse elemento ou atributo.

3. Conforme necessário, procure itens de dados no escopo para listar no painel de resultados.

a. No campo na parte superior da ferramenta, digite o texto que identifica os itens de dados que você deseja encontrar no escopo selecionado.

A ferramenta adiciona caracteres curinga implícitos depois do texto que você digita. Por exemplo:

− Digite sin para encontrar todos os itens de dados que começam com "sin",

como sinusoid ou sinusoidu.

− Digite * para encontrar todos os itens de dados

b. Se o escopo da pesquisa é um PI Server, defina os campos abaixo de Filtros para especificar quaisquer critérios adicionais aos quais os pontos do PI recuperados devem corresponder:

− Fonte de ponto

O string que associa um ponto do PI com uma interface; corresponde ao atributo de ponto PointSource.

− Tipo de ponto

O tipo de valor armazenado pelo ponto do PI; corresponde ao atributo de ponto PointType.

− Unidades de engenharia

O string que descreve as unidades de medida; corresponde ao atributo de ponto EngUnits.

− Descritor estendido

Uma string que fornece informações adicionais sobre o ponto do PI; corresponde ao atributo de ponto ExDesc.

− Tag de instrumento

Para algumas interfaces, o string que contém o tag no sistema externo; corresponde ao atributo de ponto InstrumentTag.

(24)

20

c. Clique em Pesquisar para iniciar a busca.

A ferramenta procura dentro do escopo especificado por itens de dados que

correspondam ao texto digitado e retorna os itens de dados encontrados no painel de resultados. A ferramenta pesquisa toda a hierarquia abaixo do escopo da pesquisa. (Em contraste, quando você navega na hierarquia, o painel de resultados mostra apenas os atributos-filho imediatos ao escopo da pesquisa.) A ferramenta encontra:

− Pontos do PI com nomes ou descritores correspondentes. − Atributos PI AF com nomes ou descrições correspondentes. − Atributos PI AF que têm elementos-pai com nomes ou descrições

correspondentes.

Observação: Pesquisas do PI Server não retornam mais que 100.000 pontos do PI.

Para ter certeza de que você vê todos os resultados, restrinja sua pesquisa para retornar menos pontos do PI.

4. Se desejar, altere as colunas exibidas no painel de resultados:

ο Clique com o botão direito do mouse no painel de resultados e clique em um nome de coluna para adicioná-la ou retirá-la das colunas exibidas.

ο Arraste os cabeçalhos de coluna para alterar a ordem de exibição das colunas. 5. Se desejar, mova o controle deslizante Comprimento do caminho raiz para dividir o

caminho do item de dados entre as colunas Caminho raiz e Item de dados:

ο Selecione Mínimo para especificar um caminho completo na coluna Item de dados.

ο Selecione Máximo para especificar apenas o nome do atributo ou ponto na coluna Item de dados, com o resto do caminho na coluna Caminho raiz.

ο Selecione posições intermediárias para dividir de outras formas o conteúdo entre as colunas.

O conteúdo dessas colunas determina o conteúdo adicionado aos campos do painel de tarefas ou às colunas da planilha.

6. Se estiver inserindo itens de dados em uma planilha, especifique como inserir o conteúdo do Caminho raiz:

ο Selecione Coluna ou linha para inserir o conteúdo das colunas Caminho raiz e Item de dados nas células da planilha designadas. Se ambas as colunas contiverem dados, PI DataLink sempre insere o conteúdo de Caminho raiz na primeira coluna da planilha e o conteúdo de Item de dados na segunda coluna da planilha. Se apenas a coluna Item de Dados contiver conteúdo (isto é, um caminho completo), então o PI DataLink irá inserir somente essa coluna na planilha.

ο Selecione Lista suspensa para inserir uma lista suspensa de caminhos (da coluna Caminho raiz), seguido pelos elementos de dados (da coluna Item de dados) nas células da planilha designadas.

Se você referenciar a lista suspensa e os itens de dados inseridos em uma função DataLink PI, a planilha irá atualizar dinamicamente os valores recuperados quando você selecionar um caminho diferente na lista.

(25)

Pesquisar itens de dados

Observação: O PI DataLink insere a lista de caminhos raiz na coluna EZ da planilha. Se essa coluna contém dados, o PI DataLink insere os caminhos na próxima coluna disponível à direita.

7. Selecione os itens que deseja inserir e clique em OK.

Veja também...

Criar uma exibição relacionada a ativos (página 27)

Usar o painel de navegação para limitar a pesquisa

O painel de navegação está no lado esquerdo da ferramenta Pesquisar. O painel de navegação mostra o que o escopo da pesquisa atual inclui (a parte superior da janela mostra o caminho de escopo correspondente). Para escopos em um AF PI Server, o painel de navegação mostra apenas os bancos de dados, elementos ou atributos que contêm atributos na hierarquia abaixo deles. Portanto, o painel de navegação nunca irá listar elementos ou atributos sem atributos-filho.

Você pode usar o painel de navegação para limitar o escopo de uma pesquisa (e definir o caminho de escopo). Por exemplo, você pode limitar a busca a um determinado AF PI Server ou a um determinado banco de dados no servidor, ou a um determinado elemento dentro desse banco de dados. Enquanto você navega por uma hierarquia de PI AF Server no painel de navegação, o painel de resultados se atualiza para mostrar os atributos diretamente abaixo no caminho de escopo selecionado.

Procedimento

No painel de navegação:

• Clique em um servidor para limitar a pesquisa a esse servidor.

A ferramenta atualiza o caminho de escopo no topo da janela para listar o servidor selecionado e atualiza o painel de navegação. Se você clicou em um PI AF Server

(indicado por ), o painel de navegação mostra todos os bancos de dados nesse servidor. Se você clicou em um PI Server (indicado por ), o painel de navegação mostra uma lista de campos de filtro que você pode usar para limitar os pontos do PI a serem recuperados.

• Clique em um banco de dados (indicado por ) para limitar a pesquisa a esse banco de dados.

A ferramenta atualiza o painel de navegação para mostrar todos os elementos de alto nível no banco de dados selecionado, e atualiza o caminho de escopo no topo da janela para listar o banco de dados selecionado.

(26)

22

A ferramenta atualiza o painel de navegação para mostrar todos os elementos-pai e atributos-pai sob o elemento selecionado, atualiza o caminho de escopo no topo da janela para listar o elemento selecionado, e lista os atributos sob o elemento selecionado no painel de resultados.

Note que o painel de navegação só mostra os atributos que são atributos-pai, enquanto o painel de resultados mostra tanto atributos-pai como não-pai sob o elemento selecionado.

• Clique em um atributo (indicado por ) para limitar a pesquisa a esse atributo. A ferramenta atualiza o painel de navegação para mostrar todos os atributos-pai sob o atributo selecionado, atualiza o caminho de escopo no topo da janela para listar o atributo selecionado, e lista todos os atributos sob o atributo selecionado no painel de resultados.

Usar o caminho de escopo para limitar a pesquisa

O caminho de escopo está na parte superior da ferramenta Pesquisar.

O caminho de escopo mostra onde a ferramenta Pesquisar procura por itens de dados. Você pode utilizar o caminho do escopo para limitar o âmbito de uma pesquisa. Por exemplo, você pode limitar a busca a um determinado AF PI Server ou a um determinado banco de dados no servidor, ou a um determinado elemento dentro desse banco de dados. Enquanto você navega por uma hierarquia de PI AF Server no caminho de escopo, o painel de resultados se atualiza para mostrar os atributos diretamente abaixo no caminho de escopo selecionado.

Procedimento

No caminho de escopo:

• Clique em Home para redefinir o escopo para todos os PI Servers e PI AF Servers listados no Gerenciador de Conexão.

• Clique na seta ao lado de Home e, em seguida, clique em um servidor específico para redefinir o escopo para esse servidor.

• Clique no servidor para redefinir o escopo para todo o servidor.

• Clique na seta ao lado de um AF PI Server, e clique em um banco de dados específico para redefinir o escopo para esse banco de dados.

• Clique no banco de dados para redefinir o escopo para o banco de dados inteiro.

• Clique na seta ao lado do banco de dados, e clique em um determinado elemento para redefinir o escopo para esse elemento.

(27)

Gerenciar configurações de preferência

• Clique na seta ao lado de um elemento, e clique em um subelemento ou atributo para redefinir o escopo para que subelemento ou atributo.

• Clique em um atributo-pai para redefinir o escopo para todos os seus subatributos.

• Clique na seta ao lado de um atributo-pai e selecione um subatributo específico para redefinir o escopo para esse subatributo.

Gerenciar configurações de preferência

Use a janela Configurações para especificar preferências globais e formatação padrão para a saída de funções do PI DataLink. Essas configurações se aplicam a um determinado usuário em um determinado computador.

Procedimento

1. Na guia PI DataLink no grupo Recursos , clique em Configurações. 2. Defina a configuração preferida e clique em OK.

Configuração Descrição

Em uma linha Selecione para colar múltiplos resultados de uma pesquisa em uma linha de valores na planilha. Em uma coluna Selecione para colar múltiplos resultados de uma

pesquisa em uma coluna de valores na planilha. Valor padrão.

Copiar nome do PI Server (Somente

suplementos legados) Selecione para colar o nome da fonte de dados PI Server em uma célula da planilha adjacente ao inserir nomes de pontos do PI de funções tag em uma planilha.

Utilizar o fuso horário do PI Server Selecione para que o PI DataLink interprete as datas e horas de entrada e saída como sendo no fuso horário do PI Server, para itens de dados ou expressões que contêm um ponto do PI ou um atributo PI AF que seja uma referência de dados de um ponto do PI.

Se não for selecionado, ou o item de dados ou expressão contém um atributo PI AF que não é uma referência de dados de um ponto do PI, o PI DataLink interpreta entrada e saída de horários como sendo no fuso horário da estação de trabalho cliente.

Esta opção só é relevante se um PI Server tem uma configuração de fuso horário diferente da estação de trabalho cliente.

Mostrar #N/A em vez de espaços em branco

Selecione para mostrar #N/A (não aplicável) em vez de espaços em branco em células sem valores, quando um novo cálculo retorna menos valores do que uma matriz de função pode mostrar.

Este recurso é particularmente útil se você usar o pacote de gráficos do Excel para gerar gráficos dos resultados de função.

(28)

24

Independente de local Selecione para que PI DataLink interprete strings de entrada de tempo de acordo com as regras de formato de tempo do PI, independente das configurações de local da estação de trabalho cliente. O formato de tempo do PI assume que todas as strings estão em Inglês e usa o formato de data e hora dd-mmm-yyyy hh:mm:ss. Desmarque a caixa de seleção para aplicar o formato de data e hora de acordo com as configurações regionais na estação de trabalho cliente, aplicando as regras de formato de tempo do PI somente se necessário. Desativar exibição automática do

painel de tarefas ao clicar

Selecione para desativar a abertura automática do painel de tarefas quando clicar em uma célula de função. Desativar a mensagem

"Redimensionar para mostrar todos os valores"

Selecione para não exibir uma mensagem de aviso quando um novo cálculo retorna mais valores do que uma matriz de função pode mostrar.

Formato de número Entre o formato para números em funções de saída. A string de formato de data e hora pode ser qualquer código de formato de data e hora válido da janela Formatar do Excel (consulte "Formatos de exibição" na página 18).

Durante a instalação, o PI DataLink entra o formato de número padrão do Excel neste campo, a menos que você tenha definido anteriormente uma preferência de formato diferente no PI DataLink neste computador. Se sua versão do Excel é executada numa localidade diferente, este formato inclui a sintaxe correta para refletir a localidade. Por exemplo:

35.03

apareceria como 35,03

no Excel em francês.

Formato de Data e Hora Entre o formato para horários de saída em funções. A string de formato de data e hora pode ser qualquer código de formato de data e hora válido da janela Formatar do Excel.

Durante a instalação, o PI DataLink entra o formato de data e hora padrão do Excel neste campo, a menos que você tenha definido anteriormente uma preferência de formato diferente no PI DataLink neste computador. Se sua versão do Excel é executada numa localidade diferente, este formato inclui a sintaxe correta para refletir a localidade. Por exemplo:

dd-mmm-aa hh:mm:ss apareceria como jj-mmm-aa hh:mm:ss no Excel em francês.

Cálculo (F9) Selecione para recalcular todas as funções voláteis (e todas as funções que fazem referência a elas) durante cada recálculo iniciado pelo recurso de Atualização Automática. A função Valor Atual é a única função volátil do PI DataLink.

(29)

Gerenciar conexões com servidores

Configuração Descrição

Cálculo Completo (Ctrl+Alt+Shift+F9) Selecione para recalcular todas as funções, independentemente da volatilidade, durante cada recálculo iniciado pelo recurso de Atualização Automática.

Intervalo (segundos) Digite o número de segundos entre cada recálculo iniciado pelo recurso de Atualização Automática. O valor mínimo é cinco segundos. Digite 0 para que o PI DataLink calcule um intervalo automático com base na duração dos tempos de cálculo anteriores.

Gerenciar conexões com servidores

Use o Gerenciador de Conexões para gerenciar as conexões com qualquer PI Server ou PI AF Server, incluindo a escolha do PI Server e PI AF Server padrão.

Procedimento

1. Na guia PI DataLink, no grupo Recursos, clique em Configuraçõess para abrir a janela Configurações.

2. Clique em Gerenciador de Conexões para abrir a janela Servidores, que mostra as conexões de servidor definidas e o status atual das conexões, incluindo os servidores padrão.

3. Altere as conexões, conforme desejado:

ο Clique em Adicionar AF Server para abrir a janela Propriedades do AF Server, onde você pode definir uma conexão com um AF PI Server.

ο Clique em Adicionar PI Server para abrir a janela Propriedades do PI Server, onde você pode definir uma conexão com um PI Server.

ο Selecione um servidor não está atualmente conectado, e clique em Conectar para se conectar com esse servidor.

Para se conectar com um PI AF Server, o PI DataLink usa as credenciais do

Windows do usuário autenticado. Para se conectar com um PI Server, o PI DataLink pode usar um PI trust ou um usuário padrão em complemento às credenciais do Windows do usuário autenticado.

ο Selecione um servidor não seja a conexão padrão atual e clique em Definir como padrão para fazer desse servidor a conexão padrão (PI Server ou PI AF Server). ο Selecione um servidor e clique em Propriedades para exibir as propriedades de

conexão com esse servidor.

ο Clique em um servidor com o botão direito do mouse e escolha Remover para remover a definição de conexão com esse servidor.

(30)

26

Construção de planilhas

Uma vez que você está familiarizado com as ferramentas básicas e os conceitos do PI DataLink, você está pronto para construir uma planilha que usa funções PI DataLink.

Considere seus objetivos

Pergunte a si mesmo:

• Que dados você deseja exibir em uma planilha a fim de monitorar o desempenho ou responder a uma questão de negócio?

• Onde estão os dados?

• Como você pode exibir as informações de forma mais efetiva, tanto para comunicar pontos essenciais como para fornecer o contexto necessário?

As respostas vão ajudá-lo a determinar que funções PI DataLink podem retornar os dados mais relevantes para a sua tarefa.

Selecione uma abordagem

Técnicas que você pode usar para construir sua planilha incluem:

• Baseado em função

Adicione funções (página 31) na planilha, e construa a exibição em torno das funções conforme necessário. Por exemplo, você pode adicionar informações de ponto para ajudar a esclarecer o que os dados representam. Essa abordagem é útil se você ainda está explorando suas necessidades ou aprendendo como o PI DataLink funciona.

• Baseado em estrutura

Adicione estrutura enquanto você constrói a planilha. Use a ferramenta Pesquisar (consulte "Pesquisar itens de dados" na página 18) para inserir itens de dados que estruturam o assunto da sua planilha, e então adicione funções que recuperam os dados correnpondentes. Essa abordagem requer um pouco mais de planejamento e familiaridade com o PI DataLink, mas uma vez que você tenha adicionado os itens de dados na

planilha, você pode usá-los para construir funções mais facilmente através de referências de célula. Você pode facilmente reutilizar planilhas construídas desta forma.

• Baseado em relatório

Coloque as funções do PI DataLink em uma segunda planilha na pasta de trabalho, e referencie os resultados dessas funções na primeira planilha. Use os recursos de

segurança do Excel para esconder e proteger da maioria dos usuários a sintaxe da função e a lógica de negócios na segunda planilha. Essa abordagem é útil se você for um administrador de sistema ou construir planilhas para outros usuários. Essa estratégia também funciona bem para documentos distribuídos através do PI Data Link Server (página 2).

(31)

Construção de planilhas

Exibição relacionada a ativos

Uma exibição relacionada a ativos mostra os valores de um conjunto de atributos PI AF juntamente com o ativo correspondente (um elemento PI AF). Você pode selecionar um ativo diferente para mostrar os valores para esse ativo.

Exibição relacionada ao ativo para o elemento React1

Exibição relacionada ao ativo para o elemento React2

Exibições relacionadas a ativos requerem um conjunto comum de nomes de atributos para os ativos. Por exemplo, para criar uma exibição relacionada a ativos você pode usar elementos PI AF baseados nos mesmos modelos de elementos e atributos.

Criar uma exibição relacionada a ativos

Para criar uma exibição relacionada a ativos, insira um conjunto de itens de dados que tenham uma estrutura comum em sua planilha com uma lista suspensa de caminhos raiz e, então, adicione uma função do PI DataLink que referencie essas células. Depois de criar a exibição relacionada ao ativo, você pode selecionar um ativo diferente da lista para ver os valores de atributo para esse ativo.

Procedimento

1. Inserir um conjunto de itens de dados com uma estrutura comum em sua planilha (página 28).

2. Configurar uma função PI DataLink para recuperar dados sobre os itens de dados inseridos (página 29)

Veja também...

• Exibição relacionada a ativos (página 27) • Pesquisar itens de dados (página 18)

(32)

28

planilha

Exibições relacionadas a ativos exigem que a planilha contenha um conjunto de itens de dados (atributos do PI AF) que têm uma estrutura comum, juntamente com uma lista suspensa de caminho raiz para esses itens de dados.

Procedimento

1. Selecione uma célula na planilha onde você irá inserir os itens de dados.

2. Na guia PI DataLink, clique em Pesquisar para abrir a ferramenta de pesquisa. 3. Defina o escopo da pesquisa, especifique os itens de dados que você deseja recuperar, e

clique em Pesquisar .

Para exibições relacionadas a ativos, você quer encontrar atributos de PI AF que têm um elemento-pai comum e a mesma estrutura de atributo. Esses atributos podem ter o mesmo modelo de atributo. Por exemplo, você pode querer encontrar todos os reatores em suas instalações.

4. Divida o caminho do item de dados de forma que os ativos a serem exibidos apareçam na coluna Caminho raiz.

Mova o controle deslizante Comprimento do caminho raiz até que a coluna Caminho raiz mostre os elementos individuais para os atributos listados. Normalmente isso será próximo da, ou na, posição Maximo .

(33)

Construção de planilhas

5. Selecione os itens de dados que você deseja inserir na planilha. 6. Sob Inserir caminhos raiz em, selecione Lista suspensa. 7. Clique em OK.

O PI DataLink inserirá os itens de dados individuais na planilha abaixo de uma lista suspensa que contém os ativos individuais (da coluna caminho raiz).

Observação: O PI DataLink insere a lista de caminhos raiz na coluna EZ da

planilha. Se essa coluna contém dados, o PI DataLink insere os caminhos na próxima coluna disponível à direita.

Configurar uma função PI DataLink para recuperar dados sobre os itens de dados inseridos

Exibições relacionadas a ativos requerem que você configure uma função PI DataLink para recuperar dados para os itens de dados e caminho raiz que você inseriu na sua planilha: um conjunto de dados com uma estrutura comum e o caminho rai para essa estrutura.

Procedimento

1. Clique na célula da planilha próxima ao primeiro item de dados no intervalo que você inseriu.

2. Na guia PI DataLink, clique na função que você deseja usar para recuperar os valores. O painel de tarefas da função se abrirá, com a célula clicada especificada no campo Célula de saída.

3. No painel de tarefas da função, clique no campo Item(ns) de dado(s) e, em seguida, selecione o intervalo de planilha que contém os itens de dados que você acabou de inserir.

O PI DataLink insere o intervalo de células no campo.

4. No painel de tarefas da função, clique no campo Caminho raiz e, em seguida, selecione a célula da planilha que contém a lista suspensa de caminhos raiz.

(34)

30

6. Clique em OK tpara inserir a matriz de função na planilha.

Você pode selecionar um ativo diferente da lista para ver os valores de atributo para esse ativo.

(35)

Com as funções do PI DataLink você pode consultar qualquer PI Server ou PI AF Server, aplicar cálculos aos resultados recuperados e retornar valores para células da planilha. Como outras funções do Excel, as funções do PI DataLink retornam resultados em matrizes de função, que você pode recalcular para atualizar os valores conforme necessário. Use os painéis de tarefas de função para definir as entradas para as funções do PI DataLink e colá-las em uma planilha.

As descrições de função nesta seção descrevem as entradas específicas para cada função.

Veja também...

• Painéis de tarefas de função (página 12) • Matrizes de função (página 53)

• Referência de função (página 97)

Função Valor Atual

A função Valor Atual retorna o valor atual ou mais recente de um ponto do PI ou atributo do PI AF.

Valor Atual é uma função volátil: a função recalcula e atualiza valores sempre que o Excel calcula ou recalcula qualquer célula na planilha. Para forçar um recálculo imediato, pressione F9.

Entrada Descrição

Caminho raiz O caminho comum para itens de dados especificados. As entradas válidas incluem:

Nome do PI Server se o item de dados é um ponto do PI.

PI AF Server e banco de dados se o item de dados é um atributo do PI AF.

Em branco se o item de dados é um ponto do PI no PI Server padrão.

Veja Itens de dados (página 14).

Item(ns) de dado(s) Um ou mais nomes de ponto do PI ou nomes de atributo do PI AF, para os quais a função retorna valores.

Referencia um intervalo de células que contêm nomes de pontos do PI ou de atributos do PI AF para os quais serão retornados valores. Requerido.

Capítulo 3

(36)

32

Célula de saída A célula de planilha onde a função grava a matriz resultante da função. Se você selecionar uma célula antes de abrir o painel de tarefas de função, o PI DataLink insere a célula selecionada no campo Célula de saída.

Especifica o canto superior esquerdo da matriz de função. O PI DataLink expande o intervalo, para baixo e à direita da célula de saída, conforme necessário para retornar os dados especificados. O PI DataLink pode sobrescrever células adjacentes.

Se você especificar uma matriz com várias células no campo Célula de saída e a matriz especificada for maior do que a matriz de função resultante, o PI DataLink cola a fórmula da função nas células desnecessárias da matriz especificada.

Sem horário Clique nessa opção para retornar somente valores. A função retorna valores em uma coluna para uma coluna de itens de dados

referenciados ou retorna valores em uma linha para uma linha de itens de dados referenciados.

Hora à esquerda Clique nessa opção para retornar duas colunas: o horário na coluna da esquerda e o valor na coluna da direita.

Hora na parte

superior Clique nesta opção para retornar duas linhas: o horário na linha de cima e o valor na linha de baixo.

TÓPICOS RELACIONADOS

• PICurrVal() (página 97)

Exemplo de Valor Atual

Para ver o valor atual do ponto do PI sinusoid, defina as seguintes entradas para a função Valor Atual:

Entrada Valor

Item(ns) de dado(s) sinusoid Hora à esquerda Selecionado

(37)

Função Valor de Arquivo

• Se você selecionar a opção Item de dados,a função Valor de Arquivo retorna o valor de um ponto do PI ou atributo do PI AF em um horário especificado.

• Se você selecionar a opção Expressão, a função Valor de Arquivo retorna o valor calculado de uma Performance Equation em um horário especificado.

Entrada Descrição

Caminho raiz O caminho comum para itens de dados especificados, incluindo aqueles em expressões. As entradas válidas incluem:

Nome do PI Server se o item de dados é um ponto do PI.

PI AF Server e banco de dados se o item de dados é um atributo do PI AF.

Em branco se o item de dados é um ponto do PI no PI Server padrão. Veja Itens de dados (página 14).

Item(ns) de dado(s) Um ou mais nomes de ponto do PI ou nomes de atributo do PI AF, para os quais a função retorna valores.

Referencia um intervalo de células que contêm nomes de pontos do PI ou de atributos do PI AF para os quais serão retornados valores. Requerido se você selecionar a opção Item de dado.

Expressão(ões) Uma ou mais Performance Equations para as quais a função calcula um valor. Veja Expressões (página 65).

Referencie um intervalo de células que contém expressões para as quais serão retornados valores.

Requerido se você selecionar a opção Expressão.

Horário O horário para o qual a função retorna valores. Especifique uma hora fixa ou uma expressão de tempo em relação à hora atual. Veja Entrada

(38)

34

Modo de recuperação O método usado pela função para determinar os valores a serem retornados. As opções incluem:

previous only

Retorna o valor que precede o horário especificado. interpolado

Retorna o valor interpolado no horário especificado. auto

Retorna o valor interpolado na hora especificada, ou segue o método anterior. (Usa o método anterior para itens de dados com atributos "step".)

somente próximo

Retorna o valor que sucede o horário especificado. horário exato

Retorna somente o valor que corresponde exatamente à data e hora, ou retorna Nenhum evento encontrado se não existir nenhum valor com essa data e hora.

Disponível se você selecionar a opção Item de dado.

Célula de saída A célula de planilha onde a função grava a matriz resultante da função. Se você selecionar uma célula antes de abrir o painel de tarefas de função, o PI DataLink insere a célula selecionada no campo Célula de saída.

Especifica o canto superior esquerdo da matriz de função. O PI DataLink expande o intervalo, para baixo e à direita da célula de saída, conforme necessário para retornar os dados especificados. O PI DataLink pode sobrescrever células adjacentes.

Se você especificar uma matriz com várias células no campo Célula de saída e a matriz especificada for maior do que a matriz de função resultante, o PI DataLink cola a fórmula da função nas células desnecessárias da matriz especificada.

Sem horário Clique nessa opção para retornar somente valores. A função retorna valores em uma coluna para uma coluna de itens de dados ou expressões referenciados, ou retorna valores em uma linha para uma linha de itens de dados ou expressões referenciados.

Hora à esquerda Clique nessa opção para retornar duas colunas: o horário na coluna da esquerda e o valor na coluna da direita.

Hora na parte superior

Clique nesta opção para retornar duas linhas: o horário na linha de cima e o valor na linha de baixo.