PI Datalink 2010 User Guide PT

Guia do usuário do PI DataLink
Versão 2010
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 EUA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: 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á
Escritório de Representação da OSIsoft, LLC • 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
Copyright: © 1992-2010 OSIsoft, LLC. Todos os direitos reservados.

Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de onde possa ser recuperada, ou transmistida,
de qualquer forma ou por qualquer meio, mecânico, por fotocópia, gravação, ou qualquer outro tipo, sem a autorização prévia por
escrito da OSIsoft, LLC.
OSIsoft, o logotipo e a logomarca da OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, Sigmafine, Analysis
Framework, IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI BatchView, PI Data Services, PI
Manual Logger, PI ProfileView, PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são
marcas comerciais da OSIsoft, LLC. Todas as outras marcas comerciais ou nomes comerciais usados neste documento pertencem a
seus respectivos proprietários.
DIREITOS DO GOVERNO DOS E.U.A.

O uso, duplicação ou divulgação pelo Governo dos E.U.A. está sujeito às restrições apresentadas no contrato de licença da OSIsoft,
LLC e conforme fornecido na DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC.
Publicado: 19/5/2010
Índice
Capítulo 1 Introdução....................................................................................................................1
Edições do PI DataLink ......................................................................................................1
Requisitos do sistema ........................................................................................................4
Instalação e atualização.....................................................................................................4
Configuração ......................................................................................................................5
Sobre este documento .......................................................................................................6
Capítulo 2 Noções básicas ...........................................................................................................7

Interface do usuário............................................................................................................7
Conexões do PI Server ....................................................................................................12
Componentes de função gráfica ......................................................................................13
Configurações de preferência ..........................................................................................22
Construção de planilhas...................................................................................................25
Capítulo 3 Funções do PI............................................................................................................27

Valor atual ........................................................................................................................27
Valor do arquivo ...............................................................................................................28
Dados compactados.........................................................................................................29
Dados de amostragem .....................................................................................................32
Dados com marcação de tempo ......................................................................................34
Dados calculados .............................................................................................................35
Hora filtrada......................................................................................................................40
Capítulo 4 PI Tags e atributos ....................................................................................................43

Pesquisa de tags..............................................................................................................43
Funções de tag.................................................................................................................45
Capítulo 5 Objetos do banco de dados do módulo .................................................................49

Procurar banco de dados do módulo ...............................................................................49
Funções do banco de dados do módulo ..........................................................................51
Capítulo 6 Planilhas.....................................................................................................................53
Frequência de cálculo ......................................................................................................53
Funções e valores de array..............................................................................................55
Gerenciamento de arrays.................................................................................................56
Compartilhar planilhas......................................................................................................58
Capítulo 7 Exibições de tendência ............................................................................................59

Criar uma tendência .........................................................................................................59
Guia do usuário do PI DataLink iii

Índice
Especificar o intervalo de tempo ......................................................................................62

Título e posicionamento ...................................................................................................63
Menu de contexto.............................................................................................................64
Capítulo 8 Notificações...............................................................................................................67
Pesquisar e exibir notificações.........................................................................................68
Exibir notificações ............................................................................................................70
Inserir notificações ...........................................................................................................71
Anexo A Informações suplementares .......................................................................................75

Instalação .........................................................................................................................75
Horário PI .........................................................................................................................77
Suporte a tipo de dados do PI..........................................................................................80
Expressões do PI .............................................................................................................80
Entrada manual de funções .............................................................................................88
Gravar dados no PI ..........................................................................................................91
Solução de problemas......................................................................................................91
Anexo B Referência de funções do PI DataLink ......................................................................95

Funções de valor único ....................................................................................................95
Funções de múltiplos valores...........................................................................................98
Funções de cálculo ........................................................................................................107
Funções de tag...............................................................................................................120
Funções do banco de dados do módulo ........................................................................123
Funções de entrada .......................................................................................................125
Anexo C Suporte técnico e recursos.......................................................................................127
Índice ...........................................................................................................................................131
iv
Capítulo 1
Introdução
O PI DataLink é um suplemento do Microsoft Excel que permite recuperar informações do PI
Server diretamente para uma planilha. Com o PI DataLink é possível:
• recuperar valores de ponto de um PI server
• recuperar metadados do sistema para criar uma exibição estruturada de dados do PI:
ο atributos e nomes de PI tag
ο caminhos, aliases e propriedades do PI Module Database
• referenciar esses itens usando funções do PI DataLink para calcular e filtrar dados
• manter valores atualizados quando a planilha recalcular
• recuperar Notificações do PI que você assinou a partir de um PI System
• estabelecer tendência de dados a partir da planilha ou de pontos PI selecionados
O PI DataLink fornece uma interface gráfica para recuperar dados e criar funções e cálculos.
As funções do DataLink são inseridas em células da planilha e podem fornecer atualizações
ativas de dados em tempo real a partir do PI server.
Também é possível usar os ricos recursos de cálculo e formatação do Excel para organizar e
apresentar dados do PI system a fim de ajustar à sua meta ou da audiência.
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.
Edições do PI DataLink
Observação: Por todo este livro, as referências ao Microsoft Excel 2007 aplicam-se ao
Microsoft Excel 2007 e posteriores. As referências ao Microsoft Office 2007
aplicam-se ao Microsoft Office 2007 e posteriores.
Duas edições do PI DataLink são instaladas no sistema:

• Um suplemento é instalado para o Microsoft Excel 2007. Esse suplemento não pode ser
executado em versões anteriores do Excel. Essa edição será configurada automaticamente
se o Excel 2007 estiver instalado no sistema.
• Um suplemento é instalado para o Microsoft Excel XP ou 2003. Esse suplemento
assemelha-se a versões anteriores do PI DataLink e deve ser configurado manualmente
(página 4).
Guia do usuário do PI DataLink 1

Introdução
As diferenças entre os suplementos residem principalmente em alterações de design e

interface do usuário (página 7) para o Office 2007 e posteriores.
PI SDK
O PI SDK é instalado com o PI DataLink e conecta o PI DataLink ao PI server para recuperar

dados de ponto PI.
O PI DataLink usa o PI SDK e o Microsoft Excel SDK. Quando ocorre um erro no nível do
PI SDK, o PI DataLink exibe o erro na célula. Por exemplo, se uma função tentar recuperar o
valor atual de uma tag que não exista, a célula de saída exibirá a mensagem "PIPoint não
encontrado".
O PI SDK também permite que usuários com experiência em VBA (Microsoft Visual Basic
for Applications) desenvolvam rotinas do Excel que chamem funções do PI SDK. Usuários
que planejem desenvolver programas fora do Excel deverão adquirir uma licença separada do
PI SDK ou da PI API. Entre em contato com o representante de vendas da OSIsoft para obter
informações adicionais.
2
Edições do PI DataLink
PI DataLink for Excel Services (DLES)
O PI DataLink for Excel Services (PI DLES) é uma versão de servidor do PI DataLink que
pode ser usada com o Microsoft Office SharePoint Server 2007 (MOSS). O PI DLES oferece
suporte a todas as funções do PI BatchView e DataLink fornecidas por Suplementos do Excel
em uma configuração de cliente típica do PI.
O PI DLES permite recuperar e exibir dados de PI Servers em formato de planilha do
Microsoft Excel usando apenas um navegador da Web. O acesso a dados do PI em tempo real
pode ser expandido para vários consumidores diferentes, independentemente do local ou de
familiaridade com funções do Microsoft Excel ou do PI DataLink.
Essa versão de servidor do PI DataLink usa tecnologias do MOSS, incluindo os Serviços do
Excel e a web part Excel Web Access. Juntos, esses componentes da Microsoft oferecem
suporte à maioria dos recursos padrão de planilha. O PI DataLink for Excel Services aumenta
esses serviços, adicionando conectividade e suporte a funções do PI.
As pastas de trabalho do Excel publicadas em bibliotecas de documentos do SharePoint
podem ser acessadas independentemente ou adicionadas a páginas de web part. A web part
Excel Web Access oferece suporte a conexões que permitem a troca de parâmetros entre uma
pasta de trabalho e outras web parts, integrando planilhas a funções do PI DataLink no
ambiente do PI WebParts.
Entre em contato com o representante de vendas da OSIsoft para obter informações
adicionais sobre o PI DLES.
Suporte a idiomas do PI DataLink
Este release do PI DataLink fornece suporte a vários idiomas. A interface do usuário do

suplemento aparece no mesmo idioma que o Microsoft Excel em que ele é executado, se o
idioma for suportado pelo PI DataLink. Caso contrário, o suplemento aparecerá em inglês.
Para exibir o suplemento em um idioma diferente, use a ferramenta de configuração de
idioma do Microsoft Office para alterar o idioma do Microsoft Excel.
Para obter o suporte a vários idiomas, é necessário instalar o pacote de idiomas separado.

Introdução
Requisitos do sistema
Nos requisitos do sistema, consulte o site de Suporte técnico da OSIsoft:
http://techsupport.osisoft.com/Products.htm (http://techsupport.osisoft.com/Products.htm)
Instalação e atualização
Instalação
Para instalar, baixe o kit de instalação de http://techsupport.osisoft.com e execute o kit de
instalação do PI DataLink.
O programa de instalação instala o PI DataLink no diretório raiz PIPC, normalmente em:
C:\Arquivos de programas\PIPC\Excel
A instalação também inclui arquivos de ajuda online e notas sobre o release, também
disponíveis para download em http://techsupport.osisoft.com.
Atualização
Se houver uma versão anterior do PI DataLink instalada no computador, o instalador
atualizará automaticamente a instalação. As configurações de preferência de versões
anteriores são mantidas.
Os seguintes pontos podem ser úteis ao atualizar de versões anteriores do PI DataLink:
• O PI DataLink é compatível com versões anteriores. As pastas de trabalho criadas em
versões anteriores podem ser lidas pela versão atual sem nenhuma conversão. Entretanto,
o contrário não é necessariamente verdadeiro. Depois de modificar uma planilha na
versão atual, ela poderá não funcionar em versões anteriores do PI DataLink.
• As versões atuais do PI DataLink usam o PI SDK, enquanto as versões 2.x e anteriores
usavam a PI API.
ο As mensagens de erro retornadas podem ser diferentes; portanto, se as planilhas
procurarem por determinadas strings (por exemplo, no código VBA do Excel ou em
macros) o texto poderá não ser o mesmo.
ο As versões 3.x e 4.x não criam uma conexão de API com o PI Server; portanto, o
código VBA em pastas de trabalho que dependa de uma conexão de API existente
deverá ser editado para criar uma nova conexão explícita com a PI API.
4
Configuração
Configuração
Após a instalação, poderá ser necessário configurar o suplemento PI DataLink no Excel.
Microsoft Excel 2007

O programa de instalação do PI DataLink instala automaticamente o suplemento DataLink
para Microsoft Excel 2007 se essa versão for encontrada no sistema. Nenhuma configuração
será necessária.
A instalação torna o PI DataLink disponível para todos os usuários do computador cliente. Se
um usuário individual desativar o PI DataLink ou um suplemento relacionado, as atualizações
não reativam o suplemento; ele deverá ser restaurado manualmente. Para restaurar
suplementos:
1. Clique no Botão Microsoft Office e selecione Opções do Excel.
2. Clique em Suplementos > Gerenciar Itens Desabilitados > Ir e habilite
PIDatlink.UI.dll.manifest.
3. Vá para Suplementos > Gerenciar Suplementos de COM > Ir e habilite PI DataLink ou
PI Notifications.
4. Clique em OK.
Microsoft Excel XP-2003

Se instalar o PI DataLink for Excel XP-2003, precisará configurar o suplemento para Excel
após a instalação. Este procedimento também pode ser usado para restaurar o suplemento se o
menu PI não aparecer na barra de menus do Excel.
Para adicionar o PI DataLink ao Excel versões XP-2003:
1. No Excel, escolha Ferramentas > Suplementos.
O diálogo Suplementos será exibido.

Introdução
2. Se o suplemento PI DataLink não estiver listado, clique em Procurar para localizar o

arquivo PIPC32.XLL no disco rígido local.
O caminho padrão do PI DataLink é PIPC\EXCEL.
3. Clique na caixa de seleção ao lado de PI DataLink e clique em OK.
Sobre este documento

O Guia do usuário do PI DataLink fornece uma descrição detalhada dos recursos do produto e
uma referência completa para funções do PI DataLink. O conteúdo das versões impressa e
online do guia é idêntico. Os objetos de controle de tendência também iniciam um arquivo de
ajuda separado que inclui informações sobre controles programáticos para tendências.
As versões impressas do Guia do usuário do PI DataLink incluem exercícios de tutorial
usados pela OSIsoft para cursos de treinamento em PI DataLink. Esses exercícios também
estão disponíveis em formato PDF (juntamente com arquivos de exercícios de treinamento
associados) no website de suporte da OSIsoft em techsupport.osisoft.com.
Este guia não duplica ou distingue entre os suplementos PI DataLink for Excel 2007 e Excel
XP-2003 ao discutir funcionalidades comuns, a menos que existam diferenças funcionais
significativas.
Referências específicas ao PI DataLink for Excel XP-2003 estão rotuladas (2003), e as
específicas ao PI DataLink for Excel 2007 estão rotuladas (2007), quando necessário.
6
Capítulo 2
Noções básicas
As seções a seguir introduzem conceitos e recursos básicos do PI DataLink. É necessário
familiarizar-se com essas seções antes de usar o PI DataLink para criar uma planilha e
recuperar dados do PI, especialmente se você não tiver experiência com o PI DataLink ou
com o Office 2007.
Essas seções descrevem:
• Componentes de interface comuns e como eles diferem entre os suplementos PI DataLink
for Excel XP-2003 e Excel 2007
• Principais recursos necessários para começar a trabalhar com o PI DataLink
• Abordagens diferentes para a criação de uma planilha do PI DataLink, dependendo de
suas metas, necessidades e recursos
Interface do usuário
O PI DataLink é um aplicativo de suplemento para o Microsoft Excel e aparece na interface
do usuário do Microsoft Excel na forma de menus, caixas de diálogo e painéis de tarefas
específicos ao PI DataLink.
Embora a funcionalidade básica do PI DataLink seja a mesma para o Excel XP-2003 e o
2007, a interface do usuário e as ferramentas usadas para criar e gerenciar planilhas do PI
DataLink diferem levemente para refletir o design e os objetos disponíveis na versão
correspondente do Microsoft Excel.
Dependendo da versão do Excel, será possível trabalhar com um dos seguintes grupos de
componentes do PI DataLink:
PI DataLink for Excel XP-2003 PI DataLink for Excel 2007
Menu PI Faixa de opções do PI
caixas de diálogo de função painéis de tarefas de função
menu de contexto que se clica com o menu de contexto que se clica com o botão
botão direito do mouse direito do mouse
Assistente Controle de tendências Assistente Controle de tendências
caixa de diálogo Notificações do PI caixa de diálogo Notificações do PI
A seção a seguir descreve as diferenças visuais e operacionais entre os suplementos PI

DataLink.

Noções básicas
PI DataLink for Excel 2007
O PI DataLink for Excel 2007 inclui elementos de design introduzidos no Microsoft Office
2007.
Se estiver atualizando de uma versão anterior do PI DataLink, familiarize-se com os novos
elementos de design antes de começar a trabalhar com o PI DataLink.
Faixa de opções do PI
O suplemento PI DataLink for Microsoft Excel 2007 usa um menu de faixa de opções.
O menu de faixa de opções é um menu gráfico que combina recursos de um menu padrão e
uma barra de ferramentas.
• Clique em PI na barra de menus do Excel para selecionar a guia do menu de faixa de
opções do PI DataLink.
• Clique em um item na faixa de opções PI para abrir um painel de tarefas ou uma caixa de
diálogo correspondente.
• Coloque o cursor sobre um item para exibir uma dica de ferramenta descritiva.
Painéis de tarefas de funções

O PI DataLink for Microsoft Excel 2007 fornece painéis de tarefas personalizados para
definir funções do PI DataLink.
Um painel de tarefas é um painel de controles móvel e encaixável que funciona quase como
uma caixa de diálogo, exceto que é possível continuar a trabalhar em uma planilha enquanto
um painel de tarefas está aberto.
8
O PI DataLink abre um painel de tarefas quando você adiciona uma função ou seleciona uma
célula em um array de funções para edição. Para abrir um painel de tarefas de função:
• Clique na célula de saída desejada e então clique em uma função na faixa de opções PI
para adicionar uma função.
• Clique em uma célula em um array de funções existente para exibir um painel de tarefas
correspondente e editar argumentos da função.
• Clique com o botão direito do mouse em uma célula de array de funções e escolha o
nome da função para exibir manualmente o painel de tarefas.
Observação: É possível desligar a exibição automática (página 22) de painéis de

tarefas, se preferir.
Depois que um painel de tarefas de função estiver aberto:

• Insira ou altere valores e então clique em OK para salvar as alterações e fechar o painel
de tarefas. Clique em Aplicar para salvar alterações 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 alterações.
• Clique no botão de seta na barra de título do painel de tarefas para desanexar e Mover ou
Redimensionar o painel de tarefas.
Também é possível clicar na barra de título para arrastar e encaixar um painel de tarefas,
ou colocar o cursor sobre a borda e arrastar para redimensionar o painel.
Observação: As caixas de diálogo são usadas para outras tarefas, incluindo Pesquisa
de tags, Preferências e Conexões no suplemento para Excel 2007.

Noções básicas
PI DataLink for Excel XP-2003
O PI DataLink for Excel XP-2003 aparece no Microsoft Excel como um menu padrão e
controles de caixa de diálogo relacionados.
Se você usava versões anteriores do PI DataLink, o suplemento para Excel XP-2003 mantém
a mesma aparência.
Menu PI
O PI DataLink for Excel XP-2003 adiciona um menu PI à barra de menus do Excel quando o
suplemento PI DataLink é carregado. Se o menu PI não for exibido, poderá ser necessário
configurar (página 4) o suplemento PI DataLink for Excel.
O PI DataLink for Excel XP-2003 usa uma configuração de menu padrão:

• Escolha um item no menu PI para abrir uma caixa de diálogo correspondente.
10
Caixas de diálogo de funções

O PI DataLink for Microsoft Excel XP-2003 fornece caixas de diálogo para definir funções
do PI DataLink.
O PI DataLink abre uma caixa de diálogo de função correspondente quando você adiciona ou
edita uma função. Para abrir uma caixa de diálogo de função:
• Clique em uma célula e então escolha uma função no menu PI para adicionar uma
função.
• Clique com o botão direito do mouse em uma célula de um array de funções existente
para exibir o menu de contexto e então escolha o nome da função no menu para editar
argumentos da função.
Depois que uma caixa de diálogo de função estiver aberta:
• Insira ou altere valores e então clique em OK para salvar as alterações e fechar a caixa de
diálogo.
O PI DataLink recupera valores automaticamente do PI e popula o array de funções na
planilha quando você clica em OK.
• Clique em Cancelar ou X para fechar a caixa de diálogo sem salvar alterações.
Menu de contexto
O PI DataLink adiciona diversos comandos ao menu de contexto padrão do Microsoft Excel.

É possível usar esses comandos para gerenciar arrays de funções que já estejam inseridos em
uma planilha.
Observação: Os menus de contexto são os mesmos para ambas as versões de

suplementos do PI DataLink.

Noções básicas
Para exibir um menu de contexto:

• Clique com o botão direito do mouse em qualquer local de uma célula ou grupo de
células que contenha um array de funções do PI DataLink.
Um array de funções é o cluster de células que contém a saída de uma única função do PI
DataLink. Também é possível clicar com o botão direito do mouse em um controle de
tendência inserido para ver um menu de contexto relacionado (página 64).
Os seguintes itens aparecem no menu de contexto:
• Escolha Selecionar função do DataLink para selecionar o array de funções inteiro.
Você deve selecionar um array antes de tentar copiar, recortar ou arrastá-lo para um novo
local da planilha.
• Escolha Recalcular (Redimensionar) função para recalcular (página 54) o array,
recuperando novos valores do PI.
Para algumas funções, um número diferente de valores poderá estar disponível a cada
recálculo, causando o redimensionamento do array.
• Escolha <nome da função> para abrir uma caixa de diálogo de função (página 10)
correspondente e atualizar argumentos para coletar dados diferentes.
Conexões do PI Server
Use a caixa de diálogo Conexões para gerenciar conexões a PI servers no ambiente
computacional. Para conectar a um PI server:
• Clique no ícone Conexões na barra da faixa de opções (2007) ou escolha PI > Conexões
(2003) para exibir a caixa de diálogo Conexões.
Cada PI server configurado disponível para o PI DataLink aparece no painel Servidor à
esquerda.
Se o servidor desejado não for exibido, será possível adicionar uma conexão. Para adicionar
conexões de PI server adicionais:
Escolha Servidor > Adicionar servidor ou clique com o botão direito do mouse no painel do
servidor e escolha Adicionar servidor no menu de contexto para exibir a caixa de diálogo
Adicionar servidor e configurar uma nova conexão de PI server. Uma caixa de seleção
marcada próxima de um nome de servidor na caixa de diálogo Conexões indica uma conexão
aberta com o PI Server.
12
Componentes de função gráfica
Para gerenciar configurações de conexão:

• Clique para marcar a caixa de seleção e abra uma conexão com o PI Server na lista.
Desmarque a caixa de seleção para fechar uma conexão.
• Selecione um PI Server no painel do servidor para acessar configurações de conexão
Uma conexão aberta com um PI server é requerida para adicionar funções do DataLink
a uma planilha e recuperar valores do PI. Observação: O nome do PI server
padrão aparece no canto inferior direito da caixa de diálogo. É possível manter
conexões a mais de um PI server ao mesmo tempo, embora possa ser
necessário especificar o servidor de destino ao definir uma função do PI DataLink.

O PI DataLink fornece uma interface gráfica do usuário para criar funções no Excel. Os
recursos comuns de caixa de diálogo facilitam o fornecimento de argumentos para definir a
função.
A ferramenta usada para criar uma função depende da versão instalada do PI DataLink:
• O suplemento para Excel XP-2003 fornece caixas de diálogo (página 10) para definir
funções.
• O suplemento para Excel 2007 fornece painéis de tarefas (página 8) para definir funções.
• Usuários avançados familiarizados com o PI DataLink e o PI Server podem inserir
sintaxe de função (página 88) diretamente na barra de fórmulas do Excel.
As seções a seguir descrevem recursos comuns nas caixas de diálogo e nos painéis de tarefas
de funções do PI DataLink, como os dados em tempo real são obtidos e apresentados e como
as funções do PI DataLink podem ser usadas em uma planilha.

