Академический Документы
Профессиональный Документы
Культура Документы
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
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
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
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
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
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
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
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
Nesta seo
Requisitos do PI System para o PI DataLink
Compatibilidade de atualizao
Tipos de dados suportados
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:
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.
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.
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/).
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
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.
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/).
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
Tendncias
Notificaes
Nesta seo
Ver status do suplemento
Habilitar um suplemento desabilitado
Ativar um suplemento inativo
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
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. Na lista Gerenciar, selecione Itens Desabilitados e clique em Ir.
4. Marque a caixa de seleo ao lado do suplemento.
5. Clique em Habilitar.
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.
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
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).
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
Privilgios da conta
Para evitar danos causados por usurios mal-intencionados, atribua aos usurios os acesso
menos privilegiado, por exemplo, permisses de somente leitura.
segura e que os invasores no possam modificar o contedo dos arquivos nem buscar
informaes no arquivo.
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.
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.
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.
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
Painis de tarefas de funo
Veja tambm
Painis de tarefas de funo
Entrada manual de funes
Nesta seo
Itens de dado
Entrada de dados
Entradas de tempo
Dados anexados
Formatos de exibio
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
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:
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
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:
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.
Valores interpolados
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:
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.
Nesta seo
Pesquisar itens de dados
Pesquisar ativos por filtro
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.
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.
Veja tambm...
Criar uma exibio relacionada a ativos
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
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.
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.
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.
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.
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.
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.
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.
Nesta seo
Processo de criao de planilhas
Recuperao de grandes quantidades de dados
Exibies relacionadas a ativos
Eventos na planilha
Veja tambm
Funes do PI DataLink
Pesquisar itens de dados
PI DataLink Server (DLS)
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
Pesquisar itens de dados
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 .
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.
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:
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.
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.
Nesta seo
Explorar eventos relacionado a um elemento
Explorar eventos com eventos filho
Comparar eventos incluindo eventos filho
Comparar eventos incluindo eventos pai
Nomes reservados do atributo
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.
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.
4. Especifique os resultados da planilha:
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.
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.
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.
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.
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 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.
4. Especifique os resultados da planilha:
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.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir atributo para
remover o atributo da lista.
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.
Se clicar em uma clula antes de abrir o painel de tarefas, o PI DataLink inserir
automaticamente essas clula nesse campo.
5. Clique em OK para inserir a matriz da funo na planilha.
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 Comparar para abrir o painel de tarefas
Comparar 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.
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 Comparar 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.
4. Use a lista Colunas a serem exibidas para especificar as colunas na matriz da funo
retornada.
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. 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.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir atributo para
remover o atributo da lista.
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.
Se clicar em uma clula antes de abrir o painel de tarefas, o PI DataLink inserir
automaticamente essas clula nesse campo.
6. Clique em OK para inserir a matriz da funo na planilha.
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.
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.
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).
Para obter mais informaes sobre a sintaxe do caminho, consulte Notao de caminho para
a funo Comparar eventos.
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 Comparar para abrir o painel de tarefas
Comparar 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.
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 Comparar 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
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.
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. 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.
Clicar com o boto direito do mouse em um atributo e clicar em Excluir atributo para
remover o atributo da lista.
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.
Se clicar em uma clula antes de abrir o painel de tarefas, o PI DataLink inserir
automaticamente essas clula nesse campo.
6. Clique em OK para inserir a matriz da funo na planilha.
Veja tambm...
Painis de tarefas de funo
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 Comparar eventos
Funo Pesquisa do Filtro de Ativos
Funo Propriedades
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()
Recuperao de grandes quantidades de dados
Valores interpolados
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.
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 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()
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados, incluindo aqueles em
expresses. 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.
Entrada Descrio
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.
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.
Veja Valores interpolados.
auto
Retorna valores interpolados, mas usa o mtodo inside para itens de
dado com atributos de etapas.
Entrada Descrio
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.
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()
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.
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados, incluindo aqueles em
expresses. 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 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.
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.
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.
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.
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.
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.
Coluna Clique nessa opo para retornar os valores em uma coluna.
Entrada Descrio
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...
PISampDat()
Especifica um item de dado sem uma expresso de filtro.
PISampFilDat()
Especificar um item de dados sem uma expresso de filtro.
PIExpDat()
Especificar uma expresso.
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.
Entrada Descrio
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.
Veja tambm...
PITimeDat()
Especifica um item de dado.
PITimeExpDat()
Especificar uma expresso.
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados, incluindo aqueles em
expresses. 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 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.
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.
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.
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.
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.
Veja Valores interpolados.
Disponvel se voc selecionar Expresso ou se voc especificar uma
Expresso de filtro.
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.
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...
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
Recuperao de grandes quantidades de dados
Neste exemplo, a funo calcula o intervalo de cada intervalo de uma hora. Pode-se especificar
qualquer clculo disponvel em qualquer intervalo.
Entrada Descrio
Caminho raiz O caminho comum para itens de dado especificados, incluindo aqueles em
expresses. 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.
Expresso(es) Uma Performance Equation lgica avaliada pela funo. Veja Expresses.
Referencia um intervalo de clulas contendo expresses para as quais sero
retornados valores.
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.
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.
Unidades de tempo As unidades de tempo nas quais a funo retorna o resultado.
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.
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.
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 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.
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.
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
templates derivados.
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
abreviao de unidade de tempo.
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.
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
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.
Entrada Descrio
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.
Veja tambm
Eventos na planilha
Adicionar colunas de atributos ao painel de tarefas Explorar eventos
Gerenciar configuraes do PI DataLink
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
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
templates derivados.
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
abreviao de unidade de tempo.
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.
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
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.
Veja tambm
Eventos na planilha
Adicionar atributos de evento filho como colunas no painel de tarefas Comparar eventos
Gerenciar configuraes do PI DataLink
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
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:
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 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.
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.
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.
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.
Nesta seo
Tarefas comuns de matrizes da funo
Atualizar as entradas para uma matriz da funo
Tamanho da matriz:
Redimensionar matrizes
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.
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.
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
Redimensionar matrizes
Gerenciar configuraes do PI DataLink
Redimensionar matrizes
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
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
Gerenciar configuraes do PI DataLink
Ativar Atualizao automtica
Cancelar Atualizao automtica
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
Gerenciar configuraes 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.
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.
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.
Nesta seo
PI time
Expresses
Entrada manual de funes
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
Especificao de timestamp
Especificao de intervalo de tempo
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
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,
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
Especificao de timestamp
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
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
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
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 Valor de Archive
Funo Dados compactados
Funo Dados de amostragem
Funo Dados temporizados
Funo Dados calculados
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
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.
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)
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
Sintaxe das expresses
Restries para itens de dados em expresses
Nesta seo
Definir funes manualmente
Orientaes para entrada manual de argumentos
Cdigos de sada
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.
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.
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:
Veja tambm...
PIPutVal() e PIPutValX()
Veja tambm
Viso Geral das funes do PI DataLink
Funo Propriedades
Tendncias
Nesta seo
Funo point ID para tag
Funo Mscara de atributo para tag
Pesquisar PI Points
Veja tambm...
PIPointIDToTag()
Veja tambm...
PIAttributeMaskToTag ()
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
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.
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
Menu de atalhos de 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:
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.
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.
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.
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.
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.
Nesta seo
O PI Module Database e as planilhas
Inserir objetos do PI Module Database na planilha
Funes Module Database
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.
Veja tambm
Viso Geral das funes do PI DataLink
Nesta seo
Funo Alias do tag
Funo Propriedade para valor
Veja tambm...
PIAliasToTag()
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.
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.
Coluna Clique nessa opo para retornar os valores em uma coluna.
Linha Clique nesta opo para retornar os valores em uma linha.
Veja tambm...
PIPropertyToValue()
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
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.
Antes de Iniciar
Inscreva-se para as notificaes no PI System Explorer.
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.
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.
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.
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.
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.
Nesta seo
Funes Valores nicos
Funes de valores mltiplos
Funes Clculo
Funes Tag
Funes Module Database
Funes de entrada
Funes obsoletas
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)
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")
Veja tambm...
Funo Valor atual
Definir funes manualmente
Orientaes para entrada manual de argumentos
Recuperao de grandes quantidades de dados
Valores interpolados
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
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.
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. Veja Itens de dado.
Exemplos
=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")
Veja tambm...
Funo Valor de Archive
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
Recuperao de grandes quantidades de dados
PIExpVal()
Retorna o valor calculado de uma Performance Equation em um timestamp especificado.
Sintaxe
PIExpVal(Expression, TimeStamp, OutCode, RootPath)
Argumentos
Argumento Tipo Descrio
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")
Veja tambm...
Funo Valor de Archive
Definir funes manualmente
Orientaes para entrada manual de argumentos
PITagAtt()
Retorna o valor de uma propriedade associada a um item de dado especificado.
Sintaxe
PITagAtt(DataItem, Property, RootPath)
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.
Property String O nome do ponto do PI ou do atributo do PI AF
para o qual a funo retorna um valor.
RootPath String O caminho para o item de dado. Veja Itens de dado.
Exemplos
=PITagAtt(d1,"uom",)
Veja tambm...
Funo Propriedades
Nesta seo
PINCompDat()
PINCompFilDat()
PICompDat()
PICompFilDat()
PISampDat()
PISampFilDat()
PIExpDat()
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
Argumento Tipo Descrio
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.
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).
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, 2, 5 e 6.
RootPath String O caminho para o item de dado. Veja Itens de dado.
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...
Funo Dados compactados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
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.
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).
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.
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.
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, 2, 5 e 6.
RootPath String O caminho para o item de dado. Veja Itens de dado.
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
=PINCompFilDat("cdf144","2:00:00",10,"'cdep158'>38",1,1,,)
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...
Funo Dados compactados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
STime String O incio do perodo para o qual a funo retorna
valores. Veja Entradas de tempo.
ETime String O final do perodo para o qual a funo retorna
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, 2, 4, 5 e 6.
RootPath String O caminho para o item de dado. Veja Itens de dado.
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
=PICompDat("cdf144","1:00:00","3:00:00",1,,"inside")
Veja tambm...
Funo Dados compactados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
STime String O incio do perodo para o qual a funo retorna
valores. Veja Entradas de tempo.
ETime String O final do perodo para o qual a funo retorna
valores.
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.
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.
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, 2, 4, 5 e 6.
RootPath String O caminho para o item de dado. Veja Itens de dado.
Exemplos
=PICompFilDat("cdf144","2:00:00","10:00:00","'cdep158'>38",1,1,,)
Veja tambm...
Funo Dados compactados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
STime String O incio do perodo para o qual a funo retorna
valores. Veja Entradas de tempo.
ETime String O final do perodo para o qual a funo retorna
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.
Exemplos
=PISampDat("sinusoid","y","t","3h",1,)
Veja tambm...
Funo Dados de amostragem
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
STime String O incio do perodo para o qual a funo retorna
valores. Veja Entradas de tempo.
ETime String O final do perodo para o qual a funo retorna
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.
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.
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...
Funo Dados de amostragem
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
PIExpDat()
Retorna valores calculados, regularmente espaados, de uma Performance Equation durante
um perodo especificado.
Sintaxe
PIExpDat(Expression, STime, ETime, Interval, OutCode, RootPath)
Argumentos
Argumento Tipo Descrio
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.
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...
Funo Dados de amostragem
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
Veja Entradas de tempo.
RootPath String O caminho para o item de dado. Veja Itens de dado.
Mode String O mtodo usado pela funo para recuperar dados:
interpolated
exact time
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...
Funo Dados temporizados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
PITimeExpDat()
Retorna valores de uma Performance Equation em timestamps especificados.
Sintaxe
PITimeExpDat(Expression, TimeStamps, RootPath)
Argumentos
Argumento Tipo Descrio
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.
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,)
Essa funo requer uma matriz de sada horizontal com doze clulas, como C1:C12 ou B14:B25.
Veja tambm...
Funo Dados temporizados
Definir funes manualmente
Orientaes para entrada manual de argumentos
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()
PIAdvCalcExpFilVal()
PIAdvCalcDat()
PIAdvCalcFilDat()
PIAdvCalcExpDat()
PIAdvCalcExpFilDat()
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
Argumento Tipo Descrio
DataItem String O nome do ponto do PI ou do atributo do PI AF para o qual a
funo calcula um valor. Referencie um intervalo de clulas
contendo nomes dos pontos do PI ou dos atributos do PI AF
para os quais ser calculado um valor.
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.
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...
Funo Dados calculados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Recuperao de grandes quantidades de dados
PIAdvCalcFilVal()
Retorna o valor calculado de valores do ponto do PI ou do atributo do PI AF filtrados durante
um perodo especificado.
Sintaxe
PIAdvCalcFilVal(DataItem, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento Tipo Descrio
DataItem String O nome do ponto do PI ou do atributo do PI AF para o qual a
funo calcula um valor. Referencie um intervalo de clulas
contendo nomes dos pontos do PI ou dos atributos do PI AF
para os quais ser calculado um valor.
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.
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.
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
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
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).
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 2, 3 e 9 (se Mode estiver
definido como minimum, maximum ou range).
RootPath String O caminho para o item de dado. Veja Itens de dado.
Exemplos
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total","time-
weighted","compressed","10m",50,1,4,)
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...
Funo Dados calculados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
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.
Exemplos
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","time-
weighted","compressed","10m",50,1,4,)
Veja tambm...
Funo Dados calculados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
PIAdvCalcExpFilVal()
Retorna um valor de um ponto do PI calculado e filtrado baseado em uma Performance
Equation.
Sintaxe
PIAdvCalcExpFilVal(Expression, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento Tipo Descrio
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.
Exemplos
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
Veja tambm...
Funo Dados calculados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
DataItem String O nome do ponto do PI ou do atributo do PI AF para o qual a
funo calcula valores. Referencie um intervalo de clulas
contendo nomes dos pontos do PI ou dos atributos do PI AF
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.
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...
Funo Dados calculados
Definir funes manualmente
Orientaes para entrada manual de argumentos
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)
Argumentos
Argumento Tipo Descrio
DataItem String O nome do ponto do PI ou do atributo do PI AF para o qual a
funo calcula valores. Referencie um intervalo de clulas
contendo nomes dos pontos do PI ou dos atributos do PI AF
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.
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.
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
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
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).
Exemplos
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""", "total","time-
weighted","compressed","10m",50,1,4,)
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
ignora a frequncia da amostragem e exemplifica a expresso do filtro nos eventos
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...
Funo Dados calculados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
PIAdvCalcExpDat()
Retorna valores regularmente espaados calculados por uma Performance Equation durante
um perodo especificado.
Sintaxe
PIAdvCalcExpDat(Expression, STime, ETime, Interval, Mode, CalcBasis,SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento Tipo Descrio
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 valores. Veja
Entradas de tempo.
ETime String O final do perodo para o qual a funo calcula valores.
Exemplos
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total", "time-
weighted","compressed", "10m",50,1,4,)
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...
Funo Dados calculados
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
PIAdvCalcExpFilDat()
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
Argumento Tipo Descrio
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 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.
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.
Mode String O tipo de clculo que a funo executa:
total
minimum
maximum
stdev
range
average
count
mean
Exemplos
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'="Product2"","tot
al","time-weighted","compressed","10m",50,1,4,)
Veja tambm...
Funo Dados calculados
Expresses de filtro
Definir funes manualmente
Orientaes para entrada manual de argumentos
Valores interpolados
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
Argumento Tipo Descrio
Expression String Uma Performance Equation lgica avaliada pela funo. 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 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.
TimeUnit String Unidade de tempo do resultado calculado:
seconds
minutes
hours
days
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 2, 3, 7 e 8.
Exemplos
=PITimeFilter($A$1,"y","t","1h","seconds",65,"thevax")
Veja tambm...
Funo Tempo Filtrado
Definir funes manualmente
Orientaes para entrada manual de argumentos
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
Argumento Tipo Descrio
Expression String Uma Performance Equation lgica avaliada pela funo. Veja
Expresses.
Referencia um intervalo de clulas contendo expresses para
as quais sero retornados valores.
Exemplos
=PITimeFilterVal($A$1,"y","t","seconds",0,"thevax")
Veja tambm...
Funo Tempo Filtrado
Definir funes manualmente
Orientaes para entrada manual de argumentos
Funes Tag
As funes tag ajudam a trabalhar com tags do PI.
Nesta seo
PIPointIDToTag()
PIAttributeMaskToTag ()
PIPointIDToTag()
Retorna o nome do ponto do PI que corresponde a uma ID de ponto do PI especfico.
Sintaxe
PIPointIDToTag(PointID, Server)
Argumentos
Argumento Tipo Descrio
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...
Funo point ID para tag
PIAttributeMaskToTag ()
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
Argumento Tipo Descrio
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.
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...
Funo Mscara de atributo para tag
PIAliasToTag()
Retorna o nome do ponto do PI que corresponde a um alias do PI especfico.
Sintaxe
PIAliasToTag(Alias, ModulePath, QueryDate, OutCode, Server)
Argumentos
Argumento Tipo Descrio
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.
Exemplos
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
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
Argumento Tipo Descrio
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.
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.
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")
Veja tambm...
Funo Propriedade para valor
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
Argumento Tipo Descrio
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.
RootPath String O caminho para o item de dado. Veja Itens de dado.
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.
Exemplos
=PIPutVal("testtag",a5,"t",,e5)
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)
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.
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.
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
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.
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.
Antes de Iniciar
Configurar um computador para permitir prompts de login explcitos.
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.
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.
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.
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.