Pi Datalink 2013 Guia Do Usuario

PI DataLink 2013
Guia do Usuário
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

Copyright: © 1992-2012 OSIsoft, LLC. Todos os direitos reservados.
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
Publicado em: 3/28/2013
Í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

Função Point ID para Tag ................................................................................................76
PI DataLink 2013 Guia do Usuário iii

Índice
Função Máscara de Atributo para Tag.............................................................................76

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
iv
Capítulo 1
Introdução
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.
PI DataLink 2013 Guia do Usuário 1

Introdução
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:
http://techsupport.osisoft.com/Products.htm (http://techsupport.osisoft.com/Products.htm)
2
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
• String*

Introdução
• DateTime*
• 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.
4
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.
3. Instale o pacote de idiomas PI DataLink MUI.

Introdução
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).
6
Microsoft Excel: configuração de suplementos
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)
• Notificações (página 89)

Introdução
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
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
8
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
(http://techsupport.osisoft.com/downloadcenter.aspx).

Capítulo 2
Fundamentos
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.

Fundamentos
Painéis de tarefas de função
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.
12
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)

Fundamentos
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...
• 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.
14
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.

Fundamentos
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.
16
• 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.

Fundamentos
Formatos de exibição
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).
18
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.

Fundamentos
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.
20
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.

Fundamentos
• Clique em um elemento (indicado por ) para limitar a pesquisa a esse elemento.

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.
• Clique em um elemento para redefinir o escopo para todo o elemento.
22
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 Selecione para colar o nome da fonte de dados PI Server
suplementos legados) 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 Selecione para mostrar #N/A (não aplicável) em vez de
branco 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.

Fundamentos
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 Selecione para desativar a abertura automática do painel
painel de tarefas ao clicar de tarefas quando clicar em uma célula de função.
Desativar a mensagem Selecione para não exibir uma mensagem de aviso
"Redimensionar para mostrar todos quando um novo cálculo retorna mais valores do que
os valores" 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.
24
Gerenciar conexões com servidores
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.

Fundamentos
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).
26
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)

Fundamentos
Inserir um conjunto de itens de dados com uma estrutura comum em sua

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 .
28
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.
O PI DataLink insere uma referência de célula no campo.

Fundamentos
5. Especifique outras entradas de função, como desejado.

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.
30
Capítulo 3
Funções do PI DataLink
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...
• 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.

Entrada Descrição
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 Clique nesta opção para retornar duas linhas: o horário na linha de
superior 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
A função retorna a seguinte matriz:
32
Função Valor de Arquivo
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:
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.
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
de tempo (página 16). Requerido.

Entrada Descrição
Modo de recuperação O método usado pela função para determinar os valores a serem
retornados. As opções incluem:
anterior
Retorna o valor que corresponde exatamente, ou precede, o horário
especificado.
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".)
próximo
Retorna o valor que corresponde exatamente, ou sucede, o horário
especificado.
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
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 Clique nesta opção para retornar duas linhas: o horário na linha de cima
superior e o valor na linha de baixo.
34
Função Dados Compactados
• PIArcVal() (página 98)
Especifica itens de dados.
• PIExpVal() (página 99)
Especifica uma expressão.
Exemplo de Valor de Arquivo
Para ver o valor do ponto do PI sinusoid em um momento específico, defina as entradas

seguintes para a função de Valor de Arquivo:
Entrada Valor
Horário 30-Set-07 15:13
Modo de recuperação previous

Hora à esquerda Selecionado

• Se você selecionar a opção Time range , a função Dados Compactados retorna todos os
valores de um ponto do PI ou atributo do PI AF, juntamente com uma contagem dos
valores que ocorreram durante um período de tempo especificado.
• Se você selecionar a opção Number of values , a função Dados Compactados retorna um
número específico de valores de ponto ou valores de atributo, começando em um
determinado momento.
Observação: Valores armazenados no arquivo do PI Server passam por um algoritmo

de compressão que remove todos os valores que representam a mesma
inclinação. Valores armazenados no instantâneo do PI Server não foram
submetidos a este algoritmo de compressão. Se você especificar o momento
atual no período de tempo da função Dados Compactados, a função retorna o
valor instantâneo para aquele momento. Este valor instantâneo pode não ser
armazenado posteriormente no arquivo devido à compressão.

Entrada Descrição
Caminho raiz O caminho comum para itens de dados especificados, incluindo

aqueles em expressões. As entradas válidas incluem:
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.
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.
Hora inicial O início do período de tempo para o qual a função retorna valores.
Veja Entrada de tempo (página 16). Requerido.
Hora final O final do período de tempo para o qual a função retorna valores.
Requerido se você selecionar a opção Intervalo de Tempo.
Número de valores O número de valores que a função retorna, começando em Hora
Inicial. Requerido se você selecionar a opção Número de valores.
Anterior no tempo Selecione essa caixa de verificação para retornar valores
registrados em Hora Inicial e anteriormente. Disponível se você
selecionar a opção Número de valores e entrar um valor no
campo Número de valores.
Se você entrar uma referência de célula no campo Número de
valores, essa caixa de verificação será desabilitada. Em vez disso,
digite um número negativo na célula referenciada para ter o mesmo
efeito.
Expressão de filtro Uma Performance Equation lógica usada pela função para filtrar
valores. Quando o resultado da expressão é falso, a função exclui
os valores correspondentes. Veja Expressões de filtro (página 67).
Marcar como filtrado Marque essa caixa de verificação para inserir o rótulo Filtrado
em lugar de um valor ou um bloco de valores que a função filtrou
da saída com base na Expressão de filtro.
Tipo de limite O método que a função usa para determinar quais valores serão
retornados próximo da hora inicial ou final:
dentro (Padrão)
Retorna os valores na hora inicial ou final, se existirem, ou os
valores mais próximos que ocorrem dentro do intervalo.
fora
Retorna os valores mais próximos que ocorrem imediatamente
fora do intervalo.
interpolado
Retorna valores interpolados na hora inicial e final.
auto
Retorna valores interpolados, mas usa o método dentro para
itens de dados com atributos "step".
36
Entrada Descrição
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.
Ocultar contagem Marque essa caixa de verificação para ocultar a contagem de
valores retornados e mostrar apenas os valores retornados.
Requerido se você selecionar a opção Intervalo de tempo.
Mostrar horário Marque essa caixa de verificação para mostrar o horário que
corresponde a cada valor retornado. O PI DataLink mostra os
horários à esquerda dos valores exibidos em uma coluna, ou acima
dos valores exibidos em uma linha.
Mostrar atributos de Marque essa caixa de verificação para mostrar os bits de estado
valor estendido associados aos valores retornados. Bits de status
possíveis incluem:
A
Anotado, indica que um comentário foi adicionado ao evento
S
Substituído, indica que o valor do evento foi alterado em relação
ao seu valor original
Q
Questionável, indica que há alguma razão para duvidar da
exatidão do valor
O PI DataLink mostra os atributos de valor em uma coluna à direita
dos valores do evento.
Mostrar anotações Marque essa caixa de verificação para mostrar anotações
associadas aos valores retornados. Anotações contêm notas ou
comentários que descrevem um valor de dados. O PI DataLink
mostra as anotações em uma coluna à direita do valor.
Coluna Clique nessa opção para retornar os valores em uma coluna.
Linha Clique nesta opção para retornar os valores em uma linha.
Observação: Se você especificar uma série de itens em Item(ns)
de dado(s), o PI DataLink seleciona automaticamente Coluna ou
Linha para corresponder à orientação dos itens.

• PICompDat() (página 103)
Especifica um intervalo de tempo sem uma expressão de filtro.
• PICompFilDat() (página 104)
Especifica um intervalo de tempo com uma expressão de filtro.
• PINCompDat() (página 100)
Especifica uma quantidade de valores sem uma expressão de filtro.
• PINCompFilDat() (página 102)
Especifica uma quantidade de valores com uma expressão de filtro.
Exemplo de Dados Compactados
Para ver os 10 valores mais recentes do ponto do PI sinusoid, defina as seguintes entradas
para a função Dados Compactados:
Entrada Valor
Número de valores Selecionado
Hora inicial $A$10 (assumindo que a célula A-10 contém a
hora atual)
Número de valores 10
Anterior no tempo Selecionado
Tipo de limite inside
Mostrar horário Selecionado
Coluna Selecionado
Note que você poderia selecionar a opção Intervalo de tempo e especificar a Hora Inicial e
Hora Final apropriadas para retornar os mesmos valores.
38
Função Dados de Amostragem

• Se você selecionar a opção Item de dado, a função Dados de Amostragem retorna
valores interpolados, uniformemente espaçados, para um ponto do PI ou atributo do PI
AF a intervalos regulares.
• Se você selecionar a opção Expressão, a função Dados de Amostragem retorna valores
interpolados, uniformemente espaçados, de uma Performance Equation ao longo de um
intervalo regular.
Entrada Descrição
Caminho raiz O caminho comum para itens de dados especificados, incluindo aqueles
em expressões. As entradas válidas incluem:
PI AF Server e banco de dados se o item de dados é um atributo do PI
AF.
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.
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.
Hora inicial O início do período de tempo para o qual a função retorna valores. Veja
Entrada de tempo (página 16). Requerido.
Hora final O final do período de tempo para o qual a função retorna valores.
Requerido.
Intervalo de tempo A frequência de amostragem utilizada para calcular os valores durante o
período de tempo. Entre um valor e uma unidade de tempo. Por exemplo,
entre 15m (15 minutos) para retornar um valor para cada intervalo de 15
minutos durante o período de tempo. Veja Especificação de intervalo de
tempo (página 64). Requerido.
Expressão de filtro Uma Performance Equation lógica usada pela função para filtrar valores.
Quando o resultado da expressão é falso, a função exclui os valores
correspondentes. Veja Expressões de filtro (página 67).
Marcar como filtrado Marque essa caixa de verificação para inserir o rótulo Filtrado em lugar
de um valor ou um bloco de valores que a função filtrou da saída com base
na Expressão de filtro.

Entrada Descrição
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.
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
Mostrar horário Marque essa caixa de verificação para mostrar o horário que corresponde
a cada valor retornado. O PI DataLink mostra os horários à esquerda dos
valores exibidos em uma coluna, ou acima dos valores exibidos em uma
linha.
Observação: Se você especificar um intervalo de itens em Item(ns) de
dado(s) ou uma série de expressões em Expressão(ões), o PI DataLink
seleciona automaticamente Coluna ou Linha para corresponder à
orientação do intervado especificado.
• PISampDat() (página 105)
Especifica um item de dados sem uma expressão de filtro.
• PISampFilDat() (página 106)
Especifica um item de dados com uma expressão de filtro.
• PIExpDat() (página 107)
40
Exemplo de Dados de Amostragem
Para ver valores interpolados periódicos nas últimas 24 horas para o ponto do PI sinusoid,
defina as seguintes entradas para a função de Dados de Amostragem:
Entrada Valor
Item(ns) de sinusoid
dado(s)
Hora inicial -1d
Hora final $A$10 (assumindo que a célula A-10 contém a hora atual)
Intervalo de 3h
tempo
Mostrar horário Selecionado
Coluna Selecionado
A matriz contém um valor para cada intervalo de 3 horas.

Função Dados Temporizados

• Se você selecionar a opção Item de dados, a função Dados Temporizados retorna valores
reais ou de amostragem interpolada para um ponto do PI ou atributo do PI AF nos
horários especificados.
• Se você selecionar a opção Expressão, a função Dados Temporizados retorna valores de
uma Performance Equation calculados em horários especificados.
Entrada Descrição
Caminho raiz O caminho comum para itens de dados especificados, incluindo aqueles em
expressões. As entradas válidas incluem:
PI AF Server e banco de dados se o item de dados é um atributo do PI AF.
Item(ns) de Um ou mais nomes de ponto do PI ou nomes de atributo do PI AF, para os
dado(s) 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.
Expressão(ões) Uma ou mais Performance Equations para as quais a função calcula um valor.
Veja Expressões (página 65).
Horário(s) Os horários para os quais a função retorna valores. Entre um horário ou uma
referência a uma ou mais células da planilha que contêm valores de horário.
Requerido.
Modo de O método usado pela função para recuperar dados:
recuperação interpolado
Retorna valores interpolados que correspondem aos horários especificados.
Para os itens de dados com os atributos "step", recupera o valor anterior ao
horário especificado.
horário exato
Retorna somente os valores que correspondem exatamente ao horário
especificado; retorna Não foram encontrados eventos se não existe
valor.
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.
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.
42
Função Dados Temporizados
• PITimeDat() (página 108)
Especifica um item de dados.
• PITimeExpDat() (página 109)
Exemplo de Dados Temporizados
Para ver os valores que correspondem a uma série de horários para o ponto do PI
sinusoidu, defina as seguintes entradas para a função de Dados Temporizados:
Entrada Valor
Item(ns) de sinusoidu
dado(s)
Horários $A$3..$A$12 (as células A-3 até A-12 contêm os horários para uma matriz de
dados compactados)
Modo de interpolado
recuperação
A função retorna a seguinte matriz de dados temporizados na coluna à direita:
A matriz de dados temporizados é baseada nos horários da primeira coluna.

Função Dados Calculados

• Se você selecionar a opção Item de dado , a função Dados Calculados retorna um ou
mais valores calculados, uniformemente espaçados, baseados no ponto do PI ou valores
de atributos do PI AF e nas preferências de cálculo especificadas.
• Se você selecionar a opção Expressão , a função Dados Calculados retorna um ou mais
valores calculados, uniformemente espaçados, baseados em uma equação de desempenho
avaliada e nas preferências de cálculo especificadas.
Observação: Clique no sinal + ao lado de Avançado para acessar todas as entradas da

função.
Entrada Descrição
dado(s) 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.
Expressão(ões) Uma ou mais Performance Equations para as quais a função calcula um valor.
Veja Expressões (página 65).
Hora final O final do período de tempo para o qual a função retorna valores. Requerido.
minutos durante o período de tempo. Veja Especificação de intervalo de tempo
(página 64).
Expressão de filtro Uma Performance Equation lógica usada pela função para filtrar valores.
Quando o resultado da expressão é falso, a função exclui os valores
correspondentes. Veja Expressões de filtro (página 67).
44
Entrada Descrição
Fator de conversão Um fator que a função aplica aos valores retornados. Digite 1 se um fator de
conversão não é necessário. Para cálculo de totais ponderado no tempo,
especifique um fator que converte os valores da taxa gravada para a unidade
de tempo padrão do servidor (unidades por dia). Requerido.
Por exemplo, os fatores de conversão comuns incluem:
1,0 para valores que armazenam unidades/dia
24 para valores que armazenam unidades/hora
1440 para valores que armazenam unidades/minuto
86400 para valores que armazenam unidades/segundo
Modo de cálculo O tipo de cálculo que a função executa:
total
Soma os valores durante o intervalo.
mínimo
Encontra o valor mínimo durante o intervalo.
máximo
Encontra o valor máximo durante o intervalo.
desvio padrão
Calcula o desvio padrão dos valores durante o intervalo.
intervalo
Calcula o valor máximo menos o valor mínimo durante o intervalo.
média
Calcula a média dos valores durante o intervalo.
contagem
Conta o número de valores armazenados durante o intervalo.
mediana
Calcula a versão ponderada por evento do cálculo da média.
Base de cálculo O método de cálculo:
peso de tempo
Padrão. A função pondera cada valor de evento pelo período de tempo em
que o evento se aplica.
peso de evento
A função pondera cada evento igualmente. Selecione esta opção para
valores de lote. Este método requer pelo menos um evento em um período
de tempo (dois eventos para cálculos de desvio padrão).
Amostragem da O método usado pela função para determinar quando avaliar uma expressão:
expressão compactado
A função avalia a expressão durante o período de tempo em horários onde
os pontos do PI ou atributos do PI AF na expressão tem valores
armazenados.
interpolado
A função avalia a expressão em intervalos de amostragem igualmente
espaçados, determinado por Frequência de amostragem de expressão.
Disponível se você selecionar Expressão ou se você especificar uma
Expressão de filtro.
Frequência de A freqüência na qual a função avalia uma expressão. Requerido se você
amostragem da definir Expressão de amostragem para interpolado.
expressão Por exemplo, defina para 10m (10 minutos) para retornar um valor interpolado
para cada intervalo de 10 minutos.