Noções básicas
Campos de entrada
Campos de entrada rotulados aceitam o uso de argumentos específicos para definir uma
função. A maioria dos argumentos pode ser inserida diretamente ou referenciada em células
de planilha. Embora as opções difiram por argumento, todos os campos de entrada permitem
uma ou mais das seguintes opções:
• Inserir texto diretamente em um campo de edição , como um nome

de tag ou o endereço de uma célula de saída.
• Selecionar um item entre opções em uma lista , como um cálculo ou um método de

amostragem.
• Referenciar células de planilha que contêm argumentos, como um nome de tag,

local de célula de saída ou carimbo de data e hora.
Observação: Certifique-se de inserir strings em células que possam ser

referenciadas com um apóstrofo (') à esquerda. Isso força o Excel a
interpretar o conteúdo como uma string.
• Selecione valores de um PI server ou outras fontes por meio de uma tag ou

pesquisa de banco de dados do módulo.
Por exemplo, é possível inserir uma string de nome de tag no campo Nome de tag ou clicar
no botão ao lado do campo para exibir a caixa de diálogo Pesquisa de tag e pesquisar o PI
server por tags.
Também é possível fornecer manualmente uma referência para uma célula de planilha que
contém um nome de tag:
• Clique primeiro no campo de edição e depois clique na célula (ou clique na célula e
arraste para uma célula adjacente para selecionar um intervalo) na planilha.
O DataLink insere automaticamente a referência de célula no campo de edição.
Observação: Alguns campos de entrada exibem uma entrada padrão quando a caixa
de diálogo ou o painel é aberto. Campos marcados como Opcional são opcionais
e um valor não é necessário.
14
Argumentos padrão
Alguns argumentos são comuns à maioria das funções do PI DataLink em caixas de diálogo
ou em painéis de tarefas, e normalmente são requeridos para definir a função:
Nome(s) de tag ou expressão

O campo Nome(s) de tag ou Expressão é requerido pela maioria das funções para avaliar
dados de ponto PI (tag) ou os resultados de uma expressão de PI (página 81). Um ou mais
nomes de tag, ou a sintaxe de uma expressão podem ser:
• Inseridos diretamente em um campo.
Por exemplo, sinusoid.
• Inseridos em uma ou mais células de planilha, que são então referenciadas no campo.
Por exemplo, uma referência ao array Sheet1!$B$3:Sheet1!$B$4, que por sua vez
contém as strings de nome de tag 'sinusoid e 'cdt158.
Observe que as referências de célula permitem que vários nomes de tag sejam
especificados para uma função, enquanto não é possível especificar diretamente vários
nomes de tag, a menos que o campo esteja rotulado Nome(s) de tag.
Observação: Note que aspas simples são adicionadas a cada nome de tag para
denotar valores string no Excel. As strings e as expressões de tempo
referenciadas em células devem ser incluídas entre aspas simples. Por
exemplo:
TimeEq('CD:M158','y' ,'t', "Manual")
• Selecionados no diálogo Pesquisa de tags (página 43), com base em uma pesquisa de
tags por nome, alias ou atributo.
Hora inicial
O início de um intervalo de tempo (página 16) durante o qual a função é avaliada, da Hora
inicial até a Hora final. Todos os valores de eventos correspondentes ao intervalo de tempo
são recuperados do arquivo do PI ou calculados para criar o array de funções resultante.
Hora final
O final do intervalo de tempo, frequentemente expresso como a hora atual, em que a Hora
inicial é a hora atual menos um intervalo de tempo especificado.
As horas iniciais e finais podem ser expressas em termos absolutos ou relativos para
estabelecer um intervalo de tempo no passado ou até e incluindo a hora atual.

Noções básicas
PI Server
Uma instância de uma função do PI DataLink é executada em relação a apenas um PI server.
O PI Server especifica um PI server de destino a partir de uma lista de servidores
conhecidos. Se você não selecionar um servidor ou deixar o campo em branco, o PI server
padrão (página 12) será usado.
Os servidores que aparecem acima da linha pontilhada na lista de servidores estão atualmente
conectados; aqueles abaixo dela estão desconectados.
Célula de saída
Especifique se deseja colocar o array de funções resultante usando o campo Célula de saída.
Caso selecione uma célula antes que o painel de tarefas ou a caixa de diálogo da função seja
exibido, a célula atualmente selecionada será usada como o valor padrão de Célula de saída.
O valor da célula de saída sempre especifica o canto superior esquerdo do array de funções.
Se você acrescentar (página 17) carimbos de data e hora e outros dados, lembre-se de que a
coluna de dados pode ser deslocada para baixo ou para a direita do local da célula de saída,
substituindo dados nessas células adjacentes.
Se você clicar no campo Célula de saída e depois selecionar um array de múltiplas células na
planilha, poderá substituir a exibição padrão de todos os resultados de função. Em vez disso,
somente os resultados que caibam nas dimensões do array especificado serão exibidos.
Argumentos de tempo
Muitas funções do PI DataLink requerem que os argumentos Hora inicial e Hora final
recuperem um array de valores de evento em um intervalo de tempo específico. Siga estas
diretrizes ao especificar argumentos de tempo:
• As strings de tempo podem ser inseridas diretamente em campos de edição em formatos
hora do PI (página 77) absolutos ou relativos (por exemplo, 10-Dec-99 19:12 ou -
3h).
• Se a hora inicial for mais recente que a hora final, os resultados serão exibidos em ordem
cronológica inversa.
• Os carimbos de data e hora referenciados em células da planilha também podem usar
formatos hora do PI fixos ou relativos, e devem ser precedidos por um apóstrofo para
indicar uma string (por exemplo, '10-Dec-99 19:12 ou '-3h).
• As referências de célula também podem usar o formato de tempo absoluto do Excel
(como 39299.6146, equivalente a 8/5/2007 2:45:00 PM). O Excel armazena
carimbos de data e hora nesse formato, que representa o número cumulativo de dias
desde 1900. O Excel pode exibir os mesmos carimbos de data e hora usando qualquer
formato data-hora atribuído à célula.
16
• Alguns argumentos necessitam de um intervalo ou duração de tempo, representados por

um único valor em vez de horas iniciais e finais. Sejam referenciados ou inseridos
diretamente, os valores de intervalo devem usar as strings de hora relativas do PI, como
um número seguido por uma variável de tempo (por exemplo, 1d ou 30m), e não podem
especificar ou referir-se a um carimbo de data e hora fixo do PI ou do Excel. Por
exemplo, para especificar um intervalo de 32 minutos, insira ou referencie uma célula
que contenha a string 32m.
• Para inserir intervalos em termos de frequência, converta a frequência em segundos
equivalentes. Por exemplo, a frequência 25 Hz deve ser inserida como um intervalo
0.04s (=1/25 de um segundo).
• Ao usar formatos relativos (por exemplo, -2h), a hora de referência usada para traduzir o
formato de hora é diferente para horas iniciais e finais de funções. A hora atual do relógio
de parede é a referência para uma hora inicial relativa, mas a hora inicial será então usada
como a referência para uma hora final relativa.
Observação: O PI DataLink oferece suporte apenas ao sistema de datas 1900 padrão

suportado pelo Excel. O PI DataLink não oferece suporte ao sistema de datas
1904 do Excel, e retorna carimbos de data e hora incorretos se esse sistema for
usado.
Dados acrescentados
Os carimbos de data e hora são especialmente relevantes aos eventos de ponto PI. Cada valor
de evento é acompanhado por um carimbo de data e hora que lhe fornece contexto.
A maioria das funções do PI DataLink pode retornar valores de carimbo de data e hora
correspondentes e outros dados de ponto com valores de expressão calculados ou de evento
do PI. Esses dados podem ser acrescentados aos valores retornados em um array de funções
do PI, e incluem:
• carimbos de data e hora de eventos
• carimbos de data e hora que indicam as horas inicial e final de um intervalo
• carimbos de data e hora que indicam a ocorrência de valores mínimos e máximos
• o percentual de valores válidos em um intervalo de amostragem
• atributos de valores
• anotações de evento inseridas manualmente
• nomes de PI server de origem
Quando especificados, os dados acrescentados aparecem em colunas (ou fileiras) adjacentes
aos valores primários retornados por uma função, de acordo com as seguintes regras:
• Dados de tempo são adicionados em colunas à esquerda (ou fileiras acima) dos valores
primários.
• Outros dados relacionados são adicionados em colunas à direita (ou fileiras abaixo) dos
valores primários.

Noções básicas
Array de dados acrescentados

A tabela a seguir ilustra como os dados são acrescentados por função. Para funções que
podem exibir saída em fileiras ou colunas (página 20), substitua as colunas 1-5 pelas fileiras
1-5.
Colunas de array de funções
Função/modo Célula de Coluna 2 Coluna 3 Coluna 4 Coluna 5

saída
Qualquer função sem valor
dados acrescentados
Valor atual e do carimbo de valor
arquivo, Dados de data e hora
amostragem
Dados compactados carimbo de valor anotações
data e hora
Hora filtrada hora inicial hora final valor percentual
válido
Calculado (mínimo) hora inicial hora final hora mínima valor
mínimo
Calculado (máximo) hora inicial hora final hora máxima valor
máximo
Calculado (intervalo) hora inicial hora final hora mínima hora máxima valor
Calculado (outro) hora inicial hora final valor percentual
válido
Alias servidor valor
Observação: A tabela assume que todos os dados acrescentados sejam especificados

para exibição e que alguns arrays de funções podem ser expandidos para cinco
colunas se todos os dados relacionados forem acrescentados.
Mostrar carimbos de data e hora

Uma caixa se seleção mostrar carimbos de data e hora aparece quando uma função retorna
um array de valores de PI com o passar do tempo. Se for selecionada, essa opção retornará
um carimbo de data e hora correspondente a cada valor de evento de PI.
Para funções que retornam múltiplos valores de evento (por exemplo, Dados de
amostragem), os controles de orientação (página 20) determinam como os carimbos de data e
hora são exibidos em relação a cada valor.
Para algumas funções que retornam um único valor (por exemplo, Valor atual), são
fornecidos botões de rádio para fornecer opções equivalentes:
• Selecione sem carimbo de data e hora para suprimir a exibição do carimbo de data e
hora.
• Selecione tempo à esquerda para retornar um carimbo de data e hora em uma célula à
esquerda do valor de evento.
18
• Selecione tempo na parte superior para exibir o carimbo de data e hora em uma célula
acima do valor de evento recuperado.
Quando uma referência a um array de nomes de tag em células for especificada no campo
Nome de tag, essas preferências serão ignoradas. Em vez disso, os valores de evento e
carimbo de data e hora serão posicionados a fim de corresponder à orientação do array de
tags de entrada. Para nomes de tag em uma única coluna, os carimbos de data e hora
aparecem à esquerda dos valores. Para nomes de tag em uma única fileira, os carimbos de
data e hora aparecem na parte superior dos valores.
Carimbos de data e hora de intervalo

As funções que retornam valores a intervalos de tempo específicos (por exemplo, Dados
calculados) fornecem opções para exibir carimbos de data e hora diferentes:
• Escolha mostrar hora inicial para exibir a hora inicial de cada intervalo.
• Escolha mostrar hora final para exibir a hora final de cada intervalo.
Para valores de intervalo, mínimo e máximo calculados:
• Escolha mostrar hora mín/máx para exibir carimbos de data e hora para valores
mínimos e máximos em cada intervalo.
Os carimbos de data e hora são exibidos de forma a corresponder à orientação de fileira ou
coluna especificada. Se todos os carimbos de data e hora forem mostrados, a ordem da coluna
da esquerda para a direita ou fileira superior para inferior será hora inicial, hora final, tempo
de valor mínimo, tempo de valor máximo, valor do evento.
Mostrar percentual válido

Selecione mostrar percentual válido para exibir o percentual de tempo para o qual valores
válidos são retornados durante o intervalo de tempo total do array. Valores percentuais
válidos normalmente são adicionados a uma coluna à direita ou a uma fileira abaixo dos
valores recuperados.
Valores válidos são valores de evento determinados como válidos pelo PI server, e não em
um estado de erro. O percentual de valores válidos ajuda na avaliação da confiabilidade de
cálculos efetuados em valores de ponto PI, especialmente se os valores calculados devem ser
usados em cálculos adicionais.
Por exemplo, totais ainda podem ser calculados durante um intervalo de tempo, mesmo que
alguns dos dados sejam inválidos. O valor total com peso de tempo resultante é igual ao total
dividido pela fração do interval em que os dados válidos estão disponíveis.
Entretanto, essa normalização assume que a média durante o intervalo de tempo com dados
inválidos seja equivalente ao valor médio durante o intervalo de tempo inteiro, o que se torna
menos confiável se uma grande fração do intervalo de tempo contiver dados inválidos.

Noções básicas
Mostrar atributos do valor

Selecione mostrar atributos do valor para exibir bits de status estendidos associados aos
valores de evento retornados. Os bits retornados correspondem aos atributos de valor
armazenados no PI, e podem ser um dos seguintes:
• A = anotado, indicando que um comentário foi adicionado ao evento
• S = substituído, indicando que o valor do evento foi alterado de seu valor original
• Q = questionável, indicando que há alguma razão para duvidar da exatidão do valor
Os atributos de valor são exibidos em uma coluna à direita dos valores do evento.
Mostrar anotações
Selecione mostrar anotações para exibir quaisquer anotações associadas aos valores de
evento retornados em uma coluna à direita.
As anotações são observações ou comentários acrescentados a um valor de dados no PI com
finalidade descritiva.
Controles de orientação
Para funções que retornam um array de valores de PI, use os botões coluna e fileira para
determinar a orientação dos dados retornados.
• Escolha coluna para exibir dados em colunas.
• Escolha fileira para exibir os dados em fileiras.
Fileiras ou colunas adicionais (página 17) são adicionadas para carimbos de data e hora e
dados relacionados se eles forem selecionados para exibição. O campo Saída da função
sempre indica o canto superior esquerdo do intervalo inteiro usado para o array.
Observação: Para funções que retornam um intervalo de valores, a orientação do array

de tags de entrada substitui a seleção de fileira e coluna para determinar a
orientação dos dados de saída.
20
Formatos de exibição
É possível alterar os formatos padrão de hora e número usados pelo PI DataLink para
formatar dados em arrays de funções. Os formatos padrão são especificados na caixa de
diálogo Configurações (página 22), onde estão disponíveis duas configurações para formatos:
• O formato de número padrão Geral formata números (e todos os dados que não sejam
carimbo de data e hora) de maneira que correspondam à formatação Categoria Geral na
caixa de diálogo Formatar células do Excel.
• O formato de hora padrão dd-mmm-yy hh:mm:ss corresponde ao formato padrão de
carimbo de data e hora do PI. É possível adicionar .000 ao final da string (dd-mmm-yy
hh:mm:000) para exibir carimbos de data e hora com frações de segundo. Observe que o
Excel não oferece suporte a formatos de precisão com microssegundos.
É possível personalizar strings de formato padrão usando quaisquer códigos de formato
válidos do Excel na caixa de diálogo Formatar células do Excel. Por exemplo, o equivalente
em alemão para Geral e dd-mmm-yyyy hh:mm são Padrão e TT-MM-JJJJ hh:mm,
respectivamente.
Também é possível aplicar formatação individual de data e hora a qualquer célula da planilha,
incluindo aquelas que contenham funções do PI DataLink, escolhendo Formatar > Células >
Número. Consulte a documentação do Excel para obter informações adicionais sobre a
formatação de datas e horas.

Noções básicas
Configurações de preferência
Use a caixa de diálogo Configurações para especificar preferências globais e formatação
padrão para a saída de funções do PI DataLink.
Para acessar configurações:

1. Clique em Configurações na faixa de opções PI (2007) ou escolha PI > Configurações
(2003).
2. Defina as preferências desejadas e clique em OK.
22
Configurações de preferência
Copiar itens para planilha

Escolha Em uma fileira ou Em uma coluna para copiar os nomes de várias tags
selecionadas em uma Pesquisa de tags (ou itens em uma pesquisa Procurar módulo) para a
planilha em uma fileira ou coluna de valores, respectivamente. A configuração padrão é Em
uma coluna.
Esse comando também está disponível como um atalho para o item Pesquisa de tags da faixa
de opções (2007).
Copiar nome do PI Server

Marque a caixa de seleção para copiar o nome da origem de dados do PI server para uma
célula de planilha adjacente quando nomes de tag forem copiados para uma planilha.
Usar fuso horário do PI Server

Marque a caixa de seleção para forçar que o PI DataLink use o fuso horário do PI Server
como um valor de referência para interpretar funções. Se estiver desmarcada, o PI DataLink
usará a configuração de fuso horário da máquina cliente.
Essa opção é relevante apenas se um PI server tiver uma configuração de fuso horário
diferente do computador cliente.
Exibir #N/A em vez de campos em branco

Marque a caixa de seleção para substituir #N/A (Não Aplicável) para células em branco
quando houver menos pontos de dados que células em um array de funções. As funções
adicionadas a uma planilha mantêm seu tamanho de array original, mesmo se a variância em
um determinado período de tempo produzir menos valores de dados, resultando em uma ou
mais células vazias.
Esse recurso é especialmente útil quando resultados de função são plotados com o pacote de
gráficos do Excel.
Locale Independente
Marque a caixa de seleção para forçar o PI DataLink a interpretar strings de tempo de entrada
de acordo com as regras de formato de tempo do PI, independentemente das configurações de
locale do computador cliente. O tempo do PI assume que todas as strings estejam no formato
inglês e usem a ordem data-hora dd-MMM-yyyy hh:mm:ss.
Desmarque a caixa de seleção para analisar formatos data-hora de acordo com configurações
regionais no computador cliente, retornando para regras de formato de tempo do PI somente
quando necessário.
Desabilitar exibição de painel de tarefa automática ao clicar

Apenas para o Excel 2007, marque essa caixa de seleção para impedir a exibição automática
do painel de tarefas de função ao clicar em uma célula de função. Clique com o botão direito
do mouse no menu de contexto e escolha o nome da função para exibir o painel
manualmente.

Noções básicas
Desabilitar mensagem "Redimensionar para mostrar todos os valores"

Marque essa caixa de seleção para não exibir uma mensagem de aviso quando o número de
valores recuperados por um array recalculado exceder o número que pode ser exibido.
Formato de número
Insira um formato de número para indicar como a saída de função numérica deve ser exibida
por padrão. A string de formato pode ser qualquer código de formato de número válido da
caixa de diálogo Formato do Excel (página 20).
Durante a instalação, o PI DataLink atribui o formato de número padrão do Excel a esse
campo, a menos que você tenha definido sua própria preferência de formato anteriormente no
DataLink. Se a versão do Excel for executada em um locale diferente, esse formato incluirá a
sintaxe correta para refletir o locale. Por exemplo:
35.03
apareceria como
35,03
no Excel francês.
Formato de hora
Insira um formato de carimbo de data e hora para a saída da função. A string de formato de
hora pode ser qualquer código de formato data-hora (página 16) válido da caixa de diálogo
Formato do Excel.
Durante a instalação, o DataLink atribui o formato de carimbo de data e hora padrão do PI a
esse campo, a menos que você tenha definido sua própria preferência de formato
anteriormente no DataLink. Se a versão do Excel for executada em um locale diferente, esse
formato incluirá a sintaxe correta para refletir o locale. Por exemplo:
dd-mm-yy (03-07-09)
apareceria como
jj-mm-aa (03-07-09)
no Excel francês.
Atualização automática
Use esta seção para definir preferências para Atualização automática (página 53) quando
esse recurso estiver habilitado:
Escolha um método de cálculo:
• Calcular (F9) força que todas as funções voláteis (e quaisquer funções que as
referenciem) sejam recalculadas.
• Calcular por inteiro (Ctrl+Alt+Shift+F9) força que todas as funções inseridas,
independentemente da volatilidade, sejam recalculadas.
Em seguida, insira um intervalo de cálculo em segundos. O valor mínimo é 5 segundos. Insira
0 para aceitar o intervalo automático selecionado pelo PI DataLink com base na duração de
tempos de cálculo anteriores.
24
Construção de planilhas
Construção de planilhas
Quando estiver familiarizado com as ferramentas e conceitos básicos do PI DataLink, e
estiver pronto para criar uma planilha e usar as funções do PI DataLink, onde você começa?
Suas metas
Considere primeiramente suas metas.
• Quais dados deseja exibir em uma planilha a fim de monitorar o desempenho ou
responder a uma questão comercial?
• Em qual PI server os dados residem?
• Como é possível exibir as informações mais efetivamente, tanto para comunicar pontos
essenciais como para fornecer o contexto de segundo plano necessário?
As respostas ajudarão a determinar quais funções do PI DataLink podem retornar os dados
mais relevantes à tarefa.
Funcional
Uma maneira de criar uma planilha é simplesmente adicionar funções (página 27),
construindo a exibição em torno delas conforme necessário. Posteriormente, será possível
adicionar informações de tag para ajudar a esclarecer o que os dados representam. Essa pode
ser a melhor abordagem se você ainda estiver explorando seus requisitos ou aprendendo
como o PI DataLink funciona.
Estruturado
Outra forma de criar uma planilha é adicionar estrutura desde o início. Use funções de tag e
pesquisa de tags (página 43) para adicionar tags e outros atributos como metadados para
enquadrar seu assunto; em seguida, adicione funções para recuperar os dados de ponto PI
correspondentes. Isso requer um pouco mais de planejamento e familiaridade com o PI
DataLink, mas uma vez que as informações de tag estejam presentes na planilha, será
possível usá-la para criar funções mais facilmente entre referências de célula. As planilhas
criadas dessa maneira também são mais flexíveis para reuso.
Baseado em módulos
Se configurou o PI Module Database para seu PI server, poderá criar flexibilidade máxima na
planilha pela incorporação de objetos do banco de dados do módulo (página 49). Da mesma
forma que os dados de tag, os objetos de banco de dados do módulo podem ser referenciados
em funções. Também é possível adicionar recursos de contexto do módulo para maximizar o
reuso potencial da planilha entre assuntos paralelos ou redundantes.
Relatórios direcionados
Caso seja um administrador do sistema ou um construtor de planilhas para outros usuários,
poderá desejar colocar as funções do PI DataLink em uma segunda planilha em uma pasta de
trabalho e copiar/colar os resultados na primeira planilha para exibição. A sintaxe da função e
a lógica comercial podem ser ocultadas e protegidas usando o Excel para proteger a segunda
planilha. Essa estratégia também funciona bem para documentos distribuídos com o PI DLES
(página 3).

Capítulo 3
Funções do PI
As funções do PI DataLink permitem consultar, calcular e retornar atributos e valores de
ponto PI para células de planilha. Como outras funções do Excel, os resultados de funções do
PI DataLink são exibidos em arrays que podem ser recalculados para exibir valores de
eventos atualizados, conforme necessário.
Para acessar as funções do PI:
• Clique na célula de saída desejada e escolha PI > (nome da função) para abrir um
diálogo de função (XP-2003), ou clique em uma função na faixa de opções do PI para
abrir um novo painel de tarefa de função (2007).
As descrições de funções nesta seção mostram argumentos específicos a cada função em
termos desses recursos comuns.
Valor atual
Recupera o valor atual ou mais recente (instantâneo) de um ponto PI, com base no nome da
tag.
ARGUMENTOS OBRIGATÓRIOS
• Nome da tag
OBSERVAÇÕES ESPECIAIS
• Referencie um intervalo de células que contenha nomes de tag para exibir valores de
instantâneos atuais para cada um.
• É atualizado sempre que o Excel calcula ou recalcula qualquer célula na planilha. Para
forçar um recálculo imediato, pressione F9.
EXEMPLO
Para consultar o valor atual da tag sinusoid, os seguintes argumentos são definidos para a
função Valor atual:
Tagname (Nome da tag) = sinusoid
time at left (tempo à esquerda)
e o array de funções resultante aparece como:

Funções do PI
TÓPICOS RELACIONADOS
• PICurrVal() (página 95)
Valor do arquivo
Recupera um valor de ponto PI ou avalia uma expressão correspondente a um carimbo de
data e hora especificado.
• Nome de tag ou expressão
• Carimbo de data e hora
CARIMBO DE DATA E HORA

A referência de tempo usada para recuperar o valor de arquivo do PI, que pode ser um valor
de hora (página 16) fixo ou expresso relativo à hora atual.
MODO DE RECUPERAÇÃO
É possível selecionar um entre cinco modos para produzir um valor de arquivo:
• Anterior - recupera o valor exatamente correspondente ou que precede o carimbo de data
e hora especificado.
• Somente anterior - recupera o valor que precede o carimbo de data e hora especificado.
• Interpolado - interpola o valor no horário especificado ou segue o comportamento de
Somente anterior.
• Auto - interpola o valor no horário especificado ou segue o comportamento de Anterior.
• Próximo - recupera o valor exatamente correspondente ou que sucede o carimbo de data e
hora especificado.
• Somente próximo - recupera o valor que sucede o carimbo de data e hora especificado.
• Tempo exato - recupera somente um valor exatamente correspondente ao carimbo de data
e hora, ou retorna Nenhum evento encontrado se nenhum valor existir.
• Referencie um intervalo de células que contenha nomes de tag para exibir valores
arquivados para cada um.
• Para tags com atributos de etapas, os modos Anterior e Somente anterior são substituídos
pelos modos de cálculo Auto e Interpolado, respectivamente.
• PIExpVal() será usada se uma expressão for substituída por uma tag; caso contrário,
PIArcVal() será usada.
28
Dados compactados
EXEMPLO
Para consultar o valor da tag sinusoid correspondente a uma hora específica, os seguintes
argumentos são definidos para a função Valor do arquivo:
Timestamp (Carimbo de data e hora) = 30-Sep-07 15:13
Retrieval Mode (Modo de recuperação) = previous
time at left (tempo à esquerda)
• PIArcVal() (página 96)
• PIExpVal() (página 97)
Dados compactados
Retorna todos os valores de um ponto PI ocorridos em um intervalo de tempo especificado ou
um número de valores de ponto iniciando em um determinado horário.
Valores compactados são dados registrados pelo PI server após um algoritmo de compactação
ter removido todos os valores que representam a mesma inclinação.
Observação: Caixas de diálogo separadas são fornecidas para Dados compactados

(Hora inicial/Hora final) e Dados compactados (Hora inicial/Número) no PI
DataLink for Excel XP-2003. Para o 2007, é possível selecionar um cálculo por
Intervalo de tempo ou Número de valores no painel de tarefas.
• Nome da tag
• Hora inicial
• Hora final ou Número de valores, dependendo do tipo de função
EXPRESSÃO DE FILTRO
Adicione uma expressão de filtro a fim de filtrar valores de evento usando uma expressão
matemática, eliminando dados para os quais a expressão é avaliada como falsa. A expressão
de filtro é aplicada aos dados brutos do PI (e não a valores resultantes do próprio cálculo).

Funções do PI
Por exemplo, a expressão de filtro simples:

sinusoid < 70
removeria do cálculo todos os valores acima de 70. Também é possível usar qualquer
equação de desempenho válida do PI na expressão de filtro para criar expressões mais
complexas a fim de remover picos atípicos nos valores de dados, por exemplo.
Selecione marcar como filtrado para substituir Filtrado como um espaço reservado para
cada valor ou bloco de valores filtrados do array com base na expressão (página 81) do filtro.
TIPO DE LIMITE
Especifique um tipo de limite para determinar como as pesquisas do Editor de arquivo por
valores de dados são tratadas próximas às horas inicial e final do intervalo de valores:
• Dentro (padrão): Retorna valores ocorridos nas horas inicial e final, se existirem, ou os
valores mais próximos dentro do intervalo.
• Fora: Retorna os valores mais próximos ocorridos imediatamente fora do intervalo.
• Interpolado: Retorna valores interpolados nas horas inicial e final.
• Auto: Interpolado, mas usando o comportamento de Dentro para tags com atributos de
nível definidos em PI Servers com base no Windows.
CONTAGEM DE VALORES
Normalmente, a primeira fileira ou coluna do array inclui a contagem de valores recuperados
para o intervalo de tempo. Selecione ocultar contagem para ocultar a contagem de valores e
mostrar apenas os valores recuperados no array.
MOSTRAR ATRIBUTOS DO VALOR

Selecione mostrar atributos do valor para exibir bits de status estendidos associados aos
valores de evento retornados. Os bits retornados correspondem aos atributos de valor
armazenados no PI, e podem ser um dos seguintes:
• A = anotado, indicando que um comentário foi adicionado ao evento
• S = substituído, indicando que o valor do evento foi alterado de seu valor original
• Q = questionável, indicando que há alguma razão para duvidar da exatidão do valor
Os atributos de valor são exibidos em uma coluna à direita dos valores do evento.
MOSTRAR ANOTAÇÕES
Selecione mostrar anotações para exibir quaisquer anotações associadas aos valores de
evento retornados em uma coluna à direita.
As anotações são observações ou comentários acrescentados a um valor de dados no PI com
finalidade descritiva.
30
Dados compactados
• Referencie um intervalo de nomes de tag para exibir valores compactados para cada um.
Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags
referenciadas, e em colunas para uma fileira de tags referenciadas.
• Se a Hora inicial ou final for a hora atual (*), o primeiro (ou o último) valor será na
realidade o valor instantâneo atual, e não um valor de arquivo. Depois que o valor do
instantâneo passar pelo algoritmo de compactação do PI Server, ele poderá não ser
realmente registrado no PI.
• A função PICompFilDat() será usada para funções de Hora final se uma expressão
de filtro for especificada; caso contrário, a função PICompDat() será usada.
• A função PINCompFilDat() será usada para funções Número de valores se uma
expressão de filtro for especificada; caso contrário, a função PINCompDat() será
usada.
EXEMPLO
Para consultar os dez valores mais recentes da tag sinusoid, os seguintes argumentos são
definidos para a função Dados compactados:
Number of Values (Número de valores)
Start Time (Hora inicial) = <referência de célula para a hora atual>
Number of Values (Número de valores) = 10
backwards in time (voltar no tempo)
Boundary Type (Tipo de limite) = inside
show timestamps (mostrar carimbos de data e hora)
column (coluna)
Observe que todos os eventos entre duas horas especificadas também poderiam ser
recuperados pela mesma função usando o argumento Intervalo de horas.

Funções do PI
• Expressões de filtro (página 81)
• PICompDat() (página 99)
• PICompFilDat() (página 100)
• PINCompDat() (página 98)
• PINCompFilDat() (página 98)
Dados de amostragem
Retorna valores de amostragem interpolados com espaçamento uniforme para um ponto PI ou
expressão em um intervalo regular.
• Hora inicial
• Hora final
• Intervalo de tempo
INTERVALO DE TEMPO
Insira um intervalo de tempo como uma expressão de tempo do PI (página 77). O intervalo é
a frequência de amostragem usada para coletar ou calcular valores durante o intervalo de
tempo.
Por exemplo, o intervalo 15m (15 minutos) retorna um valor a cada intervalo de 15 minutos.
sinusoid < 70
32
Dados de amostragem
• É possível usar uma Expressão do PI (página 81) em vez do nome de uma tag para essa
função.
• Referencie um intervalo de nomes de tag para exibir valores de amostragem para cada
um. Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags
• A função PISampFilDat() será usada se uma expressão de filtro for especificada;
caso contrário, a função PISampDat() será usada.
• PIExpDat() será usada se uma Expressão do PI for substituída para uma tag.
EXEMPLO
Para consultar valores interpolados periódicos durante as 24 horas anteriores da tag
sinusoid, os seguintes argumentos são definidos para a função Dados de amostragem:
Start Time (Hora inicial) = -1d
End Time (Hora final) = <referência de célula para a hora atual>
Time Interval (Intervalo de tempo)= 3h
show timestamps (mostrar carimbos de data e hora)
column (coluna)
onde um valor é exibido para cada intervalo de três horas.
• PISampDat() (página 101)
• PISampFilDat() (página 102)
• PIExpDat() (página 104)

Funções do PI
Dados com marcação de tempo

Retorna valores de amostragem interpolados ou reais para um ponto PI, de forma a
corresponder a um array de carimbos de data e hora especificados.
• Nome da tag
• Carimbo de data e hora
CARIMBO DE DATA E HORA

Uma referência a uma ou mais células de planilha que contenham valores de carimbo de data
e hora.
MODO DE RECUPERAÇÃO
Há dois modos disponíveis para seleção:
• Interpolado - interpola valores correspondentes a carimbos de data e hora especificados.
• Tempo exato - recupera somente valores exatamente correspondentes a carimbos de data
e hora especificados, ou retorna Nenhum evento encontrado se nenhum valor existir.
função.
• Referencie um intervalo de nomes de tag para exibir valores com marcação de tempo
para cada um. Observe que, por padrão, os valores são exibidos em fileiras para uma
coluna de tags referenciadas, e em colunas para uma fileira de tags referenciadas.
• Para tags com atributos de nível, o valor que precede um carimbo de data e hora
especificado será substituído por um valor interpolado quando o modo de cálculo for
Interpolado.
EXEMPLO
Para consultar valores correspondentes a um array de carimbos de data e hora para a tag
sinusoidu, os seguintes argumentos são definidos para a função Dados com marcação de
tempo:
Tagname (Nome da tag) = sinusoidu
Timestamps (Carimbos de data e hora) = <referência de célula para array existente de
dados compactados para a tag sinusoid >
Retrieval Mode (Modo de recuperação) = interpolated
34
Dados calculados
onde a coluna de dados com marcação de tempo aparece na coluna à direita, com base nos
carimbos de data e hora recuperados para uma tag diferente nas primeiras duas colunas à
esquerda.
• PITimeDat() (página 104)
• PITimeExpDat() (página 105)
Dados calculados
Retorna um ou mais valores calculados com espaçamento uniforme com base em valores de
ponto PI ou expressões avaliadas. São fornecidos um intervalo de cálculo diferente e
preferências de amostragem.
Observação: São fornecidas caixas de diálogo separadas para Dados calculados e

Dados calculados avançados no PI DataLink for Excel XP-2003. Para a versão do
Excel 2007, clique no sinal + sign ao lado de Avançado para acessar todas as
opções da função em um único painel de tarefas Dados calculados.
• Hora inicial
• Hora final
• Fator de conversão

Funções do PI
sinusoid < 70
INTERVALO DE TEMPO
tempo.
MODO DE CÁLCULO
Os seguintes cálculos são fornecidos:
• Total
• Mínimo
• Máximo
• Desvio padrão
• Intervalo
• Média
• Contagem
• Mediana
Todos os modos de cálculo possuem peso de tempo, exceto a função Mediana, que é uma
versão com peso de evento da função Média.
BASE DE CÁLCULO
Selecione uma base com peso de tempo ou de evento para o cálculo:
• Os cálculos possuem peso de tempo por padrão. Cada valor de evento é ponderado com
finalidade de cálculo pela duração de tempo ao qual o evento é aplicado.
• Os cálculos com peso de evento ponderam cada valor de evento igualmente. Deve haver
pelo menos um evento (dois para cálculos de desvio padrão) em um intervalo de tempo
para que o cálculo tenha êxito.
36
Dados calculados
FATOR DE CONVERSÃO
O fator de conversão é usado para cálculos de Total em que a unidade de tempo do ponto
calculado não é a mesma que a unidade de tempo padrão do servidor. Um fator de conversão
poderá ser necessário para converter nas unidades desejadas para o cálculo a partir do padrão
do servidor para unidades por dia.
A tabela a seguir ilustra o uso de fatores de conversão para pontos usando diferentes unidades
de fluxo. Observe que o fator de conversão igual a um significa que ele não é necessário, e
que as unidades não podem ser especificadas.
Unidade de fluxo Fator de conversão necessário para corresponder ao padrão do
servidor (unidades/dia)
Unidades/dia 1.0
Unidades/hora 24
Unidades/minuto 1440
Unidades/segundo 86400
MODO DA AMOSTRAGEM DE EXPRESSÃO

Diferentes modos de amostragem estão disponíveis para funções que incluem expressões:
• Para cálculos de PI tag, selecione um dos três modos de amostragem.
ο O modo Ponto compactado é o padrão usado para cálculos de PI tag. Esse modo
considera os carimbos de data e hora da PI tag para a qual o cálculo está sendo
executado. Ele não considera carimbos de data e hora para outras PI tags usadas na
expressão do filtro. Esse modo executa o cálculo usando os intervalos de tempo entre
carimbos de data e hora em que a expressão de filtro é avaliada como verdadeira.
Ponto compactado é menos caro computacionalmente que o modo Expressão
compactada; entretanto, o modo Expressão compactada gera resultados mais exatos.
ο O modo Expressão compactada considera os carimbos de data e hora de PI tags
usadas na expressão de filtro. Ele não considera os carimbos de data e hora da PI tag
para a qual o cálculo está sendo executado, a menos que a PI Tag seja usada na
expressão de filtro. Esse modo determina os intervalos para os quais a expressão de
filtro é verdadeira e depois executa o cálculo usando o valor interpolado das
extremidades do intervalo. O modo Expressão compactada produz resultados mais
exatos ao custo do desempenho.
ο O modo Interpolado avalia a expressão em intervalos de amostragem com
espaçamento uniforme determinados pela Frequência da amostragem de expressão.
• Para cálculos de expressão do PI, selecione um dos dois modos de amostragem:
ο O modo Compactado avalia a expressão para cada valor de evento nos carimbos de
data e hora correspondentes.
ο O modo Interpolado avalia a expressão em intervalos de amostragem com
espaçamento uniforme determinados pela Frequência da amostragem de expressão.

Funções do PI
FREQUÊNCIA DA AMOSTRAGEM DE EXPRESSÃO

Especifique a frequência na qual um cálculo ou expressão de filtro é avaliada quando o Modo
da amostragem de expressão estiver definido como Interpolado.
Por exemplo, a frequência 10m (10 minutos) retorna um valor interpolado a cada intervalo de
10 minutos enquanto a expressão de filtro for avaliada como verdadeira.
PERCENTUAL MÍNIMO VÁLIDO

Especifique o percentual de dados válidos (página 19) mínimo requerido em cada intervalo
de tempo a fim de calcular e retornar um valor. Dados válidos insuficientes é substituído
como um espaço reservado quando um valor não é retornado.
CARIMBOS DE DATA E HORA

• Selecione mostrar hora inicial para exibir a Hora inicial de cada intervalo usado para
calcular um valor. As horas iniciais são adicionadas a uma coluna à esquerda ou a uma
fileira acima dos valores calculados.
• Selecione mostrar hora final para exibir a Hora final de cada intervalo usado para
calcular um valor. As horas finais são adicionadas a uma coluna à esquerda ou a uma
fileira acima dos valores calculados.
• Para cálculos de Máximo, Mínimo e Intervalo, selecione mostrar hora mín/máx para
exibir carimbos de data e hora correspondentes a mínimos e/ou máximos em cada
intervalo usado para calcular um valor:
ο Para cálculos de Mínimo e Máximo, o carimbo de data e hora do valor
correspondente é exibido.
ο Para funções de Intervalo, os dois carimbos de data e hora são exibidos.
PERCENTUAL VÁLIDO
Selecione mostrar percentual válido para exibir o percentual de tempo para o qual valores
válidos são retornados durante o intervalo de tempo total do array. Valores percentuais
válidos normalmente são adicionados a uma coluna à direita ou a uma fileira abaixo dos
valores recuperados.
Valores válidos são valores de evento determinados como válidos pelo PI server, e não em
um estado de erro. O percentual de valores válidos ajuda na avaliação da confiabilidade de
cálculos efetuados em valores de ponto PI, especialmente se os valores calculados devem ser
usados em cálculos adicionais.
função.
• Referencie um intervalo de nomes de tag para exibir valores calculados para cada um.
Observe que, por padrão, os valores são exibidos em fileiras para uma coluna de tags
• Para cálculos de Máximo ou Mínimo com intervalos especificados, os carimbos de data e
hora indicam a hora inicial de cada intervalo de cálculo.
38
Dados calculados
• Os carimbos de data e hora não podem ser exibidos para os cálculos Total, Desvio
Padrão, Média, Contagem ou Mediana quando o intervalo não for especificado.
• A função PIAdvCalcVal() será usada para recuperar um único valor se não for
especificado um intervalo; caso contrário, a função PIAdvCalcDat() será usada para
recuperar múltiplos valores de intervalo. Os nomes de função, incluindo 'Exp' e 'Fil' são
usados para cálculos que incluem Expressões do PI e Expressões de filtro,
respectivamente.
EXEMPLO
Para consultar o intervalo de valores por hora que começam no mesmo dia à meia-noite até a
hora atual para a tag sinusoid, os seguintes argumentos são definidos para a função Dados
calculados:
PI Tag
Start Time (Hora inicial) = t
End Time (Hora final) = *
Time Interval (Intervalo de tempo) = 1h
Calculation Mode (Modo de cálculo) = range
Calculation Basis (Base de cálculo) = time-weighted
show start time (mostrar hora inicial)
show end time (mostrar hora final)
column (coluna)
onde o intervalo é calculado para cada intervalo de uma hora. Observe que qualquer cálculo
disponível poderia ser especificado para qualquer intervalo.

Funções do PI
• Expressões de cálculo (página 81)
• PIAdvCalcVal() (página 108)
• PIAdvCalcFilVal() (página 109)
• PIAdvCalcExpVal() (página 111)
• PIAdvCalcExpFilVal() (página 112)
• PIAdvCalcDat() (página 114)
• PIAdvCalcFilDat() (página 114)
• PIAdvCalcExpDat() (página 116)
• PIAdvCalcExpFilDat() (página 117)
Hora filtrada
Retorna a quantidade de tempo durante a qual uma expressão do PI é avaliada como
verdadeira para um intervalo de tempo especificado.
Observação: Os resultados de Hora filtrada variam um pouco dependendo da versão do PI
Server.
• Expressão
• Hora inicial
• Hora final
• Unidades de tempo
INTERVALO DE TEMPO
tempo.
UNIDADES DE TEMPO
Especifique as unidades de tempo usadas para exibir o resultado da expressão calculada.
• É possível inserir a expressão em uma célula de planilha e referenciar o nome da célula
na função. Inicie as expressões com uma aspa simples se desejar que o Excel interprete a
expressão como uma string.
40
Hora filtrada
EXEMPLO
Para consultar a quantidade de tempo para a qual o valor da tag sinusoid estava acima de
75 durante um período de sete dias, os seguintes argumentos são definidos para a função
Hora filtrada:
Expression (Expressão) = sgn('sinusoid'-75)=1
Start Time (Hora inicial) = -7d
End Time (Hora final) = *
Time Units (Unidades de tempo) = h
show percent good (mostrar percentual válido)
column (coluna)
onde os resultados mostram que o valor da tag estava acima de 75 por 7,85 horas durante os
sete dias anteriores.
• Expressões de cálculo (página 81)
• PITimeFilterVal() (página 119)
• PITimeFilter() (página 118)

Capítulo 4
PI Tags e atributos
Um ponto PI é um fluxo de dados em tempo real de uma origem definida, descrito por um
nome de tag correspondente e outros atributos.
No PI DataLink e neste guia, os pontos PI são frequentemente referidos como PI tags e os
termos são usados de maneira um pouco intercambiável. Entretanto, uma tag é simplesmente
um nome para um ponto PI. Ao recuperar dados do PI para uma planilha do Excel, o nome da
tag é o atributo do PI mais comumente usado para referir-se a dados de um ponto PI.
Os nomes de PI tag podem ajudar a identificar dados de pontos, descrever a origem dos
arrays e valores de dados da função, e serem referenciados como atributos para recuperar
dados. Esta seção descreve o uso de tags e outros atributos de ponto na criação de uma
planilha do PI DataLink, incluindo os seguintes:
• recuperação direta de tags para células da planilha, e
• funções usadas para resolver nomes de tag de outros atributos de ponto, ou recuperar
atributos com base em um nome de tag.
Pesquisa de tags
Use a caixa de diálogo Pesquisa de tags para consultar diretamente o PI server por nomes de
PI tag a serem copiadas para funções e planilhas. As tags selecionadas são copiadas para a
planilha ou adicionadas a um campo de edição Nome de tag como um argumento de função.
Para acessar a pesquisa de tags:
• Clique em Pesquisa de tags na faixa de opções do PI (2007), ou escolha PI > Pesquisa
de tags (2003), ou clique em Pesquisa de tags ao lado de um campo Nome de tag.
A caixa de diálogo Pesquisar marca fornece três tipos de pesquisas:
• Pesquisa básica permite que você crie uma máscara da marca especificando atributos da
tag do PI. A máscara é usada para encontrar uma lista de marcas no servidor com
atributos correspondentes.
• Pesquisa avançada fornece uma interface de criação de consulta com acesso a mais
atributos da tag para pesquisas complexas.
• Pesquisa de alias fornece uma exibição de árvore lógica de um PI Server por meio do
Banco de dados do módulo do PI, que você pode usar para selecionar marcas por seus
aliases descritivos.

PI Tags e atributos
Para procurar marcas:

1. Clique em uma guia para escolher uma pesquisa Básica, Avançada ou Alias.
2. Insira os critérios de pesquisa necessários e clique em Pesquisar.
Use '*' ou '?' como caracteres curingas para procurar nomes e atributos de marca. Por
exemplo, a máscara da marca Tem* retorna todos os nomes de ponto que começam com
Tem enquanto Tem? retorna apenas os pontos que começam com Tem e terminam com
outro caractere único. Todos os campos da máscara do ponto diferem letras maiúsculas e
minúsculas.
Você também pode clicar em Favoritos para acessar pesquisas anteriores.
3. As marcas retornadas de uma pesquisa aparecem listadas em um painel de resultado da
pesquisa. Selecione as marcas desejadas no painel de resultados e clique em OK.
Clique nos cabeçalhos da coluna no painel de resultados da pesquisa para classificar os
resultados. Tecla Ctrl ou Tecla Shift para selecionar várias marcas.
44
Funções de tag
Dicas de pesquisa de tags

• Se várias tags forem selecionadas, o primeiro nome de tag selecionado na lista será
copiado para o campo Nome de tag de uma referência de função.
• A célula atual será adotada como o ponto inicial para uma lista de tags copiadas para uma
planilha ao longo de uma única coluna ou fileira, dependendo da configuração de Copiar
itens para planilha.
• Escolha Em uma fileira ou Em uma coluna nos atalhos da Pesquisa de tags no menu da
faixa de opções do PI (2007) para copiar os nomes de várias tags para a planilha em uma
fileira ou coluna de valores, respectivamente.
• O nome do PI Server correspondente a uma tag será acrescentado ao nome da tag se a
configuração Copiar nome do PI Server estiver habilitada.
Funções de tag
A seção a seguir descreve as funções de tag do PI DataLink. Essas funções podem ser usadas
para resolver IDs de ponto PI ou outros atributos de ponto em um nome de tag
correspondente. Também é possível recuperar outros valores de atributo do ponto com base
em um nome de tag.
Para acessar as funções de tag:
As funções de tag usam componentes de função (página 13) comuns.
ID de ponto para tag
Retorna o nome da tag que corresponde a uma ID de ponto PI específica.
CAMPOS OBRIGATÓRIOS
• ID do ponto
EXEMPLO
Para recuperar o nome de uma tag correspondente a uma ID de ponto PI, os seguintes
argumentos são definidos para a função ID de ponto para tag:
Point ID (ID de ponto) = (referência para uma célula que contém o valor de uma ID de
ponto)

PI Tags e atributos
onde o nome da tag é exibido na coluna à direita, com base em uma referência para a célula
que contém a ID de ponto à esquerda.
• PIPointIDToTag() (página 120)
Máscara de atributo para tag
Retorna uma lista de nomes de tag no PI que correspondem a um ou mais valores de atributo
de tag especificados.
Um ou mais dos seguintes campos são requeridos para recuperar valores correspondentes:
• Nome da tag
• Descritor
• Origem do ponto
• Tipo de ponto
• Classe ponto
• Unidades de engenharia
EXEMPLO
Para recuperar os nomes de tags correspondentes a um ou mais atributos de ponto
especificados, os seguintes argumentos são definidos para a função Máscara de atributo para
tag:
Tagname (Nome da tag) = BA*
Point Type (Tipo de ponto) = Float32
46
Funções de tag
Observe que strings de atributos devem corresponder a valores de atributo no PI, e curingas
podem ser usados. A função opera da mesma forma que uma pesquisa de tags (página 43).
• PIAttributeMaskToTag () (página 120)
Atributos de tag
Recupera um atributo associado a um nome de PI tag especificado.
• Nome da tag
• Atributo
ATRIBUTO
Especifique o atributo de tag a ser recuperado do PI.
• Referencie um intervalo de nomes de tag para exibir atributos para cada um.
• A lista de atributos de tag disponíveis depende da classe de ponto associada à tag.
EXEMPLO
Para recuperar atributos de um ponto PI com base no nome da tag, os seguintes argumentos
são definidos para a função Atributos da tag:
Tagname (Nome da tag) = (referência para um array de células que contém nomes de tag)
Attributes (Atributos) = pointid (coluna 2), pointsource (coluna 3), pointtype (coluna 4),
descriptor (coluna 5)
e os arrays de funções resultantes aparecem como:
onde os nomes de tag são referenciados na coluna à esquerda, e uma função Atributos da tag
separada é usada para cada coluna de atributo.
• PITagAtt() (página 121)

Capítulo 5
Objetos do banco de dados do módulo

O PI Module Database fornece uma maneira totalmente diferente de criar a infraestrutura de
uma planilha. Se o banco de dados do módulo do PI server estiver configurado e incluir
objetos que representem as tags que você deseja usar, as planilhas poderão ser mais
facilmente criadas e fornecer mais flexibilidade e potencial de reuso.
O PI Module Database normalmente é configurado pelo administrador do sistema ou do PI, e
armazena aliases e propriedades que referem-se a pontos PI e seus atributos, respectivamente.
A estrutura hierárquica desses objetos fornece um contexto relacional entre pontos.
Por exemplo, você pode ter cinco pontos PI que representam os níveis de cinco tanques
individuais idênticos. Cada ponto tem um nome de tag diferente e representa um objeto físico
diferente, mas seus requisitos de uso e monitoramento são os mesmos.
Ao recuperar objetos do banco de dados do módulo, é possível criar uma única planilha
construída com base nos aliases e propriedades que representam os cinco tanques. As funções
do banco de dados do módulo resolvem esses objetos em nomes de tag e valores de atributos.
Os caminhos de módulo paralelo para cada tanque fornecem um contexto diferente para as
referências do alias.
Com esse tipo de estrutura, é possível usar a mesma planilha para alternar entre exibições de
múltiplos ativos. Por exemplo, ao selecionar o nome de qualquer um dos cinco tanques em
uma célula da planilha, o mapeamento do alias para o ponto PI correspondente permite que as
funções do DataLink recuperem valores do tanque apropriado.
Os tópicos a seguir descrevem as ferramentas fornecidas pelo PI DataLink para acessar
objetos do PI Module Database. Consulte a documentação do PI Server para obter
informações adicionais sobre bancos de dados de módulo e a configuração.
Procurar banco de dados do módulo

A caixa de diálogo Procurar banco de dados do módulo permite procurar por aliases de PI,
propriedades e caminhos de módulo no PI Module Database, uma estrutura em árvore
hierárquica com base no conteúdo de um PI Server. É possível selecionar esses itens e copiá-
los diretamente para uma planilha.
Observação: Aliases e propriedades correspondentes a pontos PI devem ser

configurados no PI server Module Database para usar as funções de procura e do
Module Database.

Para procurar e selecionar no PI Module Database:

1. Selecione uma célula e clique em Procurar módulo na faixa de opções do PI ou escolha
PI > Procurar módulo. A caixa de diálogo Procurar banco de dados do módulo será
exibida.
2. Em Tipos, selecione o tipo de objeto que está procurando:
ο Alias
ο Propriedade
ο Módulo
Use a lista suspensa PI Server para exibir bancos de dados de módulo para diferentes PI
servers conectados.
3. Especifique uma Data da consulta e horário para fornecer um contexto temporal para
objetos exibidos no banco de dados do módulo, se necessário, para selecionar a versão
correta do objeto.
50
Funções do banco de dados do módulo
4. Navegue no controle da árvore para localizar o item desejado e adicionar o item ou um

objeto de coleção pai à planilha
ο Selecione um item para copiá-lo para a planilha.
ο Selecione os Aliases ou as Propriedades pai de um módulo para copiar todos os
aliases ou as propriedades associados para a planilha.
5. Selecione Copiar caminho do módulo para copiar o caminho completo do módulo do
alias ou da propriedade para uma célula de planilha adjacente, juntamente com o objeto
selecionado.
O caminho do módulo fornece o contexto para o objeto selecionado
Se a configuração Copiar nome do PI Server estiver ativada, o nome do PI server
correspondente também será copiado.
6. Clique em OK para fechar a caixa de diálogo e copiar os itens selecionados.

A seção a seguir descreve as funções do banco de dados do módulo do PI DataLink. As
funções do Banco de dados do módulo resolvem aliases e propriedades da árvore de um
banco de dados do módulo em nomes de tag por meio de um caminho de módulo. É possível
inserir um caminho de módulo como um argumento de função ou referenciá-lo a partir de
uma célula da planilha.
Para acessar as funções do banco de dados do módulo:
Observação: Não é possível resolver um alias ou um objeto de propriedade para um

nome de tag sem um caminho de módulo. O caminho fornece um contexto para o
alias que o mapeia para um ponto PI específico.
As funções do Banco de dados do módulo usam componentes de função (página 13) comuns.
Alias para tag
Retorna um nome de tag do PI correspondente a um alias do PI especificado.
• Alias
• Caminho do módulo
• Data da consulta

ALIAS
Especifique um nome de alias do PI. Um alias pode ser inserido diretamente ou referenciado
em uma célula. Também é possível navegar até um alias no PI Module Database.
CAMINHO DO MÓDULO
Insira o caminho do módulo do PI Module Database onde o alias especificado pode ser
encontrado. O caminho do módulo será inserido automaticamente se o argumento alias for
selecionado navegando-se no Module Database.
DATA DA CONSULTA
Especifique uma data para recuperar uma versão específica do alias.
• PIAliasToTag() (página 123)
Propriedade para valor
Retorna um ou mais valores correspondentes a uma propriedade especificada do PI.

O DataLink pode retornar valores para tipos de propriedade Boolean, Date, Double, Integer,
Long, Null, Single e String, ou tipos de propriedade de array Double, Integer, Long e Single.
• Propriedade
• Caminho do módulo
• Data da consulta
PROPRIEDADE
Especifique um nome de propriedade do PI. Uma propriedade pode ser inserida diretamente
ou referenciada em uma célula. Também é possível navegar até uma propriedade no PI
Module Database.
CAMINHO DO MÓDULO
Insira o caminho do módulo do PI Module Database onde a propriedade especificada pode
ser encontrada. O caminho do módulo será inserido automaticamente se o argumento
propriedade for selecionado navegando-se no Module Database.
DATA DA CONSULTA
Especifique uma data para recuperar uma versão específica da propriedade.
• PIPropertyToValue() (página 123)
52
Capítulo 6
Planilhas
Quando você adiciona uma função a uma planilha, o PI DataLink recupera os dados
solicitados do PI Server para um array. O tamanho do array pode variar dependendo da
função, quantos valores de arquivo correspondentes estão disponíveis no PI, o número de
valores solicitados ou o número de referências de entrada.
Os tópicos a seguir fornecem uma visão geral de como as funções do PI DataLink funcionam
em uma planilha e como gerenciar e manter a planilha com o passar do tempo.
Frequência de cálculo
É possível escolher um intervalo de atualização automática para manter os dados da função
atualizados nas planilhas, ou usar métodos de recálculo manual e disparados por funções,
usados nas versões anteriores do PI DataLink.
Para obter informações detalhadas sobre como o Excel gerencia cálculos, consulte o tópico
Recálculo do Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) na biblioteca do
MSDN.
Atualização automática
A Atualização automática força o Excel a recalcular funções e tendências em planilhas

