PI DataLink 2015 User Guide PT

PI DataLink 2015
Guia do usurio
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 USA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Site: http://www.osisoft.com
Guia do usurio do PI DataLink 2015

1992-2015 por OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicao pode ser reproduzida, armazenada em um sistema de recuperao ou
transmitida, em qualquer forma ou por quaisquer meios, sejam mecnicos, de fotocpia, registro ou
outro, sem a prvia autorizao por escrito da OSIsoft, LLC.
OSIsoft, o logotipo e o logo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset
Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI
BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI Web API,
PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts so
marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais usados neste documento
so de propriedade de seus respectivos proprietrios.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicao ou a divulgao pelo Governo dos EUA esto sujeitos s restries definidas no
contrato de licena da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR
12.212, FAR 52.227, conforme aplicvel. OSIsoft, LLC.
Verso: 5.2
Publicado em: 28 de maio de 2015
Contedo
Introduo............................................................................................................1
Viso geral do PI DataLink.........................................................................................................................1
PI DataLink Server (DLS).......................................................................................................................2
Sobre esta verso..................................................................................................................................... 2
Requisitos do PI System para o PI DataLink...........................................................................................2
Compatibilidade de atualizao............................................................................................................ 2
Tipos de dados suportados.................................................................................................................... 3
Instalao do PI DataLink.......................................................................................................................... 3
Instalar o PI DataLink............................................................................................................................ 4
Instalao silenciosa..............................................................................................................................4
Ver PI DataLink em um idioma com suporte..........................................................................................5
Preferncias de conexo para coletivos do PI Data Archive................................................................... 5
Configurao do PI Data Archive........................................................................................................... 5
Configurao de suplementos do Microsoft Excel..................................................................................... 6
Ver status do suplemento...................................................................................................................... 7
Habilitar um suplemento desabilitado................................................................................................... 7
Ativar um suplemento inativo................................................................................................................7
Recomendaes de segurana.................................................................................................................. 8
Segurana do arquivo do Excel..............................................................................................................8
Configurao de suplementos do Excel................................................................................................. 9
Privilgios da conta............................................................................................................................. 10
Prticas de segurana organizacional.................................................................................................. 10
Estratgias para registro......................................................................................................................11
Sobre este documento............................................................................................................................ 11
Fundamentos...................................................................................................... 13
Interface de usurio................................................................................................................................. 13
Guia PI DataLink.................................................................................................................................. 13
Painis de tarefas de funo................................................................................................................ 14
Menu de atalhos.................................................................................................................................. 15
Viso Geral das funes do PI DataLink................................................................................................... 15
Itens de dado.......................................................................................................................................16
Entrada de dados.................................................................................................................................17
Entradas de tempo.............................................................................................................................. 17
Dados anexados.................................................................................................................................. 18
Formatos de exibio.......................................................................................................................... 19
Valores interpolados........................................................................................................................... 19
Pesquisas................................................................................................................................................ 19
Pesquisar itens de dados..................................................................................................................... 20
Pesquisar ativos por filtro.................................................................................................................... 24
Gerenciar configuraes do PI DataLink..................................................................................................26
Limitaes da configurao de fuso horrio........................................................................................ 28
Gerenciar conexes com servidores........................................................................................................ 29
Criao de planilha.............................................................................................. 31
Processo de criao de planilhas..............................................................................................................31
Recuperao de grandes quantidades de dados...................................................................................... 32
Exibies relacionadas a ativos................................................................................................................32
Criar uma exibio relacionada a ativos............................................................................................... 33
Eventos na planilha................................................................................................................................. 35
Explorar eventos relacionado a um elemento...................................................................................... 37
Explorar eventos com eventos filho..................................................................................................... 39
Guia do usurio do PI DataLink 2015 iii

Contedo
Comparar eventos incluindo eventos filho........................................................................................... 41

Comparar eventos incluindo eventos pai............................................................................................. 47
Nomes reservados do atributo............................................................................................................ 49
Funes do PI DataLink........................................................................................51
Funo Valor atual...................................................................................................................................51
Exemplo de Valor atual....................................................................................................................... 52
Funo Valor de Archive.......................................................................................................................... 53
Exemplo de Valor de Archive............................................................................................................... 55
Funo Dados compactados....................................................................................................................55
Exemplo de Dados compactados.........................................................................................................58
Funo Dados de amostragem................................................................................................................58
Exemplo de Dados de amostragem..................................................................................................... 60
Funo Dados temporizados................................................................................................................... 61
Exemplo de Dados temporizados........................................................................................................ 62
Funo Dados calculados........................................................................................................................ 63
Exemplo de Dados calculados..............................................................................................................67
Funo Tempo Filtrado........................................................................................................................... 67
Exemplo de Tempo Filtrado................................................................................................................ 69
Funo Explorar eventos......................................................................................................................... 70
Referncia do painel de tarefas Explorar eventos.................................................................................70
Exemplo Explorar eventos................................................................................................................... 74
Funo Comparar eventos.......................................................................................................................74
Referncia do painel de tarefas Comparar eventos.............................................................................. 75
Notao de caminho para a funo Comparar eventos........................................................................ 79
Exemplo de Comparar eventos............................................................................................................79
Funo Pesquisa do Filtro de Ativos........................................................................................................ 80
Funo Propriedades.............................................................................................................................. 80
Exemplo de Propriedades....................................................................................................................81
Uso e manuteno da planilha..............................................................................83

Matrizes da funo.................................................................................................................................. 83
Tarefas comuns de matrizes da funo................................................................................................ 83
Atualizar as entradas para uma matriz da funo................................................................................ 84
Tamanho da matriz:............................................................................................................................ 85
Redimensionar matrizes......................................................................................................................85
Frequncia de clculo..............................................................................................................................86
Recurso Atualizao automtica......................................................................................................... 86
Reclculo por disparo.......................................................................................................................... 87
Recalcular manualmente.....................................................................................................................88
Compartilhamento de planilhas.............................................................................................................. 88
Configurar opo Clculo da pasta de trabalho para manual............................................................... 89
Tpicos avanados.............................................................................................. 91
PI time.................................................................................................................................................... 91
Abreviaturas do horrio PI................................................................................................................... 91
Expresses de tempo do PI..................................................................................................................92
Especificao de timestamp................................................................................................................92
Especificao de intervalo de tempo................................................................................................... 93
Expresses..............................................................................................................................................94
Usar expresses em funes do PI DataLink........................................................................................94
Sintaxe das expresses........................................................................................................................95
Restries para itens de dados em expresses.....................................................................................95
Exemplos de expresses......................................................................................................................95
Expresses de filtro............................................................................................................................. 96
Entrada manual de funes.....................................................................................................................96
Definir funes manualmente............................................................................................................. 96
iv Guia do usurio do PI DataLink 2015

Contedo
Orientaes para entrada manual de argumentos............................................................................... 97

Cdigos de sada................................................................................................................................. 97
Funes para gravar dados..................................................................................................................... 99
Funes Tag...................................................................................................... 101

Funo point ID para tag....................................................................................................................... 101
Exemplo de ID de ponto para tag.......................................................................................................102
Funo Mscara de atributo para tag.....................................................................................................102
Exemplo da Mscara de atributo para tag.......................................................................................... 103
Pesquisar PI Points................................................................................................................................ 103
Tendncias........................................................................................................105
Criar uma tendncia.............................................................................................................................. 105
Criar um trao com valores da planilha...............................................................................................107
Criar um trao de valores de ponto do PI recuperado do PI Data Archive............................................107
Menu de atalhos de Tendncias............................................................................................................ 108
Objetos do PI Module Database..........................................................................109

O PI Module Database e as planilhas..................................................................................................... 109
Inserir objetos do PI Module Database na planilha.................................................................................109
Funes Module Database.....................................................................................................................110
Funo Alias do tag............................................................................................................................111
Funo Propriedade para valor...........................................................................................................111
Notificaes...................................................................................................... 113
Pesquisar e inserir notificaes.............................................................................................................. 113
Adicionar um PI AF Server funo Pesquisa de notificaes............................................................ 114
Ajustar a exibio das notificaes recuperadas.................................................................................115
Gerenciar as notificaes recuperadas............................................................................................... 116
Notificaes inseridas............................................................................................................................116
Configuraes de exibio de notificaes.............................................................................................116
Referncia de funo......................................................................................... 119

Funes Valores nicos......................................................................................................................... 119
PICurrVal()......................................................................................................................................... 119
PIArcVal().......................................................................................................................................... 120
PIExpVal()..........................................................................................................................................121
PITagAtt()......................................................................................................................................... 122
Funes de valores mltiplos.................................................................................................................122
PINCompDat()................................................................................................................................... 123
PINCompFilDat()............................................................................................................................... 124
PICompDat()..................................................................................................................................... 125
PICompFilDat()..................................................................................................................................126
PISampDat()...................................................................................................................................... 127
PISampFilDat().................................................................................................................................. 128
PIExpDat()......................................................................................................................................... 129
PITimeDat()....................................................................................................................................... 130
PITimeExpDat()................................................................................................................................. 131
Funes Clculo.....................................................................................................................................132
PIAdvCalcVal()...................................................................................................................................132
PIAdvCalcFilVal()............................................................................................................................... 133
PIAdvCalcExpVal()............................................................................................................................. 135
PIAdvCalcExpFilVal()......................................................................................................................... 136
PIAdvCalcDat().................................................................................................................................. 138
PIAdvCalcFilDat().............................................................................................................................. 139
PIAdvCalcExpDat()............................................................................................................................ 141
Guia do usurio do PI DataLink 2015 v

Contedo
PIAdvCalcExpFilDat().........................................................................................................................143
PITimeFilter().................................................................................................................................... 145
PITimeFilterVal()............................................................................................................................... 146
Funes Tag..........................................................................................................................................146
PIPointIDToTag()...............................................................................................................................147
PIAttributeMaskToTag ()................................................................................................................... 147
Funes Module Database.................................................................................................................... 148
PIAliasToTag()...................................................................................................................................148
PIPropertyToValue()..........................................................................................................................149
Funes de entrada............................................................................................................................... 150
PIPutVal() e PIPutValX().....................................................................................................................150
Funes obsoletas................................................................................................................................. 151
Soluo de problemas........................................................................................ 153

Arquivos de log......................................................................................................................................153
Guia PI DataLink no disponvel.............................................................................................................153
Limites de matrizes e clulas................................................................................................................. 154
Limites de recuperao de dados.......................................................................................................... 154
Item de dados no suportado por funo...............................................................................................154
Duplicar eventos existentes...................................................................................................................154
Segurana............................................................................................................................................. 155
Problemas de conexo do PI Data Archive............................................................................................. 155
Habilitar um protocolo de autenticao............................................................................................. 156
Configurar um computador para permitir prompts de login explcitos............................................... 156
Insira as credenciais de login do Gerenciador de conexes................................................................. 157
Eliminar erro de exceo de tempo de execuo.................................................................................... 157
Dados no atualizam............................................................................................................................. 158
Suporte tcnico e outros recursos....................................................................... 159
vi Guia do usurio do PI DataLink 2015

Introduo
Bem-vindo ao PI DataLink! Esta seo fornece uma viso geral do PI DataLink, descreve as
caractersticas dessa verso e discute a sua instalao e configurao.
Nesta seo
Viso geral do PI DataLink
Sobre esta verso
Instalao do PI DataLink
Configurao de suplementos do Microsoft Excel
Recomendaes de segurana
Sobre este documento
Viso geral do PI DataLink

O PI DataLink um suplemento do Microsoft Excel que permite recuperar informaes do seu
PI Server diretamente para uma planilha. Em combinao com os recursos computacionais,
grficos e de formatao do Microsoft Excel, o PI DataLink oferece poderosas ferramentas para
coletar, monitorar, analisar e relatar dados do PI System.
Com o PI DataLink, possvel:
Recuperar valores de pontos de um servidor PI Data Archive
Recuperar valores de atributos de um PI Asset Framework (PI AF) Server
Recuperar metadados do sistema para criar uma viso estruturada de dados do PI System:
Nomes e atributos de pontos PI
Caminhos, apelidos e propriedades do PI Module Database
Atributos e elementos do PI AF
Referenciar esses itens usando funes do PI DataLink para calcular e filtrar dados
Atualizar os valores recuperados quando a planilha recalcular
Recuperar notificaes que voc subscreveu com PI Notifications
O PI DataLink fornece uma interface de usurio para ajudar voc a criar funes e recuperar
dados . O PI DataLink incorpora funes nas clulas da planilha e pode fornecer atualizaes
ativas de dados em tempo real do seu PI System.
Tambm possvel usar os recursos avanados de clculo e formatao do Excel para
organizar e apresentar dados do PI System de acordo com o propsito ou audincia.
Existem duas maneiras de trabalhar com funes PI DataLink em planilhas do Excel:
Instalar uma verso autnoma do PI DataLink em um computador local.
Usar um navegador da Web para visualizar a planilha com o PI DataLink Server (DLS), um
produto parte que permite a visualizao das planilhas criadas com o PI DataLink.
Entre em contato com o representante de vendas da OSIsoft para obter mais informaes.
Guia do usurio do PI DataLink 2015 1

Introduo
PI DataLink Server (DLS)

O PI DataLink Server uma verso de servidor do PI DataLink para uso com o Microsoft
SharePoint Server 2007 ou posterior. O PI DataLink Server suporta todas as funes DataLink
PI e PI BatchView fornecidas pelos suplementos Excel em uma configurao tpica do cliente PI.
Com o PI DataLink Server, voc pode usar um navegador da Web para recuperar e exibir dados
do PI Data Archive contidos em uma planilha do Microsoft Excel. Voc pode expandir o acesso a
dados em tempo real do PI System para vrios consumidores diferentes, independentemente
da localizao ou da familiaridade com o Microsoft Excel ou com funes PI DataLink.
Esta verso de servidor do PI DataLink usa tecnologias do Microsoft SharePoint, incluindo o
Excel Services e o web part Excel Web Access. Juntos, esses componentes da Microsoft
oferecem suporte maioria dos recursos padro de planilha. O PI DataLink Server expande
esses servios, acrescentando conectividade e suporte a funes PI DataLink.
As pastas de trabalho do Excel publicadas em bibliotecas de documentos do SharePoint podem
ser acessadas independentemente ou adicionadas a pginas de web part. O Excel Web Access
web part suporta conexes que permitem a troca de parmetros entre uma pasta de trabalho e
outras web parts, integrando planilhas com funes PI DataLink no ambiente PI WebParts.
Entre em contato com o representante de vendas OSIsoft para obter mais informaes sobre o
PI DataLink Server.
Sobre esta verso

Esta verso do PI DataLink instala um suplemento para o Microsoft Excel 2007 SP3 ou
posterior. Esse suplemento no pode ser executado em verses anteriores do Excel. Os tpicos
nesta seo descrevem os requisitos do sistema, a compatibilidade da atualizao com verses
anteriores e os tipos de dados suportados.
Nesta seo
Requisitos do PI System para o PI DataLink
Compatibilidade de atualizao
Tipos de dados suportados
Requisitos do PI System para o PI DataLink

Para requisitos do sistema atualizados, veja a pgina de Suporte Tcnico OSIsoft Requisitos de
sistema do PI DataLink (https://techsupport.osisoft.com/Products/PI-Visualization/PI-
DataLink/System-Requirements).
Compatibilidade de atualizao
O PI DataLink compatvel com verses anteriores. Essa verso do PI DataLink pode ler pastas
de trabalho criadas em verses mais antigas, sem qualquer converso. No entanto, o inverso
no necessariamente verdadeiro. Uma vez que voc modifique uma planilha na verso atual,
ela pode no funcionar em verses mais antigas do PI DataLink.
Essa verso do PI DataLink utiliza o PI AF SDK. O PI DataLink 2010 e verses anteriores
usaram o PI SDK ou o PI API. Diferentes comportamentos podem solicitar a alterao das
planilhas existentes criadas com o PI DataLink 2010 ou verses anteriores:
2 Guia do usurio do PI DataLink 2015

Introduo
Mensagens de erro retornadas podem ser diferentes. Voc pode precisar alterar planilhas
que procuram por determinados strings (por exemplo, em cdigo Excel VBA ou em macros).
O PI DataLink no cria conexes para o PI SDK ou PI API. Talvez seja necessrio alterar o
cdigo VBA em pastas de trabalho que dependam de uma conexo PI SDK ou PI API
existente, para criar uma nova conexo explcita a PI SDK ou PI API.
Alguns formatos de tempo, como 10:, no so mais suportados. Voc precisa mudar todas
as entradas de tempo que usam formatos no suportados.
Conexes de usurio padro com o PI Data Archive no so mais suportadas. Se for
solicitado, possvel digitar um nome de usurio e senha. No entanto, a OSIsoft recomenda
configurar o PI mapping para se conectar ao PI Data Archive.
A verso de 64 bits do PI DataLink no permite criar um objeto de tendncia ActiveX. A verso
de 64 bits apenas ir mostrar uma imagem da ltima tendncia em uma planilha existente, e
no ir atualizar essas tendncias.
Tipos de dados suportados

O PI DataLink suporta os seguintes tipos de dados do ponto do PI:
Digital (estados definidos)
Int (16 e 32)
Flutuao (16, 32 e 64)
String (texto)
Timestamp
O PI DataLink no suporta tipo blob.
O PI DataLink suporta os seguintes tipos de valor de atributo do PI AF:
Byte
Int (16, 32 e 64)
nico
Duplo
String*
Data e hora*
Booliano*
Enumerao*
*No suportado pela funo Dados calculados
PI DataLink no suporta o valor do atributo do PI AF do tipo Guid, Atributo, Elemento, Arquivo
ou Matriz.
Instalao do PI DataLink
Antes de usar o PI DataLink, deve-se instalar o PI DataLink usando um CD de distribuio ou
um kit de instalao baixado da OSIsoft. Se desejado, possvel usar uma instalao silenciosa.
Tambm possvel instalar o pacote de idiomas para habilitar o suporte para outros idiomas
alm do ingls. Alm disso, deve-se considerar a configurao do PI Data Archive e garantir que
haja acesso adequado aos pontos do PI.

Introduo
Nesta seo
Instalar o PI DataLink
Instalao silenciosa
Ver PI DataLink em um idioma com suporte
Preferncias de conexo para coletivos do PI Data Archive
Configurao do PI Data Archive
Instalar o PI DataLink
Inicie o programa de instalao para instalar o PI DataLink. Em sistemas operacionais de 64
bits, o programa de instalao instala automaticamente tanto a verso 32 bits quanto a 64 bits
do PI DataLink. possvel modificar o arquivo setup.ini para instalar apenas uma verso. Se
uma verso anterior do PI DataLink estiver instalada no computador, o programa de instalao
atualiza automaticamente a instalao e mantm as configuraes de preferncia das verses
anteriores.
Procedimento
1. Encontre o kit de instalao. Pode-se:
Baixar o kit na pgina de Downloads do Suporte Tcnico da OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/).
Inserir o CD de distribuio.
2. Extraia os arquivos para o computador.
3. Para instalar somente uma verso (32 bits ou 64 bits), modifique o arquivo setup.ini.
4. Execute o programa setup.exe. O programa de instalao instala o PI DataLink no
diretrio raiz PIPC, normalmente em:
C:\Program Files\PIPC\Excel
O programa instala o arquivo de ajuda on-line no diretrio de idioma adequado no
diretrio ../PIPC/Help. Baixe a verso PDF e as notas de verso na pgina de Downloads
do Suporte Tcnico da OSIsoft (https://techsupport.osisoft.com/Downloads/All-
Downloads/).
O que Fazer Depois
Para alterar as configuraes padro do PI DataLink, consulte o artigo da Base de

conhecimento da OSIsoft Como alterar as Configuraes padro do DataLink para todos os
usurios durante a instalao ou o upgrade (https://techsupport.osisoft.com/
Troubleshooting/KB/KB00951).
Para visualizar o PI DataLink em um idioma diferente do ingls, instale o pacote de idiomas
MUI do PI DataLink. Consulte Ver PI DataLink em um idioma com suporte.
Para usar as funes de tag, as funes do Module Database ou as tendncia ou para ativar o
suplemento do PI DataLink (Legacy). Consulte Configurao de suplementos do Microsoft
Excel.
Instalao silenciosa
Voc pode instalar este software com o recurso de instalao silenciosa do Windows. s vezes
chamada de instalao automtica, a instalao silenciosa no requer feedback durante o
processo de configurao. Administradores de sistemas com um aplicativo automatizado de

Introduo
distribuio de software pode usar a instalao silenciosa para implantar software

automaticamente para um grande nmero de desktops corporativos.
Para iniciar uma instalao silenciosa, digite:
Setup.exe f silent.ini
O arquivo silent.ini est includo no kit de instalao. possvel fazer alteraes especficas
do site no arquivo conforme necessrio. Consulte o arquivo silent.ini do PI SDK para obter
informaes adicionais e descries dos argumentos disponveis.
Ver PI DataLink em um idioma com suporte

PI DataLink tem suporte a vrios idiomas. Instale o pacote de idiomas PI DataLink MUI
(Multilingual User Interface) para ver a interface de usurio do PI DataLink no mesmo idioma
do Microsoft Excel. Se o PI DataLink no suporta um idioma, a interface de usurio do PI
DataLink aparecer em ingls.
Procedimento
1. Defina o idioma desejado no Microsoft Excel:
a. Instale o pacote de idiomas do Microsoft Office.
b. Use a ferramenta de configurao de idioma do Microsoft Office para alterar o idioma do
Microsoft Excel.
2. Baixe o pacote de idiomas MUI Do PI DataLink da pgina Downloads do Suporte Tcnico da
OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).
3. Instale o pacote de idiomas MUI do PI DataLink.
Preferncias de conexo para coletivos do PI Data Archive

Se o PI DataLink se conectar a um coletivo do PI Data Archive, o PI DataLink definir uma
preferncia de conexo na primeira conexo com o coletivo. A preferncia depende do
componente que inicia a conexo:
As funes do PI DataLink definem a preferncia como Any.
A pesquisa define a preferncia como Any.
O Connection Manager (acessado pela janela Configuraes) define a preferncia como
Prefer Primary.
Objetos de controle legados da tendncia definem a preferncia como Prefer Primary.
A funo Pesquisa da tag (acessada pelas funes de tag herdada) define as preferncias
como Prefer Primary.
O Gerenciador de conexes do PI (acessado pelo Pesquisa da tag) define a preferncia como
Prefer Primary.
Configurao do PI Data Archive

O PI DataLink pode recuperar dados de um servidor PI Data Archive 3.4.380 e posteriores. No
entanto, o PI DataLink deve ser capaz de se conectar ao servidor PI Data Archive correto, e os
usurios devem ter acesso apropriado aos pontos. Isso pode exigir alteraes de configurao
de:

Introduo
Banco de dados do firewall

O banco de dados do firewall em cada computador do PI Data Archive deve ser configurado
para permitir acesso dos computadores cliente que executam o PI DataLink.
Autenticao e autorizao
Os usurios do PI DataLink devem ter a capacidade de autenticar suas identidades usando o
PI Data Archive e possuir acesso ao PI Data Archive. Atribua usurios com o acesso menos
privilegiado, como permisses de somente leitura. Para fins de autenticao, a OSIsoft
recomenda a utilizao de PI mapping (disponvel no PI Data Archive verso 3.4.380 e
posteriores). Tambm possvel usar PI trusts ou autenticao por senha do PI. A OSIsoft
no recomenda autenticao de senha PI, porque esse mtodo menos seguro.
Definies de ponto
Os pontos devem ser definidos para dar aos usurios autorizados acesso de leitura e, se
necessrio, de escrita.
Para obter mais informaes, veja a documentao do PI Data Archive, incluindo o PI Data
Archive Security Configuration Guide. possvel visualizar esta documentao na PI Live
Library (https://livelibrary.osisoft.com) ou baix-la na pgina de Downloads do suporte
tcnico da OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/).
Configurao de suplementos do Microsoft Excel

O PI DataLink tem trs suplementos de aplicativo para o Microsoft Excel.
Nome Localizao Tipo
PI DataLink ..\PIPC\Excel\OSIsoft.PIDataLink.UI.vsto COM Add-in
PI DataLink ..\PIPC\Excel\OSIsoft.PIDataLink.UI(Legacy).vsto COM Add-in
(Legacy)
PI DataLink ..\PIPC\Excel COM Add-in
Notifications \OSIsoft.PIDataLink.Notifications2007.UI.vsto
Para usar todos os recursos do PI DataLink, esses suplementos de aplicao devem estar ativos.
O programa de instalao instala todos os suplementos e ativa o suplemento do DataLink PI.
Se o PI Notifications estiver instalado no computador, o programa de instalao tambm
ativar o suplemento do PI DataLink Notifications. Se no, ser necessrio ativar esse
suplemento depois de instalar o PI Notifications. Ao instalar o PI Notifications para fornecer
suporte ao complemento PI DataLink Notifications, o OSIsoft recomenda que voc s instale o
recurso do PI Notifications Client.
O programa de instalao no ativa o suplemento PI DataLink (Legacy). Voc deve ativar o
suplemento se voc quiser usar as funes de tags, objetos Module Database, ou tendncias.
Em casos raros, o Microsoft Excel pode desabilitar um suplemento. necessrio habilitar um
suplemento para poder ativ-lo.
Nota:
Para ativar um suplemento de aplicativo voc deve ter privilgios de administrador no
computador. Caso voc no tenha privilgios administrativos, clique com o boto direito
em Excel.exe no Windows Explorer e clique em Executar como administrador para
executar o Microsoft Excel como administrador.
Veja tambm...
Funes Tag
Objetos do PI Module Database

Introduo
Tendncias
Notificaes
Nesta seo
Ver status do suplemento
Habilitar um suplemento desabilitado
Ativar um suplemento inativo
Ver status do suplemento

Verifique o status de um suplemento para saber se ele est ativo, inativo ou desabilitado.
Procedimento
1. Clique na guia Arquivo e em Opes. (No Microsoft Excel 2007, clique no Boto do Microsoft
Office e em Opes do Excel.)
2. Na janela Opes do Excel, clique em Suplementos.
3. Pesquise na lista de suplementos para encontrar o status atual de um suplemento. Cada
suplemento estar listado em uma destas opes:
Suplementos Ativos de Aplicativo
Suplementos Inativos de Aplicativo
Suplementos Desabilitados de Aplicativo
Habilitar um suplemento desabilitado

Se um suplemento estiver desabilitado, habilite-o antes de ativ-lo.
Procedimento
3. Na lista Gerenciar, selecione Itens Desabilitados e clique em Ir.
4. Marque a caixa de seleo ao lado do suplemento.
5. Clique em Habilitar.
Ativar um suplemento inativo

Ative um suplemento inativo para disponibiliz-lo no Microsoft Excel.
Nota:
Para ativar um suplemento do aplicativo, necessrio ter privilgios de administrador no
computador. Se no tiver privilgios de administrador, clique com o boto direito do
mouse em Excel.exe no Windows Explorer e clique em Executar como administrador
para executar o Microsoft Excel como administrador.
Procedimento

Introduo
3. Na lista Gerenciar, selecione Suplementos de COM e clique em Ir.

4. Marque a caixa de seleo ao lado do suplemento.
5. Clique em OK.
Recomendaes de segurana
O PI System pode armazenar dados que diferenciam maisculas de minsculas que se deseja
proteger. A OSIsoft cria seus produtos para minimizar o risco de acesso no autorizado. Os
tpicos nesta seo descrevem as prticas recomendadas para maximizar a segurana de dados
ao trabalhar com o PI DataLink.
Nesta seo
Segurana do arquivo do Excel
Configurao de suplementos do Excel
Privilgios da conta
Prticas de segurana organizacional
Estratgias para registro
Segurana do arquivo do Excel