Entrada Descrição
Mínimo percentual O percentual mínimo de dados bons necessários em cada intervalo de tempo
bom para calcular e retornar um valor para o intervalo. A função retorna o rótulo
Dados bons insuficientes para um intervalo que não atenda a esse
percentual.
especificada.
Mostrar hora inicial Marque essa caixa de verificação para mostrar a hora inicial do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora
inicial em uma coluna à esquerda ou em uma linha acima dos valores
retornados. Disponível apenas se você especificar Intervalo de tempo.
Mostrar hora final Marque essa caixa de verificação para mostrar a hora final do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora final
em uma coluna à esquerda ou em uma linha acima dos valores retornados.
Disponível apenas se você especificar Intervalo de tempo.
Mostrar hora Marque essa caixa de verificação para mostrar o horário que corresponde ao
min/max valor mínimo ou máximo, durante o intervalo utilizado para calcular o valor.
Disponível apenas para três valores de Modo de cálculo:
máximo
Mostra o horário do valor máximo.
mínimo
Mostra o horário do valor mínimo.
intervalo
Mostra os horários dos valores mínimo e máximo.
Mostrar percentual Marque esta caixa de verificação para mostrar o percentual de tempo em que
bom bons valores são retornados durante o período de tempo da matriz. O PI
DataLink mostra o percentual de bons valores em uma coluna à direita ou em
uma linha abaixo dos valores retornados.
Valores bons são valores de eventos que PI Server determinou serem válidos,
e que não estão em um estado de erro. Você pode usar o percentual de bons
valores para avaliar a confiabilidade dos cálculos construídos sobre valores de
pontos do PI, especialmente se você usar os valores calculados em outros
cálculos.
Por exemplo, se um intervalo de tempo inclui dados com erro, o total
resultante ponderado no tempo é igual ao total dividido pela fração do intervalo
onde bons valores estão disponíveis. Esta normalização assume que a média
durante o período de tempo com dados com erro é equivalente ao valor médio
ao longo de todo o período. Assim, a média torna-se menos confiável se uma
grande parcela do período de tempo contém dados inválidos.
46
Entrada Descrição
Observação: Se você especificar um intervalo de itens em Item(ns) de
dado(s) ou uma série de expressões em Expressão(ões), o PI DataLink
seleciona automaticamente Coluna ou Linha para corresponder à orientação
do intervado especificado.
• PIAdvCalcVal() (página 110)
Especifica um item de dados para recuperar um único valor
• PIAdvCalcFilVal() (página 111)
Especifica um item de dados e uma expressão de filtro para recuperar um único valor
• PIAdvCalcExpVal() (página 113)
Especifica uma expressão para recuperar um único valor
• PIAdvCalcExpFilVal() (página 115)
Especifica uma expressão e uma expressão de filtro para recuperar um único valor
• PIAdvCalcDat() (página 117)
Especifica um item de dados e um intervalo de tempo para recuperar vários valores
• PIAdvCalcFilDat() (página 119)
Especifica um item de dados, um intervalo de tempo, e uma expressão de filtro para
recuperar vários valores
• PIAdvCalcExpDat() (página 121)
Especifica uma expressão e um intervalo de tempo para recuperar vários valores
• PIAdvCalcExpFilDat() (página 123)
Especifica uma expressão, um intervalo de tempo e uma expressão de filtro para
recuperar vários valores

Exemplo de Dados Calculados
Para ver a faixa horária de valores a partir de meia-noite de hoje até o presente momento para
o ponto do PI sinusoid, defina as seguintes entradas para a função de dados calculados:
Entrada Valor
Hora inicial h
Hora final *
Intervalo de tempo 1h
Modo de cálculo range
Base de cálculo time-weighted
Mostrar hora inicial Selecionado
Mostrar hora final Selecionado
Coluna Selecionado
Nesse exemplo, a função calcula a faixa para cada intervalo de uma hora. Você pode
especificar qualquer cálculo disponível sobre qualquer intervalo.
48
Função Hora Filtrada
Função Hora Filtrada

A função Hora Filtrada retorna a quantidade de tempo em que uma Performance Equation é
avaliada como verdadeira durante um período especificado de tempo.
Observação: Os resultados da função Tempo Filtrado variam um pouco dependendo da

versão de seu PI Server.
Entrada Descrição
Expressão(ões) Uma Performance Equation lógica avaliada pela função. Veja Expressões
(página 65).
Requerido.
Hora final O final do período de tempo para o qual a função retorna valores. Requerido.
minutos durante o período de tempo. Veja Especificação de intervalo de tempo
(página 64).
Unidades de As unidades de tempo nas quais a função retorna o resultado. Requerido.
tempo
especificada.
Mostrar hora inicial Marque essa caixa de verificação para mostrar a hora inicial do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora
inicial em uma coluna à esquerda ou em uma linha acima dos valores
retornados. Disponível apenas se você especificar Intervalo de tempo.

Entrada Descrição
Mostrar hora final Marque essa caixa de verificação para mostrar a hora final do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora final
em uma coluna à esquerda ou em uma linha acima dos valores retornados.
Disponível apenas se você especificar Intervalo de tempo.
Mostrar percentual Marque esta caixa de verificação para mostrar o percentual de tempo em que
bom bons valores são retornados durante o período de tempo da matriz. O PI
DataLink mostra o percentual de bons valores em uma coluna à direita ou em
uma linha abaixo dos valores retornados.
Valores bons são valores de eventos que PI Server determinou serem válidos,
e que não estão em um estado de erro. Você pode usar o percentual de bons
valores para avaliar a confiabilidade dos cálculos construídos sobre valores de
pontos do PI, especialmente se você usar os valores calculados em outros
cálculos.
Por exemplo, se um intervalo de tempo inclui dados com erro, o total
resultante ponderado no tempo é igual ao total dividido pela fração do intervalo
onde bons valores estão disponíveis. Esta normalização assume que a média
durante o período de tempo com dados com erro é equivalente ao valor médio
ao longo de todo o período. Assim, a média torna-se menos confiável se uma
grande parcela do período de tempo contém dados inválidos.
Observação: Se você especificar um intervalo de itens em Expresssão(ões),
o PI DataLink seleciona automaticamente Coluna ou Linha para corresponder
à orientação dos itens.
• PITimeFilterVal() (página 126)
Retorna um único valor
• PITimeFilter() (página 125)
Especifica um intervalo de tempo e retorna vários valores
Exemplo Tempo Filtrado
Para ver o número de horas em que o valor do ponto do PI sinusoid excedeu 75 durante
os últimos sete dias, defina as seguintes entradas para a função Tempo Filtrado:
Entrada Valor
Expressão 'sinusoid' > 75
Hora inicial -7d
Hora final *
Unidades de tempo h
Mostrar percentual bom Selecionado

Coluna Selecionado
50
Função Propriedades
Neste exemplo, a função calcula que o valor da senóide excedeu 75 por 7,85 horas durante os
7 dias anteriores e 100 por cento dos valores foram boms durante esse período.
Função Propriedades
A função Propriedades retorna o valor da propriedade de um item de dados especificado.
Entrada Descrição
Caminho raiz O caminho comum para itens de dados especificados. As entradas válidas
incluem:
dado(s) quais a função retorna valores de propriedade.
Referência a um intervalo de células que contém nomes de pontos do PI ou
nomes de atributos do PI AF para os quais serão exibidos valores. Por padrão,
o PI DataLink escreve os valores em linhas para uma coluna de itens de dados
referenciados e nas colunas para uma linha de itens de dados referenciados.
Propriedade A propriedade para a qual a função retorna valores. As propriedades listadas
dependem do item de dados entrado:
Ponto do PI único. A lista contém os atributos de ponto da classe de ponto
do ponto entrado.
Observação: Essa lista substitui uom por engunits. Selecione uom se você
quiser ver o valor do atributo de ponto engunits.
Atributo do PI AF único. A lista contém três propriedades de atributo do PI
AF: categorias, descrição, e uom.
Referência para várias células. A lista depende do tipo do item de dados na
primeira célula referenciada:
Ponto do PI. A lista contém os atributos de ponto da classe de ponto
desse ponto.
Atributo do PI AF A lista contém três propriedades de atributo do PI AF:
categorias, descrição, e uom.
Se a lista estiver em branco, o PI DataLink não conseguirá encontrar o item de
dados.
Selecione a propriedade desejada ou especifique uma referência de célula
para uma célula que contenha a propriedade.

Entrada Descrição
especificada.
• PITagAtt() (página 99)
Exemplo de Propriedades
Para ver os valores dos atributos de alguns pontos do PI listadas na planilha, defina as
seguintes entradas para a função Propriedades:
Entrada Valor
Item de dados B3..B5 (matriz de células contendo pontos)
Propriedade descrição
Nesse caso, os nomes de ponto estão em uma coluna à esquerda. Você pode usar uma função
Propriedades diferente para visualizar atributos adicionais nas colunas subseqüentes.
52
Capítulo 4
Planilhas
Essa seção discute como as funções do PI DataLink trabalham com a planilha e como
gerenciar e manter sua planilha ao longo do tempo.
Matrizes de função
Uma matriz de função é um conjunto de células que contém a saída de uma única função do
PI DataLink. Quando você adiciona uma função a uma planilha, o PI DataLink entra a
fórmula de função nas células de saída especificadas. A função consulta o PI Server ou PI AF
Server e retorna valores em uma matriz de função. O tamanho da matriz depende da função,
do número de valores correspondentes disponíveis, do número de valores solicitadoss, e da
saída solicitada.
A planilha mostra os valores retornados nas células de uma matriz de funções. No entanto,
essas células contêm, na realidade, a fórmula da função. Você pode ver a fórmula de função
na barra de fórmulas do Excel quando você clica na célula.
1 — Fórmula de função na barra de fórmulas

2 — Valores retornados na matriz de funções

Planilhas
Tarefas comuns de matrizes de função
Matrizes de função podem ser movidas, copiadas ou removidas de uma planilha.

Para selecionar uma matriz, escolha uma das opções abaixo:
• Clique e arraste para selecionar cada célula da matriz. Observe que a planilha pode conter
células vazias, que também devem ser selecionadas.
• Clique com o botão direito em qualquer parte da matriz e então clique em Selecionar
Função DataLink para selecionar todas as células na matriz.
Uma vez selecionada, você pode facilmente gerenciar a matriz.
• Manualmente remova os caracteres $ iniciais na barra de fórmulas para tornar as
referências relativas.
Observação: Após fazer uma mudança na barra de fórmulas, pressione Ctrl + Alt +
Shift para aplicar a mudança.
• Clique com o botão da direita em qualquer célula na matriz e então clique no comando
Cortar, Copiar, Excluir, Limpar, ou Formatar desejado.
• Clique com o botão da direita em uma nova célula e então clique Colar para reinserir
uma matriz cortada ou copiada.
• Coloque o ponteiro na borda de uma matriz selecionada, e quando o ponteiro se tornar
um ponteiro de movimento, arraste a matriz para uma nova célula para movê-la.
Observação: Você deve mover ou limpar uma matriz de função inteira, incluindo
todas as células, ou o PI DataLink retornará uma mensagem de erro: Você
não pode modificar parte de uma matriz.
• Abra o painel de tarefas de função e atualize o campo Célula de saída para colocar a
matriz em uma nova localização. Veja Atualizar as entradas para uma matriz de funções
(página 54).
Você também pode copiar os valores de uma matriz de função se você desejar usá-los em
algum outro lugar da planilha. Depois que você copiar e colar os valores, eles não farão mais
parte de uma matriz de função, eles serão apenas valores de células e não serão mais
atualizados. Para copiar valores de matriz:
• Selecione os valores da função que você deseja, copie-os, e use o comando Colar
Especial para colar os valores na posição desejada.
Você não precisa selecionar a coluna ou linha inteira da matriz para copiar os valores.
54
Matrizes de função
Atualizar as entradas para uma matriz de funções
Use o painel de tarefas de função para atualizar uma matriz de funções com os novos dados
de entrada.
Procedimento
1. Abra o painel de tarefas de função para uma matriz.
ο Com a exibição automática de painel de tarefa habilitada, clique em uma ou em
várias células.
ο Com a exibição automática de painel de tarefa desabilitada, selecione uma ou várias
células, clique com o botão da direita, e escolha o nome da função.
O painel de tarefas de função mostra as entradas atuais para a matriz de função
selecionada.
Se você selecionou uma única célula, o PI DataLink automaticamente detecta matrizes de
função adjacentes que diferem somente pela fonte (ou seja, pelo item de dados ou
expressão) e seleciona essas matrizes para edição.
Se você selecionou várias células, o PI DataLink seleciona somente as matrizes que
tenham a mesma fonte (isso é, os mesmos valores de item de dados ou expressão) das
células selecionadas.
2. Altere os valores de entrada como desejado para atualizar as matrizes selecionadas, e
clique OK ou Aplicar.
Se você alterou o campo Célula de saída, o resultado dependerá da localização da nova
referência de célula:
ο Se a nova referência de célula é parte da matriz original, então o PI DataLink move a
matriz inteira, colocando a célula superior esquerda da matriz na nova célula
referenciada.
ο Se a nova referência de célula não é parte da matriz original, então o PI DataLink
copia a matriz, localizando a célula superior esquerda da matriz na nova célula
referenciada. A matriz original continuará na sua localização original.
Tamanho da matriz:
Quando o PI DataLink escreve a matriz de funções, ele automaticamente dimensiona a matriz

para conter os dados retornados. As funções escrevem a matriz de funções quando você clica
em OK ou Aplicar em um painel de tarefas ou quando você clica em Recalcular
(Redimensionar) Função no menu de atalhos.
Outros métodos que recalculam ou atualizam a função não escrevem uma nova matriz de
funções. Esses métodos atualizam os valores somente; o tamanho da matriz permanece
inalterado. Por exemplo, se você especificar entradas de função com referências de células e
mudar os valores em uma célula, a função vai atualizar os valores retornados mas o tamanho
da matriz de funções permanecerá o mesmo. A atualização pode retornar mais ou menos
valores do que a matriz de funções na planilha pode mostrar. As configurações controlam o
que o PI DataLink retorna:
Planilhas
• Se a atualização retornar menos valores, o PI DataLink return brancos ou #N/A nas

células sem valores.
• Se a atualização retornar mais valores do que a matriz de funções pode exibir, o PI
DataLink retorna o texto Redimensione para mostrar todos os valores
no final da matriz de funções, a não ser que as configurações de preferência desabilitem a
mensagem.
Valores vazios podem modificar a aparência da planilha. Para manter um tamanho constante,
considere definir as entradas de função para limitar os valores retornados. Por exemplo, na
função Dados Compactados, você pode especificar o número de valores a recuperar ao invés
de um período de tempo durante o qual você recupera todos os valores.
Veja também...
• Frequência de cálculo (página 56)
• Redimensionar matrizes (página 56)
• Gerenciar configurações de preferência (página 23)
Redimensionar matrizes
Uma atualização ou recálculo de uma função do PI DataLink pode retornar mais ou menos
valores do que a matriz pode mostrar. Use o comando Recalcular (Redimensionar) Função
para regravar 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.
Procedimento
• Clique com o botão da direita em uma matriz de funções e, então, clique em Recalcular
(Redimensionar) Função.
A função reescreve a matriz de funções, usando os dados atuais, e automaticamente
redimensiona a matriz para conter os dados retornados.
Frequência de cálculo
O PI DataLink grava a matriz de função e calcula os valores atuais para a função sempre que
você clica em OK ou Apply no painel de tarefas de função. Para manter os valores atuais
você deve recalcular a matriz de função. As seções seguintes discutem abordagens para
recalcular uma matriz de funções.
Para informação detalhada sobre como o Excel gerencia o cálculo, veja o tópico Recálculo do
Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) na biblioteca do MSDN.
56
Frequência de cálculo
Recurso Atualização Automática
O recurso de Atualização Automática inicia o recálculo das funções e tendências em

intervalos especificados. A Atualização Automática se aplica a qualquer pasta de trabalho
aberta na mesma seção do Excel. A Atualização Automática pausa quando você abre um
menu, painel de tarefas, ou janela, ou quando você entra no modo de edição na planilha atual.
A Atualização Automática não pode atualizar pastas de trabalho protegidas, que são somente
para leitura.
Suas configurações de preferência afetam a Atualização Automática:
• Tipo de atualização
A configuração de preferência determina quais funções são atualizadas durante a
Atualização Automática. Existem duas opções:
ο Cálculo (F9)
Selecione essa opção para recalcular todas as funções voláteis e qualquer função que
as referencie durante cada recálculo.
ο Cálculo Completo (Ctrl+Alt+Shift+F9)
Selecione essa opção para recalcular todas as funções, independente da volatilidade,
durante cada recálculo.
• Frequência de atualização
No campo Intervalo , entre o número de segundos entre recálculos automáticos. O valor
mínimo é cinco segundos. Entre o para que o PI DataLink configure o intervalo para duas
vezes a duração do cálculo, com um intervalo mínimo de cinco segundos. A OSIsoft
recomenda que você use o intervalo automático para garantir que o Excel continue
respondendo 50% do tempo.
Se o recálculo levar mais tempo que o intervalo especificado, uma mensagem perguntará
se você deseja mudar para intervalo automático ou desligar a Atualização Automática.
Veja também...
• Gerenciar configurações de preferência (página 23)
• Ativar Atualização Automática (página 57)
• Cancelar Atualização Automática (página 58)

Planilhas
Ativar Atualização Automática