abertas em um intervalo especificado. Para ativar a Atualização automática:
• Clique no botão de alternância Atualizar na Faixa de opções do PI (2007) ou escolha
Atualizar no menu PI (2003).
Todas as pastas de trabalho abertas na sessão atual do Excel serão calculadas
imediatamente, e depois em intervalos especificados com base nas configurações de
preferência da Atualização automática.
A Atualização automática permanecerá ativada (com uma mensagem indicativa na barra de
status do Excel) até que seja desativada. Durante um evento de recálculo, a barra de status
também exibe o intervalo de cálculo.
Observação: A Atualização automática não pode atualizar pastas de trabalho

protegidas, que são somente leitura.

Planilhas
Intervalo de cálculo
O intervalo de cálculo é uma configuração de preferência (página 22) medida em segundos,
que deve ser maior que 5 segundos.
O valor 0 representa um intervalo automático no qual o Datalink ajusta o tempo entre ciclos
de cálculo para duas vezes o tempo da duração do cálculo, com um intervalo mínimo de 5
segundos. O intervalo automático é recomendado para assegurar que o Excel permaneça
respondendo em 50% do tempo.
É possível ajustar manualmente o intervalo da Atualização automática para permitir mais
tempo entre as atualizações. Se o recálculo demorar mais que o intervalo especificado, uma
mensagem solicitará a alternância para a configuração de intervalo automático ou o
desligamento total da Atualização automática.
Observe que as atualizações são pausadas quando um menu, painel de tarefas ou caixa de
diálogo é aberta, ou quando a planilha atual está no modo de edição.
Cancelamento
Pressione Esc para cancelar um recálculo em andamento. O DataLink encerra o cálculo da
função atualmente em processamento e Cálculo abortado aparece nas células não
processadas do array de funções. Se você cancelar durante uma atualização enquanto a
Atualização automática estiver ativada, o DataLink desligará a Atualização automática.
Recálculo disparado
No Excel, as funções são recalculadas com base em um evento de disparo. Se a