As planilhas do Excel podem conter dados confidenciais que devem ser protegidos quando as
planilhas estiverem localizadas em um computador cliente. A segurana subjacente fornecida
pelo PI System no aplicvel aps a recuperao das informaes em uma planilha. Portanto,
a OSIsoft recomenda proteger cada arquivo da planilha. Voc pode:
Proteger os arquivos da planilha do Excel com senhas. As senhas permitiro apenas que
usurios autorizados vejam ou modifiquem os dados na planilha. Para obter mais
informaes, veja o artigo do Microsoft Office Proteger com senha elementos de uma
planilha ou pasta de trabalho (https://support.office.com/en-US/article/password-protect-
worksheet-or-workbook-elements-dbf706e0-ba22-4a08-84d8-552db16eef11).
Usar as prticas mais seguras para configuras as senhas da planilha:
Configure uma senha para abrir a planilha e uma senha para modificar a planilha.
Use uma combinao de letras maisculas e minsculas, nmeros e smbolos na senha.
Marque a caixa de seleo Criptografar as propriedades do documento para evitar que
usurios no autorizados vejam o resumo e personalizem as propriedades do arquivo da
planilha.
Ativar o Gerenciamento de direitos de informaes (IRM) nas planilhas do Excel. O IRM
permite que usurios e administradores especifiquem as permisses de acesso planilha,
que podem ajudar a impedir que pessoas no autorizadas imprimam, encaminhem ou
copiem dados confidenciais do PI System. Depois de restringir as permisses de um arquivo
usando IRM, as restries de acesso e uso sero aplicadas independentemente da
localizao das informaes, pois a permisso de acesso armazenada no prprio arquivo.
Para obter mais informaes, veja o artigo do Microsoft Office Gerenciamento de direitos de
informao no Office 2010 (http://office.microsoft.com/en-us/excel-help/information-
rights-management-in-office-2010-HA010354260.aspx). Se necessrio, possvel definir
uma data de validade para os dados no arquivo do Excel. No artigo do Microsoft Office, veja
o procedimento Definir uma data de expirao para um arquivo (http://
office.microsoft.com/en-us/excel-help/information-rights-management-in-office-2010-
HA010354260.aspx#BMexpire).

Introduo
Usar a criptografia Internet Protocol Security (IPSec) no link entre os computadores que
hospedam o PI DataLink e os armazenamentos de arquivo contendo as planilhas do Excel se
estas estiverem armazenadas em unidades remotas. Para obter mais informaes, veja o
artigo da Microsoft TechNet IPSec (https://technet.microsoft.com/en-us/library/
bb531150.aspx).
Aplicar permisses de arquivo seguro nas planilhas do Excel para garantir que usurios no
autorizados no tenham acesso ao contedo dos arquivos. Para obter mais informaes,
veja o artigo da Microsoft TechNet Permisses para arquivos e pastas (http://
technet.microsoft.com/en-us/library/bb727008.aspx).
Aplicar uma assinatura digital na planilha do Excel. Para obter mais informaes, veja o
artigo do Suporte da Microsoft Descrio de assinaturas digitais e assinatura de cdigo nas
planilhas do Excel (http://support.microsoft.com/kb/820738).
Configurao de suplementos do Excel

possvel usar a Central de Confiabilidade do Excel para controlar o comportamento dos
suplementos. Para evitar que software no autorizado aja nas planilhas do Microsoft Excel, a
OSIsoft recomenda solicitar que os suplementos sejam assinados por publicadores confiveis.
Especificamente, na Central de Confiabilidade, use a pgina Suplementos para:
Solicitar que os suplementos do aplicativo sejam assinados por publicadores confiveis.
Desativar as notificaes de suplementos no assinados.
Se o PI DataLink for instalado fora do diretrio C:\Program Files padro e os suplementos
precisarem ser assinados por publicadores confiveis, ser necessrio adicionar manualmente
o certificado do PI DataLink no armazenamento dos certificados confiveis. Veja Adicionar o
certificado do PI DataLink para armazenar certificados confiveis.
Para obter mais informaes, veja o artigo do Microsoft Office Exibir, gerenciar e instalar
suplementos nos programas do Office. (http://office.microsoft.com/en-us/excel-help/view-
manage-and-install-add-ins-in-office-programs-HA010354315.aspx)
Adicionar o certificado do PI DataLink para armazenar certificados

confiveis
Se o Microsoft Excel for configurado para solicitar que os suplementos sejam assinados por um
publicador confivel, e o PI DataLink for instalado fora do diretrio C:\Program Files
padro, ser necessrio adicionar manualmente o certificado do PI DataLink no
armazenamento dos certificados confiveis.
Procedimento
1. Abra uma janela de comando como administrador.
2. No prompt de comando, navegue at o diretrio contendo o certificado do PI DataLink
(pidlcert.cer).
O certificado tambm pode ser encontrado na subpasta Excel da pasta de instalao
(definida pela varivel de ambiente PIHOME).
3. Insira o seguinte comando:
C:\Windows\System32\certutil.exe -addstore TrustedPublisher
pidlcert.cer

Introduo
Privilgios da conta
Para evitar danos causados por usurios mal-intencionados, atribua aos usurios os acesso
menos privilegiado, por exemplo, permisses de somente leitura.
Prticas de segurana organizacional

Para evitar que invasores acessem o sistema, a OSIsoft recomenda que a organizao adote
estas prticas de segurana:
Proteja fisicamente os computadores. Caso um invasor acesse um computador que execute
o PI DataLink, ele pode acessar todos os dados do PI System recuperados e armazenados em
arquivos do Excel naquele computador.
Restrinja o acesso ao computador para funcionrios e usurios convidados autorizados. Os
procedimentos devem evitar que computadores perdidos ou roubados acessem a rede da
companhia.
Aplique as atualizaes de segurana mais recentes a todos os computadores. Assine o
servio de Notificao de segurana para manter-se informado sobre as novas atualizaes
de segurana para os sistemas operacionais e outros computadores. Para obter mais
informaes, veja o artigo do Security TechCenter Notificaes de segurana tcnica da
Microsoft (http://technet.microsoft.com/en-us/security/dd252948).
Proteja os computadores contra administradores no autorizados. Administradores no
autorizados podem iniciar inmeros ataques. Por exemplo, eles podem:
Instalar e executar software mal-intencionado.
Configurar acesso remoto para controlar remotamente um computador.
Audite todas as atividades administrativas e revise periodicamente os logs de auditoria.
Como pr-requisito para contratao de administradores, exija uma certido de
antecedentes criminais e solicite que ela esteja sempre atualizada.
Fornece vrias camadas de segurana. Confiar apenas na segurana do permetro, como
firewall, aumenta o risco de comprometimento do firewall. Pode-se fornecer outra camada
de defesa criando a rede para separar os clientes menos seguros dos mais seguros. Firewall
pessoais nos computadores cliente adicionam outra camada. Melhore ainda mais a
segurana com o software de deteco de invasores e com o software de deteco de
invasores baseados em host que ajuda a filtrar atividade suspeita. A execuo do antivrus
muito importante. Por fim, conscientize os usurios quanto ao fato de que a segurana dos
computadores uma parte fundamental de uma estratgia de segurana de rede.
Crie e mantenha linhas de base de segurana para todos os sistemas. Especifique cada linha
de base com uma descrio detalhada de como configurar e administrar o computador. A
descrio deve incluir todos os ajustes de configurao relevantes para um computador de
segurana. Para criar uma linha de base segura, use o sistema operacional mais seguro.
mais provvel que os sistemas operacionais mais recente sejam designados com a
segurana em mente e contenham recursos que tornem o sistema operacional seguro.
Mantenha o sistema operacional e os aplicativos atualizados instalando atualizaes de
segurana assim que elas forem disponibilizadas.
Use senhas fortes. Nunca use senhas em branco. Para obter mais informaes sobre os
conceitos de senha, veja o artigo da Microsoft TechNet Polticas de conta (https://
technet.microsoft.com/en-us/library/dd349793(v=ws.10).aspx).
Controle o acesso aos arquivos do Excel do PI DataLink. Implemente os procedimentos de
segurana para garantir que todos os arquivos do Excel estejam armazenados de forma

Introduo
segura e que os invasores no possam modificar o contedo dos arquivos nem buscar
informaes no arquivo.
Estratgias para registro

As organizaes precisam desenvolver uma estratgia apropriada para o registro em log.
Podem-se usar os arquivos de log para:
Fazer o rastreamento. necessrio usar os arquivos de log para fornecer dados estatsticos
sobre transaes.
Fazer a verificao. Os arquivos de log podem ser usados para fornecer o registro completo
das transaes para recriar as transaes.
Fornecer a validade de uma transao.
O PI DataLink envia todas as solicitaes de dados por meio do PI AF SDK. Apesar de o PI
DataLink no manter arquivos de log separados, possvel usar os arquivos de log do PI AF
SDK e do PI Data Archive para obter informaes sobre as transaes do PI DataLink. Veja a
documentao do PI AF SDK e do PI Data Archive para obter mais informaes.
Sobre este documento

O PI DataLink User Guide fornece uma descrio detalhada das caractersticas do produto e
uma referncia completa para as funes do PI DataLink. O contedo das verses PDF e Help
do guia idntico.
Este documento presume que voc tenha conhecimento sobre os conceitos do PI System. Veja o
PI Data Archive e a documentao PI AF para obter mais informaes sobre esses produtos.
Conhecer o PI Data Archive e o PI AF vai ajudar no entendimento dos termos usados no PI
DataLink.
Voc tambm poder achar til os materiais de treinamento. Eles incluem os exerccios que a
OSIsoft usa em cursos de treinamento no PI DataLink.
Baixe o material de treinamento e a documentao de outros produtos da OSIsoft na pgina de
downloads do Suporte Tcnico da OSIsoft. (https://techsupport.osisoft.com/Downloads/All-
Downloads/) Tambm possvel visualizar a documentao na Biblioteca ativa do PI (https://
livelibrary.osisoft.com).
Alteraes na terminologia
A OSIsoft est revisando sua terminologia para refletir o crescimento do PI System em relao
a sua arquitetura original de servidor nico. Na terminologia revisada, PI Data Archive refere-
se ao componente que armazena os dados de sries cronolgicas (anteriormente chamado de
PI Server), e PI Server refere-se ao PI Data Archive e ao PI Asset Framework. Este documento
usa a terminologia revisada.

Introduo

Fundamentos
Ao usar o PI DataLink, as funes do PI DataLink que extraem dados do PI System em matrizes
de funo em uma planilha do Excel so usadas. Uma matriz da funo um conjunto de clulas
contendo a sada de uma nica funo do PI DataLink. As sees seguintes apresentam
caractersticas e conceitos bsicos do PI DataLink. Familiarize-se com estas sees antes de
usar o PI DataLink para criar uma planilha e recuperar dados do PI System.
Essas sees descrevem:
Recursos de interface do usurio
Recursos principais para trabalhar com o PI DataLink
Diferentes abordagens para criar uma planilha do PI DataLink, dependendo dos objetivos,
das necessidades e dos recursos.
Nesta seo
Interface de usurio
Viso Geral das funes do PI DataLink
Pesquisas
Gerenciar configuraes do PI DataLink
Gerenciar conexes com servidores
Interface de usurio
O PI DataLink adiciona comandos de menu especficos, janelas e painis de tarefas ao Microsoft
Excel.
As sees seguintes descrevem os elementos principais da interface do PI DataLink.
Nesta seo
Guia PI DataLink
Painis de tarefas de funo
Menu de atalhos
Guia PI DataLink
O PI DataLink insere a guia PI DataLink na faixa de opes do Microsoft Excel.
Clique na guia PI DataLink para acessar os comandos do PI DataLink.

Clique em um comando para abrir o painel de tarefas ou janela correspondente.
Coloque o cursor sobre um comando para exibir uma dica descritiva da ferramenta.

Fundamentos

Utilize os painis de tarefas de funo para definir funes do PI DataLink.
Um painel de tarefas um painel de controles que pode ser movido e encaixado. Ser possvel
continuar a trabalhar em uma planilha enquanto um painel de tarefas estiver aberto.
Para abrir um painel de tarefas de funo:
Clique na clula de sada desejada e clique em um comando da funo na guia PI DataLink
para adicionar uma funo.
Clique em uma clula em uma matriz da funo existente para abrir o painel de tarefas
correspondente e editar as entradas da funo.
Nota:
Se preferir, desative a exibio automtica dos painis de tarefas. Consulte Gerenciar
configuraes do PI DataLink.
Clique com o boto direito do mouse em uma clula de matriz da funo e clique no nome da
funo para abrir manualmente o painel de tarefas.
Em um painel de tarefas de funo aberto:
Insira ou altere os valores de entrada e ento:
Clique em OK para salvar os valores de entrada, gravar a matriz da funo resultante e
fechar o painel de tarefas.
Clique em Aplicar para salvar os valores de entrada e gravar a matriz da funo
resultante sem fechar o painel de tarefas.
Clique no boto de seta para selecionar os comandos Mover, Tamanho ou Fechar.
Arraste a barra de ttulo para desencaixar o painel de tarefas.
Clique duas vezes na barra de ttulo para encaixar o painel de tarefas.
Coloque o cursor na borda e arraste para redimensionar o painel.

Fundamentos
Menu de atalhos
O PI DataLink adiciona vrios comandos ao menu de atalhos padro do Microsoft Excel. Voc
pode usar esses comandos para gerenciar matrizes de funo em uma planilha.
Para abrir o menu de atalhos com os comandos do PI DataLink, clique com o boto direito do
mouse em qualquer lugar em uma matriz da funo do PI DataLink.
PI DataLink adiciona os seguintes comandos ao menu de atalhos:
Selecionar Funo DataLink
Seleciona a matriz de funes inteira.
Antes de copiar, cortar ou colar uma matriz para um novo local na planilha, deve-se
selecionar a matriz inteira.
Recalcular (Redimensionar) funo
Reescreva toda a matriz da funo: o PI DataLink recupera novos valores do PI Data Archive
ou PI AF e automaticamente redimensiona a matriz para conter os dados retornados.
Nome da Funo
Abre o painel de tarefas de funo correspondente e mostra as entradas para a matriz de
funo.
Tendncias apresenta um menu de atalho alternativo.
Veja tambm...
Menu de atalhos de Tendncias

As funes do PI DataLink extraem dados do PI System para o Excel. Pode-se usar um painel de
tarefas de funo para inserir facilmente as entradas que definem a funo. Como alternativa,
na medida em que se torna mais experiente, o usurio pode digitar uma funo diretamente na
barra de frmulas do Excel.
As seguintes sees descrevem:
Recursos comuns nos painis de tarefas das funes do PI DataLink
Como dados em tempo real so adquiridos e apresentados
Como as funes do PI DataLink so usadas em uma planilha
Veja tambm
Entrada manual de funes
Nesta seo
Itens de dado
Entrada de dados
Entradas de tempo
Dados anexados
Formatos de exibio

Fundamentos
Valores interpolados
Itens de dado
As funes PI DataLink retornam dados a respeito de itens de dados especficos do PI System,
sejam eles pontos do PI ou atributos PI AF. As funes podem retornar valores registrados em
um banco de dados ou valores calculados com base em critrios ou expresses especificadas.
Ao definir uma funo, especifique os caminhos para itens de dado com os campos Item de
dado, Expresso e Expresso de filtro junto com o campo Caminho raiz opcional. possvel
especificar:
Caminhos totalmente qualificados nos campos Item de dado, Expresso ou Expresso de
filtro. Um caminho totalmente qualificado comea com duas barras invertidas (\\) e
representa um ponto do PI ou um atributo do PI AF.
Caminhos parciais nos campos Item de dado, Expresso ou Expresso de filtro e o caminho
base comum no campo Caminho raiz. Nomes de ponto do PI ou atributos do PI AF so
exemplos de caminhos parciais. O PI DataLink combina o caminho base comum com o
caminho parcial para definir o caminho completo que representa um ponto do PI ou
atributo do PI AF.
O PI DataLink requer um caminho completo para localizar o item de dados. Para localizar um
ponto do PI, o PI DataLink deve conhecer o servidor PI Data Archive a ser pesquisado e o nome
do ponto. Para localizar um atributo do PI AF, o PI DataLink deve conhecer o PI AF Server, o
banco de dados, o elemento e quaisquer subelementos ou atributos pai. Use um pipe (|) para
separar os atributos dos elementos ou atributos-pai.
Voc pode deixar o campo Caminho raiz em branco se os campos Item de dado, Expresso e
Expresso de filtro contiverem um caminho totalmente qualificado ou um ponto do PI no
servidor PI Data Archive padro.
Se especificado, o campo Caminho raiz indica o caminho comum para os itens de dado
especificados.
Tipo de item de dados Contedo do campo caminho raiz
Ponto do PI Servidor PI Data Archive que armazena o ponto ou um espao em branco
para indicar o servidor PI Data Archive padro. As entradas vlidas incluem:
MyPIDataArchiveServer
\\MyPIDataArchiveServer
Atributo do PI AF O PI AF Server e o banco de dados, juntamente com quaisquer elementos,
subelementos e atributos pai no especificados em Item de dado. As entradas
vlidas incluem:
\\MyPIAFServer\MyDatabase
\\MyPIAFServer\MyDatabase\MyElement
\\MyPIAFServer\MyDatabase\MyElement\MySubElement
\\MyPIAFServer\MyDatabase\MyElement|MyParentAttribute
\\MyPIAFServer\MyDatabase\MyElement|MyParentAttribute1|
MyParentAttribute2
Nota:
O PI AF Server e o banco de dados devem estar no mesmo campo. Voc
no pode especificar o PI AF Server no campo Caminho raiz e o banco
de dados no campo Item de dado.
Veja tambm...
Expresses

Fundamentos
Entrada de dados
Entradas rotuladas nos painis de tarefas da funo aceitam valores apropriados para a funo.
Para vrias entradas, possvel inserir um valor ou uma referncia em uma clula da planilha
contendo o valor. Algumas entradas tm um valor padro mostrado quando o painel de tarefas
aberto. Entradas marcadas como (opcional) so opcionais e no exigem um valor.
Para entradas com campos de edio , voc pode:
Digitar o texto diretamente no campo de edio, como um nome de atributo do PI AF ou o

endereo de uma clula de sada.
Clicar no campo de edio e depois em uma clula ou intervalo de clulas da planilha que
contenha os valores apropriados, tais como nomes de atributo do PI AF, timestamps ou
localizaes de clulas de sada.
Clicar no campo de edio para abrir uma lista dos valores vlidos a serem selecionados
(apenas disponvel nos campos Caminho raiz e Banco de dados).
Clicar em para abrir a ferramenta Pesquisar e selecionar os itens de dado encontrados
em uma pesquisa a um servidor PI Data Archive ou PI AF Server conectado.
Para entradas com listas , voc pode:
Selecionar uma opo na lista, como um mtodo de clculo ou de amostragem.
Clicar em e depois em uma clula ou intervalo que contenha os valores apropriados,
como um modo, unidade de tempo, tipo de limite ou propriedade.
Nota:
Nos campos de edio, digite strings sem quaisquer aspas. No entanto, em clulas da
planilha, digite strings com uma aspa simples (') para forar o Excel a interpretar o
contedo como um string.
Por exemplo, para especificar um ponto do PI nos Item(ns) de dado(s), possvel:
Digitar o string para o nome do ponto.
Clicar em para abrir a ferramenta Pesquisar e pesquisar por um ponto no servidor PI
Data Archive.
Entrar uma referncia a uma clula de planilha que contenha o nome do ponto:
a. Clique no campo Item(ns) de dado(s).
b. Clique na clula na planilha.
O PI DataLink insere automaticamente a referncia da clula no campo de edio.
Entradas de tempo
Muitas funes do PI DataLink requerem entradas de Hora inicial e Hora final para recuperar
uma matriz de valores de eventos ao longo de um perodo especfico. Outras funes do PI
DataLink requerem uma entrada de Timestamp para recuperar valores em um horrio
especfico. Siga essas orientaes ao especificar as entradas de tempo:
Insira um tempo determinado, tal como 10-dez-99 19:12, ou uma expresso de tempo do
PI que especifica um tempo relativo, como -3h. Por exemplo, pode-se inserir um tempo fixo

Fundamentos
para definir um perodo no passado ou digitar uma expresso de tempo relativo para definir
um perodo que inclui o tempo atual.
Se a hora de incio mais recente que o tempo final, o PI DataLink exibe os resultados em
ordem cronolgica inversa.
Preceda expresses de tempo entradas em clulas de planilha com uma aspas simples para
indicar uma string (por exemplo, '10-dez-99 19:12 ou '-3h).
Referncias de clula tambm podem usar o formato de tempo absoluto do Excel (como
39299,6146, equivalente a 05/08/2007 14:45:00). O Excel armazena timestamps nesse
formato, que representa o nmero cumulativo de dias desde 1900. Excel pode exibir o
mesmo timestamp usando qualquer formato de data e hora atribudo clula.
Algumas entradas de tempo, como 9:45, podem representar um horrio vlido ou um
intervalo vlido de linhas da planilha. Em um campo do painel de tarefas, preceda essas
entradas com uma aspa simples, como '9:45, para forar o PI DataLink a interpret-las
como hora.
Algumas funes do PI DataLink requerem uma entrada de Intervalo de tempo, que
especificado com um nico valor:
Insira um valor e uma unidade de tempo, como 1d ou 30m; nunca inclua um tempo de
referncia. Por exemplo, para especificar um intervalo de 32 minutos, digite 32m ou
referencie uma clula que contenha essa string.
Para inserir intervalos em termos de frequncia, converta a frequncia em segundos
equivalentes. Por exemplo, insira uma frequncia de 25 Hz como um intervalo de 0,04 s (=
1/25 de segundo).
Nota:
O PI DataLink suporta apenas o sistema de data 1900 padro suportado pelo Excel. O PI
DataLink no suporta o sistema de data 1904 do Excel e retorna data e hora incorretos se
este sistema for usado.
Veja tambmm
Especificao de timestamp
Especificao de intervalo de tempo
Dados anexados
PI DataLink pode anexar informaes sobre os valores recuperados. Esses dados anexados
podem fornecer o contexto para valores recuperados. Dados anexados podem incluir:
Timestamps que mostram quando os valores foram gravados
Timestamps que mostram a hora de incio e o tempo final de um intervalo
Timestamps que mostram quando os valores mximo e mnimo ocorreram
A porcentagem de valores bons em um intervalo de amostra
Atributos do valor
Anotaes inseridas manualmente
Nomes do servidor de origem
O PI DataLink exibe os dados anexados nas colunas (ou linhas) ao lado dos valores primrios
retornados pela funo:

Fundamentos
Os dados de tempo so apresentados nas colunas esquerda (ou linhas acima) dos valores
primrios.
Outros dados relacionados so exibidos em colunas direita (ou linhas abaixo) dos valores
primrios.
Formatos de exibio
Use a janela Configuraes para especificar os formatos de tempo e nmero usados pelo PI
DataLink para formatar os dados nas matrizes da funo. Existem duas configuraes:
Formato de nmero
O formato para nmeros na sada da funo. A configurao padro, General, formata
nmeros (e todos os dados no timestamp) para corresponder formatao da categoria
Geral na janela Formatar Clulas do Excel.
Formato de hora
O formato para horrios na sada da funo. A configurao padro, dd-mmm-yy hh:mm:ss,
corresponde ao formato do timestamp do PI padro. possvel adicionar .000 no final da
string (dd-mmm-yy hh:mm:ss.000) para exibir os timestamps de subsegundos. Observe
que o Excel no suporta formatos de preciso de microssegundo.
Essas strings de formato podem ser personalizadas usando quaisquer cdigos vlidos de
formato do Excel na janela Formatar Clulas do Excel.
Para obter detalhes sobre a janela Configuraes, veja Gerenciar configuraes do PI DataLink.
Tambm possvel aplicar formataes de data e hora individuais a qualquer clula na
planilha, inclusive quelas contendo funes do PI DataLink, com a janela Formatar clulas. Veja
a documentao do Excel para obter informaes adicionais sobre formatao de datas e horas.
Muitas funes do PI DataLink podem retornar valores interpolados, teis para pontos do PI
associados a timestamps. Por exemplo, possvel solicitar que a funo Valor de Archive
retorne um valor interpolado em um timestamp especfico em vez de o ltimo valor registrado
que precede o timestamp. O valor interpolado depende dos timestamps dos valores registrados
e, possivelmente, do tipo do ponto do PI:
Para timestamps anteriores ao primeiro valor retornado, a funo retorna Pt Created ou
No Data.
Para timestamps entre dois valores registrados, a funo determina o valor no timestamp
usando interpolao linear entre os valores registrados. Para pontos que armazenam
valores discretos, como pontos de estado digital ou pontos de etapa, a funo retorna o
ltimo valor retornado que precede o timestamp.
Para timestamps aps o ltimo valor retornado, o valor depende do tipo de ponto:
Para PI Point histricos, a funo retorna o valor mais recente.
Para PI Point futuros, a funo retorna No Data.
Pesquisas
O PI DataLink oferece duas formas para pesquisar itens de dado:

Fundamentos
Ferramenta Pesquisa
Com a ferramenta Pesquisa, possvel encontrar pontos do PI ou atributos do PI AF
pesquisando textos correspondentes ou explorando um banco de dados do PI AF ou PI Data
Archive. Dependendo de como a ferramenta aberta, ela insere os pontos ou atributos
encontrados na planilha ou no painel de tarefas da funo.
Funo Pesquisa do Filtro de Ativos

Com a funo Pesquisa do Filtro de Ativos, possvel encontrar os elementos do PI AF que
correspondam aos critrios e filtr-los com base nos valores do atributo. A funo pode
retornar os elementos filtrados ou os atributos selecionados dos elementos filtrados. A
funo pode colar os ativos filtrados na planilha como valores ou matriz da funo.
Nesta seo
Pesquisar itens de dados
Pesquisar ativos por filtro

Use a ferramenta Pesquisar para pesquisar itens de dado em qualquer servidor PI Data Archive
ou PI AF Server especificado. possvel inserir itens de dado na planilha e referenciar esses
itens de dado em funes PI DataLink. Tambm possvel inserir um item de dado diretamente
em um painel de tarefas da funo.
Antes de Iniciar
Conecte a qualquer servidor PI Data Archive ou PI AF Server que desejar pesquisar. Veja
Gerenciar conexes com servidores.
Procedimento
1. Abra a ferramenta Pesquisar:
Para inserir um ou mais itens em uma planilha, selecione a clula superior esquerda do
intervalo na planilha na qual se inserir os itens de dado e, na guia PI DataLink, no grupo
Pesquisar, clique em Pesquisar.
Para inserir um ou mais itens em um painel de tarefas da funo, clique no boto ao
lado do campo Item(ns) de dado(s).
2. Defina o escopo da pesquisa, mostrado no caminho no alto.
Antes do primeiro uso, a ferramenta inicia na mquina servidora, que mostra todos os
servidores PI Data Archive (indicado por ) e os PI AF Servers (indicado por ) listados
no Gerenciador de conexes. possvel limitar a pesquisa a um nico PI Data Archive ou PI
AF Server e mais ainda, a um nico banco de dados em um PI AF Server e a elementos e
atributos pai especficos.
Nos usos subsequentes, a ferramenta inicia cada sesso com o escopo da pesquisa definido
como o ltimo servidor PI Data Archive, PI AF Server ou banco de dados do PI AF
pesquisado.
Voc pode:
Usar o painel de navegao para limitar a pesquisa
Usar o caminho de escopo para limitar a pesquisa
Se definir o escopo da pesquisa para um elemento ou atributo, o painel de resultados listar
os atributos-filho imediatamente abaixo desse elemento ou atributo.
3. Conforme necessrio, procure itens de dados no escopo para listar no painel de resultados.

Fundamentos
a. No campo na parte superior da ferramenta, digite o texto que identifica os itens de dado
que se deseja encontrar no escopo selecionado.
Caracteres curinga podem ser usado para ampliar a pesquisa. Por exemplo:
Digite sinusoid para localizar todos os itens de dado com o nome sinusoid.
Digite sinusoid* para localizar quaisquer itens de dado que comeam com
sinusoid, como sinusoid ou sinusoidu.
Digite *u para localizar quaisquer itens de dado que terminam com u, como
sinusoidu.
Digite * para localizar todos os itens de dado.
b. Se o escopo da pesquisa um servidor PI Data Archive, defina os campos abaixo de
Filtros para especificar quaisquer critrios adicionais aos quais os pontos do PI
recuperados devem corresponder:
O painel contm seis listas com atributos comuns das point classes base e clssica,
incluindo o atributo future. Selecione um atributo do ponto na lista e insira o texto no
campo correspondente para encontrar pontos do PI que correspondem entrada.
Podem-se inserir caracteres curingas; a pesquisa no adiciona caracteres curinga
implcitos. Com a lista final, possvel filtrar com base no tipo do ponto e selecionar o
tipo de valor armazenado que se deseja encontrar.
Por exemplo, selecione Descritor e insira *vapor* para retornar apenas pontos do PI
contendo a palavra vapor em qualquer lugar no atributo da tag descriptor.
Veja a documentao do PI Data Archive para obter mais informaes sobre os atributos
do ponto do PI.
c. Clique em Pesquisar para iniciar a busca.
A ferramenta procura dentro do escopo especificado por itens de dados que

correspondam ao texto digitado e retorna os itens de dados encontrados no painel de
resultados. A ferramenta pesquisa toda a hierarquia abaixo do escopo da pesquisa. (Em
contraste, ao navegar na hierarquia, o painel de resultados mostrar apenas os atributos
filho imediatos ao escopo da pesquisa.) A ferramenta encontra:
Pontos do PI com nomes ou descritores correspondentes.
Atributos do PI AF com nomes ou descritores correspondentes.
Os atributos do PI AF com descries que correspondem (se voc estiver utilizando o
PI AF Server 2015 ou posterior)
Atributos do PI AF com elementos pai com nomes ou descries correspondentes.
Nota:
Pesquisas do PI Data Archive no retornam mais que 100.000 pontos do PI. Para ter
certeza de que voc v todos os resultados, restrinja sua pesquisa para retornar
menos pontos do PI.
4. Se desejar, altere as colunas exibidas no painel de resultados:
Clique com o boto direito do mouse no painel de resultados e clique em um nome de
coluna para adicion-la ou retir-la das colunas exibidas.
Arraste os cabealhos de coluna para alterar a ordem de exibio das colunas.
5. Se desejar, mova o controle deslizante Comprimento do item de dado para dividir o
caminho do item de dado entre as colunas Caminho raiz e Item de dado:

Fundamentos
Selecione Caminho completo para especificar um caminho completo na coluna Item de

dado.
Selecione Somente nome para especificar apenas o nome do atributo ou ponto na coluna
Item de dado, com o resto do caminho na coluna Caminho raiz.
Selecione posies intermedirias para dividir de outras formas o contedo entre as
colunas.
O contedo dessas colunas determina o contedo adicionado aos campos do painel de
tarefas ou s colunas da planilha.
6. Ao inserir atributos PI AF na planilha e dividir o contedo item-dado, especifique como
inserir o contedo do Caminho raiz na planilha:
Selecione Lista suspensa para inserir uma lista suspensa de caminhos (da coluna
Caminho raiz), seguido pelos elementos de dados (da coluna Item de dado) nas clulas da
planilha designadas.
Se referenciar a lista suspensa e os itens de dado inseridos em uma funo DataLink PI, a
planilha atualizar dinamicamente os valores recuperados ao selecionar um caminho
diferente na lista.
Nota:
O PI DataLink insere a lista de caminhos raiz na coluna ALL da planilha. Se essa
coluna contm dados, o PI DataLink insere os caminhos na prxima coluna
disponvel direita.
Selecione Coluna ou linha para inserir o contedo das colunas Caminho raiz e Item de
dado nas clulas da planilha designadas.
Neste caso, o PI DataLink sempre insere o contedo de Caminho raiz na primeira coluna
da planilha e o contedo de Item de dado na segunda coluna da planilha.
7. Selecione os itens que deseja inserir e clique em OK.
Veja tambm...
Criar uma exibio relacionada a ativos
Usar o painel de navegao para limitar a pesquisa

O painel de navegao est no lado esquerdo da ferramenta Pesquisar. O painel de navegao
mostra o que o escopo da pesquisa atual inclui (a parte superior da janela mostra o caminho de
escopo correspondente). Para escopos em um AF PI Server, o painel de navegao mostra
apenas os bancos de dados, elementos ou atributos que contm atributos na hierarquia abaixo
deles. Portanto, o painel de navegao nunca listar elementos ou atributos sem atributos filho.
Voc pode usar o painel de navegao para limitar o escopo de uma pesquisa (e definir o
caminho de escopo). Por exemplo, possvel limitar a busca a determinado AF PI Server, a
determinado banco de dados no servidor ou a determinado elemento dentro desse banco de
dados. Enquanto voc navega por uma hierarquia de PI AF Server no painel de navegao, o
painel de resultados se atualiza para mostrar os atributos diretamente abaixo no caminho de
escopo selecionado.
Procedimento
No painel de navegao:
Clique em um servidor para limitar a pesquisa a esse servidor.
A ferramenta atualiza o caminho de escopo no topo da janela para listar o servidor
selecionado e atualiza o painel de navegao. Se voc clicou em um PI AF Server

Fundamentos
(indicado por ), o painel de navegao mostra todos os bancos de dados nesse

servidor. Se tiver clicado em um servidor PI Data Archive (indicado por ), o painel de
navegao mostrar os filtros que podem ser usados para limitar os pontos do PI a serem
recuperados com base nos valores do atributo.
Clique em um banco de dados (indicado por ) para limitar a pesquisa a esse banco de
dados.
A ferramenta atualiza o painel de navegao para mostrar todos os elementos de alto
nvel no banco de dados selecionado e atualiza o caminho de escopo no topo da janela
para listar o banco de dados selecionado.
Clique em um elemento (indicado por ) para limitar a pesquisa a esse elemento.
A ferramenta atualiza o painel de navegao para mostrar todos os elementos pai e
atributos pai no elemento selecionado, atualiza o caminho do escopo na parte superior da
janela para listar o elemento selecionado e lista os atributos no elemento selecionado no
painel de resultados.
Observe que o painel de navegao s mostra os atributos que so atributos pai,
enquanto o painel de resultados mostra tanto atributos pai como no pai no elemento
selecionado.
Clique em um atributo (indicado por ) para limitar a pesquisa a esse atributo.
A ferramenta atualiza o painel de navegao para mostrar todos os atributos pai no
atributo selecionado, atualiza o caminho de escopo na parte superior da janela para listar
o atributo selecionado e lista todos os atributos no atributo selecionado no painel de
resultados.
Usar o caminho de escopo para limitar a pesquisa

O caminho de escopo est na parte superior da ferramenta Pesquisar.
O caminho de escopo mostra onde a ferramenta Pesquisar procura por itens de dados.
possvel utilizar o caminho do escopo para limitar o mbito de uma pesquisa. Por exemplo,
possvel limitar a busca a determinado AF PI Server, a determinado banco de dados no servidor
ou a determinado elemento dentro desse banco de dados. Enquanto voc navega por uma
hierarquia de PI AF Server no caminho de escopo, o painel de resultados se atualiza para
mostrar os atributos diretamente abaixo no caminho de escopo selecionado.
Procedimento
No caminho de escopo:
Clique em Incio para navegar at a mquina servidora. Na mquina servidora, o painel de
navegao mostra todos os servidores PI Data Archive e PI AF Servers listados no
Gerenciador de conexes. No possvel pesquisar na mquina servidora. O escopo mais
amplo de pesquisa um servidor PI Data Archive ou um PI AF Server nico.
Clique na seta ao lado de Home e, em seguida, clique em um servidor especfico para
redefinir o escopo para esse servidor.
Clique no servidor para redefinir o escopo para todo o servidor.
Clique na seta ao lado de um AF PI Server e clique em um banco de dados especfico para
redefinir o escopo para esse banco de dados.
Clique no banco de dados para redefinir o escopo para o banco de dados inteiro.

Fundamentos
Clique na seta ao lado do banco de dados e clique em determinado elemento para

redefinir o escopo para esse elemento.
Clique em um elemento para redefinir o escopo para todo o elemento.
Clique na seta ao lado de um elemento e clique em um subelemento ou atributo para
redefinir o escopo para que subelemento ou atributo.
Clique em um atributo pai para redefinir o escopo para todos os subatributos.
Clique na seta ao lado de um atributo pai e selecione um subatributo especfico para
redefinir o escopo para esse subatributo.

Use a funo Pesquisa do Filtro de Ativos para pesquisar elementos em um banco de dados do
PI AF e filtrar os elementos retornados pelo valor do atributo. Podem-se escolher gerar
elementos filtrados ou atributos selecionados dos elementos filtrados. Tambm possvel
escolher colar o resultado na planilha como valores estticos ou uma matriz da funo, que
pode ser atualizada automaticamente.
Procedimento
1. Selecione a clula superior mais esquerda do intervalo na planilha na qual deseja-se
inserir os ativos recuperados.
2. Na guia PI DataLink, no grupo Pesquisar, clique em Filtro de Ativos para abrir o painel de
tarefas Pesquisa do Filtro de Ativos.
3. No campo Caminho raiz, insira o caminho comum para os elementos a serem encontrados.
O caminho comum deve conter o servidor e o banco de dados e pode conter elementos pai.
Especifique no formato \\ServerName\DatabaseName\ParentElementName.
Por exemplo, para encontrar os elementos no nvel raiz do banco de dados MyDatabase no
servidor MyPIAFServer, insira \\MyPIAFServer\MyDatabase; para encontrar elementos
no elemento Boilers nesse mesmo banco de dados, insira \\MyPIAFServer\MyDatabase
\Boilers.
4. Especifique os elementos do PI AF a serem recuperados:
a. Na lista Template do elemento, selecione o template dos elementos recuperados.
necessrio selecionar um template para filtrar elementos baseados nos valores do
atributo. Observe que se um template base for selecionado, a funo recuperar
elementos dos templates derivados.
b. No campo Nome do elemento, insira o nome dos elementos a serem recuperados. Use
caracteres curingas para especificar parte do nome.
c. Na lista Categoria do elemento, selecione a categoria dos elementos recuperados.
d. No campo Descrio do elemento, insira o texto encontrado na descrio de todos os
elementos a serem recuperados. Use caracteres curingas para especificar parte da
descrio.
e. Marque a caixa de seleo Limitar a nvel raiz para recuperar elementos no nvel
especificado no campo Caminho raiz. Desmarque a caixa de seleo para recuperar
elementos filho.
f. Opcional: Na tabela Filtros de valores do atributo, especifique as condies dos valores
dos atributos dos elementos a serem recuperados.

Fundamentos
necessrio selecionar um template de elemento depois de especificar qualquer

condio do valor do atributo. S possvel filtrar usando os valores dos atributos
definidos nesse template de elemento.
possvel especificar at cinco condies. Para cada condio, defina trs campos:
Na lista Atributo, selecione um atributo encontrado nos elementos baseados no
template de elemento selecionado.
Na lista Operador, selecione o operador relacional, como =, < ou >. Para os atributos
que armazenam strings, boolianos ou valores enumerados, os nicos operadores
vlidos so = e <>.
No campo Valor, insira o valor a ser filtrado. Caracteres curinga podem ser usado nos
atributos da string.
Por exemplo, para recuperar os elementos contendo o atributo Manufacturer que inicia
com ABC e um atributo ZipCode de 94102 a 94188, insira trs condies:
Fabricante = ABC*
ZipCode >= 94102
ZipCode <= 94188
Para obter melhor desempenho, limite os atributos queles que tenham valores
armazenados no banco de dados do PI AF (ou seja, omita os atributos com referncia de
dados). Se um atributo for especificado com uma referncia de dados, a funo usar as
configuraes de preferncia para obter contagem mxima da pesquisa de filtro para
limitar o nmero de elementos pesquisados para corresponder os valores do atributo.
Veja Gerenciar configuraes do PI DataLink.
5. Especifique os resultados da planilha:
a. Na lista Atributos a serem exibidos, selecione os atributos a serem includos e defina a
ordem de exibio dos atributos.
Se nenhum atributo for selecionado, a funo Pesquisa do Filtro de Ativos s retornar os
elementos correspondentes. Se pelo menos um atributo for selecionado, a funo
retornar os atributos selecionados para cada elemento.
Por padro, a lista inclui os atributos no template de elemento selecionado. Voc pode:
Marcar a caixa de seleo Selecionar tudo para incluir todos os atributos listados.
Marque uma caixa de seleo para incluir um atributo ou desmarque uma para excluir
um atributo.
Digitar o nome de um atributo ao lado da caixa de seleo desmarcada na parte
inferior da lista.
Selecionar um atributo e clicar em para mover o atributo para cima na lista de
atributos exibidos.
Selecionar um atributo e clicar em para mover o atributo para baixo na lista de
atributos exibidos.
Selecionar um atributo e clicar em para remover o atributo da lista de atributos
exibidos.
b. Indicar como colocar nos elementos ou atributos correspondentes na planilha:

Fundamentos
Clique em Coluna para inserir o caminho completo para os elementos ou atributos nas
clulas da planilha designada.
Clique na Lista suspensa para inserir uma lista suspensa contendo os caminhos para
os atributos (ou seja, o servidor, o banco de dados e os elementos pai exclusivos)
seguidos pelos atributos selecionados nas clulas da planilha selecionada.
Apenas selecione Lista suspensa se pelo menos um atributo tiver sido selecionado.
Em outra funo do PI DataLink, possvel referenciar a lista suspensa inserida de um
campo Caminho raiz e os atributos de um campo Item de dado para criar uma exibio
relativa ao ativo: a planilha atualizar dinamicamente os valores retornados ao
selecionar um caminho diferente na lista. Veja Exibies relacionadas a ativos.
c. Indique o formato de sada:
Clique em Matriz da funo para colar uma matriz da funo. Esse o formato de sada
das outras funes do PI DataLink. Com uma matriz da funo, possvel facilmente
atualizar as entradas pelo painel de tarefas e recalcular a sada.
Clique em Valores para colar as sadas como valores. possvel copiar facilmente os
valores para serem usados em outro lugar.
Dica:
As matrizes da funo so particularmente teis quando os resultados da funo
so alterados com frequncia. No entanto, o reclculo da matriz da funo, que
ocorre sempre que uma planilha aberta, pode ser reduzido. Em contrapartida, os
valores so teis quando no se espera que os resultados sejam alterados nem se
deseje aguardar pelo reclculo da matriz da funo.
d. Verifique se o campo Clula de sada contm a clula superior mais esquerda na
planilha na qual se deseja inserir os ativos retornados.
6. Clique em OK para inserir os elementos ou atributos correspondentes na planilha e feche o
painel de tarefas.

Use a janela Configuraes para especificar preferncias globais e formatao de sada padro
para as funes do PI DataLink. Essas configuraes se aplicam a determinado usurio em
determinado computador. Nessa janela possvel tambm limpar o cache dos dados de
configurao dos pontos do PI e dados no baseados no PI AF.
Procedimento
1. Na guia PI DataLink, no grupo Recursos, clique em Configuraes.
2. Para limpar o cache do PI DataLink manualmente, clique em Limpar cache.
Por padro, o PI DataLink coleta dados de configurao dos pontos do PI e dados no
baseados em tempo do PI AF (ou seja, dados diferentes dos eventos e da referncia de dados
do ponto do PI). Esse cache aprimora o desempenho. Antes de calcular uma funo, o PI
DataLink verifica quando o cache foi limpo. Se o cache no foi limpo nas ltimas seis horas, o
PI DataLink faz a limpeza automaticamente. Para limpar o cache e obter os dados
atualizados com antecedncia, limpe o cache manualmente.
3. Para atualizar as configuraes, insira as configuraes preferidas e clique em OK.
Configurao Descrio
Copiar nome do PI Data Archive Selecione para colar o nome da fonte de dados PI Data Archive em
(somente suplementos legados) uma clula da planilha adjacente ao inserir nomes de pontos do PI
de funes tag em uma planilha.

Fundamentos
Configurao Descrio
Mostrar #N/A em vez de vazios Selecione para mostrar #N/A (no aplicvel) em vez de vazios em
clulas sem valores, quando um novo clculo retorna menos
valores do que uma matriz de funo pode mostrar.
Este recurso particularmente til se voc usar o pacote de
grficos do Excel para gerar grficos dos resultados de funo.
Independente de local Selecione para que PI DataLink interprete strings de tempo de
entrada de acordo com as regras de formato de hora do PI,
independente das configuraes de local da estao de trabalho
cliente. O PI time pressupe que todas as strings esto em ingls e
usa o formato de data e hora dd-mmm-yyyy hh:mm:ss.
Desmarque a caixa de seleo para aplicar o formato de data e
hora de acordo com as configuraes regionais na estao de
trabalho cliente, aplicando as regras de formato de tempo do PI
somente se necessrio.
Desativar exibio automtica Selecione para desativar a abertura automtica do painel de
do painel de tarefas ao clicar tarefas da funo ao clicar em uma clula da funo.
Desativar a mensagem Selecione para no exibir uma mensagem de aviso quando um
"Redimensionar para mostrar novo clculo retorna mais valores do que uma matriz de funo
todos os valores" pode mostrar.
Fuso horrio do cliente Selecione para interpretar os timestamps de entrada e exibir os
timestamps de sada no fuso horrio da estao de trabalho do
cliente. Algumas funes exibiro determinados timestamps no
fuso horrio do servidor PI Data Archive. Veja Limitaes da
configurao de fuso horrio para obter essas excees.
Fuso horrio do PI Data Archive Selecione para interpretar os timestamps de entrada e exibir os
timestamps de sada no fuso horrio do servidor PI Data Archive.
Essa configurao s se aplica aos itens de dados ou expresses
contendo um ponto do PI ou um atributo do PI AF que seja uma
referncia de dados do ponto do PI. Se o item de dados ou
expresso contiver um atributo do PI AF que no seja uma
referncia de dados de um ponto do PI, o PI DataLink interpretar
os timestamps de entrada e sada como sendo no fuso horrio da
estao de trabalho cliente.
Essa opo s relevante se um servidor PI Data Archive tem uma
configurao de fuso horrio diferente da estao de trabalho
cliente.
Fuso horrio UTC Selecione para interpretar os timestamps de entrada e exibir os
timestamps de sada no tempo universal coordenado (UTC).
Algumas funes no suportam essa configurao. Veja Limitaes
da configurao de fuso horrio para obter detalhes sobre essas
excees.
Em uma linha Selecione para colar mltiplos resultados de uma pesquisa em
uma linha de valores na planilha.
Em uma coluna Selecione para colar mltiplos resultados de uma pesquisa em
uma coluna de valores na planilha. Valor padro.

Fundamentos
Configurao Descrio
Formato de nmero Entre o formato para nmeros em funes de sada. A string de
formato pode ser qualquer cdigo de formato vlido da janela
Formato do Excel (veja Formatos de exibio).
Durante a instalao, o PI DataLink entra o formato de nmero
padro do Excel neste campo, a menos que voc tenha definido
anteriormente uma preferncia de formato diferente no PI
DataLink neste computador. Se a verso do Excel for executada
numa localidade diferente, esse formato inclui a sintaxe correta
para refletir a localidade. Por exemplo:
35.03
apareceria como
35,03
no Excel em francs.
Formato de hora Entre o formato para horrios de sada em funes. A string de
formato de hora pode ser qualquer cdigo de formato de data e
hora vlido da janela Formatar do Excel.
Durante a instalao, o PI DataLink entra o formato de data e hora
padro do Excel neste campo, a menos que voc tenha definido
anteriormente uma preferncia de formato diferente no PI
DataLink neste computador. Se a verso do Excel for executada
numa localidade diferente, esse formato inclui a sintaxe correta
para refletir a localidade. Por exemplo:
dd-mmm-yy hh:mm:ss
apareceria como
jj-mmm-aa hh:mm:ss
no Excel em francs.
Contagem mxima de eventos Insira o nmero mximo de eventos que as funes Explorar
eventos e Comparar eventos retornam para a visualizao e a
planilha.
Contagem mxima da pesquisa Insira o nmero mximo de elementos que a funo Pesquisa do
do filtro filtro de ativos retornar para a planilha, exceto ao especificar um
filtro de valor do atributo para um atributo com uma referncia de
dado. Nesse caso, insira o nmero total de elementos nos quais
deseja-se pesquisar um atributo com uma referncia de dados.
Observe que se esse nmero estiver configurado para muito baixo,
a funo poder retornar menos resultados que o esperado.
Calcular (F9) Selecione para recalcular todas as funes volteis (e todas as
funes que fazem referncia a elas) durante cada reclculo
iniciado pelo recurso de Atualizao Automtica. A funo Valor
Atual a nica funo voltil do PI DataLink.
Clculo completo (Ctrl+Alt Selecione para recalcular todas as funes, independentemente da
+Shift+F9) volatilidade, durante cada reclculo iniciado pelo recurso de
Atualizao Automtica.
Intervalo (segundos) Digite o nmero de segundos entre cada reclculo iniciado pelo
recurso de Atualizao Automtica. O valor mnimo cinco
segundos. Digite 0 para que o PI DataLink calcule um intervalo
automtico com base na durao dos tempos de clculo
anteriores.
Limitaes da configurao de fuso horrio

Determinadas limitaes so aplicadas configurao de fuso horrio:

Fundamentos
A funo de Pesquisa de Notificaes atualmente no suporta a configurao de fuso horrio

UTC. A funo Pesquisa de notificao sempre usa o fuso horrio cliente.
Se uma anotao contiver um timestamp, a funo Dados compactados sempre exibir esse
timestamp no fuso horrio do servidor PI Data Archive.
A funo Propriedades sempre exibe valores dos atributos do ponto do PI contendo
timestamps (por exemplo, datas de criao e modificao) no fuso horrio do servidor PI
Data Archive.
As tendncias criadas com o suplemento do PI DataLink (Legacy) sempre exibem dados no
fuso horrio do servidor PI Data Archive.
As funes do banco de dados do mdulo do PI DataLink (Alias para a funo Tag e a
propriedade para funo de valor) no suportam a configurao de fuso horrio UTC. Essas
funes usam o fuso horrio cliente quando o fuso horrio UTC selecionado.
Gerenciar conexes com servidores

Use o Gerenciador de conexes para gerenciar as conexes com qualquer servidor PI Data
Archive ou PI AF Server, incluindo a escolha dos servidores PI Data Archive e PI AF Server
padres.
Procedimento
1. Na guia PI DataLink, no grupo Recursos, clique em Configuraes para abrir a janela
Configuraes.
2. Clique em Gerenciador de Conexes para abrir a janela Servidores, que mostra as conexes
de servidor definidas e o status atual das conexes, incluindo os servidores padro.
3. Altere as conexes, conforme desejado:
Clique em Adicionar servidor ativo para abrir a janela Propriedades do PI AF Server, na
qual voc pode definir uma conexo com um PI AF Server.
Clique em Adicionar servidor de dados para abrir a janela Propriedades do PI Data Archive,
na qual voc pode definir uma conexo com um servidor PI Data Archive.
Selecione um servidor que no esteja conectado no momento e clique em Conectar para
conectar-se a ele.
Para se conectar com um PI AF Server, o PI DataLink usa as credenciais do Windows do
usurio autenticado. Para se conectar a servidores PI Data Archive, o PI DataLink pode
usar um trust do PI ou um usurio padro como complemento s credenciais do
Windows do usurio autenticado.
Selecione um servidor que no seja a conexo padro no momento e clique em Definir
como padro para torn-lo a conexo padro (servidor PI Data Archive ou PI AF Server).
Selecione um servidor e clique em Propriedades para exibir as propriedades de conexo
desse servidor.
Clique com o boto direito em um servidor e clique em Remover para remover a
definio de conexo com esse servidor.

Fundamentos

Criao de planilha
Esta seo descreve o processo que poder ser usado para criar planilhas com o PI DataLink, e
alguns tipos especficos de displays que podem ser criados com o PI DataLink. Os tpicos sobre
os displays incluem procedimentos para a criao deles.
Nesta seo
Processo de criao de planilhas
Recuperao de grandes quantidades de dados
Exibies relacionadas a ativos
Eventos na planilha
Processo de criao de planilhas

Quando estiver familiarizado com as ferramentas bsicas e os conceitos do PI DataLink, o
usurio estar pronto para criar uma planilha que use as funes do PI DataLink.
Considere seus objetivos

Pergunte-se:
Que dados deseja-se exibir em uma planilha para monitorar o desempenho ou responder a
uma pergunta de negcio?
Onde esto os dados?
Como as informaes podem ser exibidas de forma mais eficiente, tanto para comunicar
pontos essenciais como para fornecer o contexto necessrio?
As respostas vo ajud-lo a determinar que funes PI DataLink podem retornar os dados mais
relevantes para a sua tarefa.
Selecionar uma propriedade

As tcnicas que se podem usar para criar a planilha incluem:
Baseado na funo
Adicione uma funo do PI DataLink planilha e crie o display das funes conforme
necessrio. Por exemplo, possvel adicionar informaes do ponto para ajudar a esclarecer
o que os dados representam. Essa abordagem til se as necessidades esto sendo
exploradas, ou o funcionamento do PI DataLink, aprendido.
Baseado na estrutura
Adicione estruturas enquanto cria uma planilha. Use a ferramenta Pesquisar para inserir
itens de dados que estruturam o assunto da sua planilha e adicione funes que recuperam
os dados correspondentes. Essa abordagem requer um pouco mais de planejamento e
familiaridade com o PI DataLink, mas uma vez que os itens de dados tenham sido
adicionados planilha, ser possvel us-los para criar funes mais facilmente por meio
das referncias de clula. As planilhas criadas dessa forma podem ser facilmente
reutilizadas.
Baseado em relatrio
Coloque as funes do PI DataLink em uma segunda planilha na pasta de trabalho e
referencie os resultados dessas funes na primeira planilha. Use os recursos de segurana

Criao de planilha
do Excel para ocultar e proteger a sintaxe da funo e a lgica de negcios na segunda

planilha da maioria dos usurios. Essa abordagem til se o usurio for um administrador
de sistema ou construir planilhas para outros usurios. Essa estratgia tambm funciona
bem para documentos distribudos por meio do PI Data Link Server.
Veja tambm
Funes do PI DataLink
PI DataLink Server (DLS)

Para cada item de dado em uma funo, o PI DataLink deve fazer uma chamada para PI Data
Archive ou PI Asset Framework para recuperar os valores. Quando o PI DataLink recuperar os
valores para grandes nmeros de itens de dado, processar cada chamada separadamente pode
resultar em um longo tempo de recuperao. Para reduzir esse tempo, o PI DataLink faz
chamadas em lote para certas funes em certas condies.
As seguintes condies devem ser satisfeitas para fazer uma chamada em lote:
Entradas de funo especificam itens de dado, e no expresses ou expresses de filtro
Entrada de funo especifica itens de dado com uma referncia a um intervalo de clula
As configuraes do PI DataLink especificam timestamps no fuso horrio do cliente
Com as condies acima satisfeitas, as seguintes funes efetuam chamadas em lote:
Valor atual
Valor de Archive
Dados calculados (sem intervalo de tempo especificado)
O PI DataLink retorna valores de uma chamada em lote em uma nica matriz de funo.
As chamadas em lote resultam em melhorias de desempenho quando as funes retornam
valores para mais de 1.000 itens de dado ou em ambientes com latncia entre o PI DataLink e
as origens de dados. Quando as funes retornam valores para mais de 10.000 itens de dado, as
chamadas em lote reduzem o tempo de retorno de acordo com a ordem de magnitude.
Portanto, ao criar planilhas que recuperam valores para grandes nmeros de itens, considere
usar essas funes sob as condies necessrias.
Exibies relacionadas a ativos

Uma exibio relacionada a ativos mostra os valores de um conjunto de atributos do PI AF com
o ativo correspondente (um elemento do PI AF). Pode-se selecionar um ativo diferente para
mostrar os valores desse ativo.

Criao de planilha
Exibio relacionada a ativos do elemento Reator1
Exibio relacionada a ativos do elemento Reator2
As exibies relacionadas a ativos so um conjunto comum de nomes de atributo para os

ativos. Por exemplo, para criar uma exibio relacionada a ativos, use elementos do PI AF
baseados nos mesmos templates de elemento e atributo.
Criar uma exibio relacionada a ativos

Para criar uma exibio relacionada a ativos, insira um conjunto de itens de dados que tenham
uma estrutura comum na planilha com uma lista suspensa de caminhos raiz e adicione uma
funo do PI DataLink que referencie essas clulas. Depois de criar a exibio relacionada ao
ativo, ser possvel selecionar um ativo diferente da lista para ver os valores de atributo desse
ativo.
Procedimento
1. Inserir um conjunto de itens de dado com uma estrutura comum na planilha.
2. Configurar a funo PI DataLink que faz referncia aos itens de dados inseridos..
Veja tambm
Inserir um conjunto de itens de dado com uma estrutura comum na

planilha
Exibies relacionadas a ativos exigem que a planilha contenha um conjunto de itens de dado
(atributos do PI AF) que tm uma estrutura comum, junto com uma lista suspensa de caminho
raiz para esses itens de dado.
Procedimento
1. Selecione uma clula na planilha na qual os itens de dado sero inseridos.
2. Na guia PI DataLink, clique em Pesquisar para abrir a ferramenta de pesquisa.
3. Defina o escopo da pesquisa, especifique os itens de dado que voc deseja recuperar e clique
em Pesquisar .

Criao de planilha
Para exibies relacionadas a ativos, voc quer encontrar atributos de PI AF que tm um

elemento-pai comum e a mesma estrutura de atributo. Esses atributos podem ter o mesmo
modelo de atributo. Por exemplo, voc pode querer encontrar todos os reatores em suas
instalaes.
4. Divida os caminhos dos itens de dado de forma que os ativos a serem exibidos apaream na
coluna Caminho raiz.
Mova o controle deslizante Comprimento do item de dado at que a coluna Caminho raiz
mostre os elementos individuais para os atributos listados. Normalmente isso ser prximo
da, ou na, configurao Somente nome.
5. Selecione os itens de dado a serem inseridos na planilha.

6. Em Inserir caminhos raiz em, selecione Lista suspensa.
7. Clique em OK.
O PI DataLink inserir os itens de dado individuais na planilha abaixo de uma lista suspensa
contendo os ativos individuais (da coluna caminho raiz).
Nota:
O PI DataLink insere a lista de caminhos raiz na coluna ALL da planilha. Se essa coluna
contm dados, o PI DataLink insere os caminhos na prxima coluna disponvel
direita.

Criao de planilha
Configurar a funo PI DataLink que faz referncia aos itens de dados

inseridos.
Exibies relacionadas a ativos requerem a configurao de uma funo do PI DataLink para
recuperar dados para os itens de dados e caminho raiz inseridos na planilha: um conjunto de
dados com uma estrutura comum e o caminho raiz para essa estrutura.
Procedimento
1. Clique na clula da planilha prxima ao primeiro item de dados no intervalo inserido.
2. Na guia PI DataLink, clique na funo deseja-se usar para recuperar os valores.
O painel de tarefas da funo abrir, com a clula clicada especificada no campo Clula de
sada.
3. No painel de tarefas da funo, clique no campo Item(ns) de dado(s) e selecione o intervalo
de planilha que contm os itens de dados que voc acabou de inserir.
O PI DataLink insere o intervalo de clulas no campo.
4. No painel de tarefas da funo, clique no campo Caminho raiz e selecione a clula da
planilha que contm a lista suspensa de caminhos raiz.
O PI DataLink insere uma referncia de clula no campo.
5. Especifique outras entradas de funo, como desejado.
6. Clique em OK para inserir a matriz da funo na planilha.
Pode-se selecionar um ativo diferente da lista para ver os valores de atributo para esse
ativo.
Pode-se selecionar um ativo diferente da lista para ver os valores de atributo para esse
ativo.
Eventos na planilha
Use o PI DataLink para criar display para exibir, compreender e analisar eventos armazenados
no PI AF. A configurao do sistema e o tipo de dados coletados determinam quais eventos
esto armazenados no sistema. Por exemplo, o sistema pode ter eventos que armazenam
informaes sobre os processos em lote ou eventos criados com base em clculos.
Podem-se usar duas funes do PI DataLink para recuperar eventos:
Explorar a funo Eventos

til para explorar eventos em qualquer lugar na hierarquia de eventos, a funo Explorar
eventos retorna um evento por linha. Pode-se usar a funo Explorar eventos para examinar
os dados em uma hierarquia simples, como analisar os eventos de um elemento em
particular. Por exemplo, pode-se examinar o tempo ocioso de determinada caldeira.

Criao de planilha
Explorar eventos relacionados a um elemento
Tambm possvel usar a funo Explorar eventos para examinar os eventos em uma
hierarquia completa, por exemplo, analisar os eventos filho para um tipo de eventos. (O
template de eventos geralmente indica o tipo de evento.) Por exemplo, possvel examinar
as fases de inicializao das turbinas.
Explorar eventos com eventos filho
Funo Comparar eventos

til para comparar eventos hierrquicos, a funo Comparar eventos pode retornar
atributos de eventos relacionados em uma nica linha. Nos displays criados na funo
Comparar eventos, cada linha pode mostrar um evento recuperado com informaes desses
eventos filho e pai do evento. Incluir essas informaes pode ajudar na comparao dos
eventos recuperados. Por exemplo, incluir informaes sobre os eventos da fase do evento
de inicializao pode ajudar na comparao de vrios eventos de inicializao.
A funo Comparar eventos identifica os atributos por caminho. Portanto, os nomes a
localizao hierrquica do atributo afetam o display. Os recursos da funo so diferentes,
dependendo da estrutura e dos atributos dos eventos:
Os eventos com eventos filho com nomes idnticos

Se houver um conjunto de eventos com eventos filho identicamente nomeados, ser
possvel comparar esses eventos incluindo as informaes do evento filho e do evento
pai. Especifique os critrios para encontrar os eventos com eventos filho identicamente
nomeados. A funo Comparar eventos pode incluir informaes sobre os eventos filho
na mesma linha em cada evento correspondente. Por exemplo, possvel comparar
eventos de inicializao da turbina com eventos de fase identicamente nomeados, como
Phase1, Phase2 e Phase3.
Comparar eventos incluindo informaes sobre eventos filho
A funo Comparar eventos tambm pode incluir informaes sobre os eventos pai na
mesma linha de um evento correspondente. Informaes do evento pai podem ser
includas para fornecer mais informaes sobre os eventos correspondentes. Por
exemplo, para os eventos de inicializao da turbina, as informaes sobre o evento do
processo pai pode melhorar a comparao.

Criao de planilha
Comparar eventos incluindo informaes sobre eventos pai e filho
Os eventos com eventos filho com nomes diferentes

Se houver um conjunto de eventos com eventos filho com nomes diferentes, ser possvel
comparar esses eventos incluindo as informaes do evento pai. Especifique os critrios
para encontrar os eventos de nvel mais baixo na hierarquia. A funo Comparar eventos
pode incluir informaes sobre os eventos pai na mesma linha em cada evento
correspondente. Por exemplo, suponha que os eventos da primeira fase tenham nomes
diferentes, como Phase1, P1, PhaseX e PhaseA. possvel comparar os eventos da fase e
incluir informaes sobre o evento de inicializao pai.
Comparar eventos incluindo informaes de evento pai
Nesta seo
Explorar eventos relacionado a um elemento
Comparar eventos incluindo eventos filho
Comparar eventos incluindo eventos pai
Nomes reservados do atributo

Siga este procedimento para usar a funo Explorar eventos para explorar analisar os eventos
relacionados a determinado elemento do PI AF. Por exemplo, suponha que se deseje analisar o
tempo ocioso de determinada caldeira. Todos os eventos ociosos dessa caldeira podem ser
recuperados no Microsoft Excel, e um grfico pode ser criado para analisar os dados. Nesse
caso, encontre os eventos que correspondam a um nome do elemento e a um nome do evento.
Procedimento
1. Selecione uma clula na planilha na qual deseja-se que o PI DataLink comece a inserir a
matriz da funo contendo os eventos.
2. Na guia PI DataLink, no grupo Eventos, clique em Explorar para abrir o painel de tarefas
Explorar eventos.
3. Especifique os critrios para encontrar os eventos de seu interesse. Assim que os critrios
so inseridos, a lista Visualizar atualizada para mostrar os eventos que correspondem aos
critrios inseridos.
a. No campo Banco de dados, insira o banco de dados do PI AF que armazena os eventos.
Especifique no formato \\ServerName\DatabaseName. Clique no campo para abrir uma
lista de bancos de dados contendo os templates de evento nos PI AF Servers conectados.
b. Nos campos Incio da pesquisa e Trmino da pesquisa, especifique o perodo no qual se
deseja pesquisar os eventos ativos.

Criao de planilha
Insira uma expresso de tempo do PI Por exemplo, para recuperar eventos que estavam
ativos no ltimo ms, insira *-1mo no campo Incio da pesquisa e* no campo Trmino da
pesquisa.
Dica:
Para encontrar eventos com uma relao mais especfica com esse perodo, por
exemplo, eventos iniciados e terminados nesse perodo, expanda Mais opes de
pesquisa e selecione outro mtodo na lista Modo de pesquisa.
c. Conforme necessrio, especifique outros critrios para definir os eventos retornados
pela funo (mostrados na lista Visualizar).
Consulte Referncia do painel de tarefas Explorar eventos para obter uma lista dos
campos disponveis.
Por exemplo, use a lista Nome do evento para limitar os eventos retornados com base
em determinado nome. Digite *shut* para encontrar todos os elementos contendo shut
no nome, por exemplo, shutdown e BoilerShutdown. Se a entrada padro for mantida,
*, a funo encontrar eventos com qualquer nome.
Por exemplo, use a lista Nome do elemento para limitar os eventos retornados aos
associados com elementos em particular. Digite Boiler5 para analisar os eventos
associados caldeira.
a. Na lista Colunas a serem exibidas, selecione as colunas a serem includas na matriz da
funo e configure a ordem da coluna.
A lista contm os nomes dos atributos. Por padro, a lista inclui os atributos virtuais
gerados em todos os eventos e os atributos de evento do template de evento selecionado.
Pode-se:
Marcar a caixa de seleo Selecionar tudo para incluir todos os atributos listados
como colunas na matriz da funo retornada.
Marcar uma caixa de seleo para incluir o atributo ou desmarque um para excluir um
atributo como uma coluna na matriz da funo retornada.
Clique em para abrir a janela Adicionar atributos, na qual possvel adicionar
outros atributos a serem includos como colunas na matriz da funo. Veja Adicionar
colunas de atributos ao painel de tarefas Explorar eventos.
Digitar o nome de um atributo de evento ao lado da caixa de seleo desmarcada na
parte inferior da lista.
Clicar com o boto direito do mouse em um atributo, clicar em Inserir atributo para
inserir um atributo vazio acima do atributo selecionado e digitar o nome de um
atributo de evento.
Selecionar um atributo e clicar em para mover o atributo para cima na lista.
Selecionar um atributo e clique em para mover o atributo para baixo na lista.
Selecionar um atributo e clicar em para remover o atributo da lista.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir atributo para
remover o atributo da lista.
b. Verifique se o campo Clula de sada contm a clula da planilha na qual deseja-se inserir
o canto superior esquerdo da matriz da funo.

Criao de planilha
Se clicar em uma clula antes de abrir o painel de tarefas, o PI DataLink inserir

automaticamente essas clula nesse campo.
O que Fazer Depois

Usar os recursos do Excel para analisar dados. Por exemplo, criar um grfico.
Adicionar colunas de atributos ao painel de tarefas Explorar eventos

Use a janela Adicionar atributos para adicionar atributos de evento filho lista Colunas a serem
exibidas no painel de tarefas Explorar eventos. Esses atributos podem ser includos na matriz
de funo inserida na planilha.
Antes de Iniciar
Abra o painel de tarefas Explorar eventos e especifique os eventos a serem recuperados na
planilha.
Procedimento
1. Ao lado da lista Colunas a serem exibidas no painel de tarefas, clique em para abrir a
janela Adicionar atributos.
A janela lista os eventos que correspondem aos critrios atualmente especificados no painel
de tarefas.
2. Expanda um evento para ver os atributos de evento armazenado nesse evento.
Pode-se incluir qualquer atributo de elemento como uma coluna na matriz da funo.
Quando includa na matriz da funo, uma coluna de atributo mostra os valores
armazenados para um evento.
3. Marque a caixa de seleo ao lado de qualquer atributo que se deseja adicionar lista
Colunas a serem exibidas no painel de tarefas.
A funo Explorar eventos identifica os atributos por nome. Os nomes de atributo e evento
definem exclusivamente um valor. Portanto, s necessrio adicionar determinado atributo
uma nica vez. Ao selecionar um atributo, a janela automaticamente seleciona esse atributo
em todos os locais em que ele aparece na hierarquia de eventos.
Nota:
O PI DataLink no sincroniza selees nesta janela usando a lista Colunas a serem
exibidas no painel de tarefas. Nessa janela, selecione um atributo j disponvel ou
selecionado na lista de colunas no painel de tarefas; isso adiciona o mesmo atributo
mais de uma vez lista de colunas no painel de tarefas.
4. Clique em OK para inserir o atributo na lista Coluna a serem exibidas e selecione essa
coluna.

Pode-se usar a funo Explorar eventos para analisar eventos com eventos filho examinando-
os em um formato hierrquico. Por exemplo, suponha que deseje-se analisar as fases de
inicializao das turbinas e que cada etapa tenha sido configurada como um evento filho de um

Criao de planilha
evento de inicializao geral. Pode-se recuperar todos os eventos de inicializao da turbina

com seus eventos filho (os eventos da fase) no Microsoft Excel e analisar os dados obtidos.
Nesse caso, recupere os eventos pelo template de evento.
Procedimento
2. Na guia PI DataLink, no grupo Eventos, clique em Explorar para abrir o painel de tarefas
Explorar eventos.
critrios inseridos.
pesquisa.
Dica:
Consulte Referncia do painel de tarefas Explorar eventos para obter uma lista dos
campos disponveis.
Por exemplo, use a lista Template do evento para limitar os eventos retornados com
base em determinado template de evento. Selecione o template chamado
TurbineStartUp para analisar os eventos de inicializao da turbina.
a. Na lista Colunas a serem exibidas, selecione as colunas a serem includas na matriz da
funo e configure a ordem da coluna.
gerados em todos os eventos e os atributos de evento do template de evento selecionado.
Pode-se:
Clique em para abrir a janela Adicionar atributos, na qual possvel adicionar
outros atributos a serem includos como colunas na matriz da funo. Veja Adicionar
colunas de atributos ao painel de tarefas Explorar eventos.

Criao de planilha
Clicar com o boto direito do mouse em um atributo, clicar em Inserir atributo para
inserir um atributo vazio acima do atributo selecionado e digitar o nome de um
atributo de evento.
b. Na lista Nmero de nveis de eventos filho, selecionar o nmero de nveis de eventos
filho a serem includos na matriz da funo.
Selecionar 0 para que nenhum evento filho seja recuperado, selecionar 1 para recuperar
eventos filho do primeiro nvel (ou seja, eventos imediatamente abaixo dos eventos
correspondentes) e assim por diante. possvel identificar eventos com eventos filho na
lista Visualizar por um sinal de + ao lado do nome do evento. Os eventos filho no
precisam corresponder aos critrios especificados.
A funo adiciona uma coluna para cada nvel recuperado. Ao recuperar eventos filho, a
funo insere cada evento filho na linha separada. Nas linhas contendo eventos filho, a
coluna adicionada contm o nome do evento filho. A funo pode incluir at trs nveis
de elementos filho.
c. Verifique se o campo Clula de sada contm a clula da planilha na qual deseja-se inserir
o canto superior esquerdo da matriz da funo.

Pode-se usar a funo Comparar eventos para comparar eventos com eventos filhos contendo
os mesmos nomes. A funo Comparar eventos identifica os atributos por caminho. Por isso,
ela pode retornar atributos de eventos relacionados em uma nica linha. Por exemplo, suponha
que haja eventos de inicializao da turbina contendo eventos em fase (eventos filho que
ocorrem durante o evento de inicializao). A funo Comparar eventos pode apresentar uma
linha para cada evento de inicializao e mostrar valores das fases correspondentes em
colunas separadas em cada linha. Essa matriz da funo retornada pode ser usada para
comparar facilmente os eventos de inicializao.
Procedimento
2. Na guia PI DataLink, no grupo Eventos, clique em Comparar para abrir o painel de tarefas
Comparar eventos.

Criao de planilha
critrios inseridos.
pesquisa.
Dica:
Consulte Referncia do painel de tarefas Comparar eventos para obter uma lista dos
campos disponveis.
TurbineStartUp para analisar os eventos de inicializao da turbina.
4. Use a lista Colunas a serem exibidas para especificar as colunas na matriz da funo
retornada.
gerados em todos os eventos e os atributos de evento do template de evento selecionado. A
funo identifica os atributos por caminho. Consulte Notao de caminho para a funo
Comparar eventos para obter informaes sobre as notaes de caminho com suporte.
a. Clique em para abrir a janela Adicionar atributos e selecionar os atributos do evento

filho a serem comparados aos eventos pai.
Consulte Adicionar atributos de evento filho como colunas no painel de tarefas Comparar
eventos.
b. Insira quaisquer atributos de evento pai a serem includos na matriz da funo.
Consulte Adicionar atributos de evento pai como colunas no painel de tarefas Comparar
eventos.
c. Selecione as colunas a serem includas na matriz da funo e configure a ordem da
coluna.
Pode-se:

Criao de planilha
5. Verifique se o campo Clula de sada contm a clula da planilha na qual deseja-se inserir o
canto superior esquerdo da matriz da funo.
Adicionar atributos de evento filho como colunas no painel de tarefas

Comparar eventos
Use a janela Adicionar atributos para adicionar atributos de evento filho lista Colunas a serem
exibidas no painel de tarefas Comparar eventos. (Ento, essas colunas podem ser includas na
matriz de funo inserida na planilha.) Depois de especificar os critrios dos eventos no painel
de tarefas, essa janela listar os eventos correspondentes e seus eventos filho. Use essa janela
para adiciona qualquer atributo de evento desses eventos. Normalmente, essa janela usada
para adicionar atributos de evento filho que ajudaro a comparar os eventos correspondentes.
Antes de Iniciar
Abra o painel de tarefas Comparar eventos e especifique os eventos a serem recuperados na
planilha.
Procedimento
1. Ao lado da lista Colunas a serem exibidas no painel de tarefas, clique em para abrir a
janela Adicionar atributos.
A janela lista os eventos que correspondem aos critrios atualmente especificados no painel
de tarefas.
2. Expanda um evento para ver os atributos de evento armazenados para o evento, alm dos
eventos filho.
Se dois ou mais eventos filho tiverem o mesmo nome, o PI DataLink adicionar
automaticamente um ndice ao nome do evento filho. Para criar o ndice, o PI DataLink
classifica esses eventos aumentando a hora de incio, o tempo final e o identificador.

Criao de planilha
Evento com dois eventos filho chamado Fase1
Pode-se incluir um atributo de evento como uma coluna na matriz da funo. Quando
includa na matriz da funo, essa coluna mostra os valores armazenados para o atributo de
evento.
3. Marque a caixa de seleo ao lado de qualquer atributo que se deseja adicionar lista
Colunas a serem exibidas no painel de tarefas.
A funo Comparar eventos identifica os atributos por nome e caminho relativo ao evento
correspondente. Por exemplo, suponha que o atributo Start time tenha sido selecionado
em um evento correspondente e em seu evento filho.
Selecionar o atributo da hora de incio dos eventos correspondente e filho
Isso adiciona duas colunas:

.|Start time
Na planilha, essa coluna contm a hora de incio do evento correspondente listado em
cada linha.
.\Phase1|Start time
Na planilha, essa coluna contm a hora de incio do evento filho Phase1 do evento
correspondente listado em cada linha.
Planilha com coluna de atributo filho
possvel adicionar atributos de qualquer lugar na hierarquia. A janela no sincronizar

selees: se o caminho e o nome do atributo forem os mesmos, ser possvel adicionar o
mesmo atributo mais de uma vez.

Criao de planilha
Quando os eventos tiverem hierarquias de eventos inconsistentes, selecione os atributos

dos eventos filho com cuidado. Se qualquer evento contiver vrios eventos filho com o
mesmo nome, selecione os atributos em um evento filho duplicado (ou seja, um evento filho
indexado) para garantir que os dados de todos os eventos sejam vistos. Por exemplo,
suponha que tenha selecionado o atributo Start time em um evento filho duplicado (o
evento filho Phase1[1] do evento TurbineStartUp.1.2) e um evento filho no duplicado
(o evento filho Phase1 do evento TurbineStartUp.3.2 ).
Selecionar o atributo de hora de incio dos eventos filho duplicado e no duplicado
Isso adiciona duas colunas que podem retornar resultados diferentes:

.\Phase1[1]|Start time
Na planilha, essa coluna contm a hora de incio do evento filho Phase1 do evento
correspondente listado em cada linha. Se o evento correspondente tiver apenas um
evento filho com esse nome, a coluna listar a hora de incio desse evento nessa coluna.
.\Phase1|Start time
Na planilha, essa coluna contm a hora de incio do nico evento filho Phase1 do evento
correspondente listado em cada linha. Se o evento correspondente tiver mais de um
evento filho com esse nome, a coluna reportar Duplicate event exists: specify
index for Phase1.

Criao de planilha
Planilha com atributos filho indexado e no indexado
O atributo indexado garante que os dados desejados sejam retornados.

4. Clique em OK para inserir o atributo na lista Coluna a serem exibidas e selecione essa
coluna.
Adicionar atributos de evento pai como colunas no painel de tarefas

Comparar eventos
Para ajudar na comparao de eventos em uma planilha, inclua colunas contendo informaes
sobre os eventos pai dos eventos correspondentes. Use a lista Colunas a serem exibidas no
painel de tarefasComparar eventos para inserir os atributos de eventos pai (e seus eventos pai
ou qualquer evento de nvel superior na hierarquia).
Nota:
A funo Comparar eventos no recupera dados dos atributos de evento pai dos eventos
com relaes definidas pelas referncias da estrutura de eventos.
Antes de Iniciar
Abra o painel de tarefas Comparar eventos e especifique os eventos a serem recuperados na
planilha.
Procedimento
1. Na lista Colunas a serem exibidas no painel de tarefas Comparar eventos, adicione os
atributos de evento pai usando o mtodo apropriado do atributo:
Para inserir: Faa o seguinte:
Mesmo nome de a. Clique com o boto direito do mouse no atributo e clique em Clonar
atributo no nvel pai para evento pai.
O PI DataLink insere o atributo de evento pai do mesmo nome acima
do atributo selecionado.
Por exemplo, se clicar com o boto direito do mouse no atributo .|
Nome do evento (o atributo Event name do evento
correspondente) e clicar em Clonar para evento pai, o PI DataLink
inserir o atributo ..|Nome do evento (o atributo Event name do
evento pai).
Pode-se repetir para adicionar o mesmo atributo de eventos

superiores at a hierarquia. Por exemplo, se clicar com o boto
direito do mouse no atributo ..|Nome do evento e clicar em Clonar
para evento pai, O PI DataLink inserir o atributo ..\..|Nome do
evento (o atributo Eventname do evento av).

Criao de planilha
Para inserir: Faa o seguinte:

Nome exclusivo do a. Clique com o boto direito do mouse no atributo acima no qual se
atributo deseja inserir o atributo de evento pai e clique em Inserir atributo.
O PI DataLink insere um atributo em branco na etiqueta de evento
primria (.|).
b. Insira o caminho e o nome correto do atributo de evento pai.
Por exemplo, para incluir o atributo Type do evento pai, insira ..|
Tipo.
Para obter mais informaes sobre a sintaxe do caminho, consulte Notao de caminho para
a funo Comparar eventos.

Pode-se usar a funo Comparar eventos para apresentar informaes sobre os eventos pai na
mesma linha de um evento. Esse recurso pode ser usado para comparar eventos de hierarquias
correspondentes, inclusive eventos com nomes diferentes. Por exemplo, suponha que haja
eventos de inicializao da turbina com eventos de fase, mas alguns deles tm nomes
diferentes. Na funo Comparar eventos, pode-se retornar uma linha para cada evento de fase e
mostrar valores do evento pai em colunas separadas em cada linha de evento de fase. As
informaes retornadas para ajudar na comparao dos eventos de fase.
Procedimento
2. Na guia PI DataLink, no grupo Eventos, clique em Comparar para abrir o painel de tarefas
Comparar eventos.
critrios inseridos.
pesquisa.
Dica:
Consulte Referncia do painel de tarefas Comparar eventos para obter uma lista dos
campos disponveis.

Criao de planilha
StartUpPhase1 para analisar os eventos de inicializao da primeira fase.
4. Use a lista Colunas a serem exibidas para especificar as colunas na matriz da funo
retornada.
gerados em todos os eventos e os atributos de evento do template de evento selecionado. A
funo identifica os atributos por caminho. Consulte Notao de caminho para a funo
Comparar eventos para obter informaes sobre as notaes de caminho com suporte.
a. Insira os atributos de evento pai a serem includos na matriz da funo.

Consulte Adicionar atributos de evento pai como colunas no painel de tarefas Comparar
eventos.
Por exemplo, clique com o boto direito do mouse em alguns dos atributos virtuais e
clique em Clonar para evento pai para inserir os atributos de evento pai
correspondentes, como:
..|Nome do evento
..|Hora de incio
..|Elemento primrio
b. Selecione os atributos a serem includos como colunas na matriz da funo e configure a
ordem da coluna.
Pode-se:
5. Verifique se o campo Clula de sada contm a clula da planilha na qual deseja-se inserir o
canto superior esquerdo da matriz da funo.

Criao de planilha

O PI DataLink automaticamente gera alguns atributos virtuais para eventos e usos de nomes
reservados para identificar esses atributos virtuais. Para evitar conflitos com os atributos
definidos pelo evento, no defina os eventos que usem os seguintes nomes reservados como
nomes do atributo:
Durao
Template de elemento
Tempo final
Categorias de evento
Nome do evento
Caminho de evento
Template de evento
Elemento primrio
Caminho do elemento primrio
Hora de incio

Criao de planilha

Com as funes do PI DataLink, possvel consultar qualquer servidor PI Data Archive ou PI AF
Server, aplicar clculos aos resultados recuperados e retornar valores para clulas da planilha.
Como outras funes do Excel, as funes do PI DataLink retornam resultados em matrizes de
funo, que se pode recalcular para atualizar os valores conforme necessrio. Use os painis de
tarefas de funo para definir as entradas para as funes do PI DataLink e col-las em uma
planilha.
As descries de funo nesta seo descrevem as entradas especficas para cada funo.
Veja tambm...
Matrizes da funo
Referncia de funo
Nesta seo
Funo Valor atual
Funo Valor de Archive
Funo Dados compactados
Funo Dados de amostragem
Funo Dados temporizados
Funo Dados calculados
Funo Tempo Filtrado
Funo Explorar eventos
Funo Propriedades
Funo Valor atual

A funo Valor atual retorna o valor mais recente de um PI Point histrico ou atributo do PI AF.
Para um ponto do PI futuro, o valor retornado depende dos timestamps dos valores registrados
em relao ao horrio atual:
Se todos os valores retornados possurem timestamps anteriores ao horrio atual, a funo
retorna o valor registrado mais recente.
Se os valores registrados possurem timestamps que sobrepem o horrio atual, a funo
retorna um valor interpolado.
Se todos os valores registrados possurem timestamps aps o horrio atual, a funo no
retorna dados.
O Valor atual uma funo voltil: a funo recalcula e atualiza valores sempre que o Excel
calcula ou recalcula qualquer clula na planilha. Para forar um reclculo imediato, pressione
F9.
Essa funo suporta chamadas em lote.

Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados. As entradas vlidas
incluem:
PI Data Archive nome do servidor se o item de dado um ponto do PI.
PI AF Server e banco de dados se o item de dados um atributo do PI AF.
Em branco se o item de dado um ponto do PI no servidor PI Data
Archive padro.
Veja Itens de dado.
Item(ns) de dado(s) Um ou mais nomes de ponto do PI ou nomes de atributo do PI AF, para os
quais a funo retorna valores.
Referencia um intervalo de clulas contendo nomes dos pontos do PI ou dos
atributos do PI AF para os quais sero retornados valores.
Requerido.
Clula de sada A clula de planilha na qual a funo grava a matriz da funo resultante. Se
voc selecionar uma clula antes de abrir o painel de tarefas de funo, o PI
DataLink insere a clula selecionada no campo Clula de sada.
Especifique o canto superior esquerdo da matriz da funo. O PI DataLink
expande o intervalo, para baixo e direita da clula de sada, conforme
necessrio para retornar os dados especificados. O PI DataLink pode
sobrescrever clulas adjacentes.
Se uma matriz com vrias clulas for especificada no campo Clula de sada e
a matriz especificada for maior do que a matriz da funo resultante, o PI
DataLink colar a frmula da funo nas clulas desnecessrias da matriz
especificada.
Sem timestamp Clique nessa opo para retornar somente valores. A funo retorna valores
em uma coluna para uma coluna de itens de dados referenciados ou retorna
valores em uma linha para uma linha de itens de dados referenciados.
Hora esquerda Clique nesta opo para retornar duas colunas: o timestamp na coluna
esquerda e o valor na coluna direita.
Hora na parte superior Clique nesta opo para retornar duas linhas: o timestamp na linha de cima e
o valor na linha de baixo.
Veja tambm...
PICurrVal()
Exemplo de Valor atual

Para ver o valor atual do ponto do PI sinusoid, defina as seguintes entradas da funo Valor
atual:
Entrada Valor
Item(ns) de dados sinusoid
Tempo esquerda Selecionado
A funo retorna a seguinte matriz:


Se a opo Item de dado for selecionada, a funo Valor de Archive retornar o valor de um
ponto do PI ou atributo do PI AF em um timestamp especificado. Essa funo suporta
chamadas em lote.
Se voc selecionar a opo Expresso, a funo Valor de Archive retorna o valor calculado
de uma Performance Equation em um timestamp especificado.
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados, incluindo aqueles em
expresses. As entradas vlidas incluem:
Archive padro.
Veja Itens de dado.
Requerido se voc selecionar a opo Item de dado.
Expresso(es) Uma ou mais Performance Equations para as quais a funo calcula um valor.
Veja Expresses.
Referencia um intervalo de clulas contendo expresses para as quais sero
retornados valores.
Requerido se voc selecionar a opo Expresso.
Timestamp O horrio para o qual a funo retorna valores. Especifique um tempo fixo ou
uma expresso de tempo em relao hora atual. Veja Entradas de tempo.
Requerido.

Entrada Descrio
Modo de recuperao O mtodo usado pela funo para determinar os valores a serem retornados.
As opes incluem:
anterior
Retorna o valor que corresponde exatamente ou precede o timestamp
especificado.
somente anterior
Retorna o valor que precede o timestamp especificado.
interpolado
Retorna o valor interpolado no tempo especificado.
Veja Valores interpolados.
auto
Retorna o valor interpolado no tempo especificado ou segue o mtodo
anterior. (Usa o mtodo anterior dos itens de dado com atributos step.)
prximo
Retorna o valor que corresponde exatamente ou segue o timestamp
especificado.
somente prximo
Retorna o valor que segue o timestamp especificado.
horrio exato
Retorna apenas um valor que corresponde exatamente ao timestamp ou
retorna No events found se nenhum valor existe no timestamp.
Disponvel se voc selecionar a opo Item de dado.
especificada.
Sem timestamp Clique nessa opo para retornar somente valores. A funo retorna valores
em uma coluna para uma coluna de itens de dados ou expresses
referenciados, ou retorna valores em uma linha para uma linha de itens de
dados ou expresses referenciados.
Hora esquerda Clique nesta opo para retornar duas colunas: o timestamp na coluna
esquerda e o valor na coluna direita.
Hora na parte superior Clique nesta opo para retornar duas linhas: o timestamp na linha de cima e
o valor na linha de baixo.
Veja tambm...
PIArcVal()
Especificar itens de dado.
PIExpVal()

Especificar uma expresso.

Exemplo de Valor de Archive

Para ver o valor do ponto do PI sinusoid em um momento especfico, defina as seguintes
entradas para a funo Valor de Archive:
Entrada Valor
Timestamp 30-set-07 15:13
Modo de recuperao anterior
Tempo esquerda Selecionado
A funo retorna da seguinte matriz:

Se voc selecionar a opo Intervalo de tempo , a funo Dados compactados retorna todos
os valores de um ponto do PI ou atributo do PI AF, junto com uma contagem dos valores que
ocorreram durante um perodo especificado.
Se a opo Nmero de valores for selecionada, a funo Dados compactados retorna um
nmero especfico de valores de ponto ou atributo que iniciam em determinado horrio.
Nota:
Os valores armazenados no archive do PI Data Archive passam por um algoritmo de
compresso que remove todos os valores que representam a mesma inclinao. Os
valores armazenados no instantneo do PI Data Archive no foram submetidos a este
algoritmo de compresso. Se o momento atual for especificado no perodo da funo
Dados compactados, a funo retornar o valor instantneo para aquele momento. Este
valor instantneo pode no ser armazenado posteriormente no arquivo devido
compresso.
Entrada Descrio
Archive padro.
Veja Itens de dado.

Entrada Descrio
Requerido.
Hora inicial O incio do perodo para o qual a funo retorna valores. Veja Entradas de
tempo.
Requerido.
Horrio final O final do perodo para o qual a funo retorna valores.
Requerido se voc selecionar a opo Intervalo de Tempo.
Nmero de valores O nmero de valores que a funo retorna, comeando em Hora inicial.
Requerido se voc selecionar a opo Nmero de valores.
Anterior no tempo Selecione essa caixa de seleo para retornar valores registrados em Hora
inicial e anteriormente. Disponvel se voc selecionar a opo Nmero de
valores e entrar um valor no campo Nmero de valores.
Se uma referncia de clula for inserida no campo Nmero de valores, essa
caixa de seleo ser desativada. Em vez disso, digite um nmero negativo na
clula referenciada para ter o mesmo efeito.
Expresso de filtro Uma Performance Equation lgica usada pela funo para filtrar valores.
Quando o resultado da expresso falso, a funo exclui os valores
correspondentes. Veja Expresses de filtro.
Marcar como filtrado Marque esta caixa de seleo para inserir o rtulo Filtered no lugar de um
valor ou bloco de valores filtrados pela funo na sada com base na
Expresso de filtro.
Tipo de limite O mtodo que a funo usa para determinar quais valores sero retornados
prximo da hora inicial ou final:
dentro(padro)
Retorna valores na hora de incio e no tempo final, caso existam, ou os
valores mais prximos que ocorrem no intervalo.
externo
Retorna os valores mais prximos que ocorrem imediatamente fora do
intervalo.
interpolado
Retorna valores interpolados na hora de incio e no tempo final.
auto
Retorna valores interpolados, mas usa o mtodo inside para itens de
dado com atributos de etapas.

Entrada Descrio
especificada.
Ocultar contagem Marque essa caixa de verificao para ocultar a contagem de valores
retornados e mostrar apenas os valores retornados. Disponvel se voc
selecionar a opo Intervalo de tempo.
Mostrar timestamps Marque essa caixa de seleo para mostrar o timestamp que corresponde a
cada valor retornado. O PI DataLink mostra os timestamps esquerda dos
valores exibidos em uma coluna ou acima dos valores exibidos em uma linha.
Exibir bits de qualidade Marque essa caixa de verificao para mostrar os bits de estado estendido
associados aos valores retornados. Bits de status possveis incluem:
A
Anotado. Indica que h um comentrio no valor.
S
Substitudo. Indica que o valor foi alterado de seu valor originalmente
gravado.
Q
Questionvel. Indica que h um motivo para dvida quanto preciso do
valor.
O PI DataLink exibe os bits de qualidade em uma coluna direita dos valores.
Mostrar anotaes Marque essa caixa de verificao para mostrar anotaes associadas aos
valores retornados. Anotaes contm notas ou comentrios que descrevem
um valor de dados. O PI DataLink mostra as anotaes em uma coluna
direita do valor.
Coluna Clique nessa opo para retornar os valores em uma coluna.
Linha Clique nesta opo para retornar os valores em uma linha.
Nota:
Se voc especificar um intervalo de itens em Item(ns) de dado(s) ou
uma srie de expresses em Expresso(es), o PI DataLink seleciona
automaticamente Coluna ou Linha para corresponder orientao do
intervalo especificado.
Veja tambm...
PICompDat()
Especifica um intervalo de tempo sem uma expresso de filtro.
PICompFilDat()
Especifica o intervalo de tempo com uma expresso de filtro.
PINCompDat()

Especifica um nmero de valores sem uma expresso de filtro.

PINCompFilDat()
Especifica um nmero de valores com uma expresso de filtro.
Exemplo de Dados compactados

Para ver os 10 valores mais recentes do ponto do PI sinusoid, defina as seguintes entradas na
funo Dados compactados:
Entrada Valor
Nmero de valores Selecionado
Hora de incio $A$10 (pressupondo que a clula A-10 tenha o
tempo atual)
Nmero de valores 10
Voltar no tempo Selecionado
Tipo de limite dentro
Mostrar timestamps Selecionado
Coluna Selecionado
Observe que possvel selecionar a opo Intervalo de tempo e especificar a Hora de incio e o
Tempo final apropriados para retornar os mesmos valores.

Ao selecionar a opo Item de dado, a funo Dados de Amostragem retorna valores
interpolados, uniformemente espaados, para um ponto do PI ou atributo do PI AF a
intervalos regulares.
Ao selecionar a opo Expresso, a funo Dados de Amostragem retorna valores
interpolados, uniformemente espaados, de uma Performance Equation ao longo de um
intervalo regular.

Entrada Descrio
Archive padro.
Veja Itens de dado.
Veja Expresses.
retornados valores.
tempo.
Requerido.
Requerido.
Intervalo de tempo A frequncia de amostragem utilizada para calcular os valores durante o
perodo. Insira um valor e uma unidade de tempo. Por exemplo, insira 15m
(15 minutos) para retornar um valor para cada intervalo de 15 minutos
durante o perodo. Veja Especificao de intervalo de tempo.
Requerido.
Marcar como filtrado Marque esta caixa de seleo para inserir o rtulo Filtered no lugar de um
valor ou bloco de valores filtrados pela funo na sada com base na
Expresso de filtro.
especificada.
Mostrar timestamps Marque essa caixa de seleo para mostrar o timestamp que corresponde a
cada valor retornado. O PI DataLink mostra os timestamps esquerda dos
valores exibidos em uma coluna ou acima dos valores exibidos em uma linha.

Entrada Descrio
Nota:
Veja tambm...
PISampDat()
Especifica um item de dado sem uma expresso de filtro.
PISampFilDat()
Especificar um item de dados sem uma expresso de filtro.
PIExpDat()
Exemplo de Dados de amostragem

Para ver valores interpolados peridicos nas ltimas 24 horas para o ponto do PI sinusoid,
defina as seguintes entradas para a funo de Dados de amostragem:
Entrada Valor
Hora de incio -1d
Tempo final $A$10 (pressupondo que a clula A-10 tenha o
tempo atual)
Intervalo de tempo 3h
Mostrar timestamps Selecionado
Coluna Selecionado
A matriz contm um valor para cada intervalo de 3 horas.


Ao selecionar a opo Item de dado, a funo Dados Temporizados retorna valores reais ou
de amostragem interpolada para um ponto do PI ou atributo do PI AF nos timestamps
especificados.
Ao selecionar a opo Expresso, a funo Dados Temporizados retorna valores de uma
Performance Equation calculados em timestamps especificados.
Entrada Descrio
Archive padro.
Veja Itens de dado.
Veja Expresses.
retornados valores.
Timestamp(s) Os horrios para os quais a funo retorna valores. Insira um timestamp ou

uma referncia a uma ou mais clulas da planilha que contm valores de
timestamp.
Requerido.
Modo de recuperao O mtodo usado pela funo para recuperar dados:
interpolado
Retorna valores interpolados que correspondem aos timestamps
especificados. Para os itens de dado com os atributos de etapa, recupera o
valor que precede o timestamp especificado.
horrio exato
Retorna apenas os valores que correspondem exatamente aos
timestamps; retorna No events found se no houver nenhum valor.
Disponvel se voc selecionar a opo Item de dado.

Entrada Descrio
especificada.
Veja tambm...
PITimeDat()
Especifica um item de dado.
PITimeExpDat()
Exemplo de Dados temporizados

Para ver os valores que correspondem a uma matriz de timestamps para o ponto do PI
sinusoidu, defina as seguintes entradas para a funo de Dados temporizados:
Entrada Valor
Item(ns) de dados sinusoidu
Timestamps $A$3..$A$12 (clulas A-3 a A-12 contm os
timestamps de uma matriz de dados compactados)
Modo de recuperao interpolado
A funo retorna a seguinte matriz de dados temporizados na coluna direita:
A matriz de dados temporizados baseada nos timestamps da primeira coluna.


Se a opo Item de dado for selecionada, a funo Dados calculados retornar um ou mais
valores calculados e uniformemente espaados, baseados no ponto do PI ou valores de
atributos do PI AF e nas preferncias de clculo especificadas. Se voc no especificar
expresso de filtro e intervalo de tempo, a funo suportar chamadas em lote.
Se a opo Expresso for selecionada, a funo Dados calculados retornar um ou mais
valores calculados e uniformemente espaados, baseados em uma Performance Equation
avaliada e nas preferncias de clculo especificadas.
Nota:
Clique em + ao lado de Avanado para acessar todas as entradas da funo.
Entrada Descrio
Archive padro.
Veja Itens de dado.
Veja Expresses.
retornados valores.
tempo.
Requerido.
Requerido.

Entrada Descrio
Fator de converso Um fator que a funo aplica aos valores retornados. Insira 1 se um fator de
converso no for necessrio. Nos clculo de tempo ponderado total,
especifique um fator que converta os valores da taxa gravada em unidade de
tempo padro do servidor (unidades por dia).
Requerido.
Por exemplo, os fatores de converso comuns incluem:
1,0 para valores que armazenam unidades/dia
24 para valores que armazenam unidades/hora
1440 para valores que armazenam unidades/minuto
86400 para valores que armazenam unidades/segundo
Modo de clculo O tipo de clculo que a funo executa:
total
Soma os valores no intervalo.
mnimo
Encontra o valor mnimo no intervalo.
mximo
Encontra o valor mximo no intervalo.
desvio padro
Calcula o desvio padro dos valores no intervalo.
intervalo
Calcula o valor mximo menos o valor mnimo no intervalo.
mdia
Calcula a mdia dos valores gravados no intervalo usando o mtodo
especificado no campo Base de clculo. Por padro, um clculo
ponderado no tempo.
contagem
Conta o nmero de valores armazenados no intervalo.
mediana
Calcula a mdia ponderada em evento dos valores gravados no intervalo,
independentemente do mtodo especificado no campo Base de clculo.
Base de clculo O mtodo de clculo:
tempo ponderado
Padro. A funo pondera cada valor de gravado pelo comprimento de
tempo em que o valor aplicado. Em todos os modos de clculo, exceto
mdia, a funo interpola valores nos limites do intervalo.
ponderado em eventos
A funo pondera cada valor gravado igualmente. Selecione esta opo
para valores de lote. Este mtodo requer pelo menos um valor gravado em
um perodo (dois eventos para valores dos clculos de desvio padro).

Entrada Descrio
Amostragem da O mtodo usado pela funo para determinar quando avaliar uma expresso:
expresso compactado
A funo avalia a expresso durante o perodo nos timestamps em que os
pontos do PI ou os atributos do PI AF na expresso tm valores
armazenados.
interpolado
A funo avalia a expresso em intervalos de amostragem uniformemente
especados, determinados pela Frequncia de amostragem da expresso.
Disponvel se voc selecionar Expresso ou se voc especificar uma
Expresso de filtro.
Frequncia de A freqncia na qual a funo avalia uma expresso. Requerido se voc

amostragem da definir Expresso de amostragem como interpolado.
expresso
Por exemplo, defina como 10m (10 minutos) para retornar um valor
interpolado para cada intervalo de 10 minutos.
Mnimo percentual bom O percentual mnimo de dados bons necessrios em cada intervalo de tempo
para calcular e retornar um valor para o intervalo. A funo retorna o rtulo
Insufficient good data para um intervalo que no atenda a esse
percentual.
especificada.
Mostrar hora inicial Marque essa caixa de seleo para mostrar a hora inicial do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora de
incio em uma coluna esquerda ou em uma linha acima dos valores
retornados. Disponvel apenas ao especificar Intervalo de tempo.
Mostrar hora final Marque essa caixa de seleo para mostrar a hora final do intervalo de tempo
usado para calcular o valor retornado. O PI DataLink mostra o tempo final em
uma coluna esquerda ou em uma linha acima dos valores retornados.
Disponvel apenas ao especificar Intervalo de tempo.
Mostrar hora mn./mx. Marque essa caixa de verificao para mostrar o horrio que corresponde ao
valor mnimo ou mximo, durante o intervalo utilizado para calcular o valor.
Disponvel apenas para trs valores de Modo de clculo:
mximo
Mostra o timestamp do valor mximo.
mnimo
Mostra o timestamp do valor mnimo.
intervalo
Mostra os timestamps dos valores mnimo e mximo.

Entrada Descrio
Mostrar percentual bom Marque esta caixa de seleo para mostrar o percentual de tempo em que
bons valores so retornados durante o perodo da matriz. O PI DataLink
mostra o percentual de bons valores em uma coluna direita ou em uma
linha abaixo dos valores retornados.
Valores bons so valores gravados que o PI Data Archive determinou serem
vlidos e que no esto em um estado de erro. possvel usar o percentual de
bons valores para avaliar a confiabilidade dos clculos criados com base nos
valores dos pontos do PI, especialmente se os valores obtidos em outros
clculos forem usados.
Por exemplo, se um intervalo de tempo inclui dados com erro, o total
resultante ponderado no tempo igual ao total dividido pela frao do
intervalo em que bons valores esto disponveis. Esta normalizao assume
que a mdia durante o perodo com dados com erro equivalente ao valor
mdio ao longo de todo o perodo. Dessa forma, a mdia torna-se menos
confivel se uma grande parcela do perodo contm dados invlidos.
Nota:
Veja tambm...
PIAdvCalcVal()
Especifica um item de dado para recuperar um nico valor
PIAdvCalcFilVal()
Especifica um item de dado e uma expresso de filtro para recuperar um nico valor
PIAdvCalcExpVal()
Especifica uma expresso para recuperar um nico valor
PIAdvCalcExpFilVal()
Especifica uma expresso e uma expresso de filtro para recuperar um nico valor
PIAdvCalcDat()
Especifica um item de dado e um intervalo de tempo para recuperar vrios valores
PIAdvCalcFilDat()
Especifica um item de dado, um intervalo de tempo e uma expresso de filtro para
recuperar vrios valores
PIAdvCalcExpDat()
Especifica uma expresso e um intervalo de tempo para recuperar vrios valores
PIAdvCalcExpFilDat()
Especifica uma expresso, um intervalo de tempo e uma expresso de filtro para recuperar
vrios valores

Exemplo de Dados calculados

Para ver o intervalo de tempo dos valores da meia-noite de hoje hora atual do ponto do PI
sinusoid, configure as seguintes entradas para a funo Dados calculados:
Entrada Valor
Hora de incio t
Tempo final *
Intervalo de tempo 1h
Mdulo de clculo intervalo
Base de clculo ponderado pelo tempo
Mostrar hora inicial selecionado
Mostrar hora final selecionado
Coluna selecionado
Neste exemplo, a funo calcula o intervalo de cada intervalo de uma hora. Pode-se especificar
qualquer clculo disponvel em qualquer intervalo.
Funo Tempo Filtrado

A funo Tempo Filtrado retorna a quantidade de tempo em que uma Performance Equation
avaliada como true durante um perodo especificado.
Nota:
Os resultados da funo Tempo Filtrado variam um pouco dependendo da verso do seu
PI Data Archive.

Entrada Descrio
Archive padro.
Veja Itens de dado.
Expresso(es) Uma Performance Equation lgica avaliada pela funo. Veja Expresses.
retornados valores.
Requerido.
tempo.
Requerido.
Requerido.
Unidades de tempo As unidades de tempo nas quais a funo retorna o resultado.
Requerido.
especificada.
Mostrar hora inicial Marque essa caixa de seleo para mostrar a hora inicial do intervalo de
tempo usado para calcular o valor retornado. O PI DataLink mostra a hora de
incio em uma coluna esquerda ou em uma linha acima dos valores
retornados. Disponvel apenas ao especificar Intervalo de tempo.
Mostrar hora final Marque essa caixa de seleo para mostrar a hora final do intervalo de tempo
usado para calcular o valor retornado. O PI DataLink mostra o tempo final em
uma coluna esquerda ou em uma linha acima dos valores retornados.
Disponvel apenas ao especificar Intervalo de tempo.

Entrada Descrio
Mostrar percentual bom Marque esta caixa de seleo para mostrar o percentual de tempo em que
bons valores so retornados durante o perodo da matriz. O PI DataLink
mostra o percentual de bons valores em uma coluna direita ou em uma
linha abaixo dos valores retornados.
Valores bons so valores gravados que o PI Data Archive determinou serem
vlidos e que no esto em um estado de erro. possvel usar o percentual de
bons valores para avaliar a confiabilidade dos clculos criados com base nos
valores dos pontos do PI, especialmente se os valores obtidos em outros
clculos forem usados.
Por exemplo, se um intervalo de tempo inclui dados com erro, o total
resultante ponderado no tempo igual ao total dividido pela frao do
intervalo em que bons valores esto disponveis. Esta normalizao assume
que a mdia durante o perodo com dados com erro equivalente ao valor
mdio ao longo de todo o perodo. Dessa forma, a mdia torna-se menos
confivel se uma grande parcela do perodo contm dados invlidos.
Nota:
Se voc especificar um intervalo de itens em Expresso(es), o PI
DataLink seleciona automaticamente Coluna ou Linha para
corresponder orientao dos itens.
Veja tambm...
PITimeFilterVal()
Retorna um valor nico.
PITimeFilter()
Especificar um intervalo de tempo e retornar vrios valores.
Exemplo de Tempo Filtrado

Para ver o nmero de horas em que o valor do ponto do PI sinusoid excedeu 75 durante os
ltimos sete dias, defina as seguintes entradas para a funo Tempo Filtrado:
Entrada Valor
Expresso 'sinusoid' > 75
Hora de incio -7d
Tempo final *
Unidades de tempo h
Mostrar porcentagem boa Selecionado
Coluna Selecionado

Neste exemplo, a funo calcula que o valor sinusoid excedeu 75 por 7,85 horas durante os 7
dias anteriores e 100 por cento dos valores foram bons durante esse perodo.
Funo Explorar eventos

A funo Explorar eventos retorna eventos que atendam a critrios especficos em um banco
de dados do PI AF. Use a funo Explorar eventos para visualizar e explorar os eventos em um
formato hierrquico. A funo retorna um evento por linha.
Use os campos na parte superior do painel de tarefas Explorar eventos para especificar quais
eventos do PI AF deseja-se recuperar. Aps a especificao dos critrios dos eventos, a lista
Visualizar do painel de tarefas mostra os eventos correspondentes. Modifique os critrios para
ajustar os eventos correspondentes antes de inserir a matriz da funo na planilha. Use os
campos na parte inferior do painel de tarefas para especificar as colunas a serem includas e a
posio da matriz da funo inserida.
Para obter mais detalhes, consulte os seguintes tpicos:
Eventos na planilha
O PI DataLink pode exibir dados dos eventos do PI AF com a funo Explorar eventos ou
Comparar eventos.
Siga este procedimento para usar a funo Explorar eventos para analisar os eventos
relacionados a determinado elemento do PI AF.
Siga este procedimento para usar a funo Explorar eventos para analisar eventos com
eventos filho.
Referncia do painel de tarefas Explorar eventos
Os campos no painel de tarefas permitem especificar os eventos a serem recuperados e as
colunas e os dados a serem retornados para a planilha.
Para evitar conflitos com atributos gerados automaticamente, no defina os eventos que
usem nomes de atributo reservados.
Exemplo Explorar eventos
Configure as entradas da funo Explorar eventos para ver os eventos ativos no ltimo ms
e baseados em determinado template.
Use a janela Configuraes para definir o nmero mximo de eventos retornados pela
funo.
Referncia do painel de tarefas Explorar eventos

A funo Explorar eventos retorna eventos em um formato hierrquico. Uma configurao de
preferncia limita o nmero de eventos recuperados na lista Visualizar e retornados para a
planilha.
Nota:
Expanda Mais opes de pesquisa para acessar todas as entradas da funo.

Entrada Descrio
Banco de dados O banco de dados do PI AF pelo qual a funo retorna eventos. Especifique no
formato \\ServerName\DatabaseName. Clique no campo para ver uma lista
de bancos de dados contendo os templates de evento nos PI AF Servers
conectados. Especifique o banco de dados antes de a funo encontrar
quaisquer eventos correspondentes.
Incio da pesquisa Uma expresso de tempo do PI que especifica a hora em que a funo comea
a pesquisar eventos no banco de dados. Por exemplo, especifique *-12h para
pesquisar eventos nos registros do banco de dados, de 12 horas atrs.
Trmino da pesquisa Uma expresso de tempo do PI que especifica a hora em que a funo para de
pesquisar eventos no banco de dados. Por exemplo, especifique * para
pesquisar eventos at a hora atual.
Limitar a nvel do banco Marque esta caixa de seleo apenas para pesquisar eventos correspondentes
de dados no nvel raiz do banco de dados. Se essa caixa de seleo for desmarcada, a
funo pesquisar eventos correspondentes em qualquer nvel da hierarquia.
Nome do evento O nome dos eventos correspondentes. Nomes parciais podem ser
especificados com caracteres curingas.
Template de evento Um template de evento dos eventos correspondentes. Observe que se um
template de evento base for selecionado, a funo incluir eventos de
templates derivados.
Ao selecionar um template de evento, a lista Colunas a serem exibidas
atualizada para refletir os atributos no template selecionado. A atualizao
remove os atributos anteriormente inseridos.
Nome do elemento Um elemento do PI AF referenciado pelos eventos correspondentes. Nomes
parciais podem ser especificados com caracteres curingas.
Template de elemento Um template de elemento de um elemento referenciado por eventos
correspondentes. Observe que se um template de elemento base for
selecionado, a funo incluir eventos que referenciam elementos de
O PI AF Server verso 2.6 ou posteriores necessrio para filtrar os
templates de elemento.
Categoria de evento A categoria dos eventos correspondentes.
Durao mnima A durao mnima dos eventos correspondentes. Especifique um valor e uma
abreviao de unidade de tempo.
Durao mxima A durao mxima dos eventos correspondentes. Especifique um valor e uma

Entrada Descrio
Modo de pesquisa O mtodo que a funo usa para encontrar os eventos correspondentes
relativos ao perodo especificado pelo incio e trmino da pesquisa.
ativo no intervalo
Encontra eventos ativos em qualquer momento durante o perodo
especificado.
totalmente no intervalo
Encontra eventos que iniciam e terminam durante o perodo especificado.
iniciando no intervalo
Encontra eventos que iniciam no perodo especificado e terminam
durante ou aps o perodo especificado.
terminando no intervalo
Encontra eventos que terminam no perodo especificado e iniciam antes
ou durante o perodo especificado.
em andamento
Encontra eventos que iniciam no perodo especificado, mas que ainda no
foram concludos. Apenas disponvel no PI AF Server verso 2.6 ou
posteriores.
Ordem de classificao O mtodo usado pela funo para classificar eventos correspondentes:
ascendente do nome
Classifica eventos por nome do evento, de A a Z.
descendente do nome
Classifica eventos por nome do evento, de Z a A.
ascendente do horrio de incio

Classifica eventos por hora de incio, do mais antigo para o mais novo.
descendente do horrio de incio

Classifica eventos por hora de incio, do mais novo para o mais antigo.
ascendente do horrio de trmino

Classifica eventos por tempo final, do mais antigo para o mais novo.
descendente do horrio de trmino

Classifica eventos por tempo final, do mais novo para o mais antigo.

Entrada Descrio
Filtros de valores do At cinco condies de atributo usadas pela funo para filtrar os eventos
atributo correspondentes.
Nota:
Deve-se especificar um template de evento antes de especificar um
filtro de valores do atributo.
Para cada filtro, especifique:
Atributo
Um atributo do evento no qual a funo filtra os eventos correspondentes.
Os atributos disponveis dependem do template de evento selecionado.
Operador
O operador relacionado aplicado pela funo ao valor do atributo
especificado. Os operadores disponveis dependem do tipo de dados do
atributo.
Valor
O valor usado pela funo para pesquisar atributos correspondentes. Por
exemplo, se o campo Operador for configurado para =, a funo limitar
eventos aos campos com o atributo especificado igual a esse valor.
Colunas a serem As colunas na matriz da funo retornada. A lista contm os nomes dos
exibidas atributos. Por padro, a lista inclui os atributos virtuais gerados em todos os
eventos e os atributos de evento do template de evento selecionado. Pode-se:
Marcar a caixa de seleo Selecionar tudo para incluir todos os atributos
listados como colunas na matriz da funo retornada.
Marcar uma caixa de seleo para incluir o atributo ou desmarque um
para excluir um atributo como uma coluna na matriz da funo retornada.
Clique em para abrir a janela Adicionar atributos, na qual possvel
adicionar outros atributos a serem includos como colunas na matriz da

funo. Veja Adicionar colunas de atributos ao painel de tarefas Explorar
eventos.
Digitar o nome de um atributo de evento ao lado da caixa de seleo
desmarcada na parte inferior da lista.
Clicar com o boto direito do mouse em um atributo, clicar em Inserir
atributo para inserir um atributo vazio acima do atributo selecionado e
digitar o nome de um atributo de evento.
Selecionar um atributo e clicar em para mover o atributo para cima
na lista.
Selecionar um atributo e clique em para mover o atributo para baixo
na lista.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir

atributo para remover o atributo da lista.
Nmero de nveis do O nmero de nveis de eventos filho cuja funo est includa na matriz da
evento filho funo. Os eventos filho no precisam corresponder aos critrios
especificados. A funo retorna cada evento filho em uma linha separada e
adiciona outra coluna a cada nvel retornado. Nas linhas contendo eventos
filho, a coluna adicionada contm o nome do evento filho.

Entrada Descrio
especificada.
Veja tambm
Eventos na planilha
Adicionar colunas de atributos ao painel de tarefas Explorar eventos
Exemplo Explorar eventos

Para ver os eventos baseados nos template de evento PowerPlantShutDown no banco de
dados Production no PI AF Server AFSRV1 e ativos no ltimo ms, configure as seguintes
entradas na funo Explorar eventos:
Entrada Valor
Banco de dados \\AFSRV1\Production
Incio da pesquisa *-1mo
Trmino da pesquisa *
Template de evento PowerPlantDownTime
A funo retorna as seguinte matriz:

A funo Comparar eventos retorna eventos que atendam a critrios especficos em um banco
de dados do PI AF. Use a funo Comparar eventos para visualizar os eventos em um formato
simples. A funo retorna um evento por linha, mas pode retornar atributos de eventos
relacionados na mesma linha. De forma especfica, para facilitar a comparao de eventos, a
funo pode retornar atributos de eventos filho ou pai na mesma linha do evento retornado.
Use os campos na parte superior do painel de tarefas Comparar eventos para especificar quais
eventos do PI AF deseja-se recuperar. Aps a especificao dos critrios de pesquisa dos
eventos, a lista Visualizar do painel de tarefas mostra os eventos correspondentes. Modifique
os critrios para ajustar os eventos correspondentes antes de inserir a matriz da funo na
planilha. Use os campos na parte inferior do painel de tarefas para especificar as colunas a
serem includas e a posio da matriz da funo inserida.


Eventos na planilha
O PI DataLink pode exibir dados dos eventos do PI AF com a funo Explorar eventos ou
Comparar eventos.
Siga estes procedimentos para usar a funo Comparar eventos para comparar eventos com
eventos filhos contendo os mesmos nomes.
Siga este procedimento para usar a funo Comparar eventos para comparar eventos com
hierarquias correspondentes quando os eventos filho tm nomes diferentes.
Referncia do painel de tarefas Comparar eventos
Os campos no painel de tarefas permitem especificar os eventos a serem recuperados e as
colunas e os dados a serem retornados para a planilha.
Notao de caminho para a funo Comparar eventos
Use a notao de caminho especfica nos nomes do atributo para designar o local na
hierarquia de eventos.
Para evitar conflitos com atributos gerados automaticamente, no defina os eventos que
usem nomes de atributo reservados.
Exemplo de Comparar eventos
Configure as entradas da funo Comparar eventos para comparar os eventos de alerta de
temperatura.
Use a janela Configuraes para definir o nmero mximo de eventos retornados pela
funo.
Referncia do painel de tarefas Comparar eventos

A funo Comparar eventos retorna eventos em um formato simples. Uma configurao de
preferncia limita o nmero de eventos recuperados na lista Visualizar e retornados para a
planilha.
Nota:
Clique em + ao lado de Mais opes de pesquisa para acessar todas as entradas da funo.
Entrada Descrio
Banco de dados O banco de dados do PI AF pelo qual a funo retorna eventos. Especifique no
formato \\ServerName\DatabaseName. Clique no campo para ver uma lista
de bancos de dados contendo os templates de evento nos PI AF Servers
conectados. Especifique o banco de dados antes de a funo encontrar
quaisquer eventos correspondentes.
Incio da pesquisa Uma expresso de tempo do PI que especifica a hora em que a funo comea
a pesquisar eventos no banco de dados. Por exemplo, especifique *-12h para
pesquisar eventos nos registros do banco de dados, de 12 horas atrs.
Trmino da pesquisa Uma expresso de tempo do PI que especifica a hora em que a funo para de
pesquisar eventos no banco de dados. Por exemplo, especifique * para
pesquisar eventos at a hora atual.

Entrada Descrio
Limitar a nvel do banco Marque esta caixa de seleo apenas para pesquisar eventos correspondentes
de dados no nvel raiz do banco de dados. Se essa caixa de seleo for desmarcada, a
funo pesquisar eventos correspondentes em qualquer nvel da hierarquia.
Nome do evento O nome dos eventos correspondentes. Nomes parciais podem ser
especificados com caracteres curingas.
Template de evento Um template de evento dos eventos correspondentes. Observe que se um
template de evento base for selecionado, a funo incluir eventos de
Ao selecionar um template de evento, a lista Colunas a serem exibidas
atualizada para refletir os atributos no template selecionado. A atualizao
remove os atributos anteriormente inseridos.
Nome do elemento Um elemento do PI AF referenciado pelos eventos correspondentes. Nomes
parciais podem ser especificados com caracteres curingas.
Template de elemento Um template de elemento de um elemento referenciado por eventos
correspondentes. Observe que se um template de elemento base for
selecionado, a funo incluir eventos que referenciam elementos de
O PI AF Server verso 2.6 ou posteriores necessrio para filtrar os
templates de elemento.
Categoria de evento A categoria dos eventos correspondentes.
Durao mnima A durao mnima dos eventos correspondentes. Especifique um valor e uma
Durao mxima A durao mxima dos eventos correspondentes. Especifique um valor e uma
Modo de pesquisa O mtodo que a funo usa para encontrar os eventos correspondentes
relativos ao perodo especificado pelo incio e trmino da pesquisa.
ativo no intervalo
Encontra eventos ativos em qualquer momento durante o perodo
especificado.
totalmente no intervalo
Encontra eventos que iniciam e terminam durante o perodo especificado.
iniciando no intervalo
Encontra eventos que iniciam no perodo especificado e terminam
durante ou aps o perodo especificado.
terminando no intervalo
Encontra eventos que terminam no perodo especificado e iniciam antes
ou durante o perodo especificado.
em andamento
Encontra eventos que iniciam no perodo especificado, mas que ainda no
foram concludos. Apenas disponvel no PI AF Server verso 2.6 ou
posteriores.

Entrada Descrio
Ordem de classificao O mtodo usado pela funo para classificar eventos retornados:
ascendente do nome
Classifica eventos por nome do evento, de A a Z.
descendente do nome
Classifica eventos por nome do evento, de Z a A.
ascendente do horrio de incio

Classifica eventos por hora de incio, do mais antigo para o mais novo.
descendente do horrio de incio

Classifica eventos por hora de incio, do mais novo para o mais antigo.
ascendente do horrio de trmino

Classifica eventos por tempo final, do mais antigo para o mais novo.
descendente do horrio de trmino

Classifica eventos por tempo final, do mais novo para o mais antigo.
Filtros de valores do At cinco condies de atributo usadas pela funo para filtrar os eventos
atributo correspondentes.
Nota:
Deve-se especificar um template de evento antes de especificar um
filtro de valores do atributo.
Para cada filtro, especifique:
Atributo
Um atributo do evento no qual a funo filtra os eventos correspondentes.
Os atributos disponveis dependem do template de evento selecionado.
Operador
O operador relacionado aplicado pela funo ao valor do atributo
especificado. Os operadores disponveis dependem do tipo de dados do
atributo.
Valor
O valor usado pela funo para pesquisar atributos correspondentes. Por
exemplo, se o campo Operador for configurado para =, a funo limitar
eventos aos campos com o atributo especificado igual a esse valor.

Entrada Descrio
Colunas a serem As colunas na matriz da funo retornada. A lista contm os nomes dos
exibidas atributos. Por padro, a lista inclui os atributos virtuais gerados em todos os
eventos e os atributos de evento do template de evento selecionado. A funo
inclui o caminho dos atributos; a funo identifica atributos exclusivos pelo
nome e pela posio na hierarquia. Pode-se:
Marcar a caixa de seleo Selecionar tudo para incluir todos os atributos
listados como colunas na matriz da funo retornada.
Marcar uma caixa de seleo para incluir o atributo ou desmarque um
para excluir um atributo como uma coluna na matriz da funo retornada.
Clique em para abrir a janela Adicionar atributos, na qual possvel
adicionar outros atributos a serem includos como colunas na matriz da

funo. Veja Adicionar atributos de evento filho como colunas no painel
de tarefas Comparar eventos.
Clicar com o boto direito do mouse em um atributo e clicar em Clonar
para evento pai para inserir o atributo do evento pai como uma coluna na
matriz da funo. Veja Adicionar atributos de evento pai como colunas no
painel de tarefas Comparar eventos.
Digitar o nome de um atributo de evento ao lado da caixa de seleo
desmarcada na parte inferior da lista.
Clicar com o boto direito do mouse em um atributo, clicar em Inserir
atributo para inserir um atributo vazio acima do atributo selecionado e
digitar o nome de um atributo de evento.
Selecionar um atributo e clicar em para mover o atributo para cima
na lista.
Selecionar um atributo e clique em para mover o atributo para baixo
na lista.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir

atributo para remover o atributo da lista.
especificada.
Veja tambm
Eventos na planilha
Adicionar atributos de evento filho como colunas no painel de tarefas Comparar eventos

Notao de caminho para a funo Comparar eventos

A funo Comparar eventos identifica os atributos por caminho, portanto, os nomes dos
atributos sempre devem incluir informaes do caminho, especificamente relativo ao evento
correspondente mostrado em cada linha. Ao especificar atributos, use a notao que designa o
local apropriado na hierarquia de eventos.
Notao de caminho com suporte
Notao Descrio
.|A1 O atributo A1 do evento correspondente.
..|A1 O atributo A1 do evento pai do evento correspondente.
..\..|A1 O atributo A1 do evento av do evento correspondente.
.\E1|A1 O atributo A1 do evento filho E1 do evento correspondente.
Pode-se combinar a notao para designar ainda mais os atributos da hierarquia. Por exemplo,
pode-se especificar o atributo Duration para diferentes eventos na hierarquia:
Evento bisav: ..\..\..|Duration
Evento correspondente: .|Duration
Evento filho chamado Phase1: .\Phase1|Duration
Exemplo de Comparar eventos

Para ver os atributos dos eventos filho em um formato que permite a comparao fcil dos
eventos pai, use a funo Comparar eventos. Suponha que haja eventos de alerta de
temperatura e que cada um tenha um nico evento filho que indique que uma ameaa de
temperatura quando a temperatura da bomba atinge determinado nvel. Pode-se recuperar a
matriz da funo que mostra a hora de incio,a durao e a temperatura gravada para o evento
de ameaa de temperatura armazenado em cada evento de alerta de temperatura. Os eventos
pai tm nomes que iniciam com TempAlert, e os eventos filhos so chamados de TempThreat.
Para recuperar a matriz da funo dos eventos armazenados na ltima semana no banco de
dados Production no PI AF Server AFSRV1, insira as seguintes entradas:
Entrada Valor
Banco de dados \\AFSRV1\Production
Incio da pesquisa *-1w
Trmino da pesquisa *
Nome do evento TempAlert*
Cabealhos da coluna Selecione:
Nome do evento
.|Hora de incio
.|Tempo final
.|Durao
.|Evento primrio
.\TempThreat|Hora de incio*
.\TempThreat|Durao*
.\TempThreat|Temperatura*
*Adicionado lista pela janela Adicionar atributos.


A funo Pesquisa do Filtro de Ativos retorna ativos (ou seja, elementos ou atributos do PI AF)
que atendam a critrios especficos. Os critrios incluem o nome do elemento, o template de
elemento, a categoria do elemento e a descrio do elemento, assim como o valor dos atributos.
Os ativos retornados podem ser inseridos nas pastas de trabalho como valores estticos ou
uma matriz da funo.
Use os campos na parte superior do painel de tarefas Pesquisa do Filtro de Ativos para
especificar qual elemento do PI AF deseja-se recuperar. Use os campos na parte inferior do
painel de tarefas para especificar os atributos a serem recuperados, o formato da sada e a
posio.
Pesquisas
possvel pesquisar itens de dados usando a ferramenta Pesquisar ou a funo Pesquisa do
Filtro de Ativos.
Siga esse procedimento para usar a funo Pesquisa do Filtro de Ativos para especificar os
elementos a serem recuperados e a sada para a planilha.
Use a janela Configuraes para definir o nmero mximo de elementos e atributos
retornados pela funo.
Funo Propriedades
A funo Propriedades retorna o valor da propriedade de um item de dados especificado.
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados. As entradas vlidas
incluem:
Archive padro.
Veja Itens de dado.
Item(ns) de dados Um ou mais nomes do ponto do PI ou do atributo do PI AF para os quais a
funo retorna valores de propriedade.
Referncia a um intervalo de clulas que contm nomes dos pontos do PI ou
do atributos do PI AF para os quais sero exibidos valores. Por padro, o PI
DataLink escreve os valores em linhas para uma coluna de itens de dados
referenciados e nas colunas para uma linha de itens de dados referenciados.

Entrada Descrio
Propriedade A propriedade para a qual a funo retorna valores. As propriedades listadas
dependem do item de dados inserido:
Ponto do PI nico. A lista contm os atributos de ponto da classe de ponto
do ponto inserido.
Nota:
Essa lista substitui udm por EngUnits. Selecione udm para ver o valor
do atributo do ponto EngUnits.
Atributo do PI AF nico. A lista contm quatro propriedades de atributo
do PI AF: categorias, descrio, udm e ponto do PI.
Referncia para vrias clulas. A lista depende do tipo do item de dados
na primeira clula referenciada:
Ponto do PI. A lista contm os atributos do ponto do PointClass desse
ponto.
Atributo do PI AF. A lista contm quatro propriedades de atributo do PI
AF: categories, description, udm e ponto do PI.
Se a lista estiver em branco, o PI DataLink no conseguir encontrar o item de
dados.
Selecione a propriedade desejada ou especifique uma referncia de clula
para uma clula que contenha a propriedade.
especificada.
Veja tambm
PITagAtt()
Exemplo de Propriedades
Para ver os valores dos atributos de alguns pontos do PI listados na planilha, defina as
seguintes entradas para a funo Propriedades:
Entrada Valor
Item de dados B3..B5 (matriz da clula contendo pontos)
Propriedade descrio

Nesse caso, os nomes de ponto esto em uma coluna esquerda. Uma funo Propriedades
diferente pode ser usada para visualizar atributos adicionais nas colunas subsequentes.

Uso e manuteno da planilha
Esta seo discute como as funes do PI DataLink trabalham com a planilha e como gerenciar
e manter sua planilha ao longo do tempo.
Nesta seo
Matrizes da funo
Frequncia de clculo
Compartilhamento de planilhas
Matrizes da funo
Uma matriz de funo um conjunto de clulas que contm a sada de uma nica funo do PI
DataLink. Ao adicionar uma funo a uma planilha, o PI DataLink insere a frmula da funo
nas clulas de sada especificadas. A funo consulta o servidor PI Data Archive ou PI AF Server
e retorna valores em uma matriz da funo. O tamanho da matriz depende da funo, do
nmero de valores correspondentes disponveis, do nmero de valores solicitadoss, e da sada
solicitada.
A planilha mostra os valores retornados nas clulas de uma matriz de funes. No entanto,
essas clulas contm, na realidade, a frmula da funo. Voc pode ver a frmula de funo na
barra de frmulas do Excel quando voc clica na clula.
1. Frmula da funo na barra de frmula

2. Retorna os valores em uma matriz de funo.
Nesta seo
Tarefas comuns de matrizes da funo
Atualizar as entradas para uma matriz da funo
Tamanho da matriz:
Redimensionar matrizes
Tarefas comuns de matrizes da funo

Matrizes da funo podem ser movidas, copiadas ou removidas de uma planilha.
Para selecionar uma matriz, escolha uma das seguintes opes:

Clique e arraste para selecionar cada clula da matriz. Observe que a matriz pode conter
clulas vazias, que tambm devem ser selecionadas.
Clique com o boto direito em qualquer parte da matriz e ento clique em Selecionar
Funo DataLink para selecionar todas as clulas na matriz.
Uma vez selecionada, ser possvel facilmente gerenciar a matriz.
Remova manualmente os caracteres $ iniciais na barra de frmulas para tornar as
referncias relativas.
Nota:
Aps fazer uma mudana na barra de frmulas, pressione Ctrl + Shift + Enter para
aplicar a mudana.
Clique com o boto da direita em qualquer clula na matriz e ento clique no comando
Cortar, Copiar, Excluir, Limpar ou Formatar desejado.
Clique com o boto da direita em uma nova clula e ento clique Colar para reinserir uma
matriz cortada ou copiada.
Coloque o ponteiro na borda de uma matriz selecionada, e quando o ponteiro se tornar um
ponteiro de movimento, arraste a matriz para uma nova clula para mov-la.
Nota:
Mova ou limpe toda uma matriz da funo, inclusive todas as clulas, caso contrrio o
PI DataLink retornar uma mensagem de erro: You cannot change part of an
array.
Abra o painel de tarefas de funo e atualize o campo Clula de sada para colocar a matriz
em uma nova localizao. Veja Atualizar as entradas para uma matriz da funo.
Voc tambm pode copiar os valores de uma matriz de funo se voc desejar us-los em
algum outro lugar da planilha. Depois de copiar e colar os valores, eles no faro mais parte de
uma matriz de funo, eles sero apenas valores de clulas e no sero mais atualizados. Para
copiar valores de matriz:
Selecione os valores da funo que voc deseja, copie-os e use o comando Colar Especial
para colar os valores na posio desejada.
No necessrio selecionar a coluna ou linha inteira da matriz para copiar os valores.
Atualizar as entradas para uma matriz da funo

Use o painel de tarefas de funo para atualizar uma matriz da funo com os novos dados de
entrada.
Procedimento
1. Abra o painel de tarefas de funo para uma matriz.
Com a exibio automtica de painel de tarefa habilitada, clique em uma ou em vrias
clulas.
Com a exibio automtica de painel de tarefa desabilitada, selecione uma ou vrias
clulas, clique com o boto direito do mouse e escolha o nome da funo.
O painel de tarefas de funo mostra as entradas atuais para a matriz da funo selecionada.
Se uma nica clula tiver sido selecionada, o PI DataLink automaticamente detecta matrizes
da funo adjacentes que diferem somente pela fonte (ou seja, pelo item de dados ou
expresso) e seleciona essas matrizes para edio.

Se vrias clulas tiverem sido selecionadas, o PI DataLink selecionar somente as matrizes

que tenham a mesma fonte (isso , os mesmos valores de item de dados ou expresso) das
clulas selecionadas.
2. Altere os valores de entrada como desejado para atualizar as matrizes selecionadas e clique
OK ou Aplicar.
Se o campo Clula de sada tiver sido selecionado, o resultado depender da localizao da
nova referncia de clula:
Se a nova referncia de clula parte da matriz original, o PI DataLink move a matriz

inteira, colocando a clula superior esquerda da matriz na nova clula referenciada.
Se a nova referncia de clula no parte da matriz original, o PI DataLink copia a matriz,
localizando a clula superior esquerda da matriz na nova clula referenciada. A matriz
original continuar na sua localizao original.
Tamanho da matriz:
Quando o PI DataLink escreve a matriz de funes, ele automaticamente dimensiona a matriz
para conter os dados retornados. As funes escrevem a matriz de funes quando voc clica
em OK ou Aplicar em um painel de tarefas ou quando voc clica em Recalcular (Redimensionar)
Funo no menu de atalhos.
Outros mtodos que recalculam ou atualizam a funo no escrevem uma nova matriz de
funes. Esses mtodos somente atualizam os valores; o tamanho da matriz permanece
inalterado. Por exemplo, se entradas de funo com referncias de clulas forem especificadas
e os valores em uma clula forem alterados, a funo atualizar os valores retornados, mas o
tamanho da matriz da funo permanecer o mesmo. A atualizao pode retornar mais ou
menos valores do que a matriz da funo na planilha pode mostrar. As configuraes
controlam o que o PI DataLink retorna:
Se a atualizao retornar menos valores, o PI DataLink retornar valores vazios ou #N/A nas
clulas sem valores.
Se a atualizao retornar mais valores do que a matriz da funo pode exibir, o PI DataLink
retornar o texto Resize to show all values no final da matriz da funo, a no ser
que as configuraes de preferncia desabilitem a mensagem.
Valores vazios podem modificar a aparncia da planilha. Para manter um tamanho constante,
considere definir as entradas de funo para limitar os valores retornados. Por exemplo, na
funo Dados Compactados, voc pode especificar o nmero de valores a recuperar ao invs de
um perodo de tempo durante o qual voc recupera todos os valores.
Veja tambm...
Frequncia de clculo
Uma atualizao ou reclculo de uma funo do PI DataLink pode retornar mais ou menos
valores do que a matriz pode mostrar. Use o comando Recalcular (redimensionar) funo para
reescrever toda a matriz da funo: o PI DataLink recupera novos valores do PI Data Archive
ou PI AF e automaticamente redimensiona a matriz para conter os dados retornados.

Procedimento
Clique com o boto da direita em uma matriz de funes e, ento, clique em Recalcular
(Redimensionar) funo.
A funo reescreve a matriz da funo, usando os dados atuais, e automaticamente
redimensiona a matriz para conter os dados retornados.
Frequncia de clculo
O PI DataLink grava a matriz da funo e calcula os valores atuais para a funo sempre que o
painel de tarefas da funo OK ou Aplicar for clicado. Para manter os valores atuais, deve-se
recalcular a matriz da funo. As sees a seguir discutem abordagens para recalcular uma
matriz da funo.
Para obter informaes detalhadas sobre como o Excel gerencial os clculos, consulte o tpico
Reclculo de Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) na biblioteca
MSDN.
Nesta seo
Recurso Atualizao automtica
Reclculo por disparo
Recalcular manualmente
Recurso Atualizao automtica

O recurso de Atualizao automtica inicia o reclculo das funes e tendncias em intervalos
especificados. A Atualizao automtica se aplica a qualquer pasta de trabalho aberta na
mesma seo do Excel. A Atualizao automtica pausada quando um menu, painel de tarefas
ou janela aberto ou quando o modo de edio iniciado na planilha atual. A Atualizao
automtica no pode atualizar pastas de trabalho protegidas, que so somente para leitura.
As configuraes de preferncia afetam a Atualizao automtica:
Tipo de atualizao
Uma configurao de preferncia determina quais funes so atualizadas na Atualizao
automtica. Existem duas opes:
Calcular (F9)
Selecione esta opo para recalcular todas as funes volteis e qualquer funo que as
referencie durante cada reclculo.
Clculo completo (Ctrl+Alt+Shift+F9)
Selecione esta opo para recalcular todas as funes, independente da volatilidade,
durante cada reclculo.
Frequncia de atualizaes
No campo Intervalo, insira o nmero de segundos entre os reclculos automticos. O valor
mnimo cinco segundos. Insira 0 para que o PI DataLink configure o intervalo para duas
vezes a durao do clculo, com um intervalo mnimo de cinco segundos. A OSIsoft
recomenda usar o intervalo automtico para garantir que o Excel continue respondendo
50% do tempo.
Se o reclculo levar mais tempo que o intervalo especificado, uma mensagem perguntar se
deseja-se mudar para intervalo automtico ou desligar a Atualizao automtica.

Veja tambm
Ativar Atualizao automtica
Cancelar Atualizao automtica
Ativar Atualizao automtica

Ative o recurso Atualizao automtica para recalcular as funes do PI DataLink
automaticamente em intervalos especificados.
Procedimento
Na guia PI DataLink , clique no boto Atualizar.
O Excel imediatamente recalcula todas as funes do PI DataLink em todas as pastas de
trabalho na sesso atual do Excel. Ento, o Excel automaticamente recalcula essas funes
no intervalo especificado nas suas configuraes de preferncia.
Quando a Atualizao automtica est habilitada, o boto Atualizar destacado, e a barra de
status mostra um indicador de mensagem.
Veja tambm
Cancelar Atualizao automtica

Cancele o recurso Atualizao automtica para interromper o reclculo automtico de funes
do PI DataLink.
Procedimento
Na guia PI DataLink , clique no boto destacado Atualizar para limpar a seleo.
Pressione ESC para cancelar um reclculo em andamento. O PI DataLink termina o reclculo
para a funo que est sendo processada no momento, escreve Calculation aborted nas
clulas das matrizes da funo no processadas e desliga a Atualizao automtica.
Reclculo por disparo

O Excel recalcula funes volteis e qualquer funo que referencie uma funo voltil sempre
que qualquer clula da planilha alterada, ou F9, pressionado. Funes volteis incluem as
funes de tempo do Excel, now() e today(). A funo Valor atual uma funo voltil; as
outras funes do PI DataLink no so. Pode-se disparar o reclculo de funes no volteis do
PI DataLink quando referencia uma funo voltil dentro de funes no volteis do PI
DataLink.
Basear funes do PI DataLink em funes volteis do Excel

Se o recurso Atualizao automtica no for usado, ser possvel maximizar a frequncia de
atualizao e manter as matrizes de funo atuais baseando as funes do PI DataLink em uma
funo voltil do Excel.

Nota:
Para maximizar a frequncia de atualizaes quando a Atualizao automtica est em
uso, verifique as preferncias de clculo do Excel para garantir que os clculos da planilha
e do aplicativo estejam configurados para Automtico, no para Manual. Tenha em mente
que isso pode afetar o desempenhos e tornar planilhas grandes difceis de serem usadas.
Procedimento
1. Use a barra de frmulas do Excel para inserir uma funo voltil em uma clula de planilha.
Por exemplo, pode-se usar (today()+1/3) para representar 8h do mesmo dia ou now()
como uma referncia de clula para substituir o horrio do PI atual, *.
Para criar um timestamp absoluto que aciona atualizaes, adicione e subtraia now(), por
exemplo 2-feb-12 00:30:30 + now() - now().
2. Referencie a clula ao definir as entradas de Hora de incio ou Tempo final em uma funo
do PI DataLink.
Recalcular manualmente
A qualquer momento, possvel recalcular manualmente as funes do PI DataLink.
Procedimento
Pressione F9 para forar o reclculo de todas as funes volteis (e qualquer funo que as
referencie).
Pressione Ctrl+Alt+Shift+F9 para forar o reclculo de todas as funes.
Clique com o boto direito do mouse em uma matriz da funo e clique em Recalcular
(Redimensionar) funo. Esse comando gravar a matriz inteira e automaticamente
redimensionar o tamanho para conter os dados retornados.
Compartilhamento de planilhas
Para compartilhar dados do PI DataLink com outros, voc pode compartilhar pastas de
trabalho criadas com o PI DataLink. Para determinar a melhor maneira de compartilhar
planilhas, considere o seguinte:
Voc pode enviar uma pasta de trabalho PI DataLink para outro usurio do Excel. O usurio
deve ter o PI DataLink instalado e uma conexo ativa para o mesmo servidor PI Data
Archive e PI AF Server para poder recalcular as funes e ver os valores dos pontos do PI e
atributos do PI AF atualizados dinamicamente.
Aqueles que no tem o PI DataLink instalado podem ver os ltimos dados salvos na planilha,
desde que a opo Clculo da Pasta de Trabalho do Excel esteja configurada para Manual
antes que ele abra a planilha no Excel. Veja Configurar opo Clculo da pasta de trabalho
para manual.
Tambm possvel salvar uma planilha como uma pgina da Web ou arquivo PDF para
compartilhar uma verso esttica da planilha.
possvel copiar os valores das matrizes da funo para novos locais na planilha usando o
comando Colar Especial. Embora os dados da planilha no sejam mais atualizados depois de
copiados, esse mtodo permite distribuir um instantneo personalizado dos dados para
qualquer pessoa que tenha uma cpia do Excel. Veja Tarefas comuns de matrizes da funo.
Se o Microsoft SharePoint Server estiver instalado no computador, ser possvel publicar
uma planilha do PI DataLink em um site do SharePoint e usar PI DataLink Server (DLS) para
exibir e recalcular dados das funes do PI DataLink.

Configurar opo Clculo da pasta de trabalho para manual

Para permitir que aqueles que no tem o PI DataLink vejam os ltimos dados salvos na pasta
de trabalho, configure a opo Clculo da pasta de trabalho do Excel para Manual antes de
salvar a pasta de trabalho.
Procedimento
1. Clique na guia Arquivo e clique em Opes. (No Microsoft Excel 2007, clique no Boto do
Microsoft Office e, clique em Opes do Excel.)
2. Na janela Opes do Excel, clique em Frmulas.
3. Em Opes de clculo, defina Clculo da pasta de trabalho para Manual e clique em OK.


Tpicos avanados
Os tpicos desta discusso proporcionam informaes mais detalhadas e teis sobre como
trabalhar com funes PI DataLink.
Nesta seo
PI time
Expresses
Funes para gravar dados
PI time
Voc pode usar uma sintaxe especial, chamada de PI time, para especificar entradas de
timestamps e intervalos de tempo. O PI time usa abreviaturas especficas, que podem ser
combinadas para criar expresses de tempo.
Nesta seo
Abreviaturas do horrio PI
Expresses de tempo do PI
Abreviaturas do horrio PI
Ao especificar o horrio PI, possvel usar abreviaturas especficas que representam unidades
de tempo e tempos de referncia.
Abreviaturas da unidade de tempo
Abreviatura Unidade de tempo
s segundo
m minuto
h hora
d dia
mo ms
y ano
w semana
Para especificar unidades de tempo, especifique a abreviatura, a unidade de tempo completa, a

verso plural da unidade de tempo, como s, second ou seconds. Deve-se incluir um valor
vlido a qualquer unidade de tempo. Se especificar segundos, minutos ou horas, especifique um

Tpicos avanados
valor fracional, como 1.25h. No possvel especificar valores fracionais de outras unidades
de tempo.
Abreviaturas de tempo de referncia
Abreviatura Verso completa Tempo de referncia
* Hora atual
t hoje 00:00:00 (meia-noite) do dia atual
y ontem 00:00:00 (meia-noite) do dia anterior
dom1 domingo 00:00:00 (meia-noite) do ltimo domingo
jun2 junho 00:00:00 (meia-noite) do dia atual em junho do ms atual
dec DD dezembro DD 00:00:00 (meia-noite) do dia DD de dezembro do ano atual
YYYY 00:00:00 (meia-noite) do dia e ms atuais no anoYYYY
M-D ou M/D 00:00:00 (meia-noite) do dia D do ms M no ano atual
DD 00:00:00 (meia-noite) no dia DD do ms atual
1: Use as primeiras trs letras para abreviar qualquer dia da semana: dom, seg, ter, qua, qui, sex ou
sb.
2: Use as trs primeiras letras como abreviatura dos meses do ano: jan, fev, mar, abr, mai, jun, jul, ago,
set, out, nov ou dez.
Expresses de tempo do PI
As expresses de tempo do PI podem incluir tempos fixos, abreviaturas de tempo de referncia
e deslocamentos de tempo. Um deslocamento de tempo indica a direo do deslocamento (+ ou
-) e o volume do deslocamento (uma abreviatura de unidade de tempo com um valor). As
expresses de tempo do PI vlidas incluem:
Apenas tempo fixo, como 24-aug-2012 09:50:00
Apenas um abreviatura de referncia de tempo, como t
Apenas um deslocamento de tempo, como +3h
Um abreviatura de tempo de referncia com um deslocamento de tempo, como t+3h
Inclui no mximo um deslocamento de tempo em uma expresso. Incluir vrios deslocamentos
pode gerar resultados no previstos. Por exemplo, as seguintes expresses de tempo no so
vlidas:
*+1d+4h
t-1d+12h
Para especificar as entradas dos timestamps, insira as expresses de tempo contendo:
Tempos fixos
Um tempo fixe sempre representa o mesmo tempo, independentemente do tempo atual.
Entrada Significado
23-ago-12 15:00:00 15h de 23 de agosto de 2012
25-set-12 0h (meia-noite) de 25 de setembro de 2012
Abreviaturas do tempo de referncia

Tpicos avanados
Uma abreviao do tempo de referncia representa um tempo relativo ao tempo atual.

Entrada Significado
* Tempo atual (agora)
3-1 ou 3/1 0h (meia-noite) de 1 de maro do ano atual
2011 0h (meia-noite) do dia e ms atuais de 2011
25 0h (meia-noite) do 25 dia do ms atual
t 0h (meia-noite) na data atual (hoje)
y 0h (meia-noite) da data anterior (ontem)
tue 0h (meia-noite) da tera-feira mais recente
Abreviaturas de tempo de referncia com um deslocamento de tempo

Quando includo em uma abreviatura de referncia de tempo, um deslocamento de tempo
somado ou subtrado do tempo especificado.
Entrada Significado
*-1h Uma hora atrs
t+8h 08:00:00 (8h) de hoje
y-8h 16:00:00 (16h) de antes de ontem
mon+14.5h 14:30:00 (14h30) da ltima segunda-feira
sat-1m 23:59:00 (23:59) da ltima sexta-feira
Deslocamentos de tempo
Inserido sozinho, os deslocamentos de tempo especificam um tempo relativo para um
tempo de referncia implcito. O tempo de referncia implcito pode ser o horrio atual do
relgio ou outro horrio, dependendo de onde a expresso foi inserida.
Entrada Significado
-1d Um dia antes do tempo atual
+6h Seis horas antes do tempo atual

As entrada de intervalo de tempo definem intervalos para a coleta e o calculo de valores
durante um perodo. Por exemplo, voc pode especificar um intervalo de 60 minutos para
computar uma mdia de hora em um perodo de 12 horas. Para especificar as entradas do
intervalo de tempo, insira um valor vlido e uma unidade de tempo:
Valores positivos definem intervalos que comeam na hora anterior no perodo e terminam
na ou aps a hora posterior nesse perodo.
Hora inicial 2:00:00
Tempo final 3:15:00
Intervalo de tempo 30 min
Intervalos retornados 2:00:00 a 2:30:00
2:30:00 a 3:00:00
Valores negativos definem intervalos que terminam na hora posterior no perodo e que
iniciam na ou aps a hora anterior desse perodo.
Hora inicial 2:00:00
Tempo final 3:15:00

Tpicos avanados
Intervalo de tempo -30 min

Intervalos retornados 2:15:00 a 2:45:00
2:45:00 a 3:15:00
Expresses
No PI DataLink, expresses so Performance Equations que voc pode usar em funes para
incorporar operaes matemticas e clculos baseados em itens de dados do PI System. Por
exemplo, possvel usar uma expresso em uma funo do PI DataLink para calcular valores
enquanto eles so recuperados do PI Data Archive.
Nota:
O PI DataLink restringe os itens de dados que voc pode incluir em expresses. Veja
Restries para itens de dados em expresses.
Algumas funes do PI DataLink aceitam um item de dados ou uma expresso como entrada.
Essas funes mostram as opes Item de dado e Expresso no alto do painel de tarefas.
Algumas funes do PI DataLink tambm tem um campo Expresso de filtro. Especifique uma
expresso de filtro para limitar os valores retornados pela funo.
As funes do PI DataLink que podem usar expresses incluem:
Funo Tempo Filtrado
As sees seguintes descrevem informaes bsicas sobre expresses. O PI DataLink suporta
toda a sintaxe, operadores e funes que o PI Data Archive suporta.
Para obter uma descrio completa das Performance Equations e dos exemplos, veja PI Data
Archive Applications User Guide ou PI 3 Performance Equations Help File. Baixe esses
documentos na pgina de Downloads do suporte tcnico da OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/). Esses tpicos tambm podem ser
encontrados na PI Live Library (http://livelibrary.osisoft.com).
Nesta seo
Usar expresses em funes do PI DataLink
Sintaxe das expresses
Restries para itens de dados em expresses
Exemplos de expresses
Expresses de filtro
Usar expresses em funes do PI DataLink

Use expresses em funes do PI DataLink para incorporar operaes matemticas e clculos
baseados em itens de dados do PI System. Funes que aceitam um item de dado ou uma
expresso tem as opes Item de dados e Expresso no alto do painel de tarefas.

Tpicos avanados
Antes de Iniciar
Abra o painel de tarefas de funes.
Procedimento
1. Clique na opo Expresso na parte superior do painel de tarefas de funo.
O campo Item(ns) de dados torna-se uma campo Expresso(es). A disponibilidade de
outros campos pode mudar.
2. Insira uma expresso diretamente no campo Expresse(s) ou insira uma referncia para
uma clula que contenha uma expresso.
Use as referncias de clula para especificar mltiplas expresses para uma funo. Lembre-
se de que uma expresso em uma clula referenciada uma string, e deve ser precedida por
uma aspa simples.

Siga estas orientaes ao escrever expresses:
Envolva qualquer ponto do PI ou atributo do PI AF usado em expresses em aspas simples.
Se estiver entrando uma expresso em uma clula do Excel, inicie a expresso com uma
aspa simples para forar o Excel a interpretar a expresso como uma string.
Se estiver inserindo uma expresso em uma clula do Excel, e a expresso comear com o
nome de um ponto do PI ou atributo do PI AF, comece a expresso com duas aspas simples.
Se estiver inserindo um valor para comparar com um ponto do PI digital, especifique o valor
negativo do nmero do cdigo do estado digital.

O PI DataLink permite os seguintes tipos de dados em expresses:
Pontos PI
Atributos do PI AF que armazenam referncias de dados de pontos do PI.
Atributos do PI AF que armazenam dados constantes
Alm disso, uma funo PI DataLink s pode retornar dados de um nico servidor PI Data
Archive. Assim, quaisquer pontos do PI em uma expresso, inclusive aqueles referenciados por
atributos do PI AF, devem estar armazenados no mesmo servidor PI Data Archive. Da mesma
forma, pontos do PI em uma expresso de filtro devem estar armazenados no mesmo servidor
PI Data Archive que quaisquer pontos do PI especificados pelos campos Item de dado ou
Expresso.
Exemplos de expresses
A seguinte expresso calcula a soma dos valores do ponto do PI sinusoid elevados ao cubo e o
valor do ponto do PI cdf144 dividido por 10:
(('sinusoid')^3 + 'cdf144'/10)
A seguinte expresso avaliada como true (diferente de zero) se o valor absoluto do ponto do
PI mytag , no mnimo, 14,65:
(abs('mytag') >= 14.65)

Tpicos avanados
A seguinte expresso avaliada como true se o valor do atributo do PI AF Manufacturer

ACME:
('\\Server\Database\Element|Manufacturer' = "Manual")
A seguinte expresso avaliada como true se o valor do ponto do PI sinusoid menor que
45, e a raiz quadrada do valor do ponto do PI vdf1002 maior que 2:
('sinusoid' < 45 and sqr('vdf1002') > 2)
Expresses de filtro
Use uma expresso de filtro em uma funo do PI DataLink para filtrar valores de eventos
retornados com um Performance Equation lgico. O PI DataLink remove os dados para os quais
a expresso avalia como false.
O PI DataLink aplica a expresso de filtro aos dados brutos recuperados (e no aos valores
resultantes do clculo em si) Por exemplo, adicionando a expresso de filtro simples
'sinusoid' < 70, a uma funo Dados calculados elimina do clculo todos os valores
maiores que 70.
Expresses de filtro podem conter qualquer Performance Equation lgico; no entanto, itens de
dados em expresses de filtro devem referenciar pontos do PI. Podem-se criar expresses
complexas. Por exemplo, seria possvel usar expresses de filtro para remover picos atpicos
em valores de dados.
Se disponvel, marque a caixa de seleo Marcar como filtrado para inserir o rtulo Filtered
no lugar de um valor ou bloco de valores filtrados pela funo pela sada baseada na expresso
de filtro.
Veja tambm

Embora seja possvel usar a interface do PI DataLink para construir funes PI DataLink,
usurios experientes podem preferir entrar as funes diretamente na barra de frmulas do
Excel.
O tpico a seguir se aplica a funes PI DataLink inseridas diretamente na barra de frmulas.
Nesta seo
Definir funes manualmente
Orientaes para entrada manual de argumentos
Cdigos de sada

Para no inserir as frmulas no painel de tarefas, podem-se definir as funes do PI DataLink
manualmente.

Tpicos avanados
Procedimento
1. Selecione um intervalo apropriado na planilha para a matriz de sada, baseado no nmero
esperado de valores.
2. Insira a funo PI DataLink e seus argumentos na barra de frmulas do Excel.
3. Pressione Ctrl + Shift+Enter para colocar a funo do PI DataLink nas clulas de sada
selecionadas.
Consulte a ajuda on-line do Microsoft Excel para obter mais informaes sobre frmulas de
matrizes.

A tabela a seguir lista os tipos de dados que podem ser inseridos como argumentos em funes
do PI DataLink e fornece orientaes para que eles sejam inseridos.
Dado entrado como argumento Orientao
Funes padro Voc pode incluir vrias funes em argumentos que aceitam
expresses. Veja PI Data Archive Applications User Guide ou PI 3
Performance Equations Help File para obter uma lista de funes.
Strings Envolva argumentos string com aspas duplas. Por exemplo, para
recuperar o tempo do instantneo e o valor do ponto do PI sinusoid
do servidor PI Data Archive chamado casaba, selecione uma matriz
de sada 1 x 2 e digite:
=PICurrVal("sinusoid", 1, "casaba")
Referncias de clula Voc pode usar referncias de clula para qualquer argumento de
funes do PI DataLink. Por exemplo, suponha que clulas da
planilha tenham os seguintes valores:
A1: "sinusoid"
A2: 1
A3: "casaba"
Ento, inserir a seguinte funo na barra de frmulas:
=PICurrVal(A1, A2, A3)
equivalente a entrar:
=PICurrVal("sinusoid", 1, "casaba")
Caminho raiz Envolva argumentos string com aspas duplas. Por exemplo, para
recuperar o valor atual dos atributos do PI AF especificados nas
clulas B3 a B5 e armazen-las no PI AF Server DLAFPI, no banco de
dados MyTest e no elemento Reator, insira:
=PICurrVal(B3:B5,0,"\\DLAFPI\MyTest\Reactor")
Veja Itens de dado para obter informao sobre as entradas vlidas.
Cdigos de sada Determina quais dados adicionais a funo retorna e como a funo
orienta a sada. Veja Cdigos de sada.
Cdigos de sada
A sintaxe da funo do PI DataLink contm um argumento OutCode inteiro. Esse argumento
recebe um cdigo de sada que determina quais dados adicionais a funo retorna e a
orientao das clulas de sada.

Tpicos avanados
Os painis de tarefa do PI DataLink geram os cdigos de sada automaticamente. No entanto, se

voc entrar uma funo manualmente na barra de frmulas do Excel, voc deve calcular e
incluir o valor do cdigo de sada apropriado.
Um cdigo de sada a representao do tipo integer de bits binrios. No PI DataLink, o
significado dos bits depende da funo:
Significado dos bits para as funes Valor Atual e Valor de Arquivo
Bit Propsito
1 Mostra o horrio na coluna esquerda do valor
2 Mostra o horrio na linha acima do valor
Significado dos bits nas demais funes do PI DataLink

Bit Propsito
1 Mostrar horrio
2 Orienta os dados em linhas ao invs de colunas
3 Mostrar percentual bom
4 Ocultar contagem
5 Mostrar status extendido
6 Mostrar anotaes
71 Mostrar hora inicial
81 Mostrar hora final
91 Mostrar hora min/max
1 Requer que o 1 bit tambm esteja habilitado
Com o argumento OutCode definido como 0, a funo retorna o valor com orientao em
coluna sem dados adicionais. Para calcular o argumento OutCode, use a seguinte frmula:
Por exemplo, com um argumento OutCode igual a 0, a funo PISampDat() retorna os valores
de amostra na clula de sada designada. Com um argumento OutCode de 1, a funo retorna
os timestamps na coluna um e os valores de amostra na coluna dois de uma matriz n x 2. Com
um argumento OutCode igual a 3, a funo retorna os timestamps na linha um e os valores de
amostra na linha dois de uma matriz 2 x n. (Nesses resultados, n o nmero de eventos de
amostra.)
Nota:
As funes suportam bits diferentes e, portanto, diferentes valores de argumento
OutCode. Aqueles vlidos para uma funo no so necessariamente vlidos para outras
funes. Veja Referncia de funo para obter os bits que cada funo suporta em sua
especificao OutCode.
Exemplo
Suponha que voc queira que a funo Dados Calculados exiba o percentual bom, a hora inicial
e a hora de mnimo/mximo. Para exibir a hora de incio e o tempo mn./mx., deve-se habilitar
o bit mostrar timestamp. Para calcular o argumento OutCode:

Tpicos avanados
Na barra de frmulas do Excel, entre:

=PIAdvCalcDat("sinusoid","y","t","1h","minimum","time-weighted", 50, 1,
325,"MyDataServer")
Nota:
Se um argumento OutCode especificar o display de vrias colunas ou linhas, mas a
planilha no os mostra, clique com o boto direito do mouse na matriz da funo e
selecione Recalcular/redimensionar para escrever a matriz da funo.
Funes para gravar dados

Diferente das funes padro do PI DataLink, que recuperam dados de um servidor PI Data
Archive ou PI AF Server, as funes PIPutVal() e PIPutValX() gravam um valor de uma
planilha em um servidor PI Data Archive ou PI AF Server. Essas funes podem substituir
valores existentes por novos valores, fornecidos pelo usurio, que tenham horrios
correspondentes.
As funes PIPutVal() e PIPutValX() so funes de macro do Excel. possvel executar a
funo PIPutVal() ou PIPutValX() de uma planilha de macros do Excel 4.0. Essa planilha
usa o mtodo application.run do VBA. Veja o mdulo putval_code no arquivo
piexam32.xls distribudo com o PI DataLink para o Excel de 32 bits e no arquivo
piexam64.xls distribudo com o PI DataLink para o Excel de 64 bits.
Observe que o VBA no reconhece as funes PI DataLink, mas possvel formular uma funo
como uma string de texto e definir a propriedade matriz da frmula de um intervalo de clulas
para o valor da string de texto. O cdigo VBA pode ento verificar os valores das clulas para
encontrar os resultados das funes do PIDataLink. Isso produz o mesmo resultado que a
entrada manual de funes PI DataLink no mesmo intervalo de clulas.
Veja tambm...
PIPutVal() e PIPutValX()

Tpicos avanados

Funes Tag
Um ponto do PI um fluxo de dados em tempo real de uma fonte definida. Atributos de pontos,
incluindo Tag (isso , o nome do ponto do PI) e a origem do ponto, descrevem um ponto do PI.
Use as funes de tag do PI DataLink para encontrar pontos que correspondam a IDs de pontos
do PI ou outros atributos do ponto. Pode-se encontrar as funes Tag na guia PI DataLink no
grupo Funes da tag.
Nota:
Pode-se ativar o suplemento do PI DataLink (Legacy) para usar essas funes (consulte
Configurao de suplementos do Microsoft Excel).
Veja tambm
Funo Propriedades
Tendncias
Nesta seo
Funo point ID para tag
Funo Mscara de atributo para tag
Pesquisar PI Points

A funo ID de ponto para tag retorna o nome do ponto do PI que corresponde a uma ID de
ponto especificada.
Entrada Descrio
PI Data Archive de onde a funo ir retornar os dados. Se um servidor no for selecionado ou
o campo for deixado em branco, a funo procurar no servidor PI Data
Archive padro.
Point ID(s) Um ou mais IDs de pontos para os quais voc deseja que a funo retorne
nomes de ponto.
Requerido.
especificada.
Veja tambm...
PIPointIDToTag()

Funes Tag
Exemplo de ID de ponto para tag

Para ver o nome do ponto do PI correspondente a um ID de ponto, configure as seguintes
entradas para a funo ID de ponto para tag:
Entrada Valor
ID de ponto A5 (uma clula contendo um ID de ponto)
Nesse caso, 1 a ID de ponto, e SINUSOID o nome do ponto retornado.

A funo Mscara de atributo para tag retorna os nomes dos pontos do PI que correspondem a
um ou mais valores de pontos especificados.
Entrada Descrio
Archive padro.
Nome(s) de tag Valor do atributo de um ponto do PI para o qual a funo encontra o nome de
Descritor ponto correspondente. Insira um valor em pelo menos uma entrada. Use o
caractere curinga (*) para encontrar todas as correspondncias ou
Point source correspondncias limitadas a caracteres especificados. Por exemplo, insira S*
Tipo de ponto em Point source para encontrar um ponto com um point source de S ou um
point source que inicie com S.
Point class
Unidades de engenharia
especificada.
Veja tambm...
PIAttributeMaskToTag ()

Funes Tag
Exemplo da Mscara de atributo para tag

Para ver os pontos do PI do tipo Float32 e com um nome que inicie com BA, configure as
seguintes entrada para a funo Mscara de atributo para tag:
Entrada Valor
Nome de tag BA*
Tipo de ponto Float32
Caracteres curinga podem ser usados. As strings inseridas devem corresponder aos valores de
atributo no PI Data Archive.
Pesquisar PI Points
Para funes de informaes das tags, use a janela Pesquisar tag para consultar o PI Data
Archive em busca de IDs ou nomes dos pontos do PI a serem inseridos no painel de tarefas.
Procedimento
1. No painel de tarefas, clique em prximo dos campos ID(s) de ponto(s) ou Nome(s) de
Tag(s).
2. Na janela Pesquisar tag, clique na guia apropriada para a pesquisa:
Pesquisa bsica
Use para criar uma mscara com base em atributos dos pontos do PI especificados e
pesquisar pontos que tenham valores de atributos correspondentes.
Pesquisa avanada
Use para construir uma consulta para uma pesquisa complexa que envolva mais
atributos de pontos do que na pesquisa bsica.
Pesquisa de alias
Use para selecionar pontos pelos seus aliases descritivos no PI Module Database.
3. Insira os critrios de pesquisa.
Use * ou ? como caractere curinga conforme apropriado. Por exemplo, configure o campo
Mscara de tag para Tem* para retornar todos nos nomes dos pontos que iniciam com Tem,
mas configure o campo para Tem? para retornar apenas pontos que iniciam com Tem e
terminam com outro caractere nico. Todos os campos de pesquisa ignoram maisculas e
minsculas.
4. Se desejado, clique em Favoritos para acessar pesquisas anteriores

Funes Tag
5. Clique em Pesquisar para encontrar pontos que correspondam aos critrios especificados.
6. Selecione o ponto desejado no painel Resultados e clique em OK para inserir o valor no
painel de tarefas.

Tendncias
O PI DataLink verso de 32 bits para o Microsoft Office inclui um objeto ActiveX de tendncia.
Pode-se inserir uma tendncia em uma planilha para visualmente descrever mudanas nos
valores dos eventos ao longo do tempo. Tendncias podem descrever dados das planilhas ou
dos pontos do PI selecionados.
Nota:
Pode-se ativar o suplemento do PI DataLink (Legacy) para inserir ou editar as tendncias
(consulte Configurao de suplementos do Microsoft Excel).
Nesta seo
Criar uma tendncia
Criar uma tendncia

Uma tendncia inclui um ou mais traos, que visualmente descrevem um conjunto de valores.
Use o Assistente de complementos de tendncia para inserir e configurar tendncias.
Procedimento
1. Em uma planilha, clique na clula na qual deseja-se colocar o canto superior esquerdo da
tendncia.
Depois de selecionar uma clula, lembre-se de que, por padro, uma tendncia requer
aproximadamente 14 por 8 clulas padro.
2. Na guia PI DataLink, no grupo Funes Tag, clique em Inserir Tendncia para abrir o
Assistente de complementos de tendncia.
3. Defina um ou mais traos a serem includos na tendncia. Voc pode:
Criar um trao com valores da planilha..
Criar um trao de valores de ponto do PI recuperado do PI Data Archive.
4. Ajustar a aparncia dos traos em uma tendncia. Voc pode:

Tendncias
Marcar a caixa de seleo na coluna Marcadores para incluir marcadores que indicam a
localizao dos pontos de dados arquivados.
Nota:
Os traos so desenhados em cores diferentes. Por padro, uma tendncia inclui
tambm marcadores sem cor para diferenciar as linhas em monitores
monocromticos. Marcadores sem cor so separados regularmente ao longo do
trao e no indicam pontos de dados arquivados.
Selecionar um trao e usar os botes de seta para mover a linha para cima ou para baixo
na legenda.
Selecionar um trao e clicar em X para remov-lo.
Clicar em X tudo para remover todos os traos.
Selecionar um trao clicar em Renomear para renome-lo.
5. Clique em Prximo.
6. Se um dos traos na tendncia contiver valores de pontos do PI recuperados de um servidor
PI Data Archive, especifique o perodo para recuperar esses valores.
a. Especifique o incio do perodo no campo Hora inicial e o trmino do perodo no campo
Hora final. Voc pode:
Selecionar uma string de tempo da lista.
Digitar um valor de tempo no campo.
Clicar em para mudar o campo para um campo de referncia de dados e, ento,
clicar na clula da planilha que contm uma string de tempo ou digitar o endereo
nessa clula de planilha.
Veja PI time para uma discusso sobre strings de tempo vlidas.
b. Selecione a caixa de seleo Habilitar atualizaes para atualizar a tendncia com novos
dados do PI Data Archive se o perodo de tempo mudar ou se estender at o momento
presente.
7. Clique em Prximo.
8. Especifique o ttulo e a localizao da tendncia:
a. No campo Ttulo da tendncia, digite um ttulo para a tendncia.
b. Desmarque a caixa de seleo Exibir bits de qualidade caso no queira que os atributos
dos valores apaream nas linhas de tendncia.
cones aparecem quando os dados contm eventos com conjunto de bits Questionvel,
Substitudo ou Anotado.
c. Se desejado, especifique uma localizao diferente para a tendncia. Voc pode
selecionar:
Nova planilha para colocar a tendncia no canto superior esquerdo de uma nova
planilha.
Planilha existente para colocar a tendncia na planilha atual no incio da clula
especificada.
Se a clula for alterada, verifique se a nova clula contm dados.
9. Clique em Terminar.

Tendncias
Criar um trao com valores da planilha.

Quando estiver criando uma tendncia com o Assistente de complementos de tendncia, ser
possvel definir um trao para a tendncia dos valores da planilha.
Procedimento
1. No Assistente de complementos de tendncia, clique em Dados na planilha.
2. Clique no campo Intervalo de clulas contendo dados e selecione o intervalo de clulas da
planilha que contm os valores.
3. Especifique as opes apropriadas para especificar o intervalo de clulas.
Marque a caixa de seleo Primeiro elemento o nome do trao para usar o valor de uma
clula adjacente como nome do trao. (Se o intervalo de clulas for uma coluna, o nome
do trao estar na clula acima do primeiro valor; se o intervalo de clulas for um trao, o
nome do trao estar na clula esquerda do primeiro valor.)
Marque a caixa de seleo Incluir todas as clulas em um array para incluir todas as
clulas de uma matriz de funes no intervalo de clulas. Se essa caixa de seleo estiver
marcada, campo Intervalo de clulas contendo dados precisar especificar somente uma
clula na matriz da funo.
Marque a caixa de seleo Degrau para desenhar uma tendncia em degrau ao invs de
uma tendncia contnua. Marque essa caixa de verificao para os pontos do PI que
armazenam valores discretos.
4. Clique em Adicionar para inserir um trao na tendncia.
Criar um trao de valores de ponto do PI recuperado do PI Data Archive

Ao criar uma tendncia com o Assistente de complementos de tendncia, possvel definir um
trao para a tendncia com valores retornados de um PI Data Archive.
Procedimento
1. No Assistente de complementos de tendncia, clique em Dados do PI.
2. No campo Nome da tag, especifique o nome de um ponto do PI do qual voc deseja
recuperar valores. Voc pode:
Digitar o nome do ponto.
Clicar no campo e selecionar as clulas da planilha que contm nomes de pontos.
Clique em para abrir a janela Pesquisa da tag, que pode ser usada para pesquisar
pontos (veja Pesquisar PI Points).
3. No campo Nome do servidor, especifique o servidor PI Data Archive que armazena os
valores para o ponto. Voc pode:
Selecionar o servidor de uma lista.
Clique em para mudar o campo para um campo de referncia de dados e clique na
clula da planilha que contm um servidor ou digite o endereo nessa clula de planilha.
4. Clique em Adicionar para inserir uma linha na tendncia.

Tendncias

Use o menu de atalhos de tendncia para atualizar, editar ou gerenciar uma tendncia inserida
em uma planilha. Clique com o boto direito do mouse em uma tendncia para abrir um menu
com diversos comandos.
Trocar escala
Abre a janela Trocar escala para trocar a escala do eixo y ou o intervalo de tempo do eixo x.
Reverter
Desfaz todas as alteraes e reverte para as configuraes originais de tendncia definidas
no Assistente do suplemento da tendncia.
Barra de rolagem
Habilita uma barra de rolagem em baixo da tendncia para rolar a exibio por perodos
adjacentes.
Formato
Abre a janela Propriedades do Controle de Tendncia do PI para editar a aparncia de traos
individuais ou da tendncia como um todo. Pode-se mudar a cor ou espessura de um trao
ou adicionar itens de legenda a uma tendncia.
Definir tendncia
Abre a pgina de definio de tendncia no assistente de tendncia para atualizar ou alterar
os traos.
Definir intervalo de horas da tendncia

Abre a pgina de definio do intervalo de tempo no assistente de tendncia para atualizar o
intervalo de tempo.
Excluir tendncia
Remove uma tendncia da planilha.
Nota:
No possvel restaurar uma tendncia excluda, s possvel recri-la.
Exportar dados
Abre a janela Exportar dados para colar os valores na tendncia em linhas ou colunas da
planilha. Tambm possvel exportar os nomes das linhas como cabealhos.
Mover/redimensionar
Abre a janela Mover/redimensionar para mover o canto superior esquerdo da tendncia para
uma clula especfica. Insira um intervalo de clulas para redimensionar a tendncia.
Copiar/colar
Abre a janela Copiar/colar para colar uma cpia da tendncia em uma clula especfica.

Os tpicos nessa seo descrevem as ferramentas que o PI DataLink dispe para acessar
objetos do PI Module Database. Essas ferramentas podem ser encontradas na guia PI DataLink
no grupo Module Database. Veja a documentao do PI Data Archive para obter mais
informaes sobre Module Databases e configurao.
Nota:
possvel ativar o suplemento do PI DataLink (Legacy) para usar essas ferramentas (veja
Configurao de suplementos do Microsoft Excel).
Nesta seo
O PI Module Database e as planilhas
Inserir objetos do PI Module Database na planilha
Funes Module Database
O PI Module Database e as planilhas

O PI Module Database uma estrutura hierrquica em rvore com base no contedo do PI Data
Archive. O PI Module Database proporciona uma forma completamente diferente de construir a
infraestrutura de uma planilha. Se o Module Database do PI Data Archive estiver configurado e
incluir objetos que representam os pontos do PI que voc deseja usar, as planilhas podem ser
mais fceis de construir e proporcionaro maior flexibilidade e potencial para reutilizao.
Normalmente o PI Module Database configurado pelo administrador do sistema ou do PI e
armazena aliases e propriedades que se referem a pontos do PI e seus atributos,
respectivamente. A estrutura hierrquica desses objetos proporciona um contexto relacional
entre os pontos.
Por exemplo, pode haver cinco pontos do PI representando os nveis de cinco tanques
individuais idnticos. Cada ponto tem um nome (atributo Tag) diferente e representa um
objeto fsico diferente, mas a sua utilizao e seus requisitos de monitoramento so os mesmos.
Recuperando os objetos do Module Database, voc pode criar uma nica planilha construda
em cima dos apelidos e propriedades que representam os cinco tanques. As funes do Module
Database resolvem esses objetos em nomes de pontos e outros valores de atributos. Caminhos
de mdulo paralelos para cada tanque proporcionam contextos diferentes para as referncias
dos aliases.
Com esse tipo de estrutura, voc pode usar a mesma planilha para alternar entre vises de
mltipos ativos. Por exemplo, quando voc selecionar o nome de qualquer dos cinco tanques
em uma clula de planilha, o mapeamento de apelidos para os pontos do PI correspondentes
permite que as funes do PI DataLink recuperem os valores para o tanque apropriado.
Inserir objetos do PI Module Database na planilha

Use a janela Procurar mdulo para procurar aliases, propriedades e caminhos de mdulo do PI
no PI Module Database. possvel selecionar esses itens e copi-los diretamente para uma
planilha.
Nota:
Aliases e propriedades que correspondem a pontos do PI devem ser configurados no PI
Module Database para que usem as funes Module Database no PI DataLink.

Procedimento
1. Selecione uma clula e, na guia PI DataLink, clique em Procurar mdulo para abrir a janela
Procurar Mdulo.
2. Selecione o tipo de objeto que se est procurando:
Alias
Propriedade
Mdulo
3. Na lista de PI Data Archive, selecione o servidor PI Data Archive conectado que contm o
Module database que voc deseja navegar.
4. Na lista Data da consulta, especifique a data e hora de efetividade da hierarquia do Module
Database que voc deseja ver.
5. Navegue at a rvore da hierarquia para encontrar o item desejado.
6. Selecione um item ou uma coleo de objetos pai a ser copiado para a planilha.
Selecione um item para copiar para a planilha.
Selecione um objeto pai (Aliases ou Propriedades) em um mdulo para copiar todos os
aliases ou propriedades daquele mdulo para a planilha.
7. Marque a caixa de seleo Copiar caminho do mdulo para copiar o caminho completo do
mdulo do alias ou propriedade para uma clula da planilha adjacente.
O caminho do mdulo proporciona o contexto para o objeto selecionado.
Nota:
Se a configurao Copiar nome do PI Data Archive (veja Gerenciar configuraes do PI
DataLink) estiver ativada, o PI DataLink tambm copiar o nome do servidor PI Data
Archive correspondente.
8. Clique OK para copiar os itens selecionados para a planilha e fechar a janela.

Use as funes Module Database do PI DataLink para encontrar os pontos do PI que
correspondem aos aliases e s propriedades em uma rvore do Module Database. Essas
funes usam o caminho de mdulo. possvel inserir um caminho de mdulo como um
argumento de funo ou referenci-lo em uma clula de planilha. Essas funes do Module
Database podem ser encontradas na guia PI DataLink no grupo Module Database.
Nota:
A funo no pode resolver um objeto de propriedade ou alias em um ponto do PI sem
um caminho de mdulo. O caminho fornece o contexto que mapeia o alias para um ponto
do PI especfico.
Veja tambm
Nesta seo
Funo Alias do tag
Funo Propriedade para valor

Funo Alias do tag

A funo Alias para Tag retorna o nome do ponto do PI que corresponde a um alias do PI
especificado.
Entrada Descrio
Archive padro.
Alias(s) Um apelido no PI Module Database
Requerido.
Caminho do mdulo O caminho do mdulo no PI Module Database onde o apelido especificado
pode ser encontrado. Se o Alias for especificado navegando pelo Module
Database, o PI DataLink adicionar o Caminho do mdulo automaticamente.
Requerido.
Data da consulta Uma data de efetividade do apelido. O PI DataLink retorna o ponto que
corresponde ao alias especificado nessa data.
Requerido.
de onde a funo ir retornar os dados. Se um servidor no for selecionado ou
Archive padro.
Sem servidor Selecione para retornar apenas o nome do ponto do PI.
Servidor direita Selecione para exibir o servidor PI Data Archive que armazena o ponto na
clula direita do nome do ponto.
Servidor abaixo Selecione para exibir o servidor PI Data Archive que armazena o ponto na
clula na parte inferior do nome do ponto.
Veja tambm...
PIAliasToTag()

A funo Propriedade para valor retorna o valor ou valores correspondentes a uma
propriedade mdulo do PI especificada.
O PI DataLink pode retornar valores para os tipos de propriedade Booliano, Data, Duplo,
Inteiro, Longo, Nulo, nica e String ou para os tipos de propriedade de matriz Duplo, Inteiro,
Longo e nico.
Entrada Descrio
Archive padro.

Entrada Descrio
Propriedade(s) Uma propriedade do mdulo do PI no PI Module Database.
Requerido.
Caminho do mdulo O caminho do mdulo no PI Module Database onde a propriedade
especificada pode ser encontrada. Ao especificar Propriedade navegando pelo
Module Database, o PI DataLink inserir o Caminho do mdulo
automaticamente.
Requerido.
Data da consulta Uma data de efetividade da propriedade do mdulo do PI. O PI DataLink
retorna o valor da propriedade especificada nessa data.
Requerido.
especificada.
Veja tambm...
PIPropertyToValue()

Notificaes
O PI DataLink inclui o suplemento PI DataLink Notifications. O PI Notifications deve estar
instalado no computador para ativar esse suplemento (veja Configurao de suplementos do
Microsoft Excel). Quando ativado, esse suplemento adiciona a funo Pesquisa de notificaes
guia PI DataLink. Use a funo Pesquisar Notificao para recuperar notificaes do PI Server
que voc subscreve e para inserir essas notificaes nas planilhas.
Nota:
necessrio ter uma conta em pelo menos um PI AF Server com o PI Notifications e ela
deve estar assinada em pelo menos uma regra de notificao para receber notificaes.
Para os requisitos de verso do software, acesse Pgina de Produtos do Suporte Tcnico
da OSIsoft (https://techsupport.osisoft.com/Products/) e clique no link do produto PI
DataLink para ver as informaes sobre o PI DataLink, incluindo os requisitos do sistema
atuais. Para obter mais informaes sobre o PI Notifications, veja PI Notifications User
Guide.
Para acessar a funo Pesquisar Notificao, clique na clula de sada desejada na planilha e
ento, na guia PI DataLink (no grupo Notificaes), clique em Pesquisar Notificao para abrir
a janela Pesquisar Notificao.
Nesta seo
Pesquisar e inserir notificaes
Notificaes inseridas
Configuraes de exibio de notificaes
Pesquisar e inserir notificaes

Use a janela Pesquisar Notificao para pesquisar notificaes que voc subscreveu em um
determinado PI AF Server e ento inseri-la na planilha. O PI AF Server contm um banco de
dados de elementos estruturais e eventos de notificao que ajudam a trabalhar com dados no
servidor PI Data Archive.

Notificaes
Procedimento
1. Na guia PI DataLink, no grupo Notificaes, clique em Pesquisar Notificao para abrir a
janela Pesquisar Notificao.
2. na guia Pesquisar, selecione o PI AF Server onde voc pesquisar notificaes:
Na lista PI Systems, selecione um PI AF Server e clique em Conectar para se conectar ao
servidor.
Se necessrio clique em Mostrar Lista para abrir a janela AF Servers, onde voc pode
adicionar um PI AF Server lista. Veja Adicionar um PI AF Server funo Pesquisa de
notificaes.
Clique em e, ento, clique em uma clula de planilha que contenha o nome de um PI
AF Server.
Clique novamente no boto para mostrar a lista de PI Systems.
3. Na lista Ver Notificaes, selecione a opo para filtrar as notificaes retornadas:
Selecione Ativa para retornar todas as notificaes que esto atualmente ativas.
Selecione Intervalo de Tempo e entre valores de Hora inicial e Hora final para retornar
notificaes que ocorreram em um intervalo especfico de tempo.
Selecione Recente e entre um valor e um intervalo de tempo para retornar a notificao
mais recente em um intervalo de tempo especfico.
4. No campo Clula de sada, especifique a clula de planilha onde voc deseja inserir as
notificaes.
5. Clique em Pesquisar para recuperar as notificaes que correspondem aos critrios
especificados na rea de resultados na parte de baixo da guia.
6. Examine as notificaes recuperadas. Voc pode:
Ajustar a exibio das notificaes recuperadas
Gerenciar as notificaes recuperadas
7. Clique OK para inserir os itens exibidos na planilha e fechar a janela.
O PI DataLink insere a consulta de notificao na planilha como uma matriz de funes no
local indicado. Assim como outras funes do PI DataLink, a funo Pesquisa de notificaes
atualiza os dados quando a planilha recalcula. Veja Reclculo por disparo.
Adicionar um PI AF Server funo Pesquisa de notificaes

O PI System pode ter mltiplos PI AF Servers, cada um dos quais pode ter o PI Notifications
instalado e ser uma fonte de notificaes relevantes. Por exemplo, possvel se inscrever para
notificaes dos PI AF Server que so executados em diferentes fbricas ou representam
diferentes unidades de negcio.
Antes que seja possvel ver as notificaes de certo PI AF Server no Excel, deve-se adicionar
esse PI AF Server lista de PI Systems mantida pela funo Pesquisa de notificaes.
Antes de Iniciar
Inscreva-se para as notificaes no PI System Explorer.

Notificaes
Procedimento
1. Na guia Pesquisar da janela Pesquisa de notificaes, clique em Mostrar lista ao lado da
lista PI Systems para abrir a janela AF Servers.
2. Clique em Adicionar AF Server para abrir a janela Propriedades do AF Server.

3. Insira as informaes de rede relevantes para localizar o PI AF Server e autenticar o
computador naquele servidor.
a. No campo Nome, insira o nome que identificar o PI AF Server na funo Pesquisa de
notificaes.
b. Clique Configurar Active Directory para configurar o acesso ao Active Directory para
coletar as informaes de login.
4. Clique em OK para salvar as propriedades e adicion-las lista de PI AF Servers.
5. Clique em OK para fechar a janela AF Servers.
O PI AF Server aparecer na lista PI Systems. Para obter mais informaes sobre os PI AF
Servers, consulte a documentao do PI AF.
Ajustar a exibio das notificaes recuperadas

Na janela Pesquisa de notificaes, a rea de resultados na parte inferior da guia Pesquisar
mostra as notificaes que correspondem aos critrios de pesquisa especificados. Pode-se
ajustar a exibio dessas notificaes.
Procedimento
Clique em um cabealho de coluna para classificar as notificaes por um atributo
particular.
Clique com o boto direito do mouse nos resultados para mostrar e ocultar as colunas.
Clique em Expandir tudo ou em Recolher tudo para expandir ou recolher um
agrupamento de notificaes.
Clique em Mostrar eventos de contato para alternar a exibio dos eventos de contato de
cada notificao.

Notificaes
Gerenciar as notificaes recuperadas

Na janela Pesquisa de notificaes, a rea de resultados na parte inferior da guia Pesquisar
mostra as notificaes que correspondem aos critrios de pesquisa especificados. Antes de
inserir as notificaes recuperadas na sua planilha, podem-se avaliar, gerenciar e responder a
essas notificaes.
Procedimento
Clique com o boto direito do mouse em uma notificao e escolha um comando:
Instncia reconhecida
Reconhecimento que a ao foi realizada referente notificao e que nenhuma outra
escala necessria. Se desejado, insira um comentrio e clique em OK.
Inscrio reconhecida
Reconhecimento do recebimento de uma notificao na qual se est inscrito. Se desejado,
insira um comentrio e clique em OK.
Adicionar comentrio
Comentrio em uma notificao.
Exibir resumo da regra de notificao
Exibio das propriedades da regra da notificao que acionou uma notificao
selecionada.
Notificaes inseridas
As funes do PI DataLink podem referenciar dados de notificaes em clulas de planilhas.
Por exemplo, pode-se usar o valor da Start Time de uma notificao recuperada para
recuperar dados de amostra que indicam o progresso de um processo em lotes.
Se as notificaes esto configuradas para exibir reconhecimentos, essas colunas incluem

atalhos para pginas da Web PI Notifications nas quais possvel reconhecer ou comentar a
respeito de uma notificao.
Para obter mais informaes sobre as notificaes, as assinaturas e os reconhecimentos,
consulte PI Notifications User Guide.
Configuraes de exibio de notificaes

Use a guia Exibir formato na janela Pesquisa de notificaes para especificar a aparncia das
notificaes inseridas nas clulas da planilha. As colunas exibidas podem ser selecionadas e a
classificao e a formatao delas podem ser alteradas.

Notificaes
Colunas
Selecione as colunas na lista Colunas disponveis e clique em Adicionar para mov-las para a
lista Classificao da coluna, que especifica os dados inseridos na planilha.
Nota:
Inclua a coluna Reconhecer para adicionar um link a uma planilha para reconhecer o
recebimento de uma notificao e inclua a coluna Reconhecer com comentrio para
adicionar um link na planilha para fazer um comentrio em uma notificao.
Clique em Adicionar todos para mover todas as colunas para a lista Classificao da coluna.
Selecione as colunas na lista Classificao da coluna e clique nos botes de seta sobre a lista
para alterar a ordem da coluna.
Selecione as colunas na lista Ordem da coluna e clique em Remover para remover as
colunas selecionadas na lista.
Clique em Limpar para remover todas as colunas da lista Classificao da coluna.
Eventos dos contatos

Marque a caixa de seleo Exibir eventos do contato para incluir os eventos do contato
selecionados a cada notificao, como enviar a cada destinatrio, comentrios e
reconhecimento.
Marque a caixa de seleo Deslocar contatos para deslocar os eventos dos contatos na
planilha. Isso ajudar na identificao deles.
Selecione Usando colunas separadas para adicionar uma segunda coluna aos eventos dos
contatos.
Selecione Formatando clulas para deslocar os eventos dos contatos na mesma coluna
como eventos de notificaes.
Marque a caixa de seleo Agrupar notificaes com o agrupamento do Excel para usar a
funcionalidade de agrupamento do Excel para agrupar eventos em notificaes pai
individuais que os causou.
Nota:
PI DataLink Server (DLS) no d suporte ao agrupamento do Excel.

Notificaes
Exibio e orientao
Marque a caixa de seleo Exibir cabealhos de colunas para adicionar cabealhos aos dados
das notificaes.
Marque a caixa de seleo Exibir contagem para adicionar uma linha ou coluna contendo a
contagem das notificaes antes dos dados das notificaes.
Em Orientar resultados em, selecione Colunas para exibir os dados de notificaes nas
colunas ou selecione Linhas para exibir os dados das notificaes nas linhas.

Referncia de funo
Gere funes do PI DataLink pelos painis de tarefas do PI DataLink (consulte Viso Geral das
funes do PI DataLink). A matriz da funo resultante depender das entradas. Tambm
possvel inserir as mesmas funes diretamente na barra de frmulas do Excel (consulte
Entrada manual de funes).
Essa seo contm uma referncia para as funes do PI DataLink com suporte. Cada tpico
descreve a sintaxe e os argumentos da funo; a maioria dos tpicos tambm inclui um
exemplo. As sees a seguir agrupam as funes por tipo.
Nesta seo
Funes Valores nicos
Funes de valores mltiplos
Funes Clculo
Funes Tag
Funes de entrada
Funes obsoletas
Funes Valores nicos

As funes Valores nicos recuperam o valor de um item de dados em um horrio estabelecido.
Elas retornam exatamente um valor por item de dados.
Nesta seo
PICurrVal()
PIArcVal()
PIExpVal()
PITagAtt()
PICurrVal()
Retorna o valor mais recente de um PI Point histrico ou atributo do PI AF. Para um ponto do
PI futuro, o valor retornado depende dos timestamps dos valores registrados em relao ao
horrio atual:
Se todos os valores retornados possurem timestamps anteriores ao horrio atual, a funo
retorna o valor registrado mais recente.
Se os valores registrados possurem timestamps que sobrepem o horrio atual, a funo
retorna um valor interpolado.
Se todos os valores registrados possurem timestamps aps o horrio atual, a funo no
retorna dados.
Essa funo suporta chamadas em lote.
Sintaxe
PICurrVal(DataItem, OutCode, RootPath)

Referncia de funo
Argumentos
Argumento Tipo Descrio
DataItem String O nome do ponto do PI ou do atributo do PI AF
para o qual a funo retorna um valor. Referencie
um intervalo de clulas contendo nomes dos
pontos do PI ou dos atributos do PI AF para os
quais sero retornados valores.
OutCode Inteiro Um cdigo de sada que determina quais dados
adicionais a funo retornar e como a funo
orienta a sada. Veja Cdigos de sada para obter
informaes sobre como calcular o cdigo. Essa
funo suporta bits 1 e 2.
RootPath String O caminho para o item de dado referenciado pela
expresso. Veja Itens de dado.
Exemplos
=PICurrVal("let439",1,"holden")
Retorna o valor atual e o timestamp correspondente do ponto do PI let439 pelo servidor PI

Data Archive chamado holden e coloca o timestamp na coluna esquerda do valor.
Veja tambm...
Funo Valor atual
PIArcVal()
Retorna o valor de um ponto do PI ou atributo do PI AF em um timestamp especificado. Essa
funo suporta chamadas em lote.
Sintaxe
PIArcVal(DataItem, TimeStamp, OutCode, RootPath, Mode)
Argumentos
TimeStamp String O horrio para o qual a funo retorna valores.
Veja Entradas de tempo.
RootPath String O caminho para o item de dado. Veja Itens de dado.

Referncia de funo

Mode String O mtodo usado pela funo para recuperar os
valores:
previous
previous only
interpolated
auto
next
next only
exact time
Exemplos
=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")
Retorna o valor interpolado do ponto do PI cdep158 s 19h20 de 11 de dezembro de 1992

pelo servidor PI Data Archive nomeado casaba.
Veja tambm...
PIExpVal()
Retorna o valor calculado de uma Performance Equation em um timestamp especificado.
Sintaxe
PIExpVal(Expression, TimeStamp, OutCode, RootPath)
Argumentos
Expression String Uma ou mais Performance Equations para as quais a funo
calcula um valor. Veja Expresses.
Referencia um intervalo de clulas contendo expresses para
as quais sero retornados valores.
TimeStamp String O horrio para o qual a funo retorna valores. Veja Entradas
de tempo.
OutCode Inteiro Um cdigo de sada que determina quais dados adicionais a
funo retornar e como a funo orienta a sada. Veja
Cdigos de sada para obter informaes sobre como calcular
o cdigo. Essa funo suporta bits 1 e 2.
RootPath String O caminho para o item de dado referenciado pela expresso.
Veja Itens de dado.
Exemplos
=PIExpVal("sqr('sinusoid')","y",0,"thevax")

Referncia de funo
Calcula a raiz quadrada do valor do ponto do PI sinusoid do servidor PI Data Archive

chamado thevax meia-noite de ontem.
Veja tambm...
PITagAtt()
Retorna o valor de uma propriedade associada a um item de dado especificado.
Sintaxe
PITagAtt(DataItem, Property, RootPath)
Argumentos
Property String O nome do ponto do PI ou do atributo do PI AF
para o qual a funo retorna um valor.
Exemplos
=PITagAtt(d1,"uom",)
Retorna as unidades de engenharia para o ponto do PI especificado na clula D1 do servidor PI

Data Archive padro.
Veja tambm...
Funo Propriedades
Funes de valores mltiplos

Funes de valores mltiplos associam um ponto do PI ou atributo do PI AF com um perodo de
tempo durante o qual podem haver um ou mais valores correspondentes.
Nesta seo
PINCompDat()
PINCompFilDat()
PICompDat()
PICompFilDat()
PISampDat()
PISampFilDat()
PIExpDat()

Referncia de funo
PITimeDat()
PITimeExpDat()
PINCompDat()
Retorna um nmero especfico de valores de pontos do PI ou valores de atributos do PI AF
comeando em um horrio determinado.
Sintaxe
PINCompDat(DataItem, STime, NumVals, OutCode, RootPath, Mode)
Argumentos
para o qual a funo retorna valores. Especifica um
intervalo de clulas contendo nomes dos pontos do
PI ou dos atributos do PI AF para os quais sero
retornados valores.
STime String O incio do perodo para o qual a funo retorna
valores. Veja Entradas de tempo.
NumVals Inteiro O nmero de valores que a funo retorna,
comeando em STime (especifique um nmero
negativo para recuperar valores anteriores no
tempo).
funo suporta bits 1, 2, 5 e 6.
Mode String O mtodo usado pela funo para determinar quais
valores sero recuperados prximo da hora inicial
(tipo de limite):
inside
outside
interpolated
auto
Exemplos
=PINCompDat("cdf144","1:00:00",10,1,,"inside")
Retorna dez valores e timestamps correspondentes do servidor PI Data Archive padro para o
ponto do PI cdf144 comeando 1h desta manh, usando o tipo de limite inside.
Veja tambm...

Referncia de funo
PINCompFilDat()
Retorna um nmero especfico de valores de pontos do PI ou valores de atributos do PI AF,
filtrados, comeando em um horrio determinado.
Sintaxe
PINCompFilDat(DataItem, STime, NumVals, FiltExp, FiltCode, OutCode, RootPath,
Mode)
Argumentos
NumVals Inteiro O nmero de valores que a funo retorna,
comeando em STime (especifique um nmero
negativo para recuperar valores anteriores no
tempo).
FiltExp String Uma Performance Equation lgica usada pela
funo para filtrar valores. Quando o resultado da
expresso falso, a funo exclui os valores
FiltCode Inteiro Um cdigo que indica como rotular os valores
filtrados:
1
Insira o rtulo Filtered no lugar do valor ou
bloco de valores cuja funo filtrada na sada
com base em FiltExp.
0
No rotule os valores filtrados.
funo suporta bits 1, 2, 5 e 6.
(tipo de limite):
inside
outside
interpolated
auto
Exemplos
=PINCompFilDat("cdf144","2:00:00",10,"'cdep158'>38",1,1,,)

Referncia de funo
Retorna dez valores e os timestamps correspondentes do servidor PI Data Archive padro para
o ponto do PI cdf144 comeando s 2h desta manh, quando o ponto cdep158 maior que 38,
usando um tipo de limite inside.
A sada contm o rtulo Filtered entre os valores nos quais a condio do filtro era falsa.
Veja tambm...
Expresses de filtro
PICompDat()
Retorna valores de pontos do PI ou atributos do PI AF armazenados durante um perodo
especificado.
Sintaxe
PICompDat(DataItem, STime, ETime, OutCode, RootPath, Mode)
Argumentos
retornados valores.
ETime String O final do perodo para o qual a funo retorna
valores.
funo suporta bits 1, 2, 4, 5 e 6.
(tipo de limite):
inside
outside
interpolated
auto
Exemplos
=PICompDat("cdf144","1:00:00","3:00:00",1,,"inside")
Retorna valores e timestamps correspondentes do servidor PI Data Archive padro para o

ponto do PI cdf144 das 10h s 3h desta manh usando o tipo de limite inside.

Referncia de funo
Veja tambm...
PICompFilDat()
Retorna valores de pontos do PI ou atributos do PI AF filtrados armazenados durante um
perodo especificado.
Sintaxe
PICompFilDat(DataItem, STime, ETime, FiltExp, FiltCode, OutCode, RootPath, Mode)
Argumentos
retornados valores.
valores.
filtrados:
1
0
funo suporta bits 1, 2, 4, 5 e 6.

Referncia de funo

valores sero recuperados prximo da STime ou
ETime (tipo de limite):
inside
outside
interpolated
auto
Exemplos
=PICompFilDat("cdf144","2:00:00","10:00:00","'cdep158'>38",1,1,,)
Retorna valores e timestamps correspondentes para o ponto do PI cdf144 pelo servidor PI

Data Archive padro, iniciando s 2h e terminando s 10h, quando o ponto do PI cdep158
maior que 38 usando o tipo de limite inside.
A sada contm o rtulo Filtered entre os valores nos quais a condio do filtro era falsa.
Veja tambm...
Expresses de filtro
PISampDat()
Retorna valores interpolados, espaados regularmente, para um ponto do PI ou atributo do PI
AF armazenados durante um perodo especificado.
Sintaxe
PISampDat(DataItem, STime, ETime, Interval, OutCode, RootPath)
Argumentos
retornados valores.
valores.
Interval String O intervalo entre os valores retornados. Insira um
valor e uma unidade de tempo que especifiquem o
tamanho do intervalo. Por exemplo, entre 15m(15
minutos) para retornar um valor para cada
intervalo de 15 minutos durante o perodo. Veja
Especificao de intervalo de tempo.

Referncia de funo

Exemplos
=PISampDat("sinusoid","y","t","3h",1,)
Retorna os dados de amostra e os timestamps correspondentes para o ponto do PI sinusoid

do servidor PI Data Archive padro, iniciando meia-noite de ontem e terminando meia-
noite de hoje, reportando valores em intervalos de 3 horas.
Veja tambm...
PISampFilDat()
Retorna valores interpolados, espaados regularmente e filtrados, para um ponto do PI ou
atributo do PI AF armazenados durante um perodo especificado.
Sintaxe
PISampFilDat(DataItem, STime, ETime, Interval, FiltExp, FiltCode, OutCode,
RootPath)
Argumentos
retornados valores.
valores.

Referncia de funo

filtrados:
1
0
Exemplos
=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)
Retorna dados de amostra para o ponto do PI sinusoid do servidor PI Data Archive padro. A
funo retorna valores meia noite, 11-Jan-97, 1:00 a.m. em 11-Jan-97, 2:00 a.m. em 11-Jan-97
e 3:00 a.m. em 11-Jan-97. Se a condio na clula A1 no for satisfeita em nenhum desses
horrios, a funo retorna o rtulo Filtered nesse horrio. A funo mostra os horrios na
primeira coluna e os valores na segunda coluna.
Veja tambm...
Expresses de filtro
PIExpDat()
Retorna valores calculados, regularmente espaados, de uma Performance Equation durante
um perodo especificado.
Sintaxe
PIExpDat(Expression, STime, ETime, Interval, OutCode, RootPath)
Argumentos
Expression String Uma ou mais Performance Equations para as quais
a funo calcula um valor. Veja Expresses.
Referencia um intervalo de clulas contendo
expresses para as quais sero retornados valores.
STime String O incio do perodo para o qual a funo calcula um

valor. Veja Entradas de tempo.
ETime String O final do perodo para o qual a funo calcula um
valor.

Referncia de funo

Exemplos
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
Calcula a raiz quadrada do valor do ponto do PI sinusoid recuperado pelo servidor PI Data
Archive chamado thevax em intervalos de uma hora, da meia-noite de ontem meia-noite de
hoje:
A funo exibe o timestamp para cada valor na coluna esquerda do valor calculado.
Veja tambm...
PITimeDat()
Retorna valores reais ou de amostragem interpolada de um ponto do PI ou atributo do PI AF
em timestamps especificados.
Sintaxe
PITimeDat(DataItem, TimeStamps, RootPath, Mode)
Argumentos
DataItem String O nome do ponto do PI ou do atributo do PI AF para o qual a
funo retorna valores. Especifica um intervalo de clulas
contendo nomes dos pontos do PI ou dos atributos do PI AF
para os quais sero retornados valores.
TimeStamps Referncia Uma referncia para uma ou mais clulas da planilha que
contm timestamps para os quais a funo retorna valores.
Mode String O mtodo usado pela funo para recuperar dados:
interpolated
exact time

Referncia de funo
Devolues
Valores nos horrios especificados, apresentados na mesma orientao dos horrios de
referncia. Se a referncia de timestamp uma linha, a funo apresenta os valores em uma
linha. Se a referncia de timestamp uma coluna, a funo apresenta os valores em uma
coluna. A orientao da matriz de sada deve corresponder orientao da referncia de
horrios.
Exemplos
=PITimeDat("mytag",b1:b12,,"interpolated")
Recupera valores interpolados nos timestamps localizados nas clulas B1 a B12 no ponto do PI
mytag no servidor PI Data Archive padro.
Essa funo requer uma matriz de sada horizontal com doze clulas, como C1:C12 ou B14:B25.
Veja tambm...
PITimeExpDat()
Retorna valores de uma Performance Equation em timestamps especificados.
Sintaxe
PITimeExpDat(Expression, TimeStamps, RootPath)
Argumentos
Expression String Uma ou mais Performance Equations para as quais
a funo calcula um valor. Veja Expresses.
Referencia um intervalo de clulas contendo
expresses para as quais sero retornados valores.
TimeStamps Referncia Uma referncia para uma ou mais clulas da

planilha que contm timestamps para os quais a
funo retorna valores. Veja Entradas de tempo.
Devolues
Valores nos horrios especificados, apresentados na mesma orientao dos horrios de
referncia. Se a referncia de timestamp uma linha, a funo apresenta os valores em uma
linha. Se a referncia de timestamp uma coluna, a funo apresenta os valores em uma
coluna. A orientao da matriz de sada deve corresponder orientao da referncia de
horrios.
Exemplos
=PITimeExpDat("sqr('sinusoid')",b1:b12,)
Calcula a raiz quadrada do valor do ponto do PI sinusoid recuperado do servidor PI Data

Archive padro nos tempos especificados nas clulas B1 a B12.

Referncia de funo
Essa funo requer uma matriz de sada horizontal com doze clulas, como C1:C12 ou B14:B25.
Veja tambm...
Funes Clculo
Funes Clculo calculam valores com base em valores de pontos do PI, atributos do PI AF ou
avaliao de Performance Equations durante um perodo especificado.
Nesta seo
PIAdvCalcVal()
PIAdvCalcFilVal()
PIAdvCalcExpVal()
PIAdvCalcDat()
PIAdvCalcFilDat()
PIAdvCalcExpDat()
PITimeFilter()
PITimeFilterVal()
PIAdvCalcVal()
Retorna o valor calculado de um ponto do PI ou valores de atributo do PI AF durante um
perodo especificado. Essa funo suporta chamadas em lote.
Sintaxe
PIAdvCalcVal(DataItem, STime, ETime, Mode, CalcBasis, MinPctGood, CFactor,
OutCode, RootPath)
Argumentos
funo calcula um valor. Referencie um intervalo de clulas
para os quais ser calculado um valor.
STime String O incio do perodo para o qual a funo calcula um valor.
ETime String O final do perodo para o qual a funo calcula um valor.

Referncia de funo

Mode String O tipo de clculo que a funo executa:
total
minimum
maximum
stdev
range
average
count
mean
CalcBasis String O mtodo de clculo:
time-weighted
event-weighted
MinPctGood Nmero O percentual mnimo de dados bons necessrios durante o
intervalo de tempo para calcular e retornar um valor.
CFactor Nmero Um fator que a funo aplica aos valores retornados. Insira 1
se um fator de converso no for necessrio. Nos clculos de
totais ponderados no tempo, especifique um fator que
converta os valores da taxa gravada em unidade de tempo
padro do servidor (unidades por dia).
o cdigo. Essa funo suporta bits 2, 3 e 9 (se Mode estiver
definido como minimum, maximum ou range).
Exemplos
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",50,1,4,)
Retorna o total ponderado pelo tempo do ponto do PI cdf144 calculado pelos valores no
servidor PI Data Archive padro de ontem a hoje.
A funo multiplica o resultado por 1, e retorna um resultado somente se no mnimo 50 por
cento dos dados forem bons. A funo retorna o porcentual bom direita do total calculado.
Veja tambm...
PIAdvCalcFilVal()
Retorna o valor calculado de valores do ponto do PI ou do atributo do PI AF filtrados durante
Sintaxe
PIAdvCalcFilVal(DataItem, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Referncia de funo
Argumentos
funo calcula um valor. Referencie um intervalo de clulas
para os quais ser calculado um valor.
FiltExp String Uma Performance Equation lgica usada pela funo para
filtrar valores. Quando o resultado da expresso falso, a
funo exclui os valores correspondentes. Veja Expresses de
filtro.
total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
SampMode String O mtodo de amostragem usado pela funo para determinar
quando avaliar FiltExp:
compressed
interpolated
SampFreq String A frequncia na qual a funo avalia FiltExp se SampMode
estiver definido como interpolated. Insira um valor e uma
unidade de tempo. Por exemplo, defina como 10m (10
minutos) para retornar um valor interpolado para cada
intervalo de 10 minutos. Veja Especificao de intervalo de
tempo
o cdigo. Essa funo suporta bits 2, 3 e 9 (se Mode estiver
Exemplos
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total","time-
weighted","compressed","10m",50,1,4,)

Referncia de funo
Retorna o total ponderado pelo tempo para o ponto do PI cdf144 calculado pelos valores no
servidor PI Data Archive padro, somando os valores de ontem a hoje durante perodo em que
o ponto do PI cdm158 estava definido como Manual.
A funo multiplica o resultado por 1. Como o modo de amostragem compresseda funo
ignora a frequncia da amostragem e exemplifica a expresso do filtro nos eventos
compactados do ponto cdf144. A funo retorna um resultado somente se no mnimo 50 por
cento dos dados forem bons. A funo retorna o porcentual bom direita do total calculado.
Veja tambm...
Expresses de filtro
PIAdvCalcExpVal()
Retorna o valor calculado por uma Performance Equation durante um perodo especificado.
Sintaxe
PIAdvCalcExpVal(Expression, STime, ETime, Mode, CalcBasis, SampMode, SampFreq,
MinPctGood, CFactor, OutCode, RootPath)
Argumentos

total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
quando avaliar Expression:
compressed
interpolated

Referncia de funo

SampFreq String A frequncia na qual a funo avalia Expression se
SampMode estiver definido como interpolated. Insira um
valor e uma unidade de tempo. Por exemplo, defina como 10m
(10 minutos) para retornar um valor interpolado para cada
tempo
o cdigo.
Essa funo suporta bits 2, 3 e 9 (se Mode estiver definido
como minimum, maximum ou range).

Veja Itens de dado.
Exemplos
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","time-
Retorna o total ponderado para a expresso 'cdf144'+'cdt158' calculada pelos valores do

servidor PI Data Archive padro, usando os valores de ontem a hoje.
A funo multiplica o resultado por 1. Como o modo de amostragem compressed, a funo
compactados contnuos de cdf144 e cdt158. A funo retorna um resultado somente se no
mnimo 50 por cento dos dados forem bons. A funo retorna o porcentual bom direita do
total calculado.
Veja tambm...
Retorna um valor de um ponto do PI calculado e filtrado baseado em uma Performance
Equation.
Sintaxe
PIAdvCalcExpFilVal(Expression, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,

Referncia de funo
Argumentos

filtro.
total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
quando avaliar Expression e FiltExp:
compressed
interpolated
SampFreq String A frequncia na qual a funo avalia Expression e FiltExp
se SampMode estiver definido como interpolated. Insira um
tempo.
o cdigo.
Essa funo suporta bits 2, 3 e 9 (se Mode estiver definido
como minimum, maximum ou range).

Veja Itens de dado.

Referncia de funo
Exemplos
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
Retorna o total ponderado para a expresso 'cdf144'+'cdt158' calculada pelos valores do

servidor PI Data Archive padro quando 'productid' = "Product2" usa os valores de
ontem a hoje.
A funo multiplica o resultado por 1. Como o modo de amostragem compressed, a funo
compactados contnuos de cdf144 e cdt158. A funo retorna um resultado somente se no
mnimo 50 por cento dos dados forem bons. A funo retorna o porcentual bom direita do
total calculado.
Veja tambm...
Expresses de filtro
PIAdvCalcDat()
Retorna valores calculados espaados regularmente para um ponto do PI ou valores de
atributo do PI AF durante um perodo especificado.
Sintaxe
PIAdvCalcDat(DataItem, STime, ETime, Interval, Mode, CalcBasis, MinPctGood,
CFactor, OutCode, RootPath)
Argumentos
funo calcula valores. Referencie um intervalo de clulas
para os quais sero calculados valores.
STime String O incio do perodo para o qual a funo calcula valores. Veja
Entradas de tempo.
ETime String O final do perodo para o qual a funo calcula valores.
Interval String O intervalo entre os valores retornados. Insira um valor e
uma unidade de tempo que especifiquem o tamanho do
intervalo. Por exemplo, entre 15m(15 minutos) para retornar
um valor para cada intervalo de 15 minutos durante o
perodo. Veja Especificao de intervalo de tempo.

Referncia de funo

total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
o cdigo.
Essa funo suporta bits 2, 3, 7, 8 e 9 (se Mode estiver
Exemplos
=PIAdvCalcDat("cdf144","y","t","3h","total","time-weighted",50, 1,4,)
Retorna o total ponderado pelo tempo do ponto do PI cdf144 calculado com base nos valores
do servidor PI Data Archive padro para intervalos de trs horas da meia-noite de ontem
meia-noite de hoje.
A funo multiplica o resultado por 1, e retorna um resultado somente se no mnimo 50 por
cento dos dados forem bons. A funo retorna o percentual bom direita do total calculado.
Veja tambm...
PIAdvCalcFilDat()
Retorna valores calculados espaados regularmente de um ponto do PI ou valores de atributo
do PI AF filtrados durante um perodo especificado.
Sintaxe
PIAdvCalcFilDat(DataItem, STime, ETime, Interval, FiltExp, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)

Referncia de funo
Argumentos
funo calcula valores. Referencie um intervalo de clulas
para os quais sero calculados valores.
Entradas de tempo.
filtro.
total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
quando avaliar FiltExp:
compressed
interpolated
SampFreq String A frequncia na qual a funo avalia FiltExp se SampMode
estiver definido como interpolated. Insira um valor e uma
unidade de tempo. Por exemplo, defina como 10m (10
minutos) para retornar um valor interpolado para cada
tempo

Referncia de funo

o cdigo.
Exemplos
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""", "total","time-
Retorna o total ponderado pelo tempo para o ponto do PI cdf144, calculado pelos valores no
servidor PI Data Archive padro de intervalos de trs horas da meia-noite de ontem meia-
noite de hoje quando o ponto do PI cdf144 est definido como Manual.
A funo multiplica o resultado por 1. Como o modo de amostragem compresseda funo
compactados do cdf144. A funo retorna um resultado somente se no mnimo 50 por cento
dos dados forem bons. A funo retorna o porcentual bom direita do total calculado.
Veja tambm...
Expresses de filtro
PIAdvCalcExpDat()
Retorna valores regularmente espaados calculados por uma Performance Equation durante
Sintaxe
PIAdvCalcExpDat(Expression, STime, ETime, Interval, Mode, CalcBasis,SampMode,
Argumentos
Entradas de tempo.

Referncia de funo

total
minimum
maximum
stdev
range
average
count
mean
time-weighted
event-weighted
quando avaliar Expression:
compressed
interpolated
SampFreq String A frequncia na qual a funo avalia Expression se
SampMode estiver definido como interpolated. Insira um
tempo
o cdigo.

Veja Itens de dado.
Exemplos
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total", "time-
weighted","compressed", "10m",50,1,4,)
Calcula a expresso 'cdf144'+'cdt158' em qualquer timestamp entre a meia-noite de ontem

e a meia-noite de hoje com valores gravados armazenados no servidor PI Data Archive padro
e calcula o total ponderado pelo tempo dos valores calculados em intervalos de trs horas.

Referncia de funo
A funo multiplica cada total calculado por 1 e retorna um valor quando a percentagem de
dados bons for no mnimo 50 por cento durante o intervalo de trs horas. A funo retorna o
porcentual bom direita do total calculado. Observe que, como o modo de amostragem
compressed, a funo ignora a frequncia de amostragem e exemplifica os valores sempre que
cdf144 ou cdt158 tiver um valor gravado armazenado.
Veja tambm...
Retorna valores regularmente espaados calculados por uma Performance Equation filtrada
durante um perodo especificado.
Sintaxe
PIAdvCalcExpFilDat(Expression, STime, ETime, Interval, FiltExp, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Entradas de tempo.
filtro.
total
minimum
maximum
stdev
range
average
count
mean

Referncia de funo

time-weighted
event-weighted
quando avaliar Expression e FiltExp:
compressed
interpolated
SampFreq String A frequncia na qual a funo avalia Expression e FiltExp
se SampMode estiver definido como interpolated. Insira um
tempo.
o cdigo.

Veja Itens de dado.
Exemplos
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'="Product2"","tot
al","time-weighted","compressed","10m",50,1,4,)
Calcula o total ponderado pelo tempo da expresso 'cdf144'+'cdt158' quando

'productid' = "Product2" em intervalos de trs horas de ontem a hoje pelo servidor PI
Data Archive padro.
A funo multiplica cada total calculado por 1 e retorna um valor quando a percentagem de
dados bons for no mnimo 50 por cento durante o intervalo de trs horas. A funo retorna o
porcentual bom direita do total calculado. Observe que, como o modo de amostragem
compressed, a funo ignora a frequncia de amostra e exemplifica os valores sempre que
cdf144 ou cdt158 tiver um valor gravado ou o valor de productid for alterado para ou de
Product2.
Veja tambm...
Expresses de filtro

Referncia de funo
PITimeFilter()
Retorna a quantidade de tempo que uma Performance Equation avalia como true durante
intervalos igualmente espaados em um perodo especificado.
Sintaxe
PITimeFilter(Expression, STime, ETime, Interval, TimeUnit, OutCode, RootPath)
Argumentos
Expression String Uma Performance Equation lgica avaliada pela funo. Veja
Expresses.
Entradas de tempo.
TimeUnit String Unidade de tempo do resultado calculado:
seconds
minutes
hours
days
o cdigo.
Essa funo suporta bits 2, 3, 7 e 8.

Veja Itens de dado.
Exemplos
=PITimeFilter($A$1,"y","t","1h","seconds",65,"thevax")
Retorna o nmero de segundos que a expresso na clula A1 verdadeira no servidor PI Data

Archive chamado thevax em intervalos de uma hora, da meia-noite de ontem meia-noite de
hoje.
A funo mostra a hora inicial de cada intervalo de clculo esquerda do valor.
Veja tambm...
Funo Tempo Filtrado

Referncia de funo
PITimeFilterVal()
Retorna a quantidade de tempo que uma Performance Equation avaliada como true em um
perodo especificado.
Sintaxe
PITimeFilterVal(Expression, STime, ETime, TimeUnit, OutCode, RootPath)
Argumentos
Expression String Uma Performance Equation lgica avaliada pela funo. Veja
Expresses.

TimeUnit String Unidade de tempo do resultado calculado:
seconds
minutes
hours
days
o cdigo.
Essa funo suporta bits 2 e 3.

Veja Itens de dado.
Exemplos
=PITimeFilterVal($A$1,"y","t","seconds",0,"thevax")
Retorna o nmero de segundos que a expresso na clula A1 verdadeira no servidor PI Data

Archive chamado thevax da meia-noite de ontem meia-noite de hoje.
Veja tambm...
Funo Tempo Filtrado
Funes Tag
As funes tag ajudam a trabalhar com tags do PI.
Nesta seo
PIPointIDToTag()

Referncia de funo
PIPointIDToTag()
Retorna o nome do ponto do PI que corresponde a uma ID de ponto do PI especfico.
Sintaxe
PIPointIDToTag(PointID, Server)
Argumentos
PointID String Uma point ID do PI que uma ID exclusiva interna que no
usada quando um ponto excludo.
Server String de onde a funo ir retornar os dados. Se um servidor no
for selecionado ou o campo for deixado em branco, a funo
procurar no servidor PI Data Archive padro.
Exemplos
=PIPointIDToTag("123","thevax")
Pesquisa a point ID 123 no servidor PI Data Archive chamado thevax e retorna o nome do
ponto (o atributo Tag).
Veja tambm...
Retorna nomes dos pontos do PI que correspondem a um ou mais valores do atributo de ponto
do PI especificados.
Sintaxe
PIAttributeMaskToTag(TagName, Descriptor, PointSource, PointType, PointClass,
EngUnits, OutCode, Server)
Argumentos
TagName String Nome dos pontos retornados.1
Descriptor String Descritor dos pontos retornados.1
PointSource String Point source dos pontos retornados.1
PointType String Tipo de ponto dos pontos retornados.1
PointClass String Classe de ponto dos pontos retornados.1
EngUnits String Unidades de engenharia dos pontos retornados.1
OutCode Inteiro Um cdigo de sada que determina como a funo orienta a
sada:
0
Escreve os valores em uma coluna.
2
Escreve os valores em uma linha.

Referncia de funo

1 Use o caractere curinga (*) para encontrar todas as correspondncias ou correspondncias limitadas a
caracteres especificados.
Exemplos
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
Retorna os nomes dos pontos que iniciam com sin pelo servidor PI Data Archive chamado
thevax.
Veja tambm...

Nesta seo
PIAliasToTag()
PIPropertyToValue()
PIAliasToTag()
Retorna o nome do ponto do PI que corresponde a um alias do PI especfico.
Sintaxe
PIAliasToTag(Alias, ModulePath, QueryDate, OutCode, Server)
Argumentos
Alias String O alias do Module Database que corresponde ao ponto do PI a
ser retornado.
ModulePath String O caminho completo do mdulo para o apelido.
QueryDate Inteiro Uma data de efetividade do apelido. O PI DataLink retorna o
nome do ponto que corresponde ao alias especificado nesta
data.
OutCode Inteiro Um cdigo de sada que determina se o nome do servidor
deve ser includo no resultado:
0
Retorna apenas o nome do ponto.
1
Retorna o servidor PI Data Archive que armazena o ponto
na clula direita do nome do ponto.
2
Retorna o servidor PI Data Archive que armazena o ponto
na clula na parte inferior do nome do ponto.

Referncia de funo

Exemplos
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
Retorna o nome do ponto do PI que corresponde ao alias Temperature do mdulo Reactor1,

que um submdulo de Unit1. Unit1 est na raiz do Module Database de um servidor PI Data
Archive chamado thevax. O Module Database pesquisado no horrio atual.
Veja tambm...
Funo Alias do tag
PIPropertyToValue()
Retorna o valor ou valores correspondentes a uma propriedade mdulo do PI especificada.
Sintaxe
PIPropertyToValue(Property, ModulePath, QueryDate, Server, OutCode)
Argumentos
Property String A propriedade do Module Database que corresponde ao
ponto do PI para o qual a funo retorna valores.
ModulePath String O caminho completo do mdulo para a propriedade.
QueryDate Inteiro Uma data de efetividade da propriedade do mdulo do PI. O
PI DataLink retorna os valores que correspondem
propriedade especificada nessa data.
OutCode Inteiro Um cdigo de sada que determina como a funo orienta a
sada:
0
Retorna os valores em uma coluna.
2
Retorna os valores em uma linha.
Exemplos
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")
Retorna o valor correspondente para a propriedade Implementer do mdulo Reactor1, que

um submdulo de Unit1. Unit1 est na raiz do Module Database de um servidor PI Data
Archive chamado thevax. O Module Database pesquisado no horrio atual.
Veja tambm...

Referncia de funo
Funes de entrada
PIPutVal() e PIPutValX()
Escreve um valor no servidor PI Data Archive ou PI AF Server e retorna uma string que indica o
status.
Nota:
Na verso atual do PI DataLink, no h diferena entre a funo PIPutVal e a funo
PIPutValX. Nas verses PI DataLink anteriores PI DataLink 2013, a funo
PIPutValsuportava somente trs tipos de ponto de PI tradicionais: real, inteiro e digital.
Nessas verses do PI DataLink, a funo PIPutValX adiciona suporte aos pontos de
string e timestamps de subsegundos.
Sintaxe
PIPutVal(DataItem, Value, TimeStamp, RootPath, OutCell)
PIPutValX(DataItem, Value, TimeStamp, RootPath, OutCell)
Argumentos
DataItem String O nome do ponto do PI ou do atributo do PI AF no qual a
funo grava um valor.
Value Referncia Uma referncia para uma clula que contm o valor a ser
gravado, seja uma string ou um nmero.
TimeStamp String O horrio do valor. Veja Entradas de tempo.
OutCell Referncia A referncia da clula onde o PI DataLink grava a string que a
funo de macro retorna. A string retornada varia:
Se a gravao for bem-sucedida:
A funo PIPutVal retorna xxx Written, em que xxx
Real ValueInteger, Digital State ou Value,
dependendo do tipo de valor gravado.
A funo PIPutValX retorna Value Written.
Se a gravao falhar, a funo retornar um cdigo de
erro, por exemplo, [-5] Tag not found.
Notas
As funes PIPutVal e PIPutValXno podem gravar em atributos PI AF que so atributos de
configurao. Essas funes podem gravar somente em atributos PI AF em que a caixa de
seleo Item de configurao no est marcada. Voc pode verificar o status da caixa de
seleo na guia Atributos no PI System Explorer.
As funes PIPutVal e PIPutValX suportam todos os tipos de dados PI Data Archive. As
funes interpretam timestamps usando as informaes de fuso horrio do computador cliente
para PI Data Archive, exceto se a configurao Fuso horrio do PI Data Archive estiver ativada.
As funes no verificam o intervalo especificado pelo usurio para um ponto antes de gravar
um valor. O intervalo definido como zero para zero + span, em que zero e span so atributos
do ponto especificados na criao do ponto. A funo retorna uma string Value Written
mesmo quando Over Range ou Under Range est armazenado no PI Data Archive.

Referncia de funo
Exemplos
=PIPutVal("testtag",a5,"t",,e5)
Grava o valor localizado na clula A5 no ponto do PI testtag no servidor PI Data Archive

padro; atribui esse valor a um timestamp de meia noite no dia atual. A funo grava o
resultado da funo de macro na clula E5 da planilha.
Funes obsoletas
Vrias funes foram substitudas por funes mais poderosas. Para oferecer suporte a
planilhas mais antigas que utilizam essas funes substitudas, o PI DataLink suporta as
funes antigas e obsoletas, mas a OSIsoft recomenda utilizar as novas funes
correspondentes.
Funo antiga Nova funo
PICalcVal PIAdvCalcVal
PICalcDat PIAdvCalcDat
PIExTimeVal PIArcVal (com Mode definido como exact time)

Referncia de funo

Soluo de problemas
Veja os tpicos nessa seo em caso de dificuldades ao usar o PIDataLink. Se esses tpicos no
resolverem o problema, contate o Suporte Tcnico (veja Pgina de Contato do Suporte Tcnico
da OSIsoft (https://techsupport.osisoft.com/Contact-Us/)).
Nesta seo
Arquivos de log
Guia PI DataLink no disponvel
Limites de matrizes e clulas
Limites de recuperao de dados
Item de dados no suportado por funo
Duplicar eventos existentes
Segurana
Problemas de conexo do PI Data Archive
Eliminar erro de exceo de tempo de execuo
Dados no atualizam
Arquivos de log
O PI DataLink no gera um arquivo de log genrico. As mensagens de erro nas planilhas podem
ser usadas para diagnosticar os problemas. No entanto, alguns processos especficos geram
arquivos de log:
Instalao
O diretrio ../pipc/dat contm os arquivos de log da instalao,
SetupPIDataLink_x64.log e SetupPIDataLink_x86.log.
Conectividade do servidor PI Data Archive
Examine o arquivo de registro PI Data Archive no PI SMT em caso de problemas de
conectividades do servidor PI Data Archive.
Guia PI DataLink no disponvel

Se a guia PI DataLink no aparece depois da instalao do PI DataLink, talvez seja necessrio
configurar manualmente o suplemento do Excel (consulte Configurao de suplementos do
Microsoft Excel) ou diminuir as configuraes de segurana dos suplementos (consulte
Segurana).
Alguns scripts VBA escritos pelo usurio em planilhas Excel (ou suplementos) reinicializam a
barra de opes principal do Excel. Nesses casos, a guia PI DataLink pode desaparecer mesmo
que o suplemento PI DataLink ainda esteja carregado, e funes incorporadas do PI DataLink
podem funcionar mesmo que a guia PI DataLink em si no esteja disponvel. Reiniciar o Excel
normalmente corrige esse problema.

Soluo de problemas
Limites de matrizes e clulas

O PI DataLink est sujeito s limitaes do Excel quanto ao nmero de elementos em uma
matriz de clculo. Uma nica funo PI DataLink pode retornar no mximo 1.048.576 valores
por recuperao.
O Excel SDK usado pelo PI DataLink limita o tamanho das strings em 255 caracteres. As strings
de entrada para expresses do PI DataLink em uma clula referenciada no podem exceder
esse limite de 255 caracteres.
Da mesma forma, o PI DataLink pode truncar strings de sada, como nomes de pontos do PI,
para 255 caracteres.
Limites de recuperao de dados

O cdigo de erro -11091 indica que uma consulta iniciada por uma funo do PI DataLink
tentou retornar mais eventos do PI Data Archive que o permitido no parmetro de ajuste
ArcMaxCollect.
Como esse limite se aplica a eventos recuperados do arquivo do PI Data Archive, mesmo
funes que retornam um pequeno nmero de valores podem exceder o limite imposto por
esse parmetro de ajuste. Por exemplo, o valor do ponto do PI sinusoid varia constantemente
entre 0 e 100. possvel criar uma funo que retorna valores de amostra de sinusoid a cada
30 segundos por um ano com um filtro para excluir valores menores que 95. Essa funo pode
retornar um nmero relativamente menor de valores, mas recuperar muito mais valores
registrados do arquivo para processar a consulta.
Se voc receber esse erro, considere modificar seu critrio de pesquisa para reduzir os dados
recuperados. Por exemplo, voc pode reduzir o perodo de tempo durante o qual a funo
recupera valores.
Item de dados no suportado por funo

A mensagem Data item not supported by function retornada pode indicar:
Um atributo do PI AF usa uma referncia de dados customizada que no permite clculos.
Para usar o PI DataLink, modifique o cdigo da referncia de dados personalizada para
permitir o uso de mtodos de acesso a dados. Isso desabilitado por padro.
A funo Dados calculados tentou fazer um clculo sumarizado em um atributo do PI AF do
tipo Matriz do ponto do PI.
Duplicar eventos existentes

A mensagem retornada Duplicate event exists: specify index for EventName
indica que o evento pai na linha da planilha contm mais de um evento filho chamado
EventName. Para resolver, altere a especificao da funo Comparar eventos para usar uma
verso indexada do evento do atributo exibido nessa coluna.
Quando um evento pai tem eventos filho com nomes duplicados, o PI DataLink adiciona
automaticamente um ndice para o nome do evento filho na janela Adicionar atributos. Se
outros eventos no mesmo nvel no tiverem nomes duplicados, eles no tero o ndice. Para
obter mais detalhes, veja .

Soluo de problemas
Segurana
As caractersticas de segurana do Excel para suplementos, controles ActiveX e macros
controlam os tipos de componentes que podem ser executados dentro do Excel. As
configuraes de segurana desabilitam, habilitam com consulta ou habilitam completamente
esses tipos de objeto.
As configuraes de segurana do Excel podem conflitar com certos recursos do PI DataLink.
O PI DataLink um suplemento do Excel. As configuraes de segurana que desabilitam
suplementos impedem a execuo do PI DataLink no Excel.
As tendncias usam um controle ActiveX com assinatura marcada segura para inicializao
e requerem que controles ActiveX estejam habilitados.
As planilhas contendo uma funo PIPutVal() ou PIPutValX () usam macros e
requerem que essas macros estejam habilitadas (consulte PIPutVal() e PIPutValX()).
Se a segurana do Excel for aplicada regularmente s planilhas, ou problemas forem
encontrados usando recursos do PI DataLink, talvez seja necessrio reduzir ou eliminar as
configuraes de segurana do Excel, dependendo de como se planeja usar o PI DataLink.
Para obter mais informaes sobre a segurana do Excel, consulte a Ajuda e os recursos on-line
do Microsoft Excel.
Problemas de conexo do PI Data Archive

Esta verso do PI DataLink usa configuraes de segurana restritas para conexo ao PI Data
Archive. As novas configuraes reduzem a exposio a fragilidades de segurana associadas
autenticao de senha do PI. Para obter mais informaes, veja o boletim de suporte Alerta de
segurana: vulnerabilidade de autenticao do PI (https://techsupport.osisoft.com/
Troubleshooting/Alerts/AL00206).
As novas configuraes de segurana podem resultar em erros se o PI DataLink usa:
Nomes de usurio e senhas PI para se conectar ao PI Data Archive
Usurio padro para se conectar ao PI Data Archive
Especificamente, essas configuraes podem gerar o seguinte erro:
Cannot connect to the PI Data Archive. Windows authentication trial
failed because insufficient privilege to access the PI Data Archive.
Trust authentication trial failed because insufficient privilege to
access the PI Data Archive.
Para resolver esses erros, voc pode:
Configurar PI mappings para usurios que se conectam ao PI Data Archive.
A OSIsoft recomenda essa abordagem (disponvel no PI Data Archive verso 3.4.380 e
posteriores). Esse o mtodo mais seguro de conexo. Para informaes sobre a criao de
PI mappings, veja PI Data Archive Security Configuration Guide ou PI Live Library (https://
livelibrary.osisoft.com). Para usar mapeamentos do PI, voc deve habilitar tambm o
protocolo de autenticao Windows Security em cada computador que executa o PI
DataLink.
Configurar PI trusts para usurios que se conectam ao PI Data Archive.
Essa a melhor abordagem em seguida. Para informaes sobre a criao de PI trusts, veja
PI Data Archive Security Configuration Guide ou PI Live Library (https://

Soluo de problemas
livelibrary.osisoft.com). Para usar o PI trust, voc deve habilitar tambm o protocolo de

autenticao PI Trust em cada computador que executa o PI DataLink.
Configure cada computador para permitir um prompt de login explcito quando um
mapeamento do PI ou PI trust no estiver disponvel.
A OSIsoft no recomenta essa abordagem. Logins explcitos no so seguros. Com essa
abordagem, voc deve inserir seu nome de usurio e senha na primeira vez em que se
conectar a cada PI Data Archive em uma sesso particular do Microsoft Excel.
Nota:
Inserir uma senha incorreta em um prompt de login pode resultar na mesma mensagem
de erro.
Nesta seo
Habilitar um protocolo de autenticao
Configurar um computador para permitir prompts de login explcitos
Insira as credenciais de login do Gerenciador de conexes
Habilitar um protocolo de autenticao

Para se conectar a um PI Data Archive com um PI mapping ou PI Trust definido, use o PI SDK
Utility para habilitar o protocolo correspondente no computador. Deve-se configurar cada
computador no qual uma conexo com o PI Data Archive estiver estabelecida usando um PI
mapping ou um PI trust.
Procedimento
1. Clique em Iniciar > Todos os Programas > PI System > PISDKUtility para abrir o PI SDK
Utility.
2. Em PI-SDK, clique em Conexes para mostrar os servidores PI Data Archive disponveis e
atualizar os menus do utilitrio.
3. Clique em Conexes > Opes para abrir a janela Opes de conexo.
4. Em Especificar Procedimento de Autenticao, use as setas para mover e ordenar os
protocolos habilitados listados em Ordem dos protocolos. Lista de protocolos necessrios:
Para usar o PI mapping, o Windows Security deve estar listado. Esse deve ser o primeiro
protocolo na lista Ordem dos protocolos.
Para usar o trusts do PI, o PI Trust deve estar listado.
5. Clique em OK.
Configurar um computador para permitir prompts de login explcitos

Para conectar ao PI Data Archive por meio da autenticao de um usurio PI, use o PI SDK
Utility para configurar seu computador e permitir prompts de login explcitos. Configure cada
computador que deseja conectar ao PI Data Archive por meio de um login como um usurio PI.
CUIDADO:
A OSIsoft recomenda selecionar um mtodo alternativo, mais seguro, para se conectar ao
PI Data Archive.

Soluo de problemas
Procedimento
1. Clique em Iniciar > Todos os Programas > PI System > PISDKUtility para abrir o PI SDK
Utility.
2. Clique em Conexes > Opes para abrir a janela Opes de conexo.
3. Marque a caixa de seleo Permitir prompt de login (se todos os protocolos configurados
falharem).
4. Clique em OK.
O que Fazer Depois

Insira seu nome de usurio e senha para acessar o PI Data Archive em cada nova sesso do
Excel. possvel acessar o prompt de conexo ao pesquisar no PI Data Archive com a
ferramenta Pesquisar ou ao se conectar manualmente a partir do Gerenciador de conexes.
Veja Insira as credenciais de login do Gerenciador de conexes.
Insira as credenciais de login do Gerenciador de conexes

Se voc se conectar ao PI Data Archive efetuando login como usurio do PI, ser necessrio
inserir nome de usurio e senha para cada PI Data Archive ao qual voc se conectar durante
cada sesso do Excel.
Antes de Iniciar
Configurar um computador para permitir prompts de login explcitos.
Procedimento
Configuraes.
2. Clique em Gerenciador de conexes para abrir a janela Servidores.
3. Na lista de servidores, clique com o boto direito no servidor PI Data Archive que deseja se
conectar e clique em Conectar como para abrir a janela Conectar ao PI Data Archive.
4. Na lista Autenticao, selecione Autenticao do usurio do PI.
Se a janela no exibir a lista Autenticao, ser necessrio configurar o computador para
permitir prompts de login explcitos.
5. Insira seu nome de usurio e senha e clique em OK.
Eliminar erro de exceo de tempo de execuo

Pesquisas de servidores PI Data Archive com grandes bancos de dados de pontos podem
atingir o tempo limite de espera antes que o servidor PI Data Archive retorne os resultados. A
seguinte mensagem de erro pode ser exibida:
OSIsoft.PI.Net.PITimeoutException: [-10722] PINET: Timeout on PI RPC or
System Call.
Para eliminar esse erro, use o Gerenciador de conexes para aumentar o valor do tempo limite
dos dados.

Soluo de problemas
Procedimento
Configuraes.
2. Clique em Gerenciador de conexes para abrir a janela Servidores.
3. Clique com o boto direito no servidor PI Data Archive que retornou o erro e, ento, clique
em Propriedades para abrir a janela Propriedades do PI Data Archive.
4. Aumente o valor do campo Tempo de espera de dados e clique em OK.
Dados no atualizam
O PI DataLink armazena em cache dados de configurao dos pontos do PI e dados no
baseados no PI time AF (ou seja, dados diferentes dos eventos e da referncia de dados do
ponto do PI). Como resultado, os dados inseridos nas planilhas talvez no sejam atualizados
para mostrar os valores com base na configurao alterada ou em dados no baseados em
horrio, mesmo quando a funo recalculada. Antes de calcular uma funo, o PI DataLink
verifica quando o cache foi limpo. Se o cache no foi limpo nas ltimas seis horas, o PI DataLink
faz a limpeza automaticamente. Para limpar o cache e obter os dados atualizados com
antecedncia, execute uma das seguintes aes:
Clique em Limpar cache na janela Configuraes. Veja Gerenciar configuraes do PI
DataLink.
Feche e abra novamente o Microsoft Excel.

Suporte tcnico e outros recursos
Para obter assistencia tecnica, fale com o Suporte Tecnico da OSIsoft no telefone +1
510-297-5828 ou na pgina Suporte Tecnico da OSIsoft - Entre em Contato (https://
techsupport.osisoft.com/Contact-Us/). O site oferece opes de contato adicionais para os
clientes fora dos Estados Unidos.
Ao contatar o Suporte Tcnico da OSIsoft, tenha estas informaes em mos:
Nome do produto, verso e nmeros de compilao
Detalhes sobre a plataforma do computador (tipo da CPU, sistema operacional e nmero da
verso)
Horrio em que o problema comeou
Arquivos de log nesse horrio
Detalhes de todas as alteraes no ambiente anteriores ao incio do problema
Resumo do problema, inclusive os arquivos de log relevantes durante o horrio em que o
problema ocorreu
Para fazer perguntas a outros usurios do software OSIsoft, entre na comunidade de usurios
do OSIsoft, PI Square (https://pisquare.osisoft.com). Os membros da comunidade podem
solicitar conselhos e compartilhar ideias sobre o PI System. O espao PI Developers Clube
dentro do PI Square oferece recursos para ajud-lo na programao e integrao dos produtos
OSIsoft.

Suporte tcnico e outros recursos

PI DataLink 2015 User Guide PT

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

PI DataLink 2015 User Guide PT

Uploaded by

Copyright:

Available Formats

PI DataLink 2015

Guia do usurio do PI DataLink 2015

Guia do usurio do PI DataLink 2015 iii

Comparar eventos incluindo eventos filho........................................................................................... 41

Uso e manuteno da planilha..............................................................................83

iv Guia do usurio do PI DataLink 2015

Orientaes para entrada manual de argumentos............................................................................... 97

Funes Tag...................................................................................................... 101

Objetos do PI Module Database..........................................................................109

Referncia de funo......................................................................................... 119

Guia do usurio do PI DataLink 2015 v

Soluo de problemas........................................................................................ 153

Suporte tcnico e outros recursos....................................................................... 159

vi Guia do usurio do PI DataLink 2015

Viso geral do PI DataLink

Guia do usurio do PI DataLink 2015 1

PI DataLink Server (DLS)

Sobre esta verso

Requisitos do PI System para o PI DataLink

2 Guia do usurio do PI DataLink 2015

Tipos de dados suportados

Guia do usurio do PI DataLink 2015 3

O que Fazer Depois

Para alterar as configuraes padro do PI DataLink, consulte o artigo da Base de

4 Guia do usurio do PI DataLink 2015

distribuio de software pode usar a instalao silenciosa para implantar software

Ver PI DataLink em um idioma com suporte

Preferncias de conexo para coletivos do PI Data Archive

Configurao do PI Data Archive

Guia do usurio do PI DataLink 2015 5

Banco de dados do firewall

Configurao de suplementos do Microsoft Excel

6 Guia do usurio do PI DataLink 2015

Ver status do suplemento

Habilitar um suplemento desabilitado

Ativar um suplemento inativo

Guia do usurio do PI DataLink 2015 7

3. Na lista Gerenciar, selecione Suplementos de COM e clique em Ir.

Segurana do arquivo do Excel

8 Guia do usurio do PI DataLink 2015

Configurao de suplementos do Excel

Adicionar o certificado do PI DataLink para armazenar certificados

Guia do usurio do PI DataLink 2015 9

Prticas de segurana organizacional

10 Guia do usurio do PI DataLink 2015

Estratgias para registro

Sobre este documento

Guia do usurio do PI DataLink 2015 11

12 Guia do usurio do PI DataLink 2015

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

Guia do usurio do PI DataLink 2015 13

Painis de tarefas de funo

14 Guia do usurio do PI DataLink 2015

Viso Geral das funes do PI DataLink

Guia do usurio do PI DataLink 2015 15

16 Guia do usurio do PI DataLink 2015

Digitar o texto diretamente no campo de edio, como um nome de atributo do PI AF ou o

Guia do usurio do PI DataLink 2015 17

18 Guia do usurio do PI DataLink 2015

Guia do usurio do PI DataLink 2015 19

Funo Pesquisa do Filtro de Ativos

Pesquisar itens de dados

20 Guia do usurio do PI DataLink 2015

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