Ative o recurso de Atualização Automática para recalcular as funções do PI DataLink
automáticamente em intervalos especificados.
Procedimento
• Na guia PI DataLink , clique no botão Update.
O Excel imediatamente recalcula todas as funções do PI DataLink em todas as pastas de
trabalho na sessão atual do Excel. Então, o Excel altomaticamente recalcula essas funções
no intervalo especificado nas suas configurações de preferência.
Quando a Atualização Automática está habilitada, o botão Atualizar é destacado e a
barra de status mostra um indicador de mensagem.
Veja também...
Gerenciar configurações de preferência (página 23)
Cancelar Atualização Automática

Cancele o recusro de Atualização Automática para interromper o recálculo automático de
funções do PI DataLink.
Procedimento
• Na guia PI DataLink , clique no botão destacado Atualizar para limpar a seleção.
• Clique ESC para cancelar um recálculo automático em andamento. O PI DataLink
termina o recálculo para a função que está sendo processada no momento, escreve
Cálculo cancelado nas células das matrizes de função não processadas e desliga a
Atualização Automática.
Recálculo por disparo
O Excel recalcula funções voláteis e qualquer função que referencie uma função volátil
sempre que você altera qualquer célula da planilha or pressiona F9. Funções voláteis incluem
as funções de tempo do Excel, now() e today(). A função Valor Atual é uma função
volátil; as outras funções do PI DataLink não são. Você pode disparar o recálculo de funções
não-voláteis do PI DataLink quando referencia uma função volátil dentro de funções não-
voláteis do PI DataLink.
Basear funções do PI DataLink em funções voláteis do Excel

Se você não usar o recurso de Atualização Automática, você pode maximizar a frequência de
atualização e manter as matrizes de função atuais baseando suas funções PI DataLink em uma
função volátil do Excel.
58
Compartilhamento de planilhas
Procedimento
1. Use a barra de fórmulas do Excel para entrar uma função volátil em uma célula de
planilha.
Por exemplo, você pode usar (today()+1/3) para representar 08:00hs, ou now()
como uma referência de célula para substituir a hora atual do PI, *.
Para criar um horário absoluto que dispara atualizações, some e subtraia now(), como
em 2-fev-12 00:30:30 + now() - now().
2. Referencie a célula quando você definir as entradas de Hora Inicial ou Hora Final em
uma função do PI DataLink.
Observação: Para maximizar a frequência de atualizações quanto a Atualização

Automática não está em uso, verifique suas preferências de cálculo no Excel para
garantir que tanto a planilha quanto a aplicação estão definidas para cálculo
Automático ao invés de Manual. Tenha em mente que isso pode afetar o
desempenhos e tornar planilhas grandes difíceis de serem usadas.
Recálculo manual
Você pode também recalcular as funções do PI DataLink manualmente:

• Pressione F9 para forçar o recálculo de todas as funções voláteis (e qualquer função que
as referencie).
• Pressione Ctrl+Alt+Shift+F9 para forçar o recálculo de todas as funções.
• Clique com o botão da direita em uma matriz de funções e, então, clique em Recalcular
(Redimensionar) Função. Esse comando irá gravar a matriz inteira e automaticamente
redimensionar seu tamanho para conter os dados retornados.
Compartilhamento de planilhas
Para compartilhar dados do PI DataLink com outros, você pode compartilhar pastas de
trabalho criadas com o PI DataLink. Para determinar a melhor maneira de compartilhar
planilhas, considere o seguinte:
• Você pode enviar uma pasta de trabalho PI DataLink para outro usuário do Excel. O
usuário deve ter o PI DataLink instalado e uma conexão ativa para o mesmo PI Server e
PI AF Server para poder recalcular as funções e ver or valores dos pontos do PI e
atributos do PI AF atualizados dinamicamente.
• Aqueles que não tem o PI DataLink instalado podem ver os últimos dados salvos na
planilha, desde que a opção Cálculo da Pasta de Trabalho do Excel esteja configurada
para Manual antes que ele abra a planilha no Excel. Veja Configurar opção de Cálculo
da Pasta de Trabalho para manual (página 60).
• Você pode também salvar uma planilha como uma página da web ou arquivo PDF para
compartilhar uma versão estática da planilha.

Planilhas
• Você pode copiar e colar (página 53) valores das matrizes de função para novos locais na
planilha usando o comando Colar Especial. Embora os dados da planilha não sejam mais
atualizados depois de copiados, esse método permite que você distribua um instantâneo
customizado dos dados para qualquer pessoa que tenha uma cópia do Excel.
• Se você tem o Microsoft SharePoint Server no seu ambiente de computação, você pode
publicar uma planilha do PI DataLink em um site SharePoint e usar o PI DataLink Server
(página 2) para exibir e recalcular dados de funções PI DataLink.
Configurar opção de Cálculo da Pasta de Trabalho para manual
Para permitir que aqueles que não tem o PI DataLink vejam os últimos dados salvos na pasta
de trabalho, configure a opção Cálculo da Pasta de Trabalho do Excel para Manual antes
de salvar a pasta de trabalho.
Procedimento
2. Na janela Opções do Excel, clique em Fórmulas.
3. Em Opções de cálculo, defina Cálculo da Pasta de Trabalho para Manual e, então,
clique em OK.
60
Capítulo 5
Tópicos avançados
Tópicos nessa discussão proporcionam informações mais detalhadas, úteis para trabalhar com
funções PI DataLink.
Horário PI
Você pode usar uma sintaxe especial, chamada Horário PI, para especificar entradas para
horários e intervalos de tempo. O Horário PI usa abreviaturas específicas, que você combina
para criar expressões de tempo.
Abreviaturas do horário do PI
Quando especificando um horário no PI, você pode usar abreviaturas específicas que
representam unidades de tempo e horários de referência.
Abreviaturas de unidade de tempo
Abreviatura Unidade de tempo

s segundo
m minuto
h hora
d dia
me mês
o ano
se semana
Para especificar unidades de tempo, você pode especificar a abreviatura, a unidade de tempo
completa, ou a versão no plural da unidade de tempo, como s, segundo, ou segundos.
Você deve incluir um valor válido com qualquer unidade de tempo. Se especificando
segundos, minutos ou horas, você pode especificar um valor fracionado, como 1,25h. Você
não pode especificar valores fracionados para outras unidades de tempo.

Tópicos avançados
Abreviaturas de horários de referência
Abreviatura Versão Horário de referência

completa
* Hora Atual
h hoje 00:00:00 (meia-noite) do dia atual
o ontem 00:00:00 (meia-noite) do dia anterior
1 domingo 00:00:00 (meia-moite) do Domingo mais recente
dom
jun2 junho 00:00:00 (meia-noite) no dia atual em Junho do ano

atual
dez DD dezembro DD 00:00:00 (meia-noite) no dia DD de Dezembro do ano
atual
AAAA 00:00:00 (meia-noite) no dia e mês atual no ano de
AAAA
M-D ou M/D 00:00:00 (meia-noite) no dia D do mês M no ano atual
DD 00:00:00 (meia-noite) no dia DD do mês atual
1
Use as três primeiras letras como abreviatura para qualquer dia da semana: dom, seg, ter,
qua, qui, sex ou sab.
2
Use as três primeiras letras como abreviatura para qualquer mês do ano: jan, fev, mar, abr,
mai, jun, jul, ago set, out, nov, ou dez.
Expressões de horário do PI
As expressões de horário do PI podem incluir uma referência de horário e um deslocamento

de tempo, indicado por uma direção (+ ou -) e uma unidade de tempo com um valor. As
expressões de horário do PI podem incluir:
• Apenas um horário de referência, como t
• Apenas um deslocamento de tempo, como +3h
• Uma referência de horário com um deslocamento de tempo, como t+3h
Uma referência de horário pode ser fixa, como 24-ago-2012 09:50:00, ou uma
abreviatura de horário de referência válida, como t.
Você pode incluir somente um deslocamento de tempo em uma expressão. A inclusão de
múltiplos deslocamentos pode levar a resultados imprevisíveis. Por exemplo, as expressões
de tempo seguintes não são válidas:
*+1d+4h
t-1d+12h
62
Horário PI
Especificação de horário
Para especificar entradas para horários, você pode entrar expressões de tempo que
contenham:
• Horários fixos
Um horário fixo representa sempre o mesmo horário, independente do campo ou do
horário atual.
Entrada Significado
23-ago-12 15:00:00 15:00hs em 23 de Agosto de 2012
25-set-12 00:00:00 (meia-noite) em 25 de Setembro de
2012
• Abreviaturas de horários de referência

Uma abreviatura de horário de referência representa um horário relativo ao horário atual.
Entrada Significado
* Horário atual (agora)
3-1 ou 3/1 00:00:00 (meia-noite) em 01 de Março do ano atual
2011 00:00:00 (meia-noite) no dia e mês atual no ano de
2011
25 00:00:00 (meia-noite) do dia 25 do mês atual
h 00:00:00 (meia-noite) no dia atual (hoje)
o 00:00:00 (meia-noite) no dia anterior (ontem)
ter 00:00:00 (meia-moite) da Terça-Feira mais recente
• Abreviaturas de horários de referência ou horários fixos com um deslocamento de tempo

Quando incluído com um horário fixo ou uma abreviatura de horário de referência, um
deslocamento de tempo adiciona ou subtrai do horário especificado.
Entrada Significado
*-1h Uma hora atrás
h+8h 08:00:00 (08:00hs) hoje
o-8h 16:00:00 (16:00hs) de anteontem
seg+14,5h 14:30:00 (14:30hs) da última Segunda-Feira
sab-1m 23:59:00 (23:59hs) da última Sexta-Feira
1-jan-11-1d 00:00:00 (meia-noite) de 31 de Dezembro de 2010
• Deslocamentos de tempo

Tópicos avançados
Quando entrados sozinhos em um campo de tempo, deslocamentos de tempo especificam

um tempo relativo a um horário de referência implícito. O horário de referência implícito
depende do campo onde você entra a expressão:
ο Para a hora inicial, o horário de referência é o horário atual.
ο Para a hora final, o horário de referência é a hora inicial.
ο Para um horário único, o horário de referência é o horário atual.
Campo Horário Entrada Significado
Hora inicial -1d Um dia antes do horário atual (24 horas
antes do horário atual)
Hora final +6h Seis horas depois da hora inicial
Hora final -30m 30 minutos antes da hora inicial
Horário -15s 15 segundos antes da hora atual
Especificação de intervalo de tempo
Entradas de intervalo de tempo definem intervalos para coleta ou cálculo de valores durante
um período de tempo. Por exemplo, você pode especificar um intervalo de 60 minutos para
calcular uma média horária em um período de 12 horas. Para especificar entradas de intervalo
de tempo, entre um valor válido e uma unidade de tempo:
• Valores positivos definem intervalos que começam em uma hora anterior no período e
que terminam em ou antes de uma hora posterior no período.
Exemplos com valores de intervalo de tempo positivos
Hora inicial 2:00:00 3:15:00
Hora final 3:15:00 2:00:00
Intervalo de tempo 30m 30m
Intervalo retornado 2:00:00 a 2:30:00 2:30:00 a 3:00:00

2:30:00 a 3:00:00 2:00:00 a 2:30:00
• Valores negativos definem intervalos que terminam em uma hora posterior no período e
que começam em ou depois de uma hora anterior no período.
Exemplos com valores de intervalo de tempo negativos
Hora inicial 2:00:00 3:15:00
Hora final 3:15:00 2:00:00
Intervalo de tempo -30m -30m
Intervalo retornado 2:15:00 a 2:45:00 2:45:00 a 3:15:00

2:45:00 a 3:15:00 2:15:00 a 2:45:00
64
Expressões
Expressões
No PI DataLink, expressões são Performance Equations que você pode usar em funções para
incorporar operações matemáticas e cálculos baseados em itens de dados do PI System. Por
exemplo, você pode usar uma expressão em uma função do PI DataLink para calcular valores
enquanto eles são recuperados do PI Server.
Observação: O PI DataLink restringe os itens de dados que você pode incluir em