funcionalidade Atualização automática não for usada, será possível maximizar a frequência
de atualização e manter os arrays de funções atualizados referenciando-se funções de tempo
voláteis dentro de funções não voláteis do PI DataLink.
As funções de tempo voláteis do Excel, como now() e today(), recalculam com a maior
frequência. Sempre que um usuário editar uma célula da planilha ou pressionar F9, o Excel
atualizará todas as funções de tempo voláteis na planilha. Por sua vez, a atualização dispara
quaisquer funções que referenciem um carimbo de data e hora com base em uma função de
tempo volátil.
Para basear uma função do PI DataLink em uma função volátil do Excel:
1. Use a barra de funções do Excel para inserir uma função volátil em uma célula da
planilha.
Por exemplo, é possível usar (today()+1/3) para representar 8h do mesmo dia, ou
now() como uma referência de célula para substituir a hora atual do PI *.
Para criar um carimbo de data e hora absoluto que ao mesmo tempo seja atualizado, use
2-feb-97 00:30:30 + now() - now().
2. Referencie a célula ao definir os argumentos Hora inicial ou Hora final de uma função
do DataLink.
54
Funções e valores de array
Observação: Para maximizar a frequência das atualizações quando a Atualização

automática não estiver em uso, verifique as preferências de cálculo do Excel para
assegurar que tanto a planilha quanto o aplicativo estejam definidos como cálculo
Automático em vez de Manual. Lembre-se de que isso pode impactar o
desempenho e tornar planilhas grandes de difícil utilização.
Recálculo manual
A maioria das funções do PI DataLink são não voláteis, mas a função Valor atual (página
27) é uma exceção. Valor atual é uma função volátil, atualizada sempre que uma planilha for
recalculada. Os valores de função não voláteis não são alterados a menos que um argumento
seja alterado, e devem ser atualizados manualmente, por meio de atualização automática
usando o modo Calcular por inteiro ou por meio de uma referência a um valor de função
volátil.
O recálculo manual é o melhor método parar arrays de tamanho variável (página 57), em que
o número de valores retornados pode diferir. Se estiverem disponíveis mais valores que o
tamanho atual do array, um array não expande para exibir os valores adicionais durante o
recálculo, a menos que ele seja recalculado manualmente.
Para recalcular manualmente uma única função:
• Clique com o botão direito do mouse em qualquer parte de um array e escolha
Recalcular (Redimensionar) função no menu de contexto.
• Atualize argumentos de função em qualquer versão do PI DataLink. Os valores do array
são atualizados ao clicar em OK ou Aplicar para fechar a caixa de diálogo ou o painel de
tarefas, mesmo se nenhuma alteração foi feita nos argumentos da função.
As combinações de tecla do Excel também podem ser usadas para recalcular todas as
planilhas em uma pasta de trabalho, essencialmente uma versão manual sob demanda da
Atualização automática. Para recalcular todas as funções da planilha:
• Pressione F9 para forçar que todas as funções voláteis (e quaisquer funções que as
referenciem) sejam recalculadas.
• Pressione Ctrl+Alt+Shift+F9 para forçar o recálculo de todas as funções.
Funções e valores de array

Quando você adiciona uma função a uma planilha, o PI DataLink insere a sintaxe da função
ativa na célula de destino. Depois de definida, uma função consulta o PI server e retorna
valores, que aparecem na mesma célula usada para inserir a função.
A diferença entre o conteúdo real das células e a exibição exposta de valores de dados
recuperados por uma função deve ser familiar aos usuários do Microsoft Excel. Para novos
usuários do Excel, isso ajuda a manter essa distinção clara, e lembrar que o conteúdo real de
uma célula da planilha sempre aparece na barra de fórmulas do Excel e não necessariamente
em células individuais da planilha.

Planilhas
Por exemplo, ao selecionar uma célula e adicionar uma função Valor atual, você especifica o
nome da PI tag cujo valor atual deseja ver no campo Nome de tag. Se inserir a tag sinusoid, o
PI DataLink colará a seguinte função na célula de destino:
=PICurrVal("sinusoid",0,)
O Excel avalia essa função, recupera o valor mais recente de sinusoid do PI e o exibe na
célula. Se a célula for selecionada, a sintaxe de função acima aparecerá na barra de fórmulas
do Excel.
Gerenciamento de arrays
Os arrays de funções podem ser movidos internamente, copiados ou removidos de uma
planilha. Para selecionar um array, siga um destes passos:
• Clique e arraste para selecionar cada célula no array. Lembre-se de que o array pode ter
valores vazios, que também devem ser selecionados.
• Clique com o botão direito do mouse em qualquer parte do array e escolha Selecionar
função do DataLink no menu de contexto para selecionar todas as células no array.
Depois de selecionado, é possível gerenciar facilmente o array:
• Clique com o botão direito do mouse em qualquer célula no array e escolha a operação
Recortar, Copiar, Excluir, Limpar ou Formatar desejada no menu de contexto.
Remova manualmente os caracteres $ iniciais da barra de fórmulas para tornar as
referências de células relativas.
• Clique com o botão direito do mouse em uma nova célula e escolha Colar para reinserir
um array recortado ou copiado.
• Coloque o cursor sobre a borda do array selecionado até que um cursor de cruz apareça e,
então, clique e arraste o array para uma nova célula a fim de movê-lo.
• Abra o painel de tarefas ou a caixa de diálogo da função e atualize a Célula de saída
(página 57) para colocar o array em um novo local.
Observação: É necessário mover ou limpar um array inteiro do Excel, incluindo todas

as células, ou o DataLink exibirá uma mensagem de erro: Você não pode alterar
parte de um array.
Também é possível copiar os valores de um array de funções caso deseje utilizá-los em algum
outro lugar em uma planilha. Depois de copiar e colar os valores, eles não mais farão parte de
um array de funções; serão simplesmente valores de célula e não estarão atualizados. Para
copiar valores de array:
• Selecione os valores de função desejados, copie-os e use Colar especial para colá-los no
local desejado.
Não é necessário selecionar a coluna ou a fileira inteira do array para copiar valores.
56
Gerenciamento de arrays
Argumentos de atualização
É possível atualizar um array de funções com novos valores de argumentos:

1. Clique com o botão direito do mouse e selecione o nome da função no menu de contexto
(2003 ou 2007), ou exiba o painel de tarefas ou a caixa de diálogo da função.
A caixa de diálogo da função correspondente aparecerá e exibirá os argumentos atuais
nos campos de edição apropriados.
2. Altere quaisquer parâmetros conforme desejado para atualizar o array com novos
argumentos e clique em OK ou Aplicar.
Se o argumento Célula de saída for alterado, os resultados dependerão do local da nova
referência de célula:
ο Se a nova referência de célula fizer parte do array original, o array inteiro será
movido de maneira que a célula superior mais à esquerda do array seja colocada na
célula recém-referenciada.
ο Se a nova referência de célula não fizer parte do array original, este será copiado e
colado com a célula superior mais à esquerda localizada na célula recém-
referenciada. O array original permanecerá em seu local original.
Observe que também é possível editar a sintaxe da função diretamente, pressionando-se F2
para editar na barra de fórmulas do Excel. Pressione Ctrl+Shift+Enter para salvar as edições
ao concluir.
Redimensionar arrays
Quando uma planilha for chamada em momentos diferentes, um número diferente de valores
poderá estar disponível para uma função definida. Se o número de valores exceder o tamanho
atual do array, este não será expandido para exibir os valores adicionais, a menos que você
recalcule manualmente (página 55) a função.
Se existirem menos valores que o número original de valores recuperados, valores vazios
serão retornados para preencher o array calculado, e serão marcados como #N/A se
especificado, ou deixados em branco. Se existirem valores adicionais que não possam ser
exibidos, o texto Redimensionar para mostrar todos os valores aparecerá na parte inferior do
array de funções, a menos que seja definida uma preferência para desabilitar (página 22) essa
mensagem.
Para redimensionar o array a fim de ajustar-se aos dados disponíveis:
• Clique com o botão direito do mouse em qualquer parte de um array e escolha
Recalcular (Redimensionar) função no menu de contexto.
Normalmente são adicionados valores vazios quando uma função referencia um intervalo que
tempo que extrapola a hora atual, usando horas inicial e final relativas. Quando a função for
recalculada, o intervalo de tempo abrangerá um novo intervalo, que poderá incluir mais
variância de dados e, portanto, um número diferente de eventos registrados no arquivo.

