PI System Explorer 2014 R2 User Guide PT

PI System Explorer
Guia do Usuário
Para o PI Asset Framework 2.6.1 incluído no PI Server 2014 R2

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

© 2009-2014 by OSIsoft, LLC. Todos os direitos reservados.
Nenhuma parte desta publicação pode ser reproduzida, armazenada em um sistema de recuperação ou
transmitida, em qualquer forma ou por quaisquer meios, sejam mecânicos, de fotocópia, registro ou
outro, sem a prévia autorização por escrito da OSIsoft, LLC.
OSIsoft, o logotipo e o logo OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset
Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI
BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI Web API,
PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports e RtWebParts são
marcas comerciais da OSIsoft, LLC. Todas as outras marcas ou nomes comerciais usados neste documento
são de propriedade de seus respectivos proprietários.
DIREITOS DO GOVERNO DOS EUA
O uso, a duplicação ou a divulgação pelo Governo dos EUA estão sujeitos às restrições definidas no
contrato de licença da OSIsoft, LLC e conforme fornecido nas DFARS 227.7202, DFARS 252.227-7013, FAR
12.212, FAR 52.227, conforme aplicável. OSIsoft, LLC.
Versão: 2.6.1
Publicado em: Julho de 2014
Conteúdo
Introdução ao PI Asset Framework......................................................................... 1
Como ativos são representados no PI AF................................................................................................... 1
Ferramentas para trabalhar com o PI Asset Framework............................................................................ 2
Usar o PI System Explorer......................................................................................3

Componentes da interface de usuário PI System Explorer......................................................................... 3
Trabalhar com o conteúdo do visualizador............................................................................................ 4
Ajustar configurações de idioma........................................................................................................... 8
Fazer check in e check out do trabalho......................................................................................................8
Atalhos do teclado.................................................................................................................................. 10
Alterar o idioma.......................................................................................................................................11
Importar e exportar bancos de dados e objetos de banco de dados......................................................... 12
Importar e exportar um banco de dados.............................................................................................. 12
Exportar objetos de biblioteca para outro banco de dados...................................................................15
Conectar aos servidores e bancos de dados............................................................17

Gerenciar as preferências de conexão do PI System Explorer...................................................................17
Conectar aos PI AF Servers......................................................................................................................18
Conectar a um PI AF Server................................................................................................................. 18
Adicionar um PI AF Server à lista de conexões..................................................................................... 19
Alternar membros do coletivo............................................................................................................. 22
Trocar para um membro coletivo específico........................................................................................ 23
Conectar aos PI Servers...........................................................................................................................23
Conectar a um PI Server...................................................................................................................... 23
Adicionar um PI Server a uma lista de conexões.................................................................................. 25
Exibir Status do Buffer para um PI Server............................................................................................ 26
Conectar aos bancos de dados PI AF....................................................................................................... 26
Bancos de dados PI AF........................................................................................................................ 26
Criar um banco de dados..................................................................................................................... 27
Visualizar ou editar propriedades de um banco de dados..................................................................... 27
Configurar o banco de dados padrão................................................................................................... 27
Renomear um banco de dados............................................................................................................ 28
Pesquisar um banco de dados............................................................................................................. 28
Atualizar a lista de bancos de dados.................................................................................................... 28
Sobre a exclusão dos bancos de dados................................................................................................ 28
Configurar permissões de segurança para um banco de dados............................................................ 28
Configurar permissões de segurança para todos os banco de dados.................................................... 29
Encontrar e visualizar informações de ativos..........................................................31

Procurar ativos........................................................................................................................................ 31
O que é exibido no navegador..............................................................................................................31
Procurar elementos............................................................................................................................. 31
Procurar outros objetos....................................................................................................................... 32
Configurar tamanho de página do navegador...................................................................................... 33
Abrir janelas adicionais do navegador.................................................................................................. 33
Pesquisar ativos e dados de ativos........................................................................................................... 33
Pesquisa rápida................................................................................................................................... 34
Paginar os resultados da pesquisa....................................................................................................... 34
Pesquisar em uma data específica....................................................................................................... 35
Pesquisar PI Points.............................................................................................................................. 35
Pesquisar elementos............................................................................................................................37
Pesquisar atributos em elementos...................................................................................................... 40
Pesquisar estruturas de eventos.......................................................................................................... 42
Guia do Usuário do PI System Explorer iii

Conteúdo
Pesquisar atributos nas estruturas de eventos..................................................................................... 43

Pesquisar uma transferência............................................................................................................... 44
Pesquisar atributos em transferências................................................................................................. 45
Criar uma tendência no PI System Explorer.............................................................................................46
Fazer alterações em equipamentos e processos...................................................................................... 47
Criar uma versão de um elemento ou modelo......................................................................................47
Criar uma versão de tabela.................................................................................................................. 48
Exibir versões de objetos diferentes e objetos obsoletos..................................................................... 48
Visualizar dados das séries de tempo.......................................................................................................51
Estatísticas.......................................................................................................................................... 52
Ponderado.......................................................................................................................................... 52
Expressão de filtro............................................................................................................................... 53
Tipo de limite...................................................................................................................................... 54
Restrições na visualização dos dados da série de tempo...................................................................... 54
Abreviaturas de configuração do atributo............................................................................................55
Projetar e implementar os modelos de ativos do PI AF............................................57

Organizar modelos de ativos................................................................................................................... 57
Estruturar o modelo de ativo............................................................................................................... 57
Como decidir sobre uma hierarquia..................................................................................................... 58
Criar várias visualizações de ativos...................................................................................................... 59
Usar categorias para facilitar a procura de objetos...............................................................................61
Representar ativos no PI Asset Framework..............................................................................................63
Usar templates para modelar ativos.................................................................................................... 63
Usar elementos para representar ativos.............................................................................................. 69
Segurança do objeto PI AF...................................................................................................................... 72
Configurar permissões para objetos.................................................................................................... 72
Configurar permissões para coleções................................................................................................... 77
Associação de dados com ativos..............................................................................................................78
Criar um template de atributo............................................................................................................. 78
Trabalhar com conjuntos de enumerações.......................................................................................... 80
Definir os valores constantes do atributo.............................................................................................81
Configurar referências de dados..........................................................................................................84
Trabalhar com unidades de medida.......................................................................................................126
Unidades de medida PI AF................................................................................................................. 126
Classes base e derivadas.................................................................................................................... 127
Criar uma nova unidade de medida.................................................................................................... 127
Criar uma nova classe UDM............................................................................................................... 128
Classes base UDM............................................................................................................................. 129
Algumas classes derivadas de UDMs comuns.................................................................................... 129
Análise com base em ativos para o PI Server........................................................ 131

Sobre análises........................................................................................................................................131
Usar templates de análise.................................................................................................................. 132
Agendamento de análise................................................................................................................... 132
Atualizar análises e templates de análise........................................................................................... 133
Expressões.........................................................................................................................................133
Análises de expressão............................................................................................................................134
Criar um template de análise da expressão........................................................................................ 135
Criar uma análise de expressão.......................................................................................................... 135
Análises de sinterização.........................................................................................................................136
Crie um template de análise de sintetização.......................................................................................137
Crie uma análise de sintetização........................................................................................................ 138
Análises de geração da estrutura de eventos......................................................................................... 139
Criar um template de análise de geração da estrutura de eventos......................................................140
Crie uma análise de geração da estrutura de eventos......................................................................... 141
Especificar por quanto tempo um gatilho de início deve permanecer verdadeiro............................... 142
iv Guia do Usuário do PI System Explorer

Conteúdo
Gerenciar análises de um elemento....................................................................................................... 142

Fazer o backfill dos dados de uma análise.......................................................................................... 143
Gerenciar a segurança de análises e templates de análises................................................................ 144
Análises de amostra.............................................................................................................................. 144
Construir uma análise de expressão...................................................................................................144
Criar um template para análises de sintetização................................................................................ 147
Criar automaticamente estruturas de eventos para monitorar dados................................................ 149
Gerenciar análises em um banco de dados AF........................................................................................151
Gerenciamento o Serviço de Análise do PI.............................................................................................152
Exibir estatísticas do serviço de análise.............................................................................................. 152
Exibir ou modificar o serviço de análise.............................................................................................. 153
Configuração do serviço de análise.................................................................................................... 153
Referência de funções de expressão...................................................................................................... 155
Abs.................................................................................................................................................... 155
Acos.................................................................................................................................................. 155
AND.................................................................................................................................................. 156
Ascii.................................................................................................................................................. 156
Asin................................................................................................................................................... 157
Atn.................................................................................................................................................... 157
Atn2.................................................................................................................................................. 158
Avg....................................................................................................................................................158
Badval............................................................................................................................................... 159
Bod....................................................................................................................................................159
Bom.................................................................................................................................................. 160
Bonm................................................................................................................................................ 160
Ceiling............................................................................................................................................... 161
Char...................................................................................................................................................161
Compare........................................................................................................................................... 162
Concat...............................................................................................................................................162
Convert............................................................................................................................................. 163
Cos.................................................................................................................................................... 163
Cosh.................................................................................................................................................. 164
Cot.................................................................................................................................................... 164
Coth.................................................................................................................................................. 165
Csc.................................................................................................................................................... 165
Csch.................................................................................................................................................. 166
Curve.................................................................................................................................................166
Day.................................................................................................................................................... 167
DaySec.............................................................................................................................................. 167
DigState............................................................................................................................................ 168
DigText............................................................................................................................................. 168
E........................................................................................................................................................169
ELSE................................................................................................................................................. 169
EventCount........................................................................................................................................170
Exp.................................................................................................................................................... 170
FindEq............................................................................................................................................... 171
FindGE...............................................................................................................................................172
FindGT............................................................................................................................................... 173
FindLE............................................................................................................................................... 173
FindLT............................................................................................................................................... 174
FindNE...............................................................................................................................................175
Float.................................................................................................................................................. 176
Floor.................................................................................................................................................. 176
Format............................................................................................................................................... 177
Frac....................................................................................................................................................177
Hour.................................................................................................................................................. 178
IF....................................................................................................................................................... 178
Guia do Usuário do PI System Explorer v

Conteúdo
InStr.................................................................................................................................................. 179
IN...................................................................................................................................................... 180
Int..................................................................................................................................................... 180
IsSet.................................................................................................................................................. 181
LCase.................................................................................................................................................181
Left................................................................................................................................................... 182
Len.................................................................................................................................................... 182
Log.................................................................................................................................................... 183
Log10................................................................................................................................................ 183
Logbase............................................................................................................................................ 184
LTrim................................................................................................................................................ 184
Max................................................................................................................................................... 185
Median.............................................................................................................................................. 185
Mid....................................................................................................................................................186
Min.................................................................................................................................................... 187
Minute............................................................................................................................................... 187
Mod...................................................................................................................................................188
Month............................................................................................................................................... 188
NextEvent......................................................................................................................................... 188
NextVal............................................................................................................................................. 189
Noon................................................................................................................................................. 189
NoOutput..........................................................................................................................................190
Normalrnd.........................................................................................................................................190
NOT.................................................................................................................................................. 191
OR..................................................................................................................................................... 191
ParseTime......................................................................................................................................... 192
PctGood............................................................................................................................................ 192
Pi....................................................................................................................................................... 193
Poly................................................................................................................................................... 193
Pow................................................................................................................................................... 194
PrevEvent..........................................................................................................................................194
PrevVal..............................................................................................................................................195
PStDev.............................................................................................................................................. 195
Rand..................................................................................................................................................196
Range................................................................................................................................................ 197
Remainder......................................................................................................................................... 197
Right................................................................................................................................................. 198
Round............................................................................................................................................... 199
Roundfrac......................................................................................................................................... 200
RTrim................................................................................................................................................ 200
Sec.................................................................................................................................................... 201
Sech.................................................................................................................................................. 201
Second.............................................................................................................................................. 202
Sgn................................................................................................................................................... 202
Sin.....................................................................................................................................................203
Sinh...................................................................................................................................................203
Sqr.................................................................................................................................................... 204
StateNo............................................................................................................................................ 204
SStDev.............................................................................................................................................. 205
StDev................................................................................................................................................ 205
String................................................................................................................................................ 206
TagAvg..............................................................................................................................................207
TagBad............................................................................................................................................. 208
TagDesc............................................................................................................................................ 208
TagEU............................................................................................................................................... 209
TagExDesc........................................................................................................................................ 209
TagMax............................................................................................................................................. 210
vi Guia do Usuário do PI System Explorer

Conteúdo
TagMean........................................................................................................................................... 211
TagMin.............................................................................................................................................. 211
TagName.......................................................................................................................................... 212
TagNum............................................................................................................................................ 213
TagSource......................................................................................................................................... 213
TagSpan............................................................................................................................................ 213
TagTot.............................................................................................................................................. 214
TagType............................................................................................................................................ 215
TagVal............................................................................................................................................... 215
TagZero............................................................................................................................................ 216
Tan....................................................................................................................................................216
Tanh.................................................................................................................................................. 217
Text................................................................................................................................................... 217
THEN................................................................................................................................................ 218
TimeEq..............................................................................................................................................218
TimeGE............................................................................................................................................. 219
TimeGT............................................................................................................................................. 220
TimeLE..............................................................................................................................................221
TimeLT..............................................................................................................................................221
TimeNE............................................................................................................................................. 222
Timestamp........................................................................................................................................ 223
Total..................................................................................................................................................223
Trim.................................................................................................................................................. 224
Trunc.................................................................................................................................................224
UCase................................................................................................................................................225
Yearday.............................................................................................................................................226
Year.................................................................................................................................................. 226
Weekday........................................................................................................................................... 226
Funções de vapor para expressões de análise........................................................................................ 227
Intervalos para entradas da função de vapor..................................................................................... 228
Conversão de unidades de medida para funções de vapor................................................................. 230
Estados de referência das propriedade do vapor................................................................................ 231
Referência das funções de vapor....................................................................................................... 232
Usar estruturas de eventos para capturar eventos de processos............................ 245

Estruturas de eventos............................................................................................................................245
Exemplos de estruturas de eventos................................................................................................... 246
Vantagens das PI Event Frames......................................................................................................... 247
PI Event Frames ou PI Batch?............................................................................................................ 248
Formas de criar estruturas de eventos...................................................................................................248
Templates da estrutura de eventos....................................................................................................... 249
Visualizar estruturas de eventos usando ferramentas cliente................................................................ 249
Representar eventos no PI Asset Framework........................................................................................ 250
Trabalhar com estruturas de eventos................................................................................................ 250
Trabalhar com transferências............................................................................................................ 253
Captura de valores para estruturas de eventos e transferências.........................................................256
Bloquear uma estrutura de eventos ou transferência......................................................................... 257
Tópicos avançados............................................................................................ 259

Strings de configuração do atributo...................................................................................................... 259
Strings de configuração para referências de dados do PI Point.......................................................... 260
Especificação do PI Point...................................................................................................................260
Configuração do valor do atributo..................................................................................................... 261
Strings de configuração para criação automática de pontos.............................................................. 263
Atualizações em massa das strings de configuração.............................................................................. 263
Sintaxe de referência do atributo.......................................................................................................... 265
Sintaxe das especificações de caminho............................................................................................. 265
Guia do Usuário do PI System Explorer vii

Conteúdo
Exemplos de atributos de referência do mesmo elemento ................................................................ 267

Exemplos de atributos de referência de diferentes elementos........................................................... 270
Exemplos de atributos de referências de uma estrutura de eventos para o elemento referenciado
principal ............................................................................................................................................272
Recursos do PI AF.................................................................................................................................. 272
Iniciar o PSE com opções de linha de comando.................................................................................. 272
Exportar objetos PI AF....................................................................................................................... 273
Importar objetos PI AF.......................................................................................................................276
AFDiag: o PI AF Diagnostics Utility.....................................................................................................277
Configurar o PI AF Server Utility........................................................................................................ 285
Capturar a saída do traçado de eventos do AF SDK........................................................................... 286
Monitorar as alterações do AF com a Trilha de Auditoria................................................................... 286
Persistência.......................................................................................................................................... 288
Restrições nos nomes de objeto AF.......................................................................................................289
Inserir valores nos tipos de valores........................................................................................................ 289
Definir o valor do atributo como o nome de outro atributo................................................................289
Criar tipos de referência personalizada..................................................................................................290
Forças do tipo de referência do elemento..........................................................................................290
Tipos de referência predefinidos........................................................................................................291
Criar tipos de referência personalizadas............................................................................................ 292
Copiar caminhos................................................................................................................................... 292
Armazenar informações específicas do aplicativo..................................................................................293
Gerenciar plug-ins................................................................................................................................. 293
Visualizar plug-ins atualmente instalados.......................................................................................... 293
Registro de plug-in da linha de comando...........................................................................................294
Criar um arquivo de registro XML...................................................................................................... 297
Criar um script de registro SQL..........................................................................................................297
Registrar um plug-in usando o script SQL gerado.............................................................................. 298
Gerenciar provedores de plug-in contiguáveis................................................................................... 298
Modelar um processo............................................................................................................................299
Modelar escopo.................................................................................................................................299
Diretrizes para configurar um modelo............................................................................................... 300
Visualizar e editar modelos................................................................................................................300
Criar modelos.................................................................................................................................... 301
Portas e conexões............................................................................................................................. 302
Camadas........................................................................................................................................... 303
Termos do PI AF................................................................................................ 305

Atributos...............................................................................................................................................306
Templates de atributo........................................................................................................................... 306
Templates base..................................................................................................................................... 306
Atributos de configuração..................................................................................................................... 306
Referências de dados.............................................................................................................................307
Atributo padrão..................................................................................................................................... 307
Template de elemento.......................................................................................................................... 307
Elementos............................................................................................................................................. 307
Estrutura de eventos............................................................................................................................. 308
Propriedades estendidas....................................................................................................................... 308
Dados externos..................................................................................................................................... 308
Fonte de dados externa......................................................................................................................... 308
Tabela externa...................................................................................................................................... 308
Conexões representadas....................................................................................................................... 309
Tabela importada..................................................................................................................................309
Atributos indexados.............................................................................................................................. 309
Tabela interna....................................................................................................................................... 309
Tabela vinculada................................................................................................................................... 309
Modelos................................................................................................................................................ 309
viii Guia do Usuário do PI System Explorer

Conteúdo
Conexão não representada.................................................................................................................... 310

Bancos de dados PI AF...........................................................................................................................310
Biblioteca salva do PI AF........................................................................................................................310
PI AF Server...........................................................................................................................................310
Banco de dados SQL do PI AF................................................................................................................310
Tabela................................................................................................................................................... 311
PI Asset Framework (PI AF)....................................................................................................................311
Referência de dados da matriz do PI Point............................................................................................. 311
Referência de dados PI Point................................................................................................................. 312
Dada da Consulta.................................................................................................................................. 312
Parâmetros de substituição................................................................................................................... 312
Templates............................................................................................................................................. 312
Referência de dados da pesquisa de tabela............................................................................................ 313
Unidade de Medida (UDM).................................................................................................................... 313
Suporte técnico e outros recursos....................................................................... 315
Guia do Usuário do PI System Explorer ix

Conteúdo
x Guia do Usuário do PI System Explorer

Introdução ao PI Asset Framework
O PI Asset Framework permite que o usuário represente ativos e processos como objetos PI AF
e estruture-os para fornecer valor aos negócios.
O PI System Explorer e o PI Builder são as ferramentas primárias usadas para criar e gerenciar
objetos PI AF. As duas áreas importantes de funcionalidade fornecidas por eles são:
• Suporte a estruturas de eventos

As estruturas de eventos permitem a captura de eventos importantes do processo. Consulte
Usar estruturas de eventos para capturar eventos de processos para obter uma visão geral
das estruturas de eventos.
• Análises baseadas em ativos

Integradas ao PI System Explorer, as análises baseadas em ativos permitem a criação de
cálculos e a configuração de declarações condicionais envolvendo valores de ativos.
Consulte Análise com base em ativos para o PI Server para obter mais informações.
Nesta seção
• Como ativos são representados no PI AF
• Ferramentas para trabalhar com o PI Asset Framework
Como ativos são representados no PI AF

O PI Asset Framework (PI AF) permite a criação de uma representação do equipamento e dos
processos que podem gerar informações importantes sobre os dados. No PI AF, o equipamento
e os processos a serem monitorados são chamados de ativos. A representação PI AF de todos os
ativos e processos é chamada de modelo de ativo. O modelo de ativo organiza todo o
equipamento em uma estrutura que torna a localização das informações mais fácil.
No modelo de ativo PI AF, cada peça do equipamento é representada por um elemento. Os
dados associados a um elemento são armazenados como atributos no elemento. Os atributos só
podem manter valores simples que representem informações fixas, como o diâmetro de um
tanque. Como alternativa, um atributo pode referenciar um PI Point, uma fórmula, um valor de
um banco de dados relacional, um arquivo, uma fotografia e muito mais. Todos os dados
relevantes de um ativo estão vinculados ao elemento que representa esse ativo.
Por exemplo, suponha-se que haja uma bomba com três peças de dados associadas: a pressão
(lida de um PI Point), a temperatura de entrada e a temperatura de saída. Para modelar isso no
AF, é possível criar um elemento AF para representar a bomba e criar três atributos para
representar os dados associados.
A ilustração a seguir mostra como os dados podem parecer no PI AF. Apesar de todos os
valores serem valores PI Point, o usuário nunca precisa saber os nomes dos PI Points. Todos os
dados estão disponíveis diretamente no elemento.
Guia do Usuário do PI System Explorer 1

Introdução ao PI Asset Framework
Ferramentas para trabalhar com o PI Asset Framework

A OSIsoft fornece duas ferramentas para criar e editar objetos do PI AF:
• O PI System Explorer fornece uma interface gráfica de usuário para criar, editar e gerenciar
objetos do PI AF. Use o PI System Explorer para criar e gerenciar a estrutura de ativos,
inclusive os elementos dos bancos de dados PI AF, os templates e todos os outros objetos PI
AF. Se o PI AF for novidade, inicie com o PI System Explorer.
Para abrir o PI System Explorer pelo menu Iniciar do Windows, selecione Todos os
Programas > PI System > PI System Explorer.
• O PI Builder é um suplemento do Microsoft Excel que permite a edição em massa de objetos
PI AF. Para obter mais informações sobre o PI Builder, consulte PI Builder User Guide.
Além disso, todos os aplicativos cliente do PI permitem que os usuários exibam elementos e
atributos do PI AF.
2 Guia do Usuário do PI System Explorer

Usar o PI System Explorer
O PI System Explorer permite que usuários encontrem informações sobre equipamento e
processos:
• Encontre dados de uma peça do equipamento. Por exemplo: Dados do PI Point, resultados
de cálculo, informações de manutenção etc. Por exemplo, é possível usar o PI System
Explorer para encontrar informações de um tanque específico em uma planta específica.
• Encontre todo o equipamento com valores ou intervalos de valores do atributo especificado.
Por exemplo, encontre todos os tanques fabricados pela empresa XYZ.
O PI System Explorer também tem uma grande variedade de recursos para modelar o
equipamento e os processos.
Nesta seção
• Componentes da interface de usuário PI System Explorer
• Fazer check in e check out do trabalho
• Atalhos do teclado
• Alterar o idioma
• Importar e exportar bancos de dados e objetos de banco de dados
Componentes da interface de usuário PI System Explorer

A seguinte imagem mostra os principais componentes do PI System Explorer.

1. Barra de menu
2. Barra de ferramentas
3. Navegador
4. Painel Navegador
5. Barra de status
6. Palete
7. Visualizador
Nesta seção
• Trabalhar com o conteúdo do visualizador
• Ajustar configurações de idioma
Trabalhar com o conteúdo do visualizador

As próximas seções explicam como configurar os itens exibidos no Visualizador e como
trabalhar com o conteúdo do Visualizador.
Nesta seção
• Controlar o número de objetos no visualizador
• Configurar colunas exibidas
• Selecionar vários objetos para operações
• Mostrar os valores de atributo na unidade de medida de origem
• Alterar a unidade de medida para um valor de atributo
• Copiar objetos do visualizador
• Mostrar atributos como colunas

Controlar o número de objetos no visualizador

Para controlar o número de objetos exibidos no Visualizador, especifique o tamanho máximo
da consulta na janela Opções (clique em Ferramentas > Opções). Se o número de objetos
exceder o limite, a coleção será colocada em páginas, e a única opção de classificação disponível
será por nome. A imagem a seguir mostra as primeira de duas páginas dos objetos disponíveis.
Clique em 2 ou Próximo para ver a segunda página.
Clique em para exibir a janela Selecionar número de página.
Configurar colunas exibidas

No Visualizador, algumas guias mostram colunas de informações. É possível selecionar quais
colunas serão exibidas pelo Visualizador. As colunas disponíveis dependem da guia selecionada
no Visualizador e do objeto selecionado no Navegador. Para especificar as colunas exibidas,
clique em e selecione as colunas desejadas.
Selecionar vários objetos para operações

Para selecionar mais de um objeto para operações, como cópia, exclusão, exportação, check in/
out, alteração de template e assim por diante, use a combinação padrão de mouse e teclado
para selecionar os objetos no Visualizador.
• Para selecionar o grupo de objetos contínuos no Visualizador, clique em um objeto, mova o

cursor para o final do grupo, pressione SHIFT e clique no último objeto do grupo.
• Para selecionar objetos não contínuos, pressione a tecla CTRL enquanto clica em cada objeto
no Visualizador.
• Para selecionar todos os objetos no Visualizador, pressione CTRL+A. Para desmarcar
objetos individuais, pressione CTRL e clique em cada objeto.
Nota:
É possível selecionar vários objetos apenas no Visualizador. Assim como não é possível
selecionar várias pastas na visualização em pasta (visualização em árvore) do Windows
Explorer, não é possível selecionar vários objetos no Navegador do PI System Explorer.
Depois de selecionar os objetos, clique com o botão direito do mouse e selecione a operação a
ser realizada no menu que é exibido.
Mostrar os valores de atributo na unidade de medida de origem

É possível escolher exibir os valores dos atributos nas unidades definidas pela referência de
dados em vez das unidades padrão.
Procedimento
1. Selecione Ferramentas > Opções.
2. Na guia Geral, selecione Use a unidade de medida de origem da tela do atributo.
3. Clique em Apply.
4. Clique em OK para fechar a caixa de diálogo.

Alterar a unidade de medida para um valor de atributo

É possível alterar a unidade de medida (UDM) exibida para um valor de atributo.
Procedimento
1. No visualizador, clique com o botão direito do mouse em um atributo e selecione Alterar
UDM de Exibição.
2. Selecione a nova UDM para o valor.
Copiar objetos do visualizador

É possível copiar objetos individuais ou várias linhas de objetos e colar as informações desses
objetos em uma planilha no formato separado por tab. Use o menu de contexto (selecione e
clique com o botão direito do mouse) e selecione uma destas opções:
• Copiar copia toda uma linha.

• Copiar Caminho copia o objeto e seu caminho, inclusive o PI AF Server (Copiar caminhos).
• Copiar Célula copia o texto em uma única célula.
Uma Linha Selecionada, o Elemento MixTruck, no Tutorial Achocolatado.
Mostrar atributos como colunas

É possível escolher atributos para serem exibidos como colunas no Visualizador.
Procedimento
1. No PI System Explorer, clique no botão Elementos no painel Navegador.
2. Na parte superior do navegador, selecione o contêiner Elementos.
3. No lado direito do Visualizador, clique em e selecione Selecionar Atributos no menu de
pop-up que é exibido. A caixa de diálogo Selecionar Atributos é exibida.

4. Selecione os atributos a serem exibidos no Visualizador:

◦ Selecione o botão Adicionar Atributos a partir de Padrão ou Adicionar Atributos a partir
de Elemento. Os atributos disponíveis aparecem na lista de seleção Atributos no lado
esquerdo da caixa de diálogo. Clique em para mover todos os atributos para a lista
de atributos exibidos (no lado direito da caixa de diálogo) ou clique em para

adicionar apenas o atributo selecionado.
Nota:
Os templates geralmente compartilham atributos do mesmo nome. Só é possível
adicionar um nome por vez. Por exemplo, se a lista já contiver o atributo Volume, não
será possível adicioná-lo novamente.
◦ Na caixa de texto Outro, insira os nomes dos atributos separados por ponto-e-vírgula ou
clique para pesquisar um atributo por nome. Então, clique em Adicionar para
adicionar os atributos à lista de atributos exibidos.
5. Se desejado, ajuste a ordem em que os atributos aparecem na lista de atributos exibidos.
6. Clique em OK para concluir a seleção dos atributos.
Os atributos selecionados aparecem como colunas no Visualizador.
O que Fazer Depois

Para excluir ou incluir atributos adicionais, abra a caixa de diálogo Selecionar Atributos e repita
o processo.
Nesta seção
• Selecionar os atributos de um template
• Selecionar atributos de um elemento
• Selecionar atributos por nome
Selecionar os atributos de um template
Procedimento
1. No Visualizador, clique em e selecione Selecionar Atributos no menu de pop-up que é
exibido.
2. Selecione Adicionar atributos a partir do Padrão.
3. Clique em para escolher um template.
4. Selecione um atributo no template e clique em para adicionar o atributo à lista de

atributos exibidos.
5. Para adicionar mais atributos de templates diferentes, clique em novamente e selecione
outro template.
Note que os templates geralmente compartilham atributos do mesmo nome. Só é possível
adicionar um nome por vez. Por exemplo, se a lista já contiver o atributo Volume, não será
possível adicioná-lo novamente.
7. Clique em OK para concluir a seleção dos atributos. Os atributos selecionados aparecem
como colunas no Visualizador.

Selecionar atributos de um elemento
Procedimento
exibido. A janela Selecionar Atributos é aberta.
2. Selecione Adicionar atributos a partir do Elemento.
3. Clique em para localizar um elemento específico ou em para pesquisar um elemento
por nome.
4. Selecione um atributo no elemento e clique em para adicionar o atributo à lista de
atributos exibidos.
Os atributos selecionados aparecem como colunas no Visualizador.
Selecionar atributos por nome
Procedimento
exibido. A caixa de diálogo Selecionar Atributos é exibida.
2. Em Outros, insira os nomes dos atributos separados por ponto-e-vírgula.
3. Se desejado, clique em para pesquisar um atributo por nome.
4. Clique em Adicionar para adicionar os atributos à lista de atributos exibidos.

7. Os atributos selecionados aparecem como colunas no Visualizador.
Ajustar configurações de idioma

Se vários pacotes de idiomas estiverem instalados, a opção Configurações de Idioma será
exibida no menu Visualizar. Selecione-a e, na janela Ferramentas de Configuração de Idioma do
PI que é exibida, altere o idioma padrão. É necessário fechar e reiniciar o PI System Explorer
para que a alteração se torne efetiva.
Fazer check in e check out do trabalho

As alterações feitas em um objeto precisam ser salvas no banco de dados. As alterações não
salvas são indicadas por um ícone de marca de verificação vermelho . As alterações que
foram aplicadas, mas não foram salvas no banco de dados, são indicadas pelo ícone marca
vermelha escura .

Durante o trabalho, é possível escolher uma destas opções para salvar as alterações:
• Clique em Arquivo > Fazer Check-In.
• Na barra Ferramentas, clique no botão Fazer Check-In.
• No Navegador, clique com o botão direito do mouse no objeto e selecione Fazer Check-In.
As duas primeiras opções permitem que as alterações sejam salvas em todos os objetos
modificados. A caixa de diálogo Fazer Check-In aparece e exibe os objetos modificados. É
possível fazer o check in de todos eles ou selecionar alguns objetos para fazer check in,
permitindo que outros objetos continuem com o check out. Clique no botão Sessão na caixa
de diálogo para selecionar os objetos modificados apenas na versão atual. Ainda é possível
fazer o check in dos objetos modificados em outras sessões.
A terceira opção, mostrada na figura a seguir, salva as alterações no banco de dados para
aquele objeto apenas. Não é feito check in nos outros objetos modificados.

Para que as alterações não sejam salvas, use a opção Desfazer Check Out.
As alterações podem ser feitas em um objeto e aplicadas sem que o check in seja feito. Clique
em Aplicar Alterações, conforme mostrado abaixo.
Atalhos do teclado
O PI System Explorer fornece atalhos do teclado para navegação e outras tarefas que requerem
um mouse ou outro dispositivo de apontar.
Atalho Ação
CTRL+A Seleciona todos os objetos no Visualizador.
CTRL+C Copia o objeto selecionado para a área de
transferência.
CTRL+ALT+C Copia o caminho do objeto selecionado para a área
de transferência.
CTRL+V Cola o objeto da área de transferência no
Visualizador.
CTRL+X Corta (exclui) o objeto selecionado e copia-o para a
área de transferência.

Atalho Ação
DELETE Exclui o objeto selecionado.
SHIFT+DELETE Mesma função de CTRL-X
INSERT Adiciona um novo objeto ao Visualizador ou
Navegador.
HOME Seleciona a primeira linha no Visualizador, por
exemplo, a primeira linha em uma tabela de
atributos.
END Seleciona a última linha no Visualizador.
CTRL+HOME Seleciona a primeira célula da página atual no
Visualizador.
CTRL+END Seleciona a última célula na página atual no
Visualizador.
ALT+HOME Seleciona a primeira página de objetos no
Visualizador.
ALT+END Seleciona a última página do objeto no
Visualizador.
CTRL+PAGE UP Seleciona a página anterior de objetos no
Visualizador.
CTRL+PAGE DOWN Seleciona a próxima página de objetos no
Visualizador.
CTRL+ENTER Se o Visualizador contiver várias páginas de
objetos, exibe a janela Selecionar Número de
Página.
ALT+ENTER No Navegador, exibe as propriedades do objeto
selecionado.
ESPAÇO Pressiona o botão atualmente selecionado.
ou
ENTER
Setas Para Esquerda, Direita, Cima e Baixo Navega nos objetos no Visualizador ou Navegador.
F2 Edita o objeto selecionado no Visualizador. Nos
objetos complexos, exibe a janela de edição do
objeto.
F4 Exibe as seleções na caixa da lista selecionada. Nas
listas em camadas, exibe a hierarquia completa de
,
seleções.
ALT+Seta Para Cima
ou
ALT+Seta Para Baixo
Alterar o idioma
Será possível alterar o idioma de um aplicativo instalado no computador se o Pacote de
Idiomas e os recursos de idioma desejados estiverem instalados. A configuração de idioma é
por local de usuário, por isso, se outras pessoas quiserem usar o aplicativo no mesmo
computador, mas com credenciais de login diferentes, elas poderão usar diferentes recursos de
idiomas, caso estejam disponíveis.

1. Execute o Pacote de Idiomas e selecione os recursos de idiomas que se deseja instalar, caso
eles ainda não estiverem disponíveis.
2. Clique em Visualizar > Configurações de Idioma. A caixa de diálogo Ferramenta de
Configurações de Idioma é exibida.
3. Selecione o idioma desejado e clique em OK.
4. Saia e reinicie o aplicativo.
O aplicativo agora está no idioma especificado. Observe que os usuários que fazem login na
mesma conta veem o mesmo idioma, mas o idioma não é alterado para as pessoas que fazem
login no computador com contas diferentes.
Importar e exportar bancos de dados e objetos de banco de

dados
Nesta seção
• Importar e exportar um banco de dados
• Exportar objetos de biblioteca para outro banco de dados
Importar e exportar um banco de dados

O PI System Explorer permite a exportação de um banco de dados para XML e a restauração
dele pelo arquivo XML importando-o novamente para o PI AF.
Para exportar o banco de dados sem precisar gerenciar arquivos XML, exporte o banco de
dados como uma biblioteca (Salvar um banco de dados como biblioteca).
Nesta seção
• Exportar um banco de dados para XML
• Restaurar um banco de dados
Exportar um banco de dados para XML

Este procedimento arquiva bancos de dados AF em um arquivo XML que pode ser
posteriormente restaurado.
Nota:
Também é possível exportar objetos PI AF de um utilitário de linha de comando. Consulte
Exportar objetos PI AF.
Procedimento
1. Clique em Arquivo > Exportar para Arquivo.
A caixa de diálogo Exportar para Arquivo é exibida.
2. Selecione as opções de exportação desejadas (Opções de exportação XML).
3. Clique em OK.
O PI System Explorer exporta o banco de dados atual em um arquivo XML.
Nesta seção
• Opções de exportação XML
• Formato de arquivo para exportação e restauração

Opções de exportação XML

Caixa de Seleção Resultado
Incluir Todos os Objetos de Referência Esta opção faz com que referências dependentes
sejam exportadas. Por exemplo, se um elemento
estiver sendo exportado, o template de elemento,
as categorias usadas e outros itens também serão
exportados. Use essa opção para facilitar a
movimentação de objetos entre diferentes bancos
de dados PI AF.
Incluir Configurações de Segurança Esta opção faz com que as configurações de
segurança de objetos individuais sejam
exportadas. Essa opção aumenta o volume de
tempo necessário para as operações de exportação
e importação subsequentes. É necessário ter
privilégios administrativos para importar objetos
que usem a configuração de segurança
especificada.
Incluir Valores Padrão Marque esta caixa de seleção para incluir os
valores padrão atribuídos ao objeto. Sem essa
opção, uma propriedade cuja configuração padrão
não foi alterada não está inclusa na saída. Isso
economiza espaço e tempo consideráveis ao
exportar grandes volumes de dados.
Incluir IDs Exclusivos Esta opção inclui o ID exclusivo de cada objeto na
exportação. Ao incluir essa opção, é possível
renomear os itens existentes durante uma
importação para o mesmo banco de dados. Exceto
se a renomeação for necessária, será mais eficiente
deixar essa opção desmarcada.
XML Simples Marque esta caixa de seleção para exportar objetos
hierárquicos em um formato simples. A exportação
para um estilo simples pode simplificar a edição
em algumas ferramentas. Os objetos hierárquicos
que serão exportados em formato simples são
atributos, templates de atributo, elementos e
estruturas de eventos.
Apenas Objetos da Biblioteca Selecionar esta caixa desativará as estruturas de
eventos, transferências e opções de casos.
Simplificar as Strings de Configuração Se esta caixa for marcada, o PI Server e os
identificadores de tag serão removidos das strings
de configuração para referências de dados do PI
Point. Além disso, os parâmetros de substituição
serão resolvidos.
Nota:
Selecionar essa opção desacelera o processo

de exportação, pois ele requer avaliação das
strings de configuração salvas.
Incluir Estruturas de Eventos, Transferências e Marque esta caixa de seleção para exportar
Casos estruturas de eventos, transferências e casos.

Formato de arquivo para exportação e restauração

A opção Importar/Exportar formato XML é descrita em um arquivo de esquema localizado no
diretório de instalação PIPC\AF, OSIsoft.AF.xsd.
Muitos dos Objetos AF são compatíveis com um atributo operacional no XML que permite a
exclusão. Da mesma forma, é possível executar a opção Configuração Automática de Ponto de
forma seletiva nos elementos usando essa mesma técnica. Exemplo:
... <AFElement operation=delete> <Name>ElementToDelete</Name> </AFElement> ...
Elementos e Atributos podem ser importados usando uma lista simples, na qual o caminho
relativo do elemento ou atributo está incluso no campo do nome. Exemplo:
... <AFElement> <Name>RootElement</Name> ... </AFElement> <AFElement>
<Name>RootElement\ChildElement1<\Name> ... </AFElement> <AFElement>
<Name>RootElement\ChildElement2<\Name> ... </AFElement> ...
Restaurar um banco de dados

Este procedimento restaura um banco de dados exportado para XML.
Também é possível importar objetos PI AF de um utilitário de linha de comando. Consulte
Importar objetos PI AF.
Procedimento
1. Clique em Arquivo > Importar de Arquivo. A janela Importar de Arquivo é exibida.
2. Selecione o arquivo XML contendo os dados e as opções apropriadas.
◦ Permitir Criar
Esta opção permite a criação de novos objetos. Se a intenção da operação é atualizar itens
existentes, desative essa opção para evitar a criação acidental de objetos.
◦ Permitir Atualizar
Esta opção permite a atualização de objetos existentes. Se a intenção da operação é
apenas adicionar novos objetos, desative essa opção para evitar a substituição acidental
dos objetos existentes.
◦ Check-in automático
Esta opção permite que a operação de importação faça check in automático dos objetos à
medida que a operação é executada. Isso minimiza os requisitos máximo de memória
para a operação. Use essa opção ao importar grande número de objetos.
◦ Criar ou Atualizar Pontos PI
Esta opção faz com que os atributos cuja configuração do ponto PI tenha sido
especificada no arquivo XML sejam atualizados, se eles já existirem, ou criados, se não
existirem. Essa opção chama a opção CreateConfig da Referência de Dados apropriada,
que cria e atualiza pontos PI, além de resolver seus parâmetros de substituição, servidor
de configuração e IDs do ponto. O desempenho da operação de importação é afetado
quando esta opção está selecionada.
Nota:
O PI Point não será criado a não ser que a caixa de seleção Criação de Tag esteja
marcada na janela Referência de Dados do Ponto PI.

Exportar objetos de biblioteca para outro banco de dados

É possível exportar objetos de biblioteca (templates, fórmulas, UDM e assim por diante) de um
banco de dados para outro.
Nesta seção
• Biblioteca salva do PI AF
• Visualizar bibliotecas atualmente instaladas
• Salvar um banco de dados como biblioteca
• Carregar uma biblioteca de bancos de dados
• Renomear ou editar uma biblioteca de banco de dados
Biblioteca salva do PI AF
A biblioteca salva do PI AF fornece uma coleção de aplicativos ou objetos específicos do
domínio que pode ser importada para um banco de dados PI AF. Normalmente, bibliotecas
salvas incluem categorias, templates de elemento, conjuntos de enumerações, tipos de
referência, tabelas e Banco de dados de unidade de medida. No entanto, quando uma biblioteca
é salva, a opção para incluir outros objetos, como elementos e notificações, fica disponível.
Apesar de o Banco de dados UDM não ser mostrado na guia Biblioteca do Painel Navegador, ele
sempre está incluso como parte de bibliotecas salvas.
Nota:
As bibliotecas são armazenadas como XMLs no Banco de Dados SQL do AF. Isso é muito
diferente da opção Exportar para Arquivo, que exporta todo o banco de dados como um
arquivo XML.
Visualizar bibliotecas atualmente instaladas

Procedimento
1. Selecione Arquivo > Propriedades do AF Server.
A janela Propriedades do AF Server é exibida.
2. Selecione a guia Bibliotecas.
As bibliotecas recentemente instaladas estão relacionadas nesta guia.
Nota:
Clique com o botão direito do mouse na biblioteca para ver suas propriedades.
Salvar um banco de dados como biblioteca

Procedimento
1. Clique em Arquivo > Salvar como Biblioteca. A janela Salvar Banco de Dados como Biblioteca
é exibida.
2. Insira um nome e uma descrição.
3. Selecione Substituir Biblioteca existente sem solicitação para permitir que uma biblioteca
com o mesmo nome seja substituída.

4. Selecione Incluir objetos da não biblioteca para incluir objetos como elemento e notificações
na biblioteca.
5. Clique em OK.
Carregar uma biblioteca de bancos de dados

Procedimento
1. Clique em Arquivo > Carregar Biblioteca. A janela Carregar Biblioteca no Banco de Dados é
exibida.
2. Selecione a biblioteca e clique em OK. O PI System Explorer carrega a biblioteca no banco de
dados atual.
Renomear ou editar uma biblioteca de banco de dados

Procedimento
1. Clique em Arquivo > Propriedades do AF Server. A janela Propriedades do AF Server é
exibida.
2. Na guia Bibliotecas, clique com o botão direito do mouse na biblioteca e selecione
Propriedades.
3. Faça as alterações na janela Propriedades da Biblioteca quando ela for exibida.

Conectar aos servidores e bancos de dados
Nesta seção
• Gerenciar as preferências de conexão do PI System Explorer
• Conectar aos PI AF Servers
• Conectar aos PI Servers
• Conectar aos bancos de dados PI AF
Gerenciar as preferências de conexão do PI System Explorer

Use a janela Opções do Servidor para definir como o PI System Explorer deve se conectar a um
coletivo AF ou PI, se os prompts de login são permitidos e se você deseja que os servidores
sejam automaticamente adicionados à Tabela de Servidores Conhecidos.
Procedimento
1. No PI System Explorer, selecione Ferramentas > Opções > Opções de servidor.
2. Defina as Configurações do AF Server:
Configurações Descrição
Preferência de Conexão do AF Esta preferência é usada para influenciar a seleção de membros
Server coletivos quando uma conexão é feita com o coletivo AF.
◦ Preferir Primário
O PI Server Explorer tentará se conectar ao servidor
primário no coletivo e, se ele não estiver disponível, as
configurações de prioridade individual do membro coletivo
serão usadas para influenciar na seleção da conexão do
servidor. Essa é a configuração padrão.
◦ Exigir Primário
O PI Server Explorer é obrigado a se conectar com o servidor
primário no coletivo. Se o servidor primário não estiver
disponível, a conexão falhará.
◦ Qualquer
O PI Server Explorer pode se conectar a qualquer membro
disponível no coletivo e usará as configurações de
prioridade individual do membro coletivo para influenciar a
seleção da conexão do servidor.
Permitir Prompt de Login do AF Selecione esta opção para que o prompt de login apareça quando
Server uma conexão com o servidor falhar devido a uma exceção de
segurança.
Adicionar AF Servers Selecione esta opção para adicionar automaticamente um servidor
Automaticamente na Tabela de Servidores Conhecidos.
Quando o PI System Explorer tenta se conectar a um servidor em
um coletivo que não está na Tabela de Servidores Conhecidos, se o
nome do computador for válido e o PI System Explorer puder
encontrar o nome do computador do servidor na rede, o servidor
será automaticamente adicionado à Tabela de Servidores
Conhecidos.
3. Defina as Configurações do PI Server:

Configurações Descrição
Preferência de Conexão do PI Esta preferência é usada para influenciar a seleção de membros
Server coletivos quando uma conexão é feita com o coletivo PI Server.
◦ Preferir Primário
O PI Server Explorer tentará se conectar ao servidor
primário no coletivo e, se ele não estiver disponível, as
configurações de prioridade individual do membro coletivo
serão usadas para influenciar na seleção da conexão do
servidor. Essa é a configuração padrão.
◦ Exigir Primário
O PI Server Explorer é obrigado a se conectar com o servidor
primário no coletivo. Se o servidor primário não estiver
disponível, a conexão falhará.
◦ Qualquer
O PI Server Explorer pode se conectar a qualquer membro
disponível no coletivo e usará as configurações de
prioridade individual do membro coletivo para influenciar a
seleção da conexão do servidor.
Permitir Prompt de Login do PI Selecione esta opção para que o prompt de login apareça quando
Server uma conexão com o servidor falhar devido a uma exceção de
segurança.
Adicionar PI Servers Selecione esta opção para adicionar automaticamente um servidor
Automaticamente na Tabela de Servidores Conhecidos.
Quando o PI System Explorer tenta se conectar a um servidor em
um coletivo que não está na Tabela de Servidores Conhecidos, se o
nome do computador for válido e o PI System Explorer puder
encontrar o nome do computador do servidor na rede, o servidor
será automaticamente adicionado à Tabela de Servidores
Conhecidos.
4. Clique em OK.
Conectar aos PI AF Servers

Nesta seção
• Conectar a um PI AF Server
• Adicionar um PI AF Server à lista de conexões
• Alternar membros do coletivo
• Trocar para um membro coletivo específico
Conectar a um PI AF Server
Procedimento
1. No PI System Explorer, selecione Arquivo > Conexões
A janela Servidores se abre, exibindo uma lista de quaisquer PI Server ou PI AF Server
para os quais uma conexão esteja configurada. Servidores conectados no momento
estão indicados com um círculo verde.

PI Servers versões 3.4.375 e 3.4.370 são indicados com um triângulo amarelo e um aviso de
que você está conectado a um servidor não suportado. Conexões a servidores pré-3.4.370
não são permitidas.
2. Para conectar a outro PI AF Server, clique com o botão direito do mouse no nome do
servidor na lista e selecione Conectar.
Nota:
Se o servidor de que o usuário precisa não for exibido, adicione-o conforme descrito
em Adicionar um PI AF Server à lista de conexões.
Em qualquer AF Server conectado, clique em Renomear para inserir outro nome para
ele. Entretanto, observe que renomear o servidor afeta todos os clientes. O Nome não
tem nenhuma correspondência com a Descrição.
Nesta seção
• Visualizar contagens de objeto do PI AF Server
• Visualizar ID, porta e outras propriedade do AF Server
Visualizar contagens de objeto do PI AF Server

Pode-se visualizar contagens de objeto para o PI AF Server ao qual o usuário está conectado,
como o número de bancos de dados, elementos, templates de elemento, estrutura de eventos e
assim por diante.
Procedimento
1. No PI System Explorer, selecione Arquivo > Propriedades do AF Server
A janela Propriedades do AF Server é exibida.
2. Selecione a guia Contagens.
Visualizar ID, porta e outras propriedade do AF Server

As informações sobre o PI AF Server atualmente conectado podem ser visualizadas, inclusive:
• Nome do AF Server, Nome do Host e ID
• Conta do AF Server
• Número de versão do AF Server
• Porta do AF Server, Tempo de Inatividade e Aliases
Procedimento
1. No PI System Explorer, selecione Arquivo > Propriedades do AF Server
A caixa de diálogo Propriedades do AF Server é aberta.
2. Clique na guia Geral.
Nota:
A guia Geral também inclui o botão Configurar Active Directory. Consulte Configurar
acesso ao Active Directory dos contatos para obter mais informações.
Adicionar um PI AF Server à lista de conexões

Procedimento
1. No PI System Explorer, clique em Arquivo > Conexões.
A janela Servidores é exibida. Esta janela lista qualquer PI Server ou PI AF Server
para o qual uma conexão esteja configurada.

Servidores conectados no momento estão indicados com um círculo verde. O PI Server e o PI
AF Server padrão são indicados com uma marca de verificação.
PI Servers versões 3.4.375 e 3.4.370 são indicadas com um triângulo amarelo e um aviso de
que você está conectado a um servidor não suportado. Conexões a servidores pré-3.4.370
não são permitidas.
2. Clique em Adicionar AF Server.
3. Insira as propriedades do PI AF Server.
◦ O Nome não precisa corresponder ao nome do host. Quando estiver conectado ao PI AF
Server, será possível alterar o Nome dele clicando em Renomear para inserir o novo
nome.
Warning:
Renomear o AF Server impacta todos os clientes
◦ O nome do Host pode ser o nome de domínio totalmente qualificado, nome de servidor
ou endereço IP. Endereços IPv6 devem estar entre chaves [ ].
◦ Deixe o campo Conta em branco.
◦ O valor padrão T. limite de 300 segundos é aceitável em muitos casos. Se ocorrerem
erros de tempo limite enquanto trabalha no PI System Explorer, aumente o tempo na
caixa T. limite.
◦ (Opcional) Os Aliases são nomes alternativos que podem ser usados no PI AF Server
quando usuários procuram o PI AF Server. Os alias do PI AF Server são armazenados
apenas localmente no cliente, onde são configurados.
◦ (Opcional) O link Configurar Active Directory destina-se à configuração da lista de
contatos PI Notifications. Esse é uma função administrador do PI AF System.
4. Clique em OK.
Nota:
Se uma mensagem de erro aparece dizendo que você não pode se conectar ao PI AF
Server, então você precisa preencher o campo Conta.
Nesta seção
• Preencher o campo Conta
• Configurar acesso ao Active Directory dos contatos
• Configurar segurança de um AF Server
Preencher o campo Conta

Ao adicionar uma nova conexão PI AF Server ao PI System Explorer, o campo Conta é deixado
em branco. Se, depois de clicar na conexão, uma mensagem de erro aparecer informando que
não é possível conectar ao PI AF Server, um motivo desse erro poderá ser a necessidade de
preencher o campo Conta. Se for de conhecimento que o serviço PI AF está execução em uma
conta de domínio, será necessário preencher o campo Conta.

1. Insira o nome da conta na qual o serviço PI AF é executado. Por exemplo:

company.net\afcollective
Nota:
Só é possível modificar a conta quando o servidor não está conectado.
2. Se ainda assim não for possível conectar, consulte os tópicos de solução de problemas no
guia Instalação e Atualização do PI AF.
Configurar acesso ao Active Directory dos contatos

Ao usar o PI Notifications com o PI AF Server, talvez seja necessário especificar como acessar o
Microsoft Active Directory para recuperar nomes das listas de contatos do PI Notifications.
Cada PI AF Server disponibiliza a opção para especificar o domínio e contatar subpastas, assim
como a conta necessária para acessar o Active Directory e recuperar os nomes dos contatos.
Por padrão, a conta na qual o aplicativo do PI AF Server está em execução é usada no acesso ao
Active Directory. Para usar outra conta ou acessar o Active Directory em um domínio diferente,
configure o acesso na janela Configurar o acesso aos contatos do Active Directory.
Procedimento
1. Abra o PI System Explorer e conecte-se a um banco de dados que pertença ao PI AF Server
em que deseja-se configurar o acesso ao Active Directory.
2. No menu Arquivo, selecione Propriedades do AF Server e, na janela, clique no link
Configurar o acesso aos contatos do Active Directory.
3. Na caixa de texto Nome do domínio Active Directory, insira o nome DNS completo do
domínio do Active Directory do qual os nomes de contato serão recuperados para os
Contatos do PI Notifications (por exemplo, contoso.com).
Se esse campo ficar em branco, o domínio no qual o serviço PI AF está localizado será usado.
4. Na caixa de texto Subpasta contato Active Directory, insira o caminho para a pasta
contendo a lista de contatos desse domínio.
Em domínios maiores do Active Directory, talvez os contatos sejam organizados em
subpastas. O uso de subpastas pode viabilizar a recuperação mais rápida de uma lista de
contatos do Active Directory.
Use a seguinte estrutura na subpasta:
DomainUserFolder/SubDomainUserFolder/Sub SubDomainUserFolder
5. Selecione uma opção para Conta de acesso do Active Directory:
◦ Usar a conta que o AF Server executa como
Essa é a opção padrão. Selecione-a para acessar o Active Directory usando a conta na qual
o serviço PI AF é executado. Por padrão, o PI AF Server é instalado usando a conta do
Serviço de Rede. No entanto, a conta de serviço PI AF Server pode ser alterada. Se a conta
de serviço PI AF Server não tiver as permissões necessárias para ler o Active Directory,
nenhum nome de contato será recuperado na lista Contatos. Se a segurança do Active
Directory for configurada para permitir que a conta de serviço PI AF Server leia o Active
Directory, esta será a opção mais simples.
◦ Usar a conta do em que a ferramenta cliente do AF está executando como
Selecione esta opção para usar as credenciais da conta do usuário na qual o aplicativo
cliente de conexão está em execução. Se o serviço PI AF Server estiver em execução em
uma conta (o Serviço de Rede é a conta padrão), ela não terá permissão de leitura no
Active Directory; essa opção pode ser usada. Enquanto a conta do usuário na qual o
aplicativo cliente de conexão estiver em execução e tiver permissão de leitura no Active

Directory, uma lista de nomes de contatos será retornada à lista Contatos. O conteúdo da
lista Contatos pode variar, dependendo da conta de acesso usada, pois a segurança para
ler a lista de contatos é determinada pelo Active Directory.
Nota:
A especificação dessa opção poderá exigir a configuração Kerberos se um aplicativo
do AF SDK estiver usando uma personificação no meio de uma camada, como um
Web Service.
◦ Usar a conta especificada
Esta opção permite a especificação de uma conta a ser usada para ler o Active Directory.
Isso pode ser útil quando o Active Directory e o PI AF Server estão em domínios
diferentes ou quando as contas nas primeiras duas opções não têm permissão de leitura
do Active Directory. Em Nome da Conta, use o formato Domain\User. Verifique se a
conta especificada tem a permissão apropriada de leitura do Active Directory de destino.
6. Marque Usar o Catálogo Global armazenado no cache do Active Directory para usar o
catálogo global para realizar pesquisas no controlador de domínio do Active Directory. Caso
contrário, as pesquisas devem ser realizadas no controlador de domínio próprio.
O Active Directory mantém as informações em um repositório de dados distribuídos
chamados de catálogo global. Nas instalações em que há vários controladores de domínio
distribuídos, cada controlador tem um cache das partes do catálogo global na qual ele não é
responsivo, por isso, as pesquisas do Active Directory não precisam ser consultadas no
controlador de domínio próprio. Isso melhora o desempenho das consultas que, de outra
forma, devem ter acesso ao controlador de domínio remoto.
7. Escolha uma configuração para Retornar Todas as Pessoas.
Os objetos do Active Directory são originados em um o outro da seguinte forma:
Top>Persons>OrganizationalPerson>Contact
e
Top>Persons>OrganizationalPerson>User
◦ Marque esta caixa de seleção para retornar Pessoas, Pessoas Organizacionais, Contatos e
Usuários do Active Directory de destino.
◦ Desmarque a caixa de seleção para retornar apenas Usuários.
Configurar segurança de um AF Server

É possível configurar a segurança de um AF Server conectado no momento. Para fazer isso,
atribua as permissões a usuários e grupos para acessar áreas ou objetos no servidor.
Procedimento
1. Selecione Arquivo > Conexões. A janela Servidor relaciona o PI Server e o AF Server
disponíveis; um ponto verde no ícone de um servidor indica que ele está atualmente
conectado.
2. Clique com o botão direito do mouse no AF Server conectado e selecione Segurança. No
menu em cascada, selecione a área ou os objetos nos quais as permissões serão
configuradas. (Observe que a opção Bancos de Dados lista várias escolhas adicionais.) Uma
janela de permissões é aberta onde deseja-se definir as permissões de usuário ou grupo.
Alternar membros do coletivo

Ao se conectar a um coletivo do PI AF, o PI AF automaticamente conecta o usuário ao um
membro do coletivo com a prioridade mais alta (menor número). Esse procedimento alterna a

conexão para o próximo membro na lista de coletivos. O próximo membro na lista é

determinado por prioridade atribuída dos membros.
Procedimento
1. No PI System Explorer, selecione Arquivo > Conexões
2. Clique com o botão direito do mouse no coletivo e selecione Alternar Membro do Coletivo.
Trocar para um membro coletivo específico

Ao se conectar a um coletivo do Asset Framework, o usuário é automaticamente conectado ao
um membro do coletivo com a prioridade mais alta (menor número). Pode-se trocar para um
membro específico do coletivo.
Procedimento
1. No PI System Explorer, selecione Conexões.
2. Clique com o botão direito do mouse no coletivo e selecione Conectar ao Membro Coletivo.
A caixa de diálogo Conectar ao Membro Coletivo é exibida.
3. Na lista Membro Coletivo, selecione o membro do coletivo ao qual deseja-se se conectar.
4. Clique em OK. Agora, o usuário está conectado ao membro do coletivo selecionado.
Conectar aos PI Servers

Nesta seção
• Conectar a um PI Server
• Adicionar um PI Server a uma lista de conexões
• Exibir Status do Buffer para um PI Server
Conectar a um PI Server
Procedimento
1. Clique em Arquivo > Conexões.
A caixa de diálogo Servidores é exibida. Esta caixa de diálogo lista todos os PI Servers e PI AF
Servers para os quais uma conexão está configurada. Os PI Servers e PI AF Server
atualmente conectados estão indicados com círculos verdes. Os PI Servers que estão
executando versões anteriores à 3.4.370 não são compatíveis e estão marcados com um
triângulo amarelo. É possível conectar às versões anteriores do PI Server, mas talvez a
funcionalidade não esteja completa.
2. Para conectar a outro PI Server, clique com o botão direito do mouse no nome do servidor
na lista e selecione Conectar. Se o servidor de que o usuário precisa não for exibido,
adicione-o conforme descrito em Adicionar um PI Server a uma lista de conexões.
Nesta seção
• Problemas de conexão do PI Server
• Configurar clientes para permitir prompts de login explícitos

Problemas de conexão do PI Server

A autenticação do Windows só usa mapeamentos de identidade e não utiliza trusts definidos
com credenciais de janela para autenticação nem quaisquer outros trusts que possam estar
configurados. Ao conectar a um PI Server, talvez mensagens de erro sejam exibidas e não
houver PI mappings configurados, e uma destas condições for verdadeira:
• Um nome de usuário e senha PI estão sendo usados para fazer login no PI Server.
• Um usuário padrão com uma senha em branco para fazer login no PI Server.
Esses erros ocorrem porque o PI AF 2012 e posteriores têm configurações de segurança mais
limitadas que as versões anteriores do PI AF. Os clientes que se conectam ao PI Server usando o
PI AF 2012 e posteriores estão sujeitos aos seguintes comportamentos:
• O comportamento padrão das conexões não é solicitar o login explícito do usuários, exceto
que Permitir configuração do prompt de login esteja configurado. Essa configuração
controla o que acontece quando a autenticação PI Server falha. Se Permitir configuração do
prompt de login estiver ativada, a caixa de diálogo será exibida solicitando o nome de
usuário e a senha do usuário. Se a configuração estiver desativada, uma mensagem de erro
será exibida. A configuração é específica a cada computador cliente.
• Não há mais suporte para as conexões de usuário padrão.
Para resolver as condições de erro, configure os PI mappings para conectar usuários ao PI
Server. Consulte o PI Server Security para obter as instruções.
Mensagens de erro de conexão do PI Server

Mensagem de Erro Condições de Falha de Conexão
Privilégios insuficientes para se conectar ao PI As conexões de usuário padrão estão ativadas no
Server. PISDK.
Sem Acesso — Proteger Objetos
As conexões de usuário padrão com o PI Server
estão atualmente ativadas por este cliente, mas
não são suportadas pelo PI AF.
Privilégios insuficientes para acessar o PI Server. Conexões de usuário padrão são o único método de
Métodos de autenticação sem suporte estão autenticação ativado no PISDK.
ativados.
Sem Acesso — Proteger Objetos
As conexões de usuário padrão com o PI Server
estão atualmente ativadas por este cliente, mas
não são suportadas pelo PI AF.
Privilégios insuficientes para acessar o PI Server. As configurações de login explícitos estavam

desconfiguradas no registro
Sem Acesso — Proteger Objeto
O prompt de login explícito não está configurado
neste computador, por isso, não é permitido.
Configurar clientes para permitir prompts de login explícitos

Procedimento
1. Abra o PISDKUtility no menu Iniciar do Windows.
2. Selecione Conexões > Opções.

A janela Opções de Conexão é exibida.

3. Marque a caixa de seleção Permitir a solicitação de logon (caso todos os protocolos
configurados falhem).
4. Clique em OK.
Adicionar um PI Server a uma lista de conexões

Procedimento
1. Abra o PI System Explorer e selecione Arquivo > Conexões
A caixa de diálogo Servidores é exibida. Esta caixa de diálogo lista todos os PI Servers e PI AF
Servers para os quais uma conexão está configurada. Servidores conectados no momento
estão indicados com um círculo verde. O PI Server e o PI AF Server padrão são indicados
com uma marca de verificação. (Os PI Servers, versões 3.4.370 e anteriores, são marcados
com um bitmap de triângulo amarelo em vez de um círculo verde. É possível conectar-se a
essas versões anteriores de servidores, mas talvez funcionalidade não seja completa.)
2. Clique em Adicionar PI Server.
A caixa de diálogo Propriedades do PI Server é exibida.
3. (Opcional) Para alterar o nome no campo Nome, clique em Renomear, insira um novo nome
e clique em OK. Esse nome não precisa ser igual ao nome do host.
4. Insira o nome do host no campo Host. O nome do host pode ser um nome de domínio
totalmente qualificado, um nome de servidor ou um endereço IP.
5. Exceto se o aplicativo em particular exigir outra porta, aceite os valores padrão da caixa
Porta.
Nota:
Será possível modificar o nome e a porta do host apenas quando não estiver conectado
no servidor.
6. Os valores padrão dos campos Tempo Limite daConexão e Tempo Limite dosDados são
aceitáveis na maioria dos casos. Caso ocorram tempos limites da conexão ao se conectar ao
PI Server do PI System Explorer, aumente o tempo na caixa Tempo Limite daConexão. Caso
ocorram erros de tempo de execução ao acessar os dados do PI Server, aumente o tempo na
caixa Tempo Limite dos Dados.
7. Como alternativa, insira o nome do alias na caixa Alias.
Os alias são nomes alternativos que podem ser usados no PI Server. Os alias do PI Server são
armazenados apenas localmente no cliente, onde são configurados.
8. Clique em Conectar para se conectar ao PI Server.
Nota:
Os campos ID, Fuso Horário e Versão não são editáveis. ID é o ID do PI Server,Fuso
Horário é o fuso horário local do PI Server, e Versão é a versão do PI Server.
9. Clique em OK.

Exibir Status do Buffer para um PI Server

Antes de Iniciar
• O PI Buffer Subsystem 4.3 ou posterior é necessário para exibir o status do armazenamento

em buffer, bem como para usar o Gerenciador de Buffer.
• O PI Buffer Subsystem deve estar em execução antes que você pode iniciar o Gerenciador de
Buffer.
Procedimento
1. Clique em Arquivo > Conexões.
A janela Servidores é aberta exibindo uma lista com todos os PI Servers e PI AF Servers para
os quais uma conexão está configurada. Status do Buffer indica o status do armazenamento
em buffer para cada PI Server.
Nota:
PI Buffer Subsystem versões 3.4.380 e anteriores exibem um status de Desconhecido.
2. Para ver mais detalhes e gerenciar o armazenamento em buffer para um PI Server, clique
em Gerenciador de Buffer para abrir a ferramenta Gerenciador de Buffer.
Nota:
Você também pode abrir o Gerenciador de Buffer a partir do menu Ferramentas do PI
System Explorer .
O que Fazer Depois

Para obter mais informações sobre o Gerenciador de Buffer, consulte a ajuda do Gerenciador
Buffer.
Conectar aos bancos de dados PI AF

Nesta seção
• Bancos de dados PI AF
• Criar um banco de dados
• Visualizar ou editar propriedades de um banco de dados
• Configurar o banco de dados padrão
• Renomear um banco de dados
• Pesquisar um banco de dados
• Atualizar a lista de bancos de dados
• Sobre a exclusão dos bancos de dados
• Configurar permissões de segurança para um banco de dados
• Configurar permissões de segurança para todos os banco de dados
Bancos de dados PI AF
O PI AF armazena objetos da estrutura de ativos (elementos, templates etc.) nos bancos de
dados PI AF. Podem-se ter vários bancos de dados no PI AF, mas somente um pode ser
conectado por vez. Normalmente, trabalha-se com bancos de dados PI AF no PI System

Explorer ou no PI Builder. Ao iniciar o PI System Explorer, ele se conectar ao banco de dados PI

AF padrão. Se nenhum banco de dados definido, o PI System Explorer solicita a criação de um
novo banco de dados.
Nota:
O banco de dados Configuração é usado por clientes PI AF quando eles usam o PI AF. Não
use esse banco de dados em dados próprios do aplicativo.
Criar um banco de dados

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Banco de Dados.
A janela Selecionar Banco de Dados é exibida.
2. Escolha o AF Server no qual o banco de dados será criado.
3. Clique no botão Novo Banco de Dados.
A janela Selecionar Propriedades é exibida.
4. Insira um nome e uma descrição opcional.
5. Para carregar uma biblioteca existente em um novo banco de dados, escolha uma no menu
Carregar Biblioteca. Esse menu não aparecerá se não houver bibliotecas. Para obter mais
informações, consulte Biblioteca salva do PI AF.
Visualizar ou editar propriedades de um banco de dados

Procedimento
1. No PI System Explorer, clique no botão Banco de Dados para abrir a janela Selecionar Banco
de Dados.
2. Clique com o botão direito do mouse no banco de dados e selecione Propriedades para abrir
a janela Propriedades do Banco de Dados do banco de dados selecionado.
3. Visualize e edite as propriedades disponíveis em duas guias:
◦ Geral
Lista o nome, a descrição, as bibliotecas existentes (consulte Salvar um banco de dados
como biblioteca) e o AF Server.
◦ Contagens
Lista as contagens de diferentes tipos de objetos usados pelo banco de dados.
Configurar o banco de dados padrão

O banco de dados padrão é exibido quando o PI System Explorer é aberto pela primeira vez.
Depois que o PI System Explorer é executado pela primeira vez, ele é exibido em qualquer
banco de dados aberto quando o PSE foi fechado pela última vez.
Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Banco de Dados. A caixa de
diálogo Selecionar Banco de Dados é exibida.
2. Clique com o botão direito do mouse em um banco de dados e selecione Definir como Banco
de Dados Padrão.

Renomear um banco de dados

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Banco de Dados. A janela
Selecionar Banco de Dados é exibida.
2. Clique com o botão direito do mouse em um banco de dados e selecione Renomear.
Pesquisar um banco de dados

Procedimento
2. No campo Banco de Dados, digite o nome do banco de dados.
O ícone Pesquisar é alterado para o ícone Pesquisando . Os resultados são filtrados
de acordo com o número de letras digitadas.
3. Escolha um banco de dados na lista e clique em OK. A janela é fechada, e o trabalho será
realizado no banco de dados selecionado.
4. Para retornar à lista completa de bancos de dados disponíveis, pressione ESC. A janela é
fechada.
Atualizar a lista de bancos de dados

Outros usuários podem adicionar bancos de dados ao servidor, e os bancos de dados recém-
adicionados podem não ser exibidos.
Procedimento
2. Clique com o botão direito do mouse na caixa Bancos de Dados e selecione Atualizar.
Sobre a exclusão dos bancos de dados

A exclusão de um banco de dados remove todas as informações contidas no banco de dados.
Ela não pode ser desfeita. Certifique-se de que o banco de dados correto está selecionado para
exclusão. Não é possível recuperar os dados restaurando o último backup do SQL Server.
Configurar permissões de segurança para um banco de dados

Procedimento
2. Clique com o botão direito do mouse em um banco de dados e selecione Segurança > Banco
de Dados. A janela de propriedades da permissão dos objetos selecionados é exibida.
3. Selecione os usuários e configure as permissões conforme necessário. Para obter mais
informações sobre as permissões de configuração, consulte Configurar permissões para
objetos.

Configurar permissões de segurança para todos os banco de dados

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Banco de Dados.
A janela Selecionar Banco de Dados é exibida.
2. Clique em .
A janela de propriedades da permissão dos objetos selecionados é exibida.
3. Selecione os usuários e configure as permissões conforme necessário.
Para obter mais informações sobre as permissões de configuração, consulte Configurar
permissões para objetos.


Encontrar e visualizar informações de ativos
Nesta seção
• Procurar ativos
• Pesquisar ativos e dados de ativos
• Criar uma tendência no PI System Explorer
• Fazer alterações em equipamentos e processos
• Visualizar dados das séries de tempo
Procurar ativos
Nesta seção
• O que é exibido no navegador
• Procurar elementos
• Procurar outros objetos
• Configurar tamanho de página do navegador
• Abrir janelas adicionais do navegador
O que é exibido no navegador

O conteúdo do Navegador do PI System Explorer depende do botão selecionado no painel
Navegador. Os objetos disponíveis padrão no painel Navegador são elementos, estruturas de
eventos, objetos de bibliotecas e unidades de medida.
O painel Navegador pode conter outros tipos de objetos, caso outros produtos PI estejam
instalados. Por exemplo, se o PI Notifications estiver instalado, os seguintes objetos também
aparecerão no painel Navegador: Notificações, Contatos e MyPI.
Procurar elementos
Os elementos são exibidos com árvores no Navegador. A estrutura da árvore de elementos é
diferente para cada organização. O criador do modelo de ativo escolhe a estrutura relevante
aos usuários da organização. Na ilustração a seguir, os elementos estão organizados por local
da planta. Se todos os equipamentos de uma determinada planta forem de responsabilidade do
usuário, então, esse modelo poderá fazer sentido. Um modelo diferente pode ser mais útil para
uma pessoa com outra função.

A árvore de elementos pode conter diferentes subárvores que fornecem diferentes contextos
para os mesmos ativos. Isso permite que os usuários encontrem os elementos no contexto mais
lógico para a tarefa em questão. Por exemplo, além da organização por local de planta
mostrada acima, também é possível ter uma organização por fabricante de equipamento,
conforme mostrado na ilustração a seguir.
Os elementos representando as bombas aparecem nas hierarquias Fabricantes e Local da

Planta. Na hierarquia Fabricante, os elementos da bomba não são elementos novos separados,
eles são referências aos elementos que já existiam na árvore Local da Planta. Para indicar se
eles são referências de elementos, eles precisam estar representados pelo ícone referenciado
.
Procurar outros objetos

É possível procurar objetos que não sejam elementos. Clique no botão relevante no painel
Navegador para ver os objetos deste tipo:
• Unidades de Medida (UDMs): Ao clicar no botão Unidade de Medida no painel Navegador,

todas as classes UDM aparecem no Navegador. Ao selecionar uma classe, as UDMs
pertencentes a essa classe aparecem no Visualizador.
• Objetos de Biblioteca: Ao clicar no botão Biblioteca no painel Navegador, as seguintes
coleções de objetos aparecem no Navegador: Categorias, Templates, Conjuntos de
Enumeração, Tipos de Referência e Tabelas. Para ver todos os objetos de um determinado
tipo, expanda a coleção para esse tipo.
• Estruturas de Eventos e Transferências: Porque os modelos de ativos podem ter milhares de
estruturas de eventos ou transferências, esses objetos não são exibidos em uma hierarquia
no Navegador. Em vez disso, cada um tem um conjunto de pesquisa no Navegador. Clique
com o botão direito do mouse na coleção de pesquisa para começar uma nova pesquisa.
Pesquisas recentes são listadas na coleção de pesquisas.

Configurar tamanho de página do navegador

O painel Navegador do PI System Explorer está dividido em páginas. Isso significa que ele exibe
um número específico de objetos por vez. Se houver mais objetos, o PI System Explorer os
exibirá em outra página. Quando isso acontece, os controles Próximo e Anterior aparecem no
Navegador.
Por padrão, o número máximo de objetos exibidos no Navegador é 1000, mas é possível alterar
esse número.
Procedimento
1. No PI System Explorer, escolha Ferramentas > Opções.
2. No campo Tamanho máximo de página com ramificações em árvore, digite o número
máximo de objetos que podem ser exibidos no Navegador.
Abrir janelas adicionais do navegador
Procedimento
1. Clique com o botão direito do mouse em qualquer item do painel Navegador.
2. No menu que aparece, selecione Abrir em Nova Janela.
Pesquisar ativos e dados de ativos

O PI System Explorer fornece várias opções para encontrar ativos, dados de ativos e Pontos PI.
• Encontre dados de uma peça específica do equipamento. Por exemplo: Dados do ponto PI,
resultados de cálculo, informações de manutenção etc. Por exemplo, é possível usar o PI
System Explorer para encontrar informações sobre um tanque específico em uma planta
específica.
• Encontre todo o equipamento com valores ou intervalos de valores do atributo especificado.
Por exemplo, obtenha uma lista de todos os tanques com temperatura superior a 200 °F.
Nesta seção
• Pesquisa rápida

• Paginar os resultados da pesquisa

• Pesquisar em uma data específica
• Pesquisar PI Points
• Pesquisar elementos
• Pesquisar atributos em elementos
• Pesquisar estruturas de eventos
• Pesquisar atributos nas estruturas de eventos
• Pesquisar uma transferência
• Pesquisar atributos em transferências
Pesquisa rápida
Pode-se usar a caixa de pesquisa rápida na extremidade direita da barra de ferramentas do PI
System Explorer para encontrar elementos, estruturas de eventos, templates de elemento ou
tipos de UDM (unidade de medida).
Procedimento
1. Selecione um item no painel Navegador para definir o contexto da pesquisa rápida. Por
exemplo, selecione Estruturas de Eventos no painel Navegador para definir a pesquisa
rápida para pesquisar estruturas de eventos.
2. Na caixa de pesquisa rápida, selecione um limite de pesquisa em Ação , insira os critérios
da pesquisa e pressione Enter. Os resultados da pesquisa aparecem no Visualizador e no
Navegador.
Nota:
Os resultados da pesquisa exibidos no Navegador permanecem lá para fácil acesso,
caso sejam necessários mais tarde. Pode-se clicar com o botão direito do mouse nos
resultados e excluí-los do Navegador; eles também serão removidos ao sair do PI
System Explorer. Clique com o botão direito do mouse e salve-os para mantê-los até
serem excluí-dos.
Paginar os resultados da pesquisa

Quando grandes números de elementos ou estruturas de eventos são pesquisadas, é possível
usar a opção Definir Tamanho Máximo da Consulta para retornar rapidamente os resultados
da pesquisa em blocos gerenciáveis. Esse processo chama-se paginação. Altere o valor de
Definir Tamanho Máximo da Consulta para o número de objetos que se deseja pesquisar e ver
nos resultados da pesquisa de uma única vez. Se a pesquisa retornar um número maior de
objetos que o valor Definir Tamanho Máximo da Consulta especificado, os resultados serão
paginados. Observe que:
• Apenas os resultados da pesquisa de elementos, transferências e estruturas de eventos

podem ser paginados.
• A configuração Definir Tamanho Máximo da Consulta só pode ser aplicada a pesquisa
rápidas de elementos, transferências e estruturas de eventos. Se outros objetos forem
pesquisados, o valor Definir Tamanho Máximo da Consulta será ignorado.
• Se uma pesquisa avançada estiver sendo realizada, o valor Contagem Máxima na caixa de
diálogo Pesquisa por elemento substituirá o valor Definir Tamanho Máximo da Consulta.

Por exemplo, se o valor Definir Tamanho Máximo da Consulta for 100.000, o SQL Server
tentará encontra cem mil objetos correspondentes antes de retornar os resultados. Talvez o
usuário não queira aguardar que o SQL Server encontre esse número de correspondência nem
ver tantas correspondências em uma única página de resultados da pesquisa. Se Definir
Tamanho Máximo da Consulta for alterado para 100, o SQL Server enviará os resultados
depois que cada 100 correspondências forem encontradas, e 100 objetos serão exibidos nos
resultados da pesquisa.
Configurar o tamanho máximo da consulta

Use um destes dois métodos:
• Configure a opção Tamanho Máximo da Consulta na Barra de Menu (Ferramentas >

Opções). Isso configura o valor padrão do PI System Explorer.
• Configure Contagem máxima na janela de pesquisa. Isso configura o tamanho máximo da
consulta na pesquisa avançada. O valor Contagem máxima substitui o valor Definir
Tamanho Máximo da Consulta.
Pesquisar em uma data específica

Para realizar uma pesquisa no PI System Explorer em uma data e hora específicas, insira essa
configuração de tempo na Data da Consulta. Ele também exibe versões de objeto para aquela
data. Consulte Data da consulta e horário PI System Explorer para obter informações sobre
exatamente quais objetos foram afetados pela Data da Consulta.
Além disso, é possível configurar um tempo ou intervalo de tempo que sejam aplicados apenas
aos valores do atributo exibidos e deixa a configuração Data da Consulta ajustada. Para fazer
isso, configure Definir contexto de tempo. Consulte Configurar o contexto de tempo para os
valores de atributo exibidos.
Pesquisar PI Points
Selecione Elementos no painel Navegador.
Procedimento
1. Na barra de menu do PI System Explorer, selecione Editar > Pesquisa por Tag. (Ou selecione
Visualizar > Palete > Pesquisa por Tag para realizar uma pesquisa por tag na Palete.)
A janela Pesquisa por Tag é exibida.
2. Selecione os PI Servers nos quais deseja-se pesquisar. É possível fazer várias seleciones na
lista suspensa ou clicar no botão Procurar para encontrar e adicionar PI Servers.
3. Comece digitando uma string de pesquisa na caixa de texto da pesquisa ao lado do botão
Pesquisar.
Por padrão, o PI AF pesquisa nomes dos pontos que iniciam com a string de pesquisa
inserida.

◦ Para pesquisar nomes que terminam com, contêm ou correspondem às strings de

pesquisa, clique em e selecione a opção apropriada.
◦ Para pesquisar na descrição do ponto e no nome do ponto, clique em e selecione Incluir
descrição na pesquisa.
◦ Para pesquisar em atributos específicos do ponto, clique em . É possível pesquisar em
Nome, Origem do Ponto, Tipo de Dados e Point Class. (Clique em Adicionar Critérios para
adicionar Unidades de Engenharia ou Descrição.)
4. Clique em Pesquisar para ver os resultados da pesquisa. Para selecionar as colunas a serem
exibidas nos resultados da pesquisa, clique no ícone do seletor de colunas à direita dos
cabeçalhos da coluna.
5. Clique em OK para exibir os resultados nos painéis Visualizador e Navegador.
Caracteres especiais para pesquisa por tag

No campo Pesquisa por Tag, é possível usar os seguintes caracteres especiais em uma string de
pesquisa.
Nota:
Os resultados dos exemplos abaixo presumem que a opção de pesquisa padrão esteja
sendo usada; essa opção pesquisa nomes de pontos PI que iniciam com a string
pesquisada.
Caractere especial Descrição Exemplo

* Substitui qualquer número de sin*
caracteres não especificados
Retorna todos os pontos PI com
nomes que iniciam com sin; por
exemplo, sinusoid e sinusoidu.
? Substitui um único caractere não CD?158

especificado
Retorna todos os pontos Pi com
nomes que iniciam com CD,
seguido por qualquer caractere
exclusivo, seguido por 158 (por
exemplo, CD1158, CDA158 e
assim por diante).
: Ao pesquisar todos os pontos PI pointsource:R

com um valor de atributo
Retorna todos os pontos PI cuja
específico (diferente do nome),
origem do ponto é o valor R.
separa o atributo e o valor
pesquisado. "ba:temp.1" ba\:temp.1
Dica: Ambos os exemplos acima
Ao pesquisar um nome do retornam o ponto PI chamado
ponto PI contendo uma ba:temp.1.
vírgula, coloque o nome
entre aspas duplas ou
preceda a vírgula com uma
barra invertida. (Veja
exemplos.)
>, < ou = Superior a, inferior a ou igual ao span:<=100

valor numérico especificado
Retorna pontos PI com um valor
de atributo span inferior ou igual
a 100.

Caractere especial Descrição Exemplo

'' Delimitadores para seqüências '*Owner Change*'
de caracteres de pesquisa que
ou ou
contém espaços ou caracteres
"" especiais "*Owner Change*"
Retorna todos os pontos PI que
têm nomes contendo Owner
Change.
"ba:temp.?"
Retorna todos os pontos PI
contendo nomes iniciando com
ba:temp e terminando com um
único caractere.
Pesquisar elementos
Selecione Elementos no painel Navegador.
Procedimento
1. No menu principal do PI System Explorer, clique em Editar > Pesquisar Elemento.
A janela Pesquisar Elemento é exibida.
2. Configure a janela Pesquisa por Elemento para encontrar o elemento desejado no banco de
dados do PI AF:
a. Na lista Ações , selecione o tipo de filtro a ser aplicado: Contém, Correspondente
Exato, Começa Com ou Termina Com.
b. Em Critérios, configure os campos para restringir os elementos recuperados:
▪ Nome
Insira o nome do elemento a ser recuperado com base no tipo de filtro. Caracteres
especiais podem ser inseridos para substituir parte de um nome. Consulte Caracteres
especiais nas pesquisas por nome.
▪ Template
Selecione o template no qual os elementos recuperados devem estar baseados. Depois
de selecionar o template, será possível adicionar critérios para encontrar elementos
por valor do atributo.
▪ Categoria
Selecione a categoria com a qual os atributos recuperados devem corresponder.
▪ Valor do Atributo
Disponível se um template for especificado. Especifique uma condição de valor do
atributo um nome do atributo, o operador e valor do atributo, como Temperature >=
98. Para obter mais detalhes, consulte Configurar uma condição de valor do atributo.
c. Se desejado, clique em Adicionar Critérios e selecione mais campos a serem inseridos na
janela e configure-os para restringir os elementos recuperados:

▪ Valor do Atributo
Disponível se um template for especificado. É possível especificar até três condições
de valor do atributo. Para cada condição, especifique um nome do atributo, o
operador e o valor do atributo, por exemplo, Temperature >= 98.
▪ Tipo de Elemento
Selecione o tipo de elemento com o qual os atributos recuperados devem
corresponder.
▪ Raiz de Pesquisa do Elemento

Insira o elemento a ser usado como raiz ou nível base da pesquisa por elementos.
Digite o nome exato ou clique em Procurar para abrir a janela Navegador de
Elementos, na qual é possível ver a hierarquia de elementos e selecionar um elemento.
Não é possível incluir caracteres curinga no nome inserido. Se um elemento não for
especificado, será necessário definir o nível principal da hierarquia de elementos
como sendo a raiz. Dependendo da hierarquia PI AF, a especificação de um elemento
no campo Raiz de Pesquisa do Elemento poderá melhorar o desempenho da pesquisa.
▪ Todos Descendentes
Selecione Verdadeiro para recuperar qualquer subelemento na hierarquia
correspondente aos critérios especificados. Selecione Falso para recuperar apenas os
elementos do nível raiz correspondentes aos critérios especificados.
▪ Resultados por Página

Insira o número máximo de elementos para mostrar uma única página dos resultados
da pesquisa.
Se valores para múltiplas configurações forem especificados, a pesquisa retornará apenas os
elementos que atendam a todas as configurações especificadas.
3. Clique em Pesquisar para encontrar e exibir os resultados. É possível selecionar as colunas
que serão exibidas clicando no ícone de seleção das colunas à extrema direita dos
cabeçalhos das colunas.
4. Selecione os resultados que se deseja usar e clique em OK. Os resultados da pesquisa de
elemento selecionados são exibidos no Visualizador e no Navegador.
No Navegador, clique com o botão direito do mouse para salvar ou renomear os resultados
da pesquisa e mantê-los até que decida excluí-los. Ou clique com o botão direito do mouse
para excluí-los ou permitir a exclusão deles ao sair do PI System Explorer.
Nesta seção
• Configurar uma condição de valor do atributo
Use o campo Valor do Atributo na janela de pesquisa para configurar uma condição de valor
do atributo.
• Caracteres especiais nas pesquisas por nome de elemento
Configurar uma condição de valor do atributo

É possível restringir a pesquisa baseada no valor de um atributo. Depois de especificar um
template, use o campo Valor do Atributo para configurar uma condição à qual a pesquisa deve
atender com relação a um valor do atributo.
Procedimento
1. Clique em Exibir opções de atributos e selecione um atributo.

O menu agrupa os atributos nas seguintes categorias:
◦ Atributos Indexados
Os atributos indexados, incluindo os atributos de configuração.
◦ Atributos de Configuração
Os atributos de configuração não indexados.
◦ Outros Atributos
Os atributos de não configuração que não estão indexados.
Nota:
Os atributos não indexados podem demorar um tempo considerável para serem
avaliados, particularmente se eles estiverem configurados como uma referência de
dados.
O menu não mostra os atributos com tipos de valores Object ou Array. Não é possível
pesquisar esses atributos.
2. Clique no botão do operador e selecione um operador matemático.
Nos tipos de valores do atributo Single e Double, as consultas não dão suporte ao
operador In.
Nos tipos de valores do atributo String, Boolean e Int64, as consultas não dão suporte
aos seguintes operadores:
◦ < (menor que)
◦ > (maior que)
◦ <= (menor que ou igual a)
◦ >= (maior que ou igual a)
3. Insira um valor.
Insira o valor nas unidades especificadas pela UDM padrão no template do atributo.
Nos atributos indexados que armazenam os tipos de valores String, a pesquisa só usa os
primeiros 40 caracteres do valor inserido.
Caracteres especiais nas pesquisas por nome de elemento

No campo Nome é em uma pesquisa por elemento, podem-se usar caracteres especiais:
Caractere especial Objetivo
* Substitui qualquer número ou caractere não
especificado.
. Substitui um único caractere não especificado.
[xyz] Especifica um conjunto de caracteres (x, y ou z)
para corresponder.
[xyz] Especifica um conjunto de caracteres (x, y ou z)
para corresponder.
\ Ignorar o caractere especial subsequente e
interpretar com caractere real.
Exemplos de caracteres especiais

• Caracteres * e.

Suponha que haja elementos chamados Element1, Element54 e Element64.

Para recuperar todos os três elementos, digite:
E*
Para recuperar Element54 e Element 64, digite:
Element.4
Para recuperar apenas Element1, digite:
E*1
• Caractere \
Para pesquisar um elemento chamado Element*A42, digite:
Element\*A42
Para pesquisar um elemento chamado Element\A42, digite:
Element\\A42
• Caracteres []
Suponha que haja elementos chamados ElementA, ElementB, ElementC, ElementD e
ElementE.
Para recuperar ElementA e ElementB, digite:
Element[AB]
Como alternativa, para recuperar ElementA e ElementB, digite:
Element[!CDE]
Pesquisar atributos em elementos

Pode-se pesquisar um atributo ou grupo de atributos. Pode-se localizar determinado atributo,
por exemplo, para configurar a referência de dados de uma fórmula ou atribuí-la como um
valor a outro atributo. (Para pesquisar um valor específico de atributo, selecione um template e
um valor do atributo como critérios de pesquisa para a pesquisa de um elemento.)
Procedimento
1. No painel Navegador, clique no botão Elementos. Isso define o contexto coreto no menu
Pesquisar. Para pesquisar uma estrutura de evento ou atributos de transferência, clique no
botão Estrutura de eventos.
2. Clique em Editar > Pesquisa por Atributo.
A janela Pesquisa por Atributo é exibida.
3. Configure a janela Pesquisa por Atributo para encontrar o atributo desejado no banco de
dados do PI AF:
a. Em Onde, configure os campos para restringir os atributos recuperados:
▪ Nome do Atributo
Insira o nome do atributo a ser recuperado. Caracteres especiais podem ser inseridos
para substituir parte de um nome. Consulte Caracteres especiais nas pesquisas por
nome.
▪ Categoria do Atributo

▪ Tipo de Valor do Atributo

Selecione o tipo de valor que deve estar armazenado nos atributos recuperados.
▪ Contagem Máxima
Insira o número máximo de atributos correspondentes a serem recuperados.
b. Na área Critérios do Elemento, configure os campos para restringir os elementos
pesquisados dos atributos correspondentes:
▪ Raiz de Pesquisa
Insira o elemento a ser usado como raiz ou nível base da pesquisa por atributos.
Digite o nome exato ou clique em Procurar para abrir a janela Navegador de
Elementos, na qual é possível ver a hierarquia de elementos e selecionar um elemento.
Não é possível incluir caracteres curinga no nome inserido. Se um elemento não for
especificado, será necessário definir o nível principal da hierarquia de elementos
como sendo a raiz. Dependendo da hierarquia PI AF, a especificação de um elemento
no campo Raiz de Pesquisa poderá melhorar o desempenho da pesquisa.
Marque a caixa de seleção Pesquisar por Subelementos para pesquisar a raiz inserida
e todos os subelementos. Desmarque essa caixa de seleção para pesquisar apenas na
raiz inserida.
▪ Nome
Insira o nome dos elementos nos quais deseja-se pesquisar os atributos. Caracteres
especiais podem ser inseridos para substituir parte de um nome. Consulte Caracteres
especiais nas pesquisas por nome.
▪ Categoria
Selecione a categoria dos elementos nas quais deseja-se pesquisar os atributos.
▪ Template
Selecione o template dos elementos no qual deseja-se pesquisar os atributos.
▪ Tipo
Selecione o tipo dos elementos nos quais deseja-se pesquisar os atributos.
atributos que atendam a todas as configurações especificadas.
4. Clique em Pesquisar para recuperar os atributos correspondentes na tabela Resultados da
Pesquisa.
Ou use a árvore de elementos em Resultados da Pesquisa para manualmente pesquisar os
atributos em elementos particulares e selecione os atributos para adicioná-los à tabela
Resultados da Pesquisa.
5. Selecione os itens na lista de resultados da pesquisa e clique em OK para exibir os itens
selecionados no Visualizador e no Navegador. No Navegador, clique com o botão direito do
mouse para salvar ou renomear os resultados da pesquisa e mantê-los até que decida
excluí-los. Ou clique com o botão direito do mouse para excluí-los ou permitir a exclusão
deles ao sair do PI System Explorer.
Caracteres especiais nas pesquisas por nome

Ao pesquisar objetos por nome, como nomes de elementos ou de atributos, caracteres
especiais poderão ser usados:

Caractere especial Objetivo

* Substituir qualquer número ou caractere não especificado.
? Substituir um único caractere não especificado.
[xyz] Especificar um conjunto de caracteres (x, y ou z) para fazer a
correspondência.
[!xyz] Especificar um conjuntos de caracteres (x, y ou z) para impedir uma
correspondência.
\ Ignorar o caractere especial subsequente e interpretar com
caractere real.
Pesquisar estruturas de eventos

Procedimento
1. No painel Navegador, clique no botão Estruturas de Eventos.
2. Clique em Editar > Pesquisar Estrutura do Eventos. (Como alternativa, no Navegador, clique
com o botão direito do mouse em Pesquisas de Estruturas de Eventos e selecione Nova
Pesquisa.)
3. Insira os critérios de pesquisa para encontrar as estruturas de eventos. Note que o triângulo
no final do campo Pesquisa permite alterar entre operadores, como: Contém e Começa com.
Marque a caixa de seleção Em andamento para que apenas estruturas de eventos sem um
Tempo Final sejam retornadas.
No campo Nome, podem-se inserir caracteres especiais para corresponderem a parte de um
nome. Para obter mais informações, consulte Caracteres especiais nas pesquisas por nome.
Para adicionar campos aos critérios adicionais especificados, clique em Adicionar Critérios e
selecione um parâmetro na lista.
Pode-se usar o critério Raiz de Pesquisa de Estrutura de Evento para especificar que apenas
as estruturas de eventos filho da estrutura de evento especificada estão inclusas nos
É possível adicionar dois critérios Duração, se necessário. Por exemplo, para pesquisar uma
estrutura de eventos cuja duração foi de pelo menos uma hora, mas no máximo três horas, é
possível configurar dois campos de duração.
a. Selecione maior que ou igual ao operador (>=) e insira 1h no campo
b. Selecione menor que ou igual ao operador (<=) e insira 3h no campo
4. Clique em Pesquisar para encontrar os resultados que correspondam aos critérios. Os
resultados aparecem na tabela Resultados.
5. Opcional: Clique em OK para exibir os resultados no Visualizador e na árvore Navegador.
Pode-se escolher como listar os resultados da pesquisa no Navegador. Clique com o botão
direito do mouse em uma das pesquisas listadas, selecione Organizar Por e selecione o
critério desejado.
Clique com o botão direito do mouse para salvar ou renomear os resultados da pesquisa e
mantê-los até que decida excluí-los. Ou clique com o botão direito do mouse para excluí-los
ou permitir a exclusão deles ao sair do PI System Explorer.

Pesquisar atributos nas estruturas de eventos

Procedimento
1. No painel Navegador, selecione Estruturas de Eventos para definir o contexto nos menus de
pesquisa.
2. No menu principal do PI System Explorer, selecione Editar > Critérios de Pesquisa da
Estrutura de Eventos. A janela Pesquisa do atributo da estrutura de eventos é exibida.
3. Configure a janela Pesquisar por Atributos da Estrutura de Eventos para encontrar o atributo
desejado no banco de dados do PI AF:
nome.

b. Na área Critérios da Estrutura de Eventos, configure os campos para restringir a pesquisa
dos atributos correspondentes:
▪ Pesquisar
Selecione os critérios para encontrar transferências que sobrepõem o período
especificado em Pesquisar início e Pesquisar final.
▪ Pesquisar início/Pesquisar final

Selecione ou insira a hora de início e o tempo final do período da pesquisa.
▪ Raiz de Pesquisa
Insira a estrutura de eventos a ser usada como raiz ou nível base da pesquisa por
atributos. Digite o nome exato ou clique em Procurar para abrir a janela
Navegador de Estruturas de Eventos, na qual é possível ver a hierarquia e selecionar
uma estrutura de eventos. Não é possível incluir caracteres curinga no nome inserido.
Se uma estrutura de eventos não for especificada, a raiz será definida como o nível
principal da hierarquia. Dependendo da complexidade da hierarquia PI AF, especificar
a raiz de pesquisa pode melhorar o desempenho da pesquisa.
Marque a caixa de seleção Pesquisar Estruturas de Sub-eventos para pesquisar a raiz
inserida e todos os seus filhos. Desmarque essa caixa de seleção para pesquisar
apenas na raiz inserida.
▪ Nome
Insira o nome das estruturas de eventos nas quais os atributos serão pesquisados.
Caracteres especiais podem ser inseridos para substituir parte de um nome. Consulte
Caracteres especiais nas pesquisas por nome.

▪ Duração
Insira os valores de duração máxima e mínima para limitar a pesquisa de atributos a
estruturas de eventos, cuja duração está dentro dos limites.
▪ Categoria
Insira a categoria das estruturas de eventos nas quais os atributos serão pesquisados.
▪ Template
Insira o template das estruturas de eventos nas quais os atributos serão pesquisados.
▪ Tipo
Insira o tipo das estruturas de eventos nas quais os atributos serão pesquisados.
Pesquisa. Os resultados podem ser limitados ainda mais para listar apenas os atributos que
correspondem ao texto inserido no campo Resultados da pesquisa.
5. Selecione os itens na lista de resultados da pesquisa e clique em OK para exibir os itens
selecionados no Visualizador e no Navegador. No Navegador, clique com o botão direito do
mouse para salvar ou renomear os resultados da pesquisa e mantê-los até que decida
excluí-los. Ou clique com o botão direito do mouse para excluí-los ou permitir a exclusão
deles ao sair do PI System Explorer.
Pesquisar uma transferência

Procedimento
O Navegador exibe as coleções: Pesquisas de Estruturas de Eventos e Transferir Pesquisas.
Nota:
Se uma estrutura de eventos tiver sido criada recentemente, a coleção Estruturas de
Eventos Recentes também aparecerá no Navegador. Da mesma forma, se uma
transferência tiver sido recentemente criada, a coleção Transferências Recentes será
exibida no Navegador.
2. Clique com o botão direito do mouse na pasta Transferir Pesquisas e selecione Nova
Pesquisa.
A caixa de diálogo Critérios de Pesquisa de Transferência é exibida.
3. Insira os critérios de pesquisa para encontrar as transferências. Note que no campo Nome,
podem-se inserir caracteres especiais para corresponderem a parte de um nome. Para obter
mais informações, consulte Caracteres especiais nas pesquisas por nome.
Os campos Origem e Destino permitem a especificação de elementos que possam ser de
origem ou de destino de uma transferência.
O campo Contagem Máxima limita o número de resultados da pesquisa retornados.
4. Depois de configurar os critérios de pesquisa, clique em Pesquisar.
Os resultados da pesquisa aparecem na área Resultados da pesquisa da janela Critérios de
Pesquisa de Transferência.
5. Para refinar ainda mais a pesquisa, insira o texto de filtro no campo de texto acima dos
resultados da pesquisa. Enquanto digita, os resultados da pesquisa são filtrados.

Pesquisar atributos em transferências

Procedimento
1. No painel Navegador, selecione Estruturas de Eventos para definir o contexto nos menus de
pesquisa.
2. No menu principal do PI System Explorer, selecione Editar > Transferir Pesquisa por
Atributo. A janela Transferir Pesquisa por Atributo é aberta.
3. Configure a janela Transferir Pesquisa por Atributo para encontrar o atributo desejado no
banco de dados do PI AF:
nome.

b. Na área Critérios de Transferência, configure os campos para restringir a pesquisa de
atributos às transferências que correspondam a critérios específicos:
▪ Pesquisar
Selecione os critérios para encontrar transferências que sobrepõem o período
especificado em Pesquisar início e Pesquisar final.
▪ Pesquisar início/Pesquisar final

Selecione ou insira a hora de início e o tempo final do período da pesquisa.
▪ Nome
Insira o nome das transferências nas quais deseja-se pesquisar os atributos.
Caracteres especiais podem ser inseridos para substituir parte de um nome. Consulte
Caracteres especiais nas pesquisas por nome.
▪ Origem
Insira ou procure e selecione o elemento de origem das transferências cujos atributos
deseja-se incluir na pesquisa.
▪ Destino
Insira ou procure e selecione o elemento de destino das transferências cujos atributos
deseja-se incluir na pesquisa.
▪ Template
Selecione o template das transferências na qual deseja-se pesquisar os atributos.

▪ Categoria
Selecione a categoria das transferências na qual deseja-se pesquisar os atributos.
Pesquisa.
Os resultados podem ser limitados ainda mais para listar apenas os atributos que
correspondem ao texto inserido no campo Resultados da pesquisa.
Os resultados da pesquisa por atributos anteriores estarão disponíveis no painel Navegador
até que sejam excluídos.
Criar uma tendência no PI System Explorer

Ao procurar elementos no PI System Explorer, é possível criar rapidamente tendências simples
para que fórmulas, cálculos e outras medidas criadas no PI AF possam ser verificados. Durante
a criação de um AF Formula, pode-se desejar ver a aparência dos resultados nas últimas horas.
Se você está criando atributos de pontos PI que envolvem resumos, isto poderá ser útil para
ver como eles se parecem nas últimas horas.
Você pode adicionar atributos AF ou pontos PI de interesse a uma tendência; uma forma de
fazer isso é arrastando-os e soltando-os na tendência. Dessa forma, será possível explorar os
dados ajustando a duração e a hora de início e o tempo final da tendência.
Depois que a tendência é criada, ela permanecerá disponível na janela Tendência, mesmo
quando outros recursos estiverem sendo usados no PI System Explorer. É possível adicionar ou
remover linhas da tendência a qualquer momento. Um cursor de tendência está disponível, e
clicando com o botão direito do mouse na tendência, pode-se obter um menu de contexto.
Também é possível ver uma tendência de um atributo quando os dados da série de tempo dele
são exibidos, (para fazer isso, clique com o botão direito do mouse no atributo e selecione
Dados de Série de Tempo). A tendência é mostrada automaticamente na parte inferior da
janela Dados de Série de Tempo.
Nota:
A OSIsoft recomenda usar as nossas ferramentas de visualização, como o PI Coresight, o
PI ProcessBook e o PI WebParts, para criar e salvar as tendências que se planeja usar
mais de uma vez.
Procedimento
1. Selecione Mostrar Tendência no menu Visualizar. A janela Tendência é aberta.
2. Para adicionar um atributo AF a uma tendência, clique em Adicionar Atributos. A janela
Pesquisa por atributos é aberta.
a. Se necessário, especifique os parâmetros de pesquisa em Nome do Atributo, Categoria
do atributo e outros campos para encontrar o atributo de interesse.
b. Expanda a hierarquia de elementos na área Resultados da pesquisa e selecione o atributo.
c. Clique em OK. A janela Tendência exibe uma tendência mostrando como esse atributo
variou na última hora (1 hora é a duração padrão).
d. Pode-se ajustar a duração especificando os tempos nos campo Hora de Início e Tempo
Final.
3. Para adicionar um ponto PI em uma tendência, clique em Adicionar Pontos PI. A janela
Pesquisa por tag é aberta.

a. Pesquise o ponto PI que deseja ver e selecione-o nos resultados.

b. Clique em OK. O ponto PI é adicionado à tendência.
4. Adicione quaisquer atributos AF e pontos PI extras para os quais você deseja visualizar
dados.
As linhas na janela Tendência persistem até que a janela seja fechada. Em qualquer ponto, é
possível arrastar atributos e pontos PI de outros resultados da pesquisa e soltá-los na
tendência para adicioná-los.
Também é possível clicar com o botão direito do mouse em um atributo ou ponto e
selecionar Adicionar à Tendência.
5. Para ajustar quais linhas são visíveis na tendência, clique em Linhas e desmarque a caixa de
seleção dos atributos e pontos que não se deseja ver.
Fazer alterações em equipamentos e processos

Quando é necessário fazer uma alteração no equipamento, por exemplo, trocar uma bomba
quebrada por outra similar, é possível continuar usando o elemento existente para representar
a nova bomba. No entanto, para indicar que uma alteração foi feita, é uma boa ideia criar uma
nova versão do elemento. Dessa forma, um registro da alteração é disponibilizada para o
equipamento representado pelo elemento.
Da mesma forma, talvez seja necessário criar versões de uma tabela. Por exemplo, tabelas
fortes de tanques são atualizadas periodicamente para corresponderem com a alteração das
características físicas do tanque. Ao criar a versão da tabela, será possível usar a tabela quando
ela foi configurada no momento da coleta de dados.
O PI System Explorer permite a criação de várias versões de elementos, modelos e tabelas.
Além de indicar que um elemento, modelo ou tabela não está no serviço após determinada data
selecionando a data como sendo a sua data obsoleta.
Nesta seção
• Criar uma versão de um elemento ou modelo
• Criar uma versão de tabela
• Exibir versões de objetos diferentes e objetos obsoletos
Criar uma versão de um elemento ou modelo

Procedimento
1. No painel Navegador, clique em Elementos e selecione o elemento ou o modelo cuja versão
deseja-se criar na árvore Navegador.
2. Clique na guia Versão no painel Visualizador e clique em Nova Versão. (Também é possível
clicar com o botão direito do mouse no elemento ou modelo no Navegador e selecione Criar
Versão.) A janela Criar Versão é exibida.
3. Insira uma Data Efetiva para a versão, clique em para selecionar uma e clique em OK. O
PI System Explorer criar uma nova versão.
Nota:
A criação de uma nova versão fará um check in no elemento ou modelo.

Criar uma versão de tabela

Procedimento
1. No painel Navegador, clique em Biblioteca e selecione a tabela cuja versão deseja-se criar na
árvore Navegador.
2. Clique com o botão direito do mouse na coleção Tabelas e selecione Nova Tabela.
3. Clique na guia Versão no painel Visualizador e clique em Nova Versão. (Também é possível
clicar com o botão direito do mouse no elemento ou modelo no Navegador e selecione Criar
Versão.) A janela Criar Versão é exibida.
4. Insira uma Data Efetiva para a versão, clique em para selecionar uma e clique em OK. O
PI System Explorer criar uma nova versão.
Nota:
A criação de uma nova versão fará o check in na nova tabela.
Exibir versões de objetos diferentes e objetos obsoletos

Por padrão, o PI System Explorer mostra as versões mais recentes dos elementos, dos modelos
e das tabelas (mesmo que essas versões não tenham sido lançadas). Ele também exclui as
versões anteriores de todos os objetos com uma data Obsoleta especificada (mesmo que a data
esteja no futuro). Como resultado, quando uma data Obsoleta é especificada para um objetos e
seu check in é feito, ela desaparece imediatamente do PI System Explorer.
No entanto, pode-se encontrar e visualizar um objeto obsoleto ou uma versão particular de um
objetos configurando Data da Consulta para um tempo fixo no qual o objeto ou a versão são
atuais. Para exibir um elemento efetivado em 1° de janeiro de 2010 e que se tornou obsoleto
em 1° de janeiro de 2011, por exemplo, configure Data da Consulta para qualquer tempo entre
essas duas datas.
Nesta seção
• Data da consulta e horário PI System Explorer
• Mostrar uma data e hora específica
• Configurar o contexto de tempo para os valores de atributo exibidos
• Comparar duas versões
Data da consulta e horário PI System Explorer

Data da Consulta determina os valores de tempo que o PI System Explorer usa para:
• encontrar e exibir valores do atributo

• identificar as versões atuais dos objetos a serem exibidos e inclusos nos resultados da
pesquisa
Na configuração padrão Data da Consulta, Definir para Mais recente, o PI System Explorer
encontra e exibe os dados mais atuais dos valores do atrubuto. (Pode-se substituir Data da
Consulta para visualizar os valores de um tempo diferente em Definir contexto de tempo.
Consulte Configurar o contexto de tempo para os valores de atributo exibidos.)
Definir para Mais recente também faz com que o PI System Explorer use as versões mais
recentes dos objetos, mesmo se essas versões estiverem no futuro, e exclui qualquer objeto
com uma data Obsoleta, mesmo se essa data estiver no futuro.

Pode-se alterar Data da Consulta para especificar uma data e hora fixas.
• O seletor de data e hora permite especificar uma configuração de data e hora.

• As seleções Definir para Agora e Definir para Hoje usa o tempo atual para estabelecer uma
data e hora fixas. Por exemplo, se Definir para Agora for selecionado na Segunda-Feira, na
Quarta-Feria a Data da Consulta ainda estará definida como Segunda-Feira.
Como a Data da Consulta afeta o PI System Explorer
O que é afetado A Data da Consulta é Definir para A Data da Consulta é uma data e
Mais recente hora fixas
Todos os objetos PI System Explorer O PI System Explorer usa as versões O PI System Explorer usa as versões
mais recentes, se essas versões dos objetos que estão em execução
estão no futuro; ele exclui todos os naquele tempo.
objetos com uma data obsoleta,
mesmo que essa data esteja no
futuro.
Versões de elemento, modelo e O PI System Explorer retorna as O PI System Explorer retorna as
tabela na pesquisa versões mais recentes, mesmo que versões estão em execução naquele
elas estejam no futuro. tempo.
Tempos relativos nas pesquisas O PI System Explorer define o temo O PI System Explorer define o tempo
atual (*) como o tempo da pesquisa. atual (*) como o tempo especificado
pela Data da Consulta.
Dados PI Os dados PI são retornados no valor Os dados PI retornados são os
de seu último instantâneo. valores para o timestamp
especificado pela Data da Consulta.
Mostrar uma data e hora específica

Ao definir uma data da consulta como uma data e hora específicas, a data permanecerá
constante na data e hora até que seja alterada.
Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Data da Consulta.
O Seletor de data e hora é exibido.
2. Selecione a data e hora desejadas. Para definir uma data da consulta como a data e hora
atuais, clique no botão Definir para Agora.
Nota:
Ao selecionar Definir para Agora como a data da consulta, a data da consulta será
configurada para uma data e hora específicas; esse é um valor constante. Isso não é o
mesmo de configurar uma data da consulta para sempre ser o tempo atual. Para fazer
isso, deve-se selecionar a opção Definir para Mais recente.
3. Clique em OK.
Configurar o contexto de tempo para os valores de atributo exibidos

Os usos do PI System Explorer do tempo ou intervalo de tempo para exibir valores de atributo
são determinados por Definir contexto de tempo.
Por padrão, o PI System Explorer exibe os valores mais recentes dos atributos com base no
tempo atual. A Data da Consulta reflete a configuração de tempo do PI System Explorer

(consulte Data da consulta e horário PI System Explorer). Os valores de atributos podem ser
visualizados para um tempo diferente, no entanto, especificando um novo tempo em Definir
contexto de tempo.
Alguns valores de atributo refletem um intervalo de tempo (por exemplo, a média dos valores
do ponto na última hora). Pode-se usar Definir contexto de tempo para especificar um intervalo
de tempo diferente para os valores de atributo exibidos.
As configurações de tempo e intervalo de tempo em Definir contexto de tempo se aplicam
apenas aos valores de atributo exibidos. A Data da Consulta continua a ser aplicada a todos os
objetos PI System Explorer.
Procedimento
1. Na barra de ferramentas do PI System Explorer, clique no botão Definir contexto de tempo
para abrir a janela Definir contexto de tempo.
Ou clique em Ferramentas > Opções e selecione a guia Contexto de Tempo.

2. Selecione uma destas opções. Insira os valores de tempo de uma opção diretamente ou
clique no botão do seletor de data e hora para selecioná-las. Também é possível usar o botão
de menu em cascada para criar uma expressão de tempo.
Opção Descrição
Data/Hora da Consulta A caixa de texto exibe a configuração atual para a
Data da Consulta. Uma nova configuração de
tempo pode ser selecionada para a Data da
Consulta.
Tempo Alternativo Insira um novo tempo para ser usado nos valores
de atributo exibidos.
Intervalo de Tempo Insira a Hora de Início e o Tempo Final para
especificar um novo intervalo de tempo a ser
usados nos valores atribuídos exibidos que
precisam de um intervalo de tempo.
3. Opcional: Clique em Definir como Padrão para registrar as configurações atuais como o
contexto de tempo padrão ou clique em Restaurar Padrão para restaurar o contexto de
tempo para a Data e Hora da Consulta definida para a Disponibilizado por último.
4. Clique em Aplicar para ver as alterações e em OK para salvá-las.
Comparar duas versões

É possível comparar duas versões de qualquer objeto cuja versão possa ser criada (elemento,
modelo ou tabela).
Procedimento
1. Selecione o objeto cujas versões desejam-se examinar e clique na guia Versão.
2. Clique em Exibir Histórico. A janela Exibir Histórico é aberta. Todas as versões existentes são
relacionadas no painel à esquerda.
3. Selecione duas versões no painel esquerdo. As diferenças são mostradas no painel à direita
usando barras de alteração coloridas.

◦ Vermelho significa que o item estava presente na versão anterior, mas não está presente
na nova versão.
◦ Verde significa que o item está presente na nova versão, mas não estava presente na
versão anterior.
◦ Amarelo significa que o item foi alterado entre a versão anterior e a nova.
Visualizar dados das séries de tempo

O PI System Explorer pode exibir dados das séries de tempo para atributos que contenham ou
façam referência a esses dados. Isso permite a visualização de como as configurações das
referências de dados funcionarão com os dados coletados em outras ferramentas cliente PI,
como o PI ProcessBook, o PI Coresight, o PI DataLink e o PI WebParts.
Nota:
Algumas configurações de atributo não têm suporte a esse tipo de dados. Consulte
Restrições na visualização dos dados da série de tempo
Procedimento
1. Clique com o botão direito do mouse no atributo no Visualizador e selecione a opção Dados
das Séries de Tempo no menu que é exibido. A janela Dados das Séries de Tempo é exibida.
2. Selecione a guia representando o tipo de dados que se desejam ver:
◦ Archive
Para PI Points. Mostra os valores arquivados na hora especificada. As configurações
incluem Tipo de limite e Expressão de filtro.
◦ Exemplificado
Retorna valores interpolados e igualmente espaçados em um intervalo regular. Pode-se
incluir Expressão de filtro.
◦ Gráfico
Recupera valores no intervalo de tempo especificado compatível para a criação de gráfico
no número especificado de intervalos. Normalmente, os intervalos representam pixels, e
é possível usar esse recurso para representar a largura de tela disponível para o gráfico.
◦ Resumo
Exibe o resumo Estatísticas dos valores do atributo que fornecem suporte a esse recurso.
Pode-se especificar Ponderado.
Nesta seção
• Estatísticas
• Ponderado
• Expressão de filtro
• Tipo de limite
• Restrições na visualização dos dados da série de tempo
• Abreviaturas de configuração do atributo

Estatísticas
A guia Resumo fornece as seguintes estatísticas para os atributos com suporte a essas
estatísticas:
• Porcentagem Boa
Exibe a porcentagem de tempo no qual os valores bons são retornados no intervalo de
tempo total. Valores bons são valores de evento determinados para serem válidos e fora de
um estado de erro.
• Médio
Calcula a média de valores durante o intervalo.
• Mínimo
Retorna o valor mínimo durante o intervalo.
• Máximo
Retorna o valor máximo durante o intervalo.
• Intervalo
Calcula o valor máximo menos o valor mínimo durante o intervalo.
• Desvio padrão
Calcula a média do desvio padrão dos valores no intervalo.
• Desvio padrão da população
Calcula o desvio padrão da população dos valores no intervalo.
• Contagem
Retorna o número de valores armazenados durante o intervalo.
Ponderado
A guia Resumo permite a seleção do valor Ponderado nos cálculos estatísticos:
• Tempo ponderado
Padrão. Pondera cada valor do evento pelo comprimento de tempo ao qual ele é aplicado.
• Tempo ponderado contínuo
Pondera o tempo dos valores, mas faz toda a interpolação entre valores, como se eles
representassem dados contínuos (interpolação padrão), independentemente de os atributos
serem nivelados.
• Tempo ponderado discreto
Pondera o tempo dos valores, mas faz toda a interpolação entre valores, como se eles
representassem dados discretos (gráfico de escada), independentemente de os atributos
serem nivelados.
• Evento ponderado
Pondera cada evento da mesma forma. Esse método requer pelo menos um evento em um
intervalo de tempo (dois eventos para os cálculos de desvio padrão). Por padrão, os eventos
no limite do cálculo são lidados da seguinte forma:

◦ usa eventos nos dois limites quando há apenas um intervalo de cálculo

◦ inclui eventos na hora de início em vários intervalos, que estão na ordem de tempo
crescente
◦ inclui eventos na hora de término em vários intervalos, que estão na ordem de tempo
decrescente
• Evento ponderado — Excluir eventos anteriores
EventWeighted, exceto que o evento na hora de início (hora mais cedo) de um intervalo não
é usado em um intervalo.
• Evento ponderado — Excluir evento mais recente:
EventWeighted, exceto que o evento na hora de término (hora mais recente) de um
intervalo não é usado nesse intervalo.
• Evento ponderado — Inclui as duas extremidades:
Eventos nas duas extremidades dos limites do intervalo estão inclusos nos cálculos de
evento ponderado.
Expressão de filtro
Adicione uma expressão de filtro para filtrar valores de evento usando uma expressão
matemática, eliminando dados para os quais a expressão é avaliada como falsa. Por exemplo, a
expressão de filtro simples:
‘.’ < 70
removeria todos os valores acima de 70 de um cálculo. Também é possível usar um PI

Performance Equation válido na expressão de filtro para criar expressões mais complexas para
remover picos atípicos em valores de dados, por exemplo.
Valores de expressão são limitados a Atributos ou PI Points originados de um único PI Server.
Atributos resolvidos para um valor estático (nenhuma referência de dados configurada)
também são aceitáveis. Consulte Referência indireta para obter uma descrição completa da
possível sintaxe de referência.
Exemplos de Variável de Atributo
Expressão de Filtro Função
"." Referência ao atributo consultado
"Level" Referência ao atributo "Level" no mesmo nível da
hierarquia de atributo no elemento ou na estrutura de
eventos.
".." Referência ao atributo pai de um atributo consultado.
Válido apenas para atributos filhos alojados.
".|HighLimit" Referência ao atributo filho "HighLimit" do atributo
consultado.
"|Temperature" Referência ao atributo "Temperature" no nível de
hierarquia superior no elemento atual ou na estrutura
de eventos.
"\\MyPIServer\sinusoid" Caminho absoluto para um PI Point. Ele deve estar no
mesmo PI Server do atual atributo consultado.
"\\myAFServer\myDatabase\myElement| Caminho absoluto para um Atributo AF.
myAtttribute"


"\myRootElement|myAtttribute" Caminho relativo do banco de dados para um Atributo
AF
Exemplos de Variáveis do PI Point

"." Referência ao PI Point consultado
"sinusoid" Referência ao PI Point "sinusoid" no mesmo PI Server.
Tipo de limite
Especifique um tipo de limite para determinar como as buscar por valores de dados são
realizadas perto das horas de início e término do intervalo do valor:
• Dentro (padrão)
Retorna valores nas horas de início e término, caso eles existam, ou os valores mais
próximos encontrados nesse intervalo.
• Fora
Retorna os valores mais próximos encontrados imediatamente fora do intervalo.
• Interpolado
Retorna valores interpolados nas horas de início e término.
Restrições na visualização dos dados da série de tempo

Algumas configurações de atributo não têm suporte a algumas funções de dados. A tabela a
seguir explica que as funções recebem suporte dos tipos de configuração das referências de
dados. Essas restrições também se aplicam a outras ferramentas cliente, inclusive PI DataLink,
PI Coresight, PI ProcessBook e PI WebParts.
Para obter uma descrição as abreviaturas de configuração do atributo no cabeçalho da tabela,
além das definições de cada tipo de configuração de atributo, consulte Abreviaturas de
configuração do atributo.
Função PI PI-Arc PI-Rel PI-TR PI-TR- NO-DR F CC CTS
Rel
Interpol SIM SIM SIM NÃO SIM SIM SIM OptIn Código
atedValu
e
atedValu
es
atedValu
esAtTim
es
Recorde SIM NÃO SIM NÃO NÃO SIM SIM OptIn Código
dValue
dValues

Função PI PI-Arc PI-Rel PI-TR PI-TR- NO-DR F CC CTS

Rel
dValues
ByCount
PlotValu SIM NÃO SIM NÃO NÃO SIM SIM OptIn Código
es
Summar SIM NÃO SIM NÃO NÃO SIM SIM OptIn Código
y
Summar SIM NÃO SIM NÃO NÃO SIM SIM OptIn Código
ies
Filtered SIM NÃO NÃO NÃO NÃO NÃO NÃO NÃO Código
Summar
ies
UpdateV SIM NÃO SIM NÃO NÃO SIM NÃO NÃO Código
alue
UpdateV SIM NÃO SIM NÃO NÃO SIM NÃO NÃO Código
alues
Annotati SIM SIM SIM NÃO NÃO NÃO NÃO NÃO Código
ons
Filters SIM NÃO NÃO NÃO NÃO NÃO NÃO NÃO Código
Abreviaturas de configuração do atributo

Esta tabela define as abreviaturas de configuração do atributo usadas em Restrições na
visualização de dados das séries de tempo.
Abreviatura Seu significado Descrição
PI PI Point simplesmente Nenhuma configuração adicional
configurado do método de tempo é
automática, interpolada ou
AtOrBefore
PI-Arc Recuperação de archive Método de tempo de Antes,
especificada pelo PI Point Exato, AtOrAfter, Após
PI-Rel PI Point relativo PI Point simplesmente
configurado com tempo relativo
configurado. O método de tempo
é Automatic, Interpolated ou
AtOrBefore
PI-TR Intervalo de tempo apenas do PI O método de tempo não tem
Point suporte.
PI-TR-Rel Intervalo de tempo com tempo O método de tempo está
relativo configurado para TimeRange ou
TImeRangeOverride.
No-DR Nenhuma Referência de Dados Nenhuma Referência de Dados
F Cálculo com base na Referência Se não houver entradas, isso
de Dados com entradas de séries dificilmente se comportará como
de tempo, como Fórmula. No-DR.
CC Referência de Dados
Personalizada calculada com
base em

Abreviatura Seu significado Descrição

CTS Referência de Dados
Personalizada que gera seus
próprios dados de séries de
tempo

Projetar e implementar os modelos de ativos do PI
AF
Nesta seção
• Organizar modelos de ativos
• Representar ativos no PI Asset Framework
• Segurança do objeto PI AF
• Associação de dados com ativos
• Trabalhar com unidades de medida
Organizar modelos de ativos

O objetivo da organização do modelo de ativos é tornar a busca de ativos pelos usuários mais
fácil. O principal método de organização é a árvore de elementos. Os elementos PI AF são
organizados em uma estrutura de árvores. Elementos individuais podem ser organizados e
agrupados na árvore, sem limitações. Se estiver começando a usar o PI AF, primeiro, crie a
hierarquia de elementos. Consulte Estruturar o modelo de ativo.
Também é possível organizar por meio de categorias para agilizar e simplificar a busca e
pesquisa de informações. Pensa nas categorias como rótulos que podem ser aplicados aos
objetos PI AF. Cada objeto pode ter várias categorias. Consulte Usar categorias para facilitar a
procura de objetos.
Nota:
Também é possível organizar ativos em um processo. Consulte Modelar um processo.
Nesta seção
• Estruturar o modelo de ativo
• Como decidir sobre uma hierarquia
• Criar várias visualizações de ativos
• Usar categorias para facilitar a procura de objetos
Estruturar o modelo de ativo

Os objetos PI AF são organizados em uma estrutura em árvore, semelhante à estrutura de
arquivos em um computador Windows. No Windows, em vez de ter milhares de arquivos no
desktop, normalmente os arquivos são agrupados em pastas. O mesmo conceito é aplicado aos
elementos AF. Organizar elementos em hierarquias facilita a navegação dos elementos e
fornece insights sobre como os elementos se relacionam entre si.
Ao criar um modelo de ativo, é necessário decidir qual estrutura facilitará a procura de
diferentes ativos pelos usuários. Considere quem são os usuários e o que eles estão
procurando. Por exemplo, engenheiros de manutenção podem querer usar o PI System
Explorer para encontrar e gravar informações de manutenção. Para esse público, agrupe os
ativos por tipo de equipamento.
Por exemplo, se houve três elementos de bomba, será possível criar um elemento chamado
Bombas e colocar todos os elementos da bomba nele. Se havia dois elementos representando
tanques, é necessário colocá-los no elemento Tanques.

Projetar e implementar os modelos de ativos do PI AF
Modelo de ativo organizado por tipo de equipamento
Por outro lado, se houver várias plantas em diferentes locais, esse mesmo engenheiro de
manutenção poderá querer ver todos os equipamentos localizados em sua própria planta. A
ilustração a seguir mostra os mesmos elementos organizados por planta.
Modelo de ativo organizado por local
O usuário não está restrito a apenas uma estratégia organizacional. É possível usar referências
de elementos para incluir o mesmo ativo em mais de um local na árvore. Por exemplo, seria
possível escolher organizar por tipo de equipamento e por planta. Na ilustração a seguir, a
hierarquia inclui a árvore geográfica e a árvore de equipamento lado a lado.
Modelo de ativo misto
Como alternativa, agrupe a organização do equipamento na organização geográfica.
Como decidir sobre uma hierarquia

O objetivo é criar uma hierarquia de elementos que será entendida pelas pessoas que a usarão.
Se houver diferentes tipos de usuários, talvez seja necessário criar a mais de uma estrutura de
árvores.
Caso esteja começando, não tente fazer tudo de uma única vez. Crie uma hierarquia para um
subconjunto de ativos. Por exemplo, comece criando um modelo para todos os tanque ou, como
alternativa, para os equipamentos de uma única planta ou para os equipamentos de um
fabricante específico. Outra abordagem é criar uma hierarquia para um tipo específico de
usuário.
Colete informações:

• Quais ativos serão incluídos na árvore? Em outras palavras, para quais tipos de
equipamento os modelos serão criados?
• Quem precisará encontrar os ativos nessa árvore? Engenheiros de manutenção?
Engenheiros de controle do processo? Operadores? Quais tarefas cada tipo de usuário
precisará realizar?
• Quais ativos são importantes para cada usuário e de quais informações eles precisarão?
Pergunte a alguns usuários representativos de cada tipo sobre os dados que eles precisam
acessar e como isso é feito. Isso deve informar a sua estratégia organizacional.
Novamente, comece aos poucos. Pode-se iniciar com um tipo de usuário. Por exemplo, suponha
que engenheiros de manutenção precisem usar o modelo. Se houver várias plantas, cada uma
tendo um grupo de engenheiros de manutenção como responsável pelo equipamento, será uma
boa ideia incluir uma árvore que organize os equipamentos por planta.
Então, pergunte a alguns engenheiros de manutenção como eles gostariam de acessar as
informações do equipamento. Talvez eles normalmente procurem os ativos por tipo de
equipamento, mas, às vezes, eles precisem pesquisar por fabricante. Seria possível criar
árvores paralelas, uma organizada por tipo de equipamento, e outra, por fabricante. Cada ativo
apareceria nas dias árvores. Ou poderia criar a árvore por tipo de equipamento e usar
categorias para rotular cada ativo por fabricante.
Depois de criar a hierarquia por tipo de usuário, peça a alguns deles para testar o resultado por
um templo, então, peça o feedback deles para melhorar a hierarquia. Sempre é possível alterar
uma hierarquia.
Nota:
Ao considerar os usuários, lembre que a hierarquia de elementos também pode estar
exposta a certos aplicativos clientes PI. Também leve os usuários desses aplicativos em
consideração. Por exemplo, o PI Coresight expõe a árvore para usuários que procuram
ativos relacionados. No PI Coresight, os ativos relacionados são elementos criados no
mesmo template.
Criar várias visualizações de ativos

Podem-se usar referências de elemento para adicionar mais de uma vez o mesmo elemento à
hierarquia de elementos, conforme descrito em Estruturar o modelo de ativo. Ao criar uma
referência para um elemento existente, crie um placeholder na hierarquia que aponte
novamente para o elemento referenciado. Isso permite que os usuários encontrem o elemento
em todos os contextos relevantes, mas isso não cria uma cópia do elemento. O comportamento
exato depende do tipo de referência:
Nesta seção
• Tipos de referência
• Criar uma referência de elemento
• Criar várias referências de elemento
• Localizar outras referências no mesmo elemento
Tipos de referência
Ao adicionar uma referência de elemento a uma hierarquia de elementos, a relação exata entre
o elemento referenciado e o elemento a que ela foi adicionada depende do tipo de referência.
Por padrão, o PI AF fornece três tipos de referência:

• Tipo de referência Pai-filho

• Tipo de referência de composição
• Tipo de referência fraca
Também é possível criar tipos de referência personalizada próprios ao Representar templates
filho.
Nesta seção
• Tipo de referência Pai-filho
• Tipo de referência de composição
• Tipo de referência fraca
Tipo de referência Pai-filho

Pai-filho é o tipo de referência padrão. Ele permite que o elemento filho tenha muitos pais. Se o
último elemento pai do filho for excluído, o filho também será excluído. Por exemplo, o
medidor pertence a uma companhia e está anexado a uma instalação. Uma referência pai-filho
seria usada entre o elemento da companhia e o elemento do medidor filho; outra referência
pai-filho seria escolhida entre o elemento da instalação e o elemento do medidor filho.
Se o medidor for removido da instalação, ele ainda existirá, pois ainda terá uma referência pai-
filho com o elemento da companhia. Se ele também for removido da companhia, então, ele
deixará de existir, pois todas as referências pai-filho terão sido removidas.
Tipo de referência de composição

Um tipo de referência com um comprimento de composição de referência significa que o
elemento filho é uma parte do pai e não existe sem o pai. Se um elemento pai que tem um
elemento filho composicionalmente referenciado for excluído, o elemento filho também será
excluído.
Use uma referência de composição quando dois objetos na relação forem considerados um
item. Por exemplo, um medidor pode ser composto por dois sensores, portanto, uma referência
de composição seria usada entre o elemento do medidor e cada um de seus dois elementos
filhos dos sensores filhos. A exclusão do elemento do medidor também excluir os elementos do
sensor filho. Ao fazer check out de um dos elementos filhos para fazer uma alteração, também
será feito check out do outro elemento do sensor e do elemento do medidor.
Tipo de referência fraca

Use uma referência fraca entre dois elementos quando se desejar criar uma relação entre dois
elementos, mas não se desejar que esse relacionamento controle o tempo de vida do elemento
filho. Por exemplo, para organizar os medidores em grupos, mas se todas as referências fortes
ao medidor forem removidas, será desejado que eles sejam automaticamente removidos do
agrupamento. Nesse caso, use uma referência fraca entre o elemento pai do grupo e o elemento
do medidor filho.
Criar uma referência de elemento

Procedimento
1. No Navegador, clique no elemento que se deseja referenciar e arraste-o para o elemento pai
apropriado.

A janela Escolher Tipo de Referência é exibida.

2. Selecione o tipo de referência. Caso o tipo de referência desejado não esteja definido,
provavelmente o tipo de referência padrão, pai-filho, será o desejado. Consulte Tipos de
referência para obter mais informações.
3. Clique em OK.
Os elementos de referência são exibidos no Navegador. O ícone do elemento de referência
indica que eles são referências.
Criar várias referências de elemento

Procedimento
1. No Navegador, clique com o botão direito do mouse no elemento, aponte para Novo e
selecione Adicionar Referência de Elemento. Observe que também é possível selecionar um
elemento e arrastá-lo para o pai. A janela Adicionar Elementos é exibida.
2. Clique no botão Encontrar Múltiplos Elementos.
A janela Pesquisar Elemento é exibida.
3. Selecione os critérios de pesquisa para localizar os elementos desejados e clique no botão
Pesquisar.
O campo de resultados da pesquisa mostra os resultados da pesquisa.
4. Selecione os elementos aos quais a referência será feita e clique em OK.
A janela Adicionar Elementos é exibida.
5. Selecione o tipo de referência. Caso o tipo de referência desejado não esteja definido,
provavelmente o tipo de referência padrão, pai-filho, será o desejado. Consulte Tipos de
referência para obter mais informações.
6. Clique em OK.
Os elementos de referência são exibidos no Navegador. O ícone do elemento de referência
indica que eles são referências.
Localizar outras referências no mesmo elemento

É possível fazer referência a um único elemento em vários locais em uma hierarquia. Todos os
elementos na biblioteca contendo o elemento ou uma referência ao elemento podem ser
encontrados.
Procedimento
1. Selecione o elemento no Navegador.
2. Na folha de propriedades, clique na guia Geral.
3. Clique no link Pais.
Os pais do elemento são exibidos.
Usar categorias para facilitar a procura de objetos

Nesta seção
• Categorias
• Criar uma nova categoria

• Visualizar categorias
• Adicionar um objeto a uma categoria
Categorias
O PI System Explorer permite organizar objetos em categorias. As categorias são
essencialmente grupos de objetos definidos pelo usuário. O objetivo delas é ajudar o usuário a
encontrar objetos com mais facilidade. Ao pesquisar um objeto, é possível usar a categoria
como um filtro para reduzir a lista de resultados. Defina quantas categorias desejar. Os objetos
podem pertencer a várias categorias.
Por exemplo, suponhamos que haja um conjunto de elementos representando tanques. Metade
dos tanques são fabricados pela empresa ACME, e a outra metade, pela empresa EMCA. Para
localizar os tanques por fabricante, crie uma categoria ACME e uma EMCA.
Cada tipo de objeto tem suas próprias categorias. Não é possível aplicar categorias de um tipo
de objeto a um objeto de outro tipo. Por exemplo, não é possível aplicar uma categoria de
elemento a uma tabela. O PI AF dá suporte aos seguintes tipos de categoria:
• Análise
• Atributo
• Elemento
• Tipo de Referência
• Tabela
Criar uma nova categoria

Este procedimento usa o PI System Explorer para criar uma categoria. Como alternativa, use o
PI Builder para criar várias categorias com base em uma planilha do Excel.
Procedimento
1. Abra o PI System Explorer.
2. Clique na guia Biblioteca no painel Navegador.
3. No Navegador, em Categorias, clique com o botão direito do mouse no tipo de objeto da
categoria e selecione Nova Categoria no menu que aparece.
A caixa de diálogo Propriedades da Categoria é exibida.
4. Dê um nome para a categoria e, como alternativa, insira uma descrição.
5. Clique em OK. A categoria aparece no Visualizador.
6. Faça check in do trabalho.
Visualizar categorias
Procedimento
2. Clique na guia Biblioteca no painel Navegador.
3. No Navegador, em Categorias, clique no tipo de objeto da categoria. As categorias definidas
para esse tipo de objeto aparecem no Visualizador.

Adicionar um objeto a uma categoria

Procedimento
1. No Visualizador, clique com o botão direito do mouse nos objetos a serem classificados e
selecione Categorizar no menu de resultados.
A janela Categorizar é exibida.
Nota:
É possível selecionar vários objetos contínuos ou não contínuos.

2. Selecione as categorias as serem aplicadas aos objetos selecionados.
Nota:
Se a categoria necessária não estiver na lista, clique no botão Nova Categoria para
criá-la.
Representar ativos no PI Asset Framework

Cada objeto físico incluído no modelo é representado por um elemento PI AF. Objetos físicos
são, em geral, peças de equipamento, como bombas e tanques. Para associar dados a um
elemento, é necessário criar atributos no elemento. Os atributos só podem manter valores
simples que representem informações fixas, como o diâmetro de um tanque. Como alternativa,
um atributo pode fazer referência a um PI Point, uma fórmula, um valor de um banco de dados
relacional externo e muito mais.
É possível criar cada elemento individualmente, mas a melhor opção é basear elementos
individuais em um template de ativo que represente o tipo de equipamento. Templates de
elemento permitem:
• Configurar o template uma vez; não é necessário configurar individualmente cada elemento
baseado no template
• Atualizar a estrutura de elementos em todos os elementos que pertencem ao template
• Manter a consistência no modelo de ativo
• Ativar recursos avançados nos aplicativos cliente PI.
Nesta seção
• Usar templates para modelar ativos
• Usar elementos para representar ativos
Usar templates para modelar ativos

O PI AF permite basear objetos semelhantes em um único template. Os templates
essencialmente definem um conjunto de atributos base para todos os objetos que usem esse
template. Crie o template uma vez e vários elemento baseados no template, conforme
necessário. Se uma alteração for feita a um template, ela será automaticamente refletida em
todos os elementos que usam esse template.
Por exemplo, suponha que haja 100 bombas com os mesmos três atributos. Pode-se criar um
template para uma bomba e basear todas as outras bombas nesse template. Os atributos no
template são automaticamente criados nas bombas baseadas nesse template.

Agora, suponha que seja necessário fazer uma alteração nos objetos da bomba. Basta fazer a
alteração no template para que o PI AF automaticamente propague-a em todos os objetos da
bomba baseados nesse template. Os templates são uma ferramenta poderosa, não apenas para
criar objetos, mas para manter objetos existentes consistentes e atualizados.
Outra vantagem é que as ferramentas de visualização fornecem recursos especiais para objetos
baseados em templates. Por exemplo, suponha que uma tendência tenha sido criada para uma
bomba baseada em um template. Uma ferramenta de visualização pode indicar que é
necessário trocar ou adicionar outra bomba baseada no mesmo template. Os ativos baseados
no mesmo template são, às vezes, chamados de ativos relacionados.
Nota:
Templates podem ser criados para estruturas de eventos, transferências, modelos e PI

Notifications (caso haja uma licença do PI Notifications).
Nesta seção
• Estratégia de template
• Templates de elemento
• Definir templates para outros objetos
• Representar templates filho
Estratégia de template
Em quase todo caso, a melhor opção é basear os elementos em templates. Isso poupa tempo e
garante que definições sejam consistentes em todos os elementos baseados nesse template.
Quaisquer alterações feitas em um template de elemento são propagadas para todos os
elementos baseados nesse template. Uma única modificação de template pode alterar centenas
de elementos. Isso permite que alterações sejam feitas no modelo em um único lugar; não é
necessário atualizar todos os elementos.
Não é necessário ter um plano nem criar todos os templates de uma vez. Uma boa abordagem é
iniciar pela modelagem de um único tipo de ativo. Crie um template para o tipo de ativo. Decida
quais dados, cálculos e outras propriedades precisam ser armazenados para esse tipo de ativo.
Cada um desses itens precisam de um template de atributo.
O uso de template pode ser muito amplo ou muito específico. Um template pode definir um
tipo específico de dispositivo de medição, como um instrumento de marca, ou pode ser um
template de amplo uso especificando certa função, como um medidor de massa líquida.
Dependendo da extensão do template definido, a lista de atributos é um pouco diferente dos
subconjuntos de ativos. Nessa situação, use um template base (Templates base). A alternativa é
usar um template diferente para cada subconjunto de ativos.
Também é possível permitir que elementos incluam atributos não definidos ou mantidos pelo
template (Extensões). Isso permite adicionar atributos simples e específicos do ativo sem que
seja necessário adicioná-los em todas as instâncias do template.
Templates de elemento
Um template de elemento é basicamente um modelo de um tipo de ativo. Os templates de
elemento facilitam muito a criação de telas, notificações, cálculos e análises porque

equipamentos do mesmo tipo podem compartilhar a implementação. Em geral, um template de

elemento que representa um tipo de equipamento, como um tanque ou uma bomba, é criado.
Elementos podem ser facilmente criados com base no template, pois a maior parte da
configuração do elemento é definida no template.
Quando um template de elemento é alterado, essas alterações são propagadas a todos os
elementos originados nele.
Excluir um template de elemento excluir os templates de análise e notificações de destino.
Observe que:
• Um elemento originado de um template obtém sua definição de categorias, atributos e

portas pelo template.
• Se o template permitir extensões, o elemento derivado poderá conter categorias, portas e
atributos extras que não estão definidos no template.
• Os templates de elemento podem especificar as referências pai e filho permitidas (Tipos de
referência pai e filho) para um elemento criado com base em um template. Essas restrições
são relações permitidas entre os elementos na hierarquia.
Nesta seção
• Criar um template de elemento
Criar e configurar um template de elemento.
• Configurar geração automática de pontos
Configure uma referência de dados do PI Point para criar automaticamente PI Points.
• Encontrar onde a referência de um template é feita
Visualize as referências do template.
Criar um template de elemento
Procedimento
1. No Navegador, clique com o botão direito do mouse na coleção dos templates de elemento e
selecione Novo Padrão.
2. Ajuste as configurações nas guias e configure o template de elemento. O PI System Explorer
fornece os padrões de todas as configurações necessárias, mas o próprio usuário pode fazer
as configurações. Elas incluem:
◦ Padrão Base
É possível basear o template em um template existente. Selecione o template existente
(base) na caixa.
◦ Tipo
Elemento, limite, nó e assim por diante.
◦ Categorias
Organize objetos agrupando-os em categorias (opcional). Para navegar as categorias
disponíveis, clique em Categorias.
◦ Atributo Padrão
Clique em para selecionar um atributo padrão (opcional). Consulte Atributo padrão
◦ Padrão de nomenclatura

Opcional: Clique em para selecionar os parâmetros de substituição para definir um

padrão de nomenclatura de forma que cada elemento originado neste template tenha um
nome exclusivo identificável.
(Alguns parâmetros de substituição talvez não sejam aplicados quando um elemento
derivado for criado. Para assegurar um nome de elemento derivado reflita corretamente
o padrão de nomenclatura, clique com o botão direito do mouse no elemento e selecione
Reavaliar Padrão de Nomenclatura.)
◦ Permitir Extensões
Marque a caixa para permitir que alterações sejam feitas nos elementos baseados neste
template, como os atributos de adição. Consulte Extensões.
Nota:
Propriedades estendidas são propriedades definidas por outros aplicativos nos
objetos PI AF. Por exemplo, o PI WebParts armazena ícones e URLs nas
propriedades estendidas de um elemento PI AF. Os aplicativos geralmente usam as
informações armazenadas nas Propriedades estendidas de forma programática
com o PI AF SDK. Em geral, os usuários do PI System Explorer não precisam usar
esse recurso avançado.
3. Use a guia Padrões de Atributo para criar um template de atributo para cada propriedade
ou item de dados do template. Consulte Associação de dados com ativos.
4. Use a guia Portas para especificar as portas, que definem os pontos de término das conexões
entre os elementos em um modelo. Consulte Modelar um processo.
Nesta seção
• Atributo padrão
• Templates base
• Extensões
Atributo padrão
O atributo padrão é um atributo que aplicativos clientes podem usar para representar o
elemento quando nenhum outro atributo é especificado. O atributo deve estar no nível
superior da hierarquia de atributos do elemento. Ele não pode ser colocado em outro atributo.
Escolha o atributo mais representativo do elemento. Por exemplo, se um usuário tivesse feito
referência de um tanque, talvez o nível seria o melhor atributo individual a ser usado. Em um
medidor elétrico, volts de corrente.
Nota:
Alguns aplicativos clientes usam o mesmo atributo padrão, mas muitos não o usam
Templates base
Se houver vários elementos muito similares, mas com poucos atributos extras, então será
necessário considerar o uso de um template base. Um template base inclui com eficiência todos
os atributos e portas do template de elemento base em um template de elemento recém-criado.
Quando um elemento é criado de um template de elemento que inclua um template base, o
elemento conterá todos os atributos e portas de ambos os templates de elemento.
Por exemplo, se houver um conjunto de tanques, alguns com duas válvulas e outros com uma
válvula, será possível criar um template de elemento para os modelos com uma válvula e usá-lo

como template base para os modelos com duas válvulas. Ao criar objetos com base no modelo
com duas válvulas, eles terão todos os atributos do modelo com uma válvula, assim como
quaisquer atributos extras definidos pelo modelo de duas válvulas.
Extensões
Pode-se permitir que alguns atributos sejam definidos no próprio elemento,
independentemente do template. Para fazer isso, configure o template para permitir extensões.
Os atributos que podem ser criados como extensões não são alterados quando o template é
mudado. Se o template for alterado para que extensões não sejam mais permitidas, as
extensões existentes de atributo permanecerão, mas nenhuma outra poderá ser adicionada.
As extensões permitem flexibilidade em casos em que ativos sejam semelhantes em muitas
áreas, mas que haja um grande número de pequenas variações. Por exemplo, suponha que um
template seja criado para um modelo específico de carro. Todos os carros desse modelo terão o
mesmo conjunto principal de utilitários: quatro pneus, uma direção e assim por diante. No
entanto, um carro pode ter um aquecedor, enquanto outro não. Um pode ter ar condicionado, e
outro não. As extensões podem lidar com esse tipo de variação.
Permitir que haja extensões possibilita que todos os elementos sejam baseados em um
template, enquanto adiciona mais informações a cada elemento. Se houver vários elementos
muito semelhantes à definição do template, mas todos precisarem dos mesmos atributos
extras, um template base poderá ser a melhor abordagem que permitir extensões.
Nota:
Se houver um template que permita extensões, e ele for alterado para cancelar a
permissão das extensões, nenhum outro atributo de elemento estendido poderá ser
adicionado aos elementos baseados nesse template. No entanto, todos os atributos de
elemento estendidos serão mantidos.
Configurar geração automática de pontos

Em um template de atributo, é possível configurar uma referência de dados do PI Point para
criar automaticamente PI Points.
Procedimento
1. Crie um template de elemento no PI System Explorer.
2. Adicione um novo template de atributo ao template de elemento.
3. No menu suspenso Referência de Dados, selecione PI Point.
4. Clique em Configurações. A caixa de diálogo Referência de Dados do PI Point é exibida.
5. No campo de texto Nome de tag, configure os nomes do PI Point dos pontos gerados. Use os
parâmetros de substituição para que o PI AF crie automaticamente nomes de pontos para os
pontos gerados por ele.
6. Clique na caixa de seleção Criação de Tag.
7. Clique em .
A janela Configurações de Criação de Tag é exibida. Essa janela lista os valores padrão de
cada atributo do PI Point. Edite os valores de atributo, se necessário. É possível editar os
atributos do PI Point padrão ou clicar no botão Importar para importar valores de atributo
do PI Point para um ponto existente. Isso inicia a janela Pesquisa por Tag. Parâmetros de
substituição (como %Element%) pode ser usados em muitos valores de atributo.
8. Verifique o trabalho.

9. Crie um novo elemento com base no template de elemento e clique na guia Atributos.
10. Clique com o botão direito do mouse no atributo da referência de dados do PI Point e
selecione Criar ou Atualizar Referência de Dados no menu pop-up que aparece.
11. Verifique o trabalho. Esse procedimento cria todos os pontos aos quais os novos elementos
fazem referências. Isso funciona apenas porque os elementos foram baseados em um
template, e o template de atributo para a referência de dados usa a opção Criação de Tag.
Nota:
Após a criação dos PI Points, talvez leve algum tempo para que os valores sejam
gravados no PI pela interface especificada. Até lá, os valores aparecem como Ponto
Criado.
Encontrar onde a referência de um template é feita

Selecione o template e clique na guia Geral. Use os links na parte inferior da guia:
• Clique em Padrões Derivados para relacionar todos os templates de elemento contendo este
template de elemento e seu template base. A lista também contém os templates de elemento
indiretamente derivados pelo template, por vários templates.
• Clique em Elementos para relacionar todos os elementos, modelos, transferências e
estruturas de eventos criados diretamente deste template de elemento.
• Clique em Elementos Derivados para relacionar todos os elementos, modelos,
transferências e estruturas de eventos criados deste template de elemento ou de qualquer
template derivado deste template de elemento.
• Clique em Padrões Pais Referenciados para relacionar todos os templates de elemento
especificamente vinculados a este template de elemento com um pai por meio de um tipo de
referência. A lisa inclui templates que foram indiretamente vinculados por meio de herança
de template.
• Clique em Padrões Filhos Referenciados para relacionar todos os templates de elemento
especificamente vinculados a este template de elemento com um filho por meio de um tipo
de referência. A lisa inclui templates que foram indiretamente vinculados por meio de
herança de template.
Definir templates para outros objetos

Além dos templates de elemento, é possível definir os templates para estruturas de eventos,
modelos e transferências. Esses templates têm todos os atributos e propriedades necessários
para a função do objeto. Então, é possível criar instâncias para o objeto baseando-os no
template configurado.
1. Clique em Biblioteca no painel Navegador.

2. Na árvore Navegador, abra Templates para exibir os quatro objetos da coleção: Templates
de elemento, Templates de estrutura de eventos, Templates de modelo e Templates de
transferência.
3. Clique com o botão direito do mouse na coleção e selecione Novo Template.
4. O novo template exibe estas guias:
◦ Geral
◦ Templates de atributo

◦ Portas (não disponível para os templates da estrutura de eventos)

◦ Templates de análise (apenas templates de elemento)
Preencha estas guias da mesma forma que faria com os templates de elemento. Consulte
Criar um template de elemento.
Representar templates filho

Em alguns casos, deseja-se criar um template com um ou mais templates filho. Por exemplo,
suponha que haja um template representando um motor e que deseje-se um template separado
para o eixo. O template do eixo será o filho do template do motor. Não é possível criar
diretamente um template filho da mesma forma que um elemento filho é criado. Em vez disso,
é necessário criar um novo template referenciado abaixo do template do Motor.
Isso também cria um novo Tipo de Referência na coleção Tipos de Referência.
Agora, suponha que um elemento baseado no template do Motor seja criado. O PI System
Explorer não cria automaticamente o elemento filho, Eixo. No entanto, ao criar um elemento
filho manualmente no elemento do motor, o tipo de referência Motor-Eixo aparece na lista de
tipos de referência, e o template Eixo aparece na lista Template de Elemento.
Criar uma referência de template filho
Procedimento
1. No PI System Explorer, clique no botão Biblioteca no painel Navegador.
2. Clique com o botão direito do mouse no template ao qual deseja-se adicionar a referência do
template filho e selecione Novo Template de Referência. A caixa de diálogo Configurar
Nome do Template de Elemento de Referência é exibida.
3. Digite o nome do template filho e clique em OK. Isso cria um template filho na coleção
Templates e um novo tipo de referência na coleção Tipos de Referência.
Usar elementos para representar ativos

No modelo de ativo, os elementos representam objetos físicos, como bombas ou tanques. Cada
elemento tem atributos associados que armazenam propriedades e dados para esse elemento.
Normalmente, cada elemento está baseado em um template. Por exemplo, cada elemento de
bomba seria baseado em um template da bomba.
Nesta seção
• Criar um elemento baseado em um template
• Criar um elemento que não está baseado em um template

• Excluir elementos
• Redefinir um elemento para as propriedades do elemento
• Alterar templates de elemento ou adicionar um template
Criar um elemento baseado em um template
Procedimento
1. No Navegador, clique com o botão direito do mouse na coleção de elementos ou em um
elemento individual e selecione Novo Elemento.
A janela Escolher Padrão de Elemento é exibida.
2. No campo inferior da janela Escolher Padrão de Elemento, clique no template de elemento.
3. No campo superior da janela Escolher Padrão de Elemento, clique em um tipo de referência
na lista de tipos disponíveis. Os tipos de referência disponíveis dependem do template de
elemento e dos tipos de referência definidos no banco de dados. Caso o tipo de referência
desejado não esteja definido, provavelmente o tipo de referência padrão, pai-filho, será o
desejado.
4. Clique em OK.
As guias propriedade de elemento são exibidas no Visualizador. Uma vez que o elemento é
baseado em um template, a maioria dos campos na guia Geral são somente para leitura
(com sombreamento cinza ou hash-padrão). Clique no botão Atributos para ver os atributos
definidos pelo template. Não é possível adicionar novos atributos, exceto se o template
permitir extensões.
5. Digite um nome para o elemento.
Encontrar onde um elemento é usado

Em um elemento selecionado no painel Navegador, os links na parte inferior da guia Geral
exibem informações sobre onde e como o elemento é usado no modelo de ativo:
• Pais exibe todos os elementos pais deste elemento.

• Modelos exibe todos os modelos nos quais o elemento é usado.
• Camadas exibe as camadas às quais o elemento é associado.
• Conexões exibe os elementos com os quais o elemento é conectado.
• Filhos exibem todos os elementos filho de um elemento.
• Estrutura de Eventos exibe as estruturas de eventos com as quais o elemento é conectado.
Nota:
Dependendo dos aplicativos de plug-in instalados, talvez outros links sejam exibidos,
como um para Notificações.
Criar um elemento que não está baseado em um template

A melhor opção é basear os elementos em templates. Muitos aplicativos clientes do PI
fornecem ferramentas avançadas para elementos baseados em templates.

Procedimento
1. No Navegador, clique com o botão direito do mouse na coleção de elementos ou em um
elemento individual e selecione Novo Elemento.
2. No campo inferior da janela Escolher Padrão de Elemento, clique para selecionar Nenhum.
3. No campo superior da caixa de diálogo Escolhe Padrão de Elemento, selecione um tipo de
referência. Os tipos de referência disponíveis dependem do template de elemento e dos
tipos de referência definidos no banco de dados. Caso o tipo de referência desejado não
esteja definido, provavelmente o tipo de referência padrão, pai-filho, será o desejado.
4. Clique em OK.
As guias propriedade de elemento são exibidas no Visualizador.
◦ Use a guia Geral para realizar a configuração básica do elemento.

◦ Use a guia Atributo para criar um atributo para cada propriedade ou item de dados do
template.
◦ Use a guia Portas apenas se um processo estiver sendo modelado.
◦ A guia Elementos Filhos é usada principalmente para visualizar os elementos filhos
existentes em um elemento existente. Como opção, é possível criar novos elementos
filhos diretamente dessa guia.
Nota:
objetos PI AF. Por exemplo, o PI WebParts armazena ícones e URLs nas propriedades
estendidas de um elemento PI AF. Os aplicativos geralmente usam as informações
armazenadas nas Propriedades estendidas de forma programática com o PI AF SDK.
Em geral, os usuários do PI System Explorer não precisam usar esse recurso avançado.
5. Verifique o trabalho.
Excluir elementos
Nos PI AF 2.4 e posteriores, quando um elemento é excluído, o PI AF exclui automaticamente
notificações e análises que visam esse elemento. Para redefinir o objetivo de uma notificação
anexada a um elemento que se planeja remover, redefina-o antes de remover o elemento.
Como alternativa, altere o comportamento padrão para que o PI AF não exclua
automaticamente notificações e análises ao excluir o elemento de destino. Para fazer essa
alteração, use o utilitário de linha de comando afdiag com o parâmetro /
EnablePropagationOfTargetDeletion:
afdiag /EnablePropagationOfTargetDeletion-
No entanto, desativar a configuração pode causar problemas, como:
• Notificações deixadas abertas (permanecem ativas)

• Novas notificações criadas
• E-mails esperados não enviados
Redefinir um elemento para as propriedades do elemento

Clique com o botão direito do mouse no atributo do elemento, selecione Redefinir para
Template e clique na opção Criar ou Atualizar PI Point para redefinir o elemento para as

propriedades do template. Isso é útil quando elementos e templates são criados em um

ambiente de teste, e a transferência do trabalho para um ambiente de produção é desejável.
Por exemplo, suponha que o atributo PI AF foi configurado para usar o nome do PI Server como
parte da configuração do atributo no ambiente de teste. Será desejável que isso reflita o novo
nome do PI Server quando o trabalho for transferido par ao ambiente de produção.
Alterar templates de elemento ou adicionar um template

Para alterar o elemento no qual uma estrutura de eventos está baseada ou adicionar um
template a uma estrutura de eventos que não está baseada em um template:
Procedimento
1. No PI System Explorer, clique no botão Elementos no painel Navegador.
2. No Navegador, clique com o botão direito do mouse no elemento a ser alterado e selecione
Converter > Alterar Template. A janela Alterar Template de Elemento é exibida.
3. Escolha um template da lista e clique em OK.
Segurança do objeto PI AF
A segurança no PI AF está fortemente ligada à segurança do Windows. Os objetos e suas
respectivas permissões são baseadas na identidade de usuário do Windows. É possível
configurar permissões para objetos individuais e coleções.
Nota:
Se os usuários tiverem privilégios administrativos no PI AF Server, eles receberão todos
os direitos de segurança para todos os objetos do PI AF Server, inclusive todos os bancos
de dados. Isso ocorre independentemente de o usuário receber ou não direitos
específicos a objetos individuais.
Nesta seção
• Configurar permissões para objetos
• Configurar permissões para coleções
Configurar permissões para objetos

Alguns objetos PI AF têm um conjunto de informações de controle de acesso associado a eles.
Essas informações são um descritor de segurança que controla o tipo de acesso permitido a um
conjunto de grupos e usuários do Windows. O descritor de segurança é criado
automaticamente ao criar o objeto AF. Nos elementos filho, a segurança padrão é a segurança
no elemento pai. Nos outros tipos de objeto, a segurança da coleção é usada como segurança
padrão.
Nota:
Os objetos de biblioteca são categorias, templates, conjuntos de enumerações, tipos de
referência e UDMs. Os objetos de biblioteca sempre têm permissão de leitura,
independentemente de suas configurações de segurança.
Os seguintes objetos AF de nível superior podem ser protegidos:
PISystem AFElementTemplate
AFContact AFEnumerationSet
AFCategory AFReferenceType

AFDatabase AFTable
AFAnalysis AFNotification
AFAnalyisTemplate AFNotificationContactTemplate
AFElement UOMDatabase
Nesta seção
• Como alterar as permissões de acesso nos objetos AF
• Segurança de elemento
• Segurança da estrutura de eventos e de transferência
• Segurança UDM
• Segurança do objeto do banco de dados
• Configurações de permissão de acesso a objeto AF
• Quando usar a opção Negar
Como alterar as permissões de acesso nos objetos AF

Configure permissões para objetos no Navegador, no Visualizador e nas folhas de propriedade,
onde elas aparecerem.
Procedimento
1. Clique com o botão direito do mouse no objeto e selecione Segurança no menu. A caixa de
diálogo de propriedades da permissão para os objetos selecionados é exibida.
2. Selecione os usuários e configure as permissões conforme necessário. As permissões são
definidas em Configurações de permissão de acesso a objeto AF.
Grupos e usuários usados para definir a segurança são baseados na segurança do Windows.
A melhor opção é atribuir permissões a grupos, não a usuários. Não é eficiente manter
diretamente as contas de usuários.
Segurança de elemento
Ao alterar as permissões de acesso a um elemento, essas permissões de quaisquer elementos
pai ou filho também são alteradas. O comportamento depende do tipo de referência.
Tipo de referência Descrição
Fraco As permissões de acesso nunca são herdadas.
Composição As permissões de acesso para os filhos e os pais são sempre as mesmas.
Se as permissões de acesso ao filho forem alteradas, as permissões de acesso pai serão
automaticamente alteradas para corresponderem com as permissões filho. Da mesma
forma, se as permissões de acesso ao pai forem alteradas, as permissões de acesso filho
serão automaticamente alteradas para corresponderem com as permissões pai. Essas
alterações ocorrem em cascada em toda a hierarquia.

Tipo de referência Descrição

Pai-filho Elementos filho não herdam as permissões de acesso do elemento pai. Você pode copiar as
permissões de acesso do pai para todos os objetos filho no caminho principal. Este
processo deve ser repetido cada vez que as permissões de acesso do pai mudarem e você
quiser que os elementos filho no caminho principal tenham as novas permissões de
acesso.
Elementos filho no caminho principal são facilmente notados: eles têm referências fortes
ao seu elemento pai e são de propriedade do elemento pai. Eles têm o ícone do elemento
padrão na hierarquia.
Elementos filho que têm uma forte referência para o elemento pai, mas são de
propriedade de um elemento diferente, não estão no caminho principal. Estes elementos
filhos têm uma seta de referência no ícone do elemento padrão, tornando-se óbvio que
eles não estão no caminho principal.
Copiar as permissões de acesso de um objeto pai para objetos filho

Siga estes passos para copiar as permissões de acesso dos pais para os seus objetos filho no
caminho principal.
Nota:
Para determinar o pai principal, selecione o filho e, em seguida, clique no link Pais no PI
System Explorer. O pai primário tem uma marca de verificação no seu ícone.
Procedimento
1. No navegador, clique com o botão direito do mouse no objeto para o qual você deseja alterar
a herança de permissão e escolha Segurança a partir do menu.
2. Na janela Permissões para <Object>, clique em Avançado.
3. Na janela Configurações de segurança avançadas para <Object>, faça as alterações de
permissão de acesso desejadas.
a. Selecione o Principal que você deseja alterar.
b. Clique Editar.
c. Na janela Entrada de permissão para <Object>, selecione as permissões desejadas e clique
em OK.
4. Na parte inferior da janela Configurações de segurança avançadas para <Object>, clique na
caixa de verificação Substitua todas as entradas de permissão do objeto filho pelas
entradas de permissões herdadas deste objeto.
Nota:
Se você estiver usando um sistema operacional antigo, esta opção estará redigida de
forma ligeiramente diferente, mas tem o mesmo efeito.
5. Clique em OK.
6. Na janela Segurança do Windows, clique em Sim.
7. Clique OK para fechar a janela Permissões para <Object>.
Resultados
Permissões de acesso do objeto-pai são copiadas para todos os objetos filho no caminho
principal, apenas esta vez. Você precisa repetir este processo quando as permissões de acesso
do pai mudarem e você quiser copiar mais uma vez as permissões para todos os objetos filho
no caminho principal.

Segurança da estrutura de eventos e de transferência

Estrutura de evento
No momento da criação, as permissões de acesso atribuídas a uma estrutura de evento que não
têm uma referência forte para o pai são calculadas a partir do template de estrutura de evento
a partir do qual ela foi criada. Se as permissões de acesso não são criados a partir de um
modelo, elas são baseadas no item de segurança de estrutura de evento associado ao banco de
dados PI AF atual.
Quando você adiciona uma estrutura de evento filho a uma estrutura de evento existente, as
permissões de acesso da estrutura de evento filho são atribuídas com base na estrutura de
evento pai no momento em que a estrutura de evento filho foi adicionada. Você pode copiar as
permissões de acesso do pai para todos as estruturas de evento filho no caminho principal.
Este processo deve ser repetido cada vez que as permissões de acesso do pai mudarem e você
quiser que as estruturas de evento filho no caminho principal tenham as novas permissões de
acesso.
Estruturas de evento filho no caminho principal são facilmente notadas, pois elas têm fortes
referências à sua estrutura de evento pai e são de propriedade da estrutura de evento pai. Eles
têm o ícone de estrutura de evento padrão na hierarquia. Estruturas de evento filho que têm
uma forte referência à estrutura de evento pai, mas são de propriedade de uma estrutura de
evento diferente, não estão no caminho principal. Estas estruturas de evento filho têm uma
seta de referência no ícone da estrutura de evento padrão, tornando-se óbvio que elas não
estão no caminho principal.
Transferência
Quando você cria uma nova transferência, suas permissões de acesso são atribuídas com base
no modelo de transferência atribuído à nova transferência, se ela foi criada com base em um
modelo. Para transferências que não são criadas com base em um modelo de transferência são
atribuídas permissões de acesso com base no item de segurança de transferência associado ao
banco de dados PI AF atual.
Modificação de permissão de acesso

Você pode modificar a permissão de acesso da estrutura de evento da seguinte forma:
• No AF SDK, use o parâmetro applyToChildren no AFSecurity.SetAccessControl
Method em um objeto estrutura de evento.
• No Navegador PI System Explorer, clique com o botão direito do mouse na estrutura de
evento para o qual você deseja alterar a herança de permissão e siga o mesmo
procedimento descrito na Copiar as permissões de acesso de um objeto pai para objetos
filho.
Segurança UDM
Não é possível configurar permissões para UDMs individuais ou classes UDMs. No entanto, é
possível definir permissões para todo o banco de dados da UDM. Clique com o botão direito do
mouse em uma área vazia, conforme mostrado na figura a seguir, e selecione Segurança.

Nota:
As UDMs sempre podem ser lidas (sempre têm permissão de Leitura),

independentemente de suas configurações de segurança.
Segurança do objeto do banco de dados

A permissão de gravação em um banco de dados AF é automaticamente imposta em nos
objetos no banco de dados. Isso permite que um mecanismo mais simples desative a permissão
de gravação sem precisar recalcular os descritores de segurança de todos os objetos no banco
de dados.
Configurações de permissão de acesso a objeto AF

Permissão Definição
Read A capacidade de ler ou ver o objeto. Sem essa
permissão, não é possível obter o objeto.
Write A capacidade de criar e modificar um objeto. A
exceção é que estruturas de eventos e
transferências requerem permissão WriteData no
template de elemento com base no qual elas são
criadas, e casos requerem permissão WriteData na
análise na qual eles estão contidos. Além disso, se
usuários não tiverem a permissão Write no banco
de dados AF, eles não poderão modificar objetos
no banco de dados, independentemente da
permissão específica do objeto.
Delete A capacidade de excluir um objeto.
Admin A capacidade de modificar as configurações de
segurança ou o proprietário de um objeto.

Permissão Definição
ReadData A capacidade de ler valores de não configuração
dos atributos dos elementos. Além disso, essa
permissão controla se um usuário pode ver as
transferências criadas com base em um template
de elemento de transferência específico. Da mesma
forma, ela controla se um usuário pode ver os
casos criados em uma análise específica.
WriteData A capacidade de gravar valores de não
configuração nos atributos de um elemento. Além
disso, essa permissão controla se um usuário pode
criar ou modificar as estruturas de eventos ou as
transferências criadas com base em um template
de elemento de transferência específico. Da mesma
forma, ela controla se um usuário pode criar ou
modificar os casos criados em uma análise
específica.
Execute A capacidade de executar casos de análises.
Subscribe A capacidade de assinar e cancelar notificações
para o próprio usuário.
Subscribe Others A capacidade de assinar e cancelar notificações
para outros usuários.
Quando usar a opção Negar

Selecione a opção Negar nestes casos:
• Para excluir um subconjunto do grupo que permitiu as permissões.

• Para excluir uma permissão especial quando controle total já tiver sido concedido ao
usuário ou ao grupo.
Nota:
O PI Module Database não oferece suporte à opção Negar. Se o PI MDB e o PI AF

estiverem sendo usados, evite usar a opção Negar para impedir problemas de
sincronização.
Configurar permissões para coleções

É possível atribuir permissões de acesso padrão a cada tipo de coleção em um banco de dados
PI AF. Por exemplo, é possível atribuir permissões de acesso padrão a todas as tabelas no
banco de dados. A segurança está baseada nas identidades do Windows. As permissões de
acesso definidas em uma coleção:
• Controlam se um usuário tem permissão para criar novos objetos na coleção

• São usadas como permissões de acesso padrão para objetos recém-criados na coleção
Procedimento
1. Abra o PI System Explorer, clique no botão Biblioteca no painel Navegador.
2. Clique com o botão direito do mouse no ícone do banco de dados PI AF (o objeto raiz no
Navegador) e selecione Segurança e o tipo de coleção desejado. A janela Permissões é
exibida.
3. Configure as permissões apropriadas para a coleção.

4. Para configurar as permissões dos membros existentes de uma coleção,clique em Avançado.

A janela Configurações de Segurança Avançada é exibida.
5. Marque a caixa de seleção Substituir entradas da permissão.
6. Selecione a entrada a permissão e clique em Editar.
7. Especifique as permissões, descritas em Configurar permissões para objetos.
Associação de dados com ativos

Para associar dados a um ativo, é necessário criar atributos no elemento que representa esse
ativo.
Os atributos só podem manter valores simples que representem informações fixas, como o
diâmetro de um tanque. Eles também podem manter valores dos PI Points, originar em
fórmulas ou manter dados fora do PI System usando tabelas PI AF.
Em vez de criar atributos em cada elemento, seria mais comum iniciar criando templates de
atributo em um template de elemento. Então, ao criar elementos baseados nesse template, o PI
AF automaticamente cria o atributo. Ainda é necessário atribuir um valor a cada atributo.
Observe que, se um atributo for necessário para manter apenas valores predefinidos, será
possível usar um conjunto de enumeração. Um conjunto de enumeração mapeia um conjunto
pedido de valores constantes definidos pelo usuário em um conjunto de strings. Strings podem
ser usadas para fornecer um texto breve e descritivo a ser usado no modelo AF.
Nesta seção
• Criar um template de atributo
• Trabalhar com conjuntos de enumerações
• Definir os valores constantes do atributo
• Configurar referências de dados
Criar um template de atributo

Procedimento
1. Selecione o template de elemento do Navegador e clique na guia Padrões de Atributo no
Visualizador.
2. Clique com o botão direito do mouse no campo de template de atributo e selecione Novo
Padrão de Atributo no menu resultante.
3. Digite um nome para o template.
4. Defina os campos de configuração, conforme necessário. Os campos incluem itens de
configuração, itens indexados, categorias e UDM. Para obter mais informações, consulte
Atributos de configuração, Atributos indexados, Categorias e Unidade de Medida (UDM).
Nota:
Pode-se alterar a UDM exibida no atributo no PI System Explorer; no entanto, a UDM
definida no template não é alterada.
5. Configure o tipo de valor mantido pelo atributo.
◦ Para os atributos com valores constantes, defina o atributo Tipo de Valor.
Valores constantes de atributos podem ser números, strings, arquivos, datas e horas,
boolianos, URLs, matrizes e mais.

Nota:
Apesar de permitido, o tipo de valor Qualquer não é recomendado.
◦ Em fórmulas, valores de ponto PI, matrizes de pontos PI e dados de tabela (inclusive
dados de bancos de dados relacionais), clique em Configurações para configurar uma
referência de dados.
Consulte Configurar referências de dados para obter informações sobre como configurar
diferentes tipos de referência de dados.
6. (Opcional) Insira um valor padrão par ao atributo no campo Valor Padrão.
O que Fazer Depois

Ao criar um atributo com base no template, é necessário criar o valor:
• Para obter valores constantes, adicione o valor diretamente ao atributo. Consulte Definir os
valores constantes do atributo.
• Para as referências de dados, crie a instância da referência. Para tanto, clique com o botão
direito do mouse no elemento no Navegador e selecione Criar ou Atualizar Referência de
Dados. Para obter mais informações, consulte Criar ou atualizar referências de dados.
Nota:
O modo como um atributo é configurado pode às vezes restringir o modo de exibição dos
dados nos aplicativos cliente, como o PI ProcessBook ou o PI Coresight. Consulte
Restrições na visualização dos dados da série de tempo para obter mais informações.
Adicionar um atributo a um elemento

Em algumas situações, talvez deseje-se adicionar outro atributo a um elemento existente.
Se o elemento estiver baseado em um template que permite extensões, será possível definir
outros atributos no próprio elemento, independentemente do template. Se o elemento estiver
baseado em um template que não permite extensões, não será possível adicionar um novo
atributo.
Procedimento
1. Selecione um Elemento no Navegador e clique na guia Atributos no Visualizador.
2. Clique com o botão direito do mouse no campo de atributos e selecione Novo Atributo no
menu resultante.
3. Configure o tipo de valor mantido pelo atributo:
◦ Para os atributos com valores constantes, defina o atributo Tipo de Valor. Essa
configuração determina os dados que podem ser inseridos no campo Valor.
Valores constantes de atributos podem ser números, strings, arquivos, datas e horas,
boolianos, URLs, matrizes e mais.
Nota:
Apesar de permitido, o tipo de valor Qualquer não é recomendado.
Como alternativa, insira um valor padrão no atributo no campo Valor Padrão.
◦ Em fórmulas, valores do PI Point, matrizes do PI Point e dados de tabela (inclusive dados
de bancos de dados relacionais), clique em Configurações para configurar uma referência
de dados.
Consulte Configurar referências de dados para obter informações sobre como configurar
diferentes tipos de referência de dados.

4. Defina outros campos de configuração, conforme necessário. Os campos incluem itens de

configuração, itens indexados, categorias e UDMs. Para obter mais informações, consulte
Atributos de configuração, Atributos indexados, Categorias e Unidade de Medida (UDM).
Trabalhar com conjuntos de enumerações

Normalmente um conjunto de enumeração é usado para definir uma lista de valores pré-
definidos de um template de atributo. Ao configurar atributos baseados nesse template,
selecione o valor na lista.
Por exemplo, suponha que haja um template de atributo que mantenha o número de modelo
para uma peça de equipamento. Pode-se criar um conjunto de enumeração contendo todos os
números de modelo relevantes. Ao criar um elemento baseado no template, selecione o
número de modelo apropriado na lista.
Criar um conjunto de enumerações
Procedimento
1. No Navegador, clique com o botão direito do mouse na coleção dos conjuntos de
enumeração e selecione Novo Conjunto de Enumeração. A guia de configuração de
propriedade Geral do conjunto de enumerações aparece no Visualizador.
2. Configure as seguintes propriedades:
◦ Na caixa Nome, insira o nome do conjunto.
◦ Na caixa Descrição, insira uma descrição para o conjunto (opcional).
◦ Marque a caixa de seleção Hexadecimal para os valores hexadecimais.
3. Insira valores e nomes, além de uma descrição opcional, em cada membro do conjunto de
enumerações.
O nome é uma string exclusiva que descreve a condição ou o estado representado. O nome é
o meio preferido de acessar uma enumeração. O valor é um valor numérico exclusivo que
também é associado à enumeração. O valor é usado para fornecer uma representação mais
rápida e menos intensa de memória de um valor da enumeração.

Renumerar um conjunto de enumerações
Procedimento
1. Clique com o botão direito do mouse em qualquer lugar do campo e selecione Renumerar
Valores de Enumeração. A caixa de diálogo Renumerar Valores de Enumeração é exibida.
2. Insira o valor inicial e um incremento.
Nota:
Se uma linha for selecionada antes da renumeração, esta iniciará na linha selecionada,
a linha receberá o valor inicial, e cada linha subsequente receberá o próximo valor do
incremento. Apenas a linha selecionada e as próximas linhas podem ser alteradas
durante uma ação de renumeração. Se a renumeração não iniciar na primeira linha,
então, haverá a possibilidade de que os valores gerados sejam idênticos aos valores
acima da linha selecionada. Nesse caso, esta mensagem de erro será exibida:
Attempting to change the enumeration values would overlap previous
enumeration values prior to the selected row.
Definir os valores constantes do atributo

Valores constantes são diretamente atribuídos ao atributo.
Não é possível definir um valor do atributo no template de atributo, mas é possível definir um
valor padrão. Para obter informações sobre como definir um valor padrão, consulte Criar um
template de atributo.
Procedimento
1. No Visualizador, use a caixa suspensa Tipo de Valor para seleiconar o tipo de dados do
atributo. Há quatro grupos de tipos de valores:
◦ Tipos básicos
◦ Tipos de matriz
Uma matriz contendo qualquer um dos tipos básicos como elementos.
◦ Conjuntos de enumerações
Um conjunto de enumernações é uma lista de valores constantes definidos pelo usuário.
Normalmente um conjunto de enumerações é usado para definir uma lista de valores
pré-definidos de um template de atributo. Ao configurar atributos baseados nesse
template, selecione o valor na lista. A opção de menu Conjuntos de enumerações permite

que escolher qualquer um dos conjuntos de enumerações já criados no banco de dados

AF.
◦ Objetos
Um objeto pode ser outro atributo ou elemento AF ou um arquivo de sistema
operacional.
2. Clique no campo Valor.
O formato do campo Valor é alterado de acordo com o Tipo de Valor.
3. Configure o valor do atributo, conforme descrito no procedimento apropriado par ao tipo de
atributo.
Nesta seção
• Configurar um valor básico
• Configurar um valor Matriz
• Configurar um valor Conjunto de Enumeração
• Configurar um valor Objeto
Configurar um valor básico

Depois de configurar o Tipo de valor para um dos tipos de dados Básico, defina o valor do
atributo.
Procedimento
1. Clique no campo Valor. O formato do campo é alterado de acordo com o tipo de valor:
Tipo de valor Formato do campo Valor
Booliano Uma alternância entre Verdadeiro e Falso
Byte Um campo de entrada do número inteiro positivo
Data/hora O seletor de Data/hora
Duplo Um campo de entrada numérico do ponto de
flutuação
Guid Uma máscara do GUID
Intnn Um campo de entrada do número inteiro
Único Um campo de entrada numérico do ponto de
flutuação
String Um campo de entrada do texto
2. Insira os valores do atributo no campo Valor. O PI System Explorer resolve os dados

inseridos e, no check in das alterações, envia o valor resultante para o PI AF. Por exemplo,
em Data/Hora, ele envia a data e a hora resultantes.
Exemplos
Se o tipo de valor for Data/Hora, será possível inserir a hora em qualquer formato de string
com suporte do AF (inclusive formatos do horário PI) ou do objeto Data/Hora do .NET. Alguns
exemplos de entradas válidas:
*-5d May 12, 2009 07 06 2010 10:00:00 AM 09 14 2008 14:00:00
Para criar um atributo com um link como valor, selecione o tipo de valor String e insira o URL
como o valor do atributo. As strings reconhecidas com caminhos de URL absolutos serão
exibidas como links. Por exemplo, strings que iniciam com http://, ftp:// file:// e www.
são reconhecidas como links, enquanto que strings que iniciam com C:\ e abc.com não são. No

PI System Explorer, os links aparecem sublinhados e têm uma dica de ferramenta associada a
eles.
Configurar um valor Matriz

Depois de configurar o Tipo de valor para um dos tipos de Matriz, defina o valor do atributo.
Procedimento
1. Clique no campo Valor. Um botão é exibido na extremidade direita do campo Valor.
2. Clique em . Na caixa de diálogo Matriz, defina a matriz. O campo Valor é configurado para
o formato apropriado do tipo de dados selecionado nos elementos da matriz.
Booliano Uma alternância entre Verdadeiro e Falso
Byte Um campo de entrada do número inteiro positivo
Data/hora O seletor de Data/hora
Duplo Um campo de entrada numérico do ponto de
flutuação
Guid Uma máscara do GUID
Intnn Um campo de entrada do número inteiro
Único Um campo de entrada numérico do ponto de
flutuação
String Um campo de entrada do texto
3. Clique em OK. O PI System Explorer resolve os dados inseridos e, no check in das alterações,
envia os valores de matriz resultantes para o PI AF.
Configurar um valor Conjunto de Enumeração

Quando um conjunto de enumeração é escolhido para o Tipo de valor, selecione o valor do
atributo entre os elementos do conjunto.
Procedimento
1. Clique no campo Valor. O campo Valor se torna um menu suspenso que possibilita escolher
valores desse conjunto de enumeração.
2. Selecione o valor desejado. Depois da confirmação das alterações, o PI System Explorer
envia o valor resultante ao PI AF.
Configurar um valor Objeto

Depois de configurar o Tipo de valor para um dos tipos de Objeto, defina o valor do atributo.
Procedimento
1. Clique no campo Valor. O botão de ação à direita do campo é alterado de acordo com o tipo
de valor:
<Qualquer> Apesar de permitido, o tipo de valor Qualquer
não é recomendado.

Atributo Um botão Navegador que abre a caixa Pesquisa

por Atributo
Elemento Um botão Navegador que abre a caixa Pesquisa
por Elemento
Arquivo Uma seta de upload
2. Selecione o objeto desejado e escolha OK. Depois da confirmação das alterações, o PI System
Explorer envia o valor resultante ao PI AF.
Fazer upload dos arquivos com cautela

Se o Arquivo Tipo de valor for especificado, antes de fazer o upload de um arquivo, execute o
antivírus e verifique se o tamanho do arquivo não é maior que o espaço de armazenamento.
Alguns tipos de arquivos podem representar um risco de segurança, e uma mensagem de aviso
será exibida perguntando se o usuário deseja continuar. A lista de tipos de arquivos
considerados inseguros pelo PI System Explorer pode mudar. Como boa prática, veja a lista de
tipos de arquivos da Microsoft bloqueados pelo Outlook.
Configurar referências de dados

É possível configurar um atributo ou um template de atributo para obter um valor em uma
fonte específica. Essa configuração é chamada de referência de dados, e os atributos que as
incluem são chamados de atributos das referências de dados. É possível criar uma referência
de dados para as seguintes fontes:
• PI Point
É possível configurar a referência de dados para usar o valor do PI Point, o valor do resumo
ou outras operações no valor do ponto.
• Matriz do PI Point
Use uma referência de dados da matriz do PI Point para criar um único valor de uma matriz
dos PI Points.
• Fórmula
O valor do atributo é o resultado de um cálculo definido pelo usuário. O cálculo pode incluir
atributos, inclusive atributos das referências de dados.
• Pesquisa de tabela
A tabela pode ser definida internamente, importada de uma tabela externa (não PI) ou
vinculada a uma tabela externa
• Criador de string
Use os parâmetros de substituição e as funções para manipular valores e enviar uma string.
Nesta seção
• Criar e referenciar cálculos
• Referenciar os dados PI Point
• Fazer referência a matrizes do PI Point
• Exemplos de uso da referência de dados do Construtor de String
• Referenciar dados das tabelas interna e externa nas tabelas PI AF
• Usar parâmetros nas referências de dados.

Criar e referenciar cálculos

Use a referência de dados da fórmula para criar um cálculo personalizado. Esse cálculo pode
ser uma fórmula ou uma sequência de cálculos. A referência de dados da fórmula pode ter
vários atributos de entrada.
Nesta seção
• Configurar referência de dados de uma fórmula
• Definir parâmetros
• Definir a equação
• Unidades de medida nas referências de dados da fórmula
Configurar referência de dados de uma fórmula
Procedimento
1. Selecione o atributo no Visualizador.
2. No menu suspenso Referência de Dados, selecione Fórmula.
3. Clique no botão Configurações. A janela Referência de Dados da Fórmula é exibida.
4. Se a equação precisar de um valor de atributo, clique em para adicioná-lo como um
parâmetro (Definir parâmetros).

5. Marque a caixa de seleção Valores padrão permitidos para permitir que o PI AF use os
valores padrão de atributo no cálculo. Os valores padrão são especificados no template de
atributo. Se a caixa de seleção for desmarcada, o cálculo falhará quando os dados de um ou
mais atributos não estiverem disponíveis.
6. Clique em para começar a definir a equação (Definir a equação).
7. Na caixa Unidade de Medida, especifique a unidade de medida produzida pelo resultado da

sequência de cálculo ou fórmula (Unidades de medida nas referências de dados da fórmula).
8. Na caixa Mínimo, insira um valor apropriado para o valor mínimo retornado. Se o valor
calculado for inferior ao mínimo, a referência de dados retornará o valor mínimo
especificado. Se não houver um valor mínimo para esse cálculo, deixe a caixa Mínimo em
branco.
9. Na caixa Máximo, insira um valor apropriado para o valor máximo retornado. Se o valor
calculado for superior ao máximo, a referência de dados retornará o valor máximo
especificado. Se não houver um valor máximo para esse cálculo, deixe a caixa Máximo em
branco.
Nota:
Marque a caixa de seleção Nível para obter o valor a ser nivelado durante a análise.
10. Clique em Avaliar para testar a referência de dados. O valor retornado pela sequência de
cálculo aparece em uma caixa adjacente. Quando a Referência de Dados da Fórmula for
configurada no atributo do template, o cálculo usará os valores padrão para os atributos do
template. Quando a configuração for feita em um atributo do elemento, os dados reais serão
usados no cálculo.
11. Clique em OK.
12. Configure o resto das configurações do atributo como faria com qualquer outro atributo.

Nota:
A referência de dados Fórmula não dá suporte a strings ou outros tipos de valores não
numéricos.
Definir parâmetros
Se a equação precisar de um valor de atributo, será necessário adicionar esse atributo como
um parâmetro na caixa de diálogo Configuração de fórmula.
Procedimento
1. Clique em ao lado do campo Parâmetros. A janela Configuração de parâmetros é
exibida.
Nota:
Também é possível clicar em uma linha vazia e inserir uma variável (a-z).
2. Selecione uma variável no menu Variável. O número de variáveis disponíveis está limitado a
26 caracteres (de A a Z).
3. Selecione o atributo representado pela variável.
◦ Escolha o atributo no menu Atributo. Todos os atributos semelhantes com tipos de
valores compatíveis são relacionados.
◦ Se o atributo desejado não estiver no menu, selecione Outro. Um novo campo chamado
Atributo é exibido na janela. Clique em para escolher o atributo na árvore ou insira o
caminho do atributo desejado. Veja a seguir alguns caminhos de atributo.
4. Selecione a unidade de medida desejada para o atributo. Essa NÃO é a UDM do atributo.
Especifique a UDM exigida pela fórmula nessa entrada (Unidades de medida nas referências
de dados da fórmula).
Por exemplo, se o atributo de entrada tiver uma UDM de Celsius, mas a equação exigir
Fahrenheit, selecione Fahrenheit no campo.
Definir a equação
Para definir a equação em uma referência de dados de uma fórmula:
Procedimento
1. Clique em ao lado do campo Equações. Também é possível clicar na área de texto e
digitar uma equação.

O botão é exibido.
2. Digite a equação ou clique em para escolher variáveis, operadores e funções em um

menu. Operadores e funções válidos estão listados em Operadores de referências de dados
da fórmula e em Funções de referências de dados da fórmula.
◦ Clique em para remover a equação selecionada da sequência de cálculos.
◦ Clique em para remover todas as equações da sequência de cálculos.
◦ Clique em ou em para mover uma equação para cima ou para baixo na
sequência de cálculos.

Nesta seção
• Operadores de referências de dados da fórmula
• Funções de referências de dados da fórmula
Operadores de referências de dados da fórmula

Os operadores válidos na ordem de precedência são os seguintes:
Parenthesis Unary Minus ^ * / mod + - < > <= >= == <> NOT AND OR
Não é possível usar o operador de atribuição = no início de uma fórmula.

Nota:
A sintaxe de referência de dados da fórmula usa == (dois sinais de igual) para indicar a
igualdade, e = (um sinal de igual), para atribuição. A sintaxe de análise (e o performance
equation) usa = para indicar igualdade, e =, para atribuição.
Pode-se selecionar If-Then-Else, um operador composto com operandos usados da seguinte
forma:
If expr0 Then expr1 Else expr2
em que expr0, expr1 e expr2 são expressões. Se expr0 for verdadeiro, o valor de expr1 será
retornado, caso contrário, o valor de expr2 será retornado.
Funções de referências de dados da fórmula

Função Descrição
abs(X) Valor absoluto de X.
acos(X) Cosseno do arco de X.
asin(X) Seno do arco de X.
atan(X) Tangente do arco de X.
BadVal(x) Retorna 1 se o valor tem um status com erro, tem
um valor de ponto de flutuação igual NaN (Not a
Number) ou valor não numérico; caso contrário,
retorna 0.
ceiling(X) O menor inteiro superior ou igual a X.
cos(X) Cosseno de X.
cosh(X) Cosseno hiperbólico de X.
cot(X) Cotangente de X.
coth(X) Cotangente hiperbólica de X.
csc(X) Cossecante de X.
csch(X) Cossecante hiperbólica de X.
e() Valor da base do logaritmo natural.
exp(X) Base do logaritmo natural elevado à potência X.
floor(X) Maior inteiro inferior ou igual a X.
ln(X) Logaritmo natural de X.
log(X) Logaritmo de X usando a base 10.
logbase(X,Y) Logaritmo de X usando a base Y.
max(X,Y) Maior que X e Y.
min(X,Y) Menor que X e Y.

normalrnd(X,Y) Número aleatório que mapeia a curva de
distribuição normal. X é o desvio principal, e Y, o
padrão.
pi() Valor do Pi.
poisson(X) Número aleatório que mapeia a distribuição
Poisson. X é o principal.
pow(X,Y) X elevado à potência Y.
rand() Número aleatório uniforme. As válvulas podem
estar entre os valores 0 e menor que 1.0
rand(X,Y) Número aleatório uniforme. Os valores podem
estar entre X-Y/2 e menor que X+Y/2.
remainder(X,Y) Retorna o resultado remanescente da divisão de X
por Y.
round(X) X arredondado para o número inteiro mais
próximo.
roundfrac(X,Y) X arredondado para o número de dígitos fracionais
especificado por Y. Y é um número inteiro.
sec(X) Secante de X.
sech(X) Secante hiperbólica de X.
sign(X) Retorna 1 se X é maior que ou igual a zero, e -1 se X
é menor que zero.
sin(X) Seno de X.
sinh(X) Seno hiperbólico de X.
sqrt(X) Raiz quadrada de X.
tan(X) Tangente de X.
tanh(X) Tangente hiperbólica de X.
Unidades de medida nas referências de dados da fórmula

Ao trabalhar com fórmulas e unidades de medida, é necessário configurar as entradas e saídas
da equação com a UDM correta:
• Nos atributos na equação, use a UDM esperada pela fórmula (NÃO as unidades de atributos
já inseridas).
• No resultado de cálculo, use a UDM na qual deseja-se que o resultado apareça. Isso deve ser
consistente com as UDMs das entradas (valores de atributos).
Por exemplo, considere a seguinte configuração de fórmula para converter o volume e a
densidade em massa:
V=Volume;UOM=L;D=Density;UOM=kg/L;[V*D];UOM=kg
As unidades de medida das entradas e saídas são consistentes: (L*kg/L = kg). Essa fórmula
funciona em quaisquer atributos de entrada e saída, independentemente da unidade de medida
do atributo, contanto que eles tenham uma unidade de medida da classe correta especificada.
Referenciar os dados PI Point

Uma data reference PI Point é uma referência de um atributo AF a um PI Point. O valor do
atributo da referência de dados pode ser o mesmo do valor do ponto ou pode ser o resultado

de um cálculo baseado nos valores do ponto. Pode-se criar uma referência de dados PI Point
para:
• um atributo de elemento ou template de atributo

• um atributo de transferência ou template de atributo
• um atributo de estrutura de eventos ou template de atributo
As referências do PI Point para os templates de atributo têm alguns valores extras. Ao criar
uma referência de dados PI Point em um template de atributo, pode-se:
• Criar automaticamente tags referenciadas por atributos baseados nesse template.

• Criar um esquema de nomeação para atributos baseados nesse template para que os
atributos criados com base nele tenham nomes exclusivos com uma estrutura consistente.
Nesta seção
• Configurar as etapas básicas da referência de dados do PI Point
• Especificar o PI Point
• Configuração do valor do atributo
• Considerações da unidade de medida
• Permitir que um atributo grave em um valor do ponto
• Criar ou atualizar referências de dados
• Indicador de atributos para executar a opção Criar ou Atualizar Referência de Dados ou
Ponto PI
Configurar as etapas básicas da referência de dados do PI Point

Este procedimento usa o PI System Explorer para configurar uma referência de dados PI Point
em um atributo.
Nota:
É possível usar os resultados de Pesquisa por Tag na Palete para criar e configurar
rapidamente os atributos da nova referência de dados PI Point. Para obter mais
informações, consulte Arraste da Palete para criar referências de dados PI Point.
Procedimento
1. Selecione o atributo no Visualizador.
2. No menu suspenso Referência de Dados, selecione PI Point.
3. Clique no botão Configurações. A janela de configuração Referência de dados do PI Point é
exibida.
4. Configure a referência de dados:
a. Selecione o ponto no qual fazer referência, de forma direta ou referenciando outro
atributo. Consulte Especificar o PI Point
b. Especifique como o atributo obtém seu valor. Por exemplo, o valor do atributo pode ser o
mesmo do valor do ponto ou pode ser um resultado de um cálculo no valor do ponto.
Consulte Configuração do valor do atributo.
c. Especifique as unidades que o PI Point referenciado usa (opcional). Consulte
Considerações da unidade de medida.
d. Use a caixa de seleção Somente Leitura para especificar se o PI AF gravará o valor do
atributo novamente no ponto de origem. Por padrão, o PI AF não grava dados no PI Point

referenciado (a caixa de seleção Somente Leitura está marcada). Consulte Permitir que
um atributo grave em um valor do ponto
A caixa de seleção Somente leitura está localizada no canto inferior esquerdo.
Arraste da Palete para criar referências de dados PI Point

Pode-se arrastar uma tag dos resultados da Pesquisa por tag na Palete para criar uma
referência de dados PI Point. Quando um novo atributo for criado, arraste-o para o campo
Configurações para configurar o atributo como referência de dados PI Point baseada na tag.
Como alternativa, arraste-o para a lista Atributos no Visualizador para criar um novo atributo
configurado como uma referência de dados PI baseada na tag.
Procedimento
1. Selecione Elementos no painel Navegador.
2. Selecione um elemento no Navegador e selecione sua guia Atributos no Visualizador.
3. Selecione Visualizador > Palete > Pesquisa por tag e procure as tags a serem usadas.
4. Execute uma destas etapas
◦ Arraste uma tag dos resultados da pesquisa na lista Atributos. Um novo atributo
configurado como referência de dados PI Point baseada na tag é adicionado à lista.
◦ Clique em Novo Atributo na barra de ferramentas e arraste uma tag dos resultados da
pesquisa para o campo Configurações para configurar o atributo como uma referência de
dados PI Point baseada na tag.
5. Clique em Fazer Check-In para salvar a nova referência de dados.
Especificar o PI Point
Para referenciar o PI Point, há duas opções:
• Referência Direta
Especifica um PI Server e um nome do ponto.
• Referência Indireta

Faz referência a outro atributo de referência de dados do PI Point.
Nesta seção
• Criar uma referência para o PI Server e o nome do ponto
• Referências de atributos (referências indiretas)
• Criar uma referência por meio de um atributo
Criar uma referência para o PI Server e o nome do ponto

O método mais comum de configurar uma referência de dados de ponto PI é especificar o nome
do ponto PI e o PI Server.
Procedimento
1. Na tela Referência de Dados do Ponto PI, selecione a opção Nome de tag.
2. Escolha o PI Server no menu suspenso PI Server.
Nota:
Se o PI Server desejado não aparecer no menu, clique em para abrir o PI

Connection Manager. Use o gerenciador Conexões para adicionar o PI Server. Para
obter instruções, clique no botão Ajuda na parte superior da caixa de diálogo.
3. Insira o nome do ponto no campo Nome de tag ou clique em para pesquisar um ponto no
PI Server selecionado.
Direcionar referências para SINUSOID em MyPIServer
Usar parâmetros de substituição
Nos templates de atributo, é possível usar os parâmetros de substituição nos campos PI

Server e Nome de tag. Consulte Lista de parâmetros de substituição do PI AF.
Referências de atributos (referências indiretas)

É possível configurar referências de dados do PI Point para apontar para outro atributo. O
atributo de referência deve ser uma referência de dados do PI Point. Isso se chama referência

indireta para qualquer PI Point nas referências do atributo de destino. Faz sentido fazer
referência por atributo quando são necessários vários atributos que usem dados do mesmo PI
Point.
Por exemplo, suponha que haja um atributo chamado Nível que faça referência a um PI Point
registrando o nível de um tanque. Será necessário que três atributos filhos mantenham os
níveis diários médio, máximo e mínimo do tanque. Se os três atributos filhos forem
configurados para fazer referência ao atributo Nível, será possível alterar o atributo Nível para
fazer referência a um ponto diferente e não será necessário reconfigurar os atributos filhos.
Criar uma referência por meio de um atributo
Procedimento
1. Na janela Referência de Dados do PI Point, selecione a opção Atributo.
2. Insira um caminho relativo para o atributo ou selecione um caminho no menu suspenso.
O menu lista os atributos que têm referências de dados do PI Point.
Para inserir um caminho, use a sintaxe descrita em Referência indireta.

Nota:
Não é possível referenciar um atributo que não faça referência a um PI Point.
Configuração do valor do atributo

Os aplicativos clientes solicitam valores de atributo para uma hora especifica ou um intervalo
de tempo. Por exemplo, no PI ProcessBook, a tela pode fornecer um contexto de intervalo de
tempo (um símbolo de intervalo, como uma tendência, deve estar presente na tela para
permitir a recepção de um intervalo de tempo). Normalmente, a referência de dados é
configurada para esperar uma hora ou um intervalo de tempo. O valor do atributo será:
• O valor de um ponto em uma hora específica. Consulte Configurar a recuperação de valor

por tempo.
• O resultado de um cálculo nos valores do ponto em um intervalo de tempo. Consulte
Configurar a recuperação de valor por intervalo de tempo. Por exemplo, o valor do atributo
pode ser a média dos valores do ponto em uma hora.
Nesta seção
• Configurar a recuperação de valor por tempo
• Configurar a recuperação de valor por intervalo de tempo
Configurar a recuperação de valor por tempo

A solicitação de um aplicativo cliente de um valor do atributo inclui um tempo. Especifique
como interpretar esse tempo para recuperar os valores para o atributo.
Procedimento
1. Selecione uma opção no menu suspenso Por hora.
◦ Após
Retorna o primeiro valor gravado depois da solicitação do tempo pelo aplicativo cliente.
◦ Em ou Antes
Selecione para retornar um valor gravado no tempo solicitado pelo aplicativo cliente. Se
não houver nenhum valor no tempo especificado, o valor anterior gravado será
retornado.
◦ Em ou Após
não houver nenhum valor no tempo especificado, o próximo valor gravado será
retornado.
◦ Automático
Selecione para que um ponto contínuo (atributo de etapa = 0) seja tratado como
Interpolado; um ponto discreto (atributo de etapa = 1), como "Em ou Antes".
◦ Antes
Selecione para retornar o primeiro valor gravado antes da solicitação do tempo pelo
aplicativo cliente.
◦ Tempo exato
não houver nenhum valor gravado no momento, um erro será retornado.
◦ Interpolado

Selecione para retornar um valor interpolado no tempo solicitado pelo aplicativo cliente.
Os pontos discretos (atributo de etapa = 1) transportam o valor anterior.
Nota:
Não selecione as opções Não Suportado, Intervalo de tempo e Sobreposição do
Intervalo de tempo. Essas opções destinam-se aos valores do atributo baseados nos
cálculos do intervalo de tempo.
2. Deixe a caixa Tempo Relativo vazio, exceto para Configurar um atraso de tempo.
3. No menu suspenso Por Intervalo de Tempo, selecione Tempo Final.
Se o aplicativo cliente enviar um intervalo de tempo em vez de um tempo específico, o PI AF
retornará uma mensagem de erro como o valor do atributo.
4. Clique em OK.
Configurar um atraso de tempo

Se o atributo for configurado para retornar o valor em um momento específico, será possível
configurar um atraso de tempo da hora selecionada. Isso pode ser útil ao criar atributos
atrasados de tempo morto.
Procedimento
1. Faça as configurações de Recuperação de Valores para Configurar a recuperação de valor
por tempo.
2. Na caixa Tempo Relativo, digite o tempo relativo do atraso. Use a expressão de tempo
relativo PI. Consulte Tempo relativo.
Nota:
É possível usar os parâmetros de substituição neste momento para ler o tempo

relativo do valor de outro atributo. Consulte Referenciar um valor do atributo.
3. Clique em OK.
Configurar a recuperação de valor por intervalo de tempo

Para que o valor do atributo seja o resultado de um cálculo de resumo em um intervalo de
tempo, configure a recuperação do valor por intervalo de tempo.
Procedimento
1. Selecione uma destas opções no menus suspenso Por hora.
◦ Não Suportado
Se o aplicativo cliente enviar um tempo em vez de um intervalo de tempo, o PI AF
retornará uma mensagem de erro como o valor do atributo.
◦ Intervalo de Tempo
Criará o intervalo de tempo padrão a ser usado se o aplicativo cliente enviar um templo
em vez de um intervalo de tempo. Se esta opção for selecionada, digite a expressão de
tempo relativo do PI na caixa Tempo Relativo. Consulte Criar um intervalo de tempo
padrão para obter detalhes.
◦ Sobreposição do Intervalo de tempo
Especifique um intervalo de tempo que sempre substitua o intervalo de tempo
especificado pelo aplicativo cliente. É possível especificar uma duração fixa do intervalo

(Criar um intervalo de duração configurável) ou calcular a duração dinamicamente

(Configurar cálculo dinâmico de intervalo de tempo).
2. Selecione uma destas opções no menu suspenso Por Intervalo de Tempo.
◦ Média
O valor médio no intervalo de tempo.
◦ Contagem
Se Base de cálculo for selecionado para Ponderado pelo Evento, a Contagem será a
contagem do evento no intervalo de tempo. Se Base de cálculo estiver configurado para
qualquer uma das opções ponderadas pelo tempo, a opção Contagem será a soma da
duração do evento no intervalo de tempo.
◦ Delta
A diferença no valor do final até o início do intervalo de tempo.
◦ Máximo
O valor máximo no intervalo de tempo.
◦ Mínimo
O valor mínimo no intervalo de tempo.
◦ Desvio padrão da população
Selecione o desvio padrão da população no intervalo de tempo.
◦ Desvio padrão
Selecione o desvio padrão no intervalo de tempo.
◦
Hora de Início
Retorna o valor na Hora de Início no intervalo de tempo.
Nota:
Se a opção Hora de Início for selecionada, não será possível selecionar Não
Suportado no menu Por hora. Se isso for feito, a seguinte mensagem de erro será
exibida: The TimeMethod must be supported to support the
TimeRangeMethod of "Start Time".
◦ Tempo Final
Retorna o valor no tempo final do intervalo de tempo.
◦ Total
O valor total no intervalo de tempo.
3. Se o menu suspenso Base de cálculo for ativado, selecione uma das seguintes opções:
◦
Evento ponderado
Selecione para avaliar os valores com a mesma ponderação em cada evento. Nenhuma
interpolação é realizada. Pelo menos um evento deve estar no intervalo de tempo para
que o cálculo seja bem-sucedido. Dois eventos são necessários ao desvio padrão.
◦
Tempo ponderado
Selecione para ponderar os valores no cálculo pelo tempo no qual eles são aplicados. A
interpolação é baseada no atributo de etapa do ponto. Eventos interpolados são gerados
nos limites, se necessário.

Nota:
Se a opção Tempo ponderado for selecionada para obter o total, as unidades de

origem são convertidas em uma taxa. Selecione uma unidade de tempo no menu
suspenso que aparece ao lado do campo Unidades de origem.
◦
Tempo Ponderado Contínuo
Selecione para aplicar a ponderação como no Tempo ponderado, mas faça todas as
interpolações entre valores, como se eles representassem dados contínuos (interpolação
padrão), independentemente do atributo de etapa do ponto.
Nota:
Se a opção Tempo Ponderado Contínuo for selecionada para obter o total, as

unidades de origem serão convertidas em uma taxa. Selecione uma unidade de
tempo no menu suspenso que aparece ao lado do campo Unidades de origem.
◦
Tempo Ponderado Discreto
Selecione para aplicar a ponderação como no Tempo ponderado, mas faça a interpolação
entre valores, como ele eles representassem valores discretos não relacionados (análise
em escada), independentemente do atributo de etapa do ponto.
Nota:
Se a opção Tempo ponderado discreto for selecionada para obter o total, as

unidades de origem serão convertidas em uma taxa. Selecione uma unidade de
tempo no menu suspenso que aparece ao lado do campo Unidades de origem.
4. No campo Porcentagem mínima boa, insira um valor entre 0 e 100. Essa é a porcentagem
representando o valor mínimo de tempo que um valor deve ser bom antes de um valor de
resumo seja retornado.
5. Clique em OK.
Nesta seção
• Intervalos de tempos para estruturas de eventos e transferências
• Criar um intervalo de duração configurável
• Configurar cálculo dinâmico de intervalo de tempo
• Criar um intervalo de tempo padrão
Intervalos de tempos para estruturas de eventos e transferências

De acordo com sua natureza, as estruturas de eventos e transferências têm um intervalo de
tempo associado a elas. Quando um aplicativo de chamada solicita um valor de um atributo, o
valor retornado depende da referência de dados e de sua configuração.
• Quando ele não fornece contexto de tempo, o PI AF calcula o valor do atributo usando o
intervalo de tempo da estrutura de eventos ou transferência. Por exemplo, se um atributo
contiver um PI Point configurado com uma opção de resumo do intervalo de tempo, o
resumo será feito durante o intervalo de tempo da estrutura de eventos ou transferência.

Se um atributo contiver um PI Point configurado com apenas a opção de tempo padrão, o PI

AF retornará o valor do ponto no tempo final da estrutura de eventos.
• Quando o aplicativo de chamada fornece um único timestamp, o PI AF retorna o valor no
tempo especificado, mesmo que o tempo esteja fora do intervalo de tempo da estrutura de
eventos ou transferência.
• Se fornecer um intervalo de tempo, o PI AF usará a interseção do intervalo de tempo
fornecido e o intervalo de tempo da estrutura de eventos. Se não houver intersecção, um
evento "Nenhum Dado" será retornado.
A área escurecida na seguinte imagem mostra a intersecção entre um intervalo de tempo da
estrutura de eventos e um intervalo de tempo solicitado. Para atributos contendo um PI
Point configurado com uma opção de resumo do intervalo de tempo, o resumo será feito
nessa intersecção. Se o atributo contiver um PI Point configurado com apenas a opção de
tempo padrão, o valor será retornado na hora de início da intersecção.
Criar um intervalo de duração configurável

Para garantir que o intervalo de tempo tenha sempre o mesmo comprimento, é possível
configurar uma substituição de intervalo de tempo:
Por exemplo, para criar uma média de rolagem de uma hora, use estas configurações:
• No menu suspenso Por Tempo, selecione Substituição de Intervalo de Tempo.

• Na caixa Tempo Relativo, digite: -1h
Procedimento
1. No menu suspenso Por Tempo, selecione Sobreposição do Intervalo de Tempo.
2. Na caixa Tempo Relativo, digite uma expressão de tempo relativo do PI (Tempo relativo).
O AF criará um intervalo de tempo com base na hora de término fornecida pelo aplicativo
cliente e no deslocamento definido pelo tempo relativo.
Nota:
É possível usar os parâmetros de substituição neste momento para ler o tempo

relativo pelo valor de outro atributo (Referenciar um valor do atributo). Se isso for
feito, o PI AF avaliará o valor do atributo de referência no momento de cada solicitação
de dados.

Por exemplo, para criar uma média de rolagem de uma hora, use estas configurações:
• No menu suspenso Por Tempo, selecione Substituição de Intervalo de Tempo.

• Na caixa Tempo Relativo, digite: -1h
• Na lista Por Intervalo de Tempo, selecione Média.
Essa configuração permite que a referência de dados sempre calcule uma média de 1 hora,
mesmo quando o aplicativo cliente especifica outro intervalo de tempo.
Configurar cálculo dinâmico de intervalo de tempo

É possível usar o atributo do AF para calcular o intervalo de tempo baseado em vários fatores.
Os valores de atributo devem ser tempos relativos válidos do PI (Tempo relativo). Então, é
possível usar o valor de atributo para determinar dinamicamente o intervalo de tempo.
Procedimento
1. Configure um atributo para gerar tempos relativos do PI. O atributo pode fazer referência a
um conjunto de enumerações contendo tempos relativos do PI ou construir os tempos
relativos do PI com base em cálculo.
2. Configure a referência de dados do PI Point usando a seguinte recuperação de valor :
a. No menu suspenso Por Tempo, selecione Sobreposição do Intervalo de Tempo.
b. Na caixa Tempo Relativo, digite: %@AttributeName% em que AttributeName é o nome
do atributo que gera valores de tempo relativo do PI.
c. Na lista Por Intervalo de Tempo, selecione um método de cálculo. .
Resultados
Essa configuração permite que a referência de dados use o tempo relativo calculado com um
deslocamento de tempo que determina o intervalo de tempo.
Consulte Hora de término da variável de exemplo para ver detalhadamente um exemplo.
Nesta seção
• Hora de término da variável de exemplo
• Tempo relativo
Hora de término da variável de exemplo

Este exemplo cria uma referência de dados com uma hora de término da variável.
Procedimento
1. Crie um conjunto de enumerações, MyEnumSet, contendo estes três valores:
-30m -1h -2h

Nota:
Os valores devem ser expressões de tempo relativo do PI (Tempo relativo).

2. Crie um atributo chamado TimeRangeAttribute, que faz referência a MyEnumSet. Para fazer
isso, na lista Tipo de Valor, selecione Conjuntos de Enumeração > MyEnumSet.
3. Crie outro atributo, chamado DataReferenceAttribute. Crie uma referência de dados para o
atributo conforme a seguir:
a. No PI Point, selecione qualquer ponto que tenha um valor numérico. Nesse exemplo, o
ponto sinusoid será usado em um PI Server chamado PISRV1.
b. No menu suspenso Por Tempo, selecione Sobreposição do Intervalo de Tempo.
c. Na caixa Tempo Relativo, digite:
%@TimeRangeAttribute%
d. No menu suspenso Por Intervalo de Tempo, selecione Médio.

Referência de dados completa do PI Point
Resultados
É possível usar o atributo TimeRangeAttribute como um menu suspenso para selecionar o
intervalo de tempo para o cálculo.
Tempo relativo
Expressões de tempo relativo são números de um número de dias (d), horas (h), minutos (m)
ou segundos (s) especificado por um sinal de mais (+) ou de menos (-) à esquerda. O ponto de
início padrão do tempo relativo é a hora atual. Portanto, um tempo igual a -8h ocorre oito horas
antes da hora atual. Tempos fracionados têm suporte. Por exemplo, use -1.5d para um dia e
meio. Todos esses são tempos relativos válidos:
+1d -24h -3.25m +24s
Expressões de tempo relativo podem conter apenas um operador, + ou -. Por exemplo, esta
expressão não tem suporte:

-1d+1h
Criar um intervalo de tempo padrão

É possível criar um intervalo de tempo padrão para os atributos do elemento. Um intervalo de
tempo padrão é um intervalo de tempo usado pelo PI AF quando o aplicativo cliente fornece
um tempo específico, em vez de um intervalo de tempo. A estrutura de eventos e os atributos
de transferência funcionam de formas diferentes. Consulte Intervalos de tempos para
estruturas de eventos e transferências para obter mais informações.
Para criar um intervalo de tempo padrão, use as seguintes configurações de Recuperação de
Valor:
• No menu suspenso Por Tempo, selecione Intervalo de Tempo.

• Na caixa Tempo Relativo, digite a expressão de tempo relativo do PI (Tempo relativo). O AF
criará um intervalo de tempo com base no tempo final fornecido pelo aplicativo cliente e no
deslocamento definido pelo tempo relativo.
Nota:
É possível usar os parâmetros de substituição neste momento para ler o tempo relativo
pelo valor de outro atributo (Referenciar um valor do atributo).
Por exemplo, um metro calculado requer um intervalo de tempo para fornecer um valor
calculado. Se o aplicativo cliente enviar um tempo específico, crie um intervalo de tempo de
uma hora que termine no tempo especificado. Para fazer isso, use estas configurações:
• No menu suspenso Por Tempo, selecione Intervalo de Tempo.

• Na caixa Tempo Relativo, digite:
-1h
• No menu suspenso Por Intervalo de Tempo, selecione Intervalo de Tempo.
Considerações da unidade de medida

Ao definir uma referência de dados PI Point, como opção, é possível especificar as unidades
usadas pelo PI Point referenciado. Se possível, o PI AF automaticamente altera o tipo de
atributo para o tipo de valor compatível com as unidades especificadas.
No entanto, se o atributo for definido por um template de atributo, o PI AF não poderá alterar o
tipo. Em vez disso, o PI AF tenta converter o valor no tipo de valor do template. Se o PI AF não
puder converter o valor, ele gerará um erro.
Permitir que um atributo grave em um valor do ponto

Um atributo com uma referência de dados do PI Point pode gravar um valor em um PI Point. Na
caixa de diálogo de configuração Referência de dados do PI Point, a caixa de seleção Somente
leitura determina se o atributo pode gravar dados no PI Point referenciado. Por padrão, a caixa
está marcada (Somente leitura = Verdadeiro), o que significa que o atributo do AF não pode
alterar o valor do PI Point.
Em raras ocasiões, pode-se desejar gravar o valor do atributo novamente no valor do ponto.
Por exemplo, se o valor do atributo for o resultado de um cálculo ou uma análise, será possível
atualizar o PI Point com o resultado dessa análise. Nesse caso, a caixa de seleção Somente
leitura seria desmarcada para permitir que o atributo gravasse seu valor no ponto.

Criar ou atualizar referências de dados

Ao criar um atributo baseado em um template com uma referência de dados, o PI AF não cria
automaticamente as referências de dados do PI Point associadas a esse elemento. Para criar as
referências de dados, clique com o botão direito do mouse no elemento no Navegador e
selecione Criar ou Atualizar Referência de Dados no menu resultante. O PI AF então substitui
todos os parâmetros de substituição pelos valores correspondentes no momento. E o PI AF cria
e trava a referência de dados. Quando uma referência de dados está travada:
• Quais alterações subsequentes feitas em um template de atributo não propagam para os

elementos baseados no template.
• O PI AF não avalia os parâmetros de substituição novamente, a não ser que a referência de
dados seja atualizada.
Nota:
A única exceção é uma referência do valor de atributo no campo Tempo Relativo.

Após o travamento, pode-se clicar com o botão direito do mouse no atributo do elemento,
selecionar Redefinir para Template e na opção Criar ou Atualizar Referência de Dados para
redefinir as propriedades do template. Isso é útil quando elementos e templates são criados em
um ambiente de teste, e a transferência do trabalho para um ambiente operacional é desejável.
Indicador de atributos para executar a opção Criar ou Atualizar Referência de Dados

ou Ponto PI
O PI System Explorer emprega indicadores visuais distintos para atributos que suportam a
opção Criar ou Atualizar Dados de Referência. Um indicador visual é exibido também quando
um atributo parece não mais estar configurado corretamente, como após o nome de um
servidor ou tag ter sido alterado.
Os seguintes indicadores visuais para a opção Criar ou Atualizar Referência de Dados estão
disponíveis.
Ícone Descrição
O atributo é associado com um template que contém regras de criação de pontos.
Use a opção Criar ou Atualizar Ponto PI para criar a configuração de tag baseada no
template. Adicionalmente, o nome do ponto e o ID são resolvidos.
A configuração da referência de dados do atributo é diferente dos dados
armazenados no banco de dados AF. Isso pode ocorrer quando um ponto é
renomeado ou quando o PI Server subjacente é substituído. Use a opção Criar ou
Atualizar Ponto PI para atualizar a configuração.
O atributo é um item de configuração. Consulte Atributos de configuração para
obter mais informações.
Nota:
A opção Criar ou Atualizar Referência de Dados não é aplicável para
atributos de configuração.
Quando você revisa atributos de elementos na guia Atributos, a primeira entrada na coluna à
esquerda de um nome de atributo de referência de dados indica se você pode executar a opção
Criar ou Atualizar Referência de Dados. Você inicia a opção Criar ou Atualizar Referência de
Dados clicando um elemento ou um atributo e escolhendo Criar ou Atualizar Ponto PI.
A operação Criar ou Atualizar Referência de Dados atualiza uma referência de dados po ponto
PI com quaisquer alterações que tenham sido feitas no ponto PI (os parâmetros de substituição

são resolvidos, e os IDs de pontos e servidores, atualizados). Se o ponto PI ainda não existir, e a
configuração contém uma opção de criação de ponto, ele é criado.
Exemplo de atualização de atributo

Quando você vê o indicador exibido para um atributo, você pode atualizar sua configuração
clicando com o botão direito do mouse e escolhendo Criar ou Atualizar Ponto PI.
Nota:
O ícone não determina antecipadamente se quaisquer alterações para o tag ou sua
configuração irão ocorrer.
Attribute indicator with tooltip
Como a dica de ferramenta mostrada acima indica, quando você atualiza a configuração, as
regras de substituição de nome de ponto são resolvidas e o ID do ponto é armazenado nos
metadados do atributo. Isso resulta em uma inicialização subseqüente mais rápida.
Fazer referência a matrizes do PI Point

Use a referência de dados da matriz do PI Point para vincular atributos de elementos a
matrizes dos PI Points para ler ou gravar o valor deles. Cada nome de tag especificado
corresponde a uma entrada na matriz. Configure a referência de dados da matriz do PI Point da
mesma forma que faria na referência de dados PI Point, com exceção do campo Nomes de Tag
na caixa de diálogo de configuração da referência de dados. A referência de dados da matriz do
PI Point permite a seleção de vários PI Points. Clique em para pesquisar e selecionar vários
pontos no PI Server selecionado ou inseri-los diretamente no campo Nomes de Tag. Os nomes
dos pontos devem ser separados por um símbolo de barra (|). Por exemplo:
CDM158|CDT158|SINUSOID
Exemplos de uso da referência de dados do Construtor de String

A referência de dados do Construtor de String permite a aplicação de funções de manipulação
de strings, como concatenação, para valores de um atributo e para a saída de uma string
reformatada.
Nota:
Ao usar a referência de dados do Construtor de String em um template, a substituição do
valor ocorrerá no tempo de execução.
Para criar uma referência de dados do Construtor de String, siga estas etapas:
1. Durante a visualização da guia Atributos de um elemento, clique em Novo Atributo.
2. No campo suspenso Referência de Dados, selecione Construtor de String.
3. Clique em Configurações. A janela Referência de Dados do Construtor de String é aberta.

4. Clique na linha destacada e no botão de triângulo no final da linha. Um menu dos

parâmetros de substituição, valores do atributo e funções de string são disponibilizados.
5. Selecione uma série de itens para criar a string de saída necessária, conforme demonstrado
pelos exemplos neste tópico. Pode-se editar a string de expressão durante sua criação (para
alterar os valores de parâmetro padrão da função, por exemplo).
Quando uma expressão de string é criada, o resulta do expressão é exibido no campo Valor (na
parte inferior da janela Referência de Dados do Construtor de String).
É possível construir uma expressão em uma única linha usando pontos-e-vírgula para separar
os itens. Também é possível colocar cada termo em sua própria linha, eliminando os pontos-e-
vírgulas e tornando a estrutura da expressão mais aparente. Os primeiros dois exemplos de
valores de concatenação mostram estas técnicas.
Nota:
Diferentemente de outras funções da string, a sintaxe Format(DateTime, ... ) segue a
sintaxe C#.
Valores de concatenação
É possível usar os parâmetros de substituição para criar uma string, como um nome de
caminho. Por exemplo:
"%Database%";"\";"%Element%";"|";"%Attribute%";
Essas referências de dados podem gerar uma saída, como: DB26\WX12000|pressure.

Nota:
Normalmente, você deve colocar parâmetros de substituição entre aspas duplas para que
seu resultado seja tratado como uma sequência literal de caracteres. Caso contrário, seu
resultado será tratado como um caminho de atributo.
Um segundo exemplo mostra como criar uma string para mostrar a duração de um evento.
Depois de clicar em Configurações, a janela Referência de Dados do Construtor de String será
aberta:
1. Clique no botão de triângulo no final da linha e em Parâmetros de Substituição, selecione
%StartTime%.
2. Adicione uma nova linha clicando no botão da nova linha de fórmula .
3. Digite os caracteres: " para "

4. Adicionar uma nova linha clicando no botão da nova linha de fórmula .
5. Clique no triângulo e em Parâmetros de Substituição e selecione %EndTime%.

6. Clique em OK paras lavar a nova referência de dados.
O campo Valor mostra o intervalo de data e hora, como 10/25/2013 14:31:06 to
10/25/2013 14:31:10.
Um terceiro exemplo de concatenação obtém a data e hora atuais e anexa outros caracteres:
Format("%Time%","yyyy-MM-dd HH:mm:ss");" PM";
Essa expressão retorna o valor: 2013-10-11 11:12:38 PM.
Extração do texto e manipulação do caso

Estas funções podem ser usadas para manipular o caso de uma string e extrair certas seções.
Por exemplo, para um atributo chamado GasPressure, a seguinte expressão retorna: GASPR:
Mid(UCase("%Attribute%"), 1, 5);

Para criar esta string de expressão, depois de clicar em Configurações, a janela Referência de
Dados do Construtor de String é aberta:
1. Clique no botão de triângulo no final da linha e em Parâmetros de Substituição, selecione
%Attribute%.
2. Clique no triângulo e em Funções, selecione UCase(string)
3. Clique no triângulo e em Funções, selecione Mid(string, start, length)
Como outro exemplo, para um atributo chamado GasPressure, a seguinte expressão é
retornada: pressure:
Mid(LCase("%Attribute%"), 4, 8);
Limitação do número de casas decimais

O seguinte exemplo lê os valores no atributo chamado Attribute1, mapeado em um ponto PI
chamado cdt158, e retorna um valor de string que mostra duas casas decimais:
Format('Attribute1', "%3.2f");
Por exemplo, se cdt158 tiver o valor 66,67538, essa referência de dados retornará 66,68.
Nota:
Certifique-se que o tipo de dados especificado corresponda ao tipo de dados do atributo.
Erros seriam encontrados, por exemplo, se "%3.2f" fosse especificado para um valor do
atributo do tipo inteiro, ou "%3d", para o valor do atributo do ponto de flutuação.
Referenciar dados das tabelas interna e externa nas tabelas PI AF

Pode-se configurar um atributo para ler seu valor em uma tabela PI AF. A tabela PI AF pode ser
definida totalmente no PI AF ou vinculada a ou importada de uma fonte de dados fora do PI
System (como um tabela do Microsoft SQL ou uma planilha do Microsoft Excel).
1. Criar uma tabela PI AF.

2. Defina e preencha os dados da tabela de uma destas formas:
◦ Importe de ou vincule a uma tabela externa (não PI System). Consulte Importar ou
vincular dados do Microsoft Access ou do Excel.
◦ Defina e preencha manualmente uma tabela PI AF Consulte Definir e preencher
manualmente uma tabela PI AF.
3. Configurar uma referência de dados de pesquisa de tabela.
Nesta seção
• Criar uma tabela PI AF
• Definir e preencher manualmente uma tabela PI AF
• Referenciar dados de fora do PI System
• Configurar uma referência de dados de pesquisa de tabela
• Usar parâmetros em consulta de tabela vinculada

Criar uma tabela PI AF
Procedimento
1. No PI System Explorer navegue até a Biblioteca no banco de dados atual clicando em
Biblioteca no Navegador.
2. Clique com o botão direito do mouse na coleção Tabelas e selecione Nova Tabela.
3. Clique na guia Geral.
4. Selecione o fuso horário da tabela no menu suspenso no campo Fuso Horário.
O campo Fuso Horário indica o fuso horário dos valores Data/Hora na tabela.
5. Marque ou desmarque a caixa de seleção Converter para Local.
Quando um cliente consulta a tabela, o fuso horário no qual os valores Data/Hora são
exibidos é determinado pela marcação da caixa de seleção Converter para Local. Em geral:
◦ Para converter Data/Hora na hora local, marque a caixa de seleção Converter para Local.
◦ Para sempre exibir Data/Hora no fuso horário selecionado no campo Fuso Horário,
desmarque a caixa de seleção Converter para Local, assim, qualquer tempo na tabela PI
AF é representada no fuso horário especificado no campo Fuso Horário.
Nota:
Diversos fatores estão envolvidos no cálculo do fuso horário. Para obter informações
detalhadas sobre as configurações de conversão do fuso horário, consulte
Configurações de conversão do fuso horário.
6. No campo Intervalo do Cache, insira o tempo necessário até que os dados armazenados em
cache da tabela sejam atualizados. No menu suspenso, selecione o se o valor está em
segundos, minutos, horas ou dias. O valor padrão é zero, o que significa que o recurso de
atualização automática está desativado.
Nota:
A atualização automática é desativada se a tabela tem alterações não salvas no
servidor.
Nota:
Os campos Conexão e Consulta são somente para leitura. O PI AF preenche esses
campos quando uma tabela externa é importada ou vinculada.
8. Defina e preencha a tabela em uma destas três formas:
◦ Importe uma tabela de fora do PI AF Server.
◦ Vincule a uma tabela de fora do PI AF Server
◦ Defina e preencha manualmente a tabela no PI System Explorer.
Configurações de conversão do fuso horário

O cálculo preciso de conversão de tempo depende do seguinte:
• O valor selecionado na coluna Fuso Horário. As opções exatas que aparecem no menu Fuso
Horário dependem do sistema operacional em execução. Tempos têm um destes prefixos:
<UTC>, <GMT> ou <TZ>. O menu também inclui a opção <Nenhum>.
• Se a caixa de seleção Converter para Local for marcada ou desmarcada.
• Se esta é uma tabela interna (importada ou definida no PI AF) ou externa (vinculada).

A tabela a seguir explica como os tempos exibidos são determinados para cada combinação
possível.
Fuso Horário* Converter para Local Interno/Externo Comportamento
<Nenhum> Sim Interno Os campos Data/Hora
são ajustados
automaticamente para
as diferenças de Fuso
Horário e são horas
Locais no cliente.
<Nenhum> Não Interno Os campos Data/Hora
não são traduzidos. Útil
para armazenar os
campos Data em que a
tradução não é desejada,
por exemplo, Data de
Aniversário.
<UTC> ou <GMT> Sim Interno Os campos Data/Hora
são ajustados para a
hora local do cliente.
<UTC> ou <GMT> Não Interno Os campos Data/Hora
são sempre
representados como
UTC.
<TZ> Sim Interno Os campos Data/Hora
são ajustados para as
diferenças de Fuso
Horário e estão na hora
local do cliente. Essa
combinação não é
normalmente
necessária, exceto
durante a importação de
dados externos do PI
System Explorer.
<TZ> Não Interno Os campos Data/Hora
são mantidos no Fuso
Horário especificado. A
Referência de Dados de
Pesquisa da Tabela será
ajustada conforme
necessário, no entanto,
talvez outros aplicativos
não sejam.
<Nenhum> Sim Externo Presume-se que os
campos Data/Hora
estejam no Fuso Horário
do AF Server e sejam
ajustados para a hora
local do cliente.
<Nenhum> Não Externo Os campos Data/Hora
não são traduzidos. Útil
para os campos Data em
que a tradução não é
desejada, por exemplo,
Data de Aniversário.

Fuso Horário* Converter para Local Interno/Externo Comportamento

<UTC> ou <GMT> Sim Externo Os campos Data/Hora
são armazenados
externamente como
UTC, mas ajustados para
a hora local do cliente.
<UTC> ou <GMT> Não Externo Os campos Data/Hora
são armazenados
externamente como UTC
e mantidos como UTC
no cliente.
<TZ> Sim Externo Os campos Data/Hora
são ajustados para as
diferenças de Fuso
Horário e estão
ajustados na hora local
do cliente.
<TZ> Não Externo Os campos Data/Hora
são mantidos no Fuso
Horário especificado. A
Referência de Dados de
Pesquisa da Tabela será
ajustada conforme
necessário, no entanto,
talvez outros aplicativos
não sejam.
As opções exatas que aparecem no menu Fuso Horário dependem do sistema operacional em
execução.
Definir e preencher manualmente uma tabela PI AF
Nesta seção
• Criar manualmente uma definição de tabela
• Preencher uma tabela manualmente
Criar manualmente uma definição de tabela

Preencha os valores Definir Tabela.
Procedimento
1. No campo Nome, insira um nome para a coluna.
2. Na lista Tipo de Valor, selecione os tipos de dados das colunas da tabela.
3. Na lista Fuso Horário, selecione os fusos horários das colunas da tabela.
4. Na lista Unidade de Medida, selecione as unidades de medida das colunas da tabela.
5. Na lista Usar imagem, selecione uma imagem para representar a coluna.
Se uma célula contiver uma matriz de bytes que for selecionada, o PI System Explorer
tentará exibir a matriz como uma imagem.
Preencher uma tabela manualmente

Preencha os valores da guia Tabela.

Procedimento
1. Com base nas colunas da tabela criada na guia Definir Tabela, insira as informações
apropriadas nas linhas de cada coluna.
2. Opcional: É possível cortar e colar todas as linhas de ou para uma planilha do Excel. Depois
de copiar várias linhas da planilha, clique com o botão direito do mouse em uma nova linha
ou em um intervalo de linhas na tabela e selecione Colar.
Referenciar dados de fora do PI System

Use as tabelas PI AF para acessar dados externos ao PI System. Esses dados podem estar no
Microsoft Excel, no Access, no SQL Server ou em outras fontes de dados OLEDB/ODBC.
Também é possível importar ou vincular a tabela ao PI System Explorer.
1. Criar uma tabela PI AF.

2. Importar ou vincular tabelas externas. As etapas dependem do tipo de fonte de dados que se
deseja acessar:
◦ Importar ou vincular dados do Microsoft Access ou do Excel.
◦ Importar ou vincular dados do SQL Server.
3. Configurar uma referência de dados de pesquisa de tabela.
Nesta seção
• Tabelas importadas e vinculadas
• Criar uma conexão de tabela reutilizável
• Autenticação de tabelas vinculadas
• Importar ou vincular dados do Microsoft Access ou do Excel
• Importar ou vincular dados do SQL Server
• Configuração de segurança para tabelas vinculadas
Tabelas importadas e vinculadas

Há duas formas de acessar dados de uma tabela não PI System:
• Importando a tabela.
Após a importação inicial, não há mais relação entre a tabela externa e a tabela PI AF. As
tabelas PI AF com dados importados são chamadas de tabelas importadas. Tabelas
importadas são tabelas de leitura/gravação. Seu tamanho é limitado, mas elas são mais
seguras que as tabelas vinculadas. Às vezes, as tabelas importadas são chamadas de tabelas
internas, pois, diferentemente das tabelas vinculadas, os dados da tabela são gerenciados
pelo PI AF após a importação inicial. Os dados podem ser editados diretamente no PI AF.
Uma boa prática é limitar o número de linhas de dados das tabelas importadas em até
10.000. As tabelas importadas não são projetadas para armazenar bancos de dados muito
grandes. Se for necessário acessar muitos dados nas tabelas PI AF, use tabelas externas, que
não têm esses limites de armazenamento. Como alternativa, divida a tabela durante a
importação.
• Vinculando a uma tabela.
Os dados da tabela não são armazenados no banco de dados PI AF. Às vezes, as tabelas
vinculadas são chamadas de tabelas externas, pois os dados de origem não são mantidos no
PI AF. Não é possível editar uma tabela externa pelo PI AF. As tabelas vinculadas têm

algumas configurações de segurança adicionais, pois é necessário configurar como o PI AF

se conecta à fonte de dados externa.
Criar uma conexão de tabela reutilizável

Crie uma conexão OLEDB e reutilize-a para configurar as tabelas vinculadas da mesma fonte de
dados.
Antes de Iniciar
Use o PI System Explorer de 64 bits para configurar as conexões com as tabelas vinculadas. Ele
inclui drivers OLEDB de 64 bits, necessários para o PI AF Server de 64 bits.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Biblioteca e verifique se Conexões
de tabelas aparece no painel Navegador.
2. Selecione Conexões de tabelas e clique em Nova conexão da tabela no menu principal.
(Também é possível clicar com o botão direito do mouse em Conexões de tabelas e
selecionar Nova conexão da tabela no menu de contexto.) O visualizador exibir as
propriedades de conexão de tabela, como Nome e Descrição.
3. Opcional: Edite o nome padrão e adicione uma descrição para a conexão de tabela.
4. Em Conexão, clique em Construir para configurar a conexão usando Propriedades do Link de
Dados. (Também é possível inserir ou editar uma string de conexão diretamente na caixa de
texto Conexão.)
5. Na guia Provedor em Propriedades do Link de Dados, selecione um provedor OLEDB e siga as
instruções que aparecem na tela para configurar a conexão. Para obter informações
específicas, clique em Ajuda em qualquer guia.
6. No visualizador, selecione uma opção para Segurança. (Talvez algumas opções não estejam
disponíveis. Consulte Autenticação de tabelas vinculadas para obter mais informações.)
◦ Personificar Cliente (recomendado)
◦ Selecione Fornecer Senha e insira uma senha para a conexão da tabela.
◦ Não há contexto de segurança adicional
7. Clique em Fazer Check-In no menu principal para fazer check in e salvar a conexão da
tabela. Pode-se abrir a opção Conexões de tabela no painel Navegador para visualizar a
conexão de tabela recém-criada.
Autenticação de tabelas vinculadas

Quando um aplicativo cliente solicita dados externos, o PI AF Server consulta a fonte de dados
externa e retorna os dados para o cliente como uma tabela PI AF de somente leitura.
Para tabelas vinculadas externamente, a OSIsoft recomenda que o provedor OLE DB e o PI AF
Server tenham o mesmo tamanho de bit (32 bit ou 64 bit). Para configurar uma conexão de
tabela externa no PI System Explorer, por exemplo, é necessário usar um PI AF Server com o
mesmo tamanho de bit (normalmente, 64 bits).
Ao configurar a tabela vinculada, é solicitado a especificação das credenciais usadas pelo PI AF
Server para se conectar ao banco de dados. As opções de autenticação são:
• Personificar Cliente

Se o banco de dados de origem tem suporte na autenticação do Windows, use a identidade

do Windows do cliente que está solicitando os dados. Isso é uma personalização da conexão.
Esse é o método mais seguro de autenticação; use-o sempre que possível.
• Fornecer Senha
Se o banco de dados de origem não tiver suporte à autenticação do Windows, ou se o banco
de dados e o PI AF Server estiverem em domínios diferentes não confiáveis, especifique um
nome de usuário e senha com o acesso necessário ao banco de dados de origem. O PI AF usa
esta conta codificada para ler os dados na fonte de dados externa. Por exemplo, o banco de
dados MySQL não tem suporte à autenticação do Windows, por isso, o nome de usuário e
senha de uma conta seriam usados no banco de dados MySQL.
• Sem contexto de segurança adicional
Esta opção normalmente é aplicável quando o Excel ou outras fontes de dados baseadas em
arquivo; caso contrário, cada usuário precisará conceder acesso de leitura ao arquivo no
servidor. Com esta opção, a tabela externa será acessada usando a identidade do PI AF
Server. Nesse caso, não é necessário especificar um nome de usuário ou senha durante a
configuração da tabela vinculada; a configuração Kerberos também não é necessária. No
entanto, cuidado ao configurar o SQL Security de forma que a identidade do AF Server não
tenham mais privilégios que o necessário para recuperar os dados. Apenas os
Administradores do PI AF podem configurar tabelas externas por motivos de segurança, por
isso, o privilégio PI AF Administrator deve ser entregue a um número limitado de usuários
quando esse modo de conexão for ativado.
Nesta seção
• Restrições em conexões não personificadas
• Risco em usar conexões não personificadas
Restrições em conexões não personificadas

Porque as tabelas vinculadas que usam conexões não personificadas têm riscos de segurança,
alguns administradores do sistema do PI AF Server restringem ou impedem o uso delas. O
administrador do sistema pode:
• Solicitar privilégios administrativos no PI AF Server e gravar os privilégios na tabela PI AF.
• Impedir a criação de tabelas PI AF vinculadas com conexões não personificadas.
• Impedir a criação de qualquer tipo de tabelas vinculadas.
Se houver problemas com as tabelas vinculadas, consulte o administrador do sistema sobre as
configurações de tabelas externas do PI AF Server.
Risco em usar conexões não personificadas

Dependendo da configuração do SQL Server, um usuário com privilégios de administrador do
PI AF poderia criar ataques no SQL Server e obter o controle total do sistema se estas
condições existissem:
• Uma tabela PI AF está configurada para usar a identidade PI AF Server para vincular a um
banco de dados externo.
• Tabelas vinculadas não personificadas (externas) são ativadas no PI AF Server.
Por padrão, as tabelas vinculadas não personificadas estão desativadas no PI AF Server.
Para que um usuário execute um ataque, ele precisaria ativar as tabelas externas não
personificadas.
• A conta do PI AF Server tem direitos administrativos no SQL Server.

Por padrão, o AF Server é executado na conta NetworkService e não tem direitos

administrativos no SQL Server configurado localmente nem acesso aos bancos de dados do
computador remoto. Se direitos de administrador no banco de dados remoto, possíveis
ataques com elevação de privilégio são limitados.
CUIDADO:
Por motivos de segurança, não conceda privilégios administrativos do PI AF Server no
computador ou SQL Server quando consultas não personificadas estiverem sendo
executadas.
Importar ou vincular dados do Microsoft Access ou do Excel

Para acessar dados por meio de um banco de dados do Microsoft Access ou de uma planilha do
Microsoft Excel, vincule ou importe os dados. Os dados em uma tabela vinculada são atualizados
quando essa tabela é acessada e sempre que a última atualização exceder as configurações do
Intervalo de Cache da tabela. Os dados importados são carregados uma vez na tabela PI AF.
Para atualizar uma tabela com dados importados, clique com o botão direito do mouse em sua
entrada no nó Tabelas do painel Biblioteca e selecione Reimportar Tabela.
Procedimento
• Para vincular ou importar dados de uma tabela do Microsoft Access ou planilha do Microsoft
Excel, especifique:
◦ o banco de dados ou a planilha de origem
◦ uma consulta que retorna o banco de dados desejado
◦ quaisquer credenciais de login necessárias para acessar o banco de dados ou a planilha
As instruções exatas dependem da configuração do hardware e do que o usuário está
tentando fazer:
◦ Para servidores PI AF de 32 bits: siga as instruções em Vincular ou importar dados.
◦ Para servidores PI AF de 64 bits: para importar, consulte Vincular ou importar dados;
para vincular, consulte Vincular a dados em um PI AF Server de 64 bits.
Nesta seção
• Vincular ou importar dados
• Vincular a dados em um PI AF Server de 64 bits
Vincular ou importar dados

Estas instruções descrevem como importar dados em AF Server de 32 bits e 64 bits e como
vinculá-los aos dados de um PI AF Server de 32 bits apenas. Para vincular a dados de um
servidor de 64 bits, consulte Vincular a dados em um PI AF Server de 64 bits.
Procedimento
1. No PI System Explorer, navegue até a tabela PI AF ou crie uma conforme descrito em Criar
uma tabela PI AF.
2. No painel Biblioteca, expanda o nó Tabelas e clique na tabela PI AF desejada.
Os detalhes da tabela são exibidos no painel direito.
3. Clique em Vincular ou Importar.
A janela correspondente é aberta.
4. Apenas vincular: Se a tabela estiver sendo vinculada, ative a opção Personificar Cliente (não
exibida para Importar).

5. Clique em Construção.
A janela Propriedades do link de dados é exibida.
6. Na guia Provedor, selecione o provedor de acordo com a versão do Microsoft Office que está
sendo usada e clique em Próximo.
◦ Office 97-2003: selecione Microsoft Jet 4.0 OLE DB Provider.
◦ Office 2007 e superiores: selecione Microsoft Office 12.0 Access Database Engine OLE
DB Provider.
7. Na guia Conexão, especifique o seguinte e clique em OK.
◦ Fonte de Dados
O local e o nome do arquivo do banco de dados ou da planilha (por exemplo, C:
\AFTestData.xls). Se estiver vinculando, o caminho para o arquivo deverá ser relativo
ao AF Server.
◦ Nome de Usuário
Credenciais de login de um usuário que recebeu acesso de leitura ao banco de dados ou à
planilha.
Nota:
Para armazenar a senha com as informações de conexão, marque a caixa de seleção
Permitir Salvamento de Senha. A senha é armazenada como texto simples (não
criptografado).
8. Na guia Avançado, na lista Permissões de acesso, selecione Compartilhar Negar Nenhum.
9. Apenas Excel: Na guia Todos, selecione o valor Propriedades Estendidas e clique em Editar
Valor.
A janela Editar Valor da Propriedade é exibida.
Insira o valor da propriedade de acordo com a versão do Microsoft Excel que está sendo
usada e clique em OK.
◦ Excel 97-2003: Excel 8.0
◦ Excel 2007 e superiores: Excel 12.0
10. Para verificar se a planilha está acessível, voltar para a guia Conexão e clique em Testar
Conexão.
Se as configurações forem válidas, uma mensagem Test connection succeeded será exibida.
11. Para fechar a janela e retornar para o PI System Explorer, clique em OK.
12. Para definir os dados a serem retornados da planilha, insira um consulta SQL no campo
Consulta. Para fechar a janela, clique em OK.
◦ Exemplo do Microsoft Excel: SELECT * FROM [$Sheet1]
◦ Exemplo do Microsoft Access: SELECT * FROM Table1
13. Para revisar os dados resultantes, examine a guia Tabela. Se a consulta for especificada
corretamente, a guia conterá uma tabela exibindo os resultados.
14. Para salvar as alterações, clique com o botão direito do mouse no nó da tabela e selecione
Fazer Check-In.

Vincular a dados em um PI AF Server de 64 bits

Para vincular a dados em um banco de dados do Access ou a uma planilha do Excel em um PI
AF Server de 64 bits, é necessário usar o provedor de dados Access Database Engine (ACE) de
64 bits; não há nenhum provedor de dados Jet de 64 bits.
Procedimento
1. No PI System Explorer, navegue até a tabela PI AF ou crie uma conforme descrito em Criar
uma tabela PI AF.
2. No painel Biblioteca, expanda o nó Tabelas e clique na tabela PI AF desejada.
Os detalhes da tabela são exibidos no painel direito.
3. Clique em Vincular.
A janela correspondente é aberta.
4. Ative a opção Personificar Cliente.
5. No campo Conexão, insira uma string de conexão válida para a planilha do Excel ou o banco
de dados do Access usando o Microsoft Office 12.0 Access Database Engine OLE DB Provider
(deve estar instalado no AF Server), conforme nos seguintes exemplos:
◦ Exemplo do Microsoft Excel:
Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\example.xlsx;Extended
Properties="Excel 12.0";
◦ Exemplo do Microsoft Access:
Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\example.accdb;Persist
Security Info=False;
6. Para definir os dados a serem retornados da planilha, insira um consulta SQL no campo
Consulta. Para fechar a janela, clique em OK.
◦ Exemplo do Microsoft Excel: SELECT * FROM [$Sheet1]
◦ Exemplo do Microsoft Access: SELECT * FROM Table1
7. Para revisar os dados resultantes, examine a guia Tabela. Se a consulta for especificada
corretamente, a guia conterá uma tabela exibindo os resultados.
8. Para salvar as alterações, clique com o botão direito do mouse no nó da tabela e selecione
Fazer Check-In.
Importar ou vincular dados do SQL Server

Ao importar ou vincular dados de/para uma tabela do Microsoft SQL Server, é necessário
definir as informações de conexão válida. As etapas para vinculamento ou importação
dependem do método de conexão escolhido. Consulte Autenticação de tabelas vinculadas.
O banco de dados de amostra do SQL Server, o AdventureWorks, é usado nesses
procedimentos.
Nesta seção
• Usar a conexão de segurança personificada do Windows
• Usar a segurança não personificada do Windows
• Usar a segurança SQL Server
• Vincular ou importar a tabela de destino

Usar a conexão de segurança personificada do Windows

Vincule ou importe dados da tabela do SQL Server com a opção Personificar Cliente. Consulte
Recomendações de acesso a dados para tabelas vinculadas.
Nota:
Se vincular a um SQL Server em um computador diferente do AF Server, talvez seja
necessário configurar o Kerberos para permitir que a identidade do cliente seja
encaminhada do AF Server para o SQL Server.
Procedimento
1. Criar um grupo de usuários local no servidor de dados.
2. Configurar a segurança no banco de dados da tabela de destino.
3. Vincular ou importar a tabela de destino.
Nesta seção
• Criar um grupo de usuários local no servidor de dados
• Configurar a segurança no banco de dados da tabela de destino
Criar um grupo de usuários local no servidor de dados

Se a tabela à qual deseja-se conectar estiver localizada em uma instância do SQL Server
diferente da instância na qual o banco de dados SQL do AF (PIFD) está localizado, use este
procedimento para garantir que a tabela esteja acessível.
Procedimento
1. No computador em que a instância SQL Server está localizada, clique em Iniciar >
Ferramentas Administrativas > Gerenciamento do Computador.
O aplicativo Gerenciamento do Computador é iniciado.
2. Expanda Usuários e Grupos Locais.
3. Clique com o botão direito do mouse em Grupos e selecione Novo Grupo.
A janela Novo Grupo é exibida.
4. Crie um grupo de usuários local para os usuários que precisam de acesso à tabela do banco
de dados.
5. Adicione a esse grupo as contas de todos os usuários que podem ser personificados.
6. Clique em OK para adicionar os usuários selecionados e clique em Fechar para fechar a
janela Novo Grupo.
7. Feche o aplicativo Gerenciamento do Computador.
Configurar a segurança no banco de dados da tabela de destino

Qualquer conta na qual a consulta especificada possa ser executada precisa receber permissão
para executar a consulta.
Procedimento
1. Abra o Microsoft SQL Server Management Studio e conecte-o à instância do SQL Server
contendo a tabela de destino.
2. No SQL Server Instance, expanda as pastas Segurança e Logins.
3. Clique com o botão direito do mouse na pasta Logins e selecione Novo Login.

4. Use o botão Pesquisar para encontrar o grupo criado na seção anterior e selecione esse
grupo como no nome do Login.
5. Selecione a opção Autenticação do Windows e o banco de dados contendo a tabela de
destino, como Default database.
6. Selecione a página Mapeamento do Usuário.
7. Selecione a linha dos Bancos de Dados contendo a tabela de destino.
8. Marque a caixa de seleção Mapear do banco de dados selecionado.
9. Expanda a pasta Bancos de Dados, a pasta do banco de dados de destino e conceda as
permissões necessárias para executar a consulta usada no Login recém-criado.
Por exemplo, se a consulta que será usada for uma declaração SELECT que especifica uma
única tabela, expanda a pasta Tabelas do banco de dados de destino, expanda a pasta
Tabelas, clique com o botão direito do mouse na tabela referenciada pela consulta e
selecione Propriedades.
10. Na janela Propriedades da tabela, selecione a página Permissões, procure e selecione Login,
Conceda o Login da Permissão Selecionada e clique em OK para fechar a janela
Propriedades da tabela.
11. Feche o Microsoft SQL Server Management Studio.
Usar a segurança não personificada do Windows

Vincule ou importe dados da tabela do SQL Server com a opção de contexto no additional
security .
Procedimento
1. Criar um grupo de usuários local no servidor de dados
2. Configurar a segurança no banco de dados da tabela de destino
3. Vincular ou importar a tabela de destino
Criar um grupo de usuários local no servidor de dados

Se a tabela à qual deseja-se conectar estiver localizada em uma instância do SQL Server
diferente da instância na qual o banco de dados AF (PIFD) está localizado, execute as etapas a
seguir para garantir que a tabela esteja acessível.
Procedimento
1. No computador em que a instância SQL Server está localizada, clique em Iniciar >
Ferramentas Administrativas > Gerenciamento do Computador.
O aplicativo Gerenciamento do Computador é iniciado.
2. Expanda Usuários e Grupos Locais.
3. Clique com o botão direito do mouse em Grupos e selecione Novo Grupo.
A janela Novo Grupo é exibida.
4. Crie um grupo de usuários local para manter a identidade do AF Service.
5. Adicione a conta do usuário associado ao serviço AF ao novo grupo. Se o AF Service estiver
em execução na conta NT AUTHORITY\NetworkService, adicione a conta do computado do
AF Server ao grupo.

Nota:
Se o serviço AF estive em execução como a conta Sistema Local ou Serviço Local,
provavelmente será necessário usar a autenticação SQL Server (modo de autenticação
SQL Server e Windows) em ver da segurança integrada.
6. Clique em OK para adicionar o usuário selecionado.
7. Feche o aplicativo Gerenciamento do Computador.
Usar a segurança SQL Server

Vincule ou importe dados de uma tabela do SQL Server usando a autenticação SQL Server.
Procedimento
1. Criar um usuário SQL Server.
2. Configurar a segurança no banco de dados da tabela de destino.
3. Vincular ou importar a tabela de destino.
Nota:
Se estiver conectado a uma instância remota do SQL Server, verifique se este está
configurado para aceitar Conexões Remotas.
Se estiver usando uma conta do SQL Server, verifique que a instância do SQL Server
está configurada para permitir a autenticação do modo misto.
Criar um usuário SQL Server

Se a tabela de destino (a tabela no qual deseja-se conectar) estiver localizada em uma instância
SQL Server diferente da qual o banco de dados AF (PIFD) está localizado, crie um usuário e
ative o acesso ao banco de dados do usuário, conforme descrito neste tópico.
Procedimento
1. Abra o Microsoft SQL Server Management Studio e conecte-o à instância do SQL Server
contendo a tabela de destino.
2. No SQL Server Instance, expanda as pastas Segurança e Logins.
3. Crie um novo Login e insira um nome no campo Nome de Login.
4. Selecione a opção Autenticação do SQL Server.
5. Insira a senha nos campos Senha e Confirmar Senha.
6. Na lista Banco de Dados Padrão, selecione o banco de dados contendo a tabela de destino.
8. Selecione a linha dos Bancos de Dados contendo a tabela de destino.
9. Marque a caixa de seleção Mapear do banco de dados selecionado.
10. Clique em OK para fechar a janela Login – Novo e salvar o novo Login.
11. Expanda a pasta Bancos de Dados, a pasta do banco de dados de destino e conceda as
permissões necessárias para executar a consulta usada no Login recém-criado.
Por exemplo, se a consulta que será usada for uma declaração SELECT que especifica uma
única tabela, expanda a pasta Tabelas do banco de dados de destino, expanda a pasta
Tabelas, clique com o botão direito do mouse na tabela referenciada pela consulta e
selecione Propriedades.

12. Na janela Propriedades da tabela, selecione a página Permissões, Login e Conceder o Login à
Permissão Selecionada. Clique em OK para fechar a janela Propriedades da tabela.
13. Feche o Microsoft SQL Server Management Studio.
Vincular ou importar a tabela de destino

Se dados estiverem sendo vinculados a ou importados de uma tabela do Microsoft SQL Server,
o processo será praticamente o mesmo. A seguir estão as instruções para vincular uma tabela
AF usando o PI System Explorer.
Procedimento
1. Para navegar até a tabela PI AF de destino, abra o painel Biblioteca, expanda o nó Tabelas e
clique na tabela desejada.
As propriedades da tabela são exibidas no painel direito.
2. Clique em Vincular.
A janela Link da Tabela é exibida.
3. Clique em Construção.
A janela Propriedades do link de dados é exibida.
4. Na guia Provedor, selecione Cliente Nativo do SQL Server.
5. Na guia Conexão, configure a instância do SQL Server que contém o banco de dados a ser
conectado.
6. Configure a autenticação:
◦ Na segurança integrada, selecione a opção Use Windows NT Integrated Security.

◦ Na segurança do SQL Server, selecione a opção Use a Specific User Name and
Password. Então, insira o nome de login do SQL Server no campo Nome do Usuário e a
senha no campo Senha.
7. Selecione a opção Select the Database e escolha o banco de dados contendo a tabela a
ser conectada.
8. Para verificar se as configurações de conexão funcionam, clique em Testar Conexão. Se as
configurações estiverem corretas, o PI System Explorer exibirá uma mensagem de êxito.
Nota:
A opção Testar Conexão verifica se a conta na qual o PI System Explorer está em
execução tem acesso ao banco de dados especificado. No entanto, se a opção
Segurança Integrada for selecionada na definição Tabela e a opção no additional
security context escolhida na segurança da tabela, a conta associada ao AF Service
será usada para fazer a conexão quando um usuário exibe os dados visualizando a guia
Tabela.
9. Clique em OK.
10. No campo Consulta, especifique a consulta SQL que retorna os dados desejados e clique em
OK.
11. Para exibir os dados recuperados pela consulta, veja a guia Tabela.
Configuração de segurança para tabelas vinculadas
Nesta seção
• Recomendações de acesso a dados para tabelas vinculadas

• Alterar as configurações de segurança das tabelas vinculadas
Recomendações de acesso a dados para tabelas vinculadas

• Se o acesso para vincular tabelas não for necessário, desative-o.
• Não conceda privilégios administrativos de conta do serviço AF no PI AF Server ou no SQL
Server, quando executando com consultas não personificadas.
• Você deve ter privilégios administrativos no PI AF Server para configurar uma tabela
externa que execute consultas não personificadas.
Consulte Alterar as configurações de segurança das tabelas vinculadas para obter instruções.
Alterar as configurações de segurança das tabelas vinculadas

O PI AF Diagnostics Utility é um utilitário de linha de comando que pode ser usado para ativar
ou desativar recursos do PI AF Server, além de realizar outras funções administrativas. Esse
utilitário realiza uma conexão direta com o banco de dados do SQL Server associado e exige a
função sysadmin ou db_afadmin role do SQL Server.
Ele se chama afdiag e está localizado na pasta \PIPC\AF.
Use o AF Diagnostics Utility para ajusta as configurações de segurança das tabelas externas.
Tarefa Comando Configuração padrão
Ativa o suporte a afdiag /DT ativado
tabelas PI AF
externas
Desativa o suporte afdiag /DT
a tabelas PI AF
externas
Ativa o suporte a afdiag /DTImp desativado
tabelas PI AF
externas para
usuários não
personificados
Desativa o suporte afdiag /DTImp-
a tabelas PI AF
externas para
usuários não
personificados
Altera as No PI System Explorer, clique com o Por padrão, a configuração da tabela
configurações de botão direito do mouse na tabela do requer privilégios administrativos no PI
segurança de uma Navegador e selecione Segurança no AF Server.
tabela PI AF menu resultante.
específica
Altere as No PI System Explorer, clique com o Por padrão, a configuração da tabela
configurações de botão direito do mouse em Tabelas no requer privilégios administrativos no PI
segurança de todas Navegador e selecione Segurança no AF Server.
as tabelas. menu resultante.
Configurar uma referência de dados de pesquisa de tabela
Procedimento
2. No Navegador, selecione o elemento ou o template de elemento desejado.

3. No Visualizador, selecione o atributo ou o template de atributo para o qual deseja-se um

valor da pesquisa de tabela.
4. No campo Referência de Dados na Palete, selecione Pesquisa de Tabela no menu.
5. Clique em Configurações.
A janela Referência de dados de pesquisa de tabela é aberta.
6. Na lista Tabela, selecione a tabela desejada.
É possível usar os três botões à direita do campo Tabela para gerenciar e selecionar tabelas.
Passe o mouse sobre o botão para ver o nome dele.
◦ Clique em Gerenciar Tabelas para abrir uma lista das tabelas que podem ser pesquisadas
ou filtradas. Para selecionar uma tabela, destaque-a na lista e clique em OK.
◦ Clique em Propriedades da tabela para ver ou editar as propriedades da tabela atual.
◦ Clique em Criar tabela para abrir a janela Propriedades da tabela para criar uma nova
tabela.
7. Na lista Coluna de resultados, selecione a coluna na tabela em que deseja ler o valor.
Nota:
Marque a caixa de seleção Nível para obter o valor a ser nivelado qual analisado em
uma tendência. Com essa configuração, não existe interpolação entre os valores da
tabela.
8. Na lista Unidade de Medida, selecione a unidade de medida apropriada na qual os dados na
coluna de resultado é armazenada.
9. Selecione o Fuso Horário.
10. Na lista Regra, selecione uma opção:
◦ Select first row matching criteria
Use a lista Ordenar por para especificar a classificação. Essa classificação é usada para
selecionar uma linha quando mais de uma corresponder aos critérios.
◦ Summarize all rows matching criteria
Selecione uma operação de resumo na lista Resumo para executar a operação
selecionada na coluna selecionada no intervalo de linhas que corresponde aos critérios.
Consulte Operações de resumo com suporte para obter as descrições dos operadores.
◦ Table provided time series data
Selecione essa opção se a tabela tiver valores com timestamps associados e quiser tratar
esses valores como dados das séries de tempo. Na lista Coluna Hora, selecione a coluna
da tabela que contém os timestamps a serem usados. Apenas colunas com um tipo de
valor de Data/Hora aparece no menu. A cláusula WHERE não é necessária quando essa
opção é selecionada.
11. No painel Onde, use os menus e botões para criar a consulta de tabela.
Nota:
É possível digitar manualmente toda a cláusula no campo de texto Completar cláusula
WHERE. Consulte Sintaxe da cláusula WHERE para obter mais informações.
◦ Na lista Coluna, selecione a coluna da tabela que será usada na consulta.

◦ Na lista Operador, selecione o operador relacional que será usado na consulta. Consulte
Interpolação para obter uma explicação sobre o operador Interpolar.

◦ Na lista Atributo ou Valor, selecione um atributo ou um valor literal que será usado na
consulta.
◦ Clique em Adicionar E ou Adicionar Ou para gravar a cláusula WHERE no campo
Completar cláusula WHERE com um operador E/OU.
◦ Edite a cláusula no campo Completar cláusula WHERE conforme necessário.
Nota:
Os botões Adicionar E ou Adicionar Ou geram automaticamente a sintaxe necessária, a
UDM e as conversões de fuso horário sempre que necessário.
12. Opcional: Edite os valores dos parâmetros da tabela.
Os parâmetros da tabela só se aplicam a tabelas vinculadas. Para obter mais informações,
consulte Usar parâmetros em consulta de tabela vinculada.
13. Opcional: Em Valores de substituição, selecione os atributos ou os valores literais a serem
retornados quando a consulta da tabela retornar linhas ou valores nulos nos dados.
Nesta seção
• Operações de resumo com suporte
• Interpolação
• Sintaxe da cláusula WHERE
Operações de resumo com suporte

Operação Descrição
Sum Soma
Avg Média
Min Mínimo
Max Máximo
Count Contagem
StDev Desvio estatístico padrão
Var Variação estatística
None • Se o atributo do resultado não for uma matriz, o
valor da coluna selecionada na primeira linha
que corresponde à cláusula WHERE será
retornado.
• Se o atributo do resultado for uma matriz, a
matriz com um valor de cada coluna de todas as
linhas que correspondem à cláusula WHERE
será retornada.
Interpolação
Use o operador Interpolar para interpolar um valor na coluna de resultados baseados em uma
interpolação de uma coluna de entrada específica.
Por exemplo, se uma tabela forte de tanque contiver duas colunas, Nível e Volume, a seguinte
string de configuração interpolará o volume baseado na leitura do nível:
SELECT Volume FROM MyTable WHERE INTERPOLATE(Level, @MyLevelReading)

Presuma que a tabela tenha as seguintes linhas:

Tabela de exemplo
Nível Volume
1 0,0
2 20,0
3 30,0
4 40,0
5 60,0
6 70,0
Uma leitura de Nível 2,2 resulta um volume igual a 22,0.

Apenas o operador Interpolar pode ser usado de forma efetiva em uma cláusula WHERE
exclusiva.
Sintaxe da cláusula WHERE

É possível usar os menus na caixa de diálogo Referência de dados de pesquisa de tabela para
criar a cláusula WHERE para a consulta ou digitar a cláusula diretamente no campo Preencher
Cláusula WHERE. Observe estas diretrizes:
• Os atributos AF, que podem ser identificados pelo símbolo @ antecedendo seu nome, são
substituídos pelo valor deles durante a pesquisa de tabela.
• Nomes de coluna e de atributos contendo símbolos não alfanuméricos devem estar entre
parênteses: [height] >= @[Level Gauge].
• Se a UDM ou a conversão de Fuso Horário forem necessárias para um valor do atributo,
adicione uma UDM à cláusula TZ entre parênteses: [height] >= @[Level
Gauge;UOM=m].
Usar parâmetros em consulta de tabela vinculada

A consulta de uma tabela vinculada determina quais dados de uma fonte externa devem ser
incluídos na tabela. Podem-se incluir parâmetros na consulta e, ao configurar uma referência
de dados de pesquisa de tabela que use a tabela vinculada, podem-se especificar valores de
parâmetro. Isso permite usar uma única tabela vinculada para obter diferentes resultados em
todas as referências de dados de pesquisa de tabela que a use.
Usar parâmetros em uma consulta de tabela vinculada é útil, por exemplo, para limitar o
número de linhas retornadas de uma tabela externa muito grande. Condições e parâmetros
podem ser adicionados para retornar mais resultados de destino, como todas as linhas que
incluem um número de identificação do dispositivo ou fabricante, específico a cada referência
de dados de pesquisa da tabela.
À medida que configura uma tabela na janela Link da Tabela, é possível adicionar parâmetros
de tabela à sua consulta e definir valores para elas. Então, na janela Referência de dados de
pesquisa de tabela, enquanto uma referência de dados é definida usando uma tabela vinculada,
é possível inserir os valores de parâmetro de tabela específicos à referência de dados. Também
é possível fornecer valores de parâmetro de forma programática usando o AF SDK. Os valores
de parâmetro podem ser valores específicos ou originados de outros valores de atributos ou de
variáveis de substituição pré-definidas, como %Element%.

Adicionar os parâmetros de tabela a uma consulta de tabela vinculada

À medida que uma tabela vinculada é definida na janela Link da Tabela, é possível adicionar
parâmetros à consulta da tabela e definir valores padrão para eles.
Procedimento
1. Edite o texto na caixa Consulta para incluir os novos parâmetros. Os nomes dos parâmetros
devem iniciar com o caractere @.
2. Clique na tabela Parâmetros para exibir os novos parâmetros da consulta.
3. Insira os valores padrão de cada parâmetro para determinar os resultados padrão da
consulta e clique em OK. Após a adição dos parâmetros à consulta, especifique os valores
para esses parâmetros à medida em que configura uma referência de dados de pesquisa de
tabela que use a tabela vinculada.
Exemplo
Considere a consulta a seguir para uma tabela vinculada chamada MyTable. A cláusula WHERE
limita a seleção de uma tabela externa (BigTable) para as linhas com um RowID específico:
SELECT * FROM BigTable WHERE RowID = 101
Substitua o valor 101 fixo com um parâmetro de consulta de tabela @id (observe que os nomes
dos parâmetros da consulta devem iniciar com o caractere @):
SELECT * FROM BigTable WHERE RowID = @id
Agora, em cada referência de dados da pesquisa de tabela que use MyTable, será possível
fornecer valores diferentes de parâmetro da tabela para @id para obter resultados diferentes
da consulta.
Por exemplo, na janela Referência de dados da pesquisa de tabela, conforme configura uma
referência de dados, insira @AsseID para o valor de @id na lista Parâmetros de tabela. Isso
define @id como o valor atual do atributo AssetID. A consulta correspondente seria:
SELECT Result FROM MyTable; @id=@AssetId
Essa consulta retorna linhas cujo RowID corresponde ao valor atual de AssetID.
Usar parâmetros nas referências de dados.

Os parâmetros de substituição são variáveis inseridas nos templates de atributo e nas
referências de dados da matriz do PI Point. O PI AF resolve os parâmetros de substituição
quando ele cria a referência de dados para um atributo baseado nesse template. Por exemplo,
podem-se usar os parâmetros de substituição:
• Para configurar um template de referência de dados do PI Point para usar nomes de tags
com base em nomes de elementos originados desse template.
• Para usar o valor de outros atributo na configuração de um valor de propriedades do PI
Point.
Nesta seção
• Substituições de nome
• Referenciar um valor do atributo
• Lista de parâmetros de substituição do PI AF
O PI AF interpreta inúmeros parâmetros de substituição.

Substituições de nome
Ao usar uma substituição de nome, o PI AF faz uma substituição direta do parâmetro de
substituição para qualquer parâmetro específico que seja representado.
A tabela em Lista de parâmetros de substituição do PI AF relaciona os parâmetros de
substituição disponíveis e o que cada um representa. Por exemplo, %Element% é um parâmetro
de substituição que representa o nome do elemento. Depois de criar um elemento baseado
nesse template, o PI AF é instruído a criar a referência de dados (Criar ou atualizar referências
de dados). Quando o PI AF cria a referência, ele substitui o nome do elemento atual sempre que
a configuração diz %Element%.
Suponha que haja um template de referência de dados que faz referência ao nome do PI Point:
%Element%_TT
Um elemento chamado Tank1 e baseado nesse template é criado. A referência de dados do

atributo aponta para um PI Point chamado:
Tank1_TT
Referenciar um valor do atributo

Ao configurar um atributo de referência de dados do PI Point, é possível usar parâmetros de
substituição para fazer referência ao valor de outro atributo. É possível usar referências do
valor de atributo para especificar um valor na caixa Tempo Relativo ou na configuração do
atributo do ponto para PI Points gerados automaticamente. A sintaxe é:
%@AttributeName%
em que AttributeName é o nome do atributo. O símbolo @ indica a necessidade de substituir o

valor do atributo indicado, em vez de seu nome. Para fazer referência a um atributo diferente
do atributo atual, use a sintaxe descrita em Referência indireta para definir o caminho para o
atributo desejado.
O PI AF não atualiza o valor do atributo com o passar do tempo. Ele usa o valor do atributo no
momento exato que a referência de dados é criada ou atualizada (Criar ou atualizar referências
de dados). Esse valor é uma constante. O PI AF não avalia os valores do atributo novamente, a
não ser que a referência de dados seja atualizada.
Nota:
A exceção a essa regra é uma substituição de valor do Tempo Relativo, avaliada em cada
chamada de valor para a referência de dados do PI Point (Criar um intervalo de duração
configurável).
Lista de parâmetros de substituição do PI AF

A seguinte tabela lista os parâmetros de substituição com suporte do PI AF:
Nome do Parâmetro Substituição
%Analysis% Nome da análise, se puder ser obtido no contexto.
%Attribute% Nome do atributo contendo essa referência de dados.
%AttributeId% ID do atributo que mantém essa referência de dados.
%Database% Nome do banco de dados do PI AF no qual o atributo está localizado.
%Description% Descrição do atributo que mantém essa referência de dados.
%Element% Nome do elemento no qual o atributo está localizado. Nas estrutura
de eventos, refere-se ao nome do elemento principal consultado.

Nome do Parâmetro Substituição

%..\Element% Nome do elemento pai no qual o atributo está localizado. Para
recuperar mais ancestrais, use a nota ..\, por exemplo %..\..
\Element%.
%\Element% Nome do elemento raiz no qual o atributo está localizado.
%ElementDescription% Descrição do elemento no qual o atributo está localizado.
%ElementId% ID do elemento no qual o atributo está localizado. Nas estruturas de
eventos, refere-se ao ID do elemento principal consultado.
%EndTime% Hora final local, se puder ser obtida no contexto de tempo.
%EventFrame% Nome da estrutura de eventos na qual o atributo está localizado.
%<Environment Variable>% Valor da variável do ambiente do sistema correspondente. Por
exemplo, %COMPUTERNAME% é substituído pelo nome do computador
no qual a referência de dados está em execução.
%..\EventFrame% Nome da estrutura de eventos pai da estrutura de eventos na qual o
atributo está localizado. Para recuperar mais ancestrais, use a
nota ..\, por exemplo %..\..\EventFrame%.
%\EventFrame% Nome da estrutura de eventos raiz na qual o atributo está localizado.
%EventFrameId% ID da estrutura de eventos na qual o atributo está localizado.
%Model% Nome do modelo, se puder ser obtido no contexto.
%Server% Nome do PI Server padrão do computador no qual o atributo foi
criado. Durante a criação do atributo no PI System Explorer, esse é o
PI Server padrão do computador no qual o PI System Explorer está
em execução.
Nota:
O parâmetro %Server% não é resolvido no computador no
qual o banco de dados do PI AF está localizado. O parâmetro
%Server% pode ser resolvido em um PI Server diferente
dependendo do padrão no cliente do PI AF.
%Source% Nome do elemento de origem da transferência na qual o atributo

está localizado.
%StartTime% Hora de início local, se puder ser obtida no contexto do tempo.
%System% Nome do PI AF Server ou do coletivo do PI AF no qual o atributo está
localizado.
%Template% Nome do template no qual o elemento está baseado. Por exemplo, se
um elemento Valve101 for criado com base em um template
chamado Valve, o texto de substituição será Valve.
%Time% Hora local, se puder ser obtida no contexto de tempo.
%Transfer% Nome da transferência na qual o atributo está localizado.
%TransferId% ID da transferência na qual o atributo está localizado.
%UtcEndTime% Tempo Universal Coordenado (UTC) final se ele puder ser obtido no
contexto de tempo.
%UtcStartTime% Tempo Universal Coordenado (UTC) inicial se ele puder ser obtido
no contexto de tempo.
%UtcTime% Tempo Universal Coordenado (UTC) se ele puder ser obtido no
contexto de tempo.

Encontrar o PI Server padrão

O parâmetro de substituição %Server% resolte o nome do PI Server padrão do computador no
qual o atributo foi criado. Se um atributo estiver sendo criado no PSE, ele será o PI Server
padrão do computador no qual o PSE está em execução.
Nota:
%Server% não é resolvido para o computador no qual o banco de dados PI AF está

localizado.
Procedimento
1. No computador executando o PI System Explorer, abra o PI SDK Utility. . Com os padrões de
instalação do PI Server, selecione Iniciar Todos os Programas > PI System > AboutPI-SDK
A caixa de diálogo PI SDK Utility é exibida.
2. Selecione Arquivo > Conexões. O Gerenciador de Conexões do PI é exibido.
3. Selecione Conexões > Opções. A caixa de diálogo Opções de Conexão é exibida. O servidor
padrão é listado em Configurações de Servidor Padrão.
Trabalhar com unidades de medida

Nesta seção
• Unidades de medida PI AF
• Classes base e derivadas
• Criar uma nova unidade de medida
• Criar uma nova classe UDM
• Classes base UDM
• Algumas classes derivadas de UDMs comuns
Unidades de medida PI AF
O recurso de unidade de medida (UDM) permite conversões automática de unidades em
aplicativos cliente. Por exemplo, suponha que um atributo AF tenha uma UDM de metros. Um
usuário PI ProcessBook que está visualizando um valor de atributo pode escolher visualizar o
valor em diferentes unidades, como pés. O PI AF converte automaticamente os dados de metros
para pés.
No PI AF, cada unidade de medida está baseada na classe UDM. Classes representam
propriedades de medida, como temperatura, comprimento, tempo e massa. Cada classe tem
uma unidade canônica. Essa é a unidade base da qual o AF converte valores em outras
unidades, quando necessário. Por exemplo, a unidade canônica para a classe comprimento é o
metro (m). A implementação de UDMs no PI System Explorer está baseada no Sistema
Internacional (SI) de Unidades.
Nota:
As Unidades de Medida são usadas em todos os bancos de dados PI AF. Não há outra UDM
definida para diferentes bancos de dados.

Classes base e derivadas

O PI AF predefiniu um pequeno conjunto de classes base e um grande conjunto de classes
derivadas das classes base: as classes derivadas. As classes derivadas são simplesmente classes
que podem ser expressas em termos de classes base UDM. Por exemplo, ambas as classes de
área e volume são derivadas da classe de comprimento. Podem-se definir praticamente todas
as unidades de medidas em termos de um pequeno grupo de classes base UDM.
O PI AF usa a unidade canônica para a classe base para determinar as unidades canônicas de
todas as classes derivadas dessa classe base. Não é possível alterar a unidade canônica de uma
classe derivada. Por exemplo, porque a classe de área está baseada na classe de comprimento, a
unidade canônica da área é metro quadrado (m²).
O PI AF contém várias UDMs padrão, classes UDM e fatores de conversão, mas nem sempre é
possível adicionar novos itens. Em geral, não é necessário criar uma nova classe base, apesar
de, ocasionalmente, desejar-se adicionar uma para medidas não físicas. Por exemplo, pode-se
adicionar uma classe chamada "bytes" que pode incluir UDMs de bytes, KB, MB, GB etc.
Criar uma nova unidade de medida

Procedimento
1. No PI System Explorer, clique no botão Unidade de Medida no painel Navegador. Todas as
classes UDM aparecem no Navegador.
2. No Navegador, clique para selecionar a classe à qual deseja-se adicionar a nova UDM. Por
exemplo, para adicionar uma nova unidade de comprimento, clique para selecionar a classe
Comprimento. Todas as UDMs atualmente definidas para a classe selecionada aparecem no
Visualizador.
3. Clique com o botão direito do mouse na classe desejada no Navegador e selecione Nova
Unidade de Medida no menu que aparece. A janela Propriedades da Unidade de Medida é
exibida.
4. Preencha a guia Propriedades da Unidade de Medida (Propriedades da unidade de medida).
Nesta seção
• Propriedades da unidade de medida
• O campo de fórmula
Propriedades da unidade de medida

Caixa/Botão Descrição
Nome Insira um nome. As unidades de medida podem ter
o mesmo nome, mas devem ter diferentes
abreviaturas.
Abreviatura Insira a abreviatura. As unidades de medida devem
ter diferentes abreviaturas.
Descrição Opcional. Insira uma descrição para a unidade de
medida.
UDM Canônica A caixa de somente leitura exibe unidade canônica
para a classe.
UDM de Referência Selecione uma unidade da classe de referência do
qual a nova unidade pode ser convertida.

Caixa/Botão Descrição
Tipo — Simples Selecione para uma conversão que requer um fator
de escala e um deslocamento de base.
Tipo — Fórmula Selecione para um cálculo de conversão complexo.
Consulte O campo de fórmula para obter mais
informações.
Fator O fator de conversão da UDM de referência nesta
UDM. Por exemplo, um quilômetro tem um fator
igual a 1000 relativo a um metro.
Deslocamento O deslocamento de conversão na UDM de
referência. Por exemplo, °C têm um deslocamento
de 273,15 de Kelvin.
O campo de fórmula
Ao criar uma nova Unidade de Medida, é necessário definir o método de conversão. Uma
fórmula pode ser usada para a conversão. O PI AF usa C# para avaliação de fórmula UDM. Siga
estas orientações:
• Grave todas as Unidades de Medida em termos de abreviatura UDM. Se uma abreviatura não
for um nome de variável C# válido, coloque-a entre parênteses.
• Adira às regras de avaliação C#.
• Como alternativa, é possível chamar métodos estáticos .NET, como Math.Log10(), para
realizar o cálculo (limita-se ao que o Conjunto do Sistema disponibiliza). A fórmula usa a
classe CompilerResults para avaliar a fórmula dos resultados.
Por exemplo, watts (w) é a UDM canônica para a classe Potência. Para criar uma UDM dBM
na classe Potência, a fórmula pode ser:
Por exemplo, watts (w) é a UDM canônica para a classe Potência. Para criar uma UDM dBM na
classe Potência, a fórmula pode ser:
dBm = Math.Log10( w ) + 30
Criar uma nova classe UDM

Procedimento
1. No PI System Explorer, clique no botão Unidade de Medida no painel Navegador.
Todas as classes UDM aparecem no Navegador.
2. No Navegador, clique com o botão direito do mouse em qualquer lugar e selecione Nova
Classe de Unidade de Medida. A janela Propriedades da Classe de Unidade de Medida é
exibida.
3. Preencha as propriedades na guia Geral:
◦ Nome
Insira um nome para a classe. Se necessário, consulte Restrições nos nomes de objeto AF.
◦ Descrição
Opcional. Insira uma descrição para a classe.
◦ UOM Canônico

Insira o nome da UDM canônica para a classe. Se a UDM não existir, o PI AF a criará
quando a nova classe for criada.
◦ Abreviação UOM Canônica
Insira a abreviatura. As classes de unidades de medida devem ter abreviaturas diferentes.
◦ Unidades de Medida Base
Insira um cálculo para a unidade de medida. Para definir uma nova classe base, deixe
esse campo em branco.
4. Clique em OK.
5. A guia Unidades de Medida mostra todas as UDMs definidas para essa classe. Para adicionar
novas unidades de medida, clique na lista e selecione Nova Unidade de Medida. É possível
adicionar novas unidades de medida sempre que necessário.
Classes base UDM

Classe Unidade Canônica
Corrente Elétrica Ampère (amp)
Comprimento metro (m)
Massa quilograma (kg)
Mols (Quantidade de substância) mol (mol)
Ângulo Plano rádio (rad)
Quantidade contagem
Rátio porcentagem (%)
Temperatura Kelvin (K)
Tempo segundos (s)
Algumas classes derivadas de UDMs comuns

Classe com base em... Unidade Canônica
Velocidade Angular Ângulo Planar * Tempo-1 radianos por segundo (rad/s)
Área Comprimento2 metros quadrados (m2)
Densidade Massa * Volume-3 quilogramas por metro cúbico (kg/m3)
Caga Elétrica Corrente Elétrica * Tempo Coulomb (C)
Potencial Elétrico Corrente Elétrica-1 * Comprimento2 * volt (V)
Massa * Tempo-3
Energia Comprimento2 * Massa * Tempo-2 joule (J)
Frequência Tempo-1 hertz (Hz)
Força Massa * Comprimento * Tempo-2 newton (N)
Taxa de Fluxo de Massa * Tempo-1 quilogramas por segundo (kg/s)
Massa
Potência Massa * Comprimento2 * Tempo-3 watt (W)
Pressão Massa * Comprimento-1 * Tempo-2 pascal (Pa)
Energia específica, Comprimento2 * Tempo-2 joules por grama (J/g)
Entalpia específica
Velocidade Comprimento * Tempo-1 metros por segundo (m/s)

Classe com base em... Unidade Canônica

Volume Comprimento3 metro cúbico (m3)
Taxa de Fluxo de Comprimento3 * Tempo-1 metro cúbico por segundo (m3/s)
Volume

Análise com base em ativos para o PI Server
Análises com base em ativos é um recurso integral do PI Asset Framework (PI AF) que permite
a criação e o gerenciamento de análises. No PI System Explorer, a funcionalidade Análises com
base em ativos está disponível enquanto você trabalha com elementos e templates de
elemento.
Uma análise é um cálculo agendado que recebe valores de entradas dos atributos em uma
hierarquia do AF e resultados de saída de outros atributos do AF. Usar atributos do AF
configurados como Referências de dados do PI Point viabiliza que uma análise receba entradas
e salve saída dos PI Points.
Nota:
É altamente recomendável salvar as saídas de análises dos PI Points para possa ser criada
uma história dos dados, e para que eles participem da criação de uma tendência pelas
nossas ferramentas cliente. Salvar as saídas de análises nos PI Points também melhora o
desempenho do PI AF.
Nesta seção
• Sobre análises
• Análises de expressão
• Análises de sinterização
• Análises de geração da estrutura de eventos
• Gerenciar análises de um elemento
• Análises de amostra
• Gerenciar análises em um banco de dados AF
• Gerenciamento o Serviço de Análise do PI
• Referência de funções de expressão
• Funções de vapor para expressões de análise
Sobre análises
Uma análise é composta por uma expressão que realiza cálculos e agendamento para sua
execução. Ela leva os valores existentes como entradas para criar novas saídas, novos valores
calculados ou estruturas de eventos. Os atributos podem ser especificados de qualquer lugar da
hierarquia AF como entradas em uma análise.
Cada análise está associada a um elemento ou, preferivelmente, a um template de elemento. É
possível salvar as saídas de análise mapeando-as nos atributos desses elementos ou template
de elementos.
Nota:
O mapeamento de uma saída de análise em um atributo AF configurado como uma
referência de dados do PI Point salvará a saída para um PI Point. É altamente
recomendável salvar as saídas de análises dos PI Points para que possa ser criada uma
história dos dados, e para que eles participem da criação de uma tendência pelas nossas
ferramentas cliente. Salvar as saídas de análises nos PI Points também melhora o
desempenho do PI AF.
Há três tipos de análises disponíveis:

• Expressão
Calcula um ou mais valores de saída de operadores, valores de entrada e funções específicas.
• Sintetização
Calcula as funções estatísticas padrão para um grupo de atributos selecionados, que é
selecionado de atributos de um elemento ou de um conjunto com todos os atributos em seus
subelementos.
• Geração da estrutura de eventos

Especifica as condições que iniciam e terminam as estruturas de eventos.
Nesta seção
• Usar templates de análise
• Agendamento de análise
• Atualizar análises e templates de análise
• Expressões
Usar templates de análise

Para aplicar uma análise a um template, especifique o elemento diretamente enquanto cria a
análise. Para aplicar uma análise a um grupo de elemento, no entanto, é muito mais eficiente
usar um template de análise em vez de aplicar a análise individualmente a cada elemento.
Um template de análise define a forma de uma análise. Todas as análises criadas com base no
template são semelhantes, mas têm atributos de entrada e saída específicos. Os templates de
análise permitem usar todos os recursos da hierarquia AF. Cada elemento originado em um
template de elemento adquire automaticamente a análise de seus templates de análise.
Pode-se criar um template de análise em um template de elemento de forma muito semelhante
à criação de uma análise em um elemento. Ao adicionar ou alterar um template de análise em
um template de elemento, essas alterações são propagadas para todos os elemento originados
no template de elemento. A exclusão de um template de análise exclui todas as análises
originadas nele, exceto pelas análises vinculadas às Notificações.
Nota:
Uma análise originada em um template de análise não pode ser removida diretamente de
um elemento.
Agendamento de análise
O agendamento especifica quando uma análise será avaliada. Há dois tipos de agendamento
disponíveis:
• Periódico
O agendamento periódico usa o relógio como base. Quando você seleciona a opção Periódico
para Agendamento, o período atual é exibido. Clique em Configurar para configurar o
período de agendamento.
• Acionado por Evento

Este tipo de agendamento é baseado no evento. Quando você seleciona Acionado por Evento
para Agendamento, você pode selecionar um ou mais atributos de entrada para acionar
uma avaliação para a análise sempre que houver uma alteração no valor de um dos
atributos selecionados.

Atualizar análises e templates de análise

Assim que é feito check in de uma nova análise, ela é automaticamente ativada e
disponibilizada para execução. Qualquer alteração cujo check in é feito é imediatamente
coletado por todas as análises afetadas por ela, mesmo se estiverem em execuções. As
alterações que podem afetar uma análise incluem:
• Edições feitas diretamente na análise

• Alterações em um elemento que impactam na análise, inclusive a adição ou exclusão de uma
análise
• Alterações em um template de elemento, que são propagadas em todos os elementos
originados no template, inclusive na adição e exclusão de um template de análise
• Alterações em um template de análise, que são propagadas a todas as análises originadas no
template
• Alterações em um template da estrutura de eventos usado pela análise; novas estruturas de
eventos são baseadas no template atualizado
Expressões
Todas as análises, exceto as sintetizações, incluem expressões exibidas como uma ou mais
linhas. Uma expressão simples pode ocupar uma única linha.
Nome Expressão Valor
Variable1 PrevVal('Att1') - 100
O seguinte exemplo mostra uma expressão complexa recriada em expressões menores em

várias linhas. As duas linhas superiores atribuem nomes V1 e V2 para expressões mais simples
usadas como variáveis na última linha.
V1 'Att1'/2
V2 'Att2' - 'Att3'
Resultado V1 + 3*V2
Observe que:
• O nome de uma linha pode ser uma variável em qualquer linha inferior.
• As linhas são avaliadas na ordem da primeira linha para a segunda e assim por diante.
Porque as linhas inferiores dependem das superiores, podem-se reordenar as linhas para
avaliá-las na ordem correta.
Clique em Adicionar nova expressão para adicionar uma linha, e o ícone (X) para excluí-la.
Em qualquer expressão, clique em Avaliar para avaliar as linhas (com base nos dados atuais) e
exibir os valores de cada uma na coluna Valores.
Em todas as análises Expressão, pelo menos uma linha deve ser mapeada em um atributo de
saída. Nas expressões de várias linhas, mapeie o valor de qualquer linha em um atributo de
saída.
Nesta seção
• Inserir expressões
• Simplificar uma expressão com recriação

Inserir expressões
Para criar uma expressão, clique na coluna Expressão de uma linha e especifique os atributos
de entrada, as funções ou as variáveis a serem inclusos nela.
• É possível selecionar e inserir atributos e funções na expressão dos painéis Atributos e

Funções à direita da expressão.
• Pode-se inserir o texto diretamente na expressão. À medida que os dados são inseridos,
funções, atributos e variáveis que correspondem a esses dados inseridos aparecem em uma
lista selecionada no cursor; pode-se selecionar um item a ser inserido.
Simplificar uma expressão com recriação

Nos aplicativos reais, a expressão em uma análise pode ser extremamente complexa, e o
comprimento dos nomes do atributo pode adicionar mais complexidade. Para simplificar uma
expressão complexa, recrie-a como um grupo de pequenas expressões atribuídas a variáveis.
A recriação de uma análise facilita a compreensão de como cada parte dela funciona. Também
ajuda no teste e na depuração permitindo a avaliação de expressões menores individualmente
para isolar um erro.
Pode-se recriar uma análise adicionando novas linhas de expressão e inserindo texto para
Nome e Expressão diretamente.
Como alternativa, destaque um termo em uma expressão e clique com o botão direito do
mouse para selecionar Atribuir à variável. Isso insere uma nova linha acima que mapeia o
termo para um novo nome de variável. Na expressão original, o termo é substituído pelo nome
da nova variável.
É possível editar o nome de qualquer linha. Se o nome de uma linha da expressão usada como
variável em outras expressões for alterada, isso quebrará a conexão entre eles.
Exemplo
Uma expressão complexa pode ocupar uma única linha:
Variable1 2*'LongAttributeName' + Avg('Att2', 'Att3', 'Att4')
A expressão pode ser recriada como uma das seguintes três linhas de expressões mais simples.
Observe que um nome em uma linha pode ser usado como uma variável em qualquer linha
inferior:
Variable1 'LongAttributeName'
Variable2 Avg('Att2', 'Att3', 'Att4')
Variable3 2*Variable1 + Variable2
Análises de expressão
O tipo mais direto de análises é a análise de expressão. Ele contém uma ou mais expressões e
informações de agendamento.
Nesta seção
• Criar um template de análise da expressão

• Criar uma análise de expressão
Criar um template de análise da expressão

Crie um template de análise da expressão para o template de elemento selecionado.
Para salvar os valores de saída, mapeie-os para os atributos disponíveis do template de
elemento. Pode-se criar um novo atributo de saída à medida que a análise é configurada.
Antes de Iniciar
Determine os valores de saída que deseja-se calcular e salvar. Identifique as funções, os
operadores e os atributos de entrada necessários para o cálculo.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Biblioteca e, na árvore Navegador,
selecione o template de elemento no qual deseja-se criar o template de análise.
2. Clique na guia Templates de Análise. A guia Templates de Análise do template de elemento
é aberto no painel Visualizador. Se não houver nenhum template de análise, clique em Criar
novo template de análise para criar o primeiro. Caso contrário, clique no ícone do botão
Novo Template de Análise na barra de ferramentas acima da tabela de análise para criar
outro template.
3. Preencha o campo Nome e, como opção, Descrição.
4. Opcional: Clique no menu Categorias para exibir as categorias disponíveis que podem ser
atribuídas para análise.
◦ Marque as categorias a serem atribuídas e clique em Selecionar.
◦ Para criar uma nova categoria, clique em Novo. Insira o nome e a descrição da nova
categoria e clique em OK.
5. Em Tipo de Análise, clique em Expressão.
6. Opcional: Clique em Selecionar um elemento de exemplo para escolher um elemento com
base no template de elemento atual para que seja possível usar seu valor para avaliar o
template de análise. Os templates não têm dados concretos associados aos atributos deles.
Não será possível avaliar uma expressão em um template de análise, exceto se os valores do
atributo forem emprestados de um elemento específico para fazer isso. O elemento
selecionado é exibido em Elemento de Exemplo.
7. Insira a expressão como uma ou mais linhas.
8. Determine quais linhas deseja-se mapear nos atributos de saída. Certifique-se de mapear
pelo menos uma linha para um atributo de saída.
9. Escolha um item para Agendamento e configure o agendamento.
10. Para aplicar as alterações e salvar o trabalho localmente, clique em Aplicar Alterações (a
marca de verificação verde na barra de ferramentas).
11. Clique em Fazer Check-In para salvar o template de análise e instanciar a análise para todos
os elementos filhos do template de elemento.
Criar uma análise de expressão

Antes de criar uma expressão de análise, determine os valores de saída a serem calculados e
salvos. Identifique as funções, os operadores e os atributos de entrada necessários para o
cálculo.

Para salvar os valores de saída, mapeie-os para os atributos disponíveis do elemento. Pode-se
criar um novo atributo de saída à medida que a análise é configurada.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Elementos e, na árvore Navegador,
selecione o elemento no qual se deseja criar a análise.
2. Clique na guia Análise. A guia Análise para o elemento é aberta no painel Visualizador. Se
não houver nenhuma análise, clique em Criar nova análise para criar a primeira. Caso
contrário, clique no ícone do botão Nova Análise na barra de ferramentas acima da
tabela de análise para criar outro template.
5. Em Tipo de Análise, clique em Expressão.
6. Insira a expressão como uma ou mais linhas.
7. Certifique-se de mapear pelo menos um atributo de saída.
8. (Opcional) Clique em Avaliar para verificar se os valores de saída foram gerados conforme o
esperado.
9. Selecione um item para Agendamento e configure o agendamento.
10. (Opcional) Para verificar a análise, examine os resultados gerados por ela usando os dados
históricos.
a. Na lista de análises, clique com o botão direito do mouse no nome da análise e selecione
Visualizar Resultados.
b. Insira uma hora de início e um tempo final anterior ao tempo atual e clique em Gerar
Resultados para ver a lista de resultados.
marca de verificação verde na barra de ferramentas). Isso não executa a análise.
12. Para fazer check in na análise, clique em Fazer Check-In na barra de ferramentais. Isso salva
e faz check in da análise para que ela possa ser executada.
Análises de sinterização
Uma análise de sinterização calcula os valores estáticos, como totais e médias, de atributos
selecionados associados a um elemento. Por exemplo, uma análise de sinterização em um
elemento Fábrica pode usar os valores de atributo Temperatura em todas as bombas na fábrica
para calcula a temperatura média delas.
Selecione os atributos a serem incluídos em uma sinterização de:
• Os próprios atributos do elemento. Por exemplo, verifique se o nível de um tanque é
constante verificando se a soma de todos os fluxos de entrada e saída for igual a zero. Na
lista dos atributos do elemento do tanque, selecione os atributos dos fluxos de entrada e

saída para obter uma sinterização de somatória. Uma sinterização usando os próprios
atributos do elemento também é conhecida como sinterização;
• Atributos dos elementos filhos do elemento. Como exemplo, talvez seja necessário calcular o
consumo médio de energia de um grupo de bombas em uma refinaria. Para fazer isso, crie
uma análise de sinterização no elemento pai (a refinaria) que calcule a média dos atributos
de consumo de energia de seus elementos filhos (bombas).
Na lista de atributos disponíveis, selecione um que se deseja incluir na sinterização inserindo
um ou mais critérios de seleção:
• Insira todo, ou parte, nome do atributo para selecionar os atributos que correspondam aos
dados inseridos. Uma marca de verificação ao lado de um atributo na lista indica que ele
está incluso na sinterização.
• Também selecione as categorias Atributo e Elemento para selecionar seus atributos.
• Pode-se escolher um template de elemento para selecionar os atributos selecionados a ele.
Depois de selecionar os atributos a serem inseridos, selecione as funções estatísticas que
deseja que a sinterização calcule. Mapeie o atributo de cada uma dessas funções para um
atributo de saída.
Porque uma sinterização identifica os atributos de entrada sempre que é executada, ela
automaticamente inclui todos os novos atributos que atendam a esses critérios de seleção.
Elementos ou atributos podem ser adicionados ou excluídos na hierarquia sem que a
sinterização seja atualizada.
Nesta seção
• Crie um template de análise de sintetização
• Crie uma análise de sintetização
Crie um template de análise de sintetização

Crie um template de análise de sintetização para um template de elemento selecionado.
Selecione os valores de entrada da sintetização nos próprios atributos do template de elemento
ou nos atributos de um elemento filho (cujo elemento pai é originado no template de
elemento). Pode-se escolher um elemento filho e usar seus atributos para ajudar no
desenvolvimento de um template de análise de sintetização.
Antes de Iniciar
Antes de começar, identifique as funções estáticas que se deseja que a sintetização calcule e
onde deseja-se salvar os resultados. É possível mapear os resultados de uma função para um
dos atributos do template de elemento ou criar um novo atributo de saída ao configurar um
template de análise.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Biblioteca e selecione o template de
elemento no qual deseja-se criar o template de análise.
é aberto no painel Navegador. Se não houver nenhum template de análise, clique em Criar
outro template.

5. Em Tipo de Análise, clique em Sintetizar.
6. Selecione um item para Resumir atributos de para exibir uma lista dos atributos candidatos
à sintetização:
◦ Se Elementos filhos de <elemento> for selecionado, será necessário selecionar um
elemento de exemplo para fornecer os atributos candidatos. Clique no link Selecionar um
elemento de exemplo para selecionar qualquer elemento filho de <elemento> como um
exemplo.
◦ Selecione Este elemento para usar os atributos do template de elemento atual.
7. Insira um ou mais critérios de seleção para incluir os atributos na sintetização. Uma marca
de verificação ao lado de um atributo na lista indica que ele está incluso na sintetização.
◦ Em Nome do atributo, insira todo, ou parte, o nome do atributo para selecionar os
atributos que correspondam aos dados inseridos.
◦ Selecione uma categoria para Categoria do atributo para selecionar os atributos dessa
categoria.
◦ (Quando Elementos filhos de for selecionado) Faça as seleções para Categoria do
Elemento e Template de Elemento.
8. Selecione as funções estatísticas que deseja que a sintetização calcule.
9. Clique em Mapear para mapear as saídas das funções inclusas nos atributos de saída.
Também é possível criar um novo atributo para uma saída.
12. Para fazer check in no template de análise, clique em Fazer Check-In na barra de
ferramentais. Isso inicia a análise de todos os elementos associados.
Crie uma análise de sintetização

Crie uma análise de sintetização para um elemento selecionado. Podem-se selecionar atributos
de entrada para a sintetização dos atributos próprios do elemento do dos atributos nos seus
elementos filho.
Antes de fazer isso, identifique as funções estatísticas que se deseja sintetizar para o cálculo.
Para salvar os valores calculados, mapeie as saídas deles nos atributos do elemento. Também
pode-se criar um novo atributo de saída quando a análise é configurada.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Elemento e, na árvore Navegador,
selecione o elemento no qual se deseja criar a análise.
2. Clique na guia Análise. A guia Análise para o elemento é aberta no painel Visualizador. Se
não houver nenhuma análise, clique em Criar nova análise para criar a primeira. Caso
contrário, clique no ícone do botão Nova Análise na barra de ferramentas acima da
tabela de análise para criar outro template.


5. Em Tipo de Análise, clique em Sintetizar.
6. Em Resumir atributos de, selecione se os atributos serão usados dos elementos filho ou dos
próprios atributos do elemento.
7. Insira um ou mais critérios de seleção para incluir os atributos na sintetização. Uma marca
de verificação ao lado de um atributo na lista indica que ele está incluso na sintetização.
◦ Insira todo, ou parte, o nome do atributo para selecionar os atributos que correspondam
aos dados inseridos.
◦ Selecione uma categoria para Categoria do atributo para selecionar os atributos dessa
categoria.
◦ (Quando Elementos filhos de for selecionado) Faça as seleções para Categoria do
Elemento e Template de Elemento.
8. Selecione as funções estatísticas que deseja que a sintetização calcule.
9. Clique em Mapear para mapear as saídas das funções selecionadas nos atributos de saída.
Também é possível criar um novo atributo para uma saída.
10. (Opcional) Clique em Avaliar para verificar se os valores de saída foram gerados conforme o
esperado.
12. (Opcional) Para verificar a análise, examine os resultados gerados por ela usando os dados
históricos.
a. Na lista de análises, clique com o botão direito do mouse no nome da análise e selecione
Visualizar Resultados.
b. Insira uma hora de início e um tempo final anterior ao tempo atual e clique em Gerar
Resultados para ver a lista de resultados.
marca de verificação verde na barra de ferramentas). Isso não executa a análise.
14. Para fazer check in na análise, clique em Fazer Check-In na barra de ferramentais. Isso salva
e faz check in da análise para que ela possa ser executada.
Análises de geração da estrutura de eventos

Uma análise de geração da estrutura de eventos especifica as condições para iniciar e terminar
as estruturas de eventos.
Este tipo de análise inclui uma ou duas expressões. Quando uma condição dispara o início e o
término de uma estrutura de eventos, apenas a expressão StartTrigger é necessária. Por
exemplo, um valor de temperatura que é elevado até ficar acima do limite pode iniciar uma
estrutura de eventos e terminá-la quando o valor volta a ficar abaixo do limite. Quando as
condições de início e término são diferentes, uma expressão EndTrigger também é necessária.

• Porque as condições de início e término são testadas, expressões nas análises de geração da
estrutura de eventos devem ser avaliadas como verdadeiras ou falsas.
• Um pico nos dados de entrada podem disparar o início de uma estrutura de eventos
indesejada. Para reagir aos efeitos dos picos de dados, pode-se exigir que o disparador de
início permaneça verdadeiro em um intervalo de tempo da configuração antes de criar uma
estrutura de eventos. Insira um valor para StartTrigger verdadeiro para a fim de especificar
o intervalo de tempo.
Uma análise da estrutura de eventos é baseada em um template da estrutura de eventos, que
especifica os atributos das estruturas de eventos geradas. Antes de criar uma análise de
geração da estrutura de eventos, certifique-se de que haja um template da estrutura de eventos
disponível.
Geralmente as estruturas de eventos incluem um elemento de referência. O elemento associado
a uma análise de geração da estrutura de eventos se torna o elemento de referência para as
suas estruturas de eventos geradas.
Em alguns eventos, como um desligamento forçado, talvez queira-se avaliar as condições
gerando o evento. Para fazer isso, podem-se gerar as estruturas de eventos de causa raiz. Em
cada estrutura de eventos, uma estrutura de eventos de causa raiz é gerada para capturar os
atributos de um intervalo de tempo especificado um pouco antes do início da estrutura de
eventos.
Nesta seção
• Criar um template de análise de geração da estrutura de eventos
• Crie uma análise de geração da estrutura de eventos
• Especificar por quanto tempo um gatilho de início deve permanecer verdadeiro
Criar um template de análise de geração da estrutura de eventos

Antes de criar um template de análise de geração da estrutura de eventos, certifique-se de que
haja um template da estrutura de eventos disponível.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Biblioteca e, na árvore Navegador,
selecione o template de elemento no qual deseja-se criar o template de análise.
é aberto no painel Visualizador. Se não houver nenhum template de análise, clique em Criar
outro template.
5. No Tipo de Análise, clique em Geração da Estrutura de Eventos.
6. Opcional: Clique em Selecionar um elemento de exemplo para escolher um elemento com
base no template de elemento atual para que seja possível usar seu valor para avaliar o
template de análise. Os templates não têm dados concretos associados aos atributos deles.

Não será possível avaliar uma expressão em um template de análise, exceto se os valores do
atributo forem emprestados de um elemento específico para fazer isso. O elemento
selecionado é exibido em Elemento de Exemplo.
7. Selecione um item para o Template de Estrutura de Evento. O template determina o tipo de
estrutura de eventos a ser gerada.
8. Insira uma expressão para StartTrigger. Esta é uma condição booliana que inicia uma
estrutura de eventos.
9. Opcional: Se uma condição diferente finaliza a estrutura de eventos, insira a expressão de
condição na caixa EndTrigger.
10. Opcional: Insira um intervalo de tempo em StartTrigger verdadeiro para. Este intervalo de
tempo indica por quanto tempo a condição StartTrigger deve ser verdadeira para iniciar
uma estrutura de eventos. A configuração desse intervalo de tempo reduz a ocorrência das
estruturas de eventos não desejadas causadas por uma flutuação momentânea nos dados de
entrada.
11. Opcional: Selecione Gerar estrutura de evento causa raiz filho antes que a estrutura de
evento pai comece e especifique uma duração para gerar uma estrutura de evento de causa
raiz para cada estrutura de evento. Uma estrutura de eventos de causa raiz captura os dados
do ativo pela duração especificada, o que pode ajudar na análise das condições um pouco
antes de iniciar uma estrutura de eventos.
14. Clique em Fazer Check-in para salvar o template de análise e instanciar a análise para todos
os elementos filhos do template de elemento.
Crie uma análise de geração da estrutura de eventos

Antes de criar uma análise de geração da estrutura de eventos, certifique-se de que haja um
template da estrutura de eventos disponível.
Procedimento
1. No painel Navegador do PI System Explorer, clique em Elemento e, na árvore Navegador,
selecione o elemento no qual deseja-se criar a análise.
2. Clique na guia Análise. Se o elemento não tiver análises, clique em Criar uma nova análise;
caso contrário, clique no ícone Nova Análise na barra de ferramentas acima da tabela de
análises.
5. No Tipo de Análise, clique em Geração da Estrutura de Eventos.
6. Selecione um item para o Modelo da Estrutura de Eventos. O template determina o tipo de
estrutura de eventos a ser gerada.
7. Insira uma expressão para StartTrigger. Esta é uma condição booliana que inicia uma
estrutura de eventos.

8. Opcional: Se uma condição diferente finaliza a estrutura de eventos, insira a expressão de

condição na caixa EndTrigger.
9. Opcional: insira um intervalo de tempo em StartTrigger verdadeiro para. Este intervalo de
tempo indica por quanto tempo a condição StartTrigger deve ser verdadeira para iniciar
uma estrutura de eventos. A configuração desse intervalo de tempo reduz a ocorrência das
estruturas de eventos não desejadas causadas por um pico momentâneo nos dados de
entrada.
12. Clique em Fazer Check-In para salvar a análise e fazer o seu check in para que sua execução
possa ser iniciada.
Especificar por quanto tempo um gatilho de início deve permanecer

verdadeiro
Uma análise de geração da estrutura de eventos inicia uma estrutura de eventos quando a
condição do gatilho de início é avaliada para verdadeira. Porque um pico aleatório em um valor
de entrada pode tornar a condição verdadeira, dados ruidosos podem levar à criação de muitas
estruturas de eventos indesejadas.
Para reagir aos efeitos dos picos de dados, pode-se exigir que o disparador de início permaneça
verdadeiro em um intervalo de tempo da configuração antes de iniciar uma estrutura de
eventos. Insira um valor no campo StartTrigger verdadeiro para para especificar o intervalo de
tempo.
Quando a condição do gatilho de início é alterada para verdadeiro, o valor StartTrigger
verdadeiro para determina quanto tempo deve-se aguardar para avaliá-la novamente; se
verdadeiro, uma estrutura de eventos é iniciada. A hora de início da estrutura de eventos é a
hora em que o gatilho de início é avaliado como verdadeiro.
O valor StartTrigger verdadeiro para não tem efeito no tempo final da estrutura de eventos.
Gerenciar análises de um elemento

Ao criar uma análise, ela será adicionada a uma tabela de análise acima da expressão. Para cada
análise na tabela, pode-se ver o status atual, se ele está ou não associado a um template, seu
tipo de análise, nome e status de backfilling. Passe o mouse sobre os itens ou ícones na lista
para ver as dicas de ferramentas descritivas.
Para ver a expressão e o agendamento para análise, selecione-os na lista de análises.
Estas operações podem ser realizadas na tabela de análise:
• Criar uma nova análise

Clique no ícone Nova Análise na parte superior da tabela.
• Executar ou parar uma análise selecionada

Selecione uma análise e clique no ícone Executar ou Parar na parte superior da tabela ou
clique com o botão direito em qualquer lugar da tabela e selecione Novo.
• Visualizar resultados
É possível visualizar os resultados de uma análise para ver como ela funciona em um
intervalo de tempo específico. Clique com o botão direito do mouse em uma análise e

selecione Visualizar Resultados. Pode-se exportar a tabela de resultados para uma planilha
ou copiar as linhas selecionadas da tabela de resultados em outro aplicativo.
• Selecionar colunas a serem exibidas

Clique com o botão direito do mouse em qualquer cabeçalho da coluna na tabela de análise e
selecione os cabeçalhos a serem exibidos.
• Fazer o backfill dos dados para análise

Clique com o botão direito do mouse em uma análise e selecione Backfilling.
• Ir para template
Uma análise listada com o ícone de template é baseado em um template de análise.
Para abrir o template diretamente a partir da análise, clique com o botão direito na análise e
selecione Ir para template.
• Redefinir para template

Só é possível fazer alterações no agendamento de uma análise baseada em um template de
análise. Para ressincronizar o agendamento de um elemento com o agendamento do
template, clique com o botão direito do mouse e selecione Redefinir para Template.
• Converter para Padrão

Se o elemento de uma análise original em um template de elemento, será possível converter
a análise em um template de análise nesse template de elemento. Clique com o botão direito
do mouse na análise e selecione Converter para Padrão. Este recurso permite o
desenvolvimento e a depuração de uma análise em um elemento específico antes de
generalizá-lo como um template.
Nota:
Se qualquer uma das saídas da análise for gravado em um ponto PI específico, o
usuário será solicitado a escolher como especificar o ponto PI no template de análise
para garantir que as saídas das análises resultantes sejam gravados em pontos PI
exclusivos.
Nesta seção
• Fazer o backfill dos dados de uma análise
• Gerenciar a segurança de análises e templates de análises
Fazer o backfill dos dados de uma análise

Uma análise gera novos dados em seus atributos de saída, normalmente mapeados nos PI
Points para salvar e fazer a história dos dados.
É possível executar uma análise em um período anterior para fazer o backfill dos dados dos PI
Points mapeados em suas saídas. Em um PI Point que já tem dados de um período, exclua esses
dados antes de usar o backfill.
Procedimento
1. Na lista de análises na guia Template de Análise, clique com o botão direito do mouse na
análise em execução que se deseja usar para fazer o backfill dos dados.
2. Selecione Backfilling no menu de pop-up.
3. Especifique o período no qual deseja-se fazer o backfill dos dados.

4. Clique em OK para iniciar o backfill. A coluna Status da análise exibe um indicador de

progresso até que o backfill seja concluído.
5. Opcional: Para ver o status ou cancelar o backfill, clique com o botão direito do mouse em
uma análise e selecione Status do Backfilling.
Gerenciar a segurança de análises e templates de análises

É possível visualizar ou gerenciar permissões para limitar o acesso a análises ou templates de
análises em dois níveis:
Para uma análise única ou template de análise:
1. Na lista na guia Análises (ou Templates de Análise), clique com o botão direito do mouse na
análise (ou template de análise) e selecione Segurança.
2. Na janela Permissões, visualize ou altere grupos e permissões e clique em Ok.
Em todas as análises ou templates de análises em um banco de dados AF:
1. Clique em Banco de dados na barra de ferramentas da janela do PI System Explorer para

abrir a janela Selecionar Banco de Dados.
2. Clique com o botão direito do mouse em um banco de dados e selecione Segurança >
Análises ou Segurança > Templates de Análise.
3. Na janela Permissões, visualize ou altere grupos e permissões e clique em Ok.
Análises de amostra
As análises de amostra desta seção realizam os seguintes cálculos no mesmo banco de dados
AF:
1. Usa uma análise de tipo de expressão para monitorar o desvio da eficiência de destino do
ativo e dos processos representados pelo elemento,Etileno.
2. Cria um template para gerar um conjunto de análises de sintetização que agrega a energia
total coleta dos processos em uma refinaria. O template de elemento do qual o elemento de
cada refinaria foi criado é chamado de Refinaria.
3. Cria estruturas de eventos para capturar dados sempre que a eficiência de média de
execução de 15 minutos do elemento, Etileno, ficar abaixo de 90%.
Construir uma análise de expressão

Este exemplo mostra como criar uma análise de tipo de expressão. A análise monitora como a
eficiência de um processo é desviado de uma eficiência de destino.
Primeiro, calcula-se a eficiência média por hora, então, determina-se sua variação da eficiência
de destino.
Este exemplo usa um PI Point existente para armazenar os dados de saida (o desvio da
eficiência de destino, conforme ela varia com o tempo). Quando o usuário cria suas próprias
análises, a OSIsoft recomenda que o PI Point necessário aos dados de saída sejam criados antes
do início da criação da análise.
Procedimento
1. Em Elementos, navegue até um elemento, Etileno, do qual deseja realizar a análise.

2. Selecione a guia Análises.

3. Crie uma nova análise.
Clique em Criar nova análise ou no botão de análise .
4. Configure o Tipo de Análise para Expressão.

O tipo de análise da expressão é a mais simples, pois ela contém apenas uma ou mais
expressões e as informações de agendamento. Para obter mais informações, consulte
Análises de expressão.
5. Digite um nome para a análise no campo Nome, por exemplo, EfficiencyCalc.
6. Crie uma variável para manter o valor constante da eficiência de destino.
a. Na tabela de expressões, digite o nome Target da nova variável na coluna Nome.
b. Insira 90 na coluna Expressão. Isso define esta variável como o valor constante de 90.
7. Crie uma segunda variável para calcular a eficiência média por hora.
a. Clique em Adicionar nova expressão.
b. Nomeie a variável HourlyEfficiency.
c. Insira a seguinte sintaxe de Performance Equation na coluna Expressão:
TagAvg('Efficiency', '*-1h', '*')
Essa expressão calcula o valor médio do atributo chamado Eficiência na última hora.

8. Crie uma terceira variável para calcular o desvio da eficiência por hora da meta de 90.
a. Clique em Adicionar nova expressão.
b. Chame a variável de Deviation.
c. Insira a seguinte expressão na coluna Expressão:
HourlyEfficiency - Target
9. Salve a saída da variável, Deviation, em um PI Point.
a. Clique em Clique para mapear na coluna Atributo de saída.
b. Crie um novo atributo AF, por exemplo, chamado EfficiencyDifference.
Defina o atributo como uma referência de dados PI Point para um PI Point existente para
armazenar esses dados de saída.
10. Configure Agendamento para Periódico.

11. Clique em Configurar e especifique um período de 30 segundos. O cálculo será executado a
cada 30 segundos.
12. Para verificar se os resultados são razoáveis, clique com o botão direito do mouse na análise
e selecione Visualizar Resultados.
a. O intervalo de tempo padrão da visualização é do momento atual até a meia-noite
anterior, mas é possível inserir hora de início e tempo final diferentes, se assim for
desejado.
b. Clique em Gerar Resultados.
13. Quando estiver satisfeito com a nova análise, faça check in do trabalho.
14. Procure um círculo verde na coluna status da tabela de análises para verificar se ela está
sendo executada pelo serviço.
15. Como opção, será possível fazer o backfill dos resultados em um período, se esse intervalo
de tempo ainda não contiver dados.

É feito o backfill dos resultados no atributo de saída mapeado em uma referência de dados
PI Point na Etapa 9. Se desejado, é possível excluir os dados existentes e fazer o backfill do
intervalo de tempo.
a. Clique com o botão direito do mouse na análise na lista de análises e selecione

Backfilling.
b. Especifique uma hora de início e um tempo final para fazer o backfill.
c. Clique em Iniciar.
Criar um template para análises de sintetização

Este exemplo demonstra como criar um template para gerar um conjunto de análises de
sintetização. O template de análise agrega a todos o rascunho de energia de todos os processos
em uma refinaria.
Procedimento
1. Na Biblioteca, selecione o template de elemento do ativo a ser analisado.
Neste exemplo, o template de elemento é chamado de Refinaria. Esse é o template no qual
o elemento de cada refinaria foi criado.
2. Selecione a guia Templates de Análise.
3. Clique em Criar novo template de análise ou no botão novo template de análise .
4. Configure o Tipo de Análise para Sintetizar.

Uma análise de sintetização calcula os dados estatísticos de atributos específicos, como um
valor total ou médio. Para obter mais informações, consulte Análises de sinterização.
Um exemplo de configurações na caixa de diálogo Templates de Análise é mostrado no final
do procedimento.
5. Digite um nome para a análise no campo Nome, por exemplo, PowerRollup.
6. Clique em Selecionar um elemento de exemplo para especificar um elemento que o PI
System Explorer usa como guia para definir o template de análise. Por exemplo, na lista de
elementos originados no template Refinaria, selecione Refinaria Rotterdam e clique
em OK.
7. Em Resumir atributos de, marque Elementos filho da Refinaria Rotterdam para incluir as
informações de todos os elementos filho da refinaria.
8. Configure os atributos a serem sintetizados.
a. Insira o nome do atributo no Nome do atributo.
Pode-se usar um caractere curinga para coletar as informações dos atributos com nomes
parecidos. Por exemplo, insira a string Power* para especificar todos os atributos que
iniciam com Power. Os atributos encontrados são exibidos na tabela Atributos.
b. Selecione a categoria do atributo no campo Categoria do atributo.
c. Em Selecione as funções a serem gravadas em um atributo, selecione a função para
agregar os dados. Nesse caso, selecione Total.
d. Clique em Mapear na coluna Saída(s) e selecione Novo Padrão de Atributo.
A saída da agregação será salva nesse atributo, que pode ser definido como uma
referência de dados PI Point.
e. Use os parâmetros de substituição padrão nos campos PI Server e Nome de tag.
f. Clique em Configurações.

g. Marque Criação de tag para criar uma nova tag.

h. Clique no botão Navegador à direita do tipo do ponto e configure Point Class para
clássico e clique em OK.
i. Mantenha a configuração padrão dos outros campos e clique em OK para fechar a janela
Referência de dados do PI Point.
j. Clique em OK para fechar a janela Propriedades do Template de Atributo.
9. Clique em Avaliar e verifique se o resultado retornado na coluna Valor é razoável.
10. Configure Agendamento para Acionado por Evento.
11. Para ver os resultados dos dados recentes, clique com o botão direito do mouse na análise e
selecione Visualizar Resultados.
a. O intervalo de tempo padrão da visualização é do momento atual até a meia-noite
anterior, mas é possível inserir hora de início e tempo final diferentes.
b. Clique em Gerar Resultados.
12. Quando estiver satisfeito com o novo template de análise, faça check in do trabalho.
13. Para criar a referência de dados PI Point usada por essa análise de todas as refinarias
criadas nesse template, navegue em Elementos atéPetrolux Corporation\Downstream
\Refinarias.
a. Clique com o botão direito do mouse no elemento Refinarias e selecione Criar ou

Atualizar Referência de Dados para criar a referência de dados PI Point de saída para
cada refinaria.
b. Faça check in do trabalho.

Exemplo
Criar automaticamente estruturas de eventos para monitorar dados

No exemplo, Construir uma análise de expressão, criamos uma análise de amostra para
monitorar como a eficiência de um processo desvia-se da eficiência de destino. Neste exemplo,
criamos estruturas de eventos para capturar dados sempre que a eficiência média de execução
de 15 minutos ficar abaixo de 90%.
Procedimento
1. Na Biblioteca, abra Templates.
2. Crie um template da estrutura de eventos.
◦ Clique com o botão direito do mouse em Templates da Estrutura de Eventos e selecione
Novo Template.
◦ Ou selecione Novo Template na barra de menus.
3. Nomeie o template de EfficiencyAnomaly.
4. No campo Padrão de nomenclatura, selecione %ELEMENT% e %STARTTIME:yyyy-MM-dd
HH:mm:ss.fff%.
O campo Padrão de nomenclatura permite que você crie uma variável para o nome das
estruturas de eventos criadas com base no template,de forma que cada estrutura de eventos

terá um nome identificável e único. Você pode usar o menu suspenso para incluir strings de
substituição que são resolvidas em tempo de criação. Por exemplo, um Padrão de
Nomenclatura "EF%ELEMENT%_%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.
A string de substituição STARTTIME inclui o padrão de formatação de data e hora a ser
usado.
5. Clique na guia Templates de Atributo.

6. Crie um novo atributo de referência de dados do ponto PI usando um template de atributo.
a. Clique em Novo Template de Atributo.
b. Chame-o de Efficiency.
c. Clique em Configurações e insira a seguinte string de configuração no Nome do tag: .
\Elements[.]|Efficiency; uom=%.
Este template criará uma referência de dados de ponto PI chamada Efficiency para
cada template.
d. Defina UDM padrão como porcentagem.
7. Navegue em Elementos até encontrar o elemento, Etileno, para o qual deseja-se criar uma
análise em Construir uma análise de expressão .
O elemento está localizado em Petrolux Corporation\Petrochemicals\Maua
\Ethylene.
8. Selecione a guia Análises.
9. Clique no botão Nova Análise.
10. Chame a análise de EfficiencyAnomalyEvent.
11. Defina o Tipo de Análise como Geração da Estrutura de Eventos.
12. Defina Template da Estrutura de Eventos como EfficiencyAnomaly. Esse é o nome do
template da estrutura de eventos criada nas etapas anteriores.

13. Para StartTrigger, digite a expressão: TagAvg('Efficiency', '*-15m', '*') <90

Sempre que a eficiência média de 15 minutos ficar abaixo de 90%, uma estrutura de eventos
será criada.
14. Para EndTrigger, digite a expressão: TagAvg('Efficiency', '*-15m', '*') >92
Sempre que a eficiência média de 15 minutos for recuperada e exceder 92%, a estrutura de
eventos será encerrada.
15. Se clicar em Avaliar, cada condição da coluna Valor será preenchida com Verdadeiro ou
Falso.
16. Selecione o agendamento Periódico e clique em Configurar para definir a análise a ser
executada a cada 1 minuto.
Gerenciar análises em um banco de dados AF

(Este recurso estará disponível se a instalação do PI System Explorer incluir o plug-in
Gerenciamento de Análises.)
Clique em Análise no painel Navegador para visualizar e gerenciar as análises no banco de
dados AF atual. No painel Navegador, é possível especificar os critérios do filtro para exibir
uma tabela de análises no Visualizador. As colunas da tabela incluem:
• Status
• (Tipo de análise)

• Elemento
• Nome da análise
• Template
• Status do backfilling
Várias ações podem ser executadas nas análises na tabela:
• Filtor
Na lista suspensa Escolher um filtro, selecione um filtro (como Status). Os grupos de cada
valor do filtro (por exemplo, Em execução ou Parado) são relacionados abaixo do filtro com
uma contagem mostrando quantas análises existem em cada grupo. Selecione um grupo
para exibir as análises que correspondam a ela na tabela.
• Operações
Aplicar as operações iniciar, parar e backfill em todas as análises selecionadas na tabela.
• Detalhes da análise
Clique no botão de ativação em Detalhes da análise para ver os detalhes da análise
selecionada na tabela.
◦ Para ver um resumo da configuração e do status da análise, clique na guia Visão geral.
◦ Para ver os detalhes do erro, clique na guia Erros e Avisos.
◦ Para visualizar ou editar as análises selecionadas, clique em Configuração da Análise
para acessar a guia Análise de seus elementos associados.
Gerenciamento o Serviço de Análise do PI

(Essas opções estão disponíveis se a instalação do PI System Explorer inclui o plug-in de
Gerenciamento de Análise e você se registou através de uma conta de usuário com permissões
para configurar o Serviço de Análise de PI).
O Serviço de Análise do PI executa todas as análises no servidor PI AF atual. Duas das suas
características ajudam a gerenciar o serviço de análise:
• A janela Estatísticas do Analysis Service permite que você explore as estatísticas sobre o
serviço para monitorar suas operações. Estas estatísticas são particularmente importantes
no diagnóstico e identificação de uma solução para problemas de desempenho. Você pode
salvar estas estatísticas como um arquivo de texto, o que pode fornecer um instantâneo
detalhado de seu serviço de análise para compartilhar com o pessoal de suporte que o está
ajudando a solucionar um problema.
• A janela Configuração permite que você exiba ou modifique configurações de propriedades
do serviço de análise para ajustar o desempenho.
Exibir estatísticas do serviço de análise

Procedimento
1. Clique em Análises no painel do Navegador para exibir a área de gerenciamento de análise.
2. Clique com o botão direito do mouse em qualquer lugar no painel Operações e selecione Ver
Estatísticas do Serviço. A janela Estatísticas do Analysis Service exibe os grupos de
estatísticas que você pode usar para monitorar as operações de serviço de análise ou para
diagnosticar um problema de desempenho e identificar uma solução.

3. Opcional: Clique Atualizar para atualizar estatísticas com dados atuais.

4. Opcional: Clique Salvar para salvar estatísticas atuais como um arquivo de texto. Isso
permite que você compartilhe um instantâneo do estado atual de seu serviço de análise com
o pessoal de suporte ao cliente.
Exibir ou modificar o serviço de análise

Nota:
Alterar estas configurações pode afetar significativamente o desempenho do sistema. Se
você tiver alguma dúvida sobre como alterar as configurações padrão, entre em contato
com a equipe de suporte ao cliente para obter ajuda.
Procedimento
1. Clique em Análises no painel do Navegador para exibir a área de gerenciamento de análise.
2. Clique com o botão direito do mouse em qualquer lugar no painel Operações e selecione Ver
Estatísticas do Serviço. A janela Configuração exibe as configurações para as propriedades
do serviço de análise. Veja Configuração do Serviço de Análise para obter detalhes sobre
estas configurações.
3. Para modificar uma propriedade, edite sua configuração na coluna Configuração.
4. Clique Ok para aplicar as alterações e fechar a janela.
Configuração do serviço de análise

Você pode modificar essas configurações na janela Configuração
• AutoBackfillingEnabled
Esta propriedade preenche automaticamente as lacunas nos dados que resultam de
períodos quando o serviço de análise não está ativo. AutoBackfillingEnabled está habilitado
por padrão. Em alguns casos, isto pode não ser necessária (em um ambiente de teste, por
exemplo). Entre Falso para desativar esta propriedade.
• CacheTimeSpanInMinutes
Esta propriedade determina o período de tempo que o serviço de análise armazenaria em
cache os dados para atributos usados como entradas para os cálculos. Por padrão, o serviço
de análise iria descartar dados anteriores a 5 minutos antes da avaliação pendente mais
antiga. Uma configuração de tempo mais longa garante que quaisquer dados de entrada
necessários para cálculos estão disponíveis no cache de dados, mas ele usa mais recursos do
sistema. Para cálculos que exigem dados anteriores (por exemplo, de uma hora mais cedo),
você pode especificar um período mais longo nesta configuração para manter os dados
armazenados em cache, evitando assim chamadas para o PI Data Archive. Note que
MaxCacheEventsPerAttributes tem precedência sobre esta configuração, então ambas as
configurações podem ter que ser ajustadas simultaneamente.
• CalculationsWaitTimeInSeconds
Em vez de avaliar cálculos acionados por eventos imediatamente, você pode especificar um
período de tempo de espera antes de avaliação. Este tempo de espera pode ser usado para
compensar entradas tardias. Por exemplo, se um cálculo depende de uma interface com uma
latência conhecida de até 30 segundos, você pode ajustar esta configuração para pelo menos
30 segundos para ter certeza de que obteve o evento mais recente da interface.
Configurações mais longas reduzem a chance de falta de entradas de cálculo causadas pela
latência, mas aumentam o atraso na obtenção dos resultados do cálculo. Observe que

cálculos usam valores de entrada no timestamp do gatilho quando eles são avaliados. O
valor padrão desta propriedade é 5 segundos.
• EvaluationPartitionSize
Os cálculos são agrupados para avaliação eficiente. Análises baseadas em um template de
análise com agendamento periódico, por exemplo, são avaliadas juntas como um grupo de
cálculo. Para acelerar o tempo de avaliação, grupos de cálculo muito grandes são
particionados em subgrupos baseados na propriedade EvaluationPartitionSize; os
subgrupos são, então, avaliados em paralelo. O valor padrão para esta propriedade é 10.000.
Para um grupo de análises com longos tempos individuais, você pode querer especificar um
tamanho de partição menor. Um grupo de 100 análises, cada uma realizando cálculos para
os dados de um dia, pode avaliar mais rápido como 4 subgrupos com um tamanho de
partição de 25, dependendo dos recursos de CPU disponíveis na máquina.
• EvaluationsToQueueBeforeSkipping
Se demora muito para executar um grupo de cálculo, a fila de cálculos em espera pode se
tornar não gerenciável. Este atributo determina quando saltar cálculos para evitar o
esgotamento dos recursos. Na configuração padrão, se são encontradas mais de 50
avaliações, o serviço de análise começa a saltar as avaliações mais antigas para tentar
retomar seu processamento normal.
• IsLoadSheddingEnabled
Para algumas aplicações, acurácia e completude são críticos, e nenhum cálculo pode ser
saltado independente da demora em completá-lo. Para desabilitar o salto de cálculos, entre
Falso nesta configuração.
• IsTelemetryAllowed
Entre Falso para parar de enviar dados de uso do serviço de análise para o Programa de
Melhoria da Experiência do Cliente. (Isto não afeta a configuração correspondente para
participação no programa que você pode definir no PI System Explorer)
• MaxCacheEventsPerAttribute
Uma vez que este limite seja atingido os eventos mais antigos são eliminados do cache de
dados. Note que esta configuração tem precedência sobre CacheTimeSpanInMinutes.
• MinCacheEventsPerAttribute
A configuração padrão de 1 garante que pelo menos um evento por atributo permaneça no
cache de dados.
• NumberParallelDataPipes
Os atributos recebem atualizações de fontes de dados, incluindo o PI Data Archive, através
de canais de dados. Usar um único canal de dados para atualizar um grande número de
atributos pode levar um tempo inaceitavelmente longo. Você pode aumentar o número de
canais de dados que podem operar simultaneamente para diminuir o tempo de atualização.
Isto pode ser especialmente útil para cálculos com dados de alta frequência. Lembre-se, no
entanto, que o aumento do número de canais de dados aumenta a carga sobre o PI Data
Archive.
• Padrão para Criação Automática de PI Points de Template

Quando esta configuração estiver marcada, o serviço de análise cria automaticamente
pontos PI para atributos de saída em análises derivadas de templates de análise.

• Nome de PI Point sugerido
Você pode modificar o padrão de nomenclatura aqui com qualquer um dos parâmetros
mostrados em Lista de parâmetros de substituição do PI AF. Observe, entretanto, que alguns
parâmetros não podem ser significativos no contexto de um nome de ponto PI.
Referência de funções de expressão

As funções disponíveis para uso na expressão de análise são relacionadas em ordem alfabética.
Abs
Retorna o valor absoluto de um número inteiro ou real.
Sintaxe
Abs(x)
Argumentos
• x
Deve ser um número inteiro ou real.
Retornos
O valor absoluto de x.
Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.
Exemplo
• Abs(1)
• Abs(-2.2)
• Abs('tag1')
• Abs('tag1'- 'tag2')
Acos
Retorna a inversa de cosseno (arccos) de um número inteiro ou real. A inversa de cosseno de x
é o ângulo em radiano cujo cosseno é igual a x.
Sintaxe
Acos(x)
Argumentos
• x
Deve ser um número real entre -1,0 e 1,0, inclusive.
Retornos
A inversa de cosseno de x, em radiano.

Exceções
Se x não for um número ou for menor que -1,0 ou maior que 1,0, um valor de erro será
retornado.
Exemplo
• If 'tag1' < 1 and 'tag1' > -1 then Acos('tag1') else 0
• Acos(-.5)
• Acos(.75)
AND
Operador da conjunção lógica de duas expressões. Retorna Verdadeiro se ambas as expressões
são verdadeiras; caso contrário, retorna Falso.
Sintaxe
expression1 AND expression2
Argumentos
• expression1, expression2
Qualquer expressão avaliada como verdadeira ou falsa.
Retornos
Verdadeiro quando ambas as expressões são verdadeiras (diferentes de zero), caso contrário, é
Falso (zero).
Exceções
Nenhuma.
Exemplo
• ('tag1' > 50) AND ("overlimit" = "good")
Ascii
Retorna o código de caractere ASCII do primeiro caractere de uma string.
Sintaxe
Ascii(s)
Argumentos
• s
Qualquer expressão avaliada como uma string.
Retornos
O código de caractere do primeiro caractere da string.
Exceções
Se o argumento não for uma string, um valor de erro será retornado.

Exemplo
• Ascii( "D" ) = 68
• Ascii( string('cdm158' ) )
Asin
Retorna a inversa de seno (arcsin) de um número. A inversa de seno de x é o ângulo em radiano
cujo seno é igual a x.
Sintaxe
Asin(x)
Argumentos
• x
Deve ser um número real entre -1,0 e 1,0, inclusive.
Retornos
A inversa de seno de x, em radiano.
Exceções
Se x não for um número ou for menor que -1,0 ou maior que 1,0, um valor de erro será
retornado.
Exemplo
• Asin(TagVal('tag1','y'))
• Asin(-0.5)
• Asin('tag1')
Atn
Retorna a inversa de tangente (arctan) de um número inteiro ou real. A inversa de tangente de
x é o ângulo em radiano cuja tangente é igual a x.
Sintaxe
Atn(x)
Argumentos
• x
Retornos
A inversa de tangente de x, em radiano.
Exceções
Exemplo
• Atn(1)
• Atn(-2.2)

• Atn('tag1')
• Atn('tag1'- 'tag2')
Atn2
Retona a inversa de tangente (arctan) de um valor a/b de tangente. A inversa de tangente é o
ângulo medido em radiano de um eixo x positivo para uma linha cujos pontos de extremidade
são a origem e as coordenadas cartesianas (b, a).
Sintaxe
Atn2(a,b)
Argumentos
• a
Um número inteiro ou real.
• b
Um número inteiro diferente de zero ou real.
Retornos
A inversa de tangente em radiano de um valor a/b de tangente.
Exceções
Se a ou b não forem um número inteiro ou real, um valor de erro será retornado.
Exemplo
• Atn2('tag1', 'tag2')
• Atn2(1,1)
• Atn2(TagVal('tag1','y'),TagVal('tag1', 'y'))
Avg
Retorna a média de todos os argumentos.
Sintaxe
Avg (x1,[...])
Argumentos
• x1, [...]
Podem ser números, tempos ou períodos, mas devem ser do mesmo tipo de dados.
Retornos
A média dos argumentos. O resultado é o mesmo tipo de dados dos operandos.
Exceções
Os argumentos cujos valores de tempo de execução são strings de caracteres ou estados
digitais não inclusos na média. Se todos os valores forem strings de caracteres ou estados
digitais, Avg retornará um valor de erro.

Exemplo
• Avg(TagVal('tag1','y'),TagVal('tag2', 'y'),1,2)
A média do valor de tag1 vezes y, tag2 vezes y e os valores 1 e 2.
• Avg('y', 't', '14-Dec-97', '14 8:00')
A média dos quatro valores de tempo.
• Avg('tag1', 'tag2')
A média dos valores atuais de tag1 e tag2.
Badval
Testa um valor para ver se ele é ruim. Para pontos reais e inteiros, um valor ruim é um valor de
estado digital. Para pontos digitais, um valor ruim é um valor fora do conjunto de estados
digitais do ponto.
Sintaxe
Badval(x)
Argumentos
• x
Um valor a ser testado.
Retornos
1 se o valor for ruim
0 se o valor não for ruim
Exceções
Retorna 1 para pontos blob. Retorna 0 para strings de caracteres.
Exemplo
• BadVal('tag1')
• BadVal('digitaltag')
• BadVal(TagVal('stringtag', '14-Dec-97 8:00:00'))
Bod
Obtém o timestamp da meia-noite no início do dia.
Sintaxe
Bod(t1)
Argumentos
• t1
Uma expressão de tempo entre aspas simples.
Retornos
Timestamp para o início do dia.

Exceções
Nenhuma.
Notas
Esta função é útil para estabelecer o tempo em um relógio exclusivo, independentemente do
comprimento dos dias em particular.
Exemplo
• Bod('*')
• Bod('y')
• Bod(FindEq('tag1', '14-Dec-06', '+17d',50))
Bom
Obtém o timestamp da meia-noite no início do mês.
Sintaxe
Bom(t1)
Argumentos
• t1
Uma expressão de tempo.
Retornos
Timestamp para o início do mês.
Exceções
Nenhuma.
Notas
Exemplo
• Bom('*')
• Bom(PrevEvent('tag', '*'))
• Bom(FindEq('tag1', '14-Dec-97', '+17d',50))
Bonm
Obtém o timestamp da meia-noite no início do próximo mês.
Sintaxe
Bonm(t1)
Argumentos
• t1
Expressão de tempo entre aspas simples.

Retornos
Timestamp para o início do próximo mês.
Exceções
Nenhuma.
Notas
Exemplo
• Bonm('*')
• Bonm('y')
• Bonm(FindEq('tag1', '14-Dec-97', '+17d',50))
Ceiling
Retorna o menor número inteiro maior que ou igual a x.
Sintaxe
Ceiling(x)
Argumentos
• x
Qualquer valor numérico.
Retornos
O menor número inteiro maior que ou igual a x.
Exceções
Nenhuma.
Exemplo
• Ceiling('tag1')
• Ceiling (TagVal('tag2','14-Dec-97'))
Char
Cria uma string com base nos códigos de caracteres ASCII.
Sintaxe
Char( x1 [, ... xn] )
Argumentos
• x1, xn
Números ou expressões numéricas.

Retornos
Uma string criada com base nos códigos de caracteres.
Exceções
Se um argumento não for numérico, um erro será retornado.
Exemplo
• Char(80, 73) = "PI"
• Char(65) = "A"
• Char(6 * 9) = "6"
Compare
Compara duas strings usando caracteres curinga ("*" e "?").
Sintaxe
Compare(s1, s2 [,caseSensitive])
Argumentos
• s1, s2
Strings (s2 pode conter caracteres curinga)
• caseSensitive
Sinalizador opcional indicando se a comparação diferencia maiúsculas de minúsculas. Se
False (o padrão), a comparação não diferenciará maiúsculas de minúsculas. Se True, a
comparação diferenciará maiúsculas de minúsculas.
Retorno
1 se 1 = s2
0, caso contrário.
Exceções
Caracteres curinga em s1 são tratados literalmente e não como curingas.
Exemplo
• compare("What","what",True) = 0
• compare("b","a") = 0
• compare("What","wha?") = 1
• compare("What","wh") = 0
Concat
Concatena duas ou mais strings.
Sintaxe
Concat(s1, s2[, ... sn])
Argumentos

• s1, s2, sn
Devem ser strings de caracteres ou expressões que geram strings de caracteres.
Retornos
As strings de caracteres, concatenadas. Essa função não insere espaços vazios entre seus
argumentos. Para incluir um espaço na string concatenada, adicione um argumento que
consista de uma string que seja um espaço simples entre aspas duplas.
Nota:
Considere usar Texto que, em muitos casos, é mais geral e preciso que Concat.
Exemplo
• Concat("shut", "down") = "shutdown"
Convert
Converte um valor de sua unidade de medida (UDM) atual para uma UDM especificada; para
um valor sem UDM, atribua a UDM especificada.
Sintaxe
Convert(x, toUnit)
Argumentos
• x
Qualquer expressão que é resolvida em um valor numérico, inclusive o nome de um atributo
numérico entre aspas simples, um nome de variável ou um valor de constante.
• toUnit
A UDM resultante entre aspas duplas.
Retornos
O valor numérico convertido na UDM especificada.
Exceções
Retorna um erro se toUnit e a UDM inicial de x não estão na mesma classe UDM.
Exemplo
• Convert('MetricWeight', "lb")
• Convert('Ambient Temperature', "C")
Cos
Retorna o cosseno trigonométrico de um número inteiro ou real.
Sintaxe
Cos(x)
Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radiano.

Retornos
O cosseno de x.
Exceções
Exemplo
• Cos('tag1')
• Cos(1)
• Cos(1.1)
Cosh
Retorna o cosseno hiperbólico de um número inteiro ou real.
Sintaxe
Cosh(x)
Argumentos
• x
Retornos
O cosseno hiperbólico de x.
Exceções
Exemplo
• Cosh('tag1')
• Cosh(.9)
• Cosh(1)
Cot
Retorna a cotangente trigonométrica de um número.
Sintaxe
Cot(x)
Argumentos
• x
Retornos
A cotangente de x.

Exceções
Se x não for um número, um valor de erro será retornado.
Exemplo
• Cot('tag1')
• Cot(1)
• Cot(1.1)
Coth
Retorna a cotangente hiperbólica de um número.
Sintaxe
Coth(x)
Argumentos
• x
Retornos
A cotangente hiperbólica de x.
Exceções
Exemplo
• Coth('tag1')
• Coth(1)
• Coth(1.1)
Csc
Retorna a cossecante trigonométrica de um número.
Sintaxe
Csc(x)
Argumentos
• x
Retornos
A cossecante de x.
Exceções

Exemplo
• Csc('tag1')
• Csc(1)
• Csc(1.1)
Csch
Retorna a cossecante hiperbólica de um número.
Sintaxe
Csch(x)
Argumentos
• x
Retornos
A cossecante hiperbólica de x.
Exceções
Exemplo
• Csch('tag1')
• Csch(1)
• Csch(1.1)
Curve
Retorna o valor y de uma curva, de acordo com o valor de x.
Sintaxe
Curve( x, (x1,y1) (x2,y2) … (xn,yn) )
Argumentos
• x
Expressão avaliada como um número.
• x1, y1
O primeiro ponto na curva. xi e yi são constantes numéricas avaliadas em um tempo
compilado. O conjunto de valores de xi deve estar na ordem crescente.
Retornos
Retorna o valor y na curva correspondente ao valor de x. A interpolação linear é usada entre
pontos que definem a curva. Se o valor de x for menor que x1, y1 será retornado, e se for maior
que xn, yn será retornado. Presume-se que os pontos devem ser pedidos na direção x do menor
para o maior valor.

Exceções
Se o valor de x não for um número inteiro ou real, um valor de erro será retornado.
Exemplo
• curve('tag1', (0,100) (100,0) ) //inverter
• curve('tag3', (25,25) (75,75) ) //limiter
Day
Extrai o dia do mês de uma expressão de tempo.
Sintaxe
Day(t1)
Argumentos
• t1
Retornos
O dia do mês de um tempo, no intervalo de 1-31.
Exceções
Nenhuma.
Exemplo
• Day('*')
• Day('t')
• Day(FindGt('tag1', '*-30d', '*',50))
DaySec
Extrai o número de segundos passados desde a meia-noite de uma expressão de tempo.
Sintaxe
DaySec(t1)
Argumentos
• t1
Retornos
O número de segundos passados de um tempo desde a meia noite no intervalo de 0-86399.
Exceções
Nenhuma.

Notas
Esta função é igual à função Hora do pacote PI 2.x Performance Equation. Por exemplo, se o
tempo atual for 8h30, DaySec('*') retornará 30600.
Exemplo
• DaySec('*')
• DaySec('t')
• DaySec(FindGt('tag1', '*-30d', '*',50))
DigState
Traduz uma string de caracteres representando um estado digital em seu estado digital
correspondente.
Sintaxe
DigState(s1 [, x])
Argumentos
• s1
Uma string de caracteres representando um estado digital.
• x
(Opcional) Um ponto digital no qual a string de caracteres representa um estado digital. Se
omitido, todos os conjuntos de estados digitais, iniciando com o conjunto digital do sistema,
são pesquisados para encontrar a string determinada.
Retornos
Um valor de enumeração. (Para cálculos PI PE, um estado digital é retornado.)
Exceções
Se a string de caracteres não representar um estado digital no conjunto de estados digitais do
ponto digital especificado, a função retornará Falha no cálculo. Se o ponto digital for omitido, e
a string de caracteres não representar um estado digital em qualquer um dos conjuntos
digitais, a mensagem Falha no cálculo será retornada.
Exemplo
• DigState("digitalstring", 'digitaltag')
• StateNo(DigState("digitalstring", 'digitaltag'))
DigText
Obtém o texto correspondente ao estado digital.
Sintaxe
DigText(digstate)
Argumentos
• digstate
Um argumento que é resolvido para um estado digital.

Retornos
O texto para o estado digital.
Exceções
Se o argumento não for uma string digital, uma condição de erro será retornada.
Exemplo
• DigText('digitaltag')
• DigText(TagVal('digitaltag','y') )
• DigText('nondigitaltag') would fail with an error message
E
Retorna o valor de e (a base do logaritmo natural).
Sintaxe
E()
Argumentos
Nenhum.
Retornos
O valor de e (a base do logaritmo natural).
Exceções
Nenhuma.
Exemplo
• E()
ELSE
Retorna o segundo de dois valores especificados quando uma expressão condicional IF-THEN-
ELSE é Falsa.
Sintaxe
IF (expression) THEN (x) ELSE (y)
Argumentos
• expression
Qualquer expressão avaliada como Verdadeira ou Falsa.
• x, y
Uma expressão avaliada como um valor resultante.
Retornos
O x resultante quando a expressão condicional é Verdadeira (diferente de zero), o y resultante
quando a expressão é Falsa (zero).

Exceções
Nenhuma.
Exemplo
• IF ('tag1' > 50) THEN ('tag2') ELSE ('tag3')
EventCount
Encontra o número de eventos PI Data Archive para um ponto em um intervalo de tempo
específico.
Sintaxe
EventCount(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
Um nome de tag entre aspas simples. Este ponto deve representar uma variável contínua.
• starttime
Uma expressão de tempo representando o início do intervalo de tempo a ser pesquisado.
• endtime
Uma expressão de tempo posterior a starttime; o término do intervalo de tempo a ser
pesquisado.
CUIDADO:
Evite usar tempo futuro no endtime. O intervalo de tempo contendo eventos futuros
não arquivados pode gerar resultados incorretos para a contagem de eventos.
• pctgood
Opcional. A porcentagem de tempo mínima em um intervalo de tempo específico indicando
que os valores arquivados do ponto devem ser bons.
Retornos
Número de eventos do PI Data Archive do ponto no intervalo de tempo especificado.
Exceções
Se o ponto não tiver valores bons ou a pctgood mínima não for alcançada para o intervalo de
tempo especificado, um valor de erro será retornado.
Exemplo
• EventCount('tag1', 'y', '*')
• EventCount('tag1', '14-Dec-97', '+1d',70)
• EventCount('tag1', '14-Dec-97', '15-Dec-97')
Exp
Retorna o exponencial de um número inteiro ou real. Este é o número ex, em que e =
2,7182818...

Sintaxe
Exp(x)
Argumentos
• x
Retornos
O exponencial de x.
Exceções
Exemplo
• Exp('tag1')
• Exp(TagVal('tag1','14-Dec-97'))
• Exp(11)
FindEq
Encontra o primeiro tempo, em um intervalo, quando um ponto é igual a determinado valor.
Sintaxe
FindEq(tagname, starttime, endtime, value)
Argumento
• tagname
O nome de um atributo entre aspas simples.
• starttime
Uma expressão de tempo representando o início do intervalo de tempo para pesquisar
Tempos relativos estará relacionada a um tempo final se este não for um tempo relativo.
• endtime
Uma expressão de tempo representando o término do intervalo de tempo a ser pesquisado.
Tempos relativos são relativos à hora de início, caso esta não seja uma expressão relativa. Se
o tempo final for anterior à hora de início, o intervalo será pesquisado de trás para frente.
• value
Deve ser um número inteiro ou real ou um estado digital (string de caractere), o valor a ser
pesquisado.
Retornos
O timestamp mais próximo à hora de início, dentro do intervalo especificado, no qual o ponto
era igual ao valor especificado.
Exceções
Se o ponto nunca tiver sido igual ao valor especificado, FindEq retornará um valor de erro.

Notas
FindEq faz a interpolação entre eventos Archive, se necessário, para encontrar o valor que está
procurando.
Exemplo
• FindEq('tag1', 't', '*',40.0)
• FindEq('digitaltag', '-1d', '*', TagVal('digitaltag', '14-Dec-97'))
• FindEq('digitaltag', '14-Dec-97', '*', "On")
FindGE
Encontra o primeiro ou o último tempo, em um intervalo, quando um ponto é maior que ou
igual a determinado valor.
Sintaxe
FindGE(tagname, starttime, endtime, value)
Argumentos
• tagname
O nome de um atributo com uma referência de dados PI Point entre aspas simples.
• starttime
Uma expressão de tempo representando o início do intervalo de tempo a ser pesquisado ou
um tempo relativo ao tempo final, caso este seja um tempo.
• endtime
Uma expressão de tempo representando o término do intervalo de tempo ou tempo (em
segundos) relativo à hora de início, caso esta seja um tempo. Se o tempo final for anterior à
hora de início, o intervalo será pesquisado de trás para frente.
• value
pesquisado.
Retornos
era maior que ou igual ao valor especificado.
Exceções
Se o ponto sempre tiver sido menor que valor especificado, FindGE retornará um valor de erro.
Notas
FindGE faz a interpolação entre eventos Archive, se necessário, para encontrar o valor que está
procurando.
Exemplo
• FindGE('tag1', 't', '*',40.0)
• FindGE('digitaltag', '-1d', '*', TagVal('digitaltag', '14-Dec-97'))
• FindGE('tag1', '-1d', '*','tag2')

FindGT
Encontra o primeiro tempo, em um intervalo, quando um ponto é maior que determinado
valor.
Sintaxe
FindGT(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
Uma expressão de tempo representando o início do intervalo de tempo a ser pesquisado.
Pode ser um tempo relativo ao tempo final, caso este seja um tempo.
• endtime
Término do intervalo de tempo a ser pesquisado, tempo (em segundos) ou expressão de
tempo relativo à hora de início, caso esta seja um tempo. Se este tempo for anterior à hora
de início, o intervalo será pesquisado de trás para frente.
• value
pesquisado.
Retornos
era maior que o valor especificado.
Exceções
Se o ponto nunca tiver sido maior que o valor especificado, FindGT retornará um valor de erro.
Notas
FindGT faz a interpolação entre eventos Archive, se necessário, para encontrar o valor que está
procurando.
Exemplo
• FindGT('tag1', 't', '*',40.0)
• FindGT('tag1', '-1d', '*',40.0)
• FindGT('digitaltag', '-1d', '*', TagVal('digitaltag', 'y'))
FindLE
Encontra o primeiro tempo, em um intervalo, quando um ponto é menor que ou igual a
determinado valor.
Sintaxe
FindLE(tagname, starttime, endtime, value)
Argumentos

• tagname
• starttime
Início do intervalo de tempo a ser pesquisado; expressão de tempo ou tempo relativo ao
tempo final, caso este seja um tempo.
• endtime
Término do intervalo de tempo a ser pesquisado, timestamp ou tempo (em segundos)
relativo à hora de início, caso esta seja um tempo. Se este tempo for anterior à hora de início,
o intervalo será pesquisado de trás para frente.
• value
pesquisado.
Retornos
era menor que ou igual ao valor especificado.
Exceções
Se o ponto sempre tiver sido maior que valor especificado, FindLE retornará um valor de erro.
Notas
FindLE faz a interpolação entre eventos Archive, se necessário, para encontrar o valor que está
procurando.
Exemplo
• FindLE('tag1', 't', '*',40.0)
• FindLE('tag1', -3600, '*',40.0)
• FindLE('tag1', 'Saturday', '*',40.0)
FindLT
Encontra o primeiro tempo, em um intervalo, quando um ponto é menor que determinado
valor.
Sintaxe
FindLT(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
tempo final, caso este seja um tempo.

• endtime
Término do intervalo de tempo a ser pesquisado, expressão de tempo ou tempo (em
segundos) relativo à hora de início, caso esta seja um tempo. Se este tempo for anterior à
• value
pesquisado.
Retornos
era menor que o valor especificado.
Exceções
Se o ponto nunca tiver sido menor que o valor especificado, FindLT retornará um valor de erro.
Notas
FindLT faz a interpolação entre eventos Archive, se necessário, para encontrar o valor que está
procurando.
Exemplo
• FindLT('tag1', 't', 3600,40.0)
• FindLT('tag1', -1h, '*',40.0)
• FindLT('tag1', '14-Dec-97 01:00:00.0001, '*',40.0)
FindNE
Encontra o primeiro tempo, em um intervalo, quando um ponto é diferente de determinado
valor.
Sintaxe
FindNE(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
tempo final, caso este seja um timestamp.
• endtime
Término do intervalo de tempo a ser pesquisado, expressão de tempo ou tempo (em
segundos) relativo à hora de início, caso esta seja um tempo. Se este tempo for anterior à
• value
pesquisado.

Retornos
era diferente do valor especificado.
Exceções
Se o ponto sempre tiver sido igual ao valor especificado, FindEq retornará um valor de erro.
Exemplo
• FindNE('tag1', 'y', '*',40.0)
• FindNE('tag1', '14-Dec-97', '*',40.0)
• FindNE('tag1', '14-Dec-97', 'Monday',40.0)
Float
Converte uma string em um número.
Sintaxe
Float(x)
Argumentos
• x
Uma string ou um número.
Retornos
Um número de uma string numérica e uma mensagem Falha no cálculo de uma string não
numérica. Se x já for um número, x será retornado.
Exemplo
• Float(12.3) = 12.3
• Float('sinusoid')
• Float("-12.3") = -12.3
Floor
Retorna o maior número interior que não seja maior que x.
Sintaxe
Floor(x)
Argumentos
• x
Retornos
O maior inteiro que não é maior que x.
Exceções
Nenhuma.

Exemplo
• Floor('tag1')
• Floor (TagVal('tag2','14-Dec-97'))
Format
Converte um número em string, de acordo com uma expressão de formato.
Sintaxe
Format(x, format [,numType ])
Argumentos
• x
Um valor numérico (real ou inteiro).
• format
String que controla o formato. É o mesmo usado pela função Sprintf de linguagem C.
• numType
Opcional. Caractere indicando o tipo numérico, R(eal) ou I(nteiro). O padrão é R.
Retornos
Uma string formatada.
Exemplo
• Format('sinusoid', "%3.3f", "R") = "66.890"
• Format(45, "%3.3d") = "045"
• Format(45, "%3.3d", "I") = "045"
• Format(45, "%3.3d", "R") = "000" (Don't do this!)
Frac
Retorna a parte fracionada de um número real. Retorna 0 para inteiros.
Sintaxe
Frac(x)
Argumentos
• x
Retornos
A parte fracionada de x.
Exceções

Notas
Por definição: Int(x) + Frac(x) = x.
Exemplo
• Frac('tag1')
• Frac(1.1)
• Frac(TagVal('tag1', '14-Dec97'))
Hour
Extrai a hora de uma expressão de tempo.
Sintaxe
Hour(t1)
Argumentos
• t1
Retornos
A hora do tempo, no intervalo de 0-23.
Exceções
Nenhuma.
Exemplo
• Hour('*')
• Hour('Saturday')
• Hour('t')
IF
Apresenta a condição para uma expressão IF-THEN-ELSE. Esse tipo de expressão retorna o
primeiro de dois valores especificados quando uma condição é Verdadeira, e o segundo valor
quando ela é Falsa.
Sintaxe
Argumentos
• expression
Qualquer expressão avaliada como Verdadeira ou Falsa.
• x, y

Retornos
Exceções
Nenhuma.
Exemplo
InStr
Determina o local em uma string na qual uma correspondência de substring é a primeira
encontrada.
Sintaxe
InStr([start,] s1, s2 [,caseSensitive])
Argumentos
• start
Opcional. Um número inteiro que especifica qual caractere em s1 para iniciar a comparação.
Deve ser maior que ou igual a 1.
• s1, s2
Duas strings e/ou pontos com tipos de pontos de string a serem comparados.
• caseSensitive
Sinalizador opcional indicando se a comparação diferencia letras maiúsculas de minúsculas.
Se 0 (o padrão), a comparação não diferencia maiúsculas de minúsculas; se 1, a comparação
diferencia maiúsculas de minúsculas.
Retornos
0 se s2 não for uma substring de s1 iniciando da posição de início; caso contrário, o local do
caractere em que s2 corresponde primeiro os caracteres em s1 da posição de início.
Exceções
Caracteres curingas não são tratados como caracteres.
Exemplo
• InStr("What", "At") = 3
• InStr("What What What", "What") = 1
• InStr("what", "At", 1) = 0
• InStr(4,"what","At") = 0
• InStr('StringTag', "Error") = 1 (if the tag value for 'stringtag' is "Error")
• InStr('StringTag',"StringTag") = 0 (if the tag value for 'stringtag' is
"Error")

IN
O operador In retornará Verdadeiro se um valor estiver incluso em um conjunto ou intervalo
de valores; caso contrário, retornará Falso.
Sintaxe
value In (x, y)
value In .. x1, x2, x3...xn
Argumentos
• value
Qualquer valor numérico, string, tempo ou intervalo de tempo.
• x
Tempo ou valor numérico indicando o início de um intervalo.
• y
Tempo ou valor numérico indicando o término de um intervalo.
• x1, x2, x3, ... xn

Um conjunto de valores numéricos, tempos ou intervalos de tempos.
Retornos
Verdadeiro quando value está no intervalo ou conjunto de outros valores. Caso contrário,
retorna Falso.
Exceções
Nenhuma.
Exemplo
• ('tag1') In ("1", "10")
• '+1h' In ('+1d', '+1s')
Int
Retorna a parte inteira de um número inteiro ou real.
Sintaxe
Int(x)
Argumentos
• x
Um número ou string.
Retornos
A parte inteira de x. Se x for uma string, será o primeiro a ser convertido em um número.
Exceções
Se x não for um número ou uma string numérica, retornará Calc Failed.

Exemplo
• Int('tag1')
• Int(1)
• Int(2.1)
• Int("2.1")
IsSet
Determina se um PI Value é anotado, substituído ou questionável.
Sintaxe
IsSet(x, select)
Argumentos
• x
Qualquer valor. Pode ser um número inteiro ou real, um estado digital ou uma string de
caractere.
• select
Uma string, mas apenas o primeiro caractere é considerado. "a" para anotado; "s" para
substituído e "q" para questionável. Não diferencia maiúsculas de minúsculas.
Retornos
1 se verdadeiro, e 0 se falso.
Exceções
Nenhuma.
Exemplo
• IsSet('sinusoid', "a")
• IsSet('sinusoid', "annotated")
• IsSet('sinusoid', "annotatted is mispelled")
• IsSet('stringtag',"annotatiiion is mispelled but it does not matter.")
• IsSet('stringtag',"A")
• IsSet('alarmtag1',"q")
• IsSet('stringtag',"s")
LCase
Converte uma string em uma string em caixa baixa.
Sintaxe
LCase(s)
Argumentos
• s
Deve ser uma string.

Retornos
Uma string convertida em caixa baixa.
Exceções
Exemplo
• LCase("Stringtag") = "stringtag"
• LCase('Stringtag') = "error" if the Snapshot value for the stringtag equals
"Error"
Left
Determina um número especificado de caracteres de uma string começando da esquerda.
Sintaxe
Left(s, len)
Argumentos
• s
Uma string.
• len
Um número inteiro.
Retornos
Os primeiros caracteres len da string, começando pela esquerda.
Exceções
Se os argumentos não forem dos tipos solicitados, um erro será retornado.
Exemplo
• Left("Stringtag", 3) = "Str"
• Left('Stringtag', 3) = "Err" if the Snapshot value for the stringtag equals
"Error"
Len
Determina o comprimento de uma string.
Sintaxe
Len(s)
Argumentos
• s
Uma string.
Retornos
O comprimento de uma string.

Exceções
Exemplo
• Len("Stringtag") = 9
• Len('Stringtag') = 5 if the Snapshot value for the stringtag equals "Error"
Log
Retorna o logaritmo natural (base e = 2,7182818...) de um número inteiro ou real.
Sintaxe
Log(x)
Argumentos
• x
Deve ser um número inteiro ou real maior que zero.
Retornos
O logaritmo natural de x.
Exceções
Se x for zero ou um número negativo ou não for um número, um valor de erro será retornado.
Exemplo
• Log('*')
• Log(14)
• Log(TagVal('tag1', '14-Dec-97'))
Log10
Retorna o logaritmo de base 10 de um número inteiro ou real.
Sintaxe
Log10(x)
Argumentos
• x
Retornos
O logaritmo de base 10 de x.
Exceções/Erros

Exemplo
• Log10('*')
• Log10(14)
• Log10(TagVal('tag1', '14-Dec-97'))
Logbase
O logaritmo de um valor numérico positivo (x) para uma base especificada (y).
Sintaxe
Logbase(x,y)
Argumentos
• x
• y
Um número inteiro positivo indicando a base do logaritmo.
Retornos
O logaritmo de x para base y.
Exceções
Exemplo
• Logbase(272, 2)
• Logbase(1000,16)
• Logbase(TagVal('tag1', '14-Dec-97'),16)
LTrim
Remove os espaços à esquerda de uma string.
Sintaxe
LTrim(s)
Argumentos
• s
Uma string.
Retornos
Uma string com espaços à esquerda removidos.
Exceções
Se s não for uma string, um valor de erro será retornado.

Exemplo
• LTrim(" Stringtag") = "Stringtag"
• LTrim("Stringtag ") = "Stringtag "
• LTrim('Stringtag') = "Error" if the Snapshot value for the stringtag equals "
Error"
Max
Retorna o número máximo de um conjunto de valores.
Sintaxe
Max(x1, x2, ..., xn)
Argumentos
• x1...xn
Podem ser números, tempos ou períodos, mas todos devem ser do mesmo tipo.
Retornos
O valor máximo dos argumentos. O resultado tem o mesmo tipo de dados dos argumentos.
Exceções
Argumentos, cujos valores de tempo de execução são estados digitais, são ignorados. Se todos
os valores forem estados digitais, Max retornará um valor de erro.
Exemplo
• Max('*', 'y', 'Saturday')
• Max(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
• Max('*'-'*-h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Median
Retorna o valor médio (meio) de um conjunto de três ou mais valores.
Sintaxe
Median(x1, x2, x3, [... xn])
Argumentos
• x1, x2, x3, [... xn]
Todos os argumentos devem ser do mesmo tipo. Insira pelo menos três argumentos, todos
do mesmo tipo de dados (números inteiros e reais, tempos e períodos)
Retornos
O valor médio dos argumentos de entrada. Se o número de argumentos for par, a média dos
dois valores do meio será retornada.
Exceções
Argumentos, cujos valores de tempo de execução são estados digitais, são ignorados. A função
deve ser maior que dois argumentos avaliados como estados não digitais; caso contrário,
Median retornará um valor de erro.

Notas
Median permite que números inteiros e tipos de dados sejam misturados. Median segue o tipo
de dados do primeiro argumento. Portanto, se o primeiro argumento for um ponto avaliado
para um número inteiro, então, todas as outras entradas serão convertidas em números
inteiros pelo truncamento (não em volta).
Exemplo
• Median('*', 'y', 'Saturday')
Encontre a média destes timestamps: agora, 0h de ontem e 0h do último sábado.
• Median(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
Encontre a média destes valores: 14, o valor atual de tag1, 14,5, e o valor de tag2 à meia-
noite de 14 de dezembro de 1997.
• Median('*'-'*-1h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Encontre a média destas durações de tempo: de 1 hora atrás até agora, da 0h de ontem à 0h
de hoje e o tempo total de tag1 era igual a 50 entre a 0h de ontem e 0h de hoje.
Mid
Retorna uma substring em uma string.
Sintaxe
Mid(s, start [,len])
Argumentos
• s
Uma string.
• start
Um número inteiro que especifica a posição do primeiro caractere na string. O primeiro
caractere na string é o número 1.
• len
Opcional. O comprimento máximo da string retornada. O padrão é o comprimento da string.
Retornos
len caracteres da string à direita (e incluídos) do primeiro caractere cuja posição é especificada
pelo início.
Exceções
Se os argumentos não forem dos tipos solicitados, um valor de erro será retornado. O número
máximo de caracteres que podem ser retornados é 999.
Exemplo
• Mid("Stringtag", 3) = "ringtag"
• Mid("Stringtag", 3, 2) = "ri"
• Mid('Stringtag', 1, 1) = "E" if the Snapshot value for the stringtag equals
"Error"

Min
Retorna o número mínimo de um conjunto de valores.
Sintaxe
Min(x1, ..., xn)
Argumentos
• x1...xn
Podem ser números, tempos ou períodos, mas todos devem ser do mesmo tipo de dados.
Retornos
O mínimo dos argumentos. O resultado tem o mesmo tipo de dados dos argumentos.
Exceções
os valores forem estados digitais, Min retornará um valor de erro.
Exemplo
• Min('*', 'y', 'Saturday')
• Min(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
• Min('*'-'*-1h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Minute
Extrai o minuto de uma expressão de tempo.
Sintaxe
Minute(t1)
Argumentos
• t1
Retornos
O minuto do tempo, no intervalo de 0-59.
Exceções
Nenhuma.
Exemplo
• Minute('*')
• Minute('1')
• Minute('*-1h')

Mod
O operador módulo (mod) retorna o lembrete do quociente de dois valores numéricos. Em A
mod B, é o lembrete de A/B .
Sintaxe
x mod y
Argumentos
•
Retornos
Exceções
Nenhuma.
Exemplo
• 'att1' mod 7
Month
Extrai o mês de uma expressão de tempo.
Sintaxe
Month(t1)
Argumentos
• t1
Retornos
O mês do tempo, no intervalo de 1-12.
Exceções
Nenhuma.
Exemplo
• Month('*')
• Month('1')
• Month('*-1h')
NextEvent
Encontra o tempo do próximo evento Archive do ponto após determinado tempo.
Sintaxe
NextEvent(tagname, time)
Argumentos

• tagname
• time
Retornos
O timestamp do próximo evento Archive do nome de tag após o tempo.
Exceções
Se o ponto não tiver dados Archive após o tempo, um valor de erro será retornado.
Exemplo
• NextEvent('tag1','*')
• NextEvent('digitaltag', '*')
NextVal
Encontra o valor do próximo evento Archive do ponto após determinado tempo.
Sintaxe
NextVal(tagname, time)
Argumentos
• tagname
• time
Retornos
O valor do próximo evento Archive do nome de tag após o tempo.
Exceções
Se o ponto não tiver dados Archive após o tempo, um valor de erro será retornado.
Exemplo
• NextVal('tag1','*-1h')
• NextVal('digitaltag', '14-Dec-97')
Noon
Retorna um timestamp para o meio-dia do dia de determinada expressão de tempo.
Sintaxe
Noon(t1)
Argumentos
• t1
Uma expressão de tempo entre aspas.

Retornos
Um timestamp que corresponda ao meio-dia do dia do tempo de entrada.
Exceções
Nenhuma.
Notas
Exemplo
• Noon('*')
• Noon('14-Dec-97')
NoOutput
Não grava o resultado do cálculo atual.
Sintaxe
NoOutput()
Argumentos
Nenhum.
Notas
É importante incluir os parênteses após essa função (use NoOutput() em vez de NoOutput, já
que NoOutput é uma sintaxe inválida). Essa função é aplicada apenas no cálculo atual. O
resultado dessa função em pipetest.exe é "NoOutput() Called".
Exemplo
• If 'PITag' < 100 or 'PItag' > 0 then 'PITag' else NoOutput()
Normalrnd
Retorna um número aleatório que mapeia a curva de distribuição normal usando um
significado e um desvio padrão especificados.
Sintaxe
Normalrnd(x, y)
Argumentos
• x
Um número real que especifica o resultado da curva de distribuição normal.
• y
Um número real que especifica o desvio padrão da curva de distribuição normal.
Retornos
Um número aleatório que mapeia a curva de distribuição normal usando um significado e um
desvio padrão especificados.

Exceções
Nenhuma.
Exemplo
• Normalrnd(300, 2.5)
NOT
O operador NOT retorna a negação de uma expressão. Verdadeiro para uma expressão falsa, e
Falso para uma expressão verdadeira.
Sintaxe
NOT expression
Argumentos
• expression
Qualquer expressão que seja avaliada como verdadeira ou falsa.
Retornos
Verdadeiro quando expression é falsa, e Falso quando expression é verdadeira.
Exceções
Nenhuma.
Exemplo
• NOT ('tag1') In ("1", "10")
OR
Operador da disjunção lógica de duas expressões que retorna Verdadeiro se as expressões são
verdadeiras, e Falso, se elas são falsas.
Sintaxe
expression1 OR expression2
Argumentos
• expression1 expression2
Qualquer expressão avaliada como verdadeira ou falsa.
Retornos
Verdadeiro quando expression1 ou expression2 são verdadeiras (diferente de zero); Falso
(zero) quando ambas são falsas.
Exceções
Nenhuma.
Exemplo
• ('tag1' > 50) OR ("overlimit" = "good")

ParseTime
Traduz uma expressão de tempo PI para um timestamp.
Sintaxe
ParseTime(s1)
Argumentos
• s1
Deve ser uma string de caracteres no formato tempo PI entre aspas duplas.
Retornos
O timestamp correspondente a s1.
Exceções
Se s1 não for uma string de caractere, ou se não houver um erro de sintaxe, um valor de erro
será retornado.
Notas
Não há diferença entre ParseTime("14-Nov-92") e a expressão de tempo '14-Nov-92',
exceto que a chamada ParseTime é mais demorada. Isso ocorre porque a expressão de tempo
(entre aspas simples) é avaliada no tempo de compilação, não no tempo de execução.
Se ParseTime('14-Nov-92') (entre aspas simples, não duplas) for gravada, o analisador
detectará um erro, pois a expressão entre aspas simples já está traduzida par um timestamp no
tempo de compilação.
A expressão ParseTime(":12:00:00") é diferente da expressão de tempo ':12:00:00'. A
expressão ParseTime é avaliada no tempo de execução e traduzida usando '*' como base de
tempo relativo, enquanto a expressão de tempo é avaliada no tempo de compilação e usa o
tempo em que a expressão é analisada na base de tempo relativo.
Exemplo
• ParseTime("14-Dec-97")
• ParseTime("t")
PctGood
Encontra o percentual de tempo, em determinado intervalo, quando os valores arquivados de
um ponto forem bons.
Sintaxe
PctGood(tagname, starttime, endtime)
Argumentos
• tagname
Um nome de tag.
• starttime
Deve ser uma expressão de tempo, o início do intervalo de tempo a ser pesquisado.

• endtime
Deve ser uma expressão de tempo, maior que starttime; o término do intervalo de tempo a
ser pesquisado.
Retornos
Um número inteiro ou real de 0,0 a 100,0: o percentual de determinado tempo quando o ponto
não tem valores bons.
Exemplo
• PctGood('tag1', 'y','*')
• PctGood('tag1', '-1h', '*')
Pi
Retona o valor do pi.
Sintaxe
Pi()
Argumentos
•
Retornos
O valor do pi
Exceções
Nenhuma.
Exemplo
• Pi()
Poly
Avalia o polinômio c0 + c1x + c2x2 + … +cnxn.
Sintaxe
Poly(x, c0, ..., cn)
Argumentos
• x
A variável. Deve ser um número inteiro ou real.
• c0...cn
Os coeficientes. Deve ter pelo menos um coeficiente. Todos devem ser números.
Retornos
O valor do polinômio.

Exceções
Se x ou qualquer coeficiente não forem um número inteiro ou real, Poly retornará um valor de
erro.
Exemplo
• Poly('tag1',1,1)
Pow
Retorna x elevado à potência y.
Sintaxe
Pow(x,y)
Argumentos
• x
• y
Retornos
O valor de x elevado à potência y.
Exceções
Nenhuma
Exemplo
• Pow(400, 2)
• Pow(100.15,16)
• Pow(TagVal('tag1', '*'),8)
PrevEvent
Encontra o tempo do evento Archive anterior do ponto antes de determinado tempo.
Sintaxe
PrevEvent(tagname, time)
Argumentos
• tagname
• time
Retornos
O timestamp do evento Archive anterior do nome de tag antes do tempo.

Exceções
Se o ponto não tiver dados Archive antes do tempo, um valor de erro será retornado.
Exemplo
• PrevEvent('tag1', '*')
• PrevEvent('tag1','14-Dec-97')
PrevVal
Encontra o valor do evento Archive anterior do ponto antes de determinado tempo.
Sintaxe
PrevVal(tagname, time)
Argumentos
• tagname
• time
Retornos
O valor do evento Archive anterior do nome de tag antes do tempo.
Exceções
Se o ponto não tiver dados Archive antes do tempo, um valor de erro será retornado.
Exemplo
• PrevVal('tag1', '*')
• PrevVal('tag1','14-Dec-97')
PStDev
Retorna o desvio padrão da amostra — o desvio padrão de dois ou mais valores que constituem
toda a população. O desvio padrão de uma população x1...xn é
,
em que é o significado dos argumentos, ou seja,

Sintaxe
PStDev(x1, x2, ..., xn)
Argumentos
• x1...xn
Podem ser números ou expressões de tempo, mas todos devem ser do mesmo tipo.
Retornos
O desvio padrão dos argumentos. Se os argumentos forem números, o resultado será um
número, se forem tempos ou períodos, o resultado será um período.
Exceções
os valores forem estados digitais, PStDev retornará um valor de erro.
Notas
Na maioria dos caso, deve-se usar Sstdev, em vez de PstDev. Sstdev calcula o desvio padrão de
uma amostra.
Exemplo
• PStDev('tag1', 'tag2')
• PStDev('*','14-Dec-97', 'y')
• PStDev('*'-'y','14-Dec-97'-'*', '-1h')
Rand
Retorna um número aleatório entre 0 e 1,0. Para os valores x e y especificados, retorna um
número aleatório entre x - y/2 e x + y/2 .
Sintaxe
Rand(x, y)
Argumentos
• x
Um número real especificando o ponto central do intervalo.
• y
Um número real especificando o tamanho do intervalo.
Se nenhum argumento for especificado, o intervalo padrão será de 0 a 1,0.
Retornos
Um número aleatório entre 0 e 1,0. Para os valores x e y especificados, retorna um número
aleatório entre x - y/2 e x + y/2 .
Exceções
Nenhuma.

Exemplo
• Rand()
• Rand(500, 250)
Range
Encontra a diferença entre os valores máximo e mínimo de um ponto durante determinado
tempo, de acordo com os valores armazenados no PI Archive.
Sintaxe
Range(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
Um nome de tag. Esse ponto deve representar uma variável contínua.
• starttime
Deve ser uma expressão de tempo, o início do intervalo de tempo a ser pesquisado.
• endtime
Deve ser uma expressão de tempo maior que a hora de início; o término da expressão de
tempo a ser pesquisada.
• pctgood
Retornos
A diferença entre os valores máximo e mínimo do ponto em determinado tempo.
Exceções
Notas
CUIDADO:
Os estados digitais OverRangeStat e UnderRangeStat não são considerados no cálculo
desse valor.
Exemplo
• Range('tag1', 'y', '*')
• Range('tag1','-1h', 'y')
• Range('tag1','y', '+1h',70)
Remainder
Retorna o lembrete resultante da divisão de x por y usando o método IEEERemainder. Esse
lembrete é igual a x - (y Q), em que Q é o coeficiente de x / y arredondado para o número

inteiro mais próximo (se x / y estiver na metade de dois números inteiros, o inteiro par será
retornado). Se x - (y Q) for zero, o valor +0 será retornado se x for positivo, ou -0 ou se x for
negativo. Se y = 0, NaN (não numérico) for retornado.
Sintaxe
Remainder(x, y)
Argumentos
• x
• y
Retornos
Retorna o lembrete resultante da divisão de x por y usando o método IEEERemainder.
Nota:
Não é igual ao lembrete retornado usando o operador Mod (modulus).
Exceções
Nenhuma
Exemplo
• Remainder(11,3)
Retorna -1
• Remainder(10,3)
Retorna +1
Right
Determina um número especificado de caracteres de uma string começando da direita.
Sintaxe
Right(str, len)
Argumentos
• s
Uma string.
• len
Um número inteiro.
Retorna
len caracteres da string à direita.
Exceções
Se os argumentos não forem dos tipos solicitados, um valor de erro será retornado.

Exemplo
• Right("Stringtag", 3) = "tag"
• Right('Stringtag', 4) = "rror" if the Snapshot value for the stringtag equals
"Error"
• Right("Stringtag", 20) = "Stringtag"
Round
Arredonda um número ou tempo para a unidade mais próxima.
Sintaxe
Round(x [, unit])
Argumentos
• x
Deve ser um número inteiro ou real ou uma expressão de tempo.
• unit
Opcional. O tamanho da unidade a ser arredondado. Se x for um número, a unidade deverá
ser um número. Se x for uma expressão de tempo ou um período, a unidade deverá ser um
período. Se a unidade for omitida, Round arredondará para o próximo número inteiro (para
número) ou segundo (para período).
Retornos
O valor mais próximo a x que seja um número inteiro múltiplo da unidade. Retorna o mesmo
tipo de dados de x. Para obter mais detalhes, consulte os exemplos a seguir.
Exceções
Se x for uma string, ou se o tipo de dados da unidade estiver incorreto, um valor de erro será
retornado.
Notas
Se x for um tempo, e a unidade for omitida, essa rotina não será efetiva: a precisão dos tempos
é de apenas 1 segundo.
Exemplo
• Round(12.499)
Arredonda para o número inteiro mais próximo (12,0)
• Round(12.5)
Metade de uma unidade é arredondada (13,0)
• Round(12.8, 10)
Arredonda para a dezena mais próxima (10,0)
• Round('14-Dec-97 11:47, '+1h')
Timestamp arredondado para a hora mais próxima (14-dez-97 12:00)
• Round('18:47' -'15:00','+1h')
Período medido em segundos arredondada para a hora mais próxima (10800)

Nota:
Arredonda para os resultados do dia mais próximo no timestamp do dia mais próximo em
tempo UTC, não local.
Roundfrac
Arredonda um valor numérico x para y casas decimais.
Sintaxe
Roundfrac(x, y)
Argumentos
• x
Deve ser um número inteiro ou real ou uma expressão de tempo.
• y
O número inteiro que especifica o número de casas decimais a serem usadas para
arredondar x.
Retorna
O valor de x arredondado em y casas decimais. Retorna o mesmo tipo de dados de x. Para obter
mais detalhes, consulte os exemplos a seguir.
Exceções
Se x for uma string ou se a unidade for do tipo de dados incorreto, um valor de erro será
retornado.
Notas
Se x é um tempo e a unidade é omitida, esta rotina não tem efeito: a precisão do tempo é de
apenas 1 segundo.
Exemplo
• Roundfrac (Pi(), 4)
Retorna 3,1416
• Roundfrac (TagVal('tag1'), 2)
Retorna o valor de tag1 arredondado em duas casas decimais
RTrim
Corta os espaços à esquerda de uma string.
Sintaxe
RTrim(s)
Argumentos
• s
Uma string.

Retorna
A string de origem com os espaços brancos à esquerda removidos.
Exceções
Exemplo
• RTrim("Stringtag ") = "Stringtag"
• RTrim(" Stringtag") = " Stringtag"
• RTrim('Stringtag') = "Error" if the Snapshot value for the stringtag equals
"Error "
Sec
Retorna a secante trigonométrica de um número.
Sintaxe
Sec(x)
Argumentos
• x
Retornos
A secante de x.
Exceções
Exemplo
• Sec('tag1')
• Sec(1)
• Sec(1.1)
Sech
Retorna a secante hiperbólica de um número.
Sintaxe
Sech(x)
Argumentos
• x
Retornos
A secante hiperbólica de x.

Exceções
Exemplo
• Sech('tag1')
• Sech(1)
• Sech(1.1)
Second
Extrai o segundo de uma expressão de tempo.
Sintaxe
Second(t1)
Argumentos
• t1
Retornos
O segundo do tempo, no intervalo de 0-59.
Exceções
Nenhuma.
Exemplo
• Second('*')
• Second('y')
• Second('*-1h')
Sgn
Retorna um indicador do sinal numérico de um número.
Sintaxe
Sgn(x)
Argumentos
• x
Retornos
-1 se x < 0,0, se x = 0,1, se x > 0.
Exceções

Exemplo
• Sgn('tag1')
• Sgn(1)
• Sgn(0)
Sin
Retorna o seno trigonométrico de um número.
Sintaxe
Sin(x)
Argumentos
• x
Retornos
O seno de x.
Exceções
Exemplo
• Sin('tag1')
• Sin(1)
• Sin(1.1)
Sinh
Retorna o seno hiperbólico de um número.
Sintaxe
Sinh(x)
Argumentos
• x
Retornos
O seno hiperbólico de x.
Exceções
Exemplo
• Sinh('tag1')
• Sinh(1)
• Sinh(0.9)

Sqr
Retorna a raiz quadrada de um número.
Sintaxe
Sqr(x)
Argumentos
• x
Deve ser um número inteiro ou real maior que ou igual a zero.
Retornos
A raiz quadrada de x.
Exceções
Se x for negativo ou não for um número, um valor de erro será retornado.
Exemplo
• Sqr('tag1')
• Sqr(2)
• Sqr(2.1)
StateNo
Traduz um estado digital em seu número de estado correspondente.
Sintaxe
StateNo(digstate)
Argumentos
• digstate
Um valor da enumeração.
Retornos
O deslocamento no Conjunto de estado digital que corresponde a digstate.
Exceções
Se um ponto for passado como digstate que seja diferente de um ponto digital, um valor de erro
será retornado.
Notas
Um estado digital pode aparecer mais de uma vez na tabela de estados digitais. Nesse caso, os
retornos de StateNo podem variar. Se digstate for o valor de um ponto digital, StateNo retorna
um código apropriado para esse ponto.
Exemplo
• StateNo('digitaltag')
• StateNo(TagVal('digitaltag', '*-1h'))

SStDev
Retorna o desvio padrão das amostras — o desvio padrão de dois ou mais argumentos que
sejam uma amostra de uma população maior. O desvio padrão de uma amostra x1...xn é igual a
,
em que é o significado da amostra, ou seja,
Sintaxe
SStDev(x1, x2, ..., xn)
Argumentos
• x1...xn
Podem ser números ou expressões de tempo, mas todos devem ser do mesmo tipo.
Retornos
O desvio padrão das amostras dos argumentos. Se os argumentos forem números, o resultado
será um número, se forem tempos ou períodos, o resultado será um período (número de
segundos).
Exceções
Argumentos, cujos valores de tempo de execução são estados digitais, são ignorados. Se não
houver pelo menos dois valores numéricos, SStDev retornará zero.
Notas
No caso raro em que toda a população está presente, não uma amostra, a função PstDev poderá
ser usada em vez de SStDev.
Exemplo
• SStDev('tag1', 'tag2', TagVal('tag1', 'y'))
• SStDev('y', 't', '14-Dec-97')
• SStDev(1, 2, 1.1)
StDev
Encontra o desvio padrão ponderado pelo tempo de um ponto em determinado tempo, de
acordo com os valores armazenados no PI Archive.

Sintaxe
StDev(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
• starttime
Deve ser uma expressão de tempo representando o início do intervalo de tempo a ser
pesquisado.
• endtime
Deve ser uma expressão de tempo maior que a hora de início representando o término da
expressão de tempo a ser pesquisada.
• pctgood
Retornos
O desvio padrão ponderado pelo tempo do ponto em determinado tempo.
Exceções
Se o ponto não tiver valores bons ou a PctGood mínima não for alcançada para o intervalo de
Notas
CUIDADO:
Se o ponto tiver poucos valores Archive bons durante o período, o resultado dessa função
talvez não seja confiável. Use a função PctGood para encontrar o percentual de valores
bons.
Exemplo
• StDev('tag1', 'y', '*')
• StDev('tag1', '14-Dec-97', '+1d',85)
• StDev('tag1', '14-Dec-97', '15-Dec-97')
String
Converte qualquer valor em uma string.
Sintaxe
String(x)
Argumentos
• x
Qualquer expressão. Pode ser qualquer um dos tipos de dados normais do PI System.

Retorna
A string que representa o argumento do valor.
Exceções
Nenhuma.
Exemplo
• String(12.23) = "12.23"
• String('sinusoid')
• String('pidigital')
• String('*')
• String("Hello, PI user!") = "Hello, PI user!"
TagAvg
Encontra o valor médio ponderado pelo tempo de um ponto em determinado tempo, de acordo
com os valores armazenados no PI Archive.
Sintaxe
TagAvg(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
• starttime
pesquisado.
• endtime
• pctgood
Retornos
O valor médio ponderado pelo tempo do ponto em determinado tempo.
Exceções

Notas
CUIDADO:
bons.
Exemplo
• TagAvg('tag1', 'y', '*')
• TagAvg('tag1', '14-Dec-97', '+1d',70)
• TagAvg('tag1', '14-Dec-97', '15-Dec-97')
TagBad
Testa se um ponto sofre um estado anormal em determinado tempo. Se o tipo do ponto for R
ou I, qualquer estado digital será anormal. Se o ponto for do tipo D, os estados definidos para
ele serão normais; todos os outros serão anormais.
Sintaxe
Tagbad(tagname [, time])
Argumentos
• tagname
Um nome de tag.
• time
Opcional. Uma expressão de tempo. Se omitida, o tempo atual (*) será usado.
Retornos
0 se o estado do ponto no tempo for normal, 1 se for anormal.
Exceções
Se o ponto não existir ou não houver um valor arquivado no tempo, um valor de erro será
retornado.
Notas
Badval pode testar qualquer valor ou expressão; TagBad só pode testar um ponto.
Exemplo
• TagBad('tag1', '*')
• TagBad('digitaltag', '14-Dec-97')
• TagBad('tag1', 'y')
TagDesc
Obtém o descritor de um ponto com base no Banco de dados do ponto.
Sintaxe
TagDesc(tagname)

Argumentos
• tagname
Retornos
O descritor do ponto.
Exceções
Se o ponto não existir, um valor de erro será retornado.
Exemplo
• TagDesc('tag1')
• TagDesc('digitaltag')
TagEU
Obtém a string da unidade de medida com base no Banco de dados do ponto.
Sintaxe
TagEU(tagname)
Argumentos
• tagname
Retornos
As unidades de engenharia do ponto.
Exceções
Exemplo
• TagEU('tag1')
TagExDesc
Obtém o descritor estendido de um ponto com base no Banco de dados do ponto.
Sintaxe
TagExDesc(tagname)
Argumentos
• tagname
Retornos
O descritor estendido do ponto.

Exceções
Exemplo
• TagExDesc('tag1')
TagMax
Encontra o valor máximo de um ponto em determinado tempo, de acordo com os valores
armazenados no PI Archive.
Sintaxe
TagMax(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
Um nome de tag.
• starttime
Uma expressão de tempo indicando o início do intervalo de tempo a ser pesquisado. Os
tempos relativos serão relativos ao tempo final se este não for um tempo relativo.
• endtime
Término do intervalo de tempo a ser pesquisado. Tempos relativos são relativos à hora de
início, caso esta não seja um tempo relativo. Esse tempo deve ser após a hora de início.
• pctgood
Retornos
O valor máximo do ponto em determinado tempo.
Exceções
Notas
CUIDADO:
O estado digital OverRange não é considerado ao calcular esse valor.
• TagMax('tag1', 'y', '*')

• TagMax('tag1', '-1h', '*',95)
Nesse ponto, hora de início é uma hora antes do tempo final, que agora é ('*'). Durante o
espaço de tempo, pelo menos 95% dos valores devem ser bons.
• TagMax('tag1', '-1h', '*',95)
• TagMax('tag1', '14-Dec-97', '+1h')

TagMean
Encontra o valor médio de um ponto em determinado tempo, de acordo com os valores
Sintaxe
TagMean(tagname, starttime, endtime [, pctgood])
Retornos
O valor médio do ponto em determinado tempo. A média não é ponderada pelo tempo.
Argumentos
• tagname
• starttime
pesquisado.
• endtime
• pctgood
Exceções
tempo especificado, um valor de erro será retornado. Diferentemente de outras funções de
resumo, o TagMean não interpola qualquer valor no limite. Além disso, senão houver eventos
Archive entre o intervalo específico, um valor de erro será retornado.
Notas
CUIDADO:
bons.
Exemplo
• TagMean('tag1', 'y', '*')
• TagMean('tag1', '14-Dec-97', '+1d',70)
• TagMean('tag1', '14-Dec-97', '15-Dec-97')
TagMin
Encontra o valor mínimo de um ponto em determinado tempo, de acordo com os valores

Sintaxe
TagMin(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
• starttime
Início do intervalo de tempo a ser pesquisado. Os tempos relativos são relativos ao tempo
final, caso este não seja um tempo relativo.
• endtime
Os tempos relativos são relativos à hora de início, caso esta não seja um tempo relativo. Esse
tempo deve ser após a hora de início.
• pctgood
Retornos
O valor mínimo do ponto em determinado tempo.
Exceções
Notas
CUIDADO:
O estado digital UnderRange não é considerado ao calcular esse valor.
Exemplo
• TagMin('tag1', 'y', '*')
• TagMin('tag1', '-1h', '*',90)
• TagMin('tag1', '14-Dec-97', '+1h')
TagName
Obtém o nome de um ponto com base no Banco de dados do ponto.
Sintaxe
TagName(tag)
Argumentos
• tagname
Retornos
O nome do ponto.

Exceções
Exemplo
• TagName('tag1')
TagNum
Obtém o número de um ponto com base no Banco de dados do ponto.
Sintaxe
TagNum(string)
Argumentos
• string
O nome de um atributo com uma referência de dados PI Point entre aspas duplas.
Retornos
O número do ponto.
Exceções
Exemplo
• TagNum("tag1")
TagSource
Obtém a string de origem do ponto com base no Banco de dados do ponto.
Sintaxe
TagSource(tagname)
Retornos
A string de origem do ponto.
Argumentos
• tagname
Exceções
Exemplo
• TagSource('tag1')
TagSpan
Obtém o espaço de um ponto com base no Banco de dados do ponto.

Sintaxe
TagSpan(tagname)
Argumentos
• tagname
Retornos
O espaço do ponto. Se o tipo de ponto for Digital, esse espaço será um número inteiro cujo valor
seja o número dos estados digitais definidos para o ponto.
Exemplo
• TagSpan('tag1')
• TagSpan('digitaltag')
TagTot
Encontra o valor total (tempo integral) de um ponto em determinado tempo, de acordo com os
valores armazenados no PI Archive.
Sintaxe
TagTot(tagname, starttime, endtime [, pctgood])
Argumentos
• tagname
Um nome de tag. Esse ponto deve representar um fluxo contínuo do processo.
• starttime
O início do intervalo de tempo a ser pesquisado. Tempos relativos são relativos ao tempo
final, caso este não seja um tempo relativo.
• endtime
O término do intervalo de tempo a ser pesquisado. Tempos relativos são relativos à hora de
início, caso esta não seja um tempo relativo.
• pctgood
Retornos
O valor total do ponto em determinado tempo.
Exceções
Se o ponto não tiver valores bons ou a PctGood mínima não for alcançada para o intervalo de
tempo específico, um valor de erro será retornado.
CUIDADO:
talvez não seja confiável. Use a função PctGood para saber se o percentual de valores é
bom.

Notas
• O sistema seleciona um fator de escala, de forma que o número inteiro é correto apena se o
fluxo é expressado em unidades por dia. Se o fluxo for expressado em unidades por hora, ou
por alguma outra unidade de tempo, será necessário multiplicar esse resultado por um fator
de conversão. O fator de conversão iguala o número das unidades de tempo do fluxo atual
em um dia.
Por exemplo, se um ponto medido em galões por minuto for calculado, multiplique o
resultado de TagTot por 1.440 para obter a resposta em galões. Esse fator de conversão não
está relacionado ao período de tempo calculado; ele é estritamente uma função das
unidades de engenharia do ponto.
Alguns sites do PI têm o período total padrão configurado para ocorrer a toda hora, em vez
de todo dia. Se o usuário estivem em um desses sites, o fator de conversão dele será
diferente.
• Quando a porcentagem de dados bons é inferior a 100%, TagTot determina o total baseado
nos dados bons e divide a fração de dados bons no intervalo.
Exemplo
• TagTot('tag1', 'y', '*')
• TagTot('tag1', '-1h', '*',85)
• TagTot('tag1', '14-Dec-97', '+1h')
TagType
Obtém um caractere de tipo (I, R ou D) do ponto com base no Banco de dados do ponto.
Sintaxe
TagType(tagname)
Argumentos
• tagname
Retornos
O caractere de tipo do ponto.
Exceções
Exemplo
• TagType('tag1')
• TagType('digitaltag')
TagVal
Encontra um valor Archive do ponto em determinado tempo.
Sintaxe
TagVal(tagname [, time])

Argumentos
• tagname
• time
Opcional. Uma expressão de tempo. Se esse argumento for omitido, '*' será usado.
Retornos
O valor arquivado do nome de tag no momento. Esse valor é interpolado, exceto se o ponto
tiver o atributo Etapa de 1 (ou Código de resolução de 4 do PI2).
Exceções
Se o ponto não existir ou não houver um valor arquivado no tempo, um valor de erro será
retornado.
Exemplo
• TagVal('tag1')
• TagVal('digitaltag')
• TagVal('tag1','*')
TagZero
Obtém o valor zero do ponto com base no Banco de dados do ponto.
Sintaxe
TagZero(tagname)
Argumentos
• tagname
Retornos
O valor zero do ponto. Se o tipo do ponto for R ou I, ele será um número; se o tipo do ponto for
D, ele será um estado digital (string de caracteres).
Exceções
Exemplo
• TagZero('tag1')
TagZero('digitaltag')
Tan
Retorna a tangente trigonométrica de um número.
Sintaxe
Tan(x)

Argumentos
• x
Retornos
A tangente de x.
Exceções
Exemplo
• Tan('tag1')
• Tan(1)
• Tan(1.1)
Tanh
Retorna a tangente hiperbólica de um número.
Sintaxe
Tanh(x)
Argumentos
• x
Retornos
A tangente hiperbólica de x.
Exceções
Exemplo
• Tanh('tag1')
• Tanh(1)
• Tanh(1.1)
Text
Concatena strings que representem valores de argumento.
Sintaxe
Text(val1 [, val2, … ])
Argumentos
• val1, val2, …
Qualquer expressão. Podem ser qualquer um dos tipos de dados normais do PI System.

Retornos
Uma string que é a concatenação de strings representando valores de argumento.
Exemplo
• Text('sinusoid')
• Text("The value for tag sinusoid is at ", '*', " is ", 'sinusoid') = "The
value for tag sinusoid at 1-Jun-00 17:07:18 is 89.09"
THEN
Retorna o primeiro de dois valores especificados quando uma expressão condicional IF-THEN-
ELSE é Verdadeira.
Sintaxe
Argumentos
• expression
Qualquer expressão condicional avaliada como Verdadeira ou Falsa.
• x, y
Retornos
Exceções
Nenhuma.
Exemplo
TimeEq
Encontra o tempo total, em um intervalo, quando um ponto é igual a determinado valor.
Sintaxe
TimeEq(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
O início do intervalo de tempo a ser pesquisado. Os tempos relativos serão relativos ao
tempo final se este não for um tempo relativo.

• endtime
início, caso esta não seja um tempo relativo. Esse tempo deve ser posterior à hora de início.
• value
Deve ser um número inteiro ou real ou um estado digital (string de caracteres); o valor a ser
pesquisado.
Retornos
O período de tempo dentro do intervalo de tempo, no qual o ponto era menor que ou igual ao
valor especificado.
Exemplo
• TimeEq('tag1', 't', '*',40.0)
• TimeEq('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeEq('digitaltag', '14-Dec-97', '*', "On")
TimeGE
Encontra o primeiro tempo, em um intervalo, quando um ponto é maior que ou igual a
determinado valor.
Sintaxe
TimeGE(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
• endtime
• value
pesquisado.
Retornos
era maior que ou igual ao valor especificado.
Exceções
Nenhuma.

Notas
TimeGE faz a interpolação entre eventos Archive, se necessário, para encontrar os tempos em
que o ponto cruzou determinado valor.
Exemplo
• TimeGE('tag1', 't', '*',40.0)
• TimeGE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeGE('digitaltag', '14-Dec-97', '*', "On")
TimeGT
Encontra o tempo total, em um intervalo, quando um ponto é maior que determinado valor.
Sintaxe
TimeGT(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
• endtime
• value
pesquisado.
Retornos
O período de tempo dentro do intervalo de tempo, no qual o ponto era maior que o valor
especificado.
Exceções
Nenhuma.
Notas
TimeGT faz a interpolação entre eventos Archive, se necessário, para encontrar os tempos em
Exemplo
• TimeGT('tag1', 't', '*',40.0)
• TimeGT('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeGT('digitaltag', '14-Dec-97', '*', "On")

TimeLE
Encontra o tempo total, em um intervalo, quando um ponto é menor ou igual a um
determinado valor.
Sintaxe
TimeLE(tagname, starttime, endtime, value)
Argumentos
• tagname
O nome de um atributo com uma referência de dados de ponto PI entre aspas simples.
• starttime
O início do intervalo de tempo a ser pesquisado. Tempos relativos são relativos a endtime, se
endtime não for um tempo relativo.
• endtime
O término do intervalo de tempo a ser pesquisado. Tempos relativos são relativos a
starttime, se starttime não for um tempo relativo. Esse tempo deve ser posterior à starttime.
• value
Deve se um número inteiro ou real ou um estado digital (string de caracteres); o valor a ser
pesquisado.
Retorna
O período de tempo dentro do intervalo especificado, no qual o ponto era menor ou igual ao
valor especificado.
Exceções/erros
Nenhum.
Notas
TimeLE faz a interpolação entre eventos de archive, se necessário, para encontrar os tempos
quando o ponto cruzou o valor determinado.
Exemplos
• TimeLE('tag1', 't', '*',40.0)
• TimeLE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeLE('digitaltag', '14-Dec-97', '*', "On")
TimeLT
Encontra o tempo total, em um intervalo, quando um ponto é menor que determinado valor.
Sintaxe
TimeLT(tagname, starttime, endtime, value)
Argumentos

• tagname
• starttime
• endtime
• value
pesquisado.
Retornos
O período de tempo dentro do intervalo de tempo, no qual o ponto era menor que o valor
especificado.
Exceções
Nenhuma.
Notas
TimeLT faz a interpolação entre eventos Archive, se necessário, para encontrar os tempos em
Exemplo
• TimeLT('tag1', 't', '*',40.0)
• TimeLT('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeLT'digitaltag', '14-Dec-97', '*', "On")
TimeNE
Encontra o tempo total, em um intervalo, quando um ponto é diferente de determinado valor.
Sintaxe
TimeNE(tagname, starttime, endtime, value)
Argumentos
• tagname
• starttime
• endtime

• value
pesquisado.
Retornos
O período de tempo dentro do intervalo de tempo, no qual o ponto era diferente do valor
especificado.
Exceções
Nenhuma.
Exemplo
• TimeNE('tag1', 't', '*',40.0)
• TimeNE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
• TimeNE('digitaltag', '14-Dec-97', '*', "On")
Timestamp
Retorna o timestamp de um valor em timestamp exclusivo.
Sintaxe
TimeStamp(x)
Argumentos
• x
Um valor em timestamp (PI Event).
Retornos
O timestamp do valor em timestamp especificado.
Exceções
Se o valor de x for Nenhum dado, a mensagem Falha no cálculo será retornada.
Exemplo
• TimeStamp(PrevVal('sinusoid', '*"))
Retorna o timestamp do evento PI Archive mais recente para sinusoid.
Total
Retorna a soma de dois ou mais valores.
Sintaxe
Total(x1, x2, ..., xn)
Argumentos
• x1...xn
Podem ser números ou períodos de tempo, mas todos devem ser do mesmo tipo.

Retornos
O total dos argumentos. O resultado tem o mesmo tipo de dados dos argumentos.
Exceções
Os argumentos cujos valores de tempo de execução são strings de caracteres ou estados
digitais não inclusos no total. Se todos os valores forem estados digitais, Total retornará um
valor de erro.
Exemplo
• Total('tag1', 'tag2', TagVal('tag1', 'y'),40.0)
• Total('t'-'y', '+1h')
Trim
Corta espaços vazios nos dois lados de uma string.
Sintaxe
Trim(s)
Argumentos
• s
Uma string.
Retornos
Uma string de origem com espaços à esquerda e à direita removidos.
Exceções
Exemplo
• Trim(" Stringtag ") = "Stringtag"
• Trim(" Stringtag is a string tag. ") = "Stringtag is a string tag."
Trunc
Trunca um número ou tempo com a próxima unidade mais baixa.
Sintaxe
Trunc(x [, unit])
Argumentos
• x
Deve ser um número inteiro ou real, uma expressão de tempo ou o período de tempo.
• unit
Opcional. O tamanho da unidade a ser truncada; x será truncado para um múltiplo de unit.
Se x for um número, a unit deverá ser um número. Se x for uma expressão ou um período de
tempo, unit deverá ser um período de tempo. Se unit for omitida, Trunc truncará o próximo
número inteiro mais baixo (para um número) ou segundo (para um período de tempo).

Retornos
Trunc retorna o maior múltiplo da unidade menor que x. Para um x negativo, ele retorna o
menor múltiplo da unit maior que x.) Os dados do retorno é do mesmo tipo de x.
Exceções
Se x for uma string, ou se unidade for um tipo de dados incorreto, um erro será retornado.
Notas
Se x for um tempo, e a unidade for omitida, esta rotina não terá efeito, pois os tempos só são
precisos em um segundo.
Quando |x| < |unidade|, 0 é retornado.
Exemplo
• Trunc(12.999)
Trunca para o próximo inteiro mais baixo (12,0)
• Trunc(28.75, 10)
Trunca para o próximo múltiplo de 10 mais baixo (20,0)
• Trunc('14-Dec-97 11:47','+1h')
Trunca para a próxima hora mais baixa (14-dez-97 11:00)
• Trunc('18:47' -'15:00','+1h')
Trunca o período para a próxima hora mais baixa. (3:00:00)
Nota:
Truncar para o próximo dia mais baixo resulta em um timestamp do próximo dia mais
baixo no tempo UTC, não no tempo local.
UCase
Converte uma string em uma string em caixa alta.
Sintaxe
UCase(s)
Argumentos
• s
Deve ser um valor de string.
Retornos
Uma string em caixa alta.
Exceções
Exemplo
• UCase("Stringtag") = "STRINGTAG"
• UCase('Stringtag') = "ERROR" if the Snapshot value for the stringtag equals
"Error"

Yearday
Extrai o dia do ano de uma expressão de tempo. O dia do ano (também conhecido como dia
juliano) é um número inteiro de 1 a 366, no qual 1 representa 1 de janeiro.
Sintaxe
Yearday(t1)
Argumentos
• t1
Retornos
O dia do ano, no intervalo de 1-366, em que 1 representa o 1 de janeiro.
Exceções
Nenhuma.
Exemplo
• Yearday('*')
• Yearday('t')
Year
Extrai o ano de uma expressão de tempo.
Sintaxe
Year(t1)
Argumentos
• t1
Retornos
O ano do tempo, no intervalo de 1970-atual.
Exceções
Nenhuma.
Exemplo
• Year('*')
• Year('t')
Weekday
Extrai o dia da semana de um timestamp.
Sintaxe
Weekday(t1)

Argumentos
• t1
Retornos
O dia da semana de um tempo, no intervalo de 1-7, em que 1 representa o domingo.
Exceções
Nenhuma.
Exemplo
• Weekday('*')
• Weekday('t')
Funções de vapor para expressões de análise

Você pode incluir funções de vapor em expressões de análise para calcular as propriedades
termodinâmicas do vapor. Estas funções são baseadas na Formulação Industrial IAPWS 1997. A
implementação se baseia em grande parte na combinação das equações de frente e para trás
oficialmente publicadas para todas as regiões aplicáveis.
Nota:
Evite confundir estas funções de vapor com o conjunto de funções de vapor usado para
Equações de Desempenho PI semelhantes. Os nomes destas funções começam com
"StmSI_" ou "StmEng_". Os nomes de funções de vapor usadas com expressões de análise
começam com "Steam_".
A tabela a seguir lista as funções suportadas e suas descrições. Escalas e unidades de medida
das propriedades de função de vapor são detalhadas em Intervalos para entradas da função de
vapor. Estados de referência que se aplicam a vapor são listados em Estados de referência das
propriedade do vapor.
Descrições de função de vapor
Steam_TsatP Temperatura de saturação como uma função da pressão.
Steam_HsatP Entalpia de saturação como uma função da pressão.
Steam_SsatP Entropia de saturação como uma função da pressão.
Steam_VsatP Volume específico de vapor de saturação como uma função da pressão.
Steam_PsatT Pressão de saturação como uma função da temperatura.
Steam_HsatT Entalpia de saturação como uma função da temperatura.
Steam_SsatT Entropia de saturação como uma função da temperatura.
Steam_VsatT Volume específico do vapor de saturação como uma função da temperatura.
Steam_VPT Volume específico do vapor como uma função da pressão e da temperatura.
(Para vapor saturado e superaquecido.)
Steam_VPTL Volume específico da água como uma função da pressão e da temperatura.
Steam_VPH Volume específico do vapor como uma função da pressão e da entalpia. (Para
vapor úmido e seco.)
Steam_VPS Volume específico do vapor como uma função da pressão e da entropia. (Para

Steam_HPT Entalpia específica do vapor como uma função da pressão e da temperatura.
Steam_HPTL Entalpia específica do líquido como uma função da pressão e da temperatura.
(Para água.)
Steam_HPS Entalpia específica do vapor como uma função da pressão e da entropia. (Para
Steam_SPT Entropia específica do vapor como uma função da pressão e da temperatura.
Steam_SPTL Entropia específica do líquido como uma função da pressão e da temperatura.
(Para água.)
Steam_SPH Entropia específica do vapor como uma função da pressão e da entalpia. (Para
Steam_TPH Temperatura como uma função da entalpia e da pressão. (Para vapor úmido e
seco.)
Steam_TPS Temperatura como uma função da entropia e da pressão. (Para vapor úmido e
seco.)
Steam_XHP Qualidade do vapor (fração de vapor) como uma função da entalpia e da pressão.
(Para vapor úmido.)
Steam_XPS Qualidade do vapor (fração de vapor) como uma função da entropia e da
pressão. (Para vapor úmido.)
Steam_HPX Entalpia específica do vapor como uma função da pressão e da qualidade do
vapor. (Para vapor úmido.)
Steam_SPX Entropia específica do vapor como uma função da pressão e da qualidade do
vapor. (Para vapor úmido.)
Intervalos para entradas da função de vapor

A tabela abaixo mostra os intervalos e unidades padrão de medida para cada uma das cinco
propriedades envolvidas nos cálculos da função de vapor.
As unidades padrão de medida são unidades SI. Para obter informações sobre como usar
funções de vapor com outras unidades de medida, consulte Conversão de unidades de medida
para funções de vapor.
Pressão afeta o estado do vapor. Várias coisas para se lembrar para funções com pressão como
uma entrada são descritas em Considerações para funções de vapor que têm a pressão como
uma entrada.
Intervalos para entradas para propriedades da função de vapor
Função Temp (°C) Pressão (kPa) Entalpia(J/g) Entropia(J/(g Qualidad
K)) e
Steam_TsatP 0.611212678 até
22064
Steam_HsatP 0.611212678 até
22064
Steam_SsatP 0.611212678 até
22064
Steam_VsatP 0.611212678 até
22064
Steam_PsatT 0.0 até 373.946
Steam_HsatT 0.0 até 373.946

Função Temp (°C) Pressão (kPa) Entalpia(J/g) Entropia(J/(g Qualidad

K)) e
Steam_SsatT 0.0 até 373.946
Steam_VsatT 0.0 até 373.946
Steam_VPT 0 até 800 0.611212678 até
100000
Steam_VPT (alta 800 até 2000 0.611212678 até
temperatura e 500000
pressão)
Steam_VPTL 0 to 800 0.611212678 até
100000
Steam_VPH 0.611212678 até -0.04159 até
100000 4160.7
Steam_VPS 0.611212678 até -0.000155 até
100000 11.921
Steam_HPT 0 até 800 0.611212678 até
100000
Steam_HPT (alta 800 até 2000 0.611212678 até
pressão)
Steam_HPTL 0 até 800 0.611212678 até
100000
Steam_HPS 0.611212678 até -0.000155 até
100000 11.921
Steam_HPX 0.611212678 até 0 até 1
22064
Steam_SPT 0 até 800 0.611212678 até
100000
Steam_SPT (alta 800 até 2000 0.611212678 até
pressão)
Steam_SPTL 0 até 800 0.611212678 até
100000
Steam_SPH 0.611212678 até -0.04159 até
100000 4160.7
Steam_SPX 0.611212678 até 0 até 1
22064
Steam_TPH 0.611212678 até -0.04159 até
100000 4160.7
Steam_TPS 0.611212678 até -0.000155 até
100000 11.921
Steam_XPH 0.611212678 até -0.04159 até
22064 4160.7
Steam_XPS 0.611212678 até -0.000155 até
22064 11.921

Considerações para funções de vapor que têm a pressão como uma

entrada
Uma vez que a pressão afeta o estado de vapor, esteja ciente destas considerações para funções
que têm a pressão como uma entrada.
Funções com pressão e temperatura como entradas

Steam_HPT, Steam_SPT e Steam_VPT podem ser usadas para vapor seco saturado ou
superaquecido. Para entrada de temperatura e pressão na curva saturada, a entropia, entalpia
ou volume calculado é uma propriedade do vapor saturado. Para entrada de temperatura
inferior à temperatura saturada para a pressão de entrada, um erro será retornado.
Estas três funções também podem aceitar a temperaturas de entrada de gama alta (800 a 2000
°C) com pressões de 0.611212678 a 50000 kPa.
Funções com pressão e entalpia ou entropia como entradas

Steam_VPH, Steam_VPS, Steam_HPS, Steam_SPH, Steam_TPH e Steam_TPS podem ser usadas
para vapor superaquecido ou úmido. Para estas funções, o intervalo de entalpia (H) é-0.04159
a 4160.7 J/g e de entropia (S) é -0.000155 a 11.921 J /(g K). Mesmo para valores no intervalo,
no entanto, algumas combinações de pressão e entalpia ou entropia correspondem a água
comprimida, ao invés de vapor e resultam em um estado de erro:
• Para Steam_HPS e Steam_SPH na região de vapor úmido, são verificados os limites da

região de água comprimida e vapor superaquecido. Se a entalpia de entrada ou entropia não
está na região de vapor úmido, é retornado um erro Calc Failed.
• Para Steam_TPH e Steam_TPS na região de vapor úmido, é verificado o limite entre a região
de vapor úmido e água comprimida. Se a combinação de pressão de entrada e entropia ou
entalpia é na região de água comprimida, é retornado um erro Calc Failed.
Da mesma forma, para Steam_XPH e Steam_XPS, entalpia de entrada ou entropia maior que as
propriedades do vapor saturado ou menor que as propriedades de líquido saturado retorna um
erro.
As seguintes funções são eficazes em altas temperaturas e pressão. Steam_VPH, Steam_VPS,
Steam_HPS, Steam_SPH, Steam_TPH e Steam TPS calculam resultados válidos para estados
com pressão acima do ponto crítico (22064 kPa) e temperatura superior a 350 °C, mas menor
do que a temperatura crítica (373,946 °C), mesmo que estes estados sejam considerados como
sendo água comprimida, ao invés de vapor.
Conversão de unidades de medida para funções de vapor

As unidades de medida padrão (UDM) para as funções de vapor são unidades SI. Qualquer
entrada para as funções de vapor definidas em Unidades Inglesas são automaticamente
convertidas para as unidades SI correspondentes. Da mesma forma, se uma função de vapor
estiver configurada como um atributo de saída, sua saída é automaticamente convertida para a
UDM configurada para o atributo.
Nota:
A conversão automática requer que todas as UDM tenham sido definidas corretamente no
banco de dados de UDM. Se a definição de conversão de uma unidade para outra do
mesmo tipo estiver ausente do banco de dados de UDM, a conversão falhará.
No editor de expressões, quando você avaliar uma expressão de função de vapor, os resultados
são exibidos em unidades SI padrão. Para exibir os resultados em outra UDM, você pode usar a
função Convert.

As expressões de exemplo a seguir usam valores numéricos, variáveis e atributos para mostrar
como as funções de vapor manipulam as UDM para quantidades de entrada e de saída.
Valores de entrada numéricos

As entradas de valores numéricos são reconhecidas como quantidades na UDM padrão. No
exemplo a seguir para Steam_VPT, as entradas numéricas são reconhecidas como 300 kPa e
200 °C, e o valor de saída é em cm3/g, a UDM padrão para volume específico.
Nome Expressão Valor Atributo de saída
Variable1 Steam_VPT(300, 200) 716.44 cm3/g Click to map
Atributos de entrada e saída

Na expressão a seguir,Steam_VsatT toma como sua única entrada o atributo 'TempSat', cujo
valor atual é de 300 °F. A temperatura é automaticamente convertida em °C para avaliar a
expressão e o resultado é exibido na UDM SI padrão para Steam_VsatT.
Variable1 Steam_VsatT('TempSat') 403.7 cm3/g OutputVolume
O resultado também é mapeado para o atributo de saída 'OutputVolume'. Este atributo está
configurado em UDM Inglesa (ft3/lb), então o resultado é automaticamente convertido para
esta UDM. (Na guia Atributos no PI System Explorer, 'OutputVolume' seria listado com um
valor de 6,466627 ft3/lb.)
Variáveis e a função Convert

Este exemplo usa as variáveis e a função Convert para especificar quantidades em UDM
Inglesa como entradas de função de vapor.
1. Nas linhas P e T da expressão abaixo, Convert atribui valores numéricos para UDM Inglesa
para pressão e temperatura.
2. Na linha B, as variáveis P e T são automaticamente convertidas em unidades SI para o
cálculo de Steam_VPT; o resultado é exibido em UDM SI padrão. O resultado também é
mapeado para o atributo de saída 'OutputVolume'. Este atributo está configurado em UDM
Inglesa (ft3/lb), então o resultado é automaticamente convertido para esta UDM.
3. Na última linha, Convert é usada para converter o resultado (B) em UDM Inglesa e exibi-lo
na expressão.
P Convert(2000, "psia") 2000 psia Click to map
T Convert(800, "°F") 800 °F Click to map
B Steam_VPT(P, T) 19.206 cm3/g OutputVolume
Volume Convert(B, "ft3/lb") 0.30762 ft3/lb DisplayedVolume
Estados de referência das propriedade do vapor

A American Society of Mechanical Engineers (ASME) estabelece os seguintes estados de
referência:
• ponto tripo
O ponto triplo da água é 273.16 K ou 0.01 °C ou 32.018 °F.

• Escala Celsius
A temperatura Celsius é exatamente Tk - 273.15.
• ponto crítico
O ponto crítico do vapor é 647.096 K e 22,064 kPa, ou 705.103 °F e 3200.1 psia.
• estado de referência
A energia interna específica e a entropia específica da fase líquida foram fixados em zero no
ponto triplo da água.
Referência das funções de vapor
Steam_HPS
Calcula a entalpia específica do vapor em função da pressão (P in kPa) e entropia (S, em J/(g
K)). Usada para o valor úmido e superaquecido. Por padrão, os argumentos de entrada e os
valores retornados estão em unidades do SI. Você pode mudar as unidades de medida, por
exemplo, usando a função Convert.
Sintaxe
Steam_HPS(P, S)
Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.
• S
Entropia específica do vapor. S pode variar de -0,000155 a 11,921J/(g K).
Retorna
Entalpia específica do valor computada em J/g.
Exemplo
• Steam_HPS(2500, 7.5956)
Retorna 3684,9 J/g
Steam_HPT
Calcula a entalpia específica do vapor em função da pressão (P em kPa) e temperatura (T, em
°C). Usada apenas para vapor saturado seco ou superaquecido. Para qualquer T menor do que a
temperatura de saturação para P, a função retorna um erro que indica valor fora do intervalo. A
função aceita qualquer T no intervalo de temperatura, contudo, quando P é maior do que a
pressão crítica. Por padrão, os argumentos de entrada e os valores retornados estão em
unidades do SI. Você pode mudar as unidades de medida, por exemplo, usando a função
Convert.
Sintaxe
Steam_HPT(P, T)

Argumentos
• P
• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.
Retorna
Entalpia específica do valor computada em J/g.
Exemplo
• Steam_HPT(40000, 600)
Retorna 3350,4 J/g
Steam_HPTL
Calcula a entalpia específica líquida em função da pressão (P em kPa) e temperatura (T, em °C).
Usada somente para água subcrítica. Para qualquer T maior do que a temperatura de saturação
para P, a função retorna um erro que indica valor fora do intervalo. A função aceita qualquer T
no intervalo de temperatura, contudo, quando P é maior do que a pressão crítica. Por padrão,
os argumentos de entrada e os valores retornados estão em unidades do SI. Você pode mudar
as unidades de medida, por exemplo, usando a função Convert.
Sintaxe
Steam_HPTL(P, T)
Argumentos
• P
• T
Retorna
Entalpia específica líquida computada em J/g.
Exemplo
• Steam_HPTL(40000, 100)
Retorna 449,27 J/g
Steam_HPX
Calcula a entalpia específica em função da pressão (P em kPa) e qualidade (fração do vapor).
Usada somente para vapor úmido. Por padrão, os argumentos de entrada e os valores
retornados estão em unidades do SI. Você pode mudar as unidades de medida, por exemplo,
usando a função Convert.
Sintaxe
Steam_HPX(P, X)

Argumentos
• P
• X
Qualidade do vapor (fração do vapor). X pode variar de 0,0 a 1,0.
Retorna
Entalpia específica computada em J/g.
Exemplo
• Steam_HPX(10000, 0.9)
Retorna 2593,7 J/g
Steam_HsatP
Calcula a entalpia específica do vapor saturado em função da pressão (P em kPa). Por padrão,
Sintaxe
Steam_HsatP(P)
Argumentos
• P
Retorna
Entalpia específica computada para valor saturado em J/g.
Exemplo
• Steam_HsatP(10000)
Retorna 2725,5 J/g
Steam_HsatT
Calcula a entalpia específica do vapor saturado em função da temperatura (T em °C). Por
padrão, os argumentos de entrada e os valores retornados estão em unidades do SI. Você pode
mudar as unidades de medida, por exemplo, usando a função Convert.
Sintaxe
Steam_HsatT(T)
Argumentos
• T
Temperatura do vapor. T pode variar de 0,0 a 373,946 °C.

Retorna
Entalpia específica do valor saturado computada em J/g.
Exemplo
• Steam_HsatT(250)
Retorna 2801 J/g
Steam_PsatT
Calcula a pressão de saturação em função da temperatura (T em °C). Por padrão, os
argumentos de entrada e os valores retornados estão em unidades do SI. Você pode mudar as
unidades de medida, por exemplo, usando a função Convert.
Sintaxe
Steam_PsatT(T)
Argumentos
• T
Retorna
Pressão de saturação do vapor computada em kPa.
Exemplo
• Steam_PsatT(250)
Retorna 3975,9 kPa
Steam_SPH
Calcula a entropia específica do vapor em função da pressão (P in kPa) e entalpia (H, em J/g).
Usada para o valor úmido e superaquecido. Por padrão, os argumentos de entrada e os valores
Sintaxe
Steam_SPH(P, H)
Argumentos
• P
• H
Entalpia do vapor. H pode variar de -0,04159 a 4160,7 J/g.
Retorna
Entropia específica do vapor computada em J/(g K).
Exemplo
• Steam_SPH(10000, 3500)

Retorna 6,756 J/(g K)
Steam_SPT
Calcula a entropia específica do vapor em função da pressão (P em kPa) e temperatura (T, em
pressão crítica. Por padrão, os argumentos de entrada e os valores retornados estão em
unidades do SI. Você pode mudar as unidades de medida, por exemplo, usando a função
Convert.
Sintaxe
Steam_SPT(P, T)
Argumentos
• P
• T
Retorna
Entropia específica do vapor computada em J/(g K).
Exemplo
• Steam_SPT(40000, 600)
Steam_SPTL
Calcula a entropia específica líquida em função da pressão (P em kPa) e temperatura (T, em °C).
Usada somente para água subcrítica. Para qualquer T maior do que a temperatura de saturação
para P, a função retorna um erro que indica valor fora do intervalo. A função aceita qualquer T
no intervalo de temperatura, contudo, quando P é maior do que a pressão crítica. Por padrão,
Sintaxe
Steam_SPTL(P, T)
Argumentos
• P
• T
Retorna
Entropia específica líquida computada em J/(g K).

Exemplo
• Steam_SPTL(30000, 500)
Steam_SPX
Calcula a entropia específica do vapor em função da pressão (P em kPa) e qualidade (fração do
vapor). Usada somente para vapor úmido. Por padrão, os argumentos de entrada e os valores
Sintaxe
Steam_SPX(P, X)
Argumentos
• P
• X
Qualidade do vapor (fração do vapor). X pode variar de 0,0 a 1,0.
Retorna
Entropia específica computada do vapor em J/(g K).
Exemplo
• Steam_SPX(15000, 0.7)
Steam_SsatP
Calcula a entropia específica do vapor em função da pressão (P em kPa). Por padrão, os
Sintaxe
Steam_SsatP(P)
Argumentos
• P
Retorna
Entropia específica do vapor saturado computada em J/(g K).
Exemplo
• Steam_SsatP(10000)

Steam_SsatT
Calcula a entropia específica do vapor saturado em função da temperatura (T em °C). Por
Sintaxe
Steam_SsatT(T)
Argumentos
• T
Retorna
Entropia específica do vapor saturado computada em J/(g K).
Exemplo
• Steam_SsatT(250)
Steam_TPH
Calcula a temperatura do vapor em função da pressão (P in kPa) e entalpia (H, em J/g). Usada
para o valor úmido e superaquecido. Por padrão, os argumentos de entrada e os valores
Sintaxe
Steam_TPH(P, H)
Argumentos
• P
• H
Retorna
Temperatura de vapor computada em °C.
Exemplo
• Steam_TPH(40000, 3500)
Retorna 643,48 ℃
Steam_TPS
Calcula a temperatura do vapor em função da pressão (P in kPa) e entropia (S, em J/(g K)).

Sintaxe
Steam_TPS(P, S)
Argumentos
• P
• S
Retorna
Temperatura de vapor computada em °C.
Exemplo
• Steam_TPS(40000, 6)
Retorna 595,93 ℃
Steam_TsatP
Calcula a temperatura de saturação em função da pressão (P em kPa). Por padrão, os
Sintaxe
Steam_TsatP(P)
Argumentos
• P
Retorna
Temperatura de saturação computada em °C.
Exemplo
• Steam_TsatP(10000)
Retorna 311 ℃
Steam_VPH
Calcula o volume específico do vapor em função da pressão (P in kPa) e entalpia (S, em J/g).
Sintaxe
Steam_VPH(P, H)

Argumentos
• P
• H
Retorna
Volume específico do valor computado em cm3/g.
Exemplo
• Steam_VPH(25000, 3500)
Retorna 14,197 cm3/g
Steam_VPS
Calcula o volume específico do vapor em função da pressão (P in kPa) e entropia (S, em J/(g
K)). Usada para o valor úmido e superaquecido. Por padrão, os argumentos de entrada e os
Sintaxe
Steam_VPS(P, S)
Argumentos
• P
• S
Retorna
Exemplo
• Steam_VPS(40000, 6)
Steam_VPT
Calcula o volume específico do vapor em função da pressão (P em kPa) e temperatura (T, em
pressão crítica. Você pode mudar as unidades de medida, por exemplo, usando a função
Convert.
Sintaxe
Steam_VPT(P, T)

Argumentos
• P
• T
Retorna
Exemplo
• Steam_VPT(50000, 500)
Steam_VPTL
Calcula o volume específico líquido em função da pressão (P em kPa) e temperatura (T, em °C).
Para qualquer T maior do que a temperatura de saturação para P, a função retorna um erro que
indica valor fora do intervalo. A função aceita qualquer T no intervalo de temperatura, contudo,
quando P é maior do que a temperatura crítica. Por padrão, os argumentos de entrada e os
Sintaxe
Steam_VPTL(P, T)
Argumentos
• P
• T
Retorna
Volume específico líquido computado em cm3/g.
Exemplo
• Steam_VPTL(75000, 500)
Retorna 2,308 cm3/g
Steam_VsatP
Calcula o volume específico do vapor em função da pressão (P em kPa). Por padrão, os
Sintaxe
Steam_VsatP(P)

Argumentos
• P
Retorna
Exemplo
• Steam_VsatP(10000)
Steam_VsatT
Calcula o volume específico do vapor saturado em função da temperatura (T em °C). Por
Sintaxe
Steam_VsatT(T)
Argumentos
• T
Retorna
Volume específico do valor saturado computado em cm3/g.
Exemplo
• Steam_VsatT(250)
Steam_XPH
Calcula a qualidade do vapor (fração do vapor) em função da pressão (P in kPa) e entalpia (H,
em J/g). Usada somente para vapor úmido. Por padrão, os argumentos de entrada e os valores
Sintaxe
Steam_XPH(P, H)
Argumentos
• P
• H

Retorna
Qualidade do vapor computada (fração do vapor).
Exemplo
• Steam_XPH(10000, 2500)
Retorna 0,82888
Steam_XPS
Calcula a qualidade do vapor (fração do vapor) em função da pressão (P in kPa) e entropia (S,
em J/(g K)). Usada somente para vapor úmido. Por padrão, os argumentos de entrada e os
Sintaxe
Steam_XPS(P, S)
Argumentos
• P
• S
Retorna
Qualidade do vapor computada (fração do vapor).
Exemplo
• Steam_XPS(10000, 5)
Retorna 0,72695


Usar estruturas de eventos para capturar eventos
de processos
Capturar eventos importantes nos processos e coletar dados relevantes sobre esses eventos
pode ajudar a análise o motivo de eles ocorrerem. Por exemplo, é possível monitorar de perto
eventos, como tempo de inatividade do ativo, excursões do processo, inicialização ou
encerramento de equipamentos e excursões ambientais, para identificar as possíveis causas ou
os possíveis pontos de falha.
Coletar dados sobre períodos de tempo repetíveis, como lotes de monitoramento de produtos,
execuções de produtos ou turnos dos operadores, podem ajudar a tornar esses processos mais
eficientes. A captura de dados compreensíveis associados a tais eventos ajuda a monitorar,
comparar ou analisar o processo ou o evento.
Assim como os elementos, as estruturas de eventos permitem a coleta e o armazenamento de
dados dos ativos. A OSIsoft recomendar usar análises baseadas em ativos no PI Server 2014
para monitorar os eventos usando estruturas de eventos. PI Datalink, PI Coresight e PI
WebParts são as ferramentas cliente com suporte à visualização da estrutura de eventos.
Uma estrutura de evento engloba o período do evento com dados de ativos relevante e
compreensíveis:
Dados de eventos de amostra
Nesta seção
• Estruturas de eventos
• Formas de criar estruturas de eventos
• Templates da estrutura de eventos
• Visualizar estruturas de eventos usando ferramentas cliente
• Representar eventos no PI Asset Framework
Estruturas de eventos
Uma estrutura de eventos é um recurso PI System que ajuda na captura, no monitoramento, na
comparação ou na análise de processos importantes ou eventos de negócios e de seus dados
relacionados para um período de tempo repetível. As estruturas de eventos representam
ocorrências no processo sobre as quais deseja-se saber mais, por exemplo, inatividade do ativo,
excursões do processo, inicialização ou desligamento do equipamento, excursões ambientais,
lotes de monitoramento do produto, execuções de produto, classes de papel e turnos dos
operadores. Assim como os elementos, as estruturas de eventos permitem a coleta e o
armazenamento de dados dos ativos.

Usar estruturas de eventos para capturar eventos de processos
Cada estrutura de eventos tem um nome, uma hora de início, um tempo final, um ou mais
atributos e um ou mais elementos AF referenciados. Assim como com os elementos, é
necessário criar templates da estrutura de eventos para padronizar e gerenciar os atributos
para diferentes tipos de eventos.
As PI Event Frames permitem a pesquisa fácil dos próprios eventos no PI System, em vez de
pesquisar eventos por tempo. Podem-se configurar estruturas de eventos para retornar
automaticamente todos os dados de eventos relacionados em tempo real, de forma que não
seja necessário consultar vários sistemas para os dados do processo e evento e, então,
combiná-los manualmente. As estruturas de eventos podem ser configuradas para recuperar
dados históricos.
Nota:
As PI Event Frames estão inclusas no PI Server 2010 R3 e posterior. Caso haja outro
pacote do PI Server instalado, como o Enterprise Server, será necessário consultar o
gerente de conta sobre a atualização o pacote completo e mais recente do PI Server.
Quando usar as estruturas de eventos

Há duas categorias de eventos monitoráveis que se enquadrariam ao perfil da estrutura de
eventos:
• Eventos "Bons": Eventos que se deseja monitorar como parte normal do negócio, como
monitoramento de produtos, turnos e assim por diante.
• Eventos "Ruins": Eventos inesperados, que precisam ser analisados e, talvez, corrigidos
rapidamente caso eles ocorram, por exemplo, desligamentos inesperados e excursões. Esses
sãos eventos que deseja-se monitorar e reportar no agregamento, com o passar do tempo.
Fazer perguntas, como estas, podem ajudar a identificar os eventos ou as condições que devem
ser monitoradas.
• Quais são todos os tempos em que o evento X ocorreu nesse tipo de ativo?
• Dados podem ser associados a diferentes tags para um intervalo de tempo ou para um único
ponto no tempo?
• Quais são os dados associados a um período de tempo determinado quando um problemas
ocorreu ou poderá ocorrer?
• Quais são os eventos de processo crítico que precisam ser notificados a uma pessoa?
• Existem estados digitais para as tags PI System que sejam significativas quando elas são
alteradas, e eles devem acionar outras ações?
Nesta seção
• Exemplos de estruturas de eventos
• Vantagens das PI Event Frames
• PI Event Frames ou PI Batch?
Exemplos de estruturas de eventos

Exemplo de estruturas de eventos em uma empresa de geração de energia eólica
Veja o exemplo de uma empresa de geração de energia eólica que tenha diferentes tipos de
moinhos de vento em diferentes locais e que use o PI AF para organizar seus dados. A estrutura
do asset framework dessa empresa está baseada em um template de elemento base do tipo
"moinho de vento" e tem vários templates filho baseados no OEM, no modelo e nas
classificações de megawatt. Talvez o operador de vento queira fechar contratos de garantia
favoráveis mostrando que as lâminas estão funcionando com segurança. Ou o operador pode

quere monitorar parâmetros, como pressão do rolamento a óleo, tensão máxima, fator de
energia ou desempenho dos freios eletrônicos e mecânicos minutos antes de as falhas no
processo ocorrerem. Em todos esses casos, será possível associar as estruturas de eventos aos
atributos da estrutura de eventos específica.
O exemplo do moinho de vento do Asset Framework pode incluir esses atributos de ativos e
atributos da estrutura de eventos associados.
Atributo do ativo Atributo da estrutura de eventos
RPM Velocidades instantânea e máxima
Tensão Tensão máxima
Potência Potência atual
Ângulo Ângulo atual
Inclinação Inclinação atual
Pressão do rolamento a óleo Pressão máxima do rolamento a óleo
Porque todos os tipos de turbina compartilham muitos atributos idênticos, é possível criar
apenas um template da estrutura de eventos e usá-lo para monitorar eventos similares nos
diferentes ativos. Por exemplo, talvez o usuário esteja interessado no atributo RPM para
capturar um evento baseado na velocidade. Usar essa notação especial ".\Elements[.]|RPM" no
template permite o uso do template em qualquer moinho de vento e o acesso ao atributo do
determinado elemento referenciado.
Exemplo de estruturas de eventos usando o PI Asset-Based Analytics

Para obter um exemplo sobre como criar estruturas de eventos usando análises baseadas em
ativos no PI Server 2014, consulte Criar automaticamente estruturas de eventos para
monitorar dados.
Vantagens das PI Event Frames

Estas são as vantagens das PI Event Frames:
• Flexibilidade
Estruturas de eventos:
◦ Referencia vários elementos no mesmo evento.
◦ Oferece suporte a vários eventos de sobreposição em um elemento PI AF.
◦ Captura qualquer evento; um "lote" é apenas um tipo de evento que pode ser capturado.
• Opções de pesquisa fácil

As pesquisas podem ser especificadas em diversos atributos configuráveis da estrutura de
eventos: a especificação de um intervalo de tempo é opcional. Por exemplo, é possível fazer
pesquisas apenas inserindo o nome da estrutura de eventos. Os atributos mais pesquisados
da estrutura de eventos podem ser configurados como atributos indexados por meio de
templates da estrutura de eventos, que acelera as pesquisas do usuário final.
• Escalabilidade
As PI Event Frames são extremamente escaláveis, enquanto que o desempenho da pesquisa
diminui com grande número (dezenas de milhares) de lotes.

PI Event Frames ou PI Batch?

O PI Batch fornece meios para geração de dados de eventos em lote baseados em PI Tags. As PI
Event Frames fornecem um modo de monitorar e analisar os dados de negócios e processos
relacionados aos eventos definidos nos atributos PI AF.
Diferentes empresas e usuários têm diferentes níveis de implementação do PI System e de uso
dos recursos PI, por isso, é recomendação de uso do PI Batch ou das PI Event Frames é
extremamente subjetivo. Pode-se escolher entre o PI Batch ou as PI Event Frames dependendo
das necessidades de negócios e processos, como:
• Ser um usuário PI Batch e usar tendências de substituição ou RtReports.
Deve-se continuar a usar o PI Batch. Entre os casos de uso comuns do PI Batch estão
execuções de avaliações em papel, operações de processamento de lote químico e assim por
diante.
• O PI Batch não é usado, mas há casos de uso em lote, necessidade de tendências de
substituição ou necessidade de uso do RtReports.
Deve-se usar o PI Batch. A OSIsoft fornecerá um caminho de migração no futuro, quando o
PI System tiver suporte a essas funções.
• O PI Batch não é usado e não há casos de uso em lote.
Deve-se usar as PI Event Frames. Casos de uso comuns de estruturas de evento PI incluem
inatividade ou queda nas usinas de energia, excursões em usinas de saneamento e assim por
diante.
Nota:
A OSIsoft não recomenda executar instâncias duplas ou paralelas de lotes e interfaces de
estruturas de eventos na produção, pois isso é adicionado à complexidade da migração.
Funcionalidade não suportada do PI System com PI Event Frames
• Tendência de substituição (substituição do PI BatchView) — Esta visualização da estrutura

de eventos não está disponível atualmente no PI Coresight, mas pode ser complementada
por produtos parceiros de terceiros.
• RtReports — PI AF e estruturas de eventos não são atualmente suportadas pelo RtReports;
no entanto, pode-se usar os produtos de acesso ao PI System, como o PI OLEDB Enterprise,
para gravar consultas SQL de soluções de geração de relatórios de terceiros.
Formas de criar estruturas de eventos

As Estruturas de Eventos podem ser criadas de várias formas, usando diferentes produtos de
suporte da OSIsoft. A OSIsoft recomenda usar suporte a análises baseadas em ativos no PI
Server 2014 para criar estruturas de eventos.
• Usar análises baseadas em ativos no PI AF

O PI Server 2014 suporta a criação de eventos de camada única e pode acionar expressões
que abrem ou fecham estruturas de eventos.
• Usar o PI Event Frame Generator (PI EFGen)

O PI EFGen usa o PI SDK e o AF SDK para criar uma hierarquia de eventos ou para converter
uma estrutura PI BaGen para uma estrutura de gerador de estrutura de eventos. Use o PI
System Explorer ou o PI Builder para criar os templates da estrutura de eventos associados

e às referências do ponto PI. Para obter instruções detalhadas sobre como criar estruturas
de eventos usando o PI EFGen, assista ao vídeo Como criar eventos, atributos e templates PI
EF no Canal de Aprendizagem da OSIsoft.
• Usar a interface do PI para sistemas de execução em lote ou de fabricação

O PIBatch Framework 3.x e versões posteriores pode criar estruturas de eventos em um
banco de dados PI AF ou em objetos PI Batch em um banco de dados PI Batch. Para obter
mais informações sobre a criação de estruturas de evento e o uso do de interfaces PI para
preencher o banco de dados do PI AF com dados baseados em eventos, consulte o tópico da
PI Live Library PI interfaces para sistemas de execução em lote ou de fabricação.
• Usar interfaces programáveis

É possível criar o próprio programa personalizado usando o PI AF SDK e o PI ACE para criar
e monitorar eventos.
• Criar estruturas de eventos manualmente

A OSIsoft desencoraja a criação e o gerenciamento manuais de estruturas de eventos e
encoraja o uso do PI Server 2014 com o suporte a Análise baseada em ativo ou o PI Batch,
dependendo das necessidades de processo. Consulte PI Event Frames ou PI Batch?
Templates da estrutura de eventos

Usar os templates da estrutura de eventos permite a definição e a padronização dos dados
relacionados (atributos da estrutura de eventos) associados a diferentes tipos de eventos. É
possível usar os atributos da estrutura de eventos para fornecer mais contexto sobre os
eventos úteis para pesquisas. Por exemplo, os eventos de inatividade geralmente têm um
código de motivo que os usuários desejam pesquisar ou filtrar durante a análise de seus
eventos de inatividade.
Também é possível configurar os atributos da estrutura de evento para referencia os dados do
processo no contexto do evento. Por exemplo, é provável que um evento de excursão de
temperatura tenha um atributo para a temperatura máxima. As PI Event Frames calcularão
automaticamente esses valores. Além disso, para cada tipo de evento, pode-se configurar um
índice para os atributos mais pesquisados: isso viabiliza pesquisas mais rápidas e fáceis usando
o PI System quando vários tipos de eventos ou milhões de eventos são monitorados.
Podem-se criar templates da estrutura de eventos no PI System Explorer pela guia Biblioteca
no painel esquerdo, clicando com o botão direito do mouse em Templates das Estruturas de
Eventos e selecionando Novo Padrão.
Os parâmetros de substituição em um template da estrutura de eventos do formulário .
\Elements[.]|Attribute, instrua que a estrutura de eventos selecione o atributo no
elemento de referência primário. Essa simples notação tem vários usos práticos e torna
desnecessário ter templates separados para cada ativo associado a uma estrutura de eventos.
Por exemplo, .\Elements[.]|Temperature direciona o servidor para ir para o elemento de
referência primário e recupera seu atributo Temperature.
Visualizar estruturas de eventos usando ferramentas cliente

PI Datalink, PI Coresight e PI WebParts são as ferramentas cliente com suporte à visualização
da estrutura de eventos. Também é possível usar o PI OLEDB Enterprise, o PI JDBC Driver ou o
PI Web Services para integrar os dados do PI Event Frame em outras ferramentas de geração
de relatório de terceiros.

Nota:
O PI Process Book, o PI BatchView e o PI Manual Logger atualmente não têm suporte à
visualização da estrutura de eventos.
• PI Datalink
O PI Datalink tem suporte às estruturas de eventos, inclusive à exploração e comparação de
eventos hierárquicos.
• PI Coresight
O PI Coresight permite a visualização e a análise dos dados do PI System durante o intervalo
de tempo de um evento em particular. Por exemplo, pode-se examinar o desempenho de um
ativo durante o turno de um operador ou comparar os dados de vários ativos durante o
tempo de inatividade.
O PI Coresight tem suporte às estruturas de eventos por meio do visualizador "Eventos
Relacionados". Para obter mais informações, consulte o tópico Descobrir e analisar eventos
da PI Live Library.
Nota:
O PI Coresight não tem suporte às tendências de substituição. Para obter mais
informações sobre como escolher entre o PI Batch e os PI Event Frames, consulte
• PI WebParts
O PI WebParts não incluem recursos específicos relacionados à visualização da estrutura de
eventos. No entanto, pode-se criar um conjunto de dados baseado em uma fonte de dados
relacionais que recuperam dados da estrutura de eventos pelo PI OLEDB Enterprise. Esses
dados da estrutura de eventos podem ser exibidos em uma web part da tabela PI, por
exemplo, e usados para fornecer contexto, como a hora de início e o tempo final, a outras
web parts na página.
Representar eventos no PI Asset Framework

Nesta seção
• Trabalhar com estruturas de eventos
• Trabalhar com transferências
• Captura de valores para estruturas de eventos e transferências
• Bloquear uma estrutura de eventos ou transferência
Trabalhar com estruturas de eventos

Use o PI System Explorer para trabalhar com estruturas de eventos.
Nesta seção
• Criar uma estrutura de eventos
• Alterar templates ou adicionar um template

Criar uma estrutura de eventos

Procedimento
1. No PI System Explorer, clique em Estrutura de Eventos no painel Navegador.
2. No Navegador, clique com o botão direito do mouse na coleção Pesquisas de Estruturas de
Eventos e selecione Nova Estrutura de Evento.
A janela Escolher Modelo da Estrutura de Eventos é exibida.
3. No campo inferior da janela Escolher Modelo da Estrutura de Eventos, selecione um template
da estrutura de eventos. Se não se desejar basear a estrutura de eventos em um template,
selecione Nenhum e clique em OK.
A nova estrutura de eventos é exibida no Visualizador contendo quatro guias para
configurar essa estrutura. A guia Geral contém as propriedades básicas da estrutura de
eventos. Os campos incluem:
◦ Template: Exibe o template selecionado ao criar a estrutura de eventos. Para examinar o

template, clique em . Para alterar o template, clique com o botão direito do mouse na
estrutura de eventos no Navegador e clique em Converter > Alterar Padrão.
◦ Atributo Padrão: Somente leitura para elementos baseados em templates. Consulte
Atributo padrão para obter mais informações. Este campo é somente leitura se a
estrutura de eventos está baseada em um template.
Nota:
objetos PI AF. Por exemplo, o PI WebParts armazena ícones e URLs nas propriedades
estendidas de um elemento PI AF. Os aplicativos geralmente usam as informações
armazenadas nas Propriedades estendidas de forma programática com o PI AF SDK.
Em geral, os usuários do PI System Explorer não precisam usar esse recurso avançado.
4. Edite as outras guias conforme necessário. Para obter mais informações, consulte Criar
atributos nas estruturas de eventos e Configurar elemento de referência primário.
Nesta seção
• Configurar elemento de referência primário
• Pesquisar uma estrutura de eventos
• Criar atributos nas estruturas de eventos
Configurar elemento de referência primário

Cada estrutura de eventos faz referência a um ou mais elementos. A guia Elementos
Referenciados da estrutura de eventos relaciona todos os elementos acessados pela estrutura
de eventos. O principal elemento referenciado pela estrutura de eventos é chamado de
elemento referenciado primário e é indicado por uma marca de verificação no ícone de
elemento .
Por padrão, o primeiro elemento referenciado adicionado é configurado como sendo o
elemento primário referenciado.
1. Clique com o botão direito do mouse no elemento a ser tornado o elemento primário
referenciado.
2. Selecione Configurar como referência de elemento primário no menu que aparece.

Nota:
Se você excluir a referência ao elemento primário, o PI System Explorer não define
automaticamente um novo elemento primário referenciado. Você deve repetir estas
etapas para criar manualmente um novo elemento primário referenciado.
Pesquisar uma estrutura de eventos
Procedimento
Nota:
2. Clique com o botão direito do mouse na coleção Pesquisas de Estruturas de Eventos e
selecione Nova Pesquisa no menu resultante.
A janela Critérios de Pesquisa da Estrutura de Eventos é exibida.
3. Insira os critérios de pesquisa para encontrar as estruturas de eventos. Note que o triângulo
no final do campo Pesquisa permite alterar entre operadores, como: Contém e Começa com.
Marque a caixa de seleção Em andamento para que apenas estruturas de eventos sem um
Tempo Final sejam retornadas.
No campo Nome, podem-se inserir caracteres especiais para corresponderem a parte de um
nome. Para obter mais informações, consulte Caracteres especiais nas pesquisas por nome.
Para adicionar campos aos critérios adicionais especificados, clique em Adicionar Critérios e
selecione um parâmetro na lista.
Pode-se usar o critério Raiz de Pesquisa de Estrutura de Evento para especificar que apenas
as estruturas de eventos filho da estrutura de evento especificada estão inclusas nos
É possível adicionar dois critérios Duração, se necessário. Por exemplo, para pesquisar uma
estrutura de eventos cuja duração foi de pelo menos uma hora, mas no máximo três horas, é
possível configurar dois campos de duração.
a. Selecione maior que ou igual ao operador (>=) e insira 1h no campo
b. Selecione menor que ou igual ao operador (<=) e insira 3h no campo
4. Depois de configurar os critérios de pesquisa, clique em Pesquisar.
Os resultados da pesquisa aparecem na área Resultados da pesquisa da janela Critérios de
Pesquisa da Estrutura de Eventos.
5. Para refinar ainda mais a pesquisa, digite os dados no campo de texto na parte superior da
área Resultados da Pesquisa. Enquanto digita, os resultados da pesquisa são filtrados.
Criar atributos nas estruturas de eventos
Procedimento
1. Encontre e selecione a estrutura de eventos pai no Navegador.
2. Selecione a guia Atributos no Visualizador.

3. Clique com o botão direito do mouse no campo de atributos e selecione Novo Atributo no
menu resultante.
Nota:
Se a estrutura de eventos for baseada em um template, não será possível adicionar um

atributo, a não ser que o template permita extensões.
4. No campo Nome, insira um nome para o atributo.
5. No campo Descrição, insira uma descrição para o atributo.
6. Marque a caixa de seleção Item de Configuração dos atributos quando uma alteração no
valor resultar em uma alteração de revisão do elemento. Desmarque a caixa de seleção dos
atributos com valores que serão alterados com o processo.
7. Podem-se organizar objetos agrupando-os em categorias. Para navegar as categorias
disponíveis, clique em . Essa etapa é opcional.
8. Na caixa UOM Padrão, selecione a unidade de medida do atributo.
9. Na caixa Tipo de Valor, selecione o tipo de dados do atributo.
10. No campo Valor, insira um valor estático para o atributo. Essa caixa é somente leitura
quando uma referência de dados determina o valor.
11. Para usar uma referência de dados para determinar o valor do atributo, selecione-o na caixa
Referência de Dados.
12. Se uma referência de dados for selecionada, clique em Configurações para configurá-la. Para
obter detalhes sobre como configurar uma referência de dados, consulte Referência de
dados.
Alterar templates ou adicionar um template

É possível alterar o elemento no qual uma estrutura de eventos está baseada ou adicionar um
template a uma estrutura de eventos que não está baseada em um template.
Procedimento
1. No PI System Explorer, clique no botão Estrutura de Eventos no painel Navegador.
2. No Navegador, clique com o botão direito do mouse na coleção Pesquisas de Estruturas de
Eventos e selecione Nova Pesquisa no menu resultante.
3. Pesquise a estrutura de eventos a ser alterada.
A coleção dos resultados de pesquisa aparece no Navegador.
4. Clique com o botão direito do mouse na estrutura de eventos apropriada no navegador e
clique em Converter > Alterar Template.
A janela Escolher Template de Estrutura de Evento se abrirá.
5. Escolha um template desejado da lista e clique em OK.
Trabalhar com transferências

Este capítulo descreve como definir, configurar e trabalhar com transferências no PI System
Explorer.
Nesta seção
• Transferências

• Criar uma transferência
Transferências
As transferências são um tipo de estrutura de eventos. Elas movimentam materiais em
quantidades discretas. E têm uma hora de início e um tempo final. Elas são exclusivas em um
modelo, pois são temporais e aparecem em um modelo apenas quando uma nova transferência
de materiais ocorre. Por exemplo, use as transferências para monitorar os movimentos de
entrada e saída dos materiais da instalação, monitorar as matérias-primas usadas no processo
e os produtos finalizados armazenados e monitorar as transferências de materiais entre os
tanques.
Criar uma transferência

Procedimento
Nota:

2. Clique com o botão direito do mouse na coleção Transferir Pesquisas e selecione Nova
Transferência no menu que é exibido.
A janela Escolher Modelo de Transferência é exibida.
3. Escolha um template existente na nova transferência e selecione <Nenhum>.
4. Clique em OK.
5. Use as opções na Palete para configurar a transferência.
◦ Propriedades da transferência — guia Geral
◦ Propriedades da transferência — guia Atributos
◦ Propriedades da transferência — guia Portas
Nesta seção
• Propriedades da transferência — guia Geral
• Propriedades da transferência — guia Atributos
• Propriedades da transferência — guia Portas
Propriedades da transferência — guia Geral

As seguintes configurações estão na guia Geral:
• Nome: insira um nome para a transferência.

• Descrição: insira uma descrição para a transferência (opcional).
• Template: Somente leitura. Mostra o template escolhido na criação do elemento, se houver.
Para visualizar as propriedades do template, clique em .

• Categorias: Somente leitura para transferências baseadas em templates. Podem-se

organizar objetos agrupando-os em categorias (opcional). Para navegar as categorias
disponíveis, clique em . Consulte Categorias para obter mais informações.
• Nas caixas Hora de Início/Tempo Final, insira a hora de início e o tempo final da
transferência. Para procurar uma data, clique em . O PI System Explorer tem suporte ao
autopreenchimento nesta caixa.
• Nas caixas Origem/Porta, selecione o elemento e a porta fornecendo o material da
transferência. O PI System Explorer tem suporte ao autopreenchimento nesta caixa.
• Nas caixas Destino/Porta, selecione o elemento e a porta que estão recebendo a
transferência.
• Para atribuir um atributo padrão, clique em ao lado da caixa Atributo Padrão para exibir
uma lista de atributos disponíveis. Então, selecione o atributo. Observe que é necessário
adicionar atributos na guia Atributos antes de eles aparecerem na lista. Essa caixa será
somente leitura se a transferência estiver baseada em um template; a caixa exibe o atributo
especificado no template.
Nota:
Propriedades estendidas são propriedades definidas por outros aplicativos nos objetos PI
AF. Por exemplo, o PI WebParts armazena ícones e URLs nas propriedades estendidas de
um elemento PI AF. Os aplicativos geralmente usam as informações armazenadas nas
Propriedades estendidas de forma programática com o PI AF SDK. Em geral, os usuários
do PI System Explorer não precisam usar esse recurso avançado.
Propriedades da transferência — guia Atributos

As seguintes configurações estão na guia Atributos:
• Nome
Insira um nome para o atributo.
• Descrição
Insira uma descrição para o atributo (opcional).
• Item de Configuração
Marque esta caixa quando uma alteração no valor resultar em uma alteração de revisão do
elemento. Desmarque a caixa de seleção dos atributos com valores que serão alterados com
o processo.
• Categorias
Somente leitura para atributos baseados em templates. Podem-se organizar objetos
agrupando-os em categorias (opcional). Para navegar as categorias disponíveis, clique em
. Consulte Categorias para obter mais informações.
• UDM
A unidade de medida do atributo. Pode-se alterar a UDM exibida no atributo no PI System
Explorer; no entanto, a UDM definida no template não é alterada.
• Tipo de Valor
Selecione o tipo de dados do atributo.
• Valor

Insira um valor estatístico para o atributo. Somente leitura quando uma referência de dados
determina o valor.
• Referência de Dados
Selecione um tipo de referência de dados ou nenhum se este não for um atributo da
referência de dados. Se for um atributo da referência de dados, clique em Configurações
para configurar a referência de dados (Associação de dados com ativos).
Propriedades da transferência — guia Portas

As seguintes configurações estão na guia Portas: É possível editar os valores nas colunas ou
clicar com o botão direito do mouse na nova porta, selecionar Propriedades e preencher a caixa
de diálogo Propriedades da Porta.
Nota:
Para especificar essa porta como padrão, é necessário abrir a caixa de diálogo
Propriedades.
• Na caixa Nome, insira o nome para a porta.

• Na caixa Descrição, insira uma descrição para a porta. Uma descrição é opcional.
• Na caixa Tipo de Porta, selecione o tipo de porta: Entrada, Saída ou Não Direcionada (para
medidores, por exemplo).
• Na caixa Categorias Permitidas, selecione as categorias às quais a porta tem autorização
para ser membro.
• Na caixa Número máximo de conexões, especifique o número máximo de conexões que
podem ser feitas com a porta. Insira zero para obter um número ilimitado de conexões.
• Na caixa Tipo de Conexão, selecione os tipos de elementos aos quais a porta pode se
conectar, por exemplo, Nó, Limite, Medida etc.
• Na caixa Modelos Permitidos, selecione o tipo de elementos que podem ser conectados à
porta. Selecione apenas os elementos criados no template selecionado.
Captura de valores para estruturas de eventos e transferências

Para exibir valores de uma estrutura de eventos ou transferência, o AF executa referências de
dados para recuperar valores de atributos associados do período. No entanto, pode-se usar a
opção Capturar Valores para salvar esses valores no AF. Isso pode melhorar o desempenho, já
que é mais fácil exibir os valores salvos que recuperá-los.
Também é possível usar a opção Capturar Valores para garantir que os valores de atributo
exibidos nas estruturas de eventos sejam os mesmos em qualquer ponto futuro. Além disso,
Capturar Valores fornece uma forma para preservar os valores que não estarão disponíveis
mais tarde, como transmitir dados que não persistem no logo tempo.
Quando a opção Capturar Valores é aplicada a um grupo, como uma coleção Pesquisa de
Estrutura de Eventos, ou a uma estrutura de eventos contendo estruturas de eventos filho, ela
afeta todas as estruturas de eventos do grupo.
Capturar valores
Use a opção Capturar Valores para salvar a estrutura de eventos ou transferir valores de
atributos no AF. Fazer isso pode melhorar o desempenho, já que é mais rápido recuperar e
exibir os valores salvos que executar as referências de dados para recuperá-los.

Procedimento
1. No PI System Explorer, clique em Estrutura de Eventos no painel Navegador.
2. No Navegador, clique com o botão direito do mouse na estrutura de eventos, na
transferência ou em uma coleção (como uma Pesquisa de Estrutura de Eventos) e selecione
Capturar Valores. (Nas capturas de valores subsequentes, a seleção é Recapturar Valores.)
Quando a opção Capturar Valores é aplicada a um grupo, como uma coleção Pesquisa de
Estrutura de Eventos, ou a uma estrutura de eventos contendo estruturas de eventos filho,
ela afeta todas as estruturas de eventos do grupo.
Bloquear uma estrutura de eventos ou transferência

Depois que a ação subjacente de uma estrutura de eventos ou transferência for concluída (por
exemplo, após a conclusão de um lote), a estrutura de eventos ou transferência ainda
continuarão abertas e poderão continuar a receber dados. Pode-se bloquear uma estrutura de
eventos ou transferência, impedindo futuras alterações nelas.
Para desbloqueá-las, é necessário ter permissão de Administrador. Apenas usuários com
permissões de Administrador sobre um objeto têm a capacidade de desbloqueá-lo.
Procedimento
1. No PI System Explorer, clique no botão Estrutura de Eventos no painel Navegador.
2. No Navegador, abra a coleção Pesquisas de Estruturas de Eventos (ou Transferir Pesquisas)
contendo o objeto a ser bloqueado.
3. Clique com o botão direito do mouse no objeto e selecione Bloquear no menu.
Um ícone de cadeado aparece ao lado do nome do objeto.


Tópicos avançados
Esta seção fornece informações de referência, informações sobre os utilitários do PI AF,
instruções sobre como criar tipos de referência personalizada, gerenciamento de plug-ins e
muito mais.
Nesta seção
• Strings de configuração do atributo
• Atualizações em massa das strings de configuração
• Sintaxe de referência do atributo
• Recursos do PI AF
• Persistência
• Restrições nos nomes de objeto AF
• Inserir valores nos tipos de valores
• Criar tipos de referência personalizada
• Copiar caminhos
• Armazenar informações específicas do aplicativo
• Gerenciar plug-ins
• Modelar um processo
Strings de configuração do atributo

A string de configuração do atributo define completamente o atributo de referência de dados. A
sintaxe para uma string de configuração depende do tipo de referência de dados. Para ver a
string de configuração do atributo no PI System Explorer, selecione o atributo do AF na guia
Atributos. A string de configuração é exibida na caixa no botão Configurações. É possível
selecionar e copiar a string ou editá-la para editar a referência de dados.
No PI System Explorer, ao selecionar um atributo com uma referência de dados, a string de
configuração aparece na caixa de texto abaixo do botão Configurações. As strings de
configuração podem ser diretamente editadas na caixa de texto.
A seguinte tabela contém exemplos de strings de configuração para diferentes tipos de
referências de dados:
Tipo de referência de String de configuração de amostra
dados
Formula D=Density;V=Volume;[D*V]
A=Attribute3;[A*3];UOM=cm
Ponto PI \\My_PI_Server\sinusoid
\\192.168.0.255\ChocMilkMeter;TimeMethod=TimeRange;
RelativeTime=-1h;TimeRangeMethod=Total;ReadOnly=False
Matriz do ponto PI \\My_PI_Server\Point.1|Point.2|Point.3
Criador de Strings "%Attribute% value is";'Attribute1';
Pesquisa de Tabela SELECT Density FROM [Material Specifications] WHERE
MaterialID = @Product

Tópicos avançados
Nesta seção
• Strings de configuração para referências de dados do PI Point
• Especificação do PI Point
• Configuração do valor do atributo
• Strings de configuração para criação automática de pontos
Strings de configuração para referências de dados do PI Point

Esta seção descreve a sintaxe da string de configuração para referência de dados do PI Point. A
string de configuração do atributo para as referências de dados do PI Point contém o caminho
para o ponto (por exemplo, \\My_PI_Server\sinusoid). Ela também pode conter algumas opções
de configuração, separadas por ponto-e-vírgula. As opções de configuração incluem:
• Referência do PI Point (obrigatória, sempre no início da string)

• configuração de recuperação do valor do atributo (opcional)
• unidades de medida (opcional)
• parâmetros de substituição (opcional)
• especificações de criação de pontos — válidos apenas para templates de atributo (opcional)
Exemplos: Referências de dados do PI Point

Estes são alguns exemplos:
• Referência simples a um ponto em um PI Server chamado MyPIServer:

\\MyPIServer\sinusoid
• String de configuração que faz referência ao mesmo ponto, mas com uma especificação de
recuperação de tempo e unidades de medida especificadas:
\\MyPIServer\sinusoid;TimeMethod=ExactTime;UOM=°C
• String de configuração que faz referência ao mesmo ponto, mas retorna um valor total de
pontos em um intervalo de tempo ():
\\MyPIServer
\sinusoid;TimeMethod=NotSupported;TimeRangeMethod=Total;RateConversion=day
• String de configuração de um template de atributo que usa parâmetros de substituição:
\\%Server%\%Element%.%Attribute%
• Mesma string de configuração, mas com criação de tag ativada e configuração do ponto
especificada:
\\%Server%\%Element%.%Attribute
%;ptclassname=classic;pointtype=Float32;engunits=m3/
s;location1=1;location2=30;location4=1;location5=1;pointsource=R
Especificação do PI Point
Para fazer referência ao PI Point, é possível usar uma referência direta ou indireta. Consulte
Especificar o PI Point para obter mais informações.
Nesta seção
• Referência direta do PI Point
• Referência indireta

Tópicos avançados
Referência direta do PI Point

Na string de configuração, uma referência de dados direta usa duas barras invertidas (\\) para
fazer referência a um PI Point em um PI Server. Por exemplo, para fazer referência ao ponto
sinusoid em um PI Server chamado MyPIServer:
\\MyPIServer\sinusoid
Nos templates de atributo, também é possível usar os parâmetros de substituição na referência.

Por exemplo, para fazer referência ao ponto sinusoid no PI Server padrão do banco de dados AF
do atributo:
\\%Server%\sinusoid
Referência indireta
Para fazer referência a outro atributo, a string de configuração usa um caminho relativo. O
caminho relativo identifica um atributo da referência de dados baseado em seu nome e seu
lugar na hierarquia de elementos e atributos. Nas referências de dados PI Point, o caminho
deve incluir uma designação de caminho de atributo (| ou ..) na string de configuração para que
ela seja diferenciada de uma referência de dados PI Point.
A seguinte tabela mostra as configurações comuns das referências indiretas:
Objeto Sintaxe de exemplo
Atributo de nível superior do mesmo elemento |topLevelAttribute
Atributo pai ..
Atributo filho .|childAttribute
Atributo irmão (quando não é um atributo de nível ..|siblingAttribute
superior)
Da estrutura de eventos para o elemento primário .\Elements[.]|attribute
Caminho completo \\myServer\myDatabase\myElement|
myAttribute
Consulte Sintaxe de referência do atributo para obter mais detalhes sobre a sintaxe de caminho
relativo.
Nota:
Nas referências indiretas para os PI Points, o atributo referenciado de ser um atributo da
referência de dados PI Point.
Configuração do valor do atributo

Se a configuração padrão for usada, a string de configuração não incluirá a configuração do
valor do atributo. No PI System Explorer, a configuração padrão significa que o campo Por hora
está definido como Automático. No entanto, se o campo Por hora for definido como um valor
diferente, a string de configuração incluirá essas configurações. Por exemplo, se Tempo exato
for selecionado, a string de configuração mostrará:
TimeMethod=ExactTime
No seguinte exemplo, TimeMethod, RelativeTime e TimeRangeMethod são opções de string

de configuração.
\\MyPIServer\BA:CONC.
1;TimeMethod=TimeRangeOverride;RelativeTime=-1h;TimeRangeMethod=Total;RateConversi
on=day

Tópicos avançados
As configurações de recuperação do valor usam o tempo padrão do PI System Explorer para

determinar o tempo ou o intervalo de tempo dos valores exibidos do atributo. Para exibir os
valores do atributo para outro tempo ou intervalo de tempo, é possível usar Definir contexto de
tempo para substituir as configurações de tempo padrão. Consulte Definir o contexto de tempo
para os valores exibidos do atributo.
Opções para strings de configuração do valor

A seguinte tabela relaciona as opções disponíveis para as strings de configuração do valor:
Opções Sintaxe Valores Exemplo
opção tempo TimeMethod=<método no qual o método de TimeMethod=Automatic
de tempo> tempo é um destes:
After|AtOrAfter|Before|
AtOrBefore|Automatic|
ExactTime|Interpolated|
NotSupported|
TimeRange|
TimeRangeOverride
opção de tempo relativo RelativeTime=[*] +|- no qual a unidade de RelativeTime=-1h
<número tempo é uma destas: y|
inteiro><unidade de M|d|h|m|s
tempo>
opções de intervalo de TimeRangeMethod=<mé no qual o método de TimeRangeMethod=Tot
tempo todo de intervalo de intervalo de tempo é um al
tempo> destes: Maximum|
Minimum|
PopulationStandardDevi
ation|Range|
StandardDeviation|
StartTime|Total
percentual mínimo TimeRangeMinPercentG
válido de intervalo de ood=<porcentagem>
tempo1
opção da base de cálculo CalculationBasis=<base no qual a base de cálculo
do intervalo de tempo1 de cálculo> é uma destas:
EventWeighted|
EventWeightedExcludeE
arliestEvent|
EventWeightedExclude
MostRecentEvent|
EventWeightedIncludeB
othEnds|TimeWeighted|
TimeWeightedContinou
s|
TimeWeightedDiscrete
opção de conversão de RateConversion=<udm> no qual a udm é uma RateConversion=minute
taxa2 Unidade de Medida
definida
opção de caso case option=Case no qual o método do Case Method=EndTime
Method=<método do caso é um destes:
caso> StartTime|EndTime|
TimeRange|Automatic
opção de UDM UOM=<udm> no qual a udm é uma UOM=°C
Unidade de Medida
definida

Tópicos avançados
Opções Sintaxe Valores Exemplo

opção de somente ReadOnly=<booliano> no qual o booliano é um ReadOnly=false
leitura destes: true|false
1usado ao especificar uma opção de intervalo de tempo
2usado apenas quando TimeRangeMethod=Total
Strings de configuração para criação automática de pontos

Se um template de atributo estiver sendo configurado, será possível usar a opção Criação de
tag para criar automaticamente PI Points para qualquer atributo baseado nesse template. A
string de configuração especifica pelo menos o tipo de ponto:
\\%Server%\%Element%.%Attribute%;pointtype=Float64
A string acima especifica que as tags são do tipo Float64 e que o restante da configuração do
ponto usa as configurações padrão. Quaisquer alterações feitas nas configurações padrão são
incluídas na string de configuração. Veja a seguinte string de configuração, por exemplo:
\\%Server%\%Element%.%Attribute
%;ptclassname=classic;pointtype=Float32;location4=1;location5=2;pointsource=R;span
=200;zero=1100
A string de configuração acima especifica as seguintes configurações de criação de tag:

Nome Configuração
ptclassname classic
pointtype Float32
pointsource R
location4 1
location5 2
span 200
zero 1100
Atualizações em massa das strings de configuração

A ferramenta de linha de comando afupdatepluginconfigurations permite a atualização de
várias strings de configuração do atributo com apenas um comando.
Quando a ferramenta for executada:
1. Use o parâmetro -root para especificar em qual PI System e, como opção, em qual banco de
dados AF, as atualizações serão feitas.
2. Escolha um dos modos de atualização, descritos a seguir, especificando uma das três opções
de atualização: -CreateConfig, -Repair ou -ReplacePIServer.
3. (Opcional): Primeiro, a linha de comando pode ser executada com a opção -list. Em vez de
fazer as atualizações, a ferramenta listará todos os atributos a serem executados.
4. Depois de executar a ferramenta, clique em Atualizar no PI System Explorer para ver as
alterações ( ).

Tópicos avançados
-CreateConfig
A opção -CreateConfig realiza em massa a mesma operação executada ao clicar com o botão
direito do mouse em um elemento ou em uma referência de dados PI Point e selecione Criar ou
Atualizar PI Point. Essa operação criará o PI Point se ele ainda não existir, ou o atualizará com
as alterações feitas. Por exemplo, se um novo atributo que seja uma referência de dados PI
Point for criado, mas o PI Point ainda não existir, no PI System Explorer, bastará clicar com o
botão direito do mouse no novo atributo AF e selecionar Criar ou Atualizar PI Point para criar o
novo ponto.
Para realizar a operação CreateConfig em massa, por exemplo, em todos os atributos em um
banco de dados AF específico, use o seguinte comando:
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase" -CreateConfig
Para executar a operação CreateConfig em todos os atributos em determinado PI System, use o

seguinte comando:
afupdatepluginconfigurations "-root:\\MyPISystem" -CreateConfig
-Repair
A opção -Repair permite que a correção dos atributos da referência de dados PI Point nos
quais a string de configuração armazenada ficou dessincronizada com o PI Server, por exemplo,
porque o PI Point que usa os pontos de referência de dados do atributo foi excluído ou
renomeado.
• PI Points excluídos
Se um PI Point tiver sido excluído e recriado com o mesmo nome, o ID do novo ponto não
corresponderá ao ID na string de configuração armazenada. A operação -Repair atualiza a
string de configuração com o novo ID do ponto.
• PI Points renomeados
Se um PI Point tiver sido renomeado, a string de configuração continuará a usar o nome
antigo do PI Point. A operação -Repair atualiza a string de configuração armazenada com o
novo nome do ponto.
• Atributos que não foram resolvidos
Se o PI Point para o qual a referência de dados aponta ainda não tiver sido criado, a string de
configuração não conterá o ID do ponto. Após a criação do PI Point, será possível usar a
operação -Repair para atualizar a string de configuração armazenada com o novo ID do
ponto.
O seguinte exemplo repara as strings de configuração armazenadas no banco de dados AF
especificado para que elas mapeiem corretamente os PI Points no PI Server:
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase" -Repair
-ReplacePIServer
A opção -ReplacePIServer permite que atualizações em massa sejam feitas no nome do PI
Server na string de configuração de vários atributos.
O seguinte comando atualiza todos os atributos em um banco de dados AF especificado para
um novo PI Server:
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase" -
ReplacePIServer:OldPIServerName;NewPIServerName
Nota:
Use dois-pontos (:) para preceder o nome do PI Server existente. Separe o nome do PI
Server existente do nome do PI Server novo com um ponto e vírgula (;).

Tópicos avançados
Sintaxe de referência do atributo

Para referenciar outro atributo, é possível usar um caminho que localize o atributo no servidor,
no banco de dados e no elemento nos quais reside. Um caminho absoluto especifica o servidor,
o banco de dados e o elemento reais nos quais o atributo está localizado. Um caminho relativo
identifica um atributo baseado em seu nome e é colocado na hierarquia de elementos e
atributos.
Ao usar filtros, índices e caracteres curingas, é possível criar uma expressão que represente um
caminho que possa encontrar um único atributo, ou vários caminhos que recuperem uma
coleção de atributos.
Sintaxe das especificações de caminho

É possível usar um caminho, como \\MyPISystem\MyAFDatabase\MyElement|Attribute1,
para referenciar um atributo.
Ao usar filtros, índices e caracteres curingas, é possível criar uma expressão que represente um
caminho que pode encontrar um único atributo ou uma coleção de atributos.
Componentes de um caminho
As partes do caminho são separadas por uma única barra invertida (\), com a seguinte exceção:
• Atributos AF e templates de atributo AF são precedidos pelo caractere de barra (|).
• O PI System ou o PI Server é precedido por duas barras invertidas (\\).
Pode-se especificar os PI Servers e os bancos de dados PI pelo nome ou pelo identificador
exclusivo global (GUID). Um GUID é um número exclusivo de 128 bits gerado pelo Windows
para identificar determinado componente, aplicativo, arquivo ou entrada de banco de dados.
GUIDs podem ser especificados entre colchetes ({ e }). Por exemplo:
\\{5c64c379-c182-4f35-8d30-78d8c2f84502}\{5c64c379-c182-4f35-8d30-78d8c2f84503}
Se ambos o nome e o GUID forem especificados, separe-os com um ponto-e-vírgula (;). O

primeiro especificado tem preferência na pesquisa, por isso, no seguinte exemplo, o GUID tem
preferência:
\\{5c64c379-c182-4f35-8d30-78d8c2f84502};MySystem\{5c64c379-
c182-4f35-8d30-78d8c2f84503};MyDatabase
As seguintes entidades podem ser incluídas em uma especificação de caminho:

• O tipo de coleção em que um objeto está localizado
• Um ou mais filtros da coleção
• Índices, para obter determinado membro de uma coleção
• O caractere curinga de asterisco (*) nos nomes dos objetos
Especificação PI Server
Um caminho totalmente qualificado é precedido por duas barras invertidas (\\) seguidas pelo
PI System ou PI Server.
Para indicar o sistema atual, comece um caminho relativo com duas barras invertidas seguidas
por um ponto (\\.). Por exemplo, \\.\Database2 referencia o banco de dados chamado
Database2 no sistema atual.
Para especificar uma coleção de PI Server, use o seguinte formato: \
\PIServers[MyPIServerName].

Tópicos avançados
Especificação de banco de dados AF

O banco de dados AF segue a especificação do PI System.
Pode-se iniciar um caminho relativo com uma barra invertida (\) para indicar o banco de dados
atual. Por exemplo, os caminhos \Element2 e \Tables[MyTable] referenciam objetos no
banco de dados atual.
Nota:
Pode-se acessar objetos que não fazem parte do banco de dados externos ao PI System.
Identifique a coleção conforme demonstrado no seguinte exemplo: \\MySystem
\Contacts[JSmith].
Usando parâmetros relativos

Use pontos duplos (..) para indicar o objeto pai. O seguinte exemplo referencia Attribute1 de
Element2 que está no banco de dados atual: ..\Element2|Attribute1. Não é possível fazer
referência a um objetos mais de um nível acima do objeto atual.
O período único (.) representa o objeto atual. Pode-se usá-lo para criar um caminho relativo
pelo objeto atual.
• Quando o objeto atual for um atributo AF, o período único seguido por uma barra invertida
(.\) representa o elemento AF de propriedade.
Por exemplo: .\|Attribute1. Um único período seguido por uma barra (.|) referencia um
atributo AF filho, por exemplo .|Attribute1|Attribute2.
• Quando o objeto atual é um elemento AF, um caminho relativo é criado pelo banco de dados.
Por exemplo: \Element1\Element2|Attribute1.
Caminhos para objetos dinâmicos também têm suporte. Por exemplo, PI Point Array.\
\piserver2\sinusoid|sinusoidu cria um atributo de matriz do PI Point com dois valores:
Sinusoid e Sinusoidu.
Se um caminho direcionar a um PI Point, um atributo dinâmico será criado. Por exemplo, \
\piserver2\sinusoid cria um atributo com a referência configurada para ler o valor pelo
Sinusoid do PI Point.
Coleções
Cada objeto pai tem um tipo de coleção padrão. Por exemplo, um PI System tem uma coleção de
bancos de dados padrão, e um banco de dados AF tem uma coleção de elementos padrão.
Use um período simples entre chaves ([.]) para representar o objeto padrão do objeto pai. O
seguinte exemplo faz refere-se a Element1 do banco de dados padrão no sistema atual:
\\.\Databases[.]\Element1
Filtros
Um filtro da coleção inicia com um sinal (@) seguido pelo nome do filtro. Os filtros suportados
são: @Name, @Index, @Template, @Category, @ReferenceType, @Description, @Type, @UOM.
A especificação do filtro deve estar entre chaves ([ e ]). O seguinte exemplo retorna o atributo
Volume de todos os elementos da categoria, Tutorial, que pertence ao banco de dados
chamado MyDatabase:
\\MySystem\Databases[MyDatabase]\Elements[@Category=Tutorial]|Volume
O próximo exemplo retorna os atributos de Element1 do tipo Int32:

\Element1|Attributes[@Type=System.Int32]
O seguinte exemplo retorna os atributos de Element1 cuja unidade de medida é metros:

\Element1|Attributes[@UOM=meter]

Tópicos avançados
Pode-se especificar vários filtros, que são avaliados na ordem especificadas. Por exemplo:
\\MySystem\MyDatabase\Elements[@Template=Tank][@Category=Tutorial]|
Attributes[@Category=Tutorial]
O filtro Índice
Use o filtro índic [@Index=int] ou [int] para especificar a posição do objeto correspondente
a ser retornado (o primeiro item está na posição 1 do índice). O filtro índice deve ser o último
filtro especificado. O seguinte exemplo retorna o terceiro banco de dados na coleção de bancos
de dados AF no sistema atual:
\\Systems[MySystem]\Databases[@Index=3]
O nome do filtro índice é opcional se outro filtro é especificado antes dele. Por exemplo:
\Element#1\Elements[@Name=Tank*][3]
O caractere curinga
Pode-se colocar um caractere curinga de asterisco (*) no nome de qualquer objeto para
corresponder a zero ou mais caracteres.
\\MySystem\MyDatabase\[@Name=E*]
\\MySystem\MyDatabase\Elements[@Name=E*][@Index=3]
Nota:
Para corresponder a um asterisco literal, preceda o asterisco por uma barra invertida
(\*).
Exemplos de atributos de referência do mesmo elemento

Para referenciar um atributo pertencente ao mesmo elemento, é possível
• Identificar o atributo relativo a seu atributo ancestral de nível superior. Consulte Caminho
completo do ancestral de nível superior.
• Identificar o atributo relativo ao atributo atual (o atributo para o qual a referência de dados
está sendo configurada): Consulte Especificar o irmão do atributo de referência, Especificar
um ancestral do atributo de referência e Especificar um descendente de um atributo ode
referenciação.
Os seguintes exemplos referem-se à imagem acima.

Tipo de referência Para referenciar este Deste atributo Tipo:
atributo
Atributo pai Nível Média |Level
ou
..

Tópicos avançados
Tipo de referência Para referenciar este Deste atributo Tipo:

atributo
Atributo avô Nível Intervalo |Level
ou
..|..
Atributo pai Média Intervalo |Level|Average
ou
..
Atributo irmão Média Mínimo |Level|Average
ou
Average
Atributo filho Média Nível |Level|Average
ou
.|Average
Atributo neto Intervalo Nível |Level|Average|
Interval
ou
.|Average|
Interval
Atributo de nível superior Temperatura qualquer atributo |Temperature
Nesta seção
• Caminho completo do ancestral de nível superior
• Especificar o irmão do atributo de referência
• Especificar um ancestral do atributo de referência
• Especificar um descendente de um atributo ode referenciação
Caminho completo do ancestral de nível superior

Para referenciar qualquer atributo com base em outro atributo pertencente ao mesmo
elemento, especifique todo o caminho do atributo do elemento. Inicie o caminho com o símbolo
de barra (|) e use-o para separar os níveis do atributo.
Por exemplo, a imagem a seguir mostra os atributos de um elemento chamado Reactor1:
O ancestral de nível superior do atributo Intervalo é Nível. Para referenciar o atributo Intervalo
de qualquer outro atributo do mesmo elemento, digite:
|Level|Average|Interval
Para referenciar qualquer atributo de nível superior de qualquer outro atributo do mesmo
elemento, insira o símbolo de barra seguido pelo nome do atributo. Por exemplo, para
referenciar o atributo Nível de qualquer lugar, digite:

Tópicos avançados
|Level
Para referenciar o atributo Temperatura de qualquer lugar, digite:

|Temperature
Especificar o irmão do atributo de referência

Para especificar um irmão, use o nome do atributo irmão. Nenhuma outra notação é necessária,
no entanto, a referência de dados PI Point requer que alguns caracteres de caminho do atributo
diferencie esta referência de uma referência PI Point. Nesses casos, use o caminho completo do
atributo do elemento.
No exemplo mostrado acima, os atributos Máximo e Mínimo são irmãos. Para referenciar o
atributo Máximo ao configurar o atributo Mínimo, digite:
Maximum
Especificar um ancestral do atributo de referência

Dois períodos (..) podem ser usados para mover a hierarquia de atributos para cima. Por
exemplo, para especificar o atributo pai, pode-se usar:
..
Pode-se usar esta notação para mover os elementos do ancestral do atributo para cima. Por
exemplo, para referenciar o atributo avô, pode-se usar:
..|..
A imagem a seguir mostra os atributos de um elemento chamado Reactor1:
Para referenciar o atributo Nível de qualquer atributo Médio, digite:

..
Porque Nível é um atributo pai de nível superior, também é possível inserir:

|Level

Tópicos avançados
Nota:
Não se pode usar esta notação para referenciar o atributo Temperatura do atributo
Médio, pois Médio não é um descendente de Temperatura. Além disso, não se pode usar
essa notação para referenciar o atributo Médio do atributo Intervalo, pois Médio não está
no nível superior da hierarquia do atributo.
Para referenciar o atributo Nível do atributo Intervalo, digite:
..|..
Não é possível usar essa notação para referenciar o atributo Máximo pelo atributo Intervalo,
pois o atributo Intervalo não é descendente do atributo Máximo. Nesse caso, será necessário
retornar um caminho completo:
|Level|Maximum
Da mesma forma, para referenciar o atributo Temperatura pelo atributo Intervalo, use
|Temperature
Especificar um descendente de um atributo ode referenciação

Pode-se usar um período (.), que identifica "este atributo", seguido pelo caminho para
referenciar um atributo filho.
A imagem a seguir mostra os atributos de um elemento chamado Reactor1:
Para referenciar o atributo Médio de qualquer lugar, digite:

.|Average
Para referenciar o atributo Intervalo do atributo Nível qualquer lugar, digite:

.|Average|Interval
Não é possível usar essa notação para referenciar o atributo Intervalo pelo atributo
Temperatura, pois o atributo Intervalo não é descendente do atributo Temperatura. Nesse
caso, será necessário retornar um caminho completo.
|Level|Average|Interval
Exemplos de atributos de referência de diferentes elementos

É possível referenciar atributos que pertençam a diferentes elementos das seguintes formas:
• Diretamente da parte superior da hierarquia de elementos no banco de dados (Atributo

relativo ao banco de dados)
• Especificando o elemento pai do atributo de destino usando um caminho relativo (Atributo
relativo ao elemento contido).
Nesta seção
• Atributo relativo ao banco de dados
• Atributo relativo ao elemento contido

Tópicos avançados
Atributo relativo ao banco de dados

Para fazer referência a um atributo baseado em um caminho relativo à raiz do banco de dados
AF, especifique todo o caminho dos atributos e elementos no banco de dados. Inicie o caminho
com uma barra invertida (\) e use-a para separar os níveis de elementos. Preceda o atributo
com uma barra (|). Por exemplo:
\Reactors\React1|pressure
Esse exemplo assume que o elemento Reatores está na parte superior da hierarquia de
elementos. Sempre é possível usar esta notação para fazer referência a um atributo relativo ao
nível superior dos elementos no banco de dados.
Por exemplo, suponha que haja a hierarquia de elementos mostrada na seguinte figura:
Pressuponha que deseje-se fazer referência a um atributo chamado pressão, que pertença ao
elemento NewTank. É possível inserir:
\Tanks\Tank1\NewTank|pressure
Se deseja-se representar um atributo filho da pressão, chamado temp, a referência é:

\Tanks\Tank1\NewTank|pressure|temp
Consulte Especificar um descendente de um atributo ode referenciação para obter detalhes

sobre como referenciar atributos filho.
Atributo relativo ao elemento contido

É possível referenciar os atributos relativos ao elemento contido do atributo que está sendo
configurado. Use barras invertidas (/) para mover a hierarquia de elementos para baixo, e ..
para mover a hierarquia para cima.
Na seguinte ilustração, cada elemento (Tank1, Tank2, Tank3 e NewTank) tem uma pressão
nomeada do atributo:
Esses exemplos demonstram o uso da sintaxe:
• Referencie um elemento irmão:

Para consultar o atributo de pressão Tank2 pelo Tank1, digite:
..\Tank2|pressure
• Referencie um elemento pai:
Para consultar o atributo de pressão Tank1 pelo NewTank, digite:
..\|pressure
• Referencie um elemento filho:
Para consultar o atributo de pressão NewTank pelo Tank1, digite:
.\NewTank|pressure

Tópicos avançados
Exemplos de atributos de referências de uma estrutura de eventos para o

elemento referenciado principal
Em um atributo da estrutura de eventos, é possível referenciar atributos que pertençam ao
elemento referenciado primário da estrutura de eventos.
Inicie a referência com .\Elements[.]| para indicar o elemento primário da coleção
Elementos da estrutura de eventos. Por exemplo:
.\Elements[.]|Temperature
Recursos do PI AF
Esta seção descreve os recursos contidos no PI AF.
Nesta seção
• Iniciar o PSE com opções de linha de comando
• Exportar objetos PI AF
• Importar objetos PI AF
• AFDiag: o PI AF Diagnostics Utility
• Configurar o PI AF Server Utility
• Capturar a saída do traçado de eventos do AF SDK
• Monitorar as alterações do AF com a Trilha de Auditoria
Iniciar o PSE com opções de linha de comando

O PI System Explorer (PSE) pode ser chamado com as opções de linha de comando que
controla sua seleção inicial. O aplicativo PI System Explorer é chamado de AFExplorer.exe e
está localizado na pasta \PIPC\AF.
Procedimento
1. Abra uma janela de comando do Windows e altere para a pasta \PIPC\AF.
2. Tipo:
afexplorer parameter=paramValue
em que parameter é um destes três parâmetros:
◦ /system
◦ /database
◦ /navigator
Consulte Parâmetros do AF Explorer para obter mais informações.
Para exibir uma lista de parâmetros disponíveis, digite:
afexplorer /?
Nesta seção
• Parâmetros do AF Explorer
• Valores do parâmetro do navegador

Tópicos avançados
Parâmetros do AF Explorer
O utilitário afexplorer disponibiliza três parâmetros.
Parâmetro Valor Exemplo
/system Configure o parâmetro do afexplorer /
sistema para o nome do host do system=MyAFServer
PI AF Server com o qual o PSE
deve se conectar por padrão.
/database Configure o parâmetro do banco afexplorer /
de dados para o nome do banco database=MyAFDatabase
de dados PI AF que o PSE deve
abrir inicialmente.
/navigator Configure o parâmetro do afexplorer /
navegador para navegar em plug- navigator=Elements
ins que devem ser selecionados
inicialmente no PSE. Os valores
disponíveis estão relacionados
em Valores do parâmetro do
navegador.
Valores do parâmetro do navegador

Valor do Parâmetro Exemplo
Elements afexplorer /Navigator=Elements
EventFrames afexplorer /Navigator=EventFrames
Library afexplorer /Navigator=Library
UnitOfMeasure afexplorer /Navigator=UnitOfMeasure
MyPI afexplorer /Navigator=MyPI
Notifications afexplorer /Navigator=Notifications
AFContactNavigator afexplorer /
Navigator=AFContactNavigator
Exportar objetos PI AF
O utilitário de exportação AF é um aplicativo de linha de comando que pode ser usado para
arquivar bancos de dados AF em um formato XML que pode ser restaurado posteriormente.
Use esse utilitário para arquivar elementos, templates, estruturas de eventos, transferências e
outros objetos de um banco de dados AF. Também é possível exportar objetos AF do PI System
Explorer. Consulte a seção Importar e exportar bancos de dados e objetos de banco de dados.
O nome do utilitário é AFExport.exe, e ele está localizado na seguinte pasta:
\PIPC\AF
Para executar o utilitário de exportação AF, abra uma janela de comando e navegue até a pasta
PIPC\AF. Use a seguinte sintaxe: AFExport.exe e selecione um dos parâmetros listados em
Parâmetros do utilitário de exportação do AF. Para exibir todos os parâmetros, digite:
AFExport /?
Nesta seção
• Parâmetros do utilitário de exportação do AF

Tópicos avançados
• Diretrizes para exportar coleções

• Caminhos de exportação de exemplo
Parâmetros do utilitário de exportação do AF

Parâmetro Descrição
<Path>Mais detalhes e exemplos estão nesta Caminho para o AFObject para o qual deseja-se
tabela. exportar. Normamente do formato: \\<pisystem>
\<database>. Use "." para exportar do banco de
dados padrão. Consulte Caminhos de exportação
de exemplo.
/File:<string> Especifique um arquivo de saída. Se não
especificado, a saída será enviada para o console.
(formato curto /F)
/StartTime:<string> Especifica uma hora de início para que estruturas
de eventos, transferências e casos sejam
exportados; isso ocorre entre as horas de início e
término especificadas. (formato curto /T)
/EndTime:<string> Especifica uma hora de término na qual estruturas
de eventos, transferências e casos são exportados.
(formato curto /E)
/AllReferences[-] Esporta quaisquer objetos referenciados do objeto
AF especificado. Essa opção não pode ser usada
com a opção "No References". (formato curto /A)
/NoReferences[-] Não exporta objetos referenciados, inclusive
objetos filhos. Essa opção não pode ser usada com
a opção "All References". (formato curto /N)
/DefaultValues[-] Quando esta opção não é especificada, as
propriedades definidas como valores padrão não
são exportadas, resultando em um arquivo de
exportação substancialmente menor. A importação
de um arquivo sem valores padrão em objetos
existentes pode resultar em valores que não são
redefinidos para o padrão deles. (formato
curto /D)
/Library[-] Exporta apenas os objetos de biblioteca de um
banco de dados. Os objetos de biblioteca incluem
todas as categorias, todos os templates, conjuntos
de enumeração, tipos de referência e tabelas.
(formato curto /L)
/Security[-] Exporta informações de segurança. A exportação
de informações de segurança aumentará o tempo
de exportação e os tempos de importação
subsequentes. (formato curto /Y)
/UniqueIDs[-] Exporta IDs exclusivos de todos os objetos. Isso
permite que o restante dos objetos seja
reimportado para o mesmo banco de dados. Essa
opção aumenta o tamanho do arquivo de saída e
pode aumentar o tempo necessário para a
importação. (formato curto /U)
/Silent[-] Modo silencioso. Impede que mensagens
informativas sejam exibidas. Se nenhum arquivo
de saída for especificado, esta opção será
automaticamente marcada. (formato curto /S)

Tópicos avançados
/Summary[-] Modo de resumo. Envia apenas informações
mínimas sobre o progresso. Esta opção não é
válida no modo "Silencioso" ou se nenhum arquivo
de saída é especificado. (formato curto /M)
/User:<string> Use para especificar uma conta de usuário
diferente do Windows usada para conectar ao PI
AF Server. (formato curto /user)
/Password:<string> Se um nome de usuário for especificado,
especifique a senha das credenciais de rede.
(formato curto /pw)
/Version Usado para exibir informações da versão. Todos os
outros parâmetros são ignorados. (formato
curto /V)
/Flat[-] Exporta objetos hierárquicos em formato simples.
A exportação para um estilo simples pode
simplificar a edição em algumas ferramentas. Os
objetos hierárquicos que serão exportados em
formato simples são Atributos, Templates de
Atributos, Elementos e Estruturas de Eventos.
(formato curto /flat)
@<file> Lê o arquivo de resposta para obter mais opções. O
arquivo de resposta contêm um parâmetro por
linha. As linhas de comentário começam com o
caractere "#".
Diretrizes para exportar coleções

• Especifique as coleções pelo nome de propriedade PI AF SDK delas seguido por "[]".
• Identifique membros individuais de uma coleção colocando o nome deles entre colchetes.
• Se nenhum nome de coleção for especificado, a coleção filho padrão para o local no caminho
será assumida.
• A coleção filho padrão do PI AF Server é Bancos de Dados.
• A coleção filho padrão de um Banco de Dados é Elementos.
• A coleção filho padrão de um Elemento é Elementos.
• A coleção filho de um Banco de Dados UDM é UDM.
• Uma barra vertical (|) indica a coleção Atributos ou Templates de Atributo.
Caminhos de exportação de exemplo

Para exportar... ...Use esta sintaxe
O banco de dados padrão Use "."
MyDatabase no PI AF Server padrão \\.\MyDatabase
Elemento MyElement no MyDatabase no \\MyPISystem\MyDatabase\MyElement
MyPISystem
Todos os templates de elemento no MyDatabase \\.\MyDatabase\ElementTemplates[]
Template de elemento T1 no MyDatabase \\.\MyDatabase\ElementTemplates[T1]

Tópicos avançados
Para exportar... ...Use esta sintaxe

Todos os conjuntos de enumeração no banco de \\MyPISystem\.\EnumerationSets[]
dados padrão MyPISystem
Todos os atributos de MyChildElement no banco \\MyPISystem\MyElement\MyChildElement
de dados padrão \Attributes[]
O Banco de Dados UOM (UOMDatabase diferencia \\.\UOMDatabase
maiúsculas de minúsculas)
Todas as tabelas no banco de dados padrão \\MyPISystem\.\Tables[]
MyPISystem
Importar objetos PI AF
O utilitário de importação AF é um aplicativo de linha de comando que pode ser usado para
restaurar objetos AF em um banco de dados. Você também pode usar Importar de Arquivo no
PI System Explorer para restaurar os objetos de banco de dados. Consulte Restaurar um banco
de dados.
O nome do utilitário é AFImport.exe, e ele está localizado na seguinte pasta:
\PIPC\AF
Para executar o utilitário de importação AF, abra uma janela de comando e navegue até a pasta
PIPC\AF. Use a seguinte sintaxe: AFImport.exe e selecione um dos parâmetros listados em
Parâmetros do utilitário de importação do AF. Para exibir todos os parâmetros, digite:
AFImport /?
Parâmetros do utilitário de importação do AF

<Path> Caminho para o AFObject no qual deseja-se
importar os dados. Normamente do formato: \
\<pisystem>\<database>. Use "." para importar
no banco de dados padrão.
/File:<string> Especifique um arquivo de entrada. Se não
especificado, a operação de importação fará a
leitura da entrada padrão. (formato curto /F)
/AutoCheckIn[-] Verifica automaticamente as alterações durante a
operação de importação. O valor padrão é
"Verdadeiro" (formato curto /A)
/Create[-] Permite que a operação de importação crie novos
objetos. O valor padrão é "Verdadeiro" (formato
curto /C)
/Update[-] Permite que a operação de importação atualize
objetos. O valor padrão é "Verdadeiro" (formato
curto /U)
/CreateUpdatePIPoints[-] Cria ou atualiza a configuração do PI Point para
elementos recém-criados. Observe que esta opção
pode afetar substancialmente o desempenho da
importação. (formato curto /P)

Tópicos avançados
/DisableConfigStringValidation[-] Desativa a validação das configurações Configurar
Sequência para Referências de Dados e Canais de
Entrega, que podem aumentar a velocidade da
operação de importação. No entanto, isso ignorará
a procura de PI Points, que corrige ou adiciona IDs
de servidor e de ponto às strings de configuração.
(formato curto /D)
/GenerateUniqueNames[-] Gera Nomes Exclusivos para objetos quando um
objetos com o mesmo nome já existe. (formato
curto /G)
/Paste[-] A operação de colagem se comporta como se fosse
um processo de copiar e colar. Dependendo da
origem de importação dos dados, isso afeta a
geração de um novo nome. (formato curto /Pa)
/ContinueOnError ContinueOnError especifica o comportamento do
processo de importação quando ocorrem erros
recuperáveis. As três opções disponíveis são Sim,
Não e Prompt. O valor padrão é Prompt, exceto se
está em execução silenciosa; nesse caso, o padrão é
o cancelamento do processo de importação.
(formato curto /CE)
/Silent[-] Modo silencioso. Impede que mensagens
informativas sejam exibidas. (formato curto /S)
/Summary[-] Modo de resumo. Envia apenas informações
mínimas sobre o progresso. (formato curto /M)
/User:<string> Usado para especifica uma conta de usuário
diferente do Windows usada para conectar ao PI
System. (formato curto /user)
/Password:<string> Se um nome de usuário for especificado,
especifique a senha das credenciais de rede.
(formato curto /pw)
/Version Exibe informações da versão. Todos os outros
parâmetros são ignorados. (formato curto /V)
@<file> Lê o arquivo de resposta para obter mais opções. O
arquivo de resposta contêm um parâmetro por
linha. As linhas de comentário começam com o
caractere "#".
AFDiag: o PI AF Diagnostics Utility

O PI AF Diagnostics Utility é um utilitário de linha de comando que pode ser usado para ativar
ou desativar recursos do PI AF Server, além de realizar outras funções administrativas. Esse
utilitário realiza uma conexão direta com o banco de dados do SQL Server associado e exige a
função sysadmin ou db_afadmin role do SQL Server.
Ele se chama afdiag e está localizado na pasta \PIPC\AF.
Nesta seção
• Conceder permissões do AF Diagnostics Utility
• Executar o utilitário AFDiag
• Parâmetros do AFDiag
• Ativar a Trilha de auditoria do AF

Tópicos avançados
• Use a opção EnableSQLTrace do AFDIAG para coletar informações de perfil SQL

• Gerenciar provedores de plug-in contiguáveis
• Alterar o ID do AF Server
Conceder permissões do AF Diagnostics Utility

Para usar o PI AF Diagnostics Utility, é necessário conceder a função de banco de dados
db_AFAdmin ao Login do SQL Server.
Procedimento
1. No Microsoft SQL Server Management Studio, conecte à instância do SQL Server na qual o
banco de dados PIFD está localizado.
2. Na instância do SQL Server, expanda as pastas Segurança e Logins.
3. Clique com o botão direito do mouse no login que corresponda ao usuário apropriado do
Windows e selecione Propriedades.
5. Selecione a linha do banco de dados PIFD.
6. Marque a caixa de seleção Mapear do banco de dados PIFD.
7. Mantenha o banco de dados selecionado e marque a função do banco de dados db_Admin,
conforme mostrado na seguinte imagem.

Tópicos avançados
8. Clique em OK para salvar as alterações e fechar o Microsoft SQL Server Management.
Executar o utilitário AFDiag
Procedimento
1. Abra um prompt de comando do Windows e altere para a pasta \PIPC\AF.
2. Tipo:
afdiag parameter
em que parameter é um dos parâmetros relacionados em Parâmetros do AFDiag.

3. Para exibir uma lista de parâmetros disponíveis, digite:
afdiag /?

Tópicos avançados
Parâmetros do AFDiag
/ActiveDirectory:<string> Testa o acesso ao Active
Directory usando as
configurações atuais no PI AF
Server. Uma conta opcional do
usuário pode ser especificada
para testar outra conta. Se uma
conta for especifica ou definida
nas configurações do PI AF
Server, também será necessário
especificar a opção Password.
(formato breve /AD)
/CertificateAdd Adiciona o certificado cliente
especificado ao banco de dados
PI AF Server. Usa a opção
password para especificar uma
senha do certificado, se
necessário. (formato breve /CA)
/CertificateList Lista os certificados cliente
armazenados no banco de dados
PI AF Server. (formato
breve /CL)
/CertificateRemove Remove um certificado cliente do
banco de dados PI AF Server
especificando o nome do
certificado. (formato breve /CR)
/CertificateSet:<string> Define o certificado servidor no
arquivo de configuração do PI AF
Server no arquivo especificado.
Usa a opção Password para
especificar uma senha do
certificado, se necessário.
(formato breve /CS)
/ChangeID:<string> Altera o ID do AF Server no GUID
especificado. (Forma breve /
CID)
/ClearChangeTables Limpa as tabelas findChanges e
afdiag, que registram
informações sobre mudanças no
sistema. (formato breve /CCT)
/DeleteCases Exclui casos do banco de dados
SQL cuja hora de início seja
anterior à data especificada na
hora local (por exemplo, /
ATT:"1/1/2008"). (formato
breve /DelC)
/DeleteEventFrames Exclui estruturas de eventos do
banco de dados SQL cujo tempo
final seja anterior à data
especificada na hora local (por
exemplo, /ATT:"1/1/2008").
(formato breve /DelEF)

Tópicos avançados
/DeleteTransfers Exclui transferências do banco de
dados SQL com um tempo final
anterior à data especificada na
hora local (por exemplo, /
ATT:"1/1/2008"). (formato
breve /DelTR)
/EnableAuditTrail[-] Ativa o recurso de detalhes da
trilha de auditoria no PI AF
Server. Quanto ativada, permite
que os usuários monitorem as
alterações feitas no PI System.
(formato abreviado /AT)
Desativar o recurso de detalhes
da trilha de auditoria remove
todos os dados de alteração do
AF 2.6 e tabelas _CT.
/EnableSqlTrace[-] Coleta informações sobre
comunicações entre o AF Server
e o SQL Server. (formato
breve /ST)
Consulte Use a opção
EnableSQLTrace do AFDIAG para
coletar informações de perfil SQL
para obter mais informações.
/EnableExternalDataTables[-] Ativa o suporte a tabelas AF

externas. (formato breve /DT)
/EnableExternalDataTablesWithAF20[-] Ativa o suporte a tabelas AF
externas pelo cliente do AF 2.0.
(formato breve /DT20)
/EnablePropagationOfTargetDeletion[-] Ativa o suporte para propagar a
exclusão de destinos (Elementos)
nas Análises e Notificações de
referência. (formato breve /PTD)
/ExeFile:<string> O caminho ao arquivo executável
do AF Server. O valor padrão é
AFService.exe. (formato
breve /F)
/ExternalDataTablesAllowNonImpersonatedUsers[-] Ativa o suporte a tabelas AF
externas para usuários não
personificados. (formato curto /
DTImp)
@<file> Lê o arquivo de resposta para
obter mais opções. O arquivo de
resposta deve conter um
parâmetro por linha. As linhas de
comentários começam com o
caractere "#".
/NewID Gera um novo ID para o PI AF
Server. (formato breve /NID)
/Password Especifica uma senha de
certificado para as opções
CertificateSet,
CertificateAdd ou
ActiveDirectory. (formato
breve /PWD)

Tópicos avançados
/PlugInVerifyLevel=<level> Configura o nível de verificação
necessário para que o plug-in
seja executado. Níveis válidos:
None: Desativa a validação,
executa todos os plug-ins.
AllowUnsigned: Executa plug-
ins não assinados e plug-ins com
assinaturas válidas.
RequireSigned: Executa apenas
plug-ins com assinaturas válidas.
RequireSignedTrustedProvid
er: Executa apenas plug-ins com
uma assinatura válida de um
provedor confiável.
/Port:<integer> Testa a porta específica ao AF
Server. Pode ser usado para
realizar testes básicos de porta e
descobrir se a porta especificada
no computador usado pelo AF
Server pode ser aberta, e se algo
está escutando para realizar a
conexão na porta. As portas
padrão usadas pelo AF Server
são 5457 e 5459. Isso é
semelhante à tentativa de teste
de uma porta usando o Telnet.
Testa todos os endereços IP do
computador (os endereços IPv4 e
IPv6). Normalmente ambas as
portas 5457 e 5459 seriam
testadas. (formato breve /P)
/PrintSqlTraceSummary:DateTime Imprime registros do resumo da
tabela gerada pela opção /
EnableSqlTrace a partir da
data especificada. (formato
breve /STP)
/Reindex Recria totalmente todos os
índices no banco de dados SQL
do PI AF Server. Isso é útil após
uma inserção massiva de dados
para melhorar substancialmente
o desempenho. (formato
breve /RI)
/Silent[-] Modo silencioso. Impede a
exibição de mensagens. (formato
breve /S)
/TruncateSqlTrace:DateTime Exclui os registros criados antes
da data especificada com base na
tabela gerada pela opção /
EnableSqlTrace. (formato
breve /ST0)
/TrustedProviderAdd:<providername> Adiciona o provedor especificado
à lista de fornecedores de plug-
ins confiáveis. Para adicionar
provedores, é necessário ter
função sysadmin ou db_afadmin
do SQL Server.

Tópicos avançados
/TrustedProviderList Veja a lista de fornecedores de
plug-ins confiáveis. Para
relacionar os provedores, é
necessário ter função sysadmin
ou db_afadmin do SQL Server.
/TrustedProviderRemove:<providername> Remove o provedor especificado
da lista de provedores de plug-
ins confiáveis. Para excluir
provedores, é necessário ter
função sysadmin ou db_afadmin
do SQL Server.
/Version Exibe as informações da versão.
(formato breve /V)
Ativar a Trilha de auditoria do AF

O recurso Trilha de auditoria pode ser ativado ou desativado usando a opção EnableAuditTrail
(/AT) com o utilitário AFDiag.
Antes de ativar o recurso Trilha de auditoria do AF, observe estes requisitos:
• É necessário usar o SQL Server 2008 Enterprise ou posterior para o AF SQL Database (SQL
Server 2008 Standard Edition não é compatível). Para as pessoas que estejam trabalhando
apenas em um ambiente de desenvolvimento, o SQL Server 2008 Developer ou posterior
também é compatível.
• O SQL Server Agent precisa estar em execução antes da ativação do recurso Trilha de
Auditoria.
• Para ativar ou desativar o recurso Trilha de auditoria, é necessário ser membro da função
sysadmin no SQL Server que mantém o PI AF SQL Database.
Nota:
Para usuários sque usaram as versões anteriores da Trilha de Auditoria do AF: Os dados
existentes da trilha de auditoria não estarão acessíveis com o novo recurso Trilha de
Auditoria no AF 2.6. Os dados ainda podem ser acessados como antes. Após o upgrade do
PI AF System para a versão 2.6, ative o recurso Trilha de Auditoria do AF para garantir
que todas as alterações tenham sido capturadas a partir deste momento no novo recurso
Trilha de Auditoria do AF
Suporte de trilha de auditoria em coletivos PI AF

O recurso Trilha de Auditoria não é suportado em membros secundários dos coletivos PI AF. Se
você adicionar um servidor PI AF com trilha de auditoria habilitada a um coletivo PI AF como
um membro do secundário, o recurso de trilha de auditoria fica desativado naquele membro
secundário. Os dados da Trilha de Auditoria são armazenados apenas no membro primário de
um coletivo PI AF e não são replicados para qualquer membro secundário de um coletivo PI AF.
Nota:
Quando você estiver criando procedimentos de backup do SQL Server para os seus dados
de PI AF, esteja ciente de que se o membro principal de um PI AF coletivo ficar
indisponível, os dados da trilha de auditoria também estarão indisponíveis. Se o membro
principal de um PI AF coletivo não pode ser recuperado de um backup, os dados da Trilha
de Auditoria também não poderão ser recuperados.

Tópicos avançados
Habilitar novamente a Trilha de Auditoria do AF

Se você adicionar um servidor existente do PI AF com Trilha de Auditoria habilitada para um
coletivo como um membro secundário mas, mais tarde, remover este servidor do coletivo, você
precisa re-habilitar a Trilha de Auditoria neste servidor em particular. Caso contrário, a
auditoria permanecerá desativada.
Use a opção EnableSQLTrace do AFDIAG para coletar informações de

perfil SQL
Pode-se usar a opção /EnableSQLTrace do comando AFDiag para coletar informações sobre
comunicações entre o AF Server e o SQL Server, semelhante às informações disponíveis no SQL
Profiler, uma ferramenta de diagnóstico da Microsoft que permite o monitoramento de
comunicações com o SQL Server. Enquanto o SQL Profiler precisa de privilégios SysAdmin, esse
privilégio não é necessário ao executar o AFDiag /EnableSqlTrace.
Porque as informações são registradas em uma tabela do SQL Server, a execução do AFDiag /
EnableSqlTrace afeta o desempenho. Normalmente, não se deve executar o AFDiag /
EnableSqlTrace em um AF System de produção, a não ser que isso seja feito
temporariamente para monitorar ou resolver um problema.
Em algumas situações, o volume de dados registrados pode crescer consideravelmente. A
opção /TruncateSqlTrace pode ser usada para remover os registros da tabela antes da data
especificada. Por exemplo, o seguinte comando excluir os registros antes de 1° de janeiro de
2014 da tabela:
AFDiag /ST0:"1/1/2014"
A opção /PrintSqlTraceSummary imprime os registros de resumo da tabela de acordo com a

data especificada. Por exemplo, o seguinte comando imprime registros de 1° de janeiro de
2014:
AFDiag /STP:"1/1/2014"
A saída do AFDiag /EnableSqlTrace inclui as seguintes colunas:

Nome da coluna Descrição
Nome do Procedimento Armazenado Pode ser útil para fins de depuração ao trabalhar
com Suporte Técnico
Duração de SUM Soma da duração das chamadas do procedimento
armazenado no período deste relatório de resumo
(em milissegundos)
Duração de MIN Tempo de execução mais rápido do procedimento
executado durante o período deste relatório de
resumo (em milissegundos).
Duração de MAX Tempo de execução mais lento para este
procedimento armazenado no período deste
relatório de resumo (em milissegundos).
Duração de AVG Tempo de execução médio para este procedimento
armazenado no período deste relatório de resumo
(em milissegundos).
Contagem de Chamadas O número de vezes que este procedimento
armazenado foi chamado durante este relatório de
resumo.
Nota:
O uso do AFDiag /EnableSqlTrace não tem suporte em um membro secundário de um
coletivo AF.

Tópicos avançados
Gerenciar provedores de plug-in contiguáveis

Por padrão, é possível executar os plug-ins PI AF de qualquer provedor. Para obter mais
segurança, é possível configurar o PI AF para que apenas plug-ins de provedores confiáveis
possam ser executados (PI AF Server 2.5 e superiores). Os provedores de plug-ins são
incentivados a codificar seus plug-ins com sinais usando uma tecnologia de autenticação de
código. Para controlar como a segurança de plug-ins é aplicada, configure verify level.
Para listar os provedores confiáveis, especifique o parâmetro afdiag/
TrustedProviderList. Para obter mais detalhes, consulte Parâmetros do AFDiag. Para
adicionar um provedor, especifique o parâmetro /TrustedProviderAdd:<providername>.
Para remover um provedor, especifique o parâmetro /
TrustedProviderRemove:<providername>.
1. Clique com o botão direito do mouse no plug-in dll e selecione Propriedades. A janela
Propriedades é exibida.
2. Clique na guia Assinaturas Digitais. (Se o plug-in não estiver assinado, a guia não será
exibida.)
3. Clique no botão Detalhes. A janela Assinaturas Digitais é exibida.
4. Clique em Visualizar Certificados. A janela Certificado é exibida.
5. Na guia Detalhes, navegue até o campo Assunto. O valor exibido nesse campo é o nome do
provedor confiável, que pode ser usado como o parâmetro <providername> para os
parâmetros /TrustedProviderAdd e /TrustedProviderRemove.
Para exibir o nível de verificação usado ao carregar os plug-ins de execução, envie o comando
afdiag e omita quaisquer parâmetros. Verifique se o nível está listado na seção Definição das
Configurações dos resultados.
Para configurar o nível de verificação, envie o comando afdiag, especificando o parâmetro /
PlugInVerifyLevel. Os níveis válidos são os seguintes:
• None: Desativa a validação, executa todos os plug-ins.

• AllowUnsigned: Executa plug-ins não assinados e plug-ins com assinaturas válidas.
• RequireSigned: Executa apenas plug-ins com assinaturas válidas.
• RequireSignedTrustedProvider: Executa apenas plug-ins com uma assinatura válida de
um provedor confiável.
Alterar o ID do AF Server
Use os recursos "Alterar ID" ou "Novo ID" para alterar o identificador exclusivo associado ao PI
AF Server.
Um valor de retorno igual a 1 significa que a alteração da configuração será atrasada. Um valor
de retorno igual a 2 significa que é necessário reiniciar o PI AF Server. Um valor de retorno
negativo indica um erro.
Configurar o PI AF Server Utility

A opção Configurar PI System Utility (setpisystem) permite a configuração de PI AF Servers
conhecidos. O setpisystem está localizado no diretório PIPC\AF. Os parâmetros disponíveis
para setpisystem estão relacionados na seguinte tabela.

Tópicos avançados
/Name:<string> Especifica o nome do PI AF Server a ser modificado ou
criado. Se não especificado, o PI AF Server padrão será
usado. (Formato breve /N)
/Host:<string> Especifica o nome do host do PI AF Server. (Formato
breve /H)
/Protocol:<Tcp|NamedPipe> Especifica o protocolo do PI AF Server. (Formato
breve /C)
/Port:<integer> Especifica a porta do PI AF Server. (Formato breve /P)
/Timeout:<integer> Especifica o tempo limite do PI AF Server em segundos.
(Formato breve /T)
/AccountName:<string> Especifica o nome da conta do PI AF Server. (Formato
breve /A)
/DefaultPISystem Define o PI AF Server especificado como o PI AF Server
padrão. (Formato breve /D)
/Remove Remove o PI AF Server especificado como da lista de PI
AF Servers conhecidos. (Formato breve /R)
/Silent[-] Modo silencioso. Impede a exibição de mensagens.
(Formato abreviado /S)
/List Lista os PI AF Servers conhecidos atuais. (Formato
breve /L)
/AddAlias:<string> Adiciona o alias especificado ao PI System (AF Server).
(Formato breve /AA)
/RemoveAlias:<string> Remove o alias especificado do PI System (AF Server).
(Formato abreviado /RA)
Capturar a saída do traçado de eventos do AF SDK

É possível usar o AF Get Trace Utility (afgettrace.exe) para capturar a saída do traçado de
eventos no AF SDK. O traçado de evento podem ajudar na depuração de um aplicativo e
executar a análise de capacidade e desempenho.
Procedimento
1. Abra uma janela de comando e navegue até a pasta PIPC\AF.
2. Opcional: Para exibir a sintaxe e os parâmetros deste utilitário, digite: afgettrace /?
3. Para executar o AF Get Trace, digite: afgettrace no prompt de comando. Por padrão, a
saída vai até a saída padrão a ser exibido e pode ser salvo em um arquivo de registro
4. Para terminar o traçado, digite: X na janela de comando. Se a janela de comando for fechada
sem o que o traçado seja terminadoafgettrace, os eventos do traçado continuarão a ser
gerados, podendo diminuir a velocidade dos aplicativos AF SDK.
Monitorar as alterações do AF com a Trilha de Auditoria

Se a Trilha de Audição do AF tiver sido ativada no sistema, será possível abrir a janela Trilha de
Audição do AF para visualizar as alterações feitas nos objetos AF de todos os bancos de dados
AF. Consulte Ativar a Trilha de auditoria do AF para obter detalhes sobre como ativar esse
recurso.

Tópicos avançados
A janela Trilha de Audição do AF contém uma tabela; cada linha da tabela contém dados que
identificam uma alteração específica em um objeto AF. Também é possível clicar duas vezes em
uma linha para ver os detalhes sobre essa alteração.
Também é possível copiar e colar linhas de cada janela em outro documento, como uma
planilha.
Visualizar alterações na janela Trilha de Audição do AF

Antes de Iniciar
É necessário serum administrador do PI AF para abrir a janela Trilha de Audição do AF.
Procedimento
1. Abra a janela Trilha de Audição do AF. No PI System Explorer, clique em Ferramentas >
Trilha de Audição do AF. A tabela na janela lista as alterações feitas nos objetos AF. Cada
linha inclui:
◦ Data
A data e hora da alteração
◦ Ação
O tipo de alteração (Inserir, Atualizar ou Excluir)
◦ Tipo
O tipo de objeto alterado
◦ Banco de dados
O banco de dados AF contendo o objeto alterado
◦ Caminho
O caminho hieráquico para o objeto alterado (quando o objeto é um filho de um objeto
pai, o caminho mostra o objeto pai)
◦ Nome
O nome do objeto alterado
◦ Usuário
O usuário que fez a alteração, na forma de [domínio]\[usuário]
2. Opcional: Visualize as alterações de um período de tempo subsequente ou anterior. Clique
em Adiantar hora (botão de seta para a direita) para visualizar as alterações do próximo
período de tempo; clique em Atrasar hora (botão de seta para a esquerda) para listar as
alterações no período de tempo anterior.
Para um período de tempo de 24 horas, por exemplo, cada clique moverá para o próximo
período de 24 horas (ou o período anterior).
3. Opcional: Altere Hora de início e Tempo final para ajustar o período de tempo. Clique no
botão calendário a ser selecionado ou insira um novo tempo ou crie uma expressão de
tempo relativo com as seleções da lista de botão triângulo. Clique no botão Atualizar (ou
pressione Enter) para exibir a tabela atualizada.
Quando há várias mudanças no período de tempo atual, talvez seja necessário diminuí-lo. O
período de tempo menor contém menos alterações, o que mantém o número de linhas de
alterações na tabela em um nível mais fácil de gerenciar.

Tópicos avançados
4. Opcional: Altere Contagem máxima para definir um limite no número de linhas de

alterações que podem ser retornadas no período de tempo atual. Clique no botão Atualizar
(ou pressione Enter) para exibir a tabela atualizada. Talvez seja necessário ajustar
Contagem máxima para controlar o tempo de resposta. Além disso, se o número de
alterações no período de tempo atual excerder a Contagem máxima, o valor poderá ser
aumentado para exibir essas alterações. (Também é possível afetar o número de alterações
a serem exibidas ajustando o período de tempo.)
5. Opcional: Insira o texto no campo Filtro para filtrar os resultados retornados na tabela.
Selecione um tipo de filtro na lista suspensa à extrema direita do campo Filtro, insira os
critérios do filtro no campo Filtro e clique no botão Pesquisar.
A tabela exibe apenas as linhas contendo os critérios definidos do filtro.
6. Opcional: Para visualizar os detalhes de uma linha na tabela, clique duas vezes na linha para
abrir a janela Detalhes da Trilha de Audição do AF. Os seguintes dados são exibidos para os
itens listados:
◦ Ação
Tipo de alteração (Inserir, Atualizar ou Excluir) e o subobjeto do objeto AF (como um
atributo ou valor do atributo)
◦ Nome
O subobjeto AF pode estar em branco
◦ Nome da propriedade
O nome da coluna da tabela SQL no PI AF SQL Database (PIFD) para o subobjeto alterado.
Apesar de esse nome não ser necessariamente fácil de entender, ele fornece um método
para incluir todos os dados no registro alterado.
◦ Valor antigo
O valor anterior à alteração
◦ Novo valor
O valor posterior à alteração
Persistência
O Diretório de Dados aceita qualquer tipo de objeto no método SetValue, contanto que ele
possa ser convertido em um tipo de dados e uma unidade de medida configurados. No entanto,
o Diretório de Dados pode salvar estes tipos de valores:
• Um Tipo de Valor .NET (tipos de valor mais básico)

• Uma matriz de Tipo de Valor .NET
• Um objeto Serializável .NET
• Um objeto com suporte à interface IPIPersist do PI SDK. A interoperabilidade com o PI SDK
pode ser alcançada com esse último suporte, pois ele permite que atributos armazenem
referências a PI Points, Módulos, Bateladas etc. Todos os objetos AF também dão suporte à
interface IPIPersist, o que significa que eles podem ser armazenados como valores em
atributos ou no PIProperties do PI SDK, conforme necessário.
Se um objeto não puder persistir, uma exceção será gerada quando o elemento contido não
puder ser salvo.

Tópicos avançados
Restrições nos nomes de objeto AF

Tipo de Objeto Caracteres Não Permitidos
Outros além de contatos Caracteres de controle, mais: * ? ; { } [ ] | \ ` ' "
Contatos Caracteres de controle, mais: * ? ; [ ] | \ "
Para todos os tipos de objeto:
• O PI AF remove automaticamente espaços à direita ou à esquerda dos nomes.

• O comprimento máximo do nome é de 259 caracteres.
• Nomes em branco não são permitidos.
Inserir valores nos tipos de valores

É possível inserir valores para:
• valores de atributo (exceto atributos com atributos de referência de dados)

• valores padrão do template de atributo
• valores de propriedade estendida
Os formatos de valor para esses tipos de valor precisam de explicação.
• Data/Hora:Se o tipo de valor for Data/Hora, será possível inserir a hora em qualquer
formato de string com suporte do AF (inclusive formatos do horário PI) ou do objeto Data/
Hora do .NET. Alguns exemplos de entradas válidas:
*-5d May 12, 2009 07 06 2010 10:00:00 AM 09 14 2008 14:00:00
Nota:
O PI System Explorer resolverá a string quando a data e hora resultantes forem
enviadas para o AF.
• Para criar um atributo com um link como valor, selecione a string do tipo de valor e torne o
URL o valor do atributo. As strings reconhecidas com caminhos de URL absolutos serão
exibidas como links.
Por exemplo, strings que iniciam com http://, ftp://, file:// e www. são reconhecidas
como links, enquanto strings que iniciam com C:\, \\server\ e abc.com não são. No PI
System Explorer, esses valores aparecerão sublinhados, junto com uma dica de ferramenta,
Ctrl + Clique para seguir o link.
• Qualquer: Apesar de permitido, o tipo de valor Qualquer não é recomendado.
Nota:
Consulte Restrições nos nomes de objeto AF para obter os valores do nome do objeto.
Definir o valor do atributo como o nome de outro atributo

Os tipos de valor do atributo e elemento permitem pesquisar e armazenar um elemento AF ou
um atributo AF (não o valor do atributo) respectivamente.

Tópicos avançados
Nota:
Esse é um recurso avançado disponibilizado para compatibilidade reversa em casos de
uso específicos. Talvez ele não esteja disponível em lançamentos futuros.
Criar tipos de referência personalizada

É fácil criar tipos de referência personalizada. Cada tipo de referência personalizada deve ser
baseada em um dos três tipos de referência predeterminados. Usar tipos de referência
personalizados permite a criação de regras que possibilitam que o AF oriente os usuários
quando eles criam novos elementos. Consulte Representar templates filho para obter
informações sobre como criar referências de template.
Nesta seção
• Forças do tipo de referência do elemento
• Tipos de referência predefinidos
• Criar tipos de referência personalizadas
Forças do tipo de referência do elemento

Os elementos podem estar relacionados entre si de várias formas por meio de um Tipo de
Referência. Os tipos de referência são nomeados e sempre hierárquicos. Caso os tipos de
referência não sejam usados, o sistema automaticamente usará um tipo de referência definido
pelo sistema cuja hierarquia funciona exatamente igual ao Banco de dados do módulo.
Há três forças de tipo de referência fundamental disponíveis:
• Forte – Na ausência de um pai de composição, há um elemento, contanto que ele tenha um

ou mais pais fortemente relacionados. Esse é o mesmo comportamento das referências no
Banco de dados do módulo.
Um tipo de referência forte, como o tipo de referência pai-filho padrão, permite que o
elemento filho tenha vários pais. Se o último elemento pai do filho for excluído, o filho
também será excluído. Esse tipo de referência era o único disponível no AF 1.x.
Use uma referência forte entre dois elementos quando for desejado que o elemento filho
exista enquanto seu tipo de referência for forte para pelo menos um pai, mas não se desejar
que os elementos filhos sejam tratados como uma única unidade com o elemento pai. Por
exemplo, o medidor pertence a uma companhia e está anexado a uma instalação. Uma
referência forte seria usada entre o elemento da companhia e o elemento do medidor filho;
outra referência forte seria escolhida entre o elemento da instalação e o elemento do
medidor filho. Se o medidor for removido da instalação, ele ainda existirá, pois ainda terá
uma referência forte com o elemento da companhia. Se ele também for removido da
companhia, então, ele deixará de existir, pois todas as referências fortes terão sido
removidas.
• Fraca – Uma referência fraca é usada quando não se deseja que o pai defina o tempo de vida
de um filho.
Um tipo de referência fraca é o mais simples. Use uma referência fraca entre dois elementos
quando se desejar criar uma relação entre dois elementos, mas não se desejar que esse
relacionamento controle o tempo de vida do elemento filho. Por exemplo, para organizar os
medidores em grupos, mas se todas as referências fortes ao medidor forem removidas, será

Tópicos avançados
desejado que eles sejam automaticamente removidos do agrupamento. Nesse caso, use uma
referência fraca entre o elemento pai do grupo e o elemento do medidor filho.
• Composição – Uma referência de composição significa que o elemento pais só define e
possui o elemento filho. Nesse tipo de relacionamento, um filho pode estar contido em um
pai, e a exclusão do pai também exclui o filho.
Um tipo de referência com um comprimento de composição de referência significa que o
elemento filho é uma parte do pai e não existe sem o pai. Se um elemento pai que tem um
elemento filho composicionalmente referenciado for excluído, o elemento filho também será
excluído. Além disso, pode-se fazer referência a um elemento filho na forma de composição
por apenas um pai.
Use uma referência de composição quando dois objetos na relação forem considerados um
item. Por exemplo, um medidor pode ser composto por dois sensores, portanto, uma
referência de composição seria usada entre o elemento do medidor e cada um de seus dois
elementos filhos dos sensores filhos. A exclusão do elemento do medidor também excluir os
elementos do sensor filho. Ao fazer check out de um dos elementos filhos para fazer uma
alteração, também será feito check out do outro elemento do sensor e do elemento do
medidor.
As seguintes opções são tipos de referência definidos pelo sistema:
• Child-Parent – Define um tipo de referência forte "n..n", que pode ser usado para criar
referências do tipo Banco de Dados do Módulo. Esse é o tipo de referência padrão quando
nenhum outro tipo é especificado. Ele exige nomes exclusivos e referências não circulares.
• IsComposedOf-ComposedBy – Define um tipo de referência de composição "0..n", que pode
ser usado para criar hierarquias de composição do tipo AF. Diferenças no comportamento
"Check Out" e "Criação de versão" podem ser aplicáveis.
• Referenced-Referenced By – Define uma referência fraca "n..n".
O usuário ou um aplicativo podem definir tipos de referência adicionais. Isso permite que
hierarquias de elementos específicas ao aplicativo usando uma relação mais específica e que
aplicativos definam ou substituam as especificações de como as relações de elementos se
comportam.
Os tipos de referência entre elementos são definidos no banco de dados. Os tipos de referência
são nomeados, têm um nome de relação inversa, aplica nomes exclusivos e são restritos pelo
template.
Os tipos de referência são definidos no banco de dados, pois eles geralmente transcendem
vários templates de elemento, como ocorre no tipo Child-Parent definido pelo sistema. Uma
instância de um tipo de referência, a relação entre dois elementos específicos, é chamada de
Referência.
Tipos de referência predefinidos

Tipo de Referência Padrão AF Força da Referência
Composição Composição
Pai-Filho Forte
Fraco Fraca

Tópicos avançados
Criar tipos de referência personalizadas

Para criar um novo tipo de referência, no Navegador, clique com o botão direito do mouse na
coleção dos tipos de referência e selecione Novo Tipo de Referência, conforme mostrado na
figura acima.
Procedimento
1. Na caixa Nome, insira o nome do tipo de referência, e nas caixas Filho e Nome do Pai, insira
os nomes do filho e do pai.
2. Na caixa Categorias, insira uma ou mais categorias do tipo de referência, separadas por
ponto e vírgula, ao qual o tipo de referência pertence. Clique em para visualizar as
opções.
3. Na caixa Força de Referência, selecione Forte, Fraco ou Composição. Veja a seção Criar uma
referência de elemento para obter as definições de forças.
4. Nas caixas Padrão Permitido do Elemento Pai/Filho, insira um ou mais templates, separados
por ponto-e-vírgula, no qual os pais e filhos do tipo de referência pertencem. Clique em
para visualizar as opções.
Nota:
É possível criar tipos de referência com mais rapidez na coleção Templates de

Elemento usando os templates de referência (Criar uma referência de template filho).
Copiar caminhos
A opção Copiar Caminho retorna todo o caminho de cada objeto selecionado. Esse caminho é
gerado ao chamar o método GetPath (AFObject.GetPath) do objeto. Pode-se usar essa string
de caminho para localizar o objeto no AF SDK chamando o método FindObject
(AFobject.FindObject) do objeto. Se vários objetos AF forem selecionados, Copiar Caminho
retornará vários caminhos separados por uma linha nova. Para obter mais informações sobre
GetPath e FindObject, consulte a documentação do AF SDK do AFobject.
Exemplos
Considere as duas linhas selecionadas, mostradas na seguinte figura:
Ao selecionar a primeira linha, clique com o botão direito do mouse e selecione Copiar (ou
pressione CTRL+C) para que o seguinte seja colocado na área de transferência:
Is Not Configuration Item Good Cooling Fan Model LJ-459
Manufacturer Model

Tópicos avançados
Ao selecionar as duas linhas, clique com o botão direito do mouse e selecione Copiar (ou
pressione CTRL+C) para que o seguinte seja colocado na área de transferência:
Is Not Configuration Item Good Cooling Fan Model LJ-459
Manufacturer Model Is Not Configuration Item Good Cooling Fan Motor
Amps 14.281286239624 A Motor Amps
Ao selecionar a primeira célula da primeira linha, clique com o botão direito do mouse e
selecione Copiar Célula, então, Fabricante é colocado na área de transferência.
Ao selecionar a primeira linha, clique com o botão direito do mouse e selecione Copiar
Caminho para que o seguinte seja colocado na área de transferência:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model
Ao selecionar ambas as linhas, clique com o botão direito do mouse e selecione Copiar Caminho
para que o seguinte seja colocado na área de transferência:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model \
\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Motor
Amps
Nota:
Ao arrastar e soltar, a área de trabalho sempre contém as informações do caminho, que
suporta o processo de arrastar e soltar no ProcessBook.
Armazenar informações específicas do aplicativo

ExtendedProperties é uma coleção de valor nomeado que permite que os usuários armazenem
informações específicas do aplicativo. Essas informações não são geralmente exibidas pelos
aplicativos cliente da OSIsoft.
Clique no link Propriedades Estendidas em algumas caixas de diálogo para configurar uma ou
mais propriedades adicionais e opcionais para um objeto. Depois que a janela Propriedades
Estendidas é exibida, clique com o botão direito do mouse abaixo da caixa Nome e selecione
Nova Propriedade Estendida. Especifique um nome e um valor para a propriedade.
Gerenciar plug-ins
Nesta seção
• Visualizar plug-ins atualmente instalados
• Registro de plug-in da linha de comando
• Criar um arquivo de registro XML
• Criar um script de registro SQL
• Registrar um plug-in usando o script SQL gerado
• Gerenciar provedores de plug-in contiguáveis
Visualizar plug-ins atualmente instalados

Procedimento
1. Selecione Arquivo > Propriedades do AF Server. A caixa de diálogo Propriedades do AF
Server é exibida.
2. Selecione a guia Plug-ins.

Tópicos avançados
◦ Mova o ponteiro sobre um plug-in para ver se ele está carregado e a versão carregada.
◦ Clique com o botão direito do mouse no plug-in e selecione Propriedades para visualizar
os detalhes, como conjunto, versão, versão carregada, conjuntos de suporte e assim por
diante.
Nota:
O a versão do plug-in carregado geralmente corresponde à versão do PI AF Server. No
entanto, se a versão do servidor for alterada, será necessário reiniciar o PI System
Explorer para carregar a nova versão do plug-in no servidor.
Registro de plug-in da linha de comando

Este tópico demonstra como registrar diferentes implementações de Plug-in e dar suporte a
montagens na linha de comando usando os utilitários RegPlugIn e RegPlugIn64.
Os utilitários de registro Plug-in estão localizados nas pastas \PIPC\AF de seus diretórios
Program Files correspondentes:
\Program Files\PIPC\AF\RegPlugIn64.exe \Program Files (x86)\PIPC\AF\RegPlugIn.exe
Nos exemplos a seguir, MyPISystem é o PI AF Server no qual o Plug-in será registrado,

MyPlugIn.dll é o nome do conjunto do Plug-in, e Support.dll é o nome do conjunto de suporte
do Plug-in.
• Plug-in apenas de .NET 3.5 direcionado a qualquer CPU

O plug-in mais fácil de ser registrado. Esta implementação funciona em qualquer
arquitetura de sistema operacional e em todas as versões do .NET Framework. Ela não pode
usar novos recursos específicos à versão .NET 4 do PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll
• Plug-in apenas de .NET 4 direcionado a qualquer CPU
Esta implementação funciona em qualquer arquitetura de sistema operacional e no .NET 4
Framework. Ela não funciona na versão .NET 3.5 do PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\4.0\MyPlugIn.dll
• Plug-ins .NET 3.5 e .NET 4 direcionados a qualquer CPU
Este plug-in tem duas implementações. Uma direcionada ao .NET 3.5 Framework e que
funciona com a versão .NET 3.5 do PI AF SDK, e outra direcionada ao .NET 4 Framework e
que funciona com a versão .NET 4 do PI AF SDK. Ambas as implementações são registradas
com o seguinte comando:
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\4.0\MyPlugIn.dll
• Plug-in apenas de .NET 3.5 direcionado a plataformas de 32 e 64 bits
Este plug-in tem duas implementações para o .NET 3.5 Framework. Uma direcionada a
sistemas operacionais de 32 bits, e outra a sistema de 64 bits. Com ambas as
implementações registradas, o plug-in funciona em qualquer arquitetura de sistema
operacional e em todas as versões do .NET Framework; no entanto, ele não pode usar novos
recursos específicos à versão .NET 4 do PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll
RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll
• Plug-ins .NET 3.5 e .NET 4 direcionados a plataformas de 32 e 64 bits
Este plug-in tem quatro implementações. Duas implementações para o .NET 3.5 Framework:
uma para a plataforma de 32 bits e uma para a de 64 bits. As outras duas implementações
para o .NET 4: uma para a plataforma de 32 bits e uma para a de 64 bits. Com todas as

Tópicos avançados
implementações registradas, ele funciona em qualquer arquitetura de sistema operacional e

em todas as versões do .NET Framework.
RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll PlugIns
\4.0\x86\MyPlugIn.dll
RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll PlugIns
\4.0\x64\MyPlugIn.dll
• Plug-in apenas de .NET 3.5 e conjunto de suporte direcionados a qualquer CPU
Esta implementação e seu conjunto de suporte funcionam em qualquer arquitetura de
sistema operacional e em todas as versões do .NET Framework. Ela não pode usar novos
recursos específicos à versão .NET 4 do PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll
• Plug-ins .NET 3.5 e .NET 4 e conjunto de suporte direcionados a qualquer CPU
Este plug-in tem duas implementações com duas implementações de seus conjuntos de
suporte. Uma direcionada ao .NET 3.5 Framework e que funciona com a versão .NET 3.5 do
PI AF SDK. A outra direcionada ao .NET 4 Framework e que funciona com a versão .NET 4 do
PI AF SDK. Ambas as implementações e seus conjuntos de suporte são registrados com o
seguinte comando.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll PlugIns
\4.0\MyPlugIn.dll PlugIns\4.0\Support.dll
Parâmetros RegPlugIn
/PISystem:<string> (formato abreviado /P) Especifica o PI System (PI AF Server) a ser
processado. Se não especificado, o PI System (PI AF
Server) padrão será usado.
/OutputFile:<string> (formato abreviado /O) Especifica um arquivo de saída. Se especificado,
um script SQL será gerado para criar Plug-ins. Use
o parâmetro AppendFile para anexar a um
arquivo existente.
/AppendFile[-] (formato abreviado /A) Usado junto com o parâmetro OutputFile para
especificar se deve ser anexado a um arquivo de
saída existente.
/List (formato abreviado /L) Lista os conjuntos registrados no PI System (PI AF
Server) especificado.
/Recursive[-] (formato abreviado /R) Processa subdiretórios. Esses processos
automaticamente dão suporte a conjuntos nos
subdiretórios baseados nos nomes do conjunto e
do diretório. Use o parâmetro RootDirectory
para especificar um diretório raiz diferente do
diretório de trabalho atual.
/Force[-] (formato abreviado /F) Força o registro de conjuntos mais antigos que os
conjuntos atualmente registrados ou força o
cancelamento do registro de conjuntos que
parecem não estar registrados.
/Silent[-] (formato abreviado /S) Modo silencioso. Impede que mensagens sejam
exibidas.
/Unregister (formato abreviado /U) Remove os conjuntos e os Plug-ins do PI System
(PI AF Server) especificado.

Tópicos avançados
/RegFile:<string> (formato abreviado /RF) Cria um arquivo XML de registro para o conjunto
especificado que pode ser usado para registrar um
conjunto de Plug-ins e todos os seus conjuntos de
suporte relacionados. Qualquer arquivo adicional
especificado será tratado como conjuntos de
suporte.
/Version (formato abreviado /V) Exibe informações de versão. Todos os outros
parâmetros são ignorados.
/User:<string> (formato curto /user) Usado para especificar uma conta de usuário
diferente do Windows para conectar ao PI System
(PI AF Server).
/Password:<string> (formato abreviado /PW) Usado junto com o parâmetro User para
especificar a senha de outra conta de usuário do
Windows para conectar ao PI System (PI AF
Server).
/Owner:<string> (formato abreviado /Own) Nome do arquivo proprietário de todos os
conjuntos de suporte especificados. Normalmente
usado com o parâmetro Directory ao registrar
conjuntos de suporte. Por padrão, o nome do
diretório será relativamente determinado com o
parâmetro RootDirectory ou diretório de
trabalho atual, caso o diretório raiz não esteja
especificado.
/Directory:<string> (formato abreviado /Dir) Nome do diretório de todos os conjuntos de
suporte especificados. Normalmente usado com o
parâmetro Owner ao registrar conjuntos de
suporte. Por padrão, o nome do diretório será
relativamente determinado com o parâmetro
RootDirectory ou diretório de trabalho atual,
caso o diretório raiz não esteja especificado.
/RootDirectory:<string> (formato abreviado / Todos os conjuntos serão relativamente
RootDir) registrados no nome de diretório raiz especificado.
Normalmente usado com o parâmetro Recursive
ao registrar conjuntos em vez de usar o parâmetro
Directory. Por padrão, esse parâmetro será
configurado para o diretório de trabalho atual.
/Exclude:<string> (formato abreviado /E) Especifica diretórios ou arquivos de entrada a
serem excluídos ao pesquisar arquivos em um
diretório. Esse parâmetro pode ser especificado
mais de uma vez, mas os valores devem ser
exclusivos.
<Files> Arquivos do conjunto de entrada, arquivos de
registro ou diretórios a serem processados. Os
seguintes especificadores curinga podem permitir
a filtragem de arquivos processados nos diretórios:
"*" corresponde a zero ou mais caracteres, "?"
corresponde exatamente a um caractere. O
parâmetro Exclude também pode ser usado para
filtrar os arquivos processados.
@<file> Use o arquivo especificado para fornecer
parâmetros de entrada adicionais. O arquivo deve
conter um parâmetro por linha. As linhas de
comentários começam com o caractere "#".
/?, /help Exibe essas descrições de opção.

Tópicos avançados
Criar um arquivo de registro XML

Nos registros complexos ou executados com frequência, é possível criar um arquivo XML que
contenha as configurações necessárias.
Procedimento
• Para criar o arquivo XML, chame RegPlugin, especificando ambas as configurações
necessárias e o nome do arquivo XML usando o parâmetro /RegFile: (/RF:).
Exemplo
Para criar um arquivo XML que registre versões .NET 3.5 e .NET 4.0 de MyPlugIn.dll, envie o
seguinte comando:
RegPlugIn /RF: PlugIns\MyPlugIn.dll PlugIns\4.0\MyPlugIn.dll
O arquivo de registro resultante pode ser editado para fornecer todas as informações
adicionais necessárias ao registro do plug-n (que normalmente não são necessárias). Para
plug-ins de 64 bits, o arquivo de registro deve ser editado para configurar LoadProperties
para x64 e garantir que Directory esteja configurado para x64:
<SupportAssembly> <FilePath>x64\AFDRTest32Bit64Bit.dll</FilePath>
<ID>1e00000c-3228-366a-3809-737433324269</ID> <Name>AFDRTest32Bit64Bit</Name>
<Description>AFDRTest32Bit64Bit.dll Support Assembly</Description>
<Directory>x64</Directory> <LoadProperties>x64</LoadProperties> </
SupportAssembly>
Para registrar as implementações usando o arquivo de registro, envie o seguinte comando:

RegPlugIn /PISystem:MyPISystem MyPlugIn.xml
Criar um script de registro SQL

Procedimento
• Para criar um script de registro SQL, chame o utilitário RegPlugIn, especificando os
detalhes necessários e o parâmetro /OutputFile ou /AppendFile. O script resultante
pode ser carregado no bando de dados do SQL usando o SQL Server Management Studio ou
executado em uma linha de comando usando o utilitário sqlcmd, permitindo a instalação de
plug-ins nos computadores em que o AF SDK não está instalado.
Nota:
Para os desenvolvedores de plug-ins: O script SQL precisará ser gerado sempre que
uma nova versão do plug-in for compilada.
Exemplo
Por exemplo, para criar um script que registre um Plug-in apenas de .NET 3.5 direcionado a
qualquer CPU, envie o seguinte comando:
RegPlugIn /O:MyPlugIn.sql PlugIns\MyPlugIn.dll
Para gerar um script de registro SQL chamado MyPlugIn.sql que registre duas
implementações de MyPlugIn, um Plug-in apenas de .NET 3.5 direcionado a plataformas de x86
e x64, envie os seguintes comandos:
RegPlugIn /O:MyPlugIn.sql PlugIns\x86\MyPlugIn.dll RegPlugIn64 /A:MyPlugIn.sql
PlugIns\x64\MyPlugIn.dll
Para gerar um script de registro SQL de um arquivo de registro XML já criado, especifique o
nome do arquivo XML na linha de comando. Por exemplo:
RegPlugIn /O:MyPlugIn.sql MyPlugIn.xml

Tópicos avançados
Registrar um plug-in usando o script SQL gerado

Procedimento
1. Inicie o Microsoft SQL Server Management Studio.
2. Selecione Arquivo > Abrir > Arquivo.
3. Encontre e carregue o script.
4. Execute o script.
5. Para executar o script de uma linha de comando, chame o utilitário sqlcmd, especificando a
opção -i inputfile com o caminho e o nome do script SQL como inputfile e as configurações
de conexão necessárias para conectar o servidor do banco de dados.
Gerenciar provedores de plug-in contiguáveis

Por padrão, é possível executar os plug-ins PI AF de qualquer provedor. Para obter mais
segurança, é possível configurar o PI AF para que apenas plug-ins de provedores confiáveis
possam ser executados (PI AF Server 2.5 e superiores). Os provedores de plug-ins são
incentivados a codificar seus plug-ins com sinais usando uma tecnologia de autenticação de
código. Para controlar como a segurança de plug-ins é aplicada, configure verify level.
Para listar os provedores confiáveis, especifique o parâmetro afdiag/
TrustedProviderList. Para obter mais detalhes, consulte Parâmetros do AFDiag. Para
adicionar um provedor, especifique o parâmetro /TrustedProviderAdd:<providername>.
Para remover um provedor, especifique o parâmetro /
TrustedProviderRemove:<providername>.
1. Clique com o botão direito do mouse no plug-in dll e selecione Propriedades. A janela
Propriedades é exibida.
2. Clique na guia Assinaturas Digitais. (Se o plug-in não estiver assinado, a guia não será
exibida.)
3. Clique no botão Detalhes. A janela Assinaturas Digitais é exibida.
4. Clique em Visualizar Certificados. A janela Certificado é exibida.
5. Na guia Detalhes, navegue até o campo Assunto. O valor exibido nesse campo é o nome do
provedor confiável, que pode ser usado como o parâmetro <providername> para os
parâmetros /TrustedProviderAdd e /TrustedProviderRemove.
Para exibir o nível de verificação usado ao carregar os plug-ins de execução, envie o comando
afdiag e omita quaisquer parâmetros. Verifique se o nível está listado na seção Definição das
Configurações dos resultados.
Para configurar o nível de verificação, envie o comando afdiag, especificando o parâmetro /
PlugInVerifyLevel. Os níveis válidos são os seguintes:
• None: Desativa a validação, executa todos os plug-ins.

• AllowUnsigned: Executa plug-ins não assinados e plug-ins com assinaturas válidas.
• RequireSigned: Executa apenas plug-ins com assinaturas válidas.
• RequireSignedTrustedProvider: Executa apenas plug-ins com uma assinatura válida de
um provedor confiável.

Tópicos avançados
Modelar um processo
Nesta seção
• Modelar escopo
• Diretrizes para configurar um modelo
• Visualizar e editar modelos
• Criar modelos
• Portas e conexões
• Camadas
Modelar escopo
Porque o número ou a variedade de elementos englobados por um modelo não altera como um
modelo é armazenado, ele não ajuda no planejamento do projeto do modelo inicial e das
informações necessárias para concluir uma análise de modelo e obter resultados significativos.
Ao considerar o escopo de um modelo, é necessário lembrar que ele precisa ser pequeno o
suficiente para que as relações entre as propriedades sejam bem definidas, mas grande o
suficiente para incluir dados redundantes. Dados redundantes podem ser calculados com base
em outros dados no modelo.
Em níveis de escala diferentes ou modelagem de escopo, os consumidores das informações
resultantes serão trocados. Por exemplo, um engenheiro analisando o desempenho de um
equipamento de uma seção da fábrica pode precisar de informações mais detalhadas que um
utilitário planejando sozinho quem monitora os materiais na fábrica. O planejador precisa de
medidas no modelo que são diferentes da medida de que o engenheiro precisa. Os elementos
comuns a ambos os modelos usam os mesmos elementos filho; isso ajuda na construção de
vários modelos usando a mesma biblioteca de elementos.
Os três níveis de modelo, na ordem de escopo crescente, são os seguintes:
• Modelo de Unidade
◦ Este nível de modelagem normalmente inclui os menores detalhes de informações em
uma unidade de processamento ou área. Esse escopo é útil para monitorar o desempenho
do equipamento e é usado principalmente pelos engenheiros nesse equipamento. Loops
auxiliares e sistemas de aquecimento que ocorrem nesse nível de modelagem podem não
ter influência fora dessa área e, portanto, não estariam inclusos na próxima escala.
◦ Para realizar uma análise significativa no modelo do nível de uma unidade, dados
detalhados devem estar disponíveis nos materiais e nas quantidades dentro da unidade.
Se houver apenas informações disponíveis no parâmetro da unidade (as entradas e
saídas), essa será uma indicação que o modelo de dados esteja em sua menor
granularidade.
• Modelo de Várias Unidades
◦ Ao considerar modelos do tipo unidade para unidade, detalhes dentro da unidade
geralmente são resumidos pelas conexões de e para essa unidade. O material adicionado

Tópicos avançados
e enviado para as áreas de armazenamento (tanques, armazéns etc.) também estariam

inclusos.
◦ No nível de modelagem de várias unidades, medidas dentro da unidade que não afetam
os volumes de entradas e saídas principais não estão inclusas no modelo.
• Modelo do limite (Fábrica e Unidade de Negócios)
◦ É útil criar uma análise para os materiais entrando e saindo da "linha de cerca" da
fábrica, além de resumir as informações de unidade para unidade para apenas as
transações de e para o processo dos pontos de transferência do material (portos, escalas
de peso, feeds de tanque, pipelines). Esse nível também é útil para analisar transações
entre unidades de negócio em uma fábrica.
Diretrizes para configurar um modelo

Leve as seguintes regras em consideração ao configurar um modelo para análise:
• Use uma abordagem sistemática para identificar o local e a configuração de calibração de

cada instrumento no modelo.
• Associe cada instrumento ao fluxo correto e certifique-se de que as correções de
temperatura e gravidade específicas estejam aplicadas às medições do fluxo, se necessário.
Verifique se a correção é realizada pelo sistema do controlador ou pelo historiador.
• Valide as propriedades do tanque/inventário criando um modelo exclusivo para tanques,
inclusive envios e recebimentos. Insira a lista de materiais com as propriedades deles ao
mesmo tempo.
• Determine a tolerância de calibração de cada instrumento (pode-se usar ISO 5167 para
medir os orifícios) ou consulte as folhas de dados e os fabricantes do medidor.
• Crie e examine modelos de unidades individuais antes de tentar conectá-los e executar uma
análise de várias unidades.
• Depois de arquivar toda a conectividade da unidade, verifique todo o desenho e execute
uma análise de equilíbrio para identificar fluxos e conexões não solucionados.
Visualizar e editar modelos

Procedimento
1. Clique com o botão direito do mouse no Navegador.
2. Selecione Conexões de Modelo no menu de pop-up resultante. A caixa de diálogo Conexões
é exibida. Ela mostra uma representação visual dos elementos no modelo e como eles são
conectados.
3. Para editar o modelo:
◦ Clique com o botão direito do mouse em um elemento no painel Conexões para criar uma
nova conexão ou para visualizar/editar as propriedades do elemento.
◦ Clique em um elemento para centralizá-lo no painel Conexões e mostrar quaisquer
outros elementos conectados. É possível se mover no fluxo do modelo dessa forma:
elemento por elemento.
◦ Clique em uma conexão para visualizar/editar a conexão ou para adicionar outra origem
ou outro destino.
◦ Clique com o botão direito do mouse em uma conexão para fazer outra conexão,
visualizar as propriedades da conexão selecionada ou copiar/colar as propriedades da
conexão.

Tópicos avançados
Criar modelos
Procedimento
1. No painel Navegador, clique no botão Elementos. A coleção de elementos aparece no
Navegador.
2. Clique com o botão direito do mouse na coleção de elementos e selecione Novo Modelo no
menu resultante. A janela Escolher Padrão do Modelo é exibida.
3. Selecione um template no qual basear o modelo ou selecione Nenhum.
4. Clique em OK. As guias configuração do modelo aparecem no Visualizador.
5. Clique na guia Geral. Configure o modelo:
◦ No campo Nome, insira um nome para o modelo.
◦ No campo Descrição, insira uma descrição para o modelo. Uma descrição é opcional.
◦ As caixas Template e Tipo de somente leitura lista o template e o tipo de elemento
selecionados durante a criação do modelo. Para visualizar as propriedades do template,
clique em . Os tipos de elemento estão descritos em Tipos de elemento em modelos.
◦ Podem-se organizar objetos agrupando-os em categorias. Para navegar as categorias

disponíveis, clique em . Essa etapa é opcional.
◦ Para atribuir um atributo padrão, clique em ao lado da caixa Atributo Padrão para
exibir uma lista de atributos disponíveis. Então, selecione o atributo. Observe que é
necessário adicionar atributos na guia Atributos antes de eles aparecerem na lista. Essa
caixa será somente leitura se o modelo estiver baseado em um template; a caixa exibirá o
atributo especificado no template.
◦ Clique em ao lado do campo Padrão de nomenclatura para selecionar os parâmetros
de substituição para definir um padrão de nomenclatura para os elementos criados com
base nesse template (opcional).
◦ Clique em Propriedades Estendidas para configurar uma ou mais propriedades
adicionais para o modelo. Depois que a janela Propriedades Estendidas é aberta, clique
com o botão direito do mouse na caixa Nome e selecione Nova Propriedade Estendida.
Especifique um nome e um valor para a propriedade.
Nesta seção
• Submodelos
• Tipos de elemento em modelos
Submodelos
Um modelo também é um elemento, o que significa que um modelo pode ser composto por
outros modelos, chamado de submodelos. Isso permite o desenvolvimento de cima para baixo
ou de baixo para cima de um modelo da planta. Os elementos de limite de um modelo
normalmente definem os elementos com portas que podem ser usadas para conexões fora do
modelo.

Tópicos avançados
Tipos de elemento em modelos

Seis tipos de elemento principal são usados para aplicar regras de conectividade entre
elementos de um modelo.
• Use um Nó para representar uma entidade física no modelo, como um tanque, uma válvula
ou uma unidade de processo.
• Use a opção Medida para indicar que o elemento é usado para verificar dimensões,
quantidades, capacidades etc. (por exemplo, metros e escalas).
• Use a opção Fluxo para indicar que o elemento carrega material de um elemento para outro.
• Use a Transferência como um fluxo temporal. A existência de uma transferência em um
modelo só está disponível no contexto do tempo, por exemplo, em um caso. As
transferências também podem ser acessadas realizando pesquisas baseadas no tempo do
banco de dados.
• Use o Limite para definir as portas de entrada e saída do modelo.
• Use Outro para representar uma coleção lógica de atributos, como uma receita.
Além dos tipos de elemento principal, dois outros tipos recebem suporte: Qualquer e Nenhum.
Use os tipos de elemento Qualquer e Nenhum ao definir as regras de conectividade de uma
porta.
Portas e conexões
Elementos em um modelo estão conectados por qualquer número de portas, definidas pelo
template de elemento. Uma porta pode ser definida como sendo uma porta de entrada, de saída
ou não direcionada. A porta define quantas conexões podem ser feitas e os tipos de elementos
que podem ser conectados.
Nas análises, as portas direcionadas (de entrada e saída) representam o fluxo positivo de
material e são usadas por conexões. Portas não direcionadas são usadas por anexos de
medidores e análises. O tipo mais comum de anexo em um modelo é uma medição ou medidor
anexado ao elemento do fluxo.
Uma conexão representa o vínculo entre as portas de dois elementos. As portas, definidas pelo
template de elemento, podem ser definidas como portas de entrada, saída ou não direcionadas.
Nesta seção
• Criar portas
• Criar conexões
Criar portas
Procedimento
1. Selecione o elemento no Navegador e clique na guia Portas no Visualizador.

Tópicos avançados
Nota:
Se o elemento for baseado em um template, não será possível adicionar uma porta, a
não ser que o template permita extensões.
2. Clique em Nova Porta e crie uma porta para o elemento. Clique com o botão direito do
mouse em uma porta existente para visualizar/editar suas propriedades.
3. Configure a porta.
◦ Tipo de Porta: Selecione o tipo de porta: Entrada, Saída ou Não Direcionado (para
metros, por exemplo).
◦ Categorias Permitidas: Selecione as categorias nas quais é permitido que a porta seja
membro.
◦ Conexões Máximas: Especifique o número máximo de conexões que podem ser feitas
com a porta. Insira zero para obter um número ilimitado de conexões.
◦ Tipo de Conexão: Selecione o tipo de elementos nos quais a porta pode ser conectada,
por exemplo, Nó, Medida e assim por diante.
◦ Templates Permitidos: Selecione os elementos permitidos para fazer a conexão com a
porta. Selecione apenas os elementos criados no template selecionado.
Nota:
Para especificar essa porta como padrão, é necessário abrir a janela Propriedades.
Criar conexões
A guia Conexões exibe as conexões no modelo.
Procedimento
1. Para criar um novo modelo no Navegador, clique com o botão direito do mouse na coleção
de elementos, conforme descrito em Criar modelos, e selecione Novo Modelo.
2. Siga estas etapas para preencher a guia Conexões.
a. Clique com o botão direito do mouse e selecione Nova Conexão. A janela Fazer Conexão é
exibida.
b. Clique com o botão direito do mouse em uma conexão existente para visualizar/editar
suas propriedades.
c. Na caixa Origem, selecione a origem da conexão. Selecione a porta apropriada da origem
na caixa Porta correspondente.
d. Na caixa Destino, selecione o destino da conexão. Selecione a porta apropriada do
destino na caixa Porta correspondente.
Para incluir elementos filhos, marque a caixa de seleção Incluir Elementos Filho.
Camadas
É possível organizar os elementos de um modelo em camadas. As camadas fornecem um
mecanismo para incluir e excluir partes do modelo, conforme necessário para a análise. Um
elemento de um modelo pode pertencer a mais de uma camada. Também é possível usar o
utilitário Camadas com uma ferramenta de modelagem gráfica, como o ProcessBook, para
fornecer uma funcionalidade de sobreposição visual.

Tópicos avançados
Criar camadas
Procedimento
1. No Navegador, clique com o botão direito do mouse para selecionar o modelo no qual a
camada será adicionada e selecione Novo Modelo no menu resultante.
2. Clique na guia Camadas no painel Navegador.
3. Clique com o botão direito do mouse em qualquer lugar no campo e selecione Nova Camada
no painel resultante.
A caixa de diálogo Propriedades da Camada é exibida.
4. Dê um nome para a camada e, como alternativa, insira uma descrição breve.
5. Clique em OK.

Termos do PI AF
Nesta seção
• Atributos
• Templates de atributo
• Templates base
• Atributos de configuração
• Referências de dados
• Atributo padrão
• Template de elemento
• Elementos
• Estrutura de eventos
• Propriedades estendidas
• Dados externos
• Fonte de dados externa
• Tabela externa
• Conexões representadas
• Tabela importada
• Atributos indexados
• Tabela interna
• Tabela vinculada
• Modelos
• Conexão não representada
• Bancos de dados PI AF
• Biblioteca salva do PI AF
• PI AF Server
• Banco de dados SQL do PI AF
• Tabela
• PI Asset Framework (PI AF)
• Referência de dados da matriz do PI Point
• Referência de dados PI Point
• Dada da Consulta
• Parâmetros de substituição
• Templates
• Referência de dados da pesquisa de tabela
• Unidade de Medida (UDM)

Termos do PI AF
Atributos
Para associar dados a um elemento, é necessário configurar os atributos de elemento. Cada
elemento do PI AF pode ter um ou mais atributos. Os atributos só podem manter valores
simples que representem informações fixas, como o diâmetro de um tanque. Um atributo pode
ser usado como referência de dados para afazer referência a uma matriz do PI Point, uma
fórmula, um valor de uma tabela externa (não PI) ou um valor de uma tabela interna (uma
tabela definida no PI AF).
Templates de atributo
Os templates de atributo estão associados aos templates de elemento. Assim como um template
de elemento representa um tipo de ativo, um template de atributo representa um tipo de
configuração de dados. Ao criar uma instância do template de elemento, esse elemento conterá
um atributo para cada template de atributo. Esses atributos herdam todas as propriedades
configuradas no template de atributo.
Templates base
Ao criar um template, pode-se especificar um template existente como sendo o template base. O
novo template automaticamente contém todos os atributos e portas do template base. É
possível adicionar mais atributos e portas ao novo template, mas não é possível remover os
atributos herdados do template base. Use um template base quando um objeto tiver um
subconjunto de outros atributos e portas do objeto.
Atributos de configuração
Os atributos de configuração são atributos que representam propriedades herdadas de um
ativo. Qualquer atributo que tenha um valor constante pode ser um item de configuração.
Porque pressupõe-se que o valor do atributo de um item de configuração seja constante, o PI
System Explorer automaticamente faz check out do atributo quando o valor do atributo é
alterado. Para confirmar a alteração, é necessário fazer o check in dela. No PI System Explorer,
os atributos de configuração são marcados com um ícone de lápis ( ).
Os atributos com valores alterados, como referências de dados do PI Point ou referências de
dados de fórmula não devem ser atributos de configuração. Quando o valor de um atributo de
não configuração é alterado, o PI System Explorer não faz o check out do atributo. Por exemplo,
suponha que haja um elemento representando um tanque. O elemento tem os seguintes
atributos:
• fabricante
• foto (arquivo)
• número de série
• classificação da temperatura máxima
• volume máximo
• temperatura (referência de dados do PI Point)
• volume (referência de dados do PI Point)

Termos do PI AF
Os primeiros cinco atributos normalmente seriam itens de configuração, já que esses

valores não serão alterados, a não ser que o equipamento seja. Os últimos dois atributos não
seriam itens de configuração, já que os valores mudam todo o tempo.
Referências de dados
Uma referência de dados é um mecanismo que permite que um valor de atributo seja obtido em
dados externos. O PI AF fornece referências de dados dos PI Points, das operações de busca da
tabela de banco de dados e dos cálculos baseados em fórmulas.
Uma referência de dados é configurada diretamente no atributo de elemento PI AF. Os
atributos com referências de dados geralmente são chamados de atributos de referências de
dados. Por exemplo, para obter os valores de um PI Point, configure uma referência de dados do
PI Point.
Atributo padrão
O atributo padrão é um atributo que aplicativos clientes podem usar para representar o
elemento quando nenhum outro atributo é especificado. O atributo deve estar no nível
superior da hierarquia de atributos do elemento. Ele não pode ser colocado em outro atributo.
Escolha o atributo mais representativo do elemento. Por exemplo, se um usuário tivesse feito
referência de um tanque, talvez o nível seria o melhor atributo individual a ser usado. Em um
medidor elétrico, volts de corrente.
Nota:
Alguns aplicativos clientes usam o mesmo atributo padrão, mas muitos não o usam
Template de elemento
Um template de elemento é basicamente um modelo de um tipo de ativo. Os templates de
elemento facilitam muito a criação de telas, notificações, cálculos e análises porque
equipamentos do mesmo tipo podem compartilhar a implementação. Em geral, um template de
elemento que representa um tipo de equipamento, como um tanque ou uma bomba, é criado.
Elementos podem ser facilmente criados com base no template, pois a maior parte da
configuração do elemento é definida no template.
Elementos
Elementos são building blocks do PI AF. Eles podem representar:
• Objetos físicos, como bombas ou tanques. Os objetos físicos são, normalmente, peças de
equipamento. Para associar dados a um elemento, é necessário criar atributos no elemento.
• Objetos de building block, para organizar os dados. Quando houver vários elementos
representando objetos físicos, será necessário configurar uma estrutura de árvore lógica
para organizá-los.
Por exemplo, na seguinte imagem, o elemento Lista de Equipamentos e os elementos Bombas,
Tanques, Medidores de Fluxo, Trocadores de Calor e Reatores são elementos estruturais. Eles
podem ou não ter dados associados, mas o objetivo principal deles é facilitar a procura dos
elementos de equipamento e fornecer um panorama dos ativos disponíveis.
Da mesma forma, os elementos SL Tank 001, SL Tank 002 e SL Tank 003 representam peças
específicas de equipamento.

Termos do PI AF
Estrutura de eventos
Uma estrutura de eventos é um recurso PI System que ajuda na captura, no monitoramento, na
comparação ou na análise de processos importantes ou eventos de negócios e de seus dados
relacionados para um período de tempo repetível. As estruturas de eventos representam
ocorrências no processo sobre as quais deseja-se saber mais, por exemplo, inatividade do ativo,
excursões do processo, inicialização ou desligamento do equipamento, excursões ambientais,
lotes de monitoramento do produto, execuções de produto, classes de papel e turnos dos
operadores. Assim como os elementos, as estruturas de eventos permitem a coleta e o
armazenamento de dados dos ativos.
Propriedades estendidas
Propriedades estendidas são propriedades definidas por outros aplicativos nos objetos PI AF.
Por exemplo, o PI WebParts armazena ícones e URLs nas propriedades estendidas de um
elemento PI AF. Os aplicativos geralmente usam as informações armazenadas nas
Propriedades estendidas de forma programática com o PI AF SDK. Em geral, os usuários do PI
System Explorer não precisam usar esse recurso avançado.
Dados externos
No PI Asset Framework, os dados externos são dados mantidos em um banco de dados ou
arquivo fora do PI AF. Por exemplo, dados externos podem ser uma tabela em um banco de
dados SQL ou uma tabela definida em uma planilha do Excel. O PI AF pode acessar tais dados
externos por meio de uma tabela PI AF especialmente configurada.
Fonte de dados externa

Um banco de dados ou aplicativo que contém dados externos vinculados a uma tabela PI AF.
Tabela externa
Uma tabela externa (também chamada tabela vinculada) é uma tabela PI AF vinculada a uma
tabela em uma planilha ou banco de dados relacional não PI. Os dados da tabela não são
armazenados no banco de dados PI AF. Não é possível editar uma tabela externa pelo PI AF. O
PI AF acessa os dados da tabela por meio de uma referência de dados de pesquisa.

Termos do PI AF
Conexões representadas
Um tipo de conexão entre uma tabela vinculada e uma fonte de dados externa. Esse tipo de
conexão usa a identidade do Windows do cliente que faz a solicitação para se conectar a fonte
de dados externa.
Tabela importada
Uma tabela importada é uma tabela PI AF criada pela importação de uma tabela em uma
planilha ou banco de dados relacional não PI. Depois de importada, os dados da tabela são
armazenados no banco de dados PI AF e perdem a conexão com a tabela de origem não PI.
Tabelas importadas são tabelas de leitura/gravação. Seu tamanho é limitado, mas elas são mais
seguras que as tabelas vinculadas. O PI AF acessa os dados da tabela por meio de uma
referência de dados de pesquisa.
Atributos indexados
Os atributos indexados são atributos otimizados para obter resultados de pesquisa e
recuperação de valores rápidos. Só é possível indexar atributos cujos valores são armazenados
no banco de dados PI AF. Isso significa que não é possível indexar atributos que obtêm seus
valores pelas referências de dados PI Point ou pelas referências de tabela vinculada.
Quando um atributo é indexado, a pesquisa retorna o atributo e seu valor com mais rapidez. No
entanto, aos atributos indexados aumentam o tamanho da tabela no banco de dados PI AF e
criam uma carga de CPU no SQL Server. Os atributos indexados são marcados com o ícone .
Em geral, os atributos nos quais os usuários frequentemente fazem pesquisa são indexados.
Por exemplo, caso desejem-se localizar ativos pesquisando por um número de série, será
necessário indexar o atributo do número de série.
Tabela interna
Uma tabela interna é uma tabela mantida totalmente no PI AF. As tabelas internas são tabelas
importadas (consulte Tabela importada) ou totalmente definidas e mantidas no PI AF. Por
outro lado, tabelas vinculadas são tabelas externas, pois os dados da tabela estão localizados
fora do PI AF. O PI AF acessa os dados da tabela por meio de uma referência de dados de
pesquisa.
Tabela vinculada
Uma tabela vinculada é uma tabela PI AF vinculada a uma tabela em uma planilha ou banco de
dados relacional não PI. Os dados da tabela não são armazenados no banco de dados PI AF. Não
é possível editar uma tabela externa pelo PI AF. O PI AF acessa os dados da tabela por meio de
uma referência de dados de pesquisa. As tabelas vinculadas também são chamadas de tabelas
externas (consulte Tabela externa), pois os dados são armazenados fora do PI AF.
Modelos
Um modelo é composto por elementos conectados que representam um modelo lógico do
processo. O próprio modelo é um elemento, mas ele contém duas propriedades de elemento

Termos do PI AF
adicionais: camadas e conexões. Os elementos no modelo podem representar entidades físicas

no processo, como tanques, canos e unidades de processo, ou entidades lógicas, como dados de
receita e resumo. O modelo é composto por elementos conectados.
Os modelos podem ser simples, contendo apenas um conjunto de elementos, ou muito
complexos, contendo milhares de elementos e medidas. Seu tamanho só é limitado pelos dados
disponíveis para atender às necessidades de informações de uma análise do modelo.
Conexão não representada

Um tipo de conexão entre uma tabela vinculada e uma fonte de dados externa. Esse tipo de
conexão não usa a identidade do cliente que faz a solicitação para se conectar a fonte de dados
externa.
Bancos de dados PI AF
O PI AF armazena objetos da estrutura de ativos (elementos, templates etc.) nos bancos de
dados PI AF. Podem-se ter vários bancos de dados no PI AF, mas somente um pode ser
conectado por vez. Normalmente, trabalha-se com bancos de dados PI AF no PI System
Explorer ou no PI Builder. Ao iniciar o PI System Explorer, ele se conectar ao banco de dados PI
AF padrão. Se nenhum banco de dados definido, o PI System Explorer solicita a criação de um
novo banco de dados.
Nota:
O banco de dados Configuração é usado por clientes PI AF quando eles usam o PI AF. Não
use esse banco de dados em dados próprios do aplicativo.
Biblioteca salva do PI AF
A biblioteca salva do PI AF fornece uma coleção de aplicativos ou objetos específicos do
domínio que pode ser importada para um banco de dados PI AF. Normalmente, bibliotecas
salvas incluem categorias, templates de elemento, conjuntos de enumerações, tipos de
referência, tabelas e Banco de dados de unidade de medida. No entanto, quando uma biblioteca
é salva, a opção para incluir outros objetos, como elementos e notificações, fica disponível.
Apesar de o Banco de dados UDM não ser mostrado na guia Biblioteca do Painel Navegador, ele
sempre está incluso como parte de bibliotecas salvas.
Nota:
As bibliotecas são armazenadas como XMLs no Banco de Dados SQL do AF. Isso é muito
diferente da opção Exportar para Arquivo, que exporta todo o banco de dados como um
arquivo XML.
PI AF Server
O PI AF Server é composto pelo serviço de aplicativo PI AF e pelo banco de dados SQL do PI AF.
O serviço de aplicativo PI AF é executado como um serviço no sistema em que está instalado.
Banco de dados SQL do PI AF

O PI AF usa o Microsoft SQL Server para armazenar seus dados. O banco de dados SQL do PI AF
é o banco de dados do SQL Server que contém as informações de configuração do PI AF e todos

Termos do PI AF
os bancos de dados PI AF definidos pelo usuário. O banco de dados SQL do PI AF chama-se

PIFD no banco de dados do SQL.
Tabela
Tabelas PI AF armazenam dados que são melhor representados em formato de tabela, como
são encontrados nos bancos de dados relacionais. As tabelas PI AF são otimizadas para
armazenar dados relativamente estáticos, como códigos de produtos, listas de materiais e
tabelas fortes.
Um usuário pode criar suas próprias tabelas ou usar as tabelas PI AF para acessar dados de
tabelas externas ao PI AF, como o Microsoft Access, o Microsoft Excel ou o Microsoft SQL
Server. Há três métodos básicos para gerar as tabelas.
• Importe uma tabela externa ao PI AF. Os dados são importados no banco de dados AF e
armazenados como uma tabela PI AF interna de leitura/gravação.
• Vincular a uma tabela externa (não PI). Tabelas externas são lidas pelo AF Server quando
solicitado pelo cliente. Os dados da tabela externa não são duplicados no banco de dados AF.
• Criar e preencher uma tabela manualmente no PI System Explorer.
Para extrair um valor de uma tabela, crie a referência de dados de pesquisa da tabela em um
atributo.
Para extrair um valor de uma tabela, crie a referência de dados de pesquisa da tabela em um
atributo.
Nota:
Porque as tabelas PI AF são completamente carregadas na memória do cliente, há um
limite prático no tamanho suportado da tabela.
PI Asset Framework (PI AF)

O PI Asset Framework (PI AF) é o produto OSIsoft que organiza e fornece acesso a dados no
contexto de seu ambiente. Por exemplo, operadores da planta podem visualizar dados
associados a ativos físicos, como equipamento, dispositivos e unidades de processamento. O PI
Asset Framework é composto pelo PI AF Server, pelo PI Builder e pelo PI System Explorer.
A instalação do PI AF Server inclui o serviço de aplicativo PI AF e o banco de dados SQL do PI
AF. Juntos, o serviço de aplicativo e o banco de dados têm o mesmo nome do PI AF Server.
Esses componentes podem ser instalados em um ou vários computadores. O PI AF dá suporte a
várias configurações de instalação, inclusive à instalação do serviço de aplicativo AF e ao banco
de dados SQL do AF ou à implementação de recursos de alta visibilidade com coletivos do PI AF
Server.
Referência de dados da matriz do PI Point

Use a referência de dados da matriz do PI Point para vincular atributos de elementos a
matrizes dos PI Points para ler ou gravar o valor deles. Cada nome de tag especificado
corresponde a uma entrada na matriz. Esse tipo de referência de dados permite incorporar
dados de diferentes PI Points em um único valor, que pode ser uma função de resumo, como
uma média.

Termos do PI AF
Referência de dados PI Point

Uma data reference PI Point é uma referência de um atributo AF a um PI Point. O valor do
atributo da referência de dados pode ser o mesmo do valor do ponto ou pode ser o resultado
de um cálculo baseado nos valores do ponto. Pode-se criar uma referência de dados PI Point
para:
• um atributo de elemento ou template de atributo

• um atributo de transferência ou template de atributo
• um atributo de estrutura de eventos ou template de atributo
As referências do PI Point para os templates de atributo têm alguns valores extras. Ao criar
uma referência de dados PI Point em um template de atributo, pode-se:
• Criar automaticamente tags referenciadas por atributos baseados nesse template.

• Criar um esquema de nomeação para atributos baseados nesse template para que os
atributos criados com base nele tenham nomes exclusivos com uma estrutura consistente.
Dada da Consulta
A Dada da Consulta determina as configurações de tempo usadas pelo PI System Explorer para
• encontrar e exibir valores de atributos

• identificar as versões atuais dos objetos a serem exibidas e inclusas nos resultados da
pesquisa
Para obter uma descrição detalhada da Data da Consulta, consulte Data da consulta e horário
PI System Explorer.
Parâmetros de substituição
Os parâmetros de substituição são variáveis inseridas nos templates de atributo e nas
referências de dados da matriz do PI Point. O PI AF resolve os parâmetros de substituição
quando ele cria a referência de dados para um atributo baseado nesse template. Por exemplo,
podem-se usar os parâmetros de substituição:
• Para configurar um template de referência de dados do PI Point para usar nomes de tags
com base em nomes de elementos originados desse template.
• Para usar o valor de outros atributo na configuração de um valor de propriedades do PI
Point.
Templates
Um template de elemento define um conjunto base de atributos e portas. Quando elementos
baseados em um template são criados, o elemento herda a configuração dos atributos e das
portas. Isso permite a criação muito rápida de vários elementos. Crie o template uma vez e
vários elemento baseados no template, conforme necessário. Por exemplo, ao alterar um
template de elemento, as alterações são propagadas para todos os elementos baseados nesse
template. Os templates de elemento podem poupar tempo e assegurar consistência entre todos
os elementos.

Termos do PI AF
É possível criar templates para:
• Elementos
• Estruturas de eventos
• Transferências
• Modelos
• Notificações (apenas se o usuário tiver licença para usar o PI Notitications).
Referência de dados da pesquisa de tabela

A referência de dados da pesquisa de tabela fornece uma forma conveniente de procurar dados
em uma das tabelas PI AF. Declarações de seleção SQL são criadas para definir a consulta. A
referência de dados normalmente retorna o valor de coluna especificado na caixa Coluna de
Resultados que corresponde à primeira linha encontrada usando a cláusula WHERE.
No entanto, se o tipo de dados do atributo for um tipo de matriz, e o valor na caixa Coluna de
Resultados não, a referência de dados retornará uma matriz, na qual cada elemento da matriz
corresponde a uma linha que atende à condição da cláusula WHERE. Nesse modo, se nenhuma
linha correspondente for encontrada, uma matriz vazia será retornada.
Unidade de Medida (UDM)

Uma classe UDM é definida pelas dimensões fundamentais de suas medições. Exemplos de
classes UDM são: Massa, Volume e Densidade. O PI AF fornece manipulação automática para
conversões simples entre unidades de medida em atributos da mesma classe UDM.
O PI AF é enviado pré-carregado com várias classes de unidade de medida padrão e fatores de
conversão. Essas classes podem ser ampliadas adicionando novas unidades de medidas e novas
classes de medição. A implementação de UDMs está baseada no Sistema Internacional (SI) de
Unidades.

Termos do PI AF

Suporte técnico e outros recursos
Para obter assistência técnica, contate o suporte técnico OSIsoft em +1 510-297-5828 ou
através da página de Suporte Técnico da OSIsoft (https://techsupport.osisoft.com/Contact-
Us/). O site do Suporte Técnico da OSIsoft oferece outras opções de contato para clientes de
fora dos Estados Unidos.
Ao contatar o Suporte Técnico da OSIsoft, tenha estas informações em mãos:
• Nome do produto, números da versão e do build
• Detalhes sobre a plataforma do computador (tipo de CPU, sistema operacional e número da
versão)
• Hora em que o problema iniciou
• Arquivos de registro do momento
• Detalhes de quaisquer alterações do ambiente antes do início do problema
• Resumo do problema, inclusive todos os arquivos de log relevantes da hora em que o
problema ocorreu
O site OSIsoft Virtual Campus (vCampus) (https://vcampus.osisoft.com) tem recursos
baseados em assinatura para ajudar na programação e na integração dos produtos da OSIsoft.

Suporte técnico e outros recursos

PI System Explorer 2014 R2 User Guide PT

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

PI System Explorer 2014 R2 User Guide PT

Uploaded by

Copyright:

Available Formats

PI System Explorer

Para o PI Asset Framework 2.6.1 incluído no PI Server 2014 R2

Guia do Usuário do PI System Explorer

Usar o PI System Explorer......................................................................................3

Conectar aos servidores e bancos de dados............................................................17

Encontrar e visualizar informações de ativos..........................................................31

Guia do Usuário do PI System Explorer iii

Pesquisar atributos nas estruturas de eventos..................................................................................... 43

Projetar e implementar os modelos de ativos do PI AF............................................57

Análise com base em ativos para o PI Server........................................................ 131

iv Guia do Usuário do PI System Explorer

Gerenciar análises de um elemento....................................................................................................... 142

Guia do Usuário do PI System Explorer v

vi Guia do Usuário do PI System Explorer

Usar estruturas de eventos para capturar eventos de processos............................ 245

Tópicos avançados............................................................................................ 259

Guia do Usuário do PI System Explorer vii

Exemplos de atributos de referência do mesmo elemento ................................................................ 267

Termos do PI AF................................................................................................ 305

viii Guia do Usuário do PI System Explorer

Conexão não representada.................................................................................................................... 310

Suporte técnico e outros recursos....................................................................... 315

Guia do Usuário do PI System Explorer ix

x Guia do Usuário do PI System Explorer

• Suporte a estruturas de eventos

• Análises baseadas em ativos

Como ativos são representados no PI AF

Guia do Usuário do PI System Explorer 1

Ferramentas para trabalhar com o PI Asset Framework

2 Guia do Usuário do PI System Explorer

Componentes da interface de usuário PI System Explorer

Guia do Usuário do PI System Explorer 3

Trabalhar com o conteúdo do visualizador

4 Guia do Usuário do PI System Explorer

Controlar o número de objetos no visualizador

Configurar colunas exibidas

Selecionar vários objetos para operações

• Para selecionar o grupo de objetos contínuos no Visualizador, clique em um objeto, mova o

Mostrar os valores de atributo na unidade de medida de origem

Guia do Usuário do PI System Explorer 5

Alterar a unidade de medida para um valor de atributo

Copiar objetos do visualizador

• Copiar copia toda uma linha.

Uma Linha Selecionada, o Elemento MixTruck, no Tutorial Achocolatado.

Mostrar atributos como colunas

6 Guia do Usuário do PI System Explorer

4. Selecione os atributos a serem exibidos no Visualizador:

de atributos exibidos (no lado direito da caixa de diálogo) ou clique em para

O que Fazer Depois

Selecionar os atributos de um template

4. Selecione um atributo no template e clique em para adicionar o atributo à lista de

Guia do Usuário do PI System Explorer 7

Selecionar atributos de um elemento

Selecionar atributos por nome

4. Clique em Adicionar para adicionar os atributos à lista de atributos exibidos.

Ajustar configurações de idioma

Fazer check in e check out do trabalho

8 Guia do Usuário do PI System Explorer

Guia do Usuário do PI System Explorer 9

10 Guia do Usuário do PI System Explorer

Guia do Usuário do PI System Explorer 11

Importar e exportar bancos de dados e objetos de banco de

Importar e exportar um banco de dados

Exportar um banco de dados para XML