expressões. Veja Restrições para itens de dados em expressões (página 66).
Algumas funções do PI DataLink aceitam um item de dados ou uma expressão como entrada.
Essas funções mostram as opções Item de Dados e Expressão no alto do painel de tarefas.
Algumas funções do PI DataLink também tem um campo Expressão de Filtro. Especifique
uma expressão de filtro para limitar os valores retornados pela função.
As funções do PI DataLink que podem usar expressões incluem:
• Valor de Arquivo (página 32)
• Dados Compactados (página 35)
• Dados Amostrados (página 39)
• Dados Temporizados (página 41)
• Dados Calculados (página 43)
• Tempo Filtrado (página 48)
As seções seguintes descrevem informações básicas sobre expressões. O PI DataLink suporta
toda a sintaxe, operadores, e funções, que o PI Server suporta.
Para uma descrição completa e exemplos de Performance Equations, veja PI Server
Applications User Guide ou o PI 3 Performance Equations Help File. Você pode baixar a
documentação do Site de Suporte Técnico da OSIsoft
(http://techsupport.osisoft.com/downloadcenter.aspx).

Tópicos avançados
Usar expressões em funções do PI DataLink
Use expressões em funções do PI DataLink para incorporar operações matemáticas e cálculos

baseados em itens de dados do PI System. Funções que aceitam um item de dado ou uma
expressão tem as opções Item de dados e Expressão no alto do painel de tarefas.
Antes de iniciar
Abra o painel de tarefas de funções.
Procedimento
1. Clique na opção Expressão no alto do painel de tarefas de função.
O campo Item(ns) de dado(s) se transforma em um campo Expressõe(s). A
disponibilidade de outros campos pode mudar..
2. Entre uma expressão diretamente no campo Expressõe(s), ou entre uma referência para
uma célula que contenha uma expressão.
Usar referências de célula para especificar múltiplas expressões para uma função.
Lembre-se que uma expressão em uma célula referenciada é uma string, e deve ser
precedida por uma aspa simples.
Sintaxe das expressões
Siga essas orientações quando escrevendo expressões:

• Envolva qualquer ponto do PI ou atributo do PI AF usado em expressões em aspas
simples.
• Se estiver entrando uma expressão em uma célula do Excel, inicie a expressão com uma
aspa simples para forçar o Excel a interpretar a expressão como uma string.
• Se estiver entrando uma expressão em uma célula do Excel e a expressão começar com o
nome de um ponto do PI ou atributo do PI AF, comece a expressão com duas aspas
simples.
• Se estiver entrando um valor para comparar com um ponto do PI digital, especifique o
valor negativo do número do código do estado digital.
66
Expressões
Restrições para itens de dados em expressões
O PI DataLink permite os seguintes tipos de dados em expressões:

• Pontos do PI
• Atributos do PI AF que armazenam referências de dados de pontos do PI.
• Atributos do PI AF que armazenam dados constantes
Além disso, uma função PI DataLink só pode retornar dados de um único PI Server. Assim,
quaisquer pontos do PI em uma expressão, incluindo aqueles referenciados por atributos do
PI AF, devem estar armazenados no mesmo PI Server. Da mesma forma, pontos do PI em
uma expressão de filtro devem estar armazenados no mesmo PI Server que quaisquer pontos
do PI especificados pelos campos Item de dado ou Expressão.
Exemplos de expressões
A expressão seguinte calcula a soma dos valores do ponto do PI sinusoid elevado ao cubo
e o valor do ponto do PI cdf144 dividido por 10:
(('sinusoid')^3 + 'cdf144'/10)
A expressão seguinte avalia como verdadeiro (não-zero) se o valor absoluto do ponto do
PI mytag é no mínimo 14,65:
(abs('mytag') >= 14,65)
A expressão seguinte avalia como verdadeiro se o valor do atributo do PI AF
Manufacturer é ACME:
('\\Server\Database\Element|Manufacturer' = "Manual")
A expressão seguinte avalia como verdadeiro se o valor do ponto do PI sinusoid é
menor do que 45 e a raiz quadrada do valor do ponto do PI vdf1002 é maior do que 2:
('sinusoid' < 45 and sqr('vdf1002') > 2)
Expressões de Filtro
Use uma expressão de filtro em uma função PI DataLink para filtrar valores de eventos
retornados com uma Performance Equation lógica. O PI DataLink remove os dados para os
quais a expressão avalia como falsa.
O Pi DataLink aplica a expressão de filtro aos dados brutos recuperados (e não aos valores
resultantes do cálculo em si) Por exemplo, adicionando a expressão de filtro simples
sinusoid < 70 a uma função Dados Calculados elimina do cálculo todos os valores
maiores que 70.

Tópicos avançados
Expressões de filtro podem conter qualquer Performance Equation lógica; no entanto, itens de
dados em expressões de filtro devem referenciar pontos do PI. Você pode construir
expressões complexas. Por exemplo, você poderia usar expressões de filtro para remover
picos atípicos em valores de dados.
Se disposível, marque a caixa de verificação Marcar como filtrado para inserir o rótulo
Filtrado em lugar de um valor ou um bloco de valores que a função filtrou da saída com
base na expressão de filtro.
Veja também...
• Sintaxe das expressões (página 66)
• Restrições para itens de dados em expressões (página 66)
Entrada manual de funções

Embora você possa usar a interface do PI DataLink para construir funções PI DataLink,
usuários experientes podem preferir entrar as funções diretamente na barra de fómulas do
Excel.
O tópico a seguir se aplica a funções PI DataLink entradas diretamente na barra de fórmulas.
Definir funções manualmente
Se você não quer entrar as fórmulas através do painel de tarefas, você pode definir as funções
do PI DataLink manualmente.
Procedimento
1. Selecione um intervalo apropriado na planilha para a matriz de fusaída, baseado no
número esperado de valores.
2. Entre a função PI DataLink e seus argumentos na barra de fórmulas do Excel.
3. Pressione Ctrl_Shift+Enter para colocar a função do PI DataLink nas células de saída
selecionadas.
Consulte a Ajuda on-line do Excel para informações adicionais sobre fórmulas de matrizes.
68
Orientações para entrada manual de argumentos
A tabela a seguir lista os tipos de dados que você pode entrar como argumentos em funções
do PI DataLink, e fornece orientações para sua entrada.
Dado entrado como Orientação
argumento
Funções padrão Você pode incluir várias funções em argumentos que aceitam
expressões. Veja o PI Server Applications User Guide ou o PI
3 Performance Equations Help File para uma lista dessas
funções.
Strings Envolva argumentos string com aspas duplas.
Por exemplo, para recuperar o tempo instantâneo e o valor do
ponto do PI sinusoid do PI Server chamado casaba,
selecione uma matriz de saída 1 x 2 e entre:
=PICurrVal("sinusoid", 1, "casaba")
Referências de célula Você pode usar referências de célula para qualquer
argumento de funções do PI DataLink.
Por exemplo, suponha que células da planilha tenham os
seguintes valores:
A1 — "sinusoid"
A2 — 1
A3 — "casaba"
Então, entrando a seguinte função na barra de fórmulas:
=PICurrVal(A1, A2, A3)
é equivalente a entrar:
=PICurrVal("sinusoid", 1, "casaba")
Caminho raiz Envolva argumentos string com aspas duplas. Por exemplo,
para recuperar o valor corrente para os atributos do PI AF
especificados nas células B3 até B5 e armazená-las no PI AF
Server DLAFPI, banco de dados MyTest, e elemento Reactor,
entre:
=PICurrVal(B3:B5,0,"\\DLAFPI\MyTest\Reactor")
Veja Itens de dados (página 14) para informação sobre as
entradas válidas.
Códigos de saída Determina quais dados adicionais a função retorna e como a
função orienta a saída. Veja Códigos de saída (página 69).

Tópicos avançados
Códigos de saída
A sintaxe das funções PI DataLink contém um argumento OutCode do tipo integer. Esse
argumento recebe um código de saída que determina quais dados adicionados (página 17) a
função retorna e a orientação das células de saída.
Os painéis de tarefa do PI DataLink geram os códigos de saída automaticamente. No entanto,
se você entrar uma função manualmente na barra de fórmulas do Excel, você deve calcular e
incluir o valor do código de saída apropriado.
Um código de saída é a representação do tipo integer de bits binários. No Pi DataLink, o
significado dos bits depende da função:
Significado dos bits para as funções Valor Atual e Valor de Arquivo
Bit Propósito
1° Mostra o horário na coluna à esquerda do
valor
2° Mostra o horário na linha acima do valor
Significado dos bits nas demais funções do PI DataLink
Bit Propósito
1° Mostrar horário
2° Orienta os dados em linhas ao invés de
colunas
3° Mostrar percentual bom
4° Ocultar contagem
5° Mostrar status extendido
6° Mostrar anotações
7° 1 Mostrar hora inicial
8° 1 Mostrar hora final
9° 1 Mostrar hora min/max
1
Requer que o 1° bit também esteja habilitado
Com um argumento OutCode igual a 0, a função retorna o valor com orientação em coluna
sem dados adicionais. Para calcular o argumento OutCode use a seguinte fórmula:
70
Por exemplo, com um argumento OutCode igual a 0, a função PISampDat() retorna os

valores amostrados na célula de saída especificada.. Com um argumento OutCode igual a 1,
a função retorna os horários na coluna um e os valores amostrados na coluna dois de uma
matriz n x 2. Com um argumento OutCode igual a 3, a função retorna os horários na linha
um e os valores amostrados na linha dois de uma matriz 2 x n. (nesses resultados, n é o
número de eventos amostrados.)
Observação: As funções suportam bits diferentes e, portanto, diferentes valores de

argumento OutCode. Aqueles válidos para uma função não são necessáriamente
válidos para outras funções. Veja na referência de funções (página 97) os bits
que cada função suporta na sua especificação de OutCode.
EXEMPLO
Suponha que você queira que a função Dados Calculados exiba o percentual bom, a hora
inicial e a hora de mínimo/máximo. Para exibir a hora inicial e a hora de mínimo/máximo,
você deve habilitar o bit mostrar-horário. Para calcular o argumento OutCode:
Na barra de fórmulas do Excel, entre:

=PICalcDat("sinusoid","y","t","1h","minimum", 1, 325,"piserver")

Tópicos avançados
Observação: Se um argumento OutCode especifica a exibição de várias colunas ou

linhas mas elas não forem exibidas na planilha, clique com o botão da direita na
matriz de funções e escolha Recalcular/Redimensionar para reescrever a matriz
de funções.
72
Funções para gravar dados
Funções para gravar dados

Diferente das funções padrão do PI DataLink, que recuperam dados de um PI Server ou PI
AF Server, as funções PIPutVal() e PIPutValX() (página 131) gravam um valor de
uma planilha em um PI Server ou PI AF Server. Essas funções podem substituir valores
existentes por novos valores, fornecidos pelo usuário, que tenham horários correspondentes.
As funções PIPutVal() e PIPutValX() são funções de macro do Excel. Você pode
executar as funções PIPutVal() ou PIPutValX() a partir de uma folha de macro do
Excel 4.0, ou em VBA usando o método application.run. Veja o módulo
putval_code no arquivo piexam32.xls distribuído com o PI DataLink para Excel 32-
bit e no arquivo piexam64.xls distribuído com o PI DataLink para Excel 64-bit. Em
particular, veja as tags marcadas PutVal e o módulo VBA PutVal_code para um
exemplo de um módulo VBA usado para entrar funções PI DataLink em uma planilha.
Note que o VBA não reconhece as funções PI DataLink, mas você pode formular a função
como uma string de texto, e então definir a propriedade fórmula de matriz de um intervalo de
células para o valor da string. O código VBA pode então verificar os valores das células para
encontrar os resultados das funções PI DataLink. Isso produz o mesmo resultado que a
entrada manual de funções PI DataLink no mesmo intervalo de células.

Capítulo 6
Funções Tag
Um ponto do PI é um fluxo de dados em tempo real de uma fonte definida. Atributos de
pontos, incluindo o tag (isso é, o nome do ponto do PI) e a fonte do ponto, descrevem um
ponto do PI.
Use as funções de tag do PI DataLink para encontrar tags que correspondam a IDs de pontos
do PI ou outros atributos do ponto. Você pode encontrar funções de tag na guia PI DataLink
no grupo Funções Tag.
Observação: Você deve ativar o suplemento PI DataLink (Legado) para usar essas
funções (veja Microsoft Excel: configuração de suplementos (página 6)).
Veja também...
• Visão Geral das funções do PI DataLink (página 13)
• Função Propriedades (página 51)
• Tendências (página 79)

Funções Tag
Função Point ID para Tag

A função Point ID para Tag retorna o tag que corresponde a um ID de ponto do PI específico.
Entrada Descrição
PI Server O PI Server de onde a função irá retornar os dados. Se você não selecionar
um servidor ou deixar o campo em branco, a função procurará no PI Server
padrão.
Point ID(s) Um ou mais IDs de pontos para os quais você deseja que a função retorne
tags. Requerido.
especificada.
• PIPointIDToTag() (página 127)
Exemplo de Point ID para Tag
Para ver o tag que corresponde a um ID de ponto do PI, defina as seguintes entradas para uma
função Pont ID para tag:
Entrada Valor
ID do ponto A5 (uma célula que contém um ID de ponto)
Nesse caso, 1 é o ID do ponto e SINUSOID pe o tag retornado.
Função Máscara de Atributo para Tag

A função Máscara de Atributo para Tag retorna tags que correspondem a um ou mais valores
de pontos do PI específicos.
76
Função Máscara de Atributo para Tag
Entrada Descrição
padrão.
Tagname(s) Valor do atributo do ponto do PI para o qual a função encontra o tag
correspondente. Você deve entrar um valor em pelo menos uma entrada. Use
Descritor o caracter curinga (*) para encontrar todas as correspondências ou
Point source correspondências limitadas a caracteres especificados. Por exemplo, entre S*
em Point source para encontrar qualquer tag com uma fonte de ponto igual a
Point type "S" ou uma fonte de ponto que comece com "S".
Point class
Engineering units
especificada.
• PIAttributeMaskToTag () (página 127)
Exemplo Máscara de Atributo para Tag
Para ver os tags que tem um nome que começa com "BA" e tipo "Float32", defina as
seguintes entradas para a função Máscara de Atributo para Tag:
Entrada Valor
Nome de tag BA*
Tipo de ponto Float32

Funções Tag
Observe que strings de atributos devem corresponder a valores de atributos no PI Server, e

que curingas podem ser usados.
Pesquisar tags
Para funções de informação de tags, use a janela Pesquisar Tag para pesquisar no PI Server
por IDs de pontos ou tags a serem inseridos no painel de tarefas.
Procedimento
1. No painel de tarefas, clique em próximo dos campos ID(s) de ponto(s) ou Nome(s)

de Tag(s).
2. Na janela Pesquisar Tag, clique na guia apropriada para a sua pesquisa:
ο Pesquisa Básica
Use para criar uma máscara a partir de atributos de pontos do PI especificados e
pesquisar por tags que tenham valores de atributos correspondentes.
ο Pesquisa Avançada
Use para construir uma consulta para uma pesquisa complexa que envolva mais
atributos de pontos do que na pesquisa básica.
ο Pesquisa de Alias
Use para selecionar tags pelos seus apelidos descritivos no PI Module Database.
3. Entre um critério de pesquisa.
Use os caracteres curinga "*" e "?", como apropriado. Por exemplo, a Máscara de Tag
Tem* retorna todos os nomes de pontos que começam com Tem, mas Tem? retorna
somente pontos que começam com Tem e terminam com um outro caracter único. Todos
os campos de pesquisa ignoram maiúsculas e minúsculas.
4. Se desejado, clique em Favoritos para acessar pesquisas anteriores
5. Clique em Pesquisar para encontrar .tags que correspondam aos critérios especificados.
6. Selecione o tag desejado no painel de Resultados, e clique em OK para inserir o valor no
painel de tarefas.
Se você selecionar múltiplos tags, o PI DataLink cola somente o primeiro tag no painel
de tarefas.
78
Capítulo 7
Tendências
O PI DataLink versão 32-bit para Microsoft Office inclui um objeto ActiveX de tendência.
Você pode inserir uma tendência em uma planilha para visualmente descrever mudanças nos
valores dos eventos ao longo do tempo. Tendências podem descrever dados das planilhas or
de pontos do PI selecionados.
Criar uma tendência

Uma tendência inclui uma ou mais linhas, que visualmente descrevem um conjunto de
valores. Use o Assistente de Suplemento Tendência para inserir e configurar tendências.
Procedimento
1. Em uma planilha, clique na célula onde você deseja colocar o canto superior esquerdo da
tendência.
Quando selecionando uma célula, lembre-se que, por padrão, uma tendência requer
aproximadamente 14 por 8 células padrão.

Tendências
2. Na guia PI DataLink, no grupo Funções Tag, clique em Inserir Tendência para abrir o
Assistente de Suplemento Tendência.
3. Defina uma ou mais linhas a serem incluídas na tendência. Você pode:
ο Criar uma linha com valores da planilha (página 81).
ο Criar linhas de valores de pontos do PI recuperados de um PI Server (página 82).
4. Ajustar a aparência das linhas em uma tendência. Você pode:
ο Marcar a caixa de verificação na coluna Marcadores para incluir marcadores que
indicam a localização dos pontos de dados arquivados.
Observação: As linhas são traçadas em cores diferentes. Por padrão a tendência
inclui também marcadores sem cor para diferenciar as linhas em monitores
monocromáticos. Marcadores sem cor são separados regularmente ao longo da linha
e não indicam pontos de dados arquivados.
ο Selecione uma linha e, então, use os botões de seta para mover a linha para cima ou
para baixo na legenda.
ο Selecione uma linha e, então, clique em X para remover a linha.
ο Clique em X Todos para remover todas as linhas.
ο Selecione uma linha e, então, clique em Renomear para renomear a linha.
5. Clique em Próximo.
6. Se alguma das linhas na tendência contém valores de pontos do PI recuperados de um PI
Server, especifique o período de tempo para recuperar os valores.
a. Especifique o início do período no campo Hora Inicial e o término do período no
campo Hora Final. Você pode:
− Selecione uma string de horário da lista.
− Digite um valor de tempo no campo.
− Clique para mudar o campo para um campo de referência de dados, e então
clique na célula da planilha que contém uma string de tempo ou digite o endereço
nessa célula de planilha.
Veja Horário do PI (página 61) para uma discussão sobre strings de tempo válidas.
b. Selecione a caixa de verificação Permitir Atualizações para atualizar a tendência
com novos dados do PI Server se o período de tempo muda ou se estende até o
momento presente.
7. Clique em Próximo.
80
Criar uma tendência
8. Especifique o título e a localização da tendência:

a. No campo Título da Tendência , digite um título para a tendência.
b. Limpe a caixa de verificação Mostrar Valores dos Atributos se você não quer que
os valores dos atributos apareçam nas linhas de tendência.
Ícones aparecem quando os dados contêm eventos que tem os bits Questionável,
Substituído, ou Anotado ligados.
c. Se desejado, especifique uma localização diferente para a tendência. Você pode
selecionar:
− Nova planilha para colocar a tendência no canto superior esquerdo de uma nova
planilha.
− Planilha existente para colocar a tendência na planilha atual começando na
célula especificada.
Se você mudar a célula, tenha certeza que a nova célula não contém dados..
9. Clique em Terminar.
Criar uma linha com valores da planilha.
Quando criando uma tendência com o Assistente de Suplemento Tendência, você pode
definir uma linha para a tendência com valores da planilha.
Procedimento
1. No Assistente de Suplemento Tendência, clique em Dados na planilha.
2. Clique no campo Intervalo de Células contendo dados, e então selecione o intervalo de
células da planilha que contém os valores.
3. Especifique as opções apropriadas para especificar o intervalo de células.
ο Marque a caixa de verificação Primeiro elemento é o nome da linha para usar o
valor de uma célula adjacente como nome da linha. (Se o intervalo de células é uma
coluna, então o nome da linha está na célula acima do primeiro valor; se o intervalo
de células é uma linha, então o nome da linha está na célula à esquerda do primeiro
valor.)
ο Marque a caixa de verificação Incluir todas as células na matriz para incluir todas
as células de uma matriz de funções no intervalo de células. Se você marcar essa
caixa de verificação, o campo Intervalo de Células contendo dados pecisa
especificar somente uma célula na matriz de funções.
ο Marque a caixa de verificação Degrau para desenhar uma tendência em degrau ao
invés de uma tendência contínua. Você pode selecionar essa caixa de verificação para
pontos do PI que armazenam valores discretos.
4. Clique em Adicionar para inserir uma linha na tendência.

Tendências
Criar uma linha com valores de pontos do PI recuperados de um PI Server
Quando criando uma tendência com o Assistente de Suplemento Tendência, você pode
definir uma linha para a tendência com valores retornados de um PI Server.
Procedimento
1. No Assistente de Suplemento Tendência, clique em Dados do PI.
2. No campo Nome do Tag, especifique o nome de umponto do PI do qual você deseja
recuperar valores. Você pode:
ο Digitar o nome do ponto.
ο Clicar no campo e então selecionar as células da planilha que contêm nomes de
pontos.
ο Clique para abrir a janela Pesquisar Tag, que você pode usar para pesquisar
tags (página 78).
3. No campo Nome do servidor, especifique o PI Server que armazena os valores para o
ponto. Você pode:
ο Selecionar o servidor de uma lista.
ο Clique para mudar o campo para um campo de referência de dados, e então
clique na célula da planilha que contém um um servidor ou digite o endereço nessa
célula de planilha.
4. Clique em Adicionar para inserir uma linha na tendência.
Menu de atalhos de Tendências

Use o menu de atalhos de tendência para atualizar, editar, ou gerenciar uma tendência
inserida em uma planilha. Clique com o botão direito em uma tendência para abrir um menu
com diversos comandos.
• Alterar Escala
Abre a janela Alterar Escala para mudar a escala do eixo-x ou do eixo-y.
• Reverter
Desfaz todas as alterações e reverte para as configurações originais de tendência
definidas no Assistente do Suplemento Tendência.
• Barra de Rolagem
Habilita uma barra de rolagem em baixo da tendência para rolar a exibição através de
períodos adjacentes de tempo.
• Formatar
Abre a janela Propriedades de Controle do PI Trend para editar a aparência de linhas
individuais ou da tendência como um todo. Você pode mudar a cor ou espessura de uma
linha, ou adicionar itens de legenda a uma tendência.
82
Menu de atalhos de Tendências
• Definir Tendência
Abre a página de definição de tendência no assistente de tendência para atualizar ou
alterar as linhas.
• Definir Intervalo de Tempo da Tendência
Abre a página de definição do intervalo de tempo no assistente de tendência para
atualizar o intervalo de tempo.
• Excluir Tendência
Remove uma tendência da planilha.
Observação: Você não pode restaurar uma tendência excluída, você pode somente
recriá-la.
• Exportar Dados
Abre a janela Exportar Dados para colar os valores da tendência em linhas ou colunas
da planilha. Você também pode exportar os nomes das linhas como cabeçalhos.
• Mover/Redimensionar
Abre a janela Mover/Redimensionar para mover o canto superior esquerdo da tendência
para uma célula específica. Entre um intervalo de células para redimensionar a tendência.
• Copiar/Colar
Abre a janela Copiar/Colar para colar uma cópia da tendência em uma célula
específica.

Capítulo 8
Objetos do PI Module Database

Os tópicos nessa seção descrevem as ferramentas que o PI DataLink dispõe para acessar
objetos do PI Module Database. Você pode encontrar essas ferramentas na guia PI DataLink
no grupo Module Database. Veja a documentação do PI Server para informações adicionais
sobre Module Databases e configuração.
O PI Module Database e as planilhas

O PI Module Database é uma estrutura hierárquica em árvore baseada no conteúdo de um PI
Server. O PI Module Database proporciona uma forma completamente diferente de construir
a infraestrutura de uma planilha. Se o Module Database do seu PI Server está configurado e
inclui objetos que representam os tags que você deseja usar, suas planilhas poderão ser mais
fáceis de construir e proporcionarão maior flexibilidade e potencial para reuso.
O PI Module Database é tipicamente configurado pelo seu administrador de sistema ou do PI,
e armazena apelidos e propriedades que se referem a pontos do PI e seus atributos,
respectivamente. A estrutura hierárquica desses objetos proporciona um contexto relacional
entre os pontos.
Por exemplo, você pode ter cinco pontos do PI que representam os níveis de cinco tanques
individuais e identicos. Cada ponto tem um nome de tag diferente e representa um objeto
físico diferente, mas a sua utilização e seus requisitos de monitoramento são os mesmos.
Recuperando os objetos do Module Database, você pode criar uma única planilha construída
em cima dos apelidos e propriedades que representam os cinco tanques. As funções do
Module Database resolvem esses objetos em nomes de tags e valores de atributos. Caminhos
de módulo paralelos para cada tanque proporcionam contextos diferentes para as referências
dos apelidos.
Com esse tipo de estrutura, você pode usar a mesma planilha para alternar entre visões de
múltipos ativos. Por exemplo, quando você selecionar o nome de qualquer dos cinco tanques
em uma célula de planilha, o mapeamento de apelidos para os pontos do PI correspondentes
permite que as funções do PI DataLink recuperem os valores para o tanque apropriado.

Inserir objetos do PI Module Database na sua planilha.

Use a janela Navegar Módulo para navegar por apelidos do PI, propriedades e caminhos de
módulo no PI Module Database. Você pode selecionar esses itens e copiá-los diretamente
para uma planilha.
Observação: Aliases e propriedades que correspondem a pontos do PI devem ser

configurados no seu PI Module Database para usar as funções Module Database
no PI DataLink.
Procedimento
1. Selecione uma célula e, então, na guia PI DataLink clique em Navegar Módulo para
abrir a janela Navegar Módulo.
2. Selecione o tipo de objeto que você está procurando:
ο Alias
ο Propriedade
ο Módulo
3. Da lista de PI Server, selecione o PI Server conectado que contém o Module Database
que você deseja navegar.
4. Da lista Query date, especifique a data e hora de efetividade da hierarquia do Module
Database que você quer ver.
5. Navegue a árvore da hierarquia para encontrar o item desejado.
6. Selecione um item ou uma coleção de objetos-pai que você quer copiar para a planilha.
ο Selecione um item para copiar para a planilha.
ο Selecione um objeto-pai (Apelidos ou Prooriedades) em um módulo para copiar
todos os aliases ou propriedades daquele módulo para a planilha.
7. Marque a caixa de verificação Copiar caminho do módulo para copiar o caminho
completo do módulo do alias ou propriedade para uma célula da planilha adjacente.
O caminho do módulo proporciona um contexto para o objeto selecionado.
Observação: Se a configuração (consulte "Gerenciar configurações de preferência"

na página 23) Copiar nome do PI Server estiver habilitada, o PI DataLink
copiará também o nome do PI Server correspondente.
8. Clique OK para copiar os itens selecionados para a planilha e fechar a janela.
86
Funções Module Database

Use as funções Module Database do PI DataLink para encontrar os tags que correspondem a
apelidos e propriedades em uma árvore do Module Database. Essas funções usam o caminho
de módulo. Você pode entrar um caminho de módulo como um argumento de função ou
referenciá-lo em uma célula de planilha. Você pode encontrar funções Module Database na
guia PI DataLink no grupo Module Database.
Observação: A função não pode resolver um objeto apelido ou propriedade em um tag

sem um caminho de módulo. O caminho fornece o contexto que mapeia o apelido
para um ponto do PI específico.
Veja também Visão Geral das funções do PI DataLink (página 13).
Função Alias para Tag
A função Apelido para Tag retorna o tag do PI que corresponde a um apelido do PI

especificado.
Opção Descrição
padrão.
Alias(s) Um apelido no PI Module Database Requerido.
Caminho do O caminho do módulo no PI Module Database onde o apelido especificado
módulo pode ser encontrado. Se você especificar o Alias navegando pelo Module
Database, então o PI DataLink entra o Caminho do módulo
automaticamente. Requerido.
Data da consulta Uma data de efetividade do apelido. O PI DataLink retorna a tag que
corresponde ao apelido especificado nessa data. Requerido.
especificada.
Sem servidor Escolha para retornar somente o tag do PI.
Servidor à direita Escolha para exibir o PI Server que armazena o tagt em uma célula à direita
do tag.
Servidor abaixo Escolha para exibir o PI Server que armazena o tagt em uma célula abaixo do
tag.

• PIAliasToTag() (página 128)
Função Propriedade para Valor
A função Propriedade para Valor retorna o valor ou valores correspondentes a uma

propriedade do módulo do PI especificada.
O PI DataLink pode retornar valores para os tipos de propriedade Boolean, Date, Double,
Integer, Long, Null, Single, e String, ou Double, Integer, Long, and Single para tipos de
propriedade de matriz.
Opção Descrição
padrão.
Propriedade(s) Uma propriedade do módulo do PI no PI Module Database. Requerido.
Caminho do O caminho do módulo no PI Module Database onde a propriedade
módulo especificada pode ser encontrada. Se você especificar Propriedade
navegando pelo Module Database, então o PI DataLink entra o Caminho do
módulo automaticamente. Requerido.
Data da consulta Uma data de efetividade da propriedade do módulo do PI. O PI DataLink
retorna a tag que corresponde à propriedade especificada nessa data.
Requerido.
especificada.
• PIPropertyToValue() (página 129)
88
Capítulo 9
Notificações
O PI DataLink inclui o suplemento PI DataLink Notifications. Quando ativado, esse
suplemento adiciona a função Pesquisar Notificação à guia PI DataLink. Use a função
Pesquisar Notificação para recuperar notificações do PI Server que você subscreve e para
inserir essas notificações nas planilhas.
O suplemento PI DadaLink Notifications executa no sistema operacional Windows XP ou
posterior, e requer o Excel 2007 SP3 ou posterior. O PI Notifications deve estar instalado no
computador para ativar esse suplemento (veja Microsoft Excel: configuração de suplementos
(página 6)).
Observação: Você deve ter uma conta em pelo menos um PI AF 2.0 Server com PI
Notifications 1.0, e ter subscrito pelo menos uma regra de notificação para
receber notificações. Para informações adicionais sobre o PI Notifications, veja o
PI Notifications User Guide.
Para acessar a função Pesquisar Notificação, clique na célula de saída desejada e, então, na
guia PI DataLink (no grupo Notificações), clique Pesquisar Notificação para abrir a janela
Pesquisar Notificação.

Notificações
Pesquisar e inserir notificações

Use a janela Pesquisar Notificação para pesquisar notificações que você subscreveu em um
determinado PI AF Server e então inseri-la na planilha. O PI AF Server contém um banco de
dados de elementos estruturais e eventos de notificação que ajudam você a trabalhar com
dados no seu PI Server.
Procedimento
1. Na guia PI DataLink, no grupo Notificações, clique em Pesquisar Notificação para
abrir a janela Pesquisar Notificação.
2. na guia Pesquisar, selecione o PI AF Server onde você pesquisará notificações:
ο Da list PI Systems, selecione um PI AF Server e clique em Conectar para conectar a
esse servidor.
Se necessário clique em Mostrar Lista para abrir a janela AF Servers, onde

você pode adicionar um PI AF Server (página 91) à lista.
ο Clique e então clique em uma célula de planilha que contenha o nome de um PI

AF Server.
Clique novamente no botão para mostrar a lista de PI Systems.
3. Na lista Ver Notificações, selecione a opção para filtrar as notificações retornadas:
ο Selecione Ativa para retornar todas as notificações que estão atualmente ativas.
ο Selecione Intervalo de Tempo e entre valores de Hora Inicial e Hora Final para
retornar notificações que ocorreram em um intervalo específico de tempo.
ο Selecione Recente e entre um valor e um intervalo de tempo para retornar a
notificação mais recente em um intervalo de tempo específico.
90
Pesquisar e inserir notificações
4. No campo Célula de Sáida, especifique a célula de planilha onde você deseja inserir as
notificações.
5. Clique em Pesquisar para recuperar as notificações que correspondem aos critérios
especificados na área de resultados na parte de baixo da guia.
6. Examine as notificações recuperadas. Você pode:
ο Ajustar a exibição das notificações recuperadas (página 92)
ο Gerenciar as notificações recuperadas (página 92)
7. Clique OK para inserir os itens exibidos na planilha e fechar a janela.
O PI DataLink insere a consulta de notificação na planilha como uma matriz de funções
no local indicado. Assim como outras funções do PI DataLink, a função Perquisar
Notificação atualiza os dados quando a planilha recalcula (página 58).
Adiionar um PI AF Server à função Pesquisar Notificação
Seu PI System pode ter múltiplos PI AF Servers, cada um dos quais pode ter instalado o PI
Notifications e ser uma fonte de notificações relevantes. por exemplo, você pode subscrever
notificações dos PI AF Server que são executados em diferentes fábricas ou representam
diferentes unidades de negócio.
Antes que você possa ver as notificações de um determinado PI AF Server no Excel, você
deve adicionar esse PI AF Server à lista de PI Systems que a função Pesquisar Notificação
mantém.
Antes de iniciar
Subscreva notificações no PI System Explorer.
Procedimento
1. Na guia Pesquisar da janela Pesquisar Notificação, clique em Mostrar Lista

próximo da lista PI Systems para abrir a janela AF Servers.

Notificações
2. Clique em Adicionar AF Server para abrir a janela Propriedades do AF Server.

3. Entre as informações de rede relevantes para localizar o PI AF Server e autenticar seu
computador naquele servidor.
ο No campo Nome, entre o nome que irá identificar o PI AF Server na função
Perquisar Notificações.
ο Clique Configurar Active Directory para configurar o acesso ao Active Directory
para coletar informações de login.
4. Clique OK para salvar as propriedades e adicionar à lista de PI AF Servers.
5. Clique em OK para fechar a janela AF Servers.
O PI AF Server aparecerá na lista PI Systems.
Para informações adicionais sobre PI AF Servers, consulte a documentação do PI AF.
Ajustar a exibição das notificações recuperadas
Na janela Pesquisar Notificação, a área de resultados na parte inferior da guia Pesquisar

mostra as notificações que correspondem ao critério de pesquisa especificado. Você pode
ajustar a exibição dessas notificações.
Procedimento
• Clique em um cabeçalho de coluna para classificar as notificações por um atributo
particular.
• Clique com o botão da direita nos resultados para mostrar e esconder colunas.
ο Clique em Expandir Tudo ou em Recolher Tudo para expandir ou recolher um
agrupamento de notificações.
ο Clique em Mostrar Eventos de Contato para alternar a exibição de eventos de
contato para cada notificação.
Gerenciar as notificações recuperadas
Na janela Pesquisar Notificação, a área de resultados na parte inferior da guia Pesquisar

mostra as notificações que correspondem ao critério de pesquisa especificado. Antes de
inserir as notificações recuperadas na sua planilha, você pode avaliar, gerenciar e responder a
essas notificações.
Procedimento
Clique com o botão direito em uma notificação e escolha um comando:
• Reconhecer Instância
Reconhece que uma ação foi tomada em relação à notificação e que não é necessário
escalamento adicional. Se desejado, entre um comentário e clique em OK.
92
Notificações inseridas
• Reconhecer Subscrição
Reconheça o recebimento de uma notificação que você subscreveu. Se desejado, entre um
comentário e clique em OK.
• Adicionar Comentário
Comente uma notificação.
• Ver Sumário da Regra de Notificação
Exibe as propriedades da regra de notificação que disparou a notificação selecionada.
Notificações inseridas
As funções do PI DataLink podem referenciar dados de notificações em células de planilhas.
Por exemplo, você pode usar o valor da Hora Inicial de uma notificação recuperada
para recuperar dados amostrados que indicam o progresso de um processo em lotes.
Se suas notificações estão configuradas para exibir reconhecimentos, essas colunas incluem
atalhos para páginas web PI Notifications onde você pode reconhecer ou comentar a respeito
de uma notificação.
Para informações adicionais sobre notificações, subscrições e reconhecimentos, veja o PI
Notifications User Guide.

Notificações
Configurações de exibição de notificações

Use a guia Formato de Exibição na janela Pesquisar Notificação para especificar a
aparência das notificações inseridas nas células da planilha. Você pode selecionar as colunas
a serem exibidas e mudas sua organização e formato.
Colunas
• Selecione colunas na lista Colunas disponíveis e clique em Adicionar para movê-las
para a lista Ordem das colunas, que especifica os dados inseridos na planilha.
Observação: Inclua a coluna Reconhecimento para adicionar um atalho na

planilha para reconhecer o recebimento de uma notificação, e inclua a coluna
Reconhecimento com comentários para adicionar um atalho na planilha
para comentar uma notificação.
• Clique Adicionar Tudo para mover todas as colunas para a lista Ordem das colunas.
• Selecione colunas da lista Ordem das colunas e clique os botões de seta acima da lista
para mudar a ordem das colunas.
• Selecione coluas da lista Ordem das colunas e clique Remover para remover as colunas
selecionadas da lista.
• Clique Limpar para remover todas as colunas da lista Ordem das colunas.
94
Configurações de exibição de notificações
Eventos de contato
• Selecione a caixa de verificação Exibir eventos de contato para incluir eventos de
contato relacionados com cada notificação, como enviando para cada recebedor,
comentários e reconhecimentos.
• Selecione a caixa de verificação Deslocar contatos para deslocar os eventos de contato
na planilha. Isso ajudará você a identificá-los.
ο Selecione Usando colunas separadas para adicionar uma segunda coluna para os
eventos de contato.
ο Selecione Formatando células para deslocar os eventos de contato na mesma coluna
dos eventos de notificação.
• Selecione a caixa de verificação Agrupar notificações com o agrupamento do Excel
para usar o recurso de agrupamento do Excel para aninhar eventos de contato abaixo da
notificação-pai individual que os causou.
Observação: O PI DataLink Server (página 2) não suporta o agrupamento do Excel.
Exibição e orientação
• Selecione a caixa de verificação Exibir cabeçalhos de colunas para adicionar cabeçalhos
aos dados de notificações.
• Selecione a caixa de verificação Exibir contagem para adicionar uma linha ou coluna
que contenha a contagem de notificações antes dos dados das notificações.
• Abaixo de Orientar resultados em, selecione Colunas para exibir os dados de
notificações em colunas ou selecione Linhas para exibir os dados de notificações em
linhas.

Anexo A
Referência de função
Você pode gerar funções PI DataLink a partir dos painéis de tarefas (página 13) do PI
DataLink. A matriz de funções resultante dependerá das entradas. Você pode também entrar
com essas funções diretamente (página 68) na barra de fórmulas do Excel.
Essa seção contém uma referência para as funções suportadas pelo PI DataLink. Cada topico
descreve a sintaxe e os argumentos da função; a maioria dos tópicos também inclui um
exemplo. As seções a seguir agrupam as funções por tipo.
Funções de valores únicos

Funções de valores únicos recuperam o valor de um item de dados em um horário
estabelecido. Elas retornam exatamente um valor por item de dados.
PICurrVal()
Retorna o valor atual de um ponto do PI de um instantâneo ou um atributo PI AF de um

banco de dados.
SINTAXE
PICurrVal(DataItem, OutCode, RootPath)
ARGUMENTOS
Argumento Descrição
DataItem O nome do ponto do PI ou do atributo do PI AF para o qual a função

(string) retorna um valor. Referencie 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.
OutCode Um código de saída que determina que dados adicionais a função
(integer) retornará e como a função orienta a saída. Veja Códigos de Saída
(página 69) para informações sobre como calcular o código. Essa
função suporta bits 1 e 2.
RootPath O caminho para o item de dados Veja Itens de dados (página 14).
(string)

Exemplo
A função seguinte retorna o valor atual e horário correspondente para o ponto do PI let439
do PI Server chamado holden e coloca o horário na coluna à esquerda do valor:
=PICurrVal("let439",1,"holden")
• Função Valor Atual (página 31)
• Definir funções manualmente (página 68)
• Orientações para entrada manual de argumentos (página 68)
PIArcVal()
Retorna o valor de um ponto do PI ou atributo do PI AF em um horário especificado.
SINTAXE
PIArcVal(DataItem, TimeStamp, OutCode, RootPath, Mode)
ARGUMENTOS
DataItem (string) O nome do ponto do PI ou do atributo do PI AF para o qual a
função retorna um valor. Referencie um intervalo de células que
contém nomes de pontos do PI ou de atributos do PI AF para os
TimeStamp (string) O horário para o qual a função retorna valores. Veja Entrada de
tempo (página 16).
OutCode (integer) Um código de saída que determina que dados adicionais a função
retornará e como a função orienta a saída. Veja Códigos de Saída
RootPath (string) O caminho para o item de dados Veja Itens de dados (página 14).
Mode (string) O método usado pela função para recuperar os valores:
previous
somente anterior
interpolado
auto
próximo
somente próximo
horário exato
EXEMPLO
A função seguinte retorna o valor interpolado do ponto do PI cdep158 às 19:20 de 11 de
Dezembro de 1992 do PI Server chamado casaba:
=PIArcVal("cdep158","11-dez-92 19:20",0, "casaba","interpolated")
98
Funções de valores únicos
• Função Valor de Arquivo (página 32)
PIExpVal()
Retorna o valor calculado de uma Performance Equation em um horário especificado.
SINTAXE
PIExpVal(Expression, TimeStamp, OutCode, RootPath)
ARGUMENTOS
Expression (string) 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.
TimeStamp (string) O horário para o qual a função retorna valores. Veja Entrada de
tempo (página 16).
OutCode (string) Um código de saída que determina que dados adicionais a
função retornará e como a função orienta a saída. Veja Códigos
de Saída (página 69) para informações sobre como calcular o
código. Essa função suporta bits 1 e 2.
RootPath (string) O caminho para o item de dados referenciado pela expressão.
EXEMPLO
A função seguinte calcula a raiz quadrada do valor do ponto do PI sinusoid de um PI
Server chamado thevax à meia-noite de ontem:
=PIExpVal("sqr('sinusoid')","y",0,"thevax")
• Função Valor de Arquivo (página 32)

PITagAtt()
Retorna o valor de uma propriedade associada com um item de dados especificado.
SINTAXE
PITagAtt(DataItem, Property, RootPath)
ARGUMENTOS
função retorna um valor. Referencie um intervalo de células que
Property (string) O nome do ponto do PI ou do atributo do PI AF para o qual a
função retorna um valor.
EXEMPLO
A função seguinte retorna as unidades de engenharia para o ponto do PI especificado na
célula D1 do PI Server padrão:
=PITagAtt(d1,"uom",)
• Função Propriedades (página 51)
Funções de valores múltiplos

Funções de valores múltiplos associam um ponto do PI ou atributo do PI AF com um período
de tempo durante o qual podem haver um ou mais valores correspondentes.
100
PINCompDat()
Retorna um número específico de valores de pontos do PI ou valores de atributos do PI AF

começando em um horário determinado.
SINTAXE
PINCompDat(DataItem, STime, NumVals, OutCode, RootPath, Mode)
ARGUMENTOS

função retorna valores. Referencie um intervalo de células que
STime (string) O início do período de tempo para o qual a função retorna valores.
Veja Entrada de tempo (página 16).
NumVals (integer) O número de valores que a função retorna, começando em STime
(especifique um número negativo para recuperar valores
anteriores no tempo).
função suporta bits 1, 2, 5 e 6.
Mode (string) O método usado pela função para determinar quais valores serão
recuperados próximo da hora inicial (tipo de limite):
inside
fora
interpolado
auto
EXEMPLO
A função seguinte retorna dez valores e horários correspondentes do PI Server padrão para o
ponto do PI cdf144 começando à 01:00 hora dessa manhã, usando o tipo de limite "inside":
=PINCompDat("cdf144","1:00:00",10,1,,"inside")
• Função Dados Compactados (página 35)

PINCompFilDat()
Retorna um número específico de valores de pontos do PI ou valores de atributos do PI AF,

filtrados, começando em um horário determinado.
SINTAXE
PINCompFilDat(DataItem, STime, NumVals, FiltExp, FiltCode,
OutCode, RootPath, Mode)
ARGUMENTOS
DataItem (string) O nome do ponto do PI ou do atributo do PI AF para o qual a função
retorna valores. Referencie 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.
NumVals (integer) O número de valores que a função retorna, começando em STime
(especifique um número negativo para recuperar valores anteriores
no tempo).
FiltExp (string) Uma Performance Equation lógica usada pela função para filtrar
valores. Quando o resultado da expressão é falso, a função exclui os
valores correspondentes. Veja Expressões de filtro (página 67).
FiltCode (integer) Um código que indica como rotular os valores filtrados:
1
Insere o rótulo Filtrado em lugar de um valor ou um bloco de
valores que a função filtrou da saída com base em FiltExp.
0
Não rotule os valores filtrados.
função suporta bits 1, 2, 5 e 6.
Mode (string) O método usado pela função para determinar quais valores serão
recuperados próximo da hora inicial (tipo de limite):
inside
fora
interpolado
auto
102
Exemplo
A função seguinte retorna dez valores e horários correspondentes do PI Server padrão para o
ponto do PI cdf144 começando às 02:00 dessa manhã, quando o tag cdep158 for maior
que 38, usando o tipo de limite "inside":
=PINCompFilDat("cdf144","2:00:00",10,"'cdep158'>38",1,1,,)
A saída conterá o rótulo Filtrado entre os valores onde a condição de filtragem for falsa.
• Expressões de Filtro (página 67)
PICompDat()
Retorna valores de pontos do PI ou atributos do PI AF armazenados durante um período

especificado de tempo.
SINTAXE
PICompDat(DataItem, STime, ETime, OutCode, RootPath, Mode)
ARGUMENTOS
STime (string) O início do período de tempo para o qual a função retorna
valores. Veja Entrada de tempo (página 16).
ETime (string) O final do período de tempo para o qual a função retorna
valores.
OutCode (integer) Um código de saída que determina que dados adicionais a
código. Essa função suporta bits 1, 2, 4, 5 e 6.
RootPath (string) O caminho para o item de dados Veja Itens de dados (página
14).
Mode (string) O método que a função usa para determinar quais valores serão
recuperados próximo do STime ou ETime (tipo de limite):
inside
fora
interpolado
auto

EXEMPLO
A função seguinte retorna valores e horários correspondentes do PI Server padrão para o
ponto do PI cdf144 de 01:00 às 03:00 dessa manhã usando o tipo de limite "inside":
=PICompDat("cdf144","1:00:00","3:00:00",1,,"inside")
PICompFilDat()
Retorna valores de pontos do PI ou atributos do PI AF, filtrados, armazenados durante um

período especificado de tempo.
SINTAXE
PICompFilDat(DataItem, STime, ETime, FiltExp, FiltCode, OutCode,
RootPath, Mode)
ARGUMENTOS
retorna valores. Referencie um intervalo de células que contém
retornados valores.
ETime (string) O final do período de tempo para o qual a função retorna valores.
valores. Quando o resultado da expressão é falso, a função exclui os
valores correspondentes. Veja Expressões de filtro (página 67).
FiltCode Um código que indica como rotular os valores filtrados:
(integer)
1
0
função suporta bits 1, 2, 4, 5 e 6.
104
Mode (string) O método que a função usa para determinar quais valores serão
recuperados próximo do STime ou ETime (tipo de limite):
inside
fora
interpolado
auto
EXEMPLO
A função seguinte retorna valores e horários correspondentes do PI Server padrão para o
ponto do PI cdf144 começando às 02:00 e terminando às 10:00 dessa manhã, quando o tag
cdep158 for maior que 38, usando o tipo de limite "inside":
=PICompFilDat("cdf144","2:00:00","10:00:00","'cdep158'>38",1,1,,)
A saída conterá o rótulo Filtrado entre os valores onde a condição de filtragem for falsa.
PISampDat()
Retorna valores interpolados, espaçados regularmente, para um ponto do PI ou atributo do PI

AF armazenados durante um período de tempo especificado.
SINTAXE
PISampDat(DataItem, STime, ETime, Interval, OutCode, RootPath)
ARGUMENTOS
DataItem O nome do ponto do PI ou do atributo do PI AF para o qual a função
(string) retorna valores. Referencie 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.
Interval O intervado entre os valores retornados. Entre um valor e uma unidade
(string) de tempo que especifica o tamanho do intervalo. Por exemplo, entre
15m (15 minutos) para retornar um valor para cada intervalo de 15
minutos durante o período de tempo. Veja Especificação de intervalo
de tempo (página 64).

OutCode Um código de saída que determina que dados adicionais a função
(integer) retornará e como a função orienta a saída. Veja Códigos de Saída
RootPath O caminho para o item de dados Veja Itens de dados (página 14).
(string)
EXEMPLO
A função seguinte retorna dados de amostragem e horários correspondentes para o ponto do
PI sinusoid no PI Server padrão, começando à meia-noite de ontem e terminando à meia-
noite de hoje, reportando valores em intervalos de 3 horas:
=PISampDat("sinusoid","y","t","3h",1,)
• Função Dados de Amostragem (página 39)
PISampFilDat()
Retorna valores interpolados, espaçados regularmente e filtrados, para um ponto do PI ou

atributo do PI AF armazenados durante um período de tempo especificado.
SINTAXE
PISampFilDat(DataItem, STime, ETime, Interval, FiltExp, FiltCode,
OutCode, RootPath)
ARGUMENTOS

Interval (string) O intervado entre os valores retornados. Entre um valor e uma
unidade de tempo que especifica o tamanho do intervalo. Por
exemplo, entre 15m (15 minutos) para retornar um valor para cada
intervalo de 15 minutos durante o período de tempo. Veja
Especificação de intervalo de tempo (página 64).
106
FiltCode (integer) Um código que indica como rotular os valores filtrados:

1
0
EXEMPLO
A função seguinte retorna dados amostrados para o ponto do PI sinusoid no PI Server
padrão. A função recupera valores à meia-noite, 01:00, 02:00, e 03:00 de 11-Jan-97. Se a
condição na célula A1 não for satisfeita em qualquer desses horários, a função retorna o
rótulo Filtrado nesse horário. A função mostra os horários na primeira coluna e os valores
na segunda coluna.
=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)
PIExpDat()
Retorna valores calculados, regularmente espaçados, de uma Performance Equation durante