Planilhas
Por exemplo, considere uma função de dados compactados criada para solicitar 40 valores,
iniciando à meia-noite do dia anterior. Quando a função for recalculada uma semana depois e
apenas 35 valores de eventos (incluindo eventos filtrados) estiverem registrados, as cinco
células finais do array original serão preenchidas com strings em branco para preservar o
tamanho do array.
Valores vazios podem alterar a aparência de uma planilha, mas ajudam a assegurar que
variâncias em dados registrados sejam incorporadas sem atualizar a função. A fim de manter
um tamanho constante para funções Dados compactados (página 29), especifique o número
de valores a serem recuperados, em vez de um intervalo de tempo. Ou para exibir apenas uma
porção predeterminada dos resultados, especifique um intervalo de células de saída (página
14) limitado.
Compartilhar planilhas
Se deseja compartilhar dados do PI e tornar as planilhas acessíveis a outros usuários, lembre-
se das seguintes considerações:
• É possível enviar uma planilha do PI DataLink para outro usuário do Microsoft Excel. O
usuário deve ter o PI DataLink instalado e uma conexão ativa com o mesmo PI server a
fim de recalcular funções e ver valores de ponto PI dinamicamente atualizados.
• Se os usuários não tiverem o PI DataLink instalado, ainda poderão ver os últimos dados
salvos na planilha, desde que as Opções de cálculo do Excel estejam definidas como
Manual antes da abertura da planilha no Excel. No Excel 2007, clique no botão Office
2007 e clique em Opções do Excel > Fórmulas para acessar essas opções. No Excel XP-
2003, a configuração manual está disponível em Ferramentas > Opções na guia
Cálculo.
• Também é possível salvar em formato HTML ou PDF no Excel 2007 a fim de
compartilhar uma planilha estática.
• É possível copiar e colar (página 56) valores de arrays de funções para novos locais em
uma planilha, usando Colar especial. Embora os dados da planilha não mais possam ser
recalculados depois de copiados, esse método permite distribuir um instantâneo
personalizado dos dados para qualquer pessoa que tenha uma cópia do Excel.
• Se tiver o Microsoft Office SharePoint Server (MOSS) no ambiente computacional, será
possível publicar uma planilha do DataLink em um site do SharePoint e usar o PI
DataLink for Excel Services (página 3) para exibir e recalcular dados de função do PI.
58
Capítulo 7
Exibições de tendência
O PI DataLink inclui um objeto ActiveX de controle de tendência que pode ser inserido em
qualquer planilha do excel para exibir a tendência de valores de evento com o passar do
tempo. Objetos de tendência inseridos podem exibir dados da planilha e dos pontos PI
selecionados.
Criar uma tendência

Um assistente facilita a inserção e a configuração de tendências. Para inserir uma tendência:
1. Clique na célula em que deseja colocar o canto superior esquerdo do objeto de tendência,
clique em PI > Inserir tendência (XP-2003), ou clique em Inserir tendência na faixa de
opções PI (2007) para exibir o Assistente de complementos de audiência.
Ao selecionar a célula de entrada, considere que o tamanho padrão do objeto de tendência
requer aproximadamente 14 x 8 células padrão.

2. Escolha a origem dos nomes de tag:

ο Selecione Dados na planilha para basear a tendência em valores do array (página
60) que já apareçam em células da planilha.
ο Selecione Dados do PI para basear a tendência em dados de ponto específicos
recuperados diretamente do PI (página 61).
3. Conclua as etapas restantes do assistente de tendência.
Dados da planilha
Se escolher Dados na planilha, o assistente de tendência solicitará que você selecione o

intervalo de células que contém os dados para o qual deseja gerar a tendência.
Para especificar dados da planilha para a tendência:

1. Clique no campo Intervalo de células contendo dados e depois clique e arraste para
selecionar um intervalo de células na planilha.
A menos que desmarque Incluir todas as células em um array, será necessário
selecionar apenas uma célula de um array de funções. O resto do array é adicionado
automaticamente à referência do intervalo de células ao clicar em Adicionar.
Para pontos de dados discretos que não façam parte de um array, ainda será necessário
selecionar cada célula desejada.
60
Criar uma tendência
2. Selecione Primeiro elemento é o nome do traço para usar o valor de uma célula
adjacente para nomear o traço na tendência.
O primeiro elemento será a célula acima do primeiro valor do intervalo selecionado se os
dados estiverem organizados em formato de coluna, e a primeira célula à esquerda do
primeiro valor do intervalo para dados em formato de fileira.
3. Selecione Nível para plotar uma tendência em nível em vez de um traço contínuo.
Essa opção normalmente é especificada para tags discretas.
4. Clique em Adicionar para adicionar o intervalo de células selecionado à tendência.
5. Adicione referências de célula conforme necessário ou clique em Avançar ou Concluir
para continuar.
Dados do PI
Caso escolha Dados do PI, o assistente de tendência solicita que você referencie ou pesquise
por nomes de PI tag.
Para especificar dados do PI para a tendência:

1. Clique no campo Nome de tag e depois clique e arraste para selecionar um intervalo de
células na planilha.
Também é possível inserir diretamente uma referência de célula ou usar o botão de
referência para exibir um diálogo de referência usado para procurar e adicionar
referências de células.

Você também pode clicar no botão de seleção para pesquisar por tags (página 43) no
PI. As tags selecionadas por meio de uma pesquisa de tags são adicionadas
automaticamente à lista de traços.
2. Altere o nome do servidor padrão (se necessário) no campo Nome do servidor e clique
em Adicionar para adicionar as referências de nome de tag selecionadas à tendência.
É possível usar o botão de referência para exibir um diálogo de referência usado

para procurar e adicionar referências de células.
3. Adicione nomes de tags conforme necessário ou clique em Avançar ou Concluir para
continuar.
Gerenciar traços
Ao construir uma tendência a partir da planilha ou de dados do PI, você acumula traços no
painel de traços à direita da tela do assistente. Vários controles são fornecidos para gerenciar
os traços que aparecem na tendência:
• Marque a caixa de seleção Marcadores ao lado do nome de um traço para exibir
marcadores no traço a fim de indicar o local dos pontos de dados arquivados.
Observação: Os traços são desenhados em cores diferentes. Por padrão, uma

tendência também inclui marcadores de cor oculta para diferenciar traços em
telas monocromáticas. Os marcadores de cor oculta têm espaçamento
uniforme ao longo de um traço e não indicam pontos de dados arquivados.
• Clique nos botões de seta acima do painel de traços para mover traços para cima e para
baixo na exibição da legenda de traços.
• Clique nos botões X e X tudo para remover traços selecionados e todos, respectivamente.
• Clique no botão Renomear para renomear um traço selecionado na legenda de traços.
Especificar o intervalo de tempo

Quando os traços de tendência forem determinados, o assistente solicitará que você
especifique um intervalo de tempo para a tendência se algum dos traços for desenhado
diretamente do PI.
Para especificar um intervalo de tempo:
1. Clique nos campos Hora inicial e Hora final e depois clique para selecionar uma célula
de carimbo de data e hora na planilha.
Também é possível inserir diretamente uma string de tempo ou usar o botão de referência
para exibir um diálogo de referência usado para procurar e adicionar referências
de células.
62
Título e posicionamento
Observação: Caso insira uma string de tempo combinada ou absoluta (página 77),
certifique-se de usar o formato correto de carimbo de data e hora.
2. Selecione Habilitar atualizações para atualizar a tendência com novos dados do PI se o

intervalo de tempo for alterado ou estender-se até o presente.
3. Escolha Avançar ou Concluir para continuar.
Título e posicionamento
Completar a tendência e determinar seu local na tela final.
Para completar a tendência:

1. Insira o Título da tendência.
2. Desmarque Mostrar atributos do valor se não deseja que os atributos de valor apareçam
ao longo dos traços de tendência.
Os ícones aparecerão quando o intervalo de dados contiver eventos que tenham definidos
os bits Questionável, Substituído ou Anotado.
3. Selecione um local diferente para a tendência, se desejado, colocando-a em uma planilha
separada ou alterando a célula de posicionamento padrão.
Se Nova planilha for selecionado, a tendência será colocada em uma planilha em branco
no canto superior esquerdo.

Se Planilha existente for selecionado, a célula (ou intervalo usado para dimensionar a
tendência) em que a tendência será colocada deverá ser especificada ou referenciada no
campo associado. Se alterar a célula de posicionamento padrão, certifique-se de que a
nova célula não contenha dados (que serão convertidos pela exibição de tendência).
Menu de contexto
Depois que uma tendência for inserida em uma planilha, será possível atualizar, editar ou
gerenciá-la usando o menu de contexto. Para acessar as opções do menu de contexto:
• Clique com o botão direito do mouse na exibição de tendência e escolha uma opção no
menu:
ο Escolha Alterar escala para alterar a escala do eixo y e o intervalo de tempo.
ο Escolha Reverter para desfazer quaisquer alterações e reverter às configurações de
tendência originais definidas no Assistente de complementos de audiência.
ο Escolha Barra de rolagem para habilitar uma barra de rolagem na parte inferior da
tendência a fim de rolar a exibição pelos intervalos de tempo adjacentes.
ο Escolha Formato para editar a exibição de traços individuais ou as tendências como
um todo usando o diálogo Propriedades do controle de tendências. É possível
alterar a cor ou a espessura da linha de um traço, ou ainda adicionar itens de legenda
à tendência.
64
Menu de contexto
ο Escolha Definir tendência para exibir a tela de definição de traço do assistente de

tendência para atualizar ou alterar as origens de traço.
ο Escolha Definir Tendência e Intervalo de horas para exibir a tela de definição do
intervalo de tempo do assistente de tendência a fim de atualizar o intervalo de tempo.
ο Escolha Excluir tendência para remover a tendência da planilha.
Observação: Uma tendência excluída não pode ser restaurada e deverá ser
recriada.
ο Escolha Exportar dados para colar os valores usados para plotar a tendência em
células da planilha. É possível especificar formato de fileira ou coluna e também
exportar nomes de tendências como cabeçalhos.
ο Escolha Mover/Redimensionar e insira um local de célula para mover o canto
superior esquerdo da tendência para a célula especificada. Insira um intervalo de
células para redimensionar a tendência.
ο Escolha Copiar/Colar para copiar a exibição de tendência inteira para a área de
transferência e solicitar uma célula de destino para colar o controle.

Capítulo 8
Notificações
O PI DataLink inclui um suplemento Pesquisa de notificações do PI que pode ser usado para
recuperar notificações assinadas a partir do PI System e inseri-las diretamente em planilhas.
O suplemento do Excel PI Notifications é instalado com o PI DataLink 4.0, executado nos
sistemas operacionais Windows XP e posteriores, e requer o Excel XP ou versões posteriores.
Observação: Você deve ter uma conta em pelo menos um PI System que execute um
servidor PI AF 2.0 com o PI Notifications 1.0, e ter assinado pelo menos uma
regra de notificação para receber notificações.
Para obter informações sobre o PI Notifications, consulte o Guia do usuário do PI
Notifications.
Para iniciar o visualizador PI Notifications:

• Clique no ícone Notificações na faixa de opções do PI (2007) ou escolha PI > Pesquisa
de notificações (2003).

Notificações
Pesquisar e exibir notificações

É possível usar o visualizador PI Notifications para pesquisar e recuperar notificações que
você tenha assinado em um PI System acessível. Um PI System é um banco de dados de
elementos estruturais e eventos de notificação que o ajudam a trabalhar com dados no PI
server.
Para pesquisar notificações:

1. Na guia Pesquisar, selecione um PI System a fim de pesquisar notificações:
ο Escolha um sistema no menu PI System e clique em Conectar para conectar-se ao
PI System selecionado.
Clique no botão de reticências para acessar a Lista de sistemas e adicionar PI
Systems (página 69) ao menu.
ο Clique em Referência para referenciar o nome de um PI System em uma célula

da planilha.
Clique novamente no botão para exibir o menu PI System.
2. Escolha uma opção no menu Exibir notificações para filtrar a lista de notificações
retornadas.
ο Escolha Ativo para exibir todas as notificações atualmente ativas.
ο Escolha Intervalo de tempo e insira valores de Hora inicial e Hora final para
retornar notificações que ocorram durante um intervalo de tempo específico.
ο Escolha Recente e insira um número e um intervalo de tempo para retornar as
notificações mais recentes durante um período de tempo específico.
3. Altere a Célula de saída para colocar a lista de notificações em uma célula diferente da
planilha, se desejado.
68
Pesquisar e exibir notificações
4. Clique em Pesquisar.
As notificações retornadas pela pesquisa aparecerão no visualizador Histórico de
notificações (página 70).
5. Clique em OK para inserir o conteúdo do visualizador Histórico de notificações na
planilha (página 71) e fechar a caixa de diálogo.
A consulta de notificações será inserida na planilha no local designado como uma função.
Como outras funções do PI, os dados de notificação serão atualizados quando a planilha
recalcular (página 54).
Clique em Cancelar para fechar a caixa de diálogo, descartando os resultados da
pesquisa.
Adicionar PI Systems
Pode haver vários PI Systems no ambiente, cada um dos quais pode ter o PI Notifications
instalado, e ser uma origem de notificações relevantes para você. Por exemplo, você pode
assinar notificações de PI systems em execução em diferentes instalações, ou representando
diferentes unidades de negócio.
Para receber essas notificações, é necessário assinar ou solicitar que o administrador o
inscreva para receber notificações de cada PI system, usando o aplicativo PI System
Explorer e adicionar cada PI System ao visualizador PI Notifications.
Para adicionar sistemas ao menu PI System:
1. Clique em Lista de sistemas .

A caixa de diálogo Sistemas será exibida.
2. Clique com o botão direito do mouse no painel de sistemas e escolha Novo PI System.
Clique com o botão direito do mouse em uma entrada de PI system existente para alterar
propriedades ou especificar um sistema padrão.

Notificações
3. Insira as informações de rede relevantes para localizar e autenticar o computador no PI

system.
O campo Nome contém o nome usado para descrever o PI system no visualizador PI
Notifications.
4. Clique em Configurar Active Directory para obter informações do PI System de um
local do Active Directory, se aplicável.
5. Quando a configuração for concluída, clique em OK para salvar a nova entrada de PI
System.
O PI system aparecerá no menu PI System, ou na parte superior do menu se for
especificado como o sistema padrão.
Para obter informações adicionais sobre PI Systems, consulte o Guia do usuário do AF 2.0.
Exibir notificações
O visualizador Histórico de notificações aparece na metade inferior da guia Pesquisa de
notificações, e exibe notificações que correspondam aos critérios de pesquisa.
Use o visualizador Histórico de notificações para avaliar, gerenciar e responder a
notificações.
• Selecione uma notificação e clique com o botão direito do mouse para exibir o menu de
contexto e depois escolha uma opção:
ο Escolha Confirmar instância para confirmar que uma ação foi efetuada com relação
à notificação, e que nenhum escalonamento adicional será necessário. Insira um
comentário na caixa de diálogo fornecida, se desejado, e clique em OK.
ο Escolha Confirmar assinatura para confirmar o recebimento de uma notificação
que você assinou. Insira um comentário na caixa de diálogo fornecida, se desejado, e
clique em OK.
ο Escolha Adicionar comentário para comentar sobre uma notificação.
ο Escolha Exibir resumo de regras de notificação para exibir as propriedades da
regra de notificação que disparou uma notificação selecionada.
Também é possível gerenciar a exibição de notificações no visualizador:
• Clique nos cabeçalhos de coluna para classificar as notificações por um atributo
específico, ou clique com o botão direito do mouse para mostrar e ocultar colunas.
• Clique com o botão direito do mouse na janela de notificações e escolha uma opção:
ο Escolha Expandir tudo ou Recolher tudo para expandir ou recolher um grupo de
notificação.
ο Escolha Mostrar eventos de contato para alternar a exibição de eventos de contato
para cada notificação.
70
Inserir notificações
Os dados de notificação em células da planilha podem ser referenciados em funções do PI
DataLink. Por exemplo, é possível usar o valor Hora inicial de uma notificação
recuperada para recuperar dados de amostragem que indiquem o progresso de um processo
em lote.
Se as notificações estiverem definidas para exibir confirmações, essas colunas incluirão links
para páginas da Web do PI Notifications onde é possível confirmar ou comentar sobre uma
notificação.
Observação: São exibidas mensagens de erro quando você confirma uma notificação
no Excel. É possível desabilitar essas mensagens para o Office 2003
(http://support.microsoft.com/kb/829072) e o Office 2007
(http://support.microsoft.com/kb/925757), mas não para outras versões
(http://support.microsoft.com/kb/291912) do Microsoft Office.
Para obter informações adicionais sobre notificações, assinatura e confirmação, consulte o

Guia do usuário do PI Notifications.

Notificações
Configurações de exibição de notificações
Use a guia Formato de exibição para especificar como as notificações deverão aparecer
quando inseridas em células da planilha. É possível selecionar as colunas usadas para exibir
dados de notificação padrão e alterar sua organização e formatação.
Colunas
• Selecione colunas na lista Colunas disponíveis e clique em Adicionar para movê-las
para a lista Ordem das colunas para determinar quais dados serão inseridos na planilha.
• Use os botões de seta acima da lista Ordem das colunas para definir a ordem das
colunas (ou fileiras).
• Clique em Remover para mover as colunas selecionadas da lista Ordem das colunas ou
em Limpar para remover todas as colunas.
• Adicione colunas Confirmar ou Confirmar com comentário a fim de adicionar links para
confirmar o recebimento ou comentar sobre uma notificação.
Eventos de contato
• Selecione Exibir eventos de contato para adicionar eventos de contato relacionados a
cada notificação à exibição, como o envio para cada destinatário, comentários e
confirmações.
• Selecione Recuar contatos para distinguir eventos de contato na exibição aplicando-se
recuo. Escolha Formatando células para exibi-las recuadas na mesma coluna que os
eventos de notificação, ou Usando colunas separadas para adicionar uma segunda
coluna para eventos de contato.
72
• Selecione Usar agrupamento do Excel para usar a funcionalidade de agrupamento do

Excel a fim de aninhar eventos de contato abaixo de notificações pai individuais que os
geraram.
Observação: Não é oferecido suporte ao Agrupamento do Excel para planilhas

publicadas no PI DLES (página 3).
Exibição e orientação
• Selecione Exibir cabeçalhos de colunas para adicionar cabeçalhos de fileira ou de
coluna acima dos dados de notificações.
• Selecione Exibir contagem para adicionar uma contagem de notificações acima dos
dados de notificações.
• Em Orientar resultados em, escolha para exibir dados de notificações em Colunas ou
Fileiras.

Anexo A
Informações suplementares
Instalação
Há duas maneiras em que os usuários podem trabalhar com funções do PI DataLink em
planilhas do Excel:
• Os usuários podem instalar uma versão autônoma do PI DataLink em seu PC local.
• Os usuários da Web podem exibir planilhas com funções do PI DataLink usando o PI
DataLink for Excel Services (página 3).
Entre em contato com o representante de vendas da OSIsoft para obter informações
adicionais.
Observação: Versões anteriores do PI DataLink permitiam que uma versão

compartilhada fosse instalada e executada a partir de um servidor de arquivos
central. Não mais é oferecido suporte a esse recurso.
É possível instalar o PI DataLink a partir de um CD de distribuição ou de um kit de instalação

baixado da OSIsoft. O programa de instalação instala automaticamente as versões para Excel
XP-2003 e 2007 do suplemento PI DataLink no sistema, independentemente de qual versão
do Excel estiver instalada.
• Se tiver o Excel XP-2003 no PC, você deverá configurar o suplemento manualmente
(página 4) após a instalação, adicionando-o ao Excel.
• Se tiver o Excel 2007 no PC, o programa de instalação configurará automaticamente o
suplemento para Excel 2007.
Instalações silenciosas
Para instalações silenciosas, use o arquivo silent.ini fornecido no kit de distribuição do

PI DataLink, digitando:
Setup.exe -f silent.ini
É 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.

Conectividade do PI Server
Computadores cliente que executem o Microsoft Excel e o PI DataLink podem recuperar

dados de PI 3 servers.
Para obter informações adicionais sobre conectividade e segurança do PI Server, consulte a
documentação do PI Server ou baixe a documentação do site de suporte técnico da OSIsoft
(http://techsupport.osisoft.com/downloadcenter.aspx).
Banco de dados do firewall

O banco de dados do firewall em um computador do PI server deve ser configurado para
permitir o acesso de computadores cliente que executem o PI DataLink. Por exemplo,
PIConfig> @table pi_gen,pifirewall PIConfig> @ostr hostmask,value
PIConfig> @select hostmask=* PIconfig> @ends *.*.*.*, ALLOW
não bloqueia intervalos de IP, indicando que todos os computadores cliente podem conectar-
se ao PI 3 Server. Em contraste,
*.*.*.*, DISALLOW 192.168.100.*, ALLOW
permite conexões apenas de endereços TCP/IP que comecem com 192.168.100.
Confiança
Uma confiança do PI permite que os clientes conectem-se a um computador PI server e
recuperem dados sem login explícito do usuário. Uma confiança pode ainda permitir que um
usuário efetue login com base em um endereço IP, domínio do Windows, nome de usuário,
aplicativo ou outros critérios.
As confianças do PI são estabelecidas no PI server e armazenadas em um banco de dados de
confiança. Para obter informações sobre como configurar confianças para acesso ao PI server,
consulte a documentação do PI Server.
Permissões de acesso a pontos

O PI DataLink solicita ao usuário um nome de usuário e uma senha durante a conexão com
um PI server. O nome de usuário é usado em conjunto com os campos PtOwner, PtAccess,
DataOwner e DataAccess.
Por exemplo, se a tag sinusoid for configurada com PtAccess O:RW, G:NONE,
W:NONE, e PtOwner for user1, um usuário deverá efetuar login como user1 a fim de
acessar a tag. Caso contrário, a tag não poderá ser encontrada.
Se sinusoid DataAccess for O:R, G:NONE, W:NONE, e DataOwner for user1,
um usuário deverá efetuar login como user1 a fim de consultar os dados da tag sinusoid. Caso
contrário, será retornada uma mensagem de erro de acesso de leitura.
Entretanto, o mesmo usuário não pode gravar dados em sinusoid porque o atributo
DataAccess é O:R (somente leitura). O Gerente do PI System precisaria alterar
DataAccess para O:RW (leitura e gravação) a fim de permitir que um usuário que efetue
login como user1 leia e grave dados em sinusoid.
76
Horário PI
Observação: A conta PIAdmin é um usuário superprivilegiado que tem acesso de

leitura e gravação a todas as tags. Por esse motivo, os Administradores do
Sistema normalmente não devem permitir que usuários do PI DataLink efetuem
login como PIAdmin.
Horário PI
As abreviações e expressões do PI Time permitem que você especifique tempo e intervalos
de tempo para os dados que usam expressões constantes, variáveis e abreviadas.
Abreviações do Horário PI
Um intervalo é uma unidade de tempo que pode ser usada em entradas de tempo. Os
intervalos que suportam valores fracionados são listados abaixo. Nos intervalos onde a coluna
Frações indica Não, as quantidades fracionadas não podem ser usadas em strings de tempo.
Nome Nome curto Nome plural Nomes de membro Frações
segundo s segundos não sim
minuto m minutos não sim
hora h horas não sim
dia d dias não não
mês me meses sim (por exemplo, Dezembro) não
ano a anos não não
semana se semanas não não
dia da ds dias da sim (por exemplo, Terça- não
semana semana feira)
dia do ano da dias do ano não não
Você pode soletrar os nomes do mês e do dia da semana ou digitar as três primeiras letras
(por exemplo, Dez, Ter).
Os tempos do PI também podem ser expressos usando determinadas constantes:
Constante Resultado
* O horário atual.
Hoje ou h 12:00 do dia atual.
Ontem ou o 12:00 do dia anterior.
Domingo ou d 00:00:00 (meia noite) no domingo passado mais recente (em

referência ao PI Server).

Expressões do Horário PI
O PI permite três tipos de expressões de tempo: tempo relativo, tempo combinado e tempo
absoluto. Esses tipos de expressão de tempo são definidos na tabela a seguir.
Expressão Descrição Exemplos
Tempo As expressões de tempo relativo especificam um +1d
relativo número de dias, horas, minutos ou segundos com um -24h
sinal de orientação de soma ou de subtração. -3m
Na ausência de um tempo de referência (como * ou um +24s
tempo absoluto) nas strings de hora inicial ou hora final,
a hora final é calculada em relação ao horário atual e a
hora inicial é calculada em relação à hora final.
Tempo Uma expressão de tempo combinado é um tempo de *+8h
combinado referência específico seguido de uma expressão de 18-dez-02 -
tempo relativa. 3m
t+32s
Tempo Uma expressão de tempo absoluto é qualquer *
absoluto expressão de tempo que não seja uma expressão de 14-dez-97
tempo relativo nem combinado. 11-nov-96
2:00:00.0001
t
a
Ao usar tempos do PI, siga essas orientações:

• Use expressões de tempo absoluto ou combinado. Evite usar expressões de tempo
relativo. Várias expressões de tempo relativo em um intervalo de tempo podem gerar uma
hora inicial incorreta ou uma mensagem de erro, dependendo do contexto da expressão.
• As expressões de tempo relativo e combinado contêm apenas um único operador: um
único sinal de soma (+) ou um único sinal de subtração (-). Os operadores adicionais
podem gerar resultados imprevisíveis. Por exemplo, essas são expressões de tempo
inválidas:
*+1d+4h
T-1d+12h
• O nome ou nome curto de um intervalo usado para denotar o tempo do PI não difere
letras maiúsculas e minúsculas.
78
Horário PI
Exemplos de string de hora do PI
Exemplos de sintaxe de hora

String de hora do PI Ou seja
06-dez-91 15:00:00 15:00:00 em 6 de dezembro de 1991
* Hora atual (agora)
25 00:00:00 (meia noite) no dia 25 do mês atual
25-ago-92 00:00:00 (meia noite) em 25 de agosto de 1992
8: 08:00:00 na data atual
25 8: 08:00:00 no dia 25 do mês atual
t 00:00:00 na data atual (hoje)
a 00:00:00 na data anterior (ontem)
dom, seg, ter, qua, qui, sex, sab 00:00:00 no domingo, segunda, ... mais recente
Sábado
*-1h Uma hora atrás
t+8h 8:00:00 de hoje
a-8h 16:00:00 no dia antes de ontem
seg+14,5h 14:30:00 da última segunda-feira
sab-1m 23:59:00 da última sexta-feira
Exemplos de intervalo de hora

Nas expressões de intervalo, um intervalo positivo ou desmarcado é baseado na hora inicial e
um intervalo negativo é baseado na hora final de uma expressão de tempo.
Por exemplo, se a hora inicial for y, a hora final for t e o intervalo for +5h para uma função
Dados exemplificados, então os valores interpolados serão gerados em y, y+5h, y+10h,
y+15h e y+20h. Se o intervalo for -5h, os valores interpolados serão y+4h, y+9h, y+14h,
y+19h e t.
String de hora Ou seja
do PI
1,5h Uma e meia horas
32m Trinta e dois minutos
49s Quarenta e nove segundos
+5h Cinco horas adicionadas à hora que
começa com a hora inicial
-5h Cinco horas subtraídas da hora que começa
com a hora final

Suporte a tipo de dados do PI

O PI DataLink oferece suporte aos seguintes tipos de dados de ponto PI:
Tipo de dados Suporte
Digital (estados definidos) suportado
Int (16 e 32) suportado
Float (16, 32 e 64) suportado
String (texto) suportado
Timestamp suportado
Blob não suportado
Expressões do PI
As expressões do PI (também conhecidas como Equações de desempenho do PI) são usadas
para funções que incorporam operações matemáticas e cálculos com base em pontos PI.
Para algumas funções, é possível substituir uma Expressão de PI para um nome de tag a fim
de calcular valores à medida que eles são recuperados do PI Server. As funções que permitem
um argumento de expressão incluem os botões PI Tag e Expressão do PI no painel de
tarefas ou na caixa de diálogo da função.
Para basear uma função em uma expressão de cálculo do PI:
1. Clique no botão Expressão do PI na parte superior do painel de tarefas ou da caixa de
diálogo da função.
O campo Nome(s) de tag se torna um campo Expressão(ões). Outros campos podem ser
ativados ou ficarem inativos.
2. Insira a expressão diretamente no campo Expressão(ões), ou use o campo para
referenciar uma célula que contenha uma expressão.
O uso de referências de campo permite especificar várias expressões para uma função.
Lembre-se de que uma expressão em uma célula referenciada é uma string e deve ser
precedida por um apóstrofo.
Algumas funções também fornecem um campo para um argumento Expressão de filtro. É
possível fornecer uma expressão de filtro para limitar os valores retornados por uma função e
referenciar uma expressão de filtro em uma célula da planilha.
As funções que podem usar essas expressões incluem:
• Valor do arquivo (página 28)
• Dados compactados (página 29)
• Dados de amostragem (página 32)
• Dados com marcação de tempo (página 34)
• Dados calculados (página 35)
• Hora filtrada (página 40)
80
Expressões do PI
As seções a seguir descrevem resumidamente as noções básicas da expressão do PI. O PI

DataLink oferece suporte a todas as sintaxes funcionais, os operadores e as funções
suportados pelo PI Server.
Para obter uma descrição completa das Equações de desempenho do PI e exemplos, consulte
o Guia de aplicativos do PI Server ou o arquivo de ajuda online Equações de desempenho do
PI 3.
Sintaxe
Siga estas diretrizes ao escrever expressões do PI:

• Inicie a expressão com uma aspa simples para forçar que o Excel a interprete como uma
string.
• Inclua nomes de tag na expressão entre aspas simples.
• Insira duas aspas simples para uma expressão que comece com um nome de tag.

Operadores
Os seguintes operadores são suportados em Expressões do PI:

Tipo Operador Exemplo de sintaxe Significado
Aritmético + A + B Adição: A + B
- A - B Subtração: A menos B
* A * B Multiplicação: A vezes B
/ A / B Divisão: A dividido por B
^ A ^ B Elevação a uma potência: A à potência de B (AB)
Mod A mod B Módulo: o resto de A dividido por B
Relacional < A < B Menor que: retorna verdadeiro se A for menor que B
= A = B Igual a: retorna verdadeiro se A for igual a B
> A > B Maior que: retorna verdadeiro se A for maior que B
<= A <= B Menor ou igual a: retorna verdadeiro se A for menor ou igual
aB
<> A <> B Diferente de: retorna verdadeiro se A for diferente de B
>= A >= B Maior ou igual a: retorna verdadeiro se A for maior ou igual
aB
Prefixo Not NOT A Complemento: retorna verdadeiro se A for 0 e falso caso
contrário
- - A Negação (como operador de prefixo): retorna o negativo de
A
Conjunção, And A and B Conjunção: retorna verdadeiro se os operandos A & B
disjunção e forem avaliados como verdadeiros. Se A e B forem inteiros,
inclusão retorna o resultado de uma operação AND bit a bit.
Or A or B Disjunção inclusiva: retorna verdadeiro se o operando A ou
o operando B for avaliado como verdadeiro. Se A e B forem
inteiros, retorna o resultado de uma operação OR bit a bit.
in .. A in B..D Associação em um intervalo: retorna verdadeiro se o valor
de A estiver entre B e D
in ( ) A in (B1, B2, Associação em um conjunto discreto: retorna verdadeiro se
…BN) o valor de A corresponder a qualquer um dos valores
incluídos entre parênteses.
Expressões if then if A then B else Expressão If-then-else: retorna B se A for verdadeiro —
If-Then-Else else D caso contrário retorna D
82
Expressões do PI
Funções da Equação de desempenho
Também é possível avaliar expressões que contenham funções da Equação de desempenho do

PI:
Funções matemáticas
Nome Descrição
Abs Valor absoluto
Asin Arco seno
Acos Arco cosseno
Atn Arco tangente
Atn2 Arco tangente (dois argumentos)
Cos Cosseno
Cosh Cosseno hiperbólico
Exp Exponencial
Float Conversão de string em número
Frac Parte fracionária de número
Int Parte inteira de número
Log Logaritmo natural
Log10 Logaritmo comum
Poly Equação polinomial
Round Arredondamento à unidade mais próxima
Sgn Sinal numérico
Sin Seno
Sinh Seno hiperbólico
Sqr Raiz quadrada
Tanh Tangente hiperbólica
Tan Tangente
Trunc Truncamento à próxima unidade menor

Funções de agregação
Nome Descrição
Avg Média
Max Máximo
Median Seletor mediano
Min Mínimo
PStDev Desvio padrão populacional
SStDev Desvio padrão amostral
Total Soma
Funções diversas
Nome Descrição
BadVal Verificar se um valor é inválido (não um número ou hora)
Curve Obter o valor de uma curva
DigState Obter estado digital de uma string
IsDST Testar se uma hora está no período do horário de verão
IsSet Testar se um valor PI é anotado, substituído ou questionável
StateNo O número de código de um estado digital
TagBad Verificar se um ponto tem um estado anormal
Recuperação de arquivo do PI
Nome Descrição
NextEvent Horário do próximo evento Arquivo de um ponto
NextVal Próximo valor de um ponto após um horário
PrevEvent Horário do evento Arquivo anterior de um ponto
PrevVal Valor anterior de um ponto antes de um horário
TagVal Valor do ponto em um horário
Pesquisa de arquivo do PI
Nome Descrição
FindEq Carimbo de data e hora quando ponto = valor
FindGE Carimbo de data e hora quando ponto >= valor
FindGT Carimbo de data e hora quando ponto > valor
FindLE Carimbo de data e hora quando ponto <= valor
FindLT Carimbo de data e hora quando ponto < valor
FindNE Carimbo de data e hora quando ponto != valor
TimeEq Período total quando ponto = valor
TimeGE Período total quando ponto >= valor
84
Expressões do PI
Nome Descrição
TimeGT Período total quando ponto > valor
TimeLE Período total quando ponto <= valor
TimeLT Período total quando ponto < valor
TimeNE Período total quando ponto != valor
Estatísticas de arquivo do PI
Nome Descrição
EventCount Número de eventos Arquivo
PctGood Percentual de tempo válido em um período
Range Intervalo de valores mínimo a máximo
StDev Desvio padrão com peso de tempo
TagAvg Média com peso de tempo
TagMean Média com peso de evento
TagMax Valor máximo em um período
TagMin Valor mínimo em um período
TagTot Integral de tempo em um período
Atributos de ponto
Nome Descrição
TagDesc Obter o descritor de um ponto
TagEU Obter a string da unidade de engenharia de um ponto
TagExDesc Obter o descritor estendido de um ponto
TagName Obter o nome de um ponto
TagNum Obter a ID de um ponto
TagSource Obter a string da origem do ponto de um ponto
TagSpan Obter o alcance de um ponto
TagType Obter o caractere de tipo de um ponto
TagTypVal Obter o valor típico de um ponto
TagZero Obter o valor zero de um ponto
Funções de tempo
Nome Descrição
Bod Carimbo de data e hora para o início do dia de um determinado tempo
Bom Carimbo de data e hora para o início do mês de um determinado
tempo
Bonm Carimbo de data e hora para o primeiro dia do próximo mês de um
determinado tempo
Day Dia do mês de um tempo

Nome Descrição
DaySec Segundos desde a meia-noite de um tempo
Hour Hora de um tempo
Minute Minuto de um tempo
Month Mês de um tempo
Noon Carimbo de data e hora para o meio-dia local de um tempo
ParseTime Converter a string de caracteres em tempo
Second Segundo de um tempo
Weekday Dia da semana de um tempo
Year Ano de um tempo
Yearday Dia do ano de um tempo
Resposta dinâmica
Nome Descrição
Arma Resposta dinâmica do modelo Média móvel autorregressiva
Delay Introduzir atraso de tempo
MedianFilt Selecionar o valor mediano de uma série de tempo
Impulse Resposta dinâmica caracterizada por forma de resposta de impulso
Funções de status de alarme
Nome Descrição
AlmAckStat Código de status de confirmação de alarme
AlmCondition Número do código de condição para Estado do alarme
AlmCondText Condição de alarme como texto
AlmPriority Número de prioridade do alarme
Funções de string
Nome Descrição
Ascii Código de caractere ASCII de um caractere
Char String para código(s) de caractere ASCII
Compare Comparação curinga de duas strings
DigText Texto de um estado digital
Format Formatação de um símbolo numérico
InStr Instância de uma sub-string
LCase Conversão de todos os caracteres em minúsculas
Len Comprimento de uma string
Left Primeiros caracteres em uma string
LTrim Remoção de espaços do lado esquerdo de uma string
Mid Extração de uma sub-string de uma string
86
Expressões do PI
Nome Descrição
Right Últimos caracteres em uma string
RTrim Remoção de espaços do lado direito de uma string
Trim Remoção de espaços em ambos os lados de uma string
UCase Conversão de todos os caracteres em maiúsculas
Conversão de string
Nome Descrição
Concat Concatenar duas ou mais strings
String String que representa qualquer valor de PI
Text Concatenação de strings para uma série de argumentos de valor de PI
Exemplos de expressões do PI
Observação: Esses exemplos usam os delimitadores de tag: (vírgula) e . (ponto). Seu

PI system pode usar delimitadores diferentes.
A expressão a seguir determina a soma do valor de sinusoid elevado ao cubo e o valor de

cdf144 dividido por 10:
(('sinusoid')^3 + 'cdf144'/10)
A expressão a seguir será avaliada como verdadeira (diferente de zero) se o valor absoluto da
tag mytag for pelo menos 14,65.
(abs('my:tag') >= 14.65)
Ao comparar tags digitais, use o negativo do número de código do estado digital. Para tags
digitais, use a própria string de estado digital. Por exemplo:
('my:tag' = "Manual")
A expressão a seguir será avaliada como Verdadeira se o valor da tag sinusoid for menor
que 45 e a raiz quadrada do valor da tag vdf1002 for maior que 2:
('sinusoid' < 45 and sqr('vd:f1002') > 2)
Expressões de filtro


sinusoid < 70
Entrada manual de funções

O PI DataLink fornece ferramentas que podem ser usadas para criar qualquer função do PI
DataLink graficamente. Usuários experientes do Excel e do PI podem preferir inserir funções
diretamente na barra de fórmulas do Excel.
Os tópicos a seguir aplicam-se a funções do PI DataLink quando inseridas diretamente dessa
maneira.
Usar funções de array
Ao definir funções de array, siga estas etapas:

• Selecione um intervalo de saída apropriado para o array, com base no número de valores
esperados.
• Insira a função do PI e seus argumentos na barra de fórmulas do Excel.
• Coloque a função do PI nas células de saída selecionadas com a combinação de
pressionamento de teclas Ctrl+Shift+Enter.
Consulte a ajuda online do Microsoft Excel para obter informações adicionais sobre funções
de array.
Funções matemáticas
Em uma expressão de cálculo de tag, operadores matemáticos e funções agem sobre nomes
de tag. As funções matemáticas suportadas são:
abs — valor absoluto
atn — arco tangente (ângulo retornado em radianos)
cos — cosseno (argumento em radianos)
exp — e (2,71828...) elevado a uma potência
int — parte inteira de um número
log — logaritmo natural
sgn — função de sinal (-1 se o argumento for negativo, 0 se for zero, 1 se for positivo)
sin — seno (argumento em radianos)
88
Entrada manual de funções
sqr — função de raiz quadrada

tan — tangente (argumento em radianos)
Por exemplo, a expressão a seguir localiza a diferença entre o logaritmo natural do valor da
tag cdep158 e o cosseno do valor da tag cdep158.
(log('cdep158') - cos('cdep158'))
Argumentos de string
Os argumentos de string devem ser incluídos entre aspas duplas. Por exemplo, selecione um
array de saída 1 x 2 e insira:
=PICurrVal("sinusoid", 1, "casaba")
para recuperar a hora do instantâneo e o valor da tag sinusoid do PI Server casaba.
Referências de célula
É possível usar referências de célula para quaisquer argumentos de função do PI DataLink.

Por exemplo, a seguinte função:
=PICurrVal(A1, A2, A3)
fornece o mesmo resultado que a definição de função
=PICurrVal("sinusoid", 1, "casaba")
se os mesmos três argumentos estiverem armazenados nas células A1, A2 e A3,
respectivamente.
Argumento PIServer
O argumento PIServer é opcional, desde que o PIServer desejado esteja especificado como o
padrão em PI > Conexões.
Por exemplo, para recuperar o valor atual da tag sinusoid do PI Server padrão, insira:
=PICurrVal("sinusoid",0,)
em um intervalo de saída 1 x 1.
Códigos de saída
A sintaxe de funções do DataLink inclui argumentos de código de saída do tipo integer. O

código de saída determina como os dados acrescentados (página 17) são retornados e como
as células de saída são orientadas.
Os códigos de saída são gerados automaticamente por caixas de diálogo e painéis de tarefas
de funções. Entretanto, se inserir manualmente uma função na barra de funções do Excel,
você poderá precisar calcular e incluir valores de código de saída apropriados.
Um código de saída de função é uma representação decimal de bits binários. No PI DataLink,
os bits possuem os seguintes significados:

• 1º bit: bit Mostrar carimbos de data e hora

• 2º bit: bit Orientação (colunas/fileira)
• 3º bit: bit Mostrar percentual válido
• 4º bit: bit Ocultar contagem
• 5º bit: bit Mostrar status estendido
• 6º bit: bit Mostrar anotações
• 7º bit: Mostrar hora inicial
• 8º bit: Mostrar hora final
• 9º bit: Mostrar hora mín/máx
Por exemplo, o código de saída 0 em uma função PICurrVal() resulta em um valor de
instantâneo atual na célula de saída designada. O código de saída 1 coloca um carimbo de
data e hora na coluna um e o valor do instantâneo na coluna dois de um array 1 x 2. O código
de saída 2 coloca um carimbo de data e hora na fileira um e o valor do instantâneo na fileira
dois de um array 2 x 1.
A fórmula usada para calcular um código de saída correspondente é:
Observação: As funções possuem argumentos e códigos de saída diferentes. Aqueles

válidos para uma função não são necessariamente válidos para outra. Consulte a
referência de funções (página 95) para obter especificações de código de saída
por função.
EXEMPLO
Suponha que desejamos que uma função Dados calculados exiba Percentual válido, Hora
inicial e Hora mín/máx. Como Hora inicial e Hora mín/máx são exibidas, o bit Mostrar
carimbos de data e hora também deve ser definido. A função mostrada na barra de funções
do Excel seria semelhante a:
=PICalcDat("sinusoid","y","t","1h","minimum", 1, 325,"piserver")
90
Gravar dados no PI
Observação: Se um código de saída indicar que uma função deveria exibir várias
colunas ou fileiras, mas apenas uma aparecer, clique com o botão direito do
mouse e escolha Recalcular/Redimensionar para atualizar a função.
Gravar dados no PI
Embora as funções padrão do PI DataLink recuperem dados de um PI server, uma função
permite gravar um valor de uma planilha em um PI server. A função de macro do Excel
PIPutVal() (página 125) substitui um evento de arquivo existente do PI com um carimbo de
data e hora correspondente por um novo valor fornecido pelo usuário.
PIPutVal() pode ser executado apenas em uma folha de macro do Excel 4.0, ou em VBA
usando o método application.run. Consulte o módulo putval_code no arquivo
piexam32.xls distribuído com o PI DataLink, especialmente as tags marcadas como PutVal
e o módulo VBA PutVal_code, para obter um exemplo de um módulo VBA usado para
inserir funções do PI em uma planilha.
Observe que o VBA não reconhece funções do PI DataLink, mas é possível formular uma
função como string de texto e, em seguida, definir a propriedade Array da fórmula de um
intervalo de células como o valor da string de texto. O código VBA poderá então verificar os
valores de células pelos resultados da função do PI. Isso gera os mesmos resultados que a
entrada manual de funções do PI no mesmo intervalo de células.
Solução de problemas
Consulte as seções a seguir se tiver dificuldades ao usar o PI DataLink. Se esses tópicos não
tratarem ou resolverem o problema, consulte Suporte técnico e recursos (página 127) para
obter detalhes sobre como entrar em contato com o Suporte técnico.
Menu PI não disponível
Se um menu PI não aparecer após a instalação do PI DataLink, poderá ser necessário

configurar manualmente (página 4) o suplemento para Excel ou reduzir as configurações de
segurança (página 92) para suplementos.
Alguns scripts VBA escritos por usuários em planilhas do Excel (ou suplementos) são
conhecidos por redefinir o menu principal do Excel. Em tais casos, o menu PI pode
desaparecer, mesmo que o suplemento PI DataLink ainda esteja carregado, e funções de array
do PI DataLink inseridas podem funcionar mesmo se o próprio menu PI não estiver
disponível. Reiniciar o Excel normalmente corrige esse problema.

Limites de arrays e células
O PI DataLink está sujeito a uma limitação do Excel quanto ao número de elementos em um

array de cálculo. O número máximo de valores que podem ser retornados para uma única
função do PI, por recuperação, são:
• 65.536 para o Excel XP-2003
• 1.048.576 para o Excel 2007
O Excel SDK usado pelo PI DataLink limita as strings em 255 caracteres de comprimento
para o Excel XP-2003 e as strings de entrada para expressões do PI DataLink em uma célula
referenciada não podem exceder esse limite de 255 caracteres.
Da mesma forma, a saída de string, como strings de nome de PI tag, pode ser truncada pelo
PI DataLink em 255 caracteres.
Limitações de fileiras
O PI DataLink 4.x pode utilizar completamente o um milhão de fileiras em uma única

planilha do Microsoft Excel. Dados até esse limite podem ser recuperados em um ou mais
arrays de funções.
Para recuperar quantidades muito grandes de dados do PI, os usuários poderão precisar
configurar o parâmetro ArcMaxCollect no PI server. O valor padrão é 150 mil fileiras.
Observe que uma consulta pode exceder um limite máximo, mesmo que ela retorne um
número relativamente pequeno de valores. O que conta é o número real de eventos, chamados
dos arquivos do PI. Por exemplo, os valores da tag sinusoid variam constantemente entre
0 e 100. Uma consulta por valores de amostragem de sinusoid a cada 30 segundos durante um
ano, com uma expressão de filtro que exclua todos os valores menores que 95, poderia
retornar um número relativamente pequeno de valores, mas muito mais eventos são
recuperados dos arquivos à medida que a consulta é processada.
Segurança
Os recursos de segurança do Excel para suplementos, controles ActiveX e macros permitem

determinar os tipos de componentes que podem ser executados no Excel. Níveis diferentes de
configurações fornecem meios para desabilitar, habilitar com aviso ou habilitar
completamente esses tipos de objetos.
As configurações de segurança do Excel podem conflitar com determinados recursos do PI
DataLink:
• O DataLink é um suplemento do Excel. As configurações de segurança que desabilitam
suplementos impedem que o PI DataLink seja carregado no Excel.
• Os Controles de tendências (página 59) usam um controle ActiveX assinado marcado
como seguro para inicialização e requerem algum nível de habilitação para controles
ActiveX.
• As planilhas PIPutVal (página 125) usam macros e requerem algum nível de habilitação
para macros.
92
Solução de problemas
Se você aplicar regularmente a segurança do Excel a planilhas ou encontrar problemas ao

usar esses recursos do PI DataLink, poderá precisar reduzir ou eliminar as configurações de
segurança do Excel dependendo de como planeja usar o PI DataLink.
Para obter informações adicionais sobre segurança no Excel, consulte a ajuda online do
Microsoft Excel e os recursos online.

Anexo B
Referência de funções do PI DataLink

As caixas de diálogo de função (XP-2003) ou os painéis de tarefas (2007) (página 13) do PI
DataLink normalmente são usados para gerar funções do PI DataLink, com a função
resultante dependente das opções e argumentos selecionados. Essas mesmas funções também
podem ser inseridas diretamente (página 88) na barra de fórmulas do Excel.
A referência completa a seguir para funções suportadas do PI DataLink agrupa funções por
tipo. Cada tópico descreve opções de sintaxe completas e indica como os argumentos são
usados. Na maioria dos casos, também é fornecido um exemplo.
Funções de valor único

As funções de valor único associam um ponto PI a um momento específico, e retornam
apenas um valor de dados correspondente, a menos que um array de nomes de tags seja
referenciado.
PICurrVal()
Recupera os valores de ponto PI atuais do instantâneo, usando a seguinte sintaxe:

PICurrVal(tagname, outcode, PIServer)
ARGUMENTOS
Argumento Valor
Tagname (string) O nome de uma ou mais tags correspondentes aos pontos PI

desejados
outcode Um código de saída para determinar o posicionamento dos resultados:
(integer) 0, 1 ou 2
PIServer O PI server de destino
(string)
RETORNA
Código Valor Carimbo de data
de saída e hora
0 célula de saída nenhum
1 coluna à direita célula de saída
2 célula de saída fileira na parte

superior

EXEMPLO
O seguinte recupera o valor atual e o carimbo de data e hora correspondente para a tag
let439 do PI Server holden e coloca o carimbo de data e hora na coluna à esquerda do
valor:
=PICurrVal("let439",1,"holden")
• Valor atual (página 27)
PIArcVal()
Recupera valores de ponto PI arquivados correspondentes a horários especificados, usando a

seguinte sintaxe:
PIArcVal(tagname, timestamp, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor
tagname (string) O nome de uma ou mais tags correspondentes aos pontos PI
desejados
time stamp (string) O carimbo de data e hora correspondente ao valor do arquivo
outcode (integer) Um código de saída para determinar o posicionamento dos
resultados: 0, 1 ou 2
PIServer (string) O PI server de destino
mode (string) O modo usado para determinar quais valores são recuperados
RETORNA
Código Valor do Carimbo de data
de saída arquivo e hora
0 célula de saída
1 coluna à célula de saída
esquerda
superior
EXEMPLO
O seguinte recupera o valor interpolado para a tag cdep158 às 19h20 de 11 de dezembro de
1992 do PI Server casaba:
=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")
96
Funções de valor único
PIExpVal()
Recupera um valor de ponto PI arquivado com base em uma expressão, usando seguinte
sintaxe:
PIExpVal(expression, timestamp, PIServer)
ARGUMENTOS
Argumento Valor
expression (string) Uma expressão de cálculo do PI
time stamp (string) O carimbo de data e hora correspondente ao valor do arquivo
RETORNA
Código Valor do Carimbo de data
de saída arquivo e hora
0 célula de saída
1 coluna à célula de saída
esquerda
superior
EXEMPLO
O seguinte calcula a raiz quadrada do valor da tag sinusoid do PI server thevax ontem à
meia-noite:
=PIExpVal("sqr('sinusoid')","y",0,"thevax")

Funções de múltiplos valores

As funções de múltiplos valores associam um ponto PI a um intervalo de tempo durante o
qual pode haver um ou mais valores correspondentes em momentos diferentes.
PINCompDat()
Recupera diversos valores de ponto PI correspondentes a uma hora inicial especificada,

usando a seguinte sintaxe:
PINCompDat(tagname, stime, numvals, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor

desejados
stime (string) A hora inicial do intervalo de valores recuperados (no formato de
hora do PI)
numvals (integer) O número de valores desejados (negativo se estiver fazendo
contagem regressiva)
outcode (integer) Um código de saída
mode (string) O método de tratamento de valores nos limites do intervalo de
tempo
RETORNA
A exibição dos resultados é determinada pelo valor de um código de saída (página 89).
EXEMPLO
O seguinte recupera dez pontos de dados compactados e os carimbos de data e hora
correspondentes para a tag cdf144 iniciando à 1h00 do PI server padrão com inside como o
tipo de limite:
=PINCompDat("cdf144","1:00",10,1,,"inside")
98
PINCompFilDat()
Recupera diversos valores de ponto PI filtrados correspondentes a uma hora inicial

especificada, usando a seguinte sintaxe:
PINCompFilDat(tagname, stime, numvals, filtexp, filtcode, outcode,
PIServer, mode)
ARGUMENTOS
Argumento Valor
desejados
hora do PI)
numvals (integer) O número de valores desejados (negativo se estiver fazendo
contagem regressiva)
filtexp (string) Uma expressão de filtro usada para filtrar resultados
filtcode (integer) Um código de filtro: 1 para denotar status Filtrado ou 0 para ignorar
PIServer (string) O PI Server
mode (string) O método de tratamento de valores nos limites do intervalo de tempo
RETORNA
EXEMPLO
O seguinte recupera dez pontos de dados compactados e os horários correspondentes,
iniciando às 2h00, para a tag cdf144 quando a tag cdep158 for maior que 38:
=PINCompFilDat("cdf144","2:00",10,"'cdep158'>38",1,1,,)
O status Filtrado será exibido para os horários em que a condição do filtro for falsa. Os
dados são recuperados do PI Server padrão com inside como o tipo de limite.
• expressão de filtro (página 81)

PICompDat()
Recupera valores de ponto PI correspondentes a um intervalo de tempo especificado, usando

a seguinte sintaxe:
PICompDat(tagname, stime, etime, outcode, PIServer, mode)
ARGUMENTOS
Argumento Valor
desejados
hora do PI)
etime (string) A hora final do intervalo (em formato de hora do PI)
mode (string) O método de tratamento de valores nos limites do intervalo de
tempo
RETORNA
EXEMPLO
O seguinte recupera pontos de dados compactados e os carimbos de data e hora
correspondentes para a tag cdf144 iniciando à 1h00 até as 3h00 do PI server padrão com
inside como o tipo de limite:
=PICompDat("cdf144","1:00","3:00",1,,"inside")
100
PICompFilDat()
Recupera valores de ponto PI filtrados correspondentes a um intervalo de tempo especificado,

usando a seguinte sintaxe:
PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode,
PIServer, mode)
ARGUMENTOS
Argumento Valor
desejados
stime (string) A hora inicial do intervalo de valores recuperados (no formato de hora
do PI)
filtexp (string) A expressão de filtro usada para filtrar resultados
filtcode Um código de filtro: 1 para retornar o status Filtrado ou 0 para ignorar
(integer)
mode (string) O método de tratamento de valores nos limites do intervalo de tempo
RETORNA
EXEMPLO
O seguinte recupera pontos de dados compactados e os horários correspondentes, iniciando às
2h00 e terminando às 10h00, para a tag cdf144 quando a tag cdep158 for maior que 38:
=PICompFilDat("cdf144","2:00","10:00","'cdep158'>38",1,1,,)
O status Filtrado será exibido para tempos em que a condição do filtro for falsa. Os dados são
recuperados do PI server padrão com inside como o tipo de limite.

PISampDat()
Recupera valores de ponto PI de amostragem correspondentes a um intervalo de tempo

especificado, usando a seguinte sintaxe:
PISampDat(tagname, stime, etime, interval, outcode, PIServer)
ARGUMENTOS
Argumento Valor
desejados
stime (string) A hora inicial do intervalo da amostragem (no formato de hora do PI)
interval O intervalo entre os valores da amostragem (em formato de hora do
(string) PI)
outcode Um código de saída: 0, 1, 2 ou 3
(integer)
PIServer O PI server de destino
(string)
RETORNA
Código Valor de Carimbo de data
de saída amostragem e hora
3 fileira abaixo célula de saída
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 0. O
código de saída 3 transpõe o array de saída resultante do código de saída 1.
EXEMPLO
O seguinte recupera dados de amostragem para a tag localizada na célula B1, de ontem à
meia-noite até a meia-noite de hoje, em intervalos de três horas:
=PISampDat(b1,"y","t","3h",1,)
Os carimbos de data e hora também são retornados.
102
PISampFilDat()
Recupera valores de ponto PI de amostragem filtrados correspondentes a um intervalo de

tempo especificado, usando a seguinte sintaxe:
PISampFilDat(tagname, stime, etime, interval, filtexp, filtcode,
outcode, PI Server)
ARGUMENTOS
Argumento Valor
desejados
stime (string) A hora inicial do intervalo da amostragem (no formato de hora do
PI)
etime (string) A hora final em formato de hora do PI
interval (string) O intervalo entre os valores da amostragem (em formato de hora do
PI)
filtcode (integer) Um código de filtro: 1 para retornar o status Filtrado ou 0 para
ignorar
outcode (integer) Um código de saída: 0, 1, 2 ou 3
RETORNA
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 0 e o
EXEMPLO
A fórmula a seguir recupera dados de amostragem para sinusoid em 11-Jan-97, 11-Jan-97
1h00, 11-Jan-97 2h00 e 11-Jan-97 3h00:
=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)
Os carimbos de data e hora são mostrados na coluna 1 e os valores na coluna 2. O status
Filtrado será retornado para valores que não satisfaçam a condição de filtro na célula A1.

PIExpDat()
Recupera valores de ponto PI com base em uma expressão, usando seguinte sintaxe:
PIExpDat(expression, stime, etime, interval, outcode, PIServer)
ARGUMENTOS
Argumento Explicação
stime (string) A hora inicial do intervalo de valores de amostragem (no formato de
hora do PI)
etime (string) A hora final (em formato de hora do PI)
interval (string) O intervalo entre os valores da amostragem (em formato de hora do
PI)
outcode (integer) Um código de saída para determinar o posicionamento dos
resultados: 0, 1, 2 ou 3
RETORNA
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 0,
enquanto o código de saída 3 transpõe o array de saída resultante do código de saída 1.
EXEMPLO
O seguinte calcula a raiz quadrada do valor da tag sinusoid do PI server thevax em
intervalos de uma hora, iniciando ontem à meia-noite até a meia-noite de hoje:
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
Também exibe os carimbos de data e hora.
• expressão de cálculo do PI (página 81)
104
PITimeDat()
Recupera valores de ponto PI de amostragem correspondentes a um array de carimbos de data

e hora especificado, usando a seguinte sintaxe:
PITimeDat(tagname, timestamps, PIServer, mode)
ARGUMENTOS
desejados
timestamps (reference) Uma referência a um array de carimbos de data e hora em
formato de hora do PI
mode (string) O modo usado para determinar quais valores devem ser
recuperados
RETORNA
Dados de amostragem. Se os carimbos de data e hora estiverem em uma única coluna, os
dados serão retornados ao longo de uma única coluna. Se os carimbos de data e hora
estiverem em uma única fileira, os dados serão retornados ao longo de uma única fileira.
EXEMPLO
O seguinte recupera dados com marcação de tempo interpolados para os horários localizados
nas células B1 até B12 para a tag mytag do PI Server padrão:
=PITimeDat("mytag",b1:b12,,"interpolated")

PITimeExpDat()
Recupera valores de ponto PI com base em uma expressão e correspondentes a um array de

carimbos de data e hora especificado, usando a seguinte sintaxe:
PITimeExpDat(expression, timestamps, PIServer)
ARGUMENTOS
timestamps (reference) Uma referência a um array de carimbos de data e hora em
formato de hora do PI (aumentando ou diminuindo de forma
constante para PI 2 servers)
RETORNA
Dados de amostragem. Se os carimbos de data e hora estiverem em uma única coluna, os
dados serão retornados ao longo de uma única coluna. Se os carimbos de data e hora
estiverem em uma única fileira, os dados serão retornados ao longo de uma única fileira.
EXEMPLO
O seguinte calcula a raiz quadrada do valor da tag sinusoid para os horários localizados
nas células B1 até B12 do PI server padrão:
=PITimeExpDat("sqr('sinusoid')",b1:b12,)
106
Funções de cálculo
As funções de cálculo computam novos valores a partir de valores de ponto PI
correspondentes a um intervalo de tempo específico.
PICalcVal()
Recupera um valor de ponto PI calculado usando a seguinte sintaxe:

PICalcVal(tagname, stime, etime, mode, cfactor, outcode, PIServer)
Observação: PICalcVal() é gerado somente pela caixa de diálogo Dados calculados

em versões XP-2003. As versões 2007 usam PIAdvCalcVal().
ARGUMENTOS
desejados para cálculo
stime (string) A hora inicial do intervalo de cálculo (no formato de hora do PI)
mode (string) O tipo de cálculo a ser usado para computar valores de ponto
cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória para
cálculos Total
outcode (integer) Um código de saída: 0-7 e não 3
RETORNA
O argumento código de saída (página 89) afeta a saída da seguinte maneira:
• Se o código de saída for 0, somente o valor calculado será retornado.
• Se o código de saída for 1, o seguinte se aplica:
Modo Coluna 1 Coluna 2 Coluna 3
Total Valor total
Minimum Tempo de valor mínimo Valor mínimo
Maximum Tempo de valor máximo Valor máximo

Stdev Valor do desvio padrão
Range Tempo de valor mínimo Tempo de valor máximo Valor do intervalo
Average Valor médio
Count Valor de contagem
Mean Valor mediano

• O código de saída 2 transpõe o array de saída resultante do código de saída 1 e os

resultados são retornados em fileiras em vez de colunas.
• O código de saída 3 não é usado.
• Se o código de saída for 4, o percentual válido será retornado à direita da célula do valor.
• Se o código de saída for 5, o seguinte se aplica:
Modo Coluna 1 Coluna 2 Coluna 3 Coluna 4
Total Valor total Percentual válido
Minimum Tempo de valor Valor mínimo Percentual
mínimo válido
Maximum Tempo de valor Valor máximo Percentual
máximo válido
Stdev Valor do desvio Percentual válido
padrão
Range Tempo de valor Tempo de valor Valor do Percentual
mínimo máximo intervalo válido
Average Valor médio Percentual válido
Count Valor de contagem Percentual válido
Mean Valor mediano Percentual válido

EXEMPLO
O seguinte calcula um total com peso de tempo para a tag cdf144 desde ontem até hoje do
PI Server padrão:
=PICalcVal("cdf144","y","t","total",1440,4,)
O resultado é multiplicado por 1440. O percentual válido é retornado ao lado do total.
108
PIAdvCalcVal()
Recupera um valor de ponto PI calculado usando a seguinte sintaxe:

PIAdvCalcVal(tagname, stime, etime, mode, calcbasis, minpctgood,
cfactor, outcode, PIServer)
ARGUMENTOS
tagname (string) O nome da tag correspondente ao ponto PI desejado para cálculo
calcbasis (string) O método de definição de peso usado para calcular valores
minpctgood O percentual mínimo de dados válidos requeridos para calcular e
(number) retornar um valor
cálculos Total
outcode (integer) Um código de saída: 0, 1, 2, 4, 5, 6 ou 7 e não 3
RETORNA
Consulte informações específicas para códigos de saída de PICalcVal() (página 107).
EXEMPLO
O seguinte calcula um total com peso de tempo para a tag cdf144 desde ontem até hoje do
PI Server padrão:
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",50,1,4,)
O resultado é multiplicado por 1. O minpctgood é 50 por cento, de maneira que o
resultado será exibido apenas se o percentual válido for 50 por cento ou maior. O percentual
válido é retornado ao lado do total.

PIAdvCalcFilVal()
Recupera um valor de ponto PI calculado filtrado, usando a seguinte sintaxe:

PIAdvCalcFilVal(tagname, stime, etime, filtexp, mode, calcbasis,
sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
sampmode (string) O método de amostragem usado para expressões de cálculo
sampfreq (string) A frequência usada para amostragem do tipo interpolated
minpctgood (number) O percentual mínimo de dados válidos requeridos para calcular e
retornar um valor
Cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória
para cálculos Total
RETORNA
EXEMPLO
O seguinte calcula um total com peso de tempo para a tag cdf144 desde ontem até hoje
durante períodos de tempo quando a tag cdm158 está Manual do PI Server padrão:
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total","t
ime-weighted","pt. compressed","10m",50,1,4,)
O resultado é multiplicado por 1. Como ponto compactado é o modo de amostragem
especificado, a frequência de amostragem será ignorada e a expressão de filtro será amostrada
nos eventos compactados de cdf144. O minpctgood é 50 por cento, de maneira que o
110
PIAdvCalcExpVal()
Recupera um valor de ponto PI calculado com base em uma expressão, usando seguinte
sintaxe:
PIAdvCalcExpVal(expression, stime, etime, mode, calcbasis,
sampmode, sampfreq, minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
retornar um valor
cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória
RETORNA
EXEMPLO
O seguinte calcula um total com peso de tempo para a expressão 'cdf144'+'cdt158' desde
ontem até hoje do PI Server padrão:
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","time-
weighted","compressed","10m",50,1,4,)
O resultado é multiplicado por 1. Como compactado é o modo de amostragem especificado, a
frequência de amostragem será ignorada e a expressão será amostrada nos eventos
compactados combinados de cdf144 e cdt158. O minpctgood é 50 por cento, de
maneira que o resultado será exibido apenas se o percentual válido for 50 por cento ou maior.
O percentual válido é retornado ao lado do total.

PIAdvCalcExpFilVal()
Recupera um valor de ponto PI calculado filtrado com base em uma expressão, usando
seguinte sintaxe:
PIAdvCalcExpFilVal(expression, stime, etime, filtexp, mode,
calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode,
PIServer)
ARGUMENTOS
retornar um valor
RETORNA
EXEMPLO
O seguinte calcula um total com peso de tempo para a expressão 'cdf144'+'cdt158'
quando 'productid' = "Product2" desde ontem até hoje do PI Server padrão:
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'="Prod
uct2"","total","time-weighted","compressed","10m",50,1,4,)
112
PICalcDat()
Recupera valores de ponto PI calculados usando a seguinte sintaxe:

PICalcDat(tagname, stime, etime, interval, mode, cfactor, outcode,
PIServer)
Observação: PICalcDat() é gerado somente pela caixa de diálogo Dados calculados

em versões XP-2003. As versões 2007 usam PIAdvCalcDat().
ARGUMENTOS
tagname (string) O nome de uma ou mais tags correspondentes aos pontos PI desejados para
cálculo
interval (string) O intervalo entre os valores calculados (em formato de hora do PI)
cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória para cálculos Total
outcode (integer) Um código de saída: 0-7
RETORNA
O argumento código de saída (página 89) afeta a saída da seguinte maneira:
• 0 produz valores calculados ao longo de uma coluna
• 1 produz carimbos de data e hora e valores ao longo de 2 colunas
• 2 produz valores calculados ao longo de uma fileira
• 3 produz carimbos de data e hora e valores ao longo de 2 fileiras
• 4 produz valores e percentual válido ao longo de 2 colunas
• 5 produz carimbos de data e hora, valores e percentual válido ao longo de 3 colunas
• 6 produz valores e percentual válido ao longo de 2 fileiras
• 7 produz carimbos de data e hora, valores e percentual válido ao longo de 3 fileiras
EXEMPLO
O seguinte recupera totais para a tag localizada na célula B1, de ontem à meia-noite até a
meia-noite de hoje, em intervalos de três horas do PI Server padrão:
=PICalcDat(b1,"y","t","3h","total",24,1,)
Os carimbos de data e hora também são retornados. Os valores são multiplicados por 24 antes
de serem exibidos na planilha.

PIAdvCalcDat()
Recupera valores de ponto PI calculados usando a seguinte sintaxe:

PIAdvCalcDat(tagname, stime, etime, interval, mode, calcbasis,
minpctgood, cfactor, outcode, PIServer)
ARGUMENTOS
minpctgood O percentual mínimo de dados válidos requeridos para calcular e
(number) retornar um valor
cálculos Total
RETORNA
Consulte informações específicas para códigos de saída de PICalcDat() (página 113).
EXEMPLO
O seguinte recupera totais para a tag cdf144, de ontem à meia-noite até a meia-noite de
hoje, em intervalos de três horas do PI Server padrão:
=PIAdvCalcDat("cdf144","y","t","3h","total","time-
weighted",50,1,4,)
O resultado é multiplicado por 1. O minpctgood é 50 por cento, de maneira que o
114
PIAdvCalcFilDat()
Recupera valores de ponto PI calculados filtrados, usando a seguinte sintaxe:

PIAdvCalcFilDat(tagname, stime, etime, interval, filtexp, mode,
PIServer)
ARGUMENTOS
tagname (string) O nome de uma ou mais tags correspondentes aos pontos PI desejados para
cálculo
minpctgood (number) O percentual mínimo de dados válidos requeridos para calcular e retornar um
valor
cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória para cálculos
Total
RETORNA
EXEMPLO
O seguinte recupera totais para a tag cdf144, desde ontem à meia-noite até a meia-noite de
hoje, em intervalos de três horas, durante os períodos de tempo em que a tag cdf144 estiver
Manual do PI Server padrão:
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""","tota
l","time-weighted","pt. compressed","10m",50,1,4,)
O resultado é multiplicado por 1. Como ponto compactado é o modo de amostragem
especificado, a frequência de amostragem será ignorada e a expressão de filtro será amostrada
nos eventos compactados de cdf144. O percentual válido é retornado ao lado do total.

PIAdvCalcExpDat()
Recupera valores de ponto PI calculados com base em uma expressão, usando seguinte
sintaxe:
PIAdvCalcExpDat(expression, stime, etime, interval, mode,
PIServer)
ARGUMENTOS
interval (string) O intervalo entre os valores calculados (em formato de hora do
PI)
retornar um valor
RETORNA
EXEMPLO
O seguinte recupera totais para a expressão 'cdf144'+'cdt158', de ontem à meia-noite até a
meia-noite de hoje, em intervalos de três horas do PI Server padrão:
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total","time-
weighted","compressed", "10m",50,1,4,)
116
PIAdvCalcExpFilDat()
Recupera valores de ponto PI calculados filtrados, com base em uma expressão, usando
seguinte sintaxe:
PIAdvCalcExpFilDat(expression, stime, etime, interval, filtexp,
mode, calcbasis, sampmode, sampfreq, minpctgood, cfactor, outcode,
PIServer)
ARGUMENTOS
minpctgood (number) O percentual mínimo de dados válidos requeridos para calcular e retornar um valor
cfactor (number) A unidade de tempo do fluxo para a tag de origem, obrigatória para cálculos Total
RETORNA
EXEMPLO
O seguinte calcula um total com peso de tempo para a expressão 'cdf144'+'cdt158'
quando 'productid' = "Product2" em intervalos de três horas, desde ontem até hoje do
PI Server padrão:
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
• Dados calculados (página 35), expressão de cálculo do PI (página 81) é expressão de
filtro (página 81)

PITimeFilter()
Retorna a quantidade de tempo durante intervalos especificados para a qual uma expressão de
ponto PI é avaliada como verdadeira, usando a seguinte sintaxe:
PITimeFilter(expression, stime, etime, interval, timeunit,
outcode, PIServer)
ARGUMENTOS
interval (string) O intervalo entre avaliações (em formato de hora do PI)
timeunit (string) Unidade de tempo do resultado calculado (em formato de tempo
do PI)
RETORNA
Código Coluna 1 Coluna 2
de saída
0 Dados calculados
1 Carimbos de data e Dados calculados
hora
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 0 e o
EXEMPLO
O seguinte calcula a quantidade de tempo que a expressão da célula $A$1 é verdadeira do PI
Server denominado thevax, em intervalos de uma hora, iniciando à meia-noite de ontem até
hoje à meia-noite:
=PITimeFilter($A$1,"y","t","1h","seconds",1,"thevax")
Também exibe os carimbos de data e hora da hora inicial de cada intervalo de cálculo. O
resultado do cálculo é expresso em segundos.
118
PITimeFilterVal()
Retorna a quantidade de tempo durante a qual uma expressão de ponto PI é avaliada como
verdadeira para um intervalo de tempo especificado, usando a seguinte sintaxe:
PITimeFilterVal(expression, stime, etime, timeunit, outcode,
PIServer)
ARGUMENTOS
timeunit (string) Unidade de tempo do resultado calculado (em formato de tempo do
PI)
RETORNA
• Se o código de saída (página 89) for 0, 1 ou 2, somente o valor calculado será retornado.
• O código de saída 3 não é usado.
• Se o código de saída for 4 ou 5, o percentual válido será retornado à direita da célula do
valor.
• Se o código de saída for 6 ou 7, o percentual válido será retornado abaixo da célula do
valor.
EXEMPLO
O seguinte calcula a quantidade de tempo que a expressão da célula $A$1 é verdadeira do PI
Server denominado thevax, iniciando à meia-noite de ontem até hoje à meia-noite:
=PITimeFilterVal($A$1,"y","t","seconds",1,"thevax")
O resultado do cálculo é expresso em segundos.

Funções de tag
PIPointIDToTag()
Recupera um nome de tag correspondente a uma ID de ponto PI, usando a seguinte sintaxe:
PIPointIDToTag(pointid, PIServer)
ARGUMENTOS
pointid (string) Uma ID de ponto PI, que é uma ID interna exclusiva, não reutilizada
após a exclusão de um ponto
RETORNA
Nome da tag
EXEMPLO
O seguinte retorna o nome da tag com ID de ponto 123 do servidor denominado thevax.
=PIPointIDToTag("123","thevax")
• ID de ponto para tag (página 45)
120
Funções de tag
PIAttributeMaskToTag ()
Recupera um nome de tag correspondente a um ou mais atributos de ponto, usando a seguinte

sintaxe:
PIAttributeMaskToTag(tagname, descriptor, pointsource, pointtype,
pointclass, engunits, outcode, PIServer)
ARGUMENTOS
tagname (string) Máscara do Nome de tag
descriptor (string) Máscara do Descritor
pointsource (string) Máscara da Origem do ponto
pointtype (string) Máscara do Tipo de ponto
pointclass (string) Máscara da Classe ponto
engunits (string) Máscara de Unidades de engenharia
outcode (integer) Um código de saída: 0 ou 2
RETORNA
de saída
0 Nome da
tag
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 1.
EXEMPLO
O seguinte retorna o nome das tags que iniciam com "sin" do servidor denominado
thevax.
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
• Máscara de atributo para tag (página 46)

PITagAtt()
Recupera o valor de um atributo de tag com base em um nome de tag, usando a seguinte
sintaxe:
PITagAtt(tagname, attribute, PIServer)
ARGUMENTOS
tagname (string) O nome de uma ou mais tags correspondentes aos atributos
desejados
attribute (string) O atributo do ponto PI desejado
RETORNA
Valor do atributo de tag
EXEMPLO
O seguinte recupera do PI Server padrão as unidades de engenharia da tag localizada na
célula D1:
=PITagAtt(d1,"units",)
• Atributos de tag (página 47)
122
PIAliasToTag()
Recupera um nome de tag com base em um alias de ponto PI, usando a seguinte sintaxe:
PIAliasToTag(alias, modulepath, querydate, outcode, PIServer)
ARGUMENTOS
alias (string) O alias do banco de dados do módulo correspondente ao ponto PI
desejado
modulepath O caminho completo do módulo até o alias
(string)
querydate Um limite de data, de maneira que apenas os aliases criados nessa
(integer) data ou posteriormente sejam retornados
Outcode (integer) Um código de saída: 0, 1 ou 2
RETORNA
de saída
0 Nome da
tag
1 Nome da Servidor da tag
tag
O código de saída (página 89) 2 transpõe o array de saída resultante do código de saída 1.
EXEMPLO
O seguinte retorna o nome de tag correspondente ao alias Temperature do módulo Reactor1,
que é um submódulo de Unit1. Unit1 está na raiz do banco de dados do módulo para um PI
server denominado thevax. O banco de dados do módulo é consultado na hora atual.
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
• Alias para tag (página 51)

PIPropertyToValue()
Recupera o valor de uma propriedade de ponto PI especificada, usando a seguinte sintaxe:

PIPropertyToValue(property, modulepath, querydate, PIServer,
outcode)
ARGUMENTOS
Property (string) A propriedade do banco de dados do módulo correspondente ao
ponto PI desejado
modulepath O caminho completo do módulo até a propriedade
(string)
querydate Um limite de data, de maneira que apenas as propriedades criadas
(integer) nessa data ou posteriormente sejam retornadas
Outcode (integer) Um código de saída: 0, 1 ou 2
RETORNA
• O código de saída (página 89) 0 exibe o valor da propriedade em uma coluna.
• O código de saída 2 exibe o valor da propriedade em uma fileira.
EXEMPLO
O seguinte retorna o valor correspondente à propriedade Temperature do módulo Reactor1,
que é um submódulo de Unit1. Unit1 está na raiz do banco de dados do módulo para um PI
server denominado thevax. O banco de dados do módulo é consultado na hora atual.
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")
• Propriedade para valor (página 52)
124
Funções de entrada
Funções de entrada
PIPutVal()
PIPutVal(tagname, value, time stamp, PIServer, outcell)
PIPutVal oferece suporte a todos os tipos de dados do PI 3 (incluindo entrada de string
para tags de string), bem como dados com frações de segundo. Os carimbos de data e hora
são interpretados usando informações do fuso horário do computador cliente para o PI 3, a
menos que Usar fuso horário do PI Server esteja habilitado.
ARGUMENTOS
tagname (string) A tag para a qual o valor será gravado para o PI
value (reference) A referência para um valor a ser gravado: uma string (para
estados digitais) ou um número
time stamp (string) Um carimbo de data e hora no formato de tempo do PI
outcell (reference) Uma referência para uma célula na qual o valor de retorno dessa
função de macro é exibido
RETORNA
Retorna o valor de string False se a função de macro falhar e grava uma mensagem de erro na
célula de saída. Se houver êxito na gravação no PI Server, a string True será retornada e o
status será gravado na célula de saída.
Observação: PIPutVal() não verifica o intervalo especificado pelo usuário para uma
tag antes de gravar. O intervalo é definido de zero até zero + span, em que
zero e span são atributos de tag especificados durante a criação do ponto (tag). O
DataLink retorna um valor mesmo que Acima do intervalo ou Abaixo do intervalo
sejam inseridos no PI.
EXEMPLO
O seguinte põe o valor localizado na célula A5 no PI Server padrão para a meia-noite de hoje
para a tag testtag:
=PIPutVal("testtag",a5,"t",,e5)
O resultado da função de macro é colocado na célula E5 da folha de macro.

Anexo C
Suporte técnico e recursos

Você pode ler as informações completas sobre as opções de suporte técnico e acessar todos os
recursos a seguir no site de Suporte técnico da OSIsoft:
http://techsupport.osisoft.com
Antes de ligar ou escrever para obter ajuda
Ao contatar o Suporte técnico da OSIsoft, forneça:

• Nome do produto, versão e/ou números de compilação
• Plataforma do computador (tipo de CPU, sistema operacional e número de versão)
• A hora em que a dificuldade começou
• O(s) arquivo(s) de log naquela hora
Help Desk e suporte telefônico
Você pode contatar o Suporte técnico da OSIsoft 24 horas por dia. Use os números na tabela
abaixo para encontrar o mais adequado para sua área. Discar qualquer um desses números
encaminhará sua chamada para nossa fila de suporte global para ser atendida por engenheiros
ao redor do mundo.
Local do escritório Número de acesso Opções de idioma local
San Leandro, CA, EUA 1 510 297 5828 Inglês
Filadélfia, PA, EUA 1 215 606 0705 Inglês
Johnson City, TN, EUA 1 423 610 3800 Inglês
Montreal, QC, Canadá 1 514 493 0663 Inglês, francês
São Paulo, Brasil 55 11 3053 5040 Inglês, português
Frankfurt, Alemanha 49 6047 989 333 Inglês, alemão
Manama, Reino de Bahrain 973 1758 4429 Inglês, árabe
Cingapura 65 6391 1811 Inglês, mandarim
86 021 2327 8686 Mandarim
Perth, WA, Austrália 61 8 9282 9220 Inglês

Suporte técnico e recursos
O suporte pode ser fornecido em outros idiomas diferente do inglês em determinados centros
(listados acima) com base na disponibilidade dos atendentes. Se você selecionar uma opção
de idioma local, faremos nossos melhores esforços para conectá-lo a um Engenheiro de
Suporte Técnico (TSE) que saiba o idioma. Se nenhum TSE do idioma local estiver
disponível para ajudá-lo, você será encaminhado para o primeiro atendente disponível.
Se todos os TSEs disponíveis estiverem ocupados atendendo outros clientes quando você
ligar, será solicitado que você permaneça na linha para aguardar o próximo TSE disponível
ou então deixe uma mensagem de correio de voz. Se você decidir deixar uma mensagem, não
perderá seu lugar na fila. Seu correio de voz será tratado como uma chamada telefônica
normal e será direcionado para o primeiro TSE que ficar disponível.
Se você estiver ligando sobre um caso em andamento, certifique-se de indicar o número do
caso ao ligar, assim poderemos conectá-lo ao engenheiro que está cuidando do seu caso no
momento. Se esse engenheiro não estiver disponível, outro engenheiro tentará ajudá-lo.
Procurar suporte
No site de Suporte técnico da OSIsoft, clique em Procurar suporte.

Procure rápida e facilmente as soluções de suporte, a documentação e os boletins de suporte
do site de Suporte técnico da OSIsoft usando o mecanismo de busca avançado do MS
SharePoint.
Suporte técnico baseado em e-mail
techsupport@osisoft.com
Ao contatar o Suporte técnico da OSIsoft por e-mail, será útil enviar as seguintes
informações:
• Descrição do problema: breve descrição do problema, sintomas, mensagens de erro ou
informação, histórico do erro
• Arquivos de log: Consulte a documentação do produto para obter informações sobre a
obtenção dos logs relevantes à situação.
Suporte técnico on-line
No site de Suporte técnico da OSIsoft, clique em Fale conosco > Meu suporte > Minhas
chamadas.
Ao usar o Suporte técnico on-line da OSIsoft, você pode:
• Inserir uma nova chamada diretamente no banco de dados da OSIsoft (monitorado 24
horas por dia)
• Visualizar ou editar chamadas da OSIsoft existentes que você inseriu
• Visualizar uma das chamadas inseridas por sua organização ou site, se permitido
• Consultar seu software licenciado e datas dos seus contratos do Programa de Confiança
do Serviço
128
Acesso remoto
No site de Suporte técnico da OSIsoft, clique em Fale conosco > Opções de suporte
remoto.
Os engenheiros de suporte da OSIsoft podem acessar remotamente seu servidor para fornecer
soluções práticas de problema e assistência. Consulte a página Acesso remoto para obter
detalhes sobre os diversos métodos que você pode usar.
Serviço no local
No site de Suporte técnico da OSIsoft, clique em Fale conosco > Visita de serviço no local.
A OSIsoft fornece serviço no local cobrando uma taxa. Visite nossa página Visita de serviço
no local para obter mais informações.
Centro de Conhecimento
No site de Suporte técnico da OSIsoft, clique em Centro de Conhecimento.

O Centro de Conhecimento fornece uma biblioteca de documentação e dados técnicos, bem
como uma coleção especial de recursos para gerenciadores de sistema. Para obter essas
opções, clique em Centro de Conhecimento no site do Suporte técnico.
• O recurso Pesquisa permite que você procure soluções de suporte, boletins, páginas de
suporte, problemas conhecidos, aprimoramentos e documentação (incluindo manuais do
usuário, notas de publicação e documentação técnica).
• Os recursos do gerenciador de sistema incluem ferramentas e instruções que ajudam você
a gerenciar: Tamanho de arquivo, scripts de backup, verificações de integridade diárias,
configuração do horário de verão, segurança do PI Server, tamanho e configuração do PI
System, confianças do PI para Nós de interface e mais.
Atualizações
No site de Suporte técnico da OSIsoft, clique em Fale conosco > Obtendo atualizações.
Você está qualificado para baixar ou pedir qualquer versão disponível de um produto para o
qual você tem um Programa de Confiança do Serviço (SRP), anteriormente conhecido como
Contrato de Suporte Técnico (TSA). Para verificar ou alterar seu status de SRP, contate seu
representante local ou Suporte técnico (http://techsupport.osisoft.com/) para obter assistência.

Índice
frequência da amostragem de expressão - 35
A função Alias para tag - 51
função Atributos de tag - 47
acesso a dados - 76
função Dados calculados - 35
Acesso a pontos - 76
função Dados calculados avançados - 35
anotações, mostrar - 20
função Dados com marcação de tempo - 34
apóstrofo, uso no Excel - 14, 15
função Dados compactados - 29
argumento código de saída - 88, 89
função Dados de amostragem - 32
argumentos de tempo - 16
função do PI Datalink, argumentos de - 15
aspa simples - 14, 15
função Hora filtrada - 40
atributos do valor, mostrar - 20
função ID de ponto para tag - 45
função Máscara de atributo para tag - 46
B
função Propriedade para valor - 52
banco de dados do módulo, procurar - 49 função Valor atual - 27
base de cálculo - 35 função Valor do arquivo - 28
funções - 27, 51, 53
C Atualizando dados do PI em uma planilha - 53
Campos de saída - 15 Caixas de diálogo - 95
carimbos de data e hora - 17, 18 caixas de diálogo de função - 11
Conexões - 12 definir - 8, 11, 13
conexões do PI server - 12 Excel - 13
Configurações - 22 Inserindo no Excel - 88
controles de orientação - 20 modificar - 57
painéis de tarefas de função - 8
D funções de tag - 45
funções, array de - 54, 55, 56
dados, atualização de - 54
automático - 54
H
manual - 55
desvio padrão - 35 hora e número, formatos de - 16, 21
E I
equações de desempenho - 81 instalação - 75
erros - 91 configurar o Excel - 5
Excel, suplemento - 1, 10 instalação silenciosa - 75
expressões intervalo de tempo - 28
cálculo do PI - 81 Intervalo de tempo - 32
filtro - 87
sintaxe - 80 M
expressões de cálculo - 81 média - 35
expressões de cálculo do PI - 81 Menu PI - 8, 10
expressões de filtro - 87 Microsoft Excel - 5
modo da amostragem de expressão - 35
F modo de cálculo - 35
fator de conversão - 35 modo de recuperação - 34
formatos de número - 16, 21, 22 mostrar anotações - 20
formatos de tempo - 16, 77 mostrar atributos do valor - 20

Índice
mostrar carimbo de data e hora - 18 valores de função - 55

mostrar percentual válido - 19 planilhas - 53
mover arrays de funções - 56 procurar - 51
O R
operadores - 80 referências de célula - 14
P S
percentual mínimo válido - 35 solução de problemas - 91
Pesquisa de tags - 43 strings de tempo do PI - 77
PI DataLink - 1 Suporte técnico da OSIsoft - 127
for Excel Services - 3
instalação - 75 T
interface - 7 tamanho do array - 57
PI Module Database - 49 tendência - 59
funções - 51 tipo de limite - 29
procurar - 51 Totais - 35
PI Notifications - 67
PI SDK - 2 V
PI system, notificações do - 67
PIAdvCalcDat - 114 voltar no tempo - 29
PIAdvCalcExpDat - 116
PIAdvCalcExpFilDat - 117
PIAdvCalcExpFilVal - 112
PIAdvCalcExpVal - 111
PIAdvCalcFilDat - 115
PIAdvCalcFilVal - 110
PIAdvCalcVal - 109
PIAliasToTag - 123
PIArcVal - 96
PICalcDat - 113
PICalcVal - 107
PICompDat - 100
PICompFilDat - 101
PICurrVal - 95
PIExpDat - 104
PIExpVal - 97
PINCompDat - 98
PINCompFilDat - 99
PIPropertyValue - 124
PIPutVal - 125
PISampDat - 102
PISampFilDat - 103
PITagAtt - 122
PITimeDat - 105
PITimeExpDat - 106
PITimeFilter - 118
PITimeFilterVal - 119
planilha, células da
referências - 14, 15
132

PI Datalink 2010 User Guide PT

Enviado por

Dados do documento

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 2010 User Guide PT

Enviado por

Direitos autorais:

Formatos disponíveis

Guia do usuário do PI DataLink

OSIsoft Australia • Perth, Austrália

Copyright: © 1992-2010 OSIsoft, LLC. Todos os direitos reservados.

DIREITOS DO GOVERNO DOS E.U.A.

Capítulo 2 Noções básicas ...........................................................................................................7

Capítulo 3 Funções do PI............................................................................................................27

Capítulo 4 PI Tags e atributos ....................................................................................................43

Capítulo 5 Objetos do banco de dados do módulo .................................................................49

Capítulo 7 Exibições de tendência ............................................................................................59

Guia do usuário do PI DataLink iii

Especificar o intervalo de tempo ......................................................................................62

Anexo A Informações suplementares .......................................................................................75

Anexo B Referência de funções do PI DataLink ......................................................................95

Anexo C Suporte técnico e recursos.......................................................................................127

Duas edições do PI DataLink são instaladas no sistema:

Guia do usuário do PI DataLink 1

As diferenças entre os suplementos residem principalmente em alterações de design e

O PI SDK é instalado com o PI DataLink e conecta o PI DataLink ao PI server para recuperar

PI DataLink for Excel Services (DLES)

Suporte a idiomas do PI DataLink

Este release do PI DataLink fornece suporte a vários idiomas. A interface do usuário do

Guia do usuário do PI DataLink 3

Microsoft Excel 2007

Microsoft Excel XP-2003

Guia do usuário do PI DataLink 5

2. Se o suplemento PI DataLink não estiver listado, clique em Procurar para localizar o

Sobre este documento

A seção a seguir descreve as diferenças visuais e operacionais entre os suplementos PI

Guia do usuário do PI DataLink 7

PI DataLink for Excel 2007

Painéis de tarefas de funções

Observação: É possível desligar a exibição automática (página 22) de painéis de

Depois que um painel de tarefas de função estiver aberto:

Guia do usuário do PI DataLink 9

PI DataLink for Excel XP-2003

O PI DataLink for Excel XP-2003 usa uma configuração de menu padrão:

Caixas de diálogo de funções

O PI DataLink adiciona diversos comandos ao menu de contexto padrão do Microsoft Excel.

Observação: Os menus de contexto são os mesmos para ambas as versões de

Guia do usuário do PI DataLink 11

Para exibir um menu de contexto:

Para gerenciar configurações de conexão:

Componentes de função gráfica

Guia do usuário do PI DataLink 13

• Inserir texto diretamente em um campo de edição , como um nome

• Selecionar um item entre opções em uma lista , como um cálculo ou um método de

• Referenciar células de planilha que contêm argumentos, como um nome de tag,

Observação: Certifique-se de inserir strings em células que possam ser

• Selecione valores de um PI server ou outras fontes por meio de uma tag ou

Nome(s) de tag ou expressão

Guia do usuário do PI DataLink 15

• Alguns argumentos necessitam de um intervalo ou duração de tempo, representados por

Observação: O PI DataLink oferece suporte apenas ao sistema de datas 1900 padrão

Guia do usuário do PI DataLink 17

Array de dados acrescentados

Função/modo Célula de Coluna 2 Coluna 3 Coluna 4 Coluna 5

Observação: A tabela assume que todos os dados acrescentados sejam especificados

Mostrar carimbos de data e hora

Carimbos de data e hora de intervalo

Mostrar percentual válido

Guia do usuário do PI DataLink 19

Mostrar atributos do valor

Observação: Para funções que retornam um intervalo de valores, a orientação do array

Guia do usuário do PI DataLink 21