um período especificado de tempo.
SINTAXE
PIExpDat(Expression, STime, ETime, Interval, OutCode, RootPath)
ARGUMENTOS
STime (string) O início do período de tempo para o qual a função calcula um valor.
ETime (string) O final do período de tempo para o qual a função calcula um valor.

EXEMPLO
A função seguinte calcula a raiz quadrada do valor do ponto do PI sinusoid recuperado de
um PI Server chamado thevax em intervalos de uma hora, iniciando à meia-noite de ontem
até a meia-noite de hoje:
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
A função exibe o horário para cada valor na coluna à esquerda do valor calculado.
PITimeDat()
Retorna valores reais ou de amostragem interpolada, de um ponto do PI ou atributo do PI AF

em horários especificados.
SINTAXE
PITimeDat(DataItem, TimeStamps, RootPath, Mode)
ARGUMENTOS
contém nomes de pontos do PI ou de atributos do PI AF para
os quais serão retornados valores.
TimeStamps (reference) Uma referência para uma ou mais células da planilha que
contém horários para os quais a função retorna valores. Veja
Entrada de tempo (página 16).
14).
Mode (string) O método usado pela função para recuperar dados:
interpolado
horário exato
108
RETORNA
Valores nos horários especificados, apresentados na mesma orientação dos horários de
referência. Se a referência de horário é uma linha, a função apresenta os valores em uma
linha. Se a referência de horário é uma coluna, a função apresenta os valores em uma coluna.
A orientação da matriz de saída deve corresponder à orientação da referência de horários.
EXEMPLO
A função seguinte recupera valores interpolados nos horários localizados nas células B1 a
B12 para o ponto do PI mytag no PI Server padrão:
=PITimeDat("mytag",b1:b12,,"interpolated")
Essa função requer uma matriz de saída horizontal com doze células, como C1:C12 ou
B14:B25.
• Função Dados Temporizados (página 41)
PITimeExpDat()
Retorna valores de uma Performance Equation em horários especificados.
SINTAXE
PITimeExpDat(Expression, TimeStamps, RootPath)
ARGUMENTOS
Referencie um intervalo de células que contém expressões
para as quais serão retornados valores.
TimeStamps (reference) Uma referência para uma ou mais células da planilha que
contém horários para os quais a função retorna valores. Veja
Entrada de tempo (página 16).
14).
RETORNA
Valores nos horários especificados, apresentados na mesma orientação dos horários de
referência. Se a referência de horário é uma linha, a função apresenta os valores em uma
linha. Se a referência de horário é uma coluna, a função apresenta os valores em uma coluna.
A orientação da matriz de saída deve corresponder à orientação da referência de horários.

EXEMPLO
A função seguinte calcula a raiz quadrada do valor do tag do PI sinusoid recuperado do PI
Server padrão nos horários especificados nas células B1 até B12.
=PITimeExpDat("sqr('sinusoid')",b1:b12,)
Essa função requer uma matriz de saída horizontal com doze células, como C1:C12 ou
B14:B25.
• Função Dados Temporizados (página 41)
Funções de cálculo
Funções de cálculo calculam valores a partir de valores de pontos do PI, atributos do PI AF,
ou avaliação de Performance Equations durante um período de tempo especificado.
PIAdvCalcVal()
Retorna o valor calculado para um ponto do PI ou valores de atributo do PI AF durante um

período de tempo especificado.
SINTAXE
PIAdvCalcVal(DataItem, STime, ETime, Mode, CalcBasis, MinPctGood,
CFactor, OutCode, RootPath)
ARGUMENTOS

calcula um valor. Referencie um intervalo de células que contém
retornados valores.
110
Mode (string) O tipo de cálculo que a função executa:

total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
CalcBasis (string) O método de cálculo:
time-weighted
peso de evento
MinPctGood O percentual mínimo de dados bons necessários durante o intervalo
(number) de tempo para calcular e retornar um valor.
CFactor (number) Um fator que a função aplica aos valores retornados. Digite 1 se um
fator de conversão não é necessário. Para cálculo de totais
ponderado no tempo, especifique um fator que converte os valores
da taxa gravada para a unidade de tempo padrão do servidor
(unidades por dia).
função suporta bits 2, 3, e 9 (se Modo for definido como mínimo,
máximo, ou intervalo).
EXEMPLO
A funcão seguinte retorna o total ponderado no tempo do ponto do PI cdf144 calculado a
partir dos valores no PI Server padrão de ontem até hoje:
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",50,1,4,)
A função multiplica o resultado por 1, e retorna um resultado somente se no mínimo 50 por
cento dos dados forem bons. A função retorna o porcentual bom à direita do total calculado.
• Função Dados Calculados (página 43)
PIAdvCalcFilVal()
Retorna o valor calculado para um ponto do PI ou valores de atributo do PI AF durante um

período de tempo especificado.

SINTAXE
PIAdvCalcFilVal(DataItem, STime, ETime, FiltExp, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)
ARGUMENTOS
função calcula um valor. Referencie um intervalo de células que
STime (string) O início do período de tempo para o qual a função calcula um
valor. Veja Entrada de tempo (página 16).
ETime (string) O final do período de tempo para o qual a função calcula um
valor.
valores. Quando o resultado da expressão é falso, a função
exclui os valores correspondentes. Veja Expressões de filtro
(página 67).
total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
SampMode (string) O método de amostragem usado pela função para determinar
quando avaliar FiltExp:
compactado
interpolado
SampFreq (string) A frequência na qual a função avalia FiltExp se SampMode for
definido como interpolado. Entre uma expressão de tempo do
PI (página 62) relativa. Por exemplo, defina para 10m (10
minutos) para retornar um valor interpolado para cada intervalo
de 10 minutos.
MinPctGood (number) O percentual mínimo de dados bons necessários durante o
intervalo de tempo para calcular e retornar um valor.
CFactor (number) Um fator que a função aplica aos valores retornados. Digite 1 se
um fator de conversão não é necessário. Para cálculo de totais
ponderado no tempo, especifique um fator que converte os
valores da taxa gravada para a unidade de tempo padrão do
servidor (unidades por dia).
112
código. Essa função suporta bits 2, 3, e 9 (se Modo for definido
como mínimo, máximo, ou intervalo).
14).
EXEMPLO
A função seguinte retorna o total ponderado no tempo para o ponto do PI cdf144 calculado
a partir dos valores do PI Server padrão, somando os valores de ontem até hoje durante o
período em que o ponto do PI cdm158 foi definido como Manual:
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total","t
ime-weighted","compressed","10m",50,1,4,)
A função multiplica o resultado por 1. Uma vez que o modo de amostragem é compactado,
a função ignora a frequência de amostragem e examina a função de filtragem nos eventos
compactados do ponto cdf144. A função retorna um resultado somente se no mínimo 50
por cento dos dados forem bons. A função retorna o porcentual bom à direita do total
calculado.

PIAdvCalcExpVal()
Retorna o valor calculado por uma Performance Equation durante um período especificado de
tempo.
SINTAXE
PIAdvCalcExpVal(Expression, STime, ETime, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)
ARGUMENTOS

total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
quando avaliar a Expressão:
compactada
interpolado
SampFreq (string) A frequência na qual a função avalia Expressão se SampMode for
PI (página 62) relativa. Por exemplo, defina para 10m (10 minutos)
para retornar um valor interpolado para cada intervalo de 10
minutos.
(unidades por dia).
114
EXEMPLO
A funcão seguinte retorna o total ponderado no tempo para a expressão 'cdf144'+''cdt158'
calculados a partir dos valores no PI Server padrão, usando valores de ontem até hoje:
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","time-
weighted","compressed","10m",50,1,4,)
A função multiplica o resultado por 1. Uma vez que o modo de amostragem é comprimido,
compactados combinados dos pontos cdf144 e cdt158. A função retorna um resultado
somente se no mínimo 50 por cento dos dados forem bons. A função retorna o porcentual
bom à direita do total calculado.

PIAdvCalcExpFilVal()
Retorna um valor de um ponto do PI calculado e filtrado baseado em uma Performance

Equation.
SINTAXE
PIAdvCalcExpFilVal(Expression, STime, ETime, FiltExp, Mode,
CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode,
RootPath)
ARGUMENTOS
total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
quando avaliar Expressão e FiltExp:
compactado
interpolado
SampFreq (string) A frequência na qual a função avalia Expressão e FiltExp se

SampMode for definido como interpolado. Entre um valor e
uma unidade de tempo. Por exemplo, defina para 10m (10
minutos) para retornar um valor interpolado para cada intervalo de
10 minutos. Veja Especificação de intervalo de tempo (página 64).
116
(unidades por dia).
EXEMPLO
A funcão seguinte retorna o total ponderado no tempo para a expressão 'cdf144'+''cdt158'
calculados a partir dos valores no PI Server padrão quando 'productid' = "Product2"
usando valores de ontem até hoje:
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
compactados combinados dos pontos cdf144 e cdt158. A função retorna um resultado
somente se no mínimo 50 por cento dos dados forem bons. A função retorna o porcentual
bom à direita do total calculado.

PIAdvCalcDat()
Retorna valores calculados espaçados regularmente para um ponto do PI ou valores de

atributo do PI AF durante um período de tempo especificado.
SINTAXE
PIAdvCalcDat(DataItem, STime, ETime, Interval, Mode, CalcBasis,
MinPctGood, CFactor, OutCode, RootPath)
ARGUMENTOS
calcula valores. Referencie um intervalo de células que contêm
calculados valores.
STime (string) O início do período de tempo para o qual a função calcula valores.
ETime (string) O final do período de tempo para o qual a função calcula valores.
total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
MinPctGood O percentual mínimo de dados bons necessários durante o intervalo
(number) de tempo para calcular e retornar um valor.
CFactor (number) Um fator que a função aplica aos valores retornados. Digite 1 se um
fator de conversão não é necessário. Para cálculo de totais
(unidades por dia).
função suporta bits 2, 3, 7, 8 e 9 (se Mode for definido como
minimum, maximum, ou range).
118
EXEMPLO
A funcão seguinte retorna o total ponderado no tempo do ponto do PI cdf144 calculado a
partir dos valores no PI Server padrão para intervalos de 3 horas de meia-noite de ontem até
meia-noite de hoje:
=PIAdvCalcDat("cdf144","y","t","3h","total","time-weighted",50,
1,4,)
A função multiplica o resultado por 1, e retorna um resultado somente se no mínimo 50 por
cento dos dados forem bons. A função retorna o percentual bom à direita do total calculado.
PIAdvCalcFilDat()
Retorna valores calculados espaçados regularmente para um ponto do PI ou valores de

atributo do PI AF filtrados durante um período de tempo especificado.
SINTAXE
PIAdvCalcFilDat(DataItem, STime, ETime, Interval, FiltExp, Mode,
RootPath)
ARGUMENTOS
função calcula valores. Referencie um intervalo de células que
contêm nomes de pontos do PI ou de atributos do PI AF para os
quais serão calculados valores.
STime (string) O início do período de tempo para o qual a função calcula
exemplo, entre 15m (15 minutos) para retornar um valor para
cada intervalo de 15 minutos durante o período de tempo. Veja
(página 67).

total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
quando avaliar FiltExp:
compactado
interpolado
SampFreq (string) A frequência na qual a função avalia FiltExp se SampMode for
PI (página 62) relativa. Por exemplo, defina para 10m (10
de 10 minutos.
código. Essa função suporta bits 2, 3, 7, 8 e 9 (se Mode for
definido como minimum, maximum, ou range).
14).
EXEMPLO
A função seguinte retorna o total ponderado no tempo para o ponto do PI cdf144 calculado
a partir dos valores do PI Server padrão, para intervalos de 3 horas de meia-noite de ontem
até meia-noite de hoje quando o ponto do PI cdf144 foi definido como Manual:
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""",
"total","time-weighted","compressed","10m",50,1,4,)
compactados do ponto cdf144. A função retorna um resultado somente se no mínimo 50
por cento dos dados forem bons. A função retorna o porcentual bom à direita do total
calculado.
120
PIAdvCalcExpDat()
Retorna valores regularmente espeçados calculados por uma Performance Equation durante
um período especificado de tempo.
SINTAXE
PIAdvCalcExpDat(Expression, STime, ETime, Interval, Mode,
RootPath)
ARGUMENTOS
total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
quando avaliar a Expressão:
compactada
interpolado

SampFreq (string) A frequência na qual a função avalia Expressão se SampMode
for definido como interpolado. Entre uma expressão de tempo
do PI (página 62) relativa. Por exemplo, defina para 10m (10
de 10 minutos.
EXEMPLO
A função seguinte calcula a expressão 'cdf144'+'cdt158' em qualquer horário entre meia-
noite de ontem e meia-noite de hoje com um evento armazenado no PI Server padrão, e então
calcula o total ponderado no tempo dos valores calculados em intervalos de três horas:
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total", "time-
weighted","compressed", "10m",50,1,4,)
122
A função multiplica cada total calculado por 1 e retorna um valor quando a percentagem de
dados bons for no mínimo 50 por cento durante o intervalo de três horas. A função retorna o
porcentual bom à direita do total calculado. Uma vez que o modo de amostragem é
compactado, a função ignora a frequência de amostragem, e coleta amostras dos valores
sempre que os eventos cdf144 ou cdt158 forem armazenados.
PIAdvCalcExpFilDat()
Retorna valores regularmente espeçados calculados por uma Performance Equation filtrada
durante um período especificado de tempo.
SINTAXE
PIAdvCalcExpFilDat(Expression, STime, ETime, Interval, FiltExp,
Mode, CalcBasis, SampMode, SampFreq, MinPctGood, CFactor, OutCode,
RootPath)
ARGUMENTOS
(página 67).

total
mínimo
máximo
desvio padrão
range
média
contagem
mediana
time-weighted
peso de evento
quando avaliar Expressão e FiltExp:
compactado
interpolado
SampFreq (string) A frequência na qual a função avalia Expressão e FiltExp se
SampMode for definido como interpolado. Entre um valor e
uma unidade de tempo. Por exemplo, defina para 10m (10
de 10 minutos. Veja Especificação de intervalo de tempo (página
64).
EXEMPLO
A funcão seguinte calcula o total ponderado no tempo para a expressão 'cdf144'+''cdt158'
quando 'productid' = "Product2" no PI Server padrão em intervalos de três horas de
ontem até hoje:
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
A função multiplica cada total calculado por 1 e retorna um valor quando a percentagem de
dados bons for no mínimo 50 por cento durante o intervalo de três horas. A função retorna o
porcentual bom à direita do total calculado. Uma vez que o modo de amostragem é
compactado, a função ignora a frequência de amostragem, e coleta amostras dos valores
124
sempre que os eventos cdf144 ou cdt158 forem armazenados ou o valor de productid

mudar para ou de Product2.
PITimeFilter()
Retorna a quantidade de tempo em que uma Performance Equation é avaliada como

verdadeira durante intervalos espaçados regularmente um período especificado de tempo.
SINTAXE
PITimeFilter(Expression, STime, ETime, Interval, TimeUnit,
OutCode, RootPath)
ARGUMENTOS
Expression (string) Uma Performance Equation lógica avaliada pela função. Veja
Expressões (página 65).
ETime (string) O final do período de tempo para o qual a função calcula
valores.
TimeUnit (string) Unidade de tempo do resultado calculado:
segundos
minutos
horas
dias
código. Essa função suporta bits 2, 3, 7 e 8.

EXEMPLO
A função seguinte retorna o número de segundos em que a expressão na célula A1 é
verdadeira no PI Server chamado thevax durante intervalos de uma hora, iniciando à meia-
noite de ontem até a meia-noite de hoje:
=PITimeFilter($A$1,"y","t","1h","seconds",65,"thevax")
A função mostra a hora inicial de cada intervalo de cálculo à esquerda do valor.
• Função Hora Filtrada (página 48)
PITimeFilterVal()
Retorna a quantidade de tempo em que uma Performance Equation é avaliada como

verdadeira durante um período especificado de tempo.
SINTAXE
PITimeFilterVal(Expression, STime, ETime, TimeUnit, OutCode,
RootPath)
ARGUMENTOS
Expression (string) Uma Performance Equation lógica avaliada pela função. Veja
Expressões (página 65).
TimeUnit (string) Unidade de tempo do resultado calculado:
segundos
minutos
horas
dias
RootPath (string) O caminho para o item de dados referenciado pela expressão. Veja
Itens de dados (página 14).
126
Funções Tag
EXEMPLO
A função seguinte retorna o número de segundos em que a expressão na célula A1 é
verdadeira no PI Server chamado thevax de meia-noite de ontem à meia-noite de hoje:
=PITimeFilterVal($A$1,"y","t","seconds",0,"thevax")
• Função Hora Filtrada (página 48)
Funções Tag
Funções tag ajudam você a trabalhar com tags do PI.
PIPointIDToTag()
Retorna o tag correspondente a um ID de ponto do PI específico.
SINTAXE
PIPointIDToTag(PointID, PIServer)
ARGUMENTOS
PointID (string) Um ID de ponto do PI, que é um ID interno único não reusado
quando um ponto é excluído.
PIServer (string) O PI Server de onde a função irá retornar os dados. Se você não
selecionar um servidor ou deixar o campo em branco, a função
procurará no PI Server padrão.
EXEMPLO
A função seguinte pesquisa no PI Server chamado thevax pelo ID de ponto 123, e retorna
o tag desse ponto:
=PIPointIDToTag("123","thevax")
• Função Point ID para Tag (página 75)
PIAttributeMaskToTag ()
Retorna tags que correspondem a um ou mais valores de atributo de ponto do PI

especificados.

SINTAXE
PIAttributeMaskToTag(TagName, Descriptor, PointSource, PointType,
PointClass, EngUnits, OutCode, PIServer)
ARGUMENTOS
TagName (string) Nome dos tags retornados.1
Descriptor (string) Descritor dos tags retornados.1
PointSource (string) Fonte de ponto dos tags retornados.1
PointType (string) Tipo de ponto dos tags retornados.1
PointClass (string) Classe de ponto dos tags retornados.1
EngUnits (string) Unidades de engenharia dos tags retornados.1
OutCode (integer) Um código de saída que determina como a função orienta a
saída:
0
Escreve os valores em uma coluna.
2
Escreve os valores em uma linha.
PIServer (string) O PI Server de onde a função irá retornar os dados. Se você
não selecionar um servidor ou deixar o campo em branco, a
função procurará no PI Server padrão.
1
Use o caracter curinga (*) para encontrar todas as correspondências ou correspondências limitadas a caracteres
especificados.
EXEMPLO
A seguinte função retorna as tags que começam com "sin" do PI Server chamado thevax:
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
• Função Máscara de Atributo para Tag (página 76)
PIAliasToTag()
Retorna o tag do PI que corresponde a um apelido do PI específicado.
SINTAXE
PIAliasToTag(Alias, ModulePath, QueryDate, OutCode, PIServer)
128
ARGUMENTOS
Alias (string) O apelido do Module Database que corresponde ao tag do PI a ser
retornado.
ModulePath O caminho completo do módulo para o apelido.
(string)
QueryDate Uma data de efetividade do apelido. O PI DataLink retorna a tag
(integer) que corresponde ao apelido especificado nessa data.
OutCode (integer) Um código de saída que determina se o nome do servidor deve ser
incluído no resultado:
0
Retorna somente o tag.
1
Retorna o PI Server que armazena o tagt em uma célula à direita
do tag.
2
Retorna o PI Server que armazena o tagt em uma célula abaixo
do tag.
EXEMPLO
A função seguinte retorna o tag que corresponde ao apelido Temperature do módulo
Reactor1, que é um submódulo de Unit1. Unit1 está na raiz do Module Database em
um PI Server chamado thevax. O Module Database é pesquisado no horário atual.
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
• Função Alias para Tag (página 87)

PIPropertyToValue()
Retorna o valor ou valores correspondentes a uma propriedade do módulo do PI especificada.
SINTAXE
PIPropertyToValue(Property, ModulePath, QueryDate, PIServer,
OutCode)
ARGUMENTOS
Property (string) A propriedade do Module Database que corresponde ao ponto do PI
para o qual a função retorna valores.
ModulePath O caminho completo do módulo para a propriedade.
(string)
QueryDate Uma data de efetividade da propriedade do módulo do PI. O PI
(integer) DataLink retorna os valores que correspondem à propriedade
especificada nessa data.
OutCode (integer) Um código de saída que determina como a função orienta a saída:
0
Retorna os valores em uma coluna.
2
Retorna os valores em uma linha.
EXEMPLO
A função seguinte retorna o valor que corresponde à propriedade Temperature do módulo
Reactor1 ,que é um submódulo de Unit1. Unit1 está na raiz do Module Database em
um PI Server chamado thevax. O Module Database é pesquisado no horário atual.
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")
• Função Propriedade para Valor (página 88)
130
Funções de entrada
Funções de entrada
PIPutVal() and PIPutValX()
Escreve um valor no PI Server ou PI AF Server e retorna uma string que indica o status.
SINTAXE
PIPutVal(DataItem, Value, TimeStamp, RootPath, OutCell)
PIPutValX(DataItem, Value, TimeStamp, RootPath, OutCell)
ARGUMENTOS
DataItem (string) O nome do ponto do PI ou do atributo do PI AF no qual a função

grava um valor.
Value (referência) Uma referência para uma célula que contém o valor a ser
gravado, seja uma string ou um número.
TimeStamp (string) O horário do valor. Veja Entrada de tempo (página 16).
14).
OutCell (reference) A referência da célula onde o PI DataLink grava a string que a
função de macro retorna.
A string retornada varia:
Se a gravação for bem sucedida, a função PIPutVal retorna
xxx Written onde xxx é Real Value, Integer, Digital
State, ou Value, dependendo do tipo de valor gravado; a
função PIPutValX retorna Value Written.
Se a gravação falhar, a função retorna um código de erro como
[-5] Tag not found.
OBSERVAÇÕES
As funções PIPutVal e PIPutValX não podem gravar em atributos PI AF que são
atributos de configuração. Essas funções podem gravar somente em atributos PI AF em que a
caixa de verificação Item de configuração não está marcada. Você pode verificar o status da
caixa de verificação na guia Atributos no PI System Explorer.
As funções PIPutVal e PIPutValX suportam todos os tipos de dados do PI Server,
incluindo entrada de strings para tags de string e dados de subsegundo. As funções
interpretam horários usando a informação de fuso horário do cliente para o PI Server a não
ser que a configuração Use Fuso Horário do PI Server esteja habilitada.

As funções não verificam o intervalo especificado pelo usuário para um ponto antes de gravar
um valor. O intervalo é definido como zero até zero + span, onde zero e span são
atributos de pontos especificados durante o processo de criação do ponto. A função retorna
uma string de valor gravado mesmo se Acima da Faixa ou Abaixo da Faixa for
armazenado no PI Server.
EXEMPLO
A função seguinte grava o valor localizado na célula A5 no PI Server no ponto do PI
testtag com o horário de hoje à meia-noite:
=PIPutVal("testtag",a5,"t",,e5)
A função grava o resultado da função de macro na célula E5 da planilha.
132
Anexo B
Solução de problemas
Consulte os tópicos nessa seção se você experimentar dificuldades ao usar o PI DataLink. Se
esses tópicos não endereçarem ou resolverem o problema, veja Suporte Técnico e outros
recursos (página 139) para detalhes sobre como entrar em contato com o Suporte Técnico.
Arquivos de Log
O PI DataLink não gera um arquivo de log genérico. Você pode usar as mensagens de erro
nas planilhas para diagnosticar os problemas. No entando, alguns processos específicos
geram arquivos de log:
• Instalação
O diretório ../pipc/dat contém os arquivos de log de instalação,
SetupPIDataLink_x64.log e SetupPIDataLink_x86.log.
• Conectividade do PI Server
Examine o arquivo de log do PI Server no PI SMT para problemas de conectividade do
PI Server.
Guia PI DataLink não disponível.

Se a guia PI DataLink não aparecer depois que você instalar o PI DataLink, você pode
precisar configurar manualmente (página 6) o suplemento no Excel, ou diminuir as
configurações de segurança (página 135) de suplementos.
Alguns scripts VBA escritos pelo usuário em planilhas Excel (ou suplementos) re-inicializam
a barra de opções principal do Excel. Nesses casos, a guia PI DataLink pode desaparecer
mesmo que o suplemento PI DataLink ainda esteja carregado, e funções incorporadas do PI
DataLink podem funcionar mesmo que a guia PI DataLink em si não esteja disponível.
Reiniciar o Excel normalmente corrige esse problema.

Limites de matrizes e células

O PI DataLink está sujeito às limitações do Excel quanto ao número de elementos em uma
matriz de cálculo. Uma única função PI DataLink pode retornar no máximo 1.048.576
valores por recuperação.
O Excel SDK usado pelo PI DataLink limita o tamanho das strings a 255 caracteres. Strings
de entrada para expressões do PI DataLink em uma célula referenciada não pode exceder esse
limite de 255 caracteres.
Da mesma forma, o PI DataLink pode truncar strings de saída, como strings de tags do PI,
para 255 caracteres.
Limites de recuperação de dados

O código de erro -11091 indica que uma consulta iniciada por uma função do PI DataLink
tentou retornar mais eventos do PI Server que o permitido no parâmetro de ajuste
ArcMaxCollect.
Como esse limite se aplica a eventos recuperados do arquivo do PI Server, mesmo funções
que retornam um pequeno número de valores podem exceder o limite imposto por esse
parâmetro de ajuste. Por exemplo, o valor do ponto do PI sinusoid varia constantemente
entre 0 e 100. Você pode criar uma função que retorna valores de dados amostrados de
sinusoid a cada 30 segundos durante um ano com um filtro que exclui valores menores do
que 95. Essa função pode retornar um número relativamente pequeno de valores, mas irá
recuperar muito mais eventos dos arquivos para processar a consulta.
Se você receber esse erro, considere modificar seu critério de pesquisa para reduzir os dados
recuperados. Por exemplo, você pode reduzir o período de tempo durante o qual a função
recupera valores.
Item de dados não suportado por função

A mensagem de retorno "Item de dados não é suportado pela função" pode indicar:
• Um atributo do PI AF usa uma referência de dados customizada que não permite
cálculos. Para usar o PI DataLink, modifique o código da referência de dados
customizada para permitir o uso de métodos de acesso a dados. Isso é desabilitado por
padrão.
• A função Dados Calculados tentou fazer um cálculo sumarizado em um atributo do PI AF
do tipo Matriz de Ponto do PI.
134
Segurança
Segurança
Características de segurança do Excel para suplementos, controles ActiveX e macros
controlam os tipos de componentes que podem ser executados dentro do Excel. As
configurações de segurança desabilitam, habilitam com consulta, ou habilitam completamente
esses tipos de objeto.
As configurações de segurança do Excel podem conflitar com certos recursos do PI
DataLink.
• O PI DataLink é um suplemento do Excel. As configurações de segurança que
desabilitam suplementos impedem a execução do PI DataLink no Excel.
• O Trends usa um controle ActiveX com assinatura marcada segura para inicialização, e
requer que controles ActiveX estejam habilitados.
• Planilhas que contém as funções PIPutVal ou PIPutValX (página 131) usam macros e
requerem que macros estejam habilitadas.
Se você regularmente aplica a segurança do Excel à planilhas, ou encontra problemas usando
recursos do PI DataLink, você pode precisar reduzir ou eliminar as configurações de
segurança do Excel, dependendo de como você planeja usar o PI DataLink.
Para informações adicionais sobre a segurança do Excel, consulte a Ajuda e os recursos on-
line do Microsoft Excel .
Problemas de conexão com o PI Server

Essa versão do PI DataLink usa configurações de segurança restritas para conexão ao PI
Server. As novas configurações reduzem a exposição a fragilidades de segurança associadas à
autenticação de senha do PI. Veja o boletim de suporte, Alerta de Segurança: Fragilidade de
Autenticação do PI (http://techsupport.osisoft.com/Bulletins/4/224a5434-ba62-41d1-83eb-
244ba60da193.htm), para mais informações.
As novas configurações de segurança podem resultar em erros se o PI DataLink usa:
• Nomes de usuário e senhas do PI para se conectar ao PI Server
• Usuário padrão para se conectar ao PI Server
Especificamente, essas configurações podem gerar o erro -10407 "Sem acesso - Objeto de
Segurança" com informações sobre privilégios insuficientes para acessar o PI Server. Essas
configurações podem também gerar uma mensagem sobre um prompt de login desabilitado.
Para resolver esses erros, você pode:
• Configurar o mapeamento do PI para usuários que se conectam ao PI Server. A OSIsoft
recomenda essa abordagem (disponível no PI Server versão 3.4.380 e posteriores). Essa é
o método mais seguro de conexão. Veja o guia Configurando a Segurança do PI Server
para informações sobre como criar mapeamentos do PI. Para usar mapeamentos do PI,
você deve habilitar também o protocolo de autenticação Windows Security em cada
computador que executa o PI DataLink.

• Configurar o PI trusts para usuários que se conectam ao PI Server. Essa é a melhor

abordagem em seguida. Veja o guia Configurando a Segurança do PI Server para
informações sobre como criar PI trusts. Para usar o PI trust, você deve habilitar também o
protocolo de autenticação PI Trust em cada computador que executa o PI DataLink.
• Configure cada computador para permitir um prompt de login explícito quando um
mapeamento do PI ou PI trust não estiver disponível. A OSIsoft não recomenta essa
abordagem. Logins explícitos não são seguros.
Observação: Entrando uma senha incorreta em um prompt de login pode resultar

na mesma mensagem de erro.
Veja também...
• Configurar um computador para permitir prompts de login explícitos (página 136)
• Habilitar um protocolo de autenticação (página 136)
Configurar um computador para permitir prompts de login explícitos
Para conectar a um PI Server através da autenticação de um usuário PI, use o PI SDK Utility
para permitir prompts de login explícitos no seu computador. Você deve configurar cada
computador onde você se conecta ao PI Server através de um login como um usuário PI.
Cuidado: A OSIsoft recomenda que você selecione um método alternativo, mais

seguro, para se conectar ao PI Server.
Procedimento
1. Clique em Iniciar > Todos os programas > PI System > PISDKUtility para abrir o PI
SDK Utility.
2. Sob PI-SDK, clique em Conexões para mostrar os PI Servers disponíveis e atualizar os
menus do utilitário.
3. Clique em Conexões > Opções para abrir a janela Opções de Conexão.
4. marque a caixa de verificação Permitir prompt de login (se todos os protocolos
configurados falharem).
5. Clique em OK.
Depois de terminar
Um prompt solicitará um nome de usuário e senha cada vez que você iniciar uma nova
conexão ao PI Server.
136
Não é possível conectar ao PI OLEDB Enterprise Agent
Habilitar um protocolo de autenticação
Para se conectar a um PI Server com um mapeamento PI ou PI Trust definido, use o PI SDK

Utility para habilitar o protocolo correspondente no seu computador. Você deve configurar
cada computador onde você se conecta ao PI Server através de um mapeamento PI ou PI
Trust.
Procedimento
1. Clique em Iniciar > Todos os programas > PI System > PISDKUtility para abrir o PI
SDK Utility.
2. Sob PI-SDK, clique em Conexões para mostrar os PI Servers disponíveis e atualizar os
menus do utilitário.
3. Clique em Conexões > Opções para abrir a janela Opções de Conexão.
4. Sob Especificar Procedimento de Autenticação, use as setas para mover e ordenar os
protocolos habilitados listados sob Ordem dos protocolos. Lista de protocolos
necessários:
ο Para usar o mapeamento do PI, Windows Security deve estar listado. Esse deve ser o
primeiro protocolo na lista Ordem dos protocolos.
ο Para usar o trusts do PI, PI Trust deve estar listado.
5. Clique em OK.
Não é possível conectar ao PI OLEDB Enterprise Agent

A mensagem de erro de pesquisa, "Cannot connect to PI OLEDB Enterprise Agent," indica
que o serviço do Windows, PI OLEDB Enterprise Agent, não está sendo executado.
Para limpar esse erro, abra o painel Serviços (por exemplo, através de Ferramentas
Administrativas no Painel de Controle), e inicie o serviço PI OLEDB Enterprise Agent.
Exceção de tempo de espera

Pesquisas a PI Servers com grandes bancos de dados de pontos podem atingir o tempo limite
de espera antes que o PI Server retorne os resultados. Você pode receber a seguinte
mensagem de erro:
OSIsoft.PI.Net.PITimeoutException: [-10722] PINET: Timeout on
PI RPC or System Call.
Para eliminar esse erro, use o Gerenciador de Conexões para aumentar o valor do tempo de
espera:
1. Na guia PI DataLink, no grupo Recursos, clique em Configurações para abrir a janela
Configurações.
2. Clique em Gerenciador de Conexões para abrir a janela Servidores.
3. Clique com o botão direito no PI Server que retornou o erro, e então clique em
Propriedades para abrir a janela Propriedades do PI Server.
4. Aumente o valor do campo Tempo de espera de dados, e então clique em OK.
138
Anexo C
Suporte técnico e outros recursos

Para obter assistência técnica, contate o Suporte técnico da OSIsoft pelo telefone +1 510-297-
5828 ou pelo e-mail techsupport@osisoft.com. O site do Suporte técnico da OSIsoft
(http://techsupport.osisoft.com) oferece outras opções de contato
(http://techsupport.osisoft.com/Contact+Us/Contact+Methods/Contact+Methods.htm) para
clientes fora dos Estados Unidos.
Ao entrar em contato com o Suporte técnico da OSIsoft, tenha estas informações em mãos:
• Nome do produto, versão e números de compilação
• Plataforma do computador (tipo da CPU, sistema operacional e número da versão)
• Horário em que o problema começou
• Arquivos de log nesse horário
• Detalhes de todas as alterações no ambiente anteriores ao início do problema
• Resumo do problema, inclusive os arquivos de log relevantes durante o horário em que o
problema ocorreu
O site do OSIsoft Virtual Campus (vCampus) (http://vCampus.osisoft.com) tem recursos
baseados em assinatura para ajudá-lo na programação e integração dos produtos da OSIsoft.

Índice
frequência de amostragem da expressão - 40
A função - 49
Função Alias para Tag - 81
acesso a dados - 6
Função Dados Calculados - 40
anotações - 33, 64
Função Dados Calculados Avançados - 40
anterior no tempo - 33
Função Dados Compactados - 33
argumento outcode - 64
Função Dados de Amostragem - 36
atributos de valor, mostrar - 33
Função Dados Temporizados - 38
atualizar dados
Função Hora Filtrada - 44
automático - 54
Função Máscara de Atributo para Tag - 70
manual - 54
Função Point ID para Tag - 69
Função Propriedade para Valor - 82
B
Função Valor Atual - 29
base de cálculo - 40 Função Valor de Arquivo - 30
funções
C definindo - 10, 63
células, planilha entrada manual - 63
referências - 13 frequência de cálculo - 52
valores de funções - 49 modificando - 50
conexões - 22 painéis de tarefas - 10
configuração - 6 referência - 91
Configuração de suplementos do Excel - 6 visão geral - 11
instalação silenciosa - 5 funções tag - 69
configurações - 20
G
D gerenciando conexões com - 22
descrição - 9 Guia PI DataLink
descrição do suplemento - 83 processo de configuração - 4
desvio padrão - 40 recursos de interface - 9
versão do servidor - 2
E
H
entradas de tempo - 14
erros - 123 horários - 14, 15, 58
expressões
cálculo - 60 I
filtro - 62 intervalo de tempo - 36, 40, 44, 60
sintaxe - 61
expressões de cálculo - 60 J
expressões de cálculo do Pi - 61
Janela Pesquisar Tag - 71
expressões de filtro - 62
M
F
média - 40
fator de conversão - 40
mínimo percentual bom - 40
formatos de exibição de tempo - 15
modo de amostragem da expressão - 40
formatos de número - 15
modo de cálculo - 40
Índice
modo de recuperação - 30, 38 R

module database - 80
referências de célula - 13
Module Database, navegar - 79, 80
mostrar anotações - 33, 64
S
mostrar atributos de valor - 33
mostrar horário - 29, 30, 33, 36, 64 solução de problemas - 123
mostrar percentual bom - 40, 44, 64
mover matriz de funções - 49 T
tamanho - 51
N tempo - 15
navegação - 80 tipo de limite - 33
totais - 40
O
operadores - 60
P
performance equations - 60
PI Module Database
module database - 80
navegação - 80
PI Notifications - 83
PI SDK - 2
PIAdvCalcDat - 109
PIAdvCalcExpDat - 112
PIAdvCalcExpFilDat - 113
PIAdvCalcExpFilVal - 107
PIAdvCalcExpVal - 106
PIAdvCalcFilDat - 110
PIAdvCalcFilVal - 104
PIAdvCalcVal - 103
PIAliasToTag - 119
PIArcVal - 92
PICompDat - 96
PICompFilDat - 97
PICurrVal - 91
PIExpDat - 100
PIExpVal - 93
PINCompDat - 94
PINCompFilDat - 95
PIPropertyValue - 119
PIPutVal - 120
PISampDat - 98
PISampFilDat - 99
PITagAtt - 93
PITimeDat - 101
PITimeExpDat - 102
PITimeFilter - 115
PITimeFilterVal - 116
Point Access - 6
142

Pi Datalink 2013 Guia Do Usuario

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Pi Datalink 2013 Guia Do Usuario

Enviado por

Direitos autorais:

Formatos disponíveis

PI DataLink 2013

OSIsoft Australia • Perth, Austrália

PI DataLink 2013 Guia do Usuário

DIREITOS DO GOVERNO DOS EUA.

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

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

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

PI DataLink 2013 Guia do Usuário iii

Função Máscara de Atributo para Tag.............................................................................76

Capítulo 7 Tendências ................................................................................................................79

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

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

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

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

Visão geral do PI DataLink

PI DataLink 2013 Guia do Usuário 1

PI DataLink Server (DLS)

Sobre esta versão

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

Tipos de dados suportados

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

PI DataLink 2013 Guia do Usuário 3

Processo de configuração do PI Datalink

Inicie o programa de instalação para instalar o PI DataLink. Em sistemas operacionais de 64

Ver PI DataLink em um idioma suportado

PI DataLink suporta vários idiomas. Instale o pacote de idiomas PI DataLink MUI

PI DataLink 2013 Guia do Usuário 5

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

O PI DataLink pode recuperar dados de um PI Server 3.4.375.91 e posterior. No entanto, o PI

Microsoft Excel: configuração de suplementos

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

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

PI DataLink 2013 Guia do Usuário 7

Ver status dos suplementos

Habilitar um suplemento desabilitado

Se um suplemento estiver desabilitado, você deve habilitar o suplemento antes de poder

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

3. Na lista Gerenciar, selecione Suplementos COM e, então, clique em Ir.

Sobre este Documento

PI DataLink 2013 Guia do Usuário 9

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.

PI DataLink 2013 Guia do Usuário 11

Painéis de tarefas de função

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

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

O PI DataLink adiciona vários comandos ao menu de atalhos padrão do Microsoft Excel.

PI DataLink 2013 Guia do Usuário 13

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

As funções PI DataLink retornam dados a respeito de itens de dados específicos do PI

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

• Clicar para abrir a ferramenta Pesquisar (Search) e, então, selecionar os itens de

PI DataLink 2013 Guia do Usuário 15

Para entradas com listas , você pode:

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

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

PI DataLink 2013 Guia do Usuário 17

Pesquisar itens de dados

ο Para inserir um ou mais itens em um painel de tarefas da função, clique no botão

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