PI System Explorer

Guia do usuário

No PI Asset Framework 2.9 incluído no PI Server 2017

OSIsoft, LLC.
1600 Alvarado Street
San Leandro, CA 94577 USA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com

Guia do Usuário do PI System Explorer

© 2009-2017 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 a logomarca da OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud
Services, OSIsoft Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset
Framework, PI Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Data Archive, PI DataLink, PI
DataLink Server, PI Developer’s Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI
Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI
ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Vision, PI Visualization Suite, PI
Web API, PI WebParts, PI Web Services, RLINK e RtReports são todos 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.9
Publicado em: 17 abr 2017
Conteúdo

Introdução ao PI Asset Framework......................................................................... 1

Como ativos são representados no PI AF................................................................................................... 1
PI System Explorer....................................................................................................................................2
Componentes da interface de usuário do PI System Explorer................................................................ 3
Sugestões de recursos........................................................................................................................... 3
Navegador do PI System Explorer......................................................................................................... 4
Personalizar o navegador...................................................................................................................... 5
Opções de personalização do PI System Explorer..................................................................................5
Configuração de exibição da coluna...................................................................................................... 6
Selecionar vários objetos no visualizador.............................................................................................. 8
Duplicação de objeto............................................................................................................................ 9
Check-in de alterações do banco de dados............................................................................................ 9
Atalhos do teclado...............................................................................................................................11
Alterar o idioma...................................................................................................................................12
Caracteres válidos em nomes de objetos PI AF.................................................................................... 13
Tempo PI............................................................................................................................................. 13

Conexões de servidor e banco de dados.................................................................17

Conexões do PI AF Server........................................................................................................................ 17
Conectar a um PI AF Server................................................................................................................. 18
Adicionar um PI AF Server à lista de conexões..................................................................................... 19
Propriedades do PI AF Server.............................................................................................................. 20
Visualizar propriedades gerais do PI AF Server conectado................................................................... 20
Gerenciar identidades......................................................................................................................... 21
Gerenciar mappings............................................................................................................................ 22
Visualizar contagens de objeto do PI AF Server................................................................................... 24
Configurar acesso ao Active Directory dos contatos............................................................................ 24
Conexões do PI Data Archive.................................................................................................................. 26
Conectar ao PI Data Archive................................................................................................................26
Adicionar PI Data Archives a listas do servidor conectadas.................................................................. 28
Visualizar status de buffering para PI Data Archives conectados......................................................... 29
Conexões de banco de dados PI AF......................................................................................................... 30
Criar bancos de dados PI AF.................................................................................................................30
Visualizar ou editar propriedades de bancos de dados PI AF................................................................ 31
Conectar a um banco de dados em um PI AF Server diferente............................................................. 32
Configurar o banco de dados padrão................................................................................................... 33
Renomear bancos de dados................................................................................................................. 33
Pesquisar bancos de dados PI AF......................................................................................................... 33
Atualizar a lista de bancos de dados.....................................................................................................33
Exclusão do banco de dados................................................................................................................ 34
Conexões coletivas do PI AF e PI Data Archive........................................................................................ 34
Gerenciar as preferências de conexão do PI System Explorer...............................................................34
Alternar membros do coletivo............................................................................................................. 36
Alternar para um membro do coletivo específico.................................................................................36

Importação e exportação de banco de dados......................................................... 39

Exportar um banco de dados para XML................................................................................................... 39
Opções de exportação XML................................................................................................................ 40
Todos os objetos referenciados........................................................................................................... 40
Formato de arquivo para exportação e restauração............................................................................. 43
Restaurar bancos de dados de arquivos XML exportados........................................................................ 43
Exportação de objetos de biblioteca para outro banco de dados............................................................. 44

Guia do Usuário do PI System Explorer iii

Conteúdo

Bibliotecas salvas do PI AF.................................................................................................................. 44

Salvar bancos de dados como biblioteca............................................................................................. 44
Carregar bibliotecas de banco de dados.............................................................................................. 45
Revisar propriedades de bibliotecas carregadas.................................................................................. 45
Utilitário AFExport.................................................................................................................................. 45
Diretrizes para exportar coleções........................................................................................................ 46
Parâmetros do utilitário AFExport.......................................................................................................46
Caminhos de exportação de amostra.................................................................................................. 48
Utilitário AFImport..................................................................................................................................48
Parâmetros do utilitário AFImport.......................................................................................................49

Recuperação de informações sobre ativos............................................................. 51

Navegação de ativos............................................................................................................................... 51
Navegação de elemento......................................................................................................................52
Configurar tamanho de página do navegador......................................................................................52
Abrir janelas adicionais do navegador..................................................................................................53
Pesquisas de ativos e dados de ativos...................................................................................................... 53
Pesquisa rápida................................................................................................................................... 54
Pesquisar paginação de resultados...................................................................................................... 54
Tamanhos máximos de consultas........................................................................................................ 54
Pesquisas em uma data específica....................................................................................................... 55
Pesquisar pontos PI............................................................................................................................. 55
Gerenciar resultados da pesquisa........................................................................................................ 61
Pesquisar elementos........................................................................................................................... 62
Pesquisar atributos em elementos...................................................................................................... 65
Pesquisar estruturas de evento............................................................................................................67
Pesquisar atributos nas estruturas de eventos..................................................................................... 70
Pesquisar transferências...................................................................................................................... 71
Pesquisar atributos em transferências................................................................................................. 73
Tendências no PI System Explorer...........................................................................................................74
Criar tendências...................................................................................................................................75
Gerenciamento de versão para equipamentos e processos...................................................................... 75
Criar versões para elementos ou modelos............................................................................................76
Criar versões de tabela........................................................................................................................ 76
Comparar duas versões........................................................................................................................77
Exibição de versões de objetos diferentes e objetos obsoletos.................................................................77
Data da consulta e horário PI System Explorer..................................................................................... 77
Mostrar datas e horas específicas........................................................................................................ 78
Contexto de tempo para valores do atributo........................................................................................79
Visualizar dados das séries de tempo...................................................................................................... 80
Tipo de limite...................................................................................................................................... 81
Expressão de filtro...............................................................................................................................81
Estatísticas..........................................................................................................................................82
Ponderado.......................................................................................................................................... 82
Modo de horizonte de evento..............................................................................................................83
Restrições na visualização dos dados da série cronológica...................................................................84
Abreviações de configuração do atributo............................................................................................ 84

Organização dos modelos de ativos no PI AF......................................................... 87

A estrutura dos modelos de ativo do PI AF.............................................................................................. 87
O design das hierarquias de ativos do PI AF.............................................................................................88
Referências do elemento na hierarquia de ativos.................................................................................... 89
Tipos de referência..............................................................................................................................89
Criar uma única referência de elemento.............................................................................................. 91
Criar várias referências de elemento....................................................................................................91
Localizar outras referências no mesmo elemento................................................................................92
Alterar tipos de referência................................................................................................................... 92

iv Guia do Usuário do PI System Explorer

 Conteúdo

Criação de tipos de referência personalizada....................................................................................... 93

Categorização de objetos........................................................................................................................93
Criar novas categorias......................................................................................................................... 94
Atribuir objetos a categorias............................................................................................................... 94

Representação de ativos no PI AF......................................................................... 97

Representação de ativo com templates...................................................................................................97
Estratégia de template........................................................................................................................... 98
Templates de elemento.......................................................................................................................... 98
Atributo padrão.................................................................................................................................. 99
Templates base...................................................................................................................................99
Extensões..........................................................................................................................................100
Criar templates de elemento..............................................................................................................101
Localizar referências de template...................................................................................................... 102
Definir templates para outros objetos............................................................................................... 104
Templates filhos....................................................................................................................................105
Criar referências de template filho..................................................................................................... 105
Representação de ativo com elementos................................................................................................ 106
Criar elementos com base em um template.......................................................................................106
Criar elementos não baseados em um template.................................................................................107
Localizar onde um elemento é usado.................................................................................................108
Exclusão de elementos...................................................................................................................... 108
Redefinição do atributo de valor para as propriedades originais........................................................ 108
Converter elementos em templates de elementos.............................................................................109
Alterar templates de elementos........................................................................................................ 109
Armazenamento de informações específicas de aplicativo.................................................................... 110
Criar propriedades estendidas........................................................................................................... 110

Associação de dados com ativos do PI AF.............................................................111

Templates de atributo........................................................................................................................... 111
Propriedades do atributo................................................................................................................... 111
Características de atributo................................................................................................................. 114
Criar templates de atributo................................................................................................................ 119
Tipos de dados do PI AF.....................................................................................................................120
Definir valores constantes para templates de atributos......................................................................121
Configurar valores para tipos de dados básicos..................................................................................122
Configurar valores para tipos de dados de matriz...............................................................................123
Configurar valores de enumeration set.............................................................................................. 123
Configurar valores para tipos de dados de objeto...............................................................................123
Adicionar extensões de atributo aos elementos baseados em template............................................ 124
Conjuntos de enumerações................................................................................................................... 125
Criar enumeration sets...................................................................................................................... 126
Renumerar valores de enumeração....................................................................................................127

Configuração de referências de dados................................................................. 129

Strings de configuração de atributo no PI System Explorer....................................................................129
Strings de configuração para referências de dados do PI Point...........................................................130
Sintaxe de caminho para referências a outros atributos..................................................................... 133
Parâmetros de substituição em referências de dados............................................................................ 136
Símbolos usados em parâmetros de substituição...............................................................................136
Substituições de nome.......................................................................................................................137
Referências a valores de atributos...................................................................................................... 137
Lista de parâmetros de substituição do PI AF.....................................................................................138
Strings de formato para os parâmetros de substituição de tempo..................................................... 142
Localizar o PI Data Archive padrão.....................................................................................................143
Referências de dados do ponto do PI..................................................................................................... 143
Referência direta do ponto do PI....................................................................................................... 144

Guia do Usuário do PI System Explorer v

Conteúdo

Referências indiretas do ponto do PI................................................................................................. 144

Criar referências de dados do ponto do PI direto a partir dos resultados da pesquisa de tag...............145
Configurar referências de dados do ponto do PI direto ou indireto.....................................................146
Considerações da unidade de medida................................................................................................148
Configuração dos métodos de recuperação para valores do atributo................................................. 148
Atualizações do valor do ponto PI de uma referência de dados.......................................................... 156
Atualizações de valor do atributo das referências de dados da tag do PI............................................ 156
Configurar a criação automática de pontos PI.................................................................................... 158
Editar propriedades do ponto do PI................................................................................................... 159
Visualizar parâmetros de substituição nas referências de dados do ponto PI......................................160
Referências de dados de matriz do ponto do PI..................................................................................... 161
Criar referência de dados da matriz do ponto do PI............................................................................ 161
Referências de dados da fórmula...........................................................................................................162
Operadores de referências de dados da fórmula................................................................................ 162
Funções de referências de dados da fórmula......................................................................................163
Unidades de medida nas referências de dados da fórmula................................................................. 164
Configurar referências de dados de fórmula...................................................................................... 164
Referência de dados do Builder da String...............................................................................................167
Referências de atributo no Builder da String...................................................................................... 167
Implementação de função no String Builder...................................................................................... 168
Criar referências de dados do Builder da string...................................................................................171
Referência de dados em busca por tabela.............................................................................................. 174
Criar tabelas do PI AF.........................................................................................................................174
Criar definições para colunas de tabelas............................................................................................. 177
Preencher tabelas manualmente....................................................................................................... 178
Referências de dados de fora do PI System........................................................................................ 178
Configurar referências de dados em busca por tabela........................................................................ 189
Referências de dados em Builder do URI................................................................................................197
Criar referências de dados do Builder do URI......................................................................................197

Unidades de medida no PI AF............................................................................. 201

Sensibilidade a maiúsculas e minúsculas de abreviações de UDM......................................................... 202
Configuração de abreviações de UDM sensíveis a maiúsculas e minúsculas....................................... 203
Classes base e derivadas........................................................................................................................203
Classes base UDM............................................................................................................................. 204
Classes derivadas de UDM comuns....................................................................................................204
Criar unidades de medida......................................................................................................................204
Cálculo de conversão de UDM com uma fórmula...............................................................................206
Criar classes de UDM.............................................................................................................................206
Calculate conversion values for a UOM................................................................................................. 208

Configuração de segurança no PI AF................................................................... 209

Identidades e mapeamentos PI AF........................................................................................................ 209
Identidades integradas do PI AF............................................................................................................ 211
Hierarquia de segurança........................................................................................................................212
Herança de permissão........................................................................................................................... 213
Direitos de acesso do PI AF.................................................................................................................... 217
Opção Negar permissão........................................................................................................................ 218
Janela Configuração de segurança........................................................................................................ 219
Segurança do PI AF Server.................................................................................................................... 220
Configurar a segurança para um PI AF Server.................................................................................... 221
Segurança do banco de dados PI AF......................................................................................................222
Configurar a segurança para novos bancos de dados do PI AF........................................................... 222
Configurar a segurança para um único banco de dados do PI AF........................................................ 223
Segurança da coleção PI AF.................................................................................................................. 224
Configurar segurança para as coleções.............................................................................................. 225
Segurança do objeto PI AF.................................................................................................................... 226

vi Guia do Usuário do PI System Explorer

 Conteúdo

Configurar segurança para objetos....................................................................................................226

Configurar a segurança de análises e templates de análises............................................................... 227
Configurar segurança do banco de dados de UDM................................................................................ 228
Diferenças do modelo de segurança do PI Data Archive........................................................................ 229

Event frames no PI AF........................................................................................ 231

Estrutura dos event frames................................................................................................................... 232
Vantagens dos event frames................................................................................................................. 232
Exemplos de estruturas de evento......................................................................................................... 233
Event Frames ou Batch?........................................................................................................................ 234
Formas de criar estruturas de evento.....................................................................................................234
Visualização de event frames................................................................................................................ 235
Templates de estrutura de evento......................................................................................................... 236
Elemento referenciado primário........................................................................................................ 237
Referências de dados a atributos no elemento referenciado primário................................................ 237
Referências de dados a atributos em outros elementos..................................................................... 237
Criar templates de estrutura de evento..............................................................................................238
Alterar templates de estrutura de evento.......................................................................................... 241
Criar estruturas de evento..................................................................................................................... 241
Criar atributos em estruturas de evento.............................................................................................243
Captura de valores para estruturas de eventos e transferências............................................................ 244
Capturar valores................................................................................................................................244
Bloquear event frames ou transferências.............................................................................................. 246
Reconhecimento de estruturas de evento............................................................................................. 246
Reconhecer estruturas de evento...................................................................................................... 247
Transferências...................................................................................................................................... 248
Criar transferências........................................................................................................................... 248

Anotações no PI AF............................................................................................ 251

Anotações de elemento.........................................................................................................................251
Adicionar anotações aos elementos.................................................................................................. 252
Anotações de estrutura de evento......................................................................................................... 253
Adicionar anotações à estrutura de evento........................................................................................ 253
Anotações de transferência...................................................................................................................254
Adicionar anotações a transferências................................................................................................ 254

Análises de ativo................................................................................................257
Análises.................................................................................................................................................257
Templates de análise.........................................................................................................................258
Agendamento de análise .................................................................................................................. 259
Atualizações de análises e templates de análise................................................................................ 261
Expressões para análises................................................................................................................... 261
Dados e análises futuros....................................................................................................................264
Análises de expressão........................................................................................................................... 265
Criar um template de análise da expressão........................................................................................265
Criar uma análise de expressão......................................................................................................... 268
Análises de somatório........................................................................................................................... 270
Funções de análise de somatório....................................................................................................... 271
Criar um template de análise de somatório........................................................................................ 271
Criar uma análise de somatório..........................................................................................................274
Análises de geração da estrutura de eventos......................................................................................... 277
Criar um template de análise de geração da estrutura de eventos......................................................279
Crie uma análise de geração da estrutura de eventos.........................................................................281
Condição de gatilho inicial................................................................................................................. 283
Geração de estrutura de evento filho com start triggers múltiplos.....................................................284
Análises SQC........................................................................................................................................ 284
Criar um template de análise SQC..................................................................................................... 285

Guia do Usuário do PI System Explorer vii

Conteúdo

Criar uma análise SQC....................................................................................................................... 287

Reconciliação de estruturas de evento durante a recarga de dados históricos automática.....................289
Gerenciamento de análises em um elemento........................................................................................290
Realizar recarga de dados históricos ou recalcular dados para uma análise........................................292
Gerenciamento de análises em um banco de dados PI AF......................................................................293
Realizar recarga de dados históricos ou recalcular dados para múltiplas análises...............................295
Análises de amostra.............................................................................................................................. 296
Criar uma análise de expressão para estudar o desvio da eficiência................................................... 296
Criar um template para análises de sintetização potentes................................................................. 299
Criar estruturas de evento automaticamente para acompanhar a ineficiência....................................301
Gerenciamento o Serviço de Análise do PI............................................................................................. 303
Exibir estatísticas do serviço de análise.............................................................................................. 303
Exibir ou modificar o serviço de análise.............................................................................................. 303
Configuração do serviço de análise.................................................................................................... 304
Referência de funções de expressão...................................................................................................... 307
Abs.................................................................................................................................................... 307
Acos.................................................................................................................................................. 307
AND.................................................................................................................................................. 308
Ascii.................................................................................................................................................. 308
Asin................................................................................................................................................... 309
Atn.................................................................................................................................................... 309
Atn2.................................................................................................................................................. 310
Avg.................................................................................................................................................... 310
BadVal............................................................................................................................................... 311
Bod....................................................................................................................................................312
Bom...................................................................................................................................................312
Bonm................................................................................................................................................. 313
Ceiling............................................................................................................................................... 314
Char...................................................................................................................................................314
Compare............................................................................................................................................315
Concat............................................................................................................................................... 316
Contains............................................................................................................................................ 316
Convert.............................................................................................................................................. 317
Cos.................................................................................................................................................... 318
Cosh.................................................................................................................................................. 318
Cot.................................................................................................................................................... 319
Coth.................................................................................................................................................. 319
Csc.....................................................................................................................................................319
Csch.................................................................................................................................................. 320
Curve.................................................................................................................................................320
Day....................................................................................................................................................321
DaySec.............................................................................................................................................. 322
DeltaValue........................................................................................................................................ 322
DigState............................................................................................................................................ 323
DigText............................................................................................................................................. 324
E........................................................................................................................................................324
ELSE..................................................................................................................................................325
EventCount....................................................................................................................................... 325
Exp.................................................................................................................................................... 326
FindEq............................................................................................................................................... 327
FindGE...............................................................................................................................................327
FindGT.............................................................................................................................................. 328
FindLE............................................................................................................................................... 329
FindLT............................................................................................................................................... 330
FindNE...............................................................................................................................................331
Float.................................................................................................................................................. 332
Floor.................................................................................................................................................. 332

viii Guia do Usuário do PI System Explorer

 Conteúdo

Format...............................................................................................................................................333
Frac................................................................................................................................................... 334
HasChanged...................................................................................................................................... 334
HasValueChanged............................................................................................................................. 335
Hour.................................................................................................................................................. 335
IF....................................................................................................................................................... 336
InStr.................................................................................................................................................. 336
IN.......................................................................................................................................................337
Int......................................................................................................................................................338
IsSet.................................................................................................................................................. 339
LCase................................................................................................................................................ 339
Left................................................................................................................................................... 340
Len.................................................................................................................................................... 340
Log.................................................................................................................................................... 341
Log10................................................................................................................................................ 341
Logbase............................................................................................................................................ 342
LTrim................................................................................................................................................ 342
Max................................................................................................................................................... 343
Median.............................................................................................................................................. 343
Mid....................................................................................................................................................344
Min.................................................................................................................................................... 345
Minute...............................................................................................................................................346
Mod...................................................................................................................................................346
Month................................................................................................................................................347
NextEvent......................................................................................................................................... 347
NextVal............................................................................................................................................. 348
Noon................................................................................................................................................. 348
NoOutput..........................................................................................................................................349
Normalrnd.........................................................................................................................................349
NOT.................................................................................................................................................. 350
NumOfChanges.................................................................................................................................350
OR..................................................................................................................................................... 351
ParseTime......................................................................................................................................... 351
PctGood............................................................................................................................................ 352
Pi....................................................................................................................................................... 353
Poisson.............................................................................................................................................. 353
Poly................................................................................................................................................... 353
Pow................................................................................................................................................... 354
PrevEvent.......................................................................................................................................... 355
PrevVal.............................................................................................................................................. 355
PStDev.............................................................................................................................................. 356
Rand.................................................................................................................................................. 357
Range................................................................................................................................................ 357
Rate...................................................................................................................................................358
Remainder.........................................................................................................................................359
Right................................................................................................................................................. 360
Round............................................................................................................................................... 360
Roundfrac..........................................................................................................................................361
RTrim................................................................................................................................................ 362
Sec.................................................................................................................................................... 363
Sech.................................................................................................................................................. 363
Second.............................................................................................................................................. 363
SecSinceChange................................................................................................................................364
Sgn....................................................................................................................................................364
Sin..................................................................................................................................................... 365
Sinh................................................................................................................................................... 365
Sqr.................................................................................................................................................... 366

Guia do Usuário do PI System Explorer ix

Conteúdo

StateNo.............................................................................................................................................366
SStDev.............................................................................................................................................. 367
StDev................................................................................................................................................ 368
String................................................................................................................................................ 369
TagAvg.............................................................................................................................................. 370
TagBad.............................................................................................................................................. 371
TagDesc.............................................................................................................................................371
TagEU............................................................................................................................................... 372
TagExDesc.........................................................................................................................................372
TagMax..............................................................................................................................................373
TagMean........................................................................................................................................... 374
TagMin.............................................................................................................................................. 375
TagName...........................................................................................................................................376
TagNum............................................................................................................................................ 376
TagSource..........................................................................................................................................377
TagSpan............................................................................................................................................ 377
TagTot...............................................................................................................................................378
TagType............................................................................................................................................ 379
TagTypVal......................................................................................................................................... 380
TagVal...............................................................................................................................................380
TagZero.............................................................................................................................................381
Tan.................................................................................................................................................... 381
Tanh..................................................................................................................................................382
Text...................................................................................................................................................382
THEN.................................................................................................................................................383
TimeEq.............................................................................................................................................. 383
TimeGE............................................................................................................................................. 384
TimeGT............................................................................................................................................. 385
TimeLE..............................................................................................................................................386
TimeLT.............................................................................................................................................. 387
TimeNE............................................................................................................................................. 388
TimeStamp....................................................................................................................................... 388
Total..................................................................................................................................................389
Trim.................................................................................................................................................. 389
Trunc.................................................................................................................................................390
UCase................................................................................................................................................ 391
Weekday........................................................................................................................................... 391
Year.................................................................................................................................................. 392
Yearday.............................................................................................................................................392
Funções de vapor para expressões de análise........................................................................................ 393
Funções de vapor nas análises de ativos e baseadas em tags............................................................. 394
Intervalos para entradas da função de vapor......................................................................................394
Conversão de unidades de medida para funções de vapor................................................................. 396
Estados de referência das propriedade do vapor................................................................................ 397
Referência das funções de vapor....................................................................................................... 398

Notificações...................................................................................................... 411
Introdução às notificações..................................................................................................................... 411
Notificações e estruturas de evento...................................................................................................... 412
Histórico de notificações....................................................................................................................... 412
Requisitos para notificações.................................................................................................................. 413
Suporte ao cliente para notificações ..................................................................................................... 413
Segurança das notificações................................................................................................................... 414
Segurança para contatos................................................................................................................... 414
Segurança para regras de notificação e templates............................................................................. 415
Criar uma regra de notificação.............................................................................................................. 416
Criar um template de regra de notificação............................................................................................. 417

x Guia do Usuário do PI System Explorer

 Conteúdo

Critérios de gatilho nas regras de notificação.........................................................................................417

Intervalo sem repetição nas regras de notificação............................................................................. 419
Intervalo de reenvio nas regras de notificação................................................................................... 419
Formatos de entrega em regras de notificação..................................................................................... 420
Assinaturas em regras de notificação.................................................................................................... 421
Personalização do conteúdo de assinatura e entrega........................................................................ 422
Configuração de delivery endpoints de notificações..............................................................................422
Configurar um delivery endpoint de e-mail........................................................................................ 423
Configurar um delivery endpoint do serviço da web SOAP ou REST.................................................. 424
Contatos............................................................................................................................................... 425
Gerenciar contatos............................................................................................................................426
Opções para as notificações do canal de entrega de e-mail................................................................430
Opções para o canal de entrega de serviço da web de notificações.................................................... 430
Configuração de regras de notificação para análises ou estruturas de evento........................................ 431
Configurar regras de notificação por meio de análises....................................................................... 431
Configurar regras de notificação para estruturas de evento definidas pelo usuário............................ 435
Configurar escalonamentos para regras de notificação......................................................................438
Gerenciamento das regras de notificação..............................................................................................438
Alterações do PI Notifications 2012....................................................................................................... 439
Migração do PI Notifications 2012.........................................................................................................440
Recursos adicionais............................................................................................................................... 442

Processar modelos no PI AF................................................................................443

O escopo de um modelo do PI AF.......................................................................................................... 443
Diretrizes para modelos PI AF............................................................................................................... 444
Submodelos..........................................................................................................................................444
Tipos de elemento em modelos............................................................................................................ 444
Criar modelos do PI AF.......................................................................................................................... 445
Editar modelos PI AF.............................................................................................................................445
Portas e conexões................................................................................................................................. 446
Criar portas....................................................................................................................................... 446
Criar conexões................................................................................................................................... 447
Camadas............................................................................................................................................... 447
Criar camadas....................................................................................................................................447

Utilitários e plug-ins do PI AF............................................................................. 449

Iniciar o PSE com opções de linha de comando..................................................................................... 449
Parâmetros do AFExplorer................................................................................................................ 449
Utilitário PI AF Diagnostics....................................................................................................................450
Conceder permissões para o utilitário Diagnósticos PI AF.................................................................. 451
Executar o utilitário AFDiag...............................................................................................................452
Parâmetros do utilitário AFDiag........................................................................................................ 452
Implementação da trilha de auditoria................................................................................................ 457
Utilitário AF Update Plug-in Configurations.......................................................................................... 459
Configurar o utilitário PI AF Server........................................................................................................ 460
Parâmetros do utilitário SetPISystem............................................................................................... 460
Capturar a saída de rastreio de eventos do AF SDK............................................................................... 460
Parâmetros do utilitário AFGetTrace................................................................................................. 461
Rastrear as alterações no PI AF com trilha de auditoria......................................................................... 462
Visualizar alterações na janela Trilha de auditoria............................................................................. 462
Visualizar plug-ins instalados................................................................................................................ 464
Registro de plug-in da linha de comando...............................................................................................464
Parâmetros RegPlugIn...................................................................................................................... 466
Criar um arquivo de registro XML.......................................................................................................... 467
Criar um script de registro SQL............................................................................................................. 468
Registrar plug-ins com os scripts SQL gerados...................................................................................... 468
Gerenciamento de fornecedor de plug-in..............................................................................................469

Guia do Usuário do PI System Explorer xi

Conteúdo

Localizar os nomes de provedores confiáveis.................................................................................... 469

Suporte técnico e outros recursos....................................................................... 471

xii Guia do Usuário do PI System Explorer

Introdução ao PI Asset Framework
Com o PI Asset Framework é possível representar ativos e processos como objetos PI AF e
estruturá-los para fornecer valor aos negócios.
O PI System Explorer e o PI Builder são as ferramentas primárias que você usa para criar e
gerenciar objetos PI AF. Ambas as ferramentas incluem suporte para os seguintes recursos:

• Estruturas de eventos
Com as estruturas de evento, é possível capturar eventos de processos importantes e coletar
dados relevantes sobre eles para ajudar a analisar por que eles ocorreram. Consulte Event
frames no PI AF para obter mais informações.

• Análises de ativo
Integradas ao PI System Explorer, as análises de ativos podem ser usadas para criar cálculos
e configurar declarações condicionais envolvendo valores de ativos. Consulte Análises de
ativo para obter mais informações.

• Notificações
Integradas ao PI System Explorer no PI AF 2016 R2, as notificações podem ser usadas para
criar regras para alertar os usuários em tempo real sobre condições anormais no sistema.
Consulte Introdução às notificações para obter mais informações.

Alterações na terminologia
A OSIsoft está revisando sua terminologia para refletir o crescimento do PI System em relação
a sua arquitetura original de servidor único. Na terminologia revisada, PI Data Archive refere-
se ao componente que armazena dados de séries temporais (anteriormente chamado de PI
Server) e PI Server refere-se a PI Data Archive e PI Asset Framework. Este documento usa a
terminologia revisada.

Nesta seção
• Como ativos são representados no PI AF
• PI System Explorer

Como ativos são representados no PI AF

PI Asset Framework (PI AF) permite criar uma representação do equipamento e dos processos
que podem dar um enorme insight aos dados. No PI AF, o equipamento e os processos que você
deseja monitorar são chamados de ativos. A representação do PI AF de todos os ativos e
processos em conjunto é denominada modelo de ativo. O modelo de ativo organiza todos os
equipamentos em uma estrutura que simplifica a localização das informações.
No modelo do ativo PI AF, cada equipamento é representado 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 do ponto PI, 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 que você tenha uma bomba com três dados associados: a pressão (lida
de um ponto PI), a temperatura de entrada e a temperatura de saída. Para modelar isso no PI
AF, é possível criar um elemento PI AF para representar a bomba e criar três atributos para
representar os dados associados.

Guia do Usuário do PI System Explorer 1

Introdução ao PI Asset Framework

A ilustração a seguir mostra como os dados podem parecer no PI AF. Apesar de todos os
valores serem valores do ponto PI, o usuário nunca precisa saber os nomes dos pontos PI.
Todos os dados estão disponíveis diretamente no elemento.

Vídeo
Para obter informações sobre ativos e atributos, assista a este vídeo:
https://www.youtube.com/watch?v=18RgS8Y3JtQ

PI System Explorer
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,
incluindo bancos de dados, elementos e templates do PI AF.

Versões do PI System Explorer

Em computadores com um sistema operacional de 64 bits, uma versão de 32 bits e uma de
64 bits do PI System Explorer ficam disponíveis após a instalação de um cliente do PI AF. No PI
AF 2017, a versão de 32 bits é chamada de versão de legado de 32 bits do PI System Explorer, e
a de 64 bits é chamada simplesmente de PI System Explorer.
A versão de legado de 32 bits está disponível para casos em que é preciso continuar usando a
versão de legado das Notificações (anterior à versão 2016 R2) e seu editor de contatos. Essa
versão do editor de contatos é necessária para trabalhar com os canais de entrega de legado.
Para obter mais informações sobre notificações, consulte Notificações.

Nesta seção
• Componentes da interface de usuário do PI System Explorer
• Sugestões de recursos
• Navegador do PI System Explorer
• Personalizar o navegador
• Opções de personalização do PI System Explorer
• Configuração de exibição da coluna
• Selecionar vários objetos no visualizador
• Duplicação de objeto
• Check-in de alterações do banco de dados
• Atalhos do teclado
• Alterar o idioma
• Caracteres válidos em nomes de objetos PI AF
• Tempo PI

2 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Componentes da interface de usuário do PI System Explorer

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

1. Barra de menus
2. Barra de ferramentas
3. Navegador
4. Navegador
5. Barra de status
6. Paleta
7. Visualizador

Vídeos
Para obter informações sobre o browser e o navegador do PI System Explorer, assista a este
vídeo:
https://www.youtube.com/watch?v=Dtf7xC2N7ak
Para obter informações sobre a paleta e o visualizador do PI System Explorer, assista a este
vídeo:
https://www.youtube.com/watch?v=IXXR88qBv2I

Sugestões de recursos
Com o lançamento do PI AF 2017, agora você pode sugerir os recursos que gostaria que fossem
adicionados ao PI System. Também pode ver as sugestões que outros usuários já enviaram e
votar nas que você aprova. Além disso, pode selecionar uma das seguintes categorias para sua
sugestão:
• Análise e cálculos
• Asset Framework
• Data Archive
• Estruturas de evento
• Geral

Guia do Usuário do PI System Explorer 3

Introdução ao PI Asset Framework

• Ajuda/Documentação/Vídeos
• Instalação
• Notificações
• PI Builder
• Segurança
• Gerenciamento do sistema
Para fornecer feedback, selecione Ajuda > Forneça um feedback e Sign in (Fazer login). Digite
seu feedback no campo Enter your idea (Insira sua ideia), selecione a categoria apropriada e
forneça detalhes adicionais conforme necessário.

PI System Customer Experience Improvement Program

A Opção de feedback da experiência do cliente no menu Ajuda permite que você participe do
programa de telemetria que a OSIsoft usa para coletar dados anônimos de uso, a fim de
melhorar o PI System e priorizar novos recursos. Os dados coletados não incluem dados de
negócio ou lógica, mas podem incluir informações como endereços IP, nomes de host e nomes
de objetos do PI System.
Para participar do programa de telemetria, selecione Sim, eu gostaria de participar
(Recomendado) e clique em OK.

Navegador do PI System Explorer

O conteúdo do navegador do PI System Explorer depende do botão selecionado no navegador.
Os objetos padrão disponíveis no navegador são elementos, estruturas de evento, objetos de
biblioteca, unidades de medida, contatos e gerenciamento (que englobam as análises e regras
de notificação).

Nota:
Se forem instaladas notificações de legado em um computador cliente do PI AF, o MyPI e
as Notificações também pode ser exibidos no navegador.
É possível alternar rapidamente entre os objetos do navegador no PI System Explorer com os
atalhos de teclado a seguir. Observe que são exibidas cores diferentes na parte superior do
navegador e do visualizador para ajudar a distinguir entre os objetos do navegador
selecionados:
Atalho Navegador
CTRL+1

CTRL+2

CTRL+3

4 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Atalho Navegador
CTRL+4

CTRL+7

CTRL+0

Personalizar o navegador
Para aumentar o espaço disponível em sua tela para os objetos no navegador, mude os botões
do navegador para ícones.

Procedimento
1. Clique com o botão direito no navegador e clique em Opções do painel de navegação.
2. Na janela Opções do painel de navegação, desmarque a caixa de seleção ao lado de cada
componente da lista Exibir botão inteiro.
3. Clique em OK. As linhas de rótulos do botão são substituídas por uma única linha de ícones.

4. Mova o cursor sobre um ícone para exibir seu rótulo.

Opções de personalização do PI System Explorer

Você pode personalizar diversos aspectos do PI System Explorer para atender a suas
necessidades em Ferramentas > Opções.

Guia Geral
Use a guia Geral para controlar as opções de exibição de diversos recursos. Você pode
controlar:
• Pressionamento de tecla para abrir as janelas Check-In e Desfazer checkout.
• Aparência da barra de título.
• Tamanho da página para objetos do navegador. Para obter mais informações, consulte
Configurar tamanho de página do navegador.
• Número de consultas retornadas em pesquisas de objeto. Para obter mais informações,
consulte Pesquisar paginação de resultados.
• Aparência da unidade de medida dos atributos. Para obter mais informações, consulte
Mostrar os valores de atributo na unidade de medida de origem.
• Exibição de atributos excluídos. Para obter mais informações, consulte Propriedades do
atributo.

Guia Contexto temporal

Use a guia Contexto temporal para definir o tempo ou o período de tempo que o PI System
Explorer usa para exibir valores de atributos. Para obter mais informações, consulte Configurar
o contexto de tempo para os valores de atributo exibidos.

Guia do Usuário do PI System Explorer 5

Introdução ao PI Asset Framework

Guia Opções do servidor

Use a guia Opções do servidor para definir como o PI System Explorer deve se conectar a um PI
AF coletivo ou a um PI Data Archive coletivo. Para obter mais informações, consulte Gerenciar
as preferências de conexão do PI System Explorer.

Nesta seção
• Mostrar os valores de atributo na unidade de medida de origem
• Alterar a unidade de medida para valores de atributos exibidos

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. Na barra de menus, selecione Ferramentas > Opções.
2. Na guia Geral, selecione Use a unidade de medida de origem da tela do atributo.
3. Clique em Aplicar.
4. Clique em OK para fechar a janela.

Alterar a unidade de medida para valores de atributos exibidos

É possível alterar a unidade de medida (UDM) exibida para um valor de atributo.

Procedimento
1. Na guia Atributos do visualizador Elementos ou Estruturas de evento, clique com o botão
direito no valor para um atributo e clique em Alterar UDM de exibição.
2. Na janela Selecionar UDM de exibição, selecione a nova UDM para o valor na lista UDMs de
exibição.
3. Clique em OK.

Configuração de exibição da coluna

Colunas de propriedade
Sempre que colunas de dados forem exibidas no visualizador ou em uma janela de resultados
de pesquisa, você pode personalizar quais colunas de propriedade deseja exibir. No lado direito
da janela, é possível clicar em e marcar seleções de coluna adicionais ou limpar seleções de
coluna padrão.

Colunas do atributo
No visualizador ou nas janelas de resultados de pesquisa para elementos e estruturas de
evento, é possível também selecionar colunas do atributo e exibi-las como colunas ao lado das
colunas de propriedade padrão. Uma coluna de atributo é identificada pelo caractere |.

6 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Selecionar atributos para exibição como colunas do visualizador

Para coleções de Elementos, Pesquisas de elementos, Pesquisas de estruturas de evento e
Pesquisas de transferência, é possível selecionar atributos para serem exibidos como colunas
no visualizador, além das propriedades padrão.

Procedimento
1. No painel do navegador, escolha uma das seguintes ações:
◦ Para selecionar atributos para coleções de Elementos e Pesquisas de elementos, clique
em Elementos.
◦ Para selecionar atributos para coleções de Pesquisas de estruturas de evento e Pesquisas
de transferência, clique em Estruturas de evento.
2. No navegador, clique na coleção para a qual deseja selecionar atributos.
3. Na parte extrema direita do visualizador, clique em .
4. Clique em Selecionar atributos.
5. Na janela Selecionar atributos, escolha uma das seguintes opções para selecionar os
atributos que você deseja que sejam exibidos no visualizador:
Para... Faça o seguinte...
Adicionar atributos de um template a. Selecione a opção Adicionar atributos do
template.
b. Selecione um template na lista.
Adicionar atributos de um elemento ou estrutura a. Selecione a opção Adicionar atributos de
de evento elemento/estrutura de evento.
Nota: b. Escolha uma das seguintes ações:
Não é possível adicionar atributos de uma ▪ Para pesquisar um elemento ou uma
coleção Pesquisas de transferência estrutura de evento, clique em e
insira os critérios para localizar os
atributos na janela Pesquisa de elemento
ou Pesquisa de estrutura de evento.
▪ Para selecionar um elemento ou uma
estrutura de evento na árvore do
navegador, clique em e selecione na
janela Navegador do elemento ou
Navegador da estrutura de evento.
c. Clique em OK.
Adicionar outros atributos a. No campo Outros, insira nomes de atributos
separados por ponto e vírgula ou clique em
e insira os critérios para localizar
atributos na janela Pesquisa de atributo.
b. Clique em Adicionar.

Os atributos selecionados são exibidos em ordem alfabética na lista à esquerda Atributos ou

Templates de atributos. Para maior conveniência, você pode agrupá-los por categoria ou
template marcando uma das caixas de seleção Agrupar por. É possível também filtrá-los se
necessário com critérios de pesquisa adicionais.
6. Na lista Atributos ou Templates de atributo, selecione os atributos que deseja exibir no
visualizador.

Guia do Usuário do PI System Explorer 7

Introdução ao PI Asset Framework

a. Use teclas de seleção padrão do Windows (como SHIFT+<click> e CTRL+<click>) para

selecionar atributos contínuos e não contínuos na lista, conforme descrito em Selecionar
vários objetos no visualizador.
b. Clique em para mover os itens selecionados ou para mover todos os itens para a
lista Atributos à direita.
7. Opcional. Ajuste a ordem em que os atributos serão exibidos nas colunas do visualizador:
Para... Faça o seguinte...
Mover um atributo para cima na lista Selecione um atributo abaixo da linha superior e
clique em .

Mover um atributo para baixo na lista Selecione um atributo acima da linha inferior e
clique em

Remover um atributo da lista Selecione um atributo e clique em .

Remover todos os atributos selecionados Clique em .

8. Opcional. É possível adicionar atributos adicionais conforme requerido, por exemplo, de

outro template. Repita as etapas de 5 a 7.
9. Clique em OK para concluir a seleção de atributos.
Os atributos selecionados são exibidos como colunas no visualizador.
10. Opcional. É possível controlar quais colunas dos atributos selecionadas são exibidas no
visualizador:
Para... Faça o seguinte...
Remover uma coluna de atributos a. Clique em .
b. Clique em Colunas dos atributos.
c. Limpar o atributo que deseja remover.
Remover todas as colunas do atributos a. Clique em .
b. Desmarque Mostrar colunas dos atributos.

Selecionar vários objetos no visualizador

No visualizador, use combinações padrão do mouse e teclado do Windows a fim de selecionar
mais de um objeto para concluir operações como cópia, exclusão, exportação, check-in e check-
out de itens, bem como alteração de templates.

Procedimento
• Para selecionar um grupo de objetos contíguos 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íguos, 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 na seleção, pressione CTRL e clique em cada objeto.

Resultados
Depois de selecionar os objetos, clique com o botão direito e clique na operação a ser executada
no menu de contexto.

8 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Duplicação de objeto
É 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 tabulação.
A opção Copiar está disponível nos menus de contexto em todo o PI AF. As opções Copiar
caminho e Copiar célula estão disponíveis onde adequadas.
Nota:
Ao arrastar e soltar, a área de trabalho sempre contém as informações do caminho, o que
torna os dados compatíveis com outros aplicativos clientes como o PI ProcessBook.

Copiar
Em qualquer navegador PI AF, usar Copiar em um menu de contexto para colocar o caminho
completo do objeto selecionado na área de transferência:
\\Kaboom\Chocolate Milk Tutorial\ChocolateMilkModel\MixFlow

Em qualquer grade ou lista do visualizador, use Copiar para colocar o conteúdo de cada coluna
exibida na linha selecionada na área de transferência. Se você selecionar várias linhas PI AF,
Copiar coloca várias linhas de dados separadas por uma nova linha. Nas listas de atributos, os
dados copiados incluem strings que correspondem aos ícones de coluna Configuração ( ),
Qualidade ( ), Template ( ) e Oculto ( ), além de outras colunas exibidas:

Nome
Valor
Caminho

Copiar caminho
A opção Copiar caminho coloca todo o caminho de cada objeto selecionado na área de
transferência. Se vários objetos PI AF forem selecionados, Copiar caminho coloca vários
caminhos separados por uma nova linha:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Motor
Amps

Copiar célula
Em qualquer grade ou lista do visualizador contendo várias colunas, como atributos, elementos
referenciados, estruturas de evento filho e assim por diante, a opção Copiar célula coloca o
conteúdo da célula selecionada na área de transferência.

Check-in de alterações do banco de dados

Sempre que você faz uma alteração em um objeto, incluindo sempre que criar um novo objeto,
o PI System Explorer faz check-out desse objeto do banco de dados. As alterações feitas em um
objeto devem ser salvas no banco de dados, embora seja possível aplicar uma alteração em um

Guia do Usuário do PI System Explorer 9

Introdução ao PI Asset Framework

objeto selecionado clicando em na barra de ferramentas e fazendo o check-in de suas

alterações mais tarde.
• 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 > Check-in.
• Na barra de ferramentas, clique no botão Check-in.
• No navegador, clique com o botão direito em um objeto e clique em Check-in para salvar as
alterações no banco de dados apenas para esse objeto.
As duas primeiras opções permitem que as alterações sejam salvas em todos os objetos
modificados. A janela Check-in é aberta e exibe os objetos que foram modificados. É possível
selecionar todos ou alguns objetos para fazer check-in e permitir que outros objetos
continuem com o check-out. Clique em Sessão para selecionar objetos modificados apenas
na sessão atual. Ainda é possível fazer o check-in dos objetos modificados em outras
sessões.

Desfazer check-out
Se você decidir não salvar as alterações, poderá usar a opção Arquivo > Desfazer check-out. Na
janela Desfazer checkout, desmarque os itens na lista dos quais deseja fazer check-in e clique
em Desfazer checkout.

Desfazer check-out para todos os usuários

Ocasionalmente, talvez você não consiga modificar um objeto do PI AF porque o elemento está
com check-out feito para outro usuário. Você vê os seguintes tipos de mensagens que informam
que um objeto está bloqueado por um usuário:
• Nas notificações, quando você tenta parar, renomear, excluir ou alterar uma notificação de
outra forma, a mensagem de erro Notification 'Notification_name' with Unique
ID 'ID' is locked by user Windows_account é exibida.
• Em PI AF, quando você tenta trabalhar com um objeto, a mensagem de erro AF Object
Name 'Object_name' with UniqueID 'ID' is locked by user Windows_account
é exibida.
Para desfazer o bloqueio, um usuário que tem a permissão Admin no objeto configurado para
Permitir pode selecionar Mostrar todos os usuários na janela Desfazer check-out, selecionar
Tudo e clicar em Desfazer check-out. Para obter mais informações, consulte Direitos de acesso
do PI AF.

10 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Vídeos
Para obter informações sobre o mecanismo de check-in/check-out de um objeto do PI AF,
assista a este vídeo:
https://www.youtube.com/watch?v=Pb8ZKxOaTsE
Para obter informações sobre como fazer o check-in de modificações em objetos do PI AF,
assista a este vídeo:
https://www.youtube.com/watch?v=Ky1ICZwwBqY
Para obter informações sobre como desfazer o check-out de objetos do PI AF, assista a este
vídeo:
https://www.youtube.com/watch?v=OPSy_HbvAyY

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 o copia para a
área de transferência.
DELETE Exclui o objeto selecionado.
SHIFT+DELETE Igual a CTRL+X
INSERT Adiciona um novo objeto ao visualizador ou ao
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 da página atual no
visualizador.
ALT+HOME Seleciona a primeira página de objetos no
visualizador.
ALT+END Seleciona a última página de objetos 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.

Guia do Usuário do PI System Explorer 11

Introdução ao PI Asset Framework

Atalho Ação
ALT+ENTER No navegador, exibe as propriedades do objeto
selecionado.
SPACE Pressiona o botão atualmente selecionado.
ou
ENTER

Setas para esquerda, direita, para cima e para Navegam nos objetos do visualizador ou do
baixo navegador.
F2 Edita o objeto selecionado no visualizador. Nos
objetos complexos, exibe a janela de edição do
objeto.
F4 Exibe as opções na caixa de lista selecionada. Nas
listas em camadas, exibe a hierarquia completa de
ou
seleções.
ALT + Seta para cima
ou
ALT + Seta para baixo

CTRL+1 Navega até o navegador Elementos.

CTRL+2 Navega até o navegador Event Frames.
CTRL+3 Navega até o navegador Biblioteca.
CTRL+4 Navega até o navegador Unidade de Medida.
CTRL+5 Navega até o navegador MyPI.
CTRL+6 Navega até o navegador Notificações.
CTRL+7 Navega até o navegador Contatos.
CTRL+0 Navega até o navegador Análises.

Alterar o idioma
Será possível alterar o idioma do PI System Explorer 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 PI System Explorer no mesmo
computador, mas com credenciais de login diferentes, elas poderão usar diferentes recursos de
idiomas, caso estejam disponíveis.

Procedimento
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 Exibir > Configurações de idioma.
3. Na janela Ferramenta de configurações de idioma, selecione o idioma de destino e clique em
OK.
4. Saia e reinicie o PI System Explorer.
O PI System Explorer aparece no idioma especificado.
Nota:
A configuração de idioma é específica da conta, portanto os usuários que fizerem login
em uma conta diferente verão o idioma especificado para essa conta.

12 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Caracteres válidos em nomes de objetos PI AF

PI AF tem as seguintes restrições em nomes de objetos:
• Espaços à esquerda ou direita são removidos dos nomes.
• O comprimento máximo do nome é de 259 caracteres.
• Nomes em branco não são permitidos.
É possível usar os caracteres do teclado padrão, com as seguintes exceções:
Tipo de objeto Caracteres inválidos
Exceto contatos Caracteres de controle mais: * ? ; { } [ ] | \ ` ' "
Contatos Caracteres de controle mais: * ? ; [ ] | \ "

Tempo PI
Pode-se usar uma sintaxe especial, chamada tempo PI, para especificar entradas para
timestamps e intervalos de tempo. O tempo PI usa abreviações específicas, que você combina
para criar expressões de tempo.

Nesta seção
• Abreviações de tempos relativos PI
• Expressões de tempo do PI
• Especificação de timestamp
• Especificação de período de tempo

Abreviações de tempos relativos PI

Ao especificar o tempo PI, é possível usar abreviações específicas que representam unidades de
tempo e tempos de referência.
Abreviaturas de unidade de tempo
Abreviatura Versão completa Versão pluralizada Unidade de tempo correspondente
s second seconds Segundo
m minute minutes Minuto
h hour hours Hora
d day days Dia
mo month months Mês
y year years Ano
w week weeks Semana

Para especificar unidades de tempo, podem-se utilizar a abreviatura, a versão completa ou a

versão pluralizada da unidade de tempo, como s, second, ou seconds. Deve-se incluir um
valor válido a qualquer unidade de tempo. Ao especificar segundos, minutos ou horas, pode-se

Guia do Usuário do PI System Explorer 13

Introdução ao PI Asset Framework

especificar um valor fracionado, como 1.25h. Você não pode especificar valores fracionados
para outras unidades de tempo.
Abreviaturas de hora de referência
Abreviatura Versão completa Tempo de referência correspondente
* Hora atual
t today 00:00:00 (meia-noite) do dia atual
y yesterday 00:00:00 (meia-noite) do dia anterior
sun1 sunday 00:00:00 (meia-moite) do último domingo

jun2 june 00:00:00 (meia-noite) no dia atual em junho do ano atual

dec DD december DD 00:00:00 (meia-noite) no DD dia de dezembro do ano atual
YYYY 00:00:00 (meia-noite) no dia e mês atual no ano de YYYY
M-D ou M/D 00:00:00 (meia-noite) no Dº dia do mês M do ano atual
DD 00:00:00 (meia-noite) no DDº dia do mês atual
1: Use as três primeiras letras como abreviatura para qualquer dia da semana: sun, mon, tue, wed, thu,

fri, ou sat.
2: Use as três primeiras letras como abreviatura para qualquer mês do ano: jan, feb, mar, apr, may,

jun, jul, aug, sep, oct, nov ou dec.

Expressões de tempo do PI
As expressões de tempo do PI podem incluir tempos fixos, abreviaturas de tempo de referência
e deslocamentos de tempo. Um deslocamento de horário indica a direção do deslocamento (+
ou -) e o tempo compensado (uma abreviatura de unidade de tempo com um valor).
Por exemplo, as expressões de tempo do PI podem ter a seguinte estrutura:
Estrutura Exemplo
Somente tempo fixo 24-aug-2012 09:50:00
Somente abreviatura da hora de referência t
Somente deslocamento de horário +3h
Abreviação da hora de referência com t+3h
deslocamento de horário

Inclui, no máximo, um deslocamento de horário em uma expressão; incluir múltiplos

deslocamentos de horário pode levar a resultados inesperados.

Especificação de timestamp
Para especificar entradas para timestamps, é possível inserir expressões de tempo que
contenham:
• Horas fixas
Uma hora fixa sempre representa o mesmo hora, independentemente da hora atual.
Entrada Significado
23-aug-12 15:00:00 15h de 23 de agosto de 2012
25-sep-12 00:00:00 (meia-noite) de 25 de setembro de 2012

• Abreviaturas de hora de referência

14 Guia do Usuário do PI System Explorer

 Introdução ao PI Asset Framework

Uma abreviatura de hora de referência representa uma hora relativa à hora atual.
Entrada Significado
* Hora atual (agora)
3-1 ou 3/1 00:00:00 (meia-noite) de 01 de março do ano atual
2011 00:00:00 (meia-noite) no dia e mês atual no ano de 2011
25 00:00:00 (meia-noite) do dia 25 do mês atual
t 00:00:00 (meia-noite) no dia atual (hoje)
y 00:00:00 (meia-noite) no dia anterior (ontem)
tue 00:00:00 (meia-moite) da última terça-feira

• Abreviações de hora de referência com um deslocamento de tempo

Quando incluído com uma abreviatura de hora de referência, um deslocamento de tempo
adiciona ou subtrai da hora especificada.
Entrada Significado
*-1h Uma hora atrás
t+8h 08:00:00 (08h) hoje
y-8h 16:00:00 (16h) de anteontem
mon+14.5h 14:30:00 (14h30) da última segunda-feira
sat-1m 23:59:00 (23:59) da última sexta-feira

• Deslocamentos de tempo
Quando inseridos sozinhos, os deslocamentos de tempo especificam um tempo relativo a
um tempo de referência implícito. O tempo de referência implícito pode ser a hora atual do
relógio ou outra hora, dependendo de onde a expressão foi inserida.
Entrada Significado
-1d Um dia antes do horário atual
+6h Seis horas depois da hora atual

Especificação de período de tempo

Entradas de período de tempo definem intervalos para coleta ou cálculo de valores durante um
período de tempo. Por exemplo, você pode especificar um intervalo de 60 minutos para
computar uma média de hora em um período de 12 horas. Para especificar as entradas do
período de tempo, insira um valor válido e uma unidade de tempo:
• Valores positivos definem intervalos que começam em uma hora anterior no período e que
terminam em ou antes de uma hora posterior no período.
Hora de início 2:00:00
Hora de término 3:15:00
Intervalo de tempo 30m
Intervalo retornado 2:00:00 a 2:30:00
02:30:00 a 03:00:00

• Valores negativos definem intervalos que terminam em uma hora posterior no período e
que começam em ou depois de um hora anterior no período.
Hora de início 2:00:00
Hora de término 3:15:00

Guia do Usuário do PI System Explorer 15

Introdução ao PI Asset Framework

Intervalo de tempo -30m

Intervalo retornado 2:15:00 a 2:45:00
2:45:00 a 3:15:00

16 Guia do Usuário do PI System Explorer

Conexões de servidor e banco de dados
Após uma instalação do PI AF Client, o administrador precisa configurar um PI AF Server para
uso geral. A configuração inclui as seguintes tarefas:
• Estabelecer conexão com um PI AF Server e configurar um padrão.
• Configurar identidades do PI AF.
• Associar contas de usuário do Windows a uma ou mais identidades do PI AF.
• Selecionar um PI Data Archive padrão, caso nenhum tenha sido selecionado durante a
instalação do PI AF Client.
• Criar (ou importar) bancos de dados do PI AF.
• Especificar as preferências de conexão do PI System Explorer, se coletivos do PI AF
estiverem definidos.
• Configurar permissões de acesso de identidades para o PI AF Client Server e os bancos de
dados. Para obter mais informações, consulte Configuração de segurança no PI AF.

Vídeo
Para obter informações sobre como se conectar a um PI System e pesquisá-lo, assista a este
vídeo:
https://www.youtube.com/watch?v=_n3yLpjMhew

Nesta seção
• Conexões do PI AF Server
• Conexões do PI Data Archive
• Conexões de banco de dados PI AF
• Conexões coletivas do PI AF e PI Data Archive

Conexões do PI AF Server
Um administrador precisa selecionar os servidores PI AF para conexão e estabelecer o padrão.
Além disso, um administrador precisa configurar identidades e mapeamentos PI AF para
servidores PI AF.

Nesta seção
• Conectar a um PI AF Server
• Adicionar um PI AF Server à lista de conexões
• Propriedades do PI AF Server
• Visualizar propriedades gerais do PI AF Server conectado
• Gerenciar identidades
• Gerenciar mappings
• Visualizar contagens de objeto do PI AF Server
• Configurar acesso ao Active Directory dos contatos

Guia do Usuário do PI System Explorer 17

Conexões de servidor e banco de dados

Conectar a um PI AF Server
Use a janela Servidores de revisar as conexões do servidor PI AF e conectar-se a diferentes
servidores, conforme necessário.

Procedimento
1. Na barra de menu do PI System Explorer, escolha Arquivo > Conexões.
Na janela Servidores, você verá uma lista de servidores conhecidos, identificados pelos
seguintes ícones.
Um servidor PI AF desconectado na Tabela de Servidores conhecidos.
Um servidor PI AF conectado.
O servidor PI AF conectado padrão.
Um coletivo desconectado do PI AF.
Um coletivo conectado do PI AF.
Um PI Data Archive na Tabela de Servidores conhecidos.
O PI Data Archive conectado padrão.
Um coletivo desconectado do PI Data Archive.

Um coletivo conectado do PI Data Archive.

Nota:
O ícone e um aviso indicam que o cliente PI AF está conectado a uma versão não
suportada do PI Data Archive, como a versão 3.4.375 ou 3.4.370. O cliente PI AF não
pode se conectar a um servidor PI Data Archive que esteja executando um software
anterior à versão 3.4.370.
2. Para conectar-se a um servidor PI AF, escolha uma das seguintes ações:
Para... Faça o seguinte...
Conectar-se a um servidor PI AF diferente Selecione um servidor na lista e clique em
Conectar.
Conectar-se a um servidor como um usuário a. Clique com o botão direito em um servidor na
diferente (por exemplo, de um computador lista e clique em Conectar como.
compartilhado)
b. Na janela Conectar-se ao PI AF Server server,
insira um nome e senha da conta de usuário
do Windows.
c. Clique em OK.
Conectar-se a um servidor que não seja exibido Clique em Adicionar servidor de ativos. Para
na Tabela de Servidores conhecidos obter mais informações, consulte Adicionar um
PI AF Server à lista de conexões.
Configurar um servidor padrão PI AF Clique com o botão direito em um PI AF Server
conectado na lista e clique em Definir como
Servidor do AF Padrão.
Um ícone é exibido ao lado do servidor que
agora é o padrão.

18 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

Conectar-se a um coletivo a. Clique com o botão direito em um coletivo da

lista.
b. Escolha uma das seguintes ações:
▪ Para conectar-se ao servidor primário do
coletivo, clique em Connect to Primary
(Conectar ao primário).
▪ Para conectar-se a um membro específico
do coletivo, clique em Connect to
Collective Member (Conectar ao membro
do coletivo), conforme descrito em
Alternar para um membro do coletivo
específico.

3. Clique em Fechar.

Adicionar um PI AF Server à lista de conexões

Se o servidor PI AF ao qual você deseja se conectar não for exibido na Tabela de servidores
conhecidos, você pode adicioná-lo na janela Propriedades do PI AF Server.

Procedimento
1. No PI System Explorer, clique em Arquivo > Conexões.
2. Clique em Adicionar servidor de ativos.
3. Na janela Propriedades do PI AF Server, insira as propriedades do servidor PI AF.
4. O campo Nome não precisa corresponder ao nome do host. Depois de se conectar a um
servidor PI AF, você pode alterar o nome do servidor clicando em Renomear e inserindo um
novo nome.
CUIDADO:
Renomear o servidor PI AF causa um impacto em todos os clientes.
5. O campo Conta normalmente não é necessário nas instalações normais e deve ser deixado
em branco.
Por padrão, os clientes do PI AF como o PI System Explorer tenta usar um Nome principal
de serviço (SPN) registrado pelo servidor PI AF para estabelecer uma conexão segura com o
servidor. Se um SPN não puder ser criado pelo servidor PI AF, uma conexão segura pode ser
estabelecida via Microsoft NTLM se o servidor estiver sendo executado sob uma conta do
sistema como Serviço de rede. Em cada caso, o campo Conta não é necessário e deve ser
deixado em branco.
Se o servidor PI AF for executado sob uma conta de domínio, no entanto, e um SPN não for
criado com êxito pelo servidor PI AF ou por um administrador, a conta de domínio do
servidor deve ser especificada para que o cliente do PI AF possa identificar o servidor com
segurança.
6. O valor padrão Tempo 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
Tempo limite.
7. Opcional. Os aliases são nomes alternativos para o servidor PI AF, que os usuários podem
usar para procurar o servidor. Quando configurados, os aliases do servidor PI AF são
armazenados apenas localmente no cliente.
8. Opcional. O link Configurar Active Directory destina-se à configuração da lista de contatos
da notificações. Essa é uma função administrador do sistema PI AF.
9. Clique em Conectar.

Guia do Usuário do PI System Explorer 19

Conexões de servidor e banco de dados

Nota:
Se aparecer uma mensagem de erro dizendo que você não pode se conectar ao
servidor PI AF, será necessário inserir a conta de domínio do servidor no campo
Conta.
10. Depois da conexão a um servidor, você pode clicar em Segurança e configurar a segurança
para o servidor. Para obter mais informações, consulte Hierarquia de segurança.
11. Clique em OK.

Propriedades do PI AF Server
Gerencie a configuração do servidor PI AF atualmente conectado na janela Propriedades do PI
AF Server. As seguintes guias estão disponíveis:
• Geral . Para obter mais informações, consulte Visualizar propriedades gerais do PI AF Server
conectado.
• Plug-ins. Para obter mais informações, consulte Visualizar plug-ins instalados.
• Bibliotecas. Para obter mais informações, consulte Revisar propriedades de bibliotecas
carregadas.
• Identidades. Para obter mais informações, consulte Gerenciar identidades.
• Mapeamentos. Para obter mais informações, consulte Gerenciar mappings.
• Contagens. Para obter mais informações, consulte Visualizar contagens de objeto do PI AF
Server.

Visualizar propriedades gerais do PI AF Server conectado

Na guia Geral da janela Propriedades do PI AF Server, revise e modifique as configurações do PI
AF Server conectado, como:
• Nome do servidor, home do host e ID
• Conta do servidor
• Número da versão do servidor
• Porta do servidor, tempo limite e aliases

Procedimento
1. Clique em na barra de ferramentas do PI System Explorer ou clique em Arquivo >
Propriedades do servidor.
2. Na guia Geral da janela Propriedades do PI AF Server, revise as informações do servidor e
modifique-as conforme necessário.
3. Você também pode escolher uma das ações a seguir.
Para… Faça isto…
Renomear o PI AF Server a. Clique em Renomear.
b. No campo Novo nome da janela Novo nome
do PI AF Server, substitua o nome atual.
c. Clique em OK.
CUIDADO:
Renomear o PI AF Server afeta todos os
clientes do PI AF.

20 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

Inserir um alias a. Clique em .

Configurar acesso ao Active Directory dos
contatos
Visualizar ou modificar permissões de segurança
de identidades de usuário mapeadas
b. No campo Novo nome da janela Novo nome
de alias, digite um nome alternativo que os
usuários podem usar para pesquisar o PI AF
Server. Os aliases são armazenados
localmente no cliente.
Consulte Configurar acesso ao Active Directory
dos contatos.
a. Clique em Segurança.
b. Na janela Configuração de segurança, revise as
permissões das identidades listadas que
foram configuradas para cada componente do
servidor. Você pode adicionar e remover
identidades (bem como criar identidades e
mapeamentos) conforme necessário. Para
obter mais informações, consulte Configurar
a segurança para um PI AF Server.

4. Clique em OK.

Gerenciar identidades
Use a guia Identidades para avaliar as identidades que estão atualmente atribuídas ao servidor
PI AF. Também é possível adicionar, remover e editar as identidades.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Propriedades do PI AF Server, clique na guia Identidades.
3. Revise a lista de identidades em ordem alfabética. Clique em um título de coluna para
alterar a ordem de classificação. As identidades ativadas são indicadas como Verdadeiro,
enquanto as desativadas ficam em cinza e são indicadas como Falso. As identidades
integradas Administrator e Mundo são apenas para leitura.
4. É possível escolher entre as seguintes ações:
Para... Faça o seguinte...
Desativar uma identidade a. Clique duas vezes em uma identidade ativada
na lista.
b. Na janela Propriedades da identidade,
desmarque a caixa de seleção A identidade
está ativada.
c. Clique em OK.
Ativar uma identidade a. Clique duas vezes em uma identidade
desativada na lista.
b. Na janela Propriedades da identidade, marque
a caixa de seleção A identidade está ativada.
c. Clique em OK.

Guia do Usuário do PI System Explorer 21

Conexões de servidor e banco de dados

Criar uma nova identidade a. Clique com o botão direito e selecione Nova
identidade.
b. Na janela Propriedades da identidade, insira
um nome e uma descrição para a identidade.
c. Opcional. Clique na guia Mapeamentos e em
Adicionar. Para obter mais informações,
consulte Adicione um mapeamento a uma
identidade.
Gerenciar as configurações de segurança para a. Clique com o botão direito em um título da
identidades coluna ou abaixo da lista e clique em
Segurança.
b. Na janela Configuração de segurança, é
possível revisar ou modificar permissões
para uma identidade listada e também
adicionar ou remover identidades conforme
necessário. Para obter mais informações,
consulte Configurar a segurança para um PI
AF Server.
Excluir uma identidade a. Clique com o botão direito em uma
identidade na lista e clique em Excluir.
b. Na janela de confirmação Excluir, clique em
Sim.
Renomear uma identidade a. Clique com o botão direito em um identidade
na lista e clique em Renomear.
b. Insira um novo nome de identidade.
c. Clique com o botão direito e clique em Check-
in para aplicar a alteração.

Gerenciar mappings
Use a guia Mapeamentos para avaliar os mapeamentos que estão atualmente configurados no
servidor PI AF. Também é possível adicionar, remover e editar os mapeamentos.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Propriedades do PI AF Server, clique na guia Mapeamentos.
3. Revise a lista de mapeamentos em ordem alfabética. Se necessário, role para a direita para
verificar as identidades e contas do Windows mapeadas.
4. É possível escolher entre as seguintes ações:
Para... Faça o seguinte...
Modificar as propriedades de um mapeamento a. Clique duas vezes em um mapeamento na
lista.
b. Na janela Propriedades do mapeamento, é
possível editar o nome e a descrição,
conforme necessário, bem como selecionar
uma identidade diferente na lista suspensa
Identidade.
c. Clique em OK.
Criar um novo mapeamento Consulte Adicione um mapeamento a uma
identidade.

22 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

Excluir um mapeamento para uma identidade a. Clique com o botão direito em um

mapeamento na lista e clique em Excluir.
b. Na janela de confirmação Excluir, clique em
Sim.
Nota:
Se a sua conta de usuário estiver associada
ao mapeamento que está sendo excluído,
um aviso de que você pode ser bloqueado é
exibido.
Renomear um mapeamento a. Clique com o botão direito em um
mapeamento na lista e clique em Renomear.
b. Insira um novo nome de mapeamento.
c. Clique com o botão direito e clique em Check-
in para aplicar a alteração.
Gerenciar as configurações de segurança para a. Clique com o botão direito em um título da
mapeamentos coluna ou abaixo da lista e clique em
Segurança.
b. Na janela Configuração de segurança, é
possível revisar ou modificar permissões
para uma identidade listada e também
adicionar ou remover identidades conforme
necessário. Para obter mais informações,
consulte Configurar a segurança para um PI
AF Server.

Adicione um mapeamento a uma identidade

Quando você adiciona um mapeamento a uma identidade, precisa especificar a conta do
Windows que será mapeada e o nome do mapeamento.

Antes de Iniciar
O identificador de segurança (SID) para a conta é gerado automaticamente e não pode ser
alterado enquanto o mapeamento estiver sendo criado.

Procedimento
1. No campo Conta da janela Propriedades do mapeamento, insira um dos seguintes tipos de
objetos:
◦ Usuário
◦ Grupo
◦ Incorporar diretor de segurança
◦ Conta de serviço
◦ Nome do computador
Você também pode clicar e inserir os critérios de pesquisa na janela Selecionar usuário,
computador, conta de serviço ou grupo para selecionar o tipo de objeto, localização e nome.
Os locais de pesquisa disponíveis são o computador que hospeda servidor PI AF conectado e
os nós do Active Directory que o usuário pode acessar.

Guia do Usuário do PI System Explorer 23

Conexões de servidor e banco de dados

Nota:
Você também pode inserir um SID diretamente no campo Conta. Quando a entrada é
validada, um identificador de domínio é anexado se esta for uma conta de domínio. Se
a conta for uma conta local na máquina host do PI System, o nome de domínio
totalmente qualificado é pré-anexado.
2. Para validar a sua entrada no campo Conta, pressione Tab ou clique em outro campo.
O campo SID da conta exibe o SID da conta e o campo Nome exibe como padrão o nome da
conta.
3. No campo Nome, modifique o nome da conta padrão, conforme necessário.
4. O texto que você inserir no campo Descrição é exibido na janela Propriedades do PI AF
Server, assim você pode usar esse campo para diferenciar entre os mapeamentos para
qualquer identidade (já que no PI AF um único usuário pode ser mapeado para múltiplas
identidades).
5. Se uma identidade ainda não foi selecionada, selecione a identidade que deseja associar ao
mapeamento na lista suspensa Identidade.
6. Clique em OK.

Visualizar contagens de objeto do PI AF Server

É possível visualizar contagens de objetos para o PI AF Server ao qual o usuário está conectado
no momento, como o número de bancos de dados, elementos, templates de elemento,
estruturas de evento e assim por diante.

Procedimento
1. No PI System Explorer, clique em Arquivo > Propriedades do servidor.
2. Na janela Propriedades do PI AF Server, clique na guia Contagens.

Configurar acesso ao Active Directory dos contatos

Ao usar as notificações com o PI AF Server, talvez seja necessário especificar como acessar o
Microsoft Active Directory para recuperar nomes das listas de contatos do serviço PI
Notifications.
Cada servidor do PI AF 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 servidor PI AF 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 a um banco de dados no servidor PI AF para o qual
deseja configurar o acesso ao Active Directory.
2. Clique em Arquivo > Propriedades do servidor.
3. Na janela Propriedades do PI AF Server, clique no link Configurar acesso ao Active Directory
para contatos.
4. 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 serviço PI Notifications (por exemplo, contoso.com).

24 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

Se esse campo ficar em branco, o domínio no qual o serviço do aplicativo PI AF está

localizado será usado.
5. Na caixa de texto Subpasta de contato do 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
6. Selecione uma opção para Conta de acesso do Active Directory:
◦ Usar a conta que o PI 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 do aplicativo PI AF é executado. Por padrão, o servidor PI AF é instalado usando
uma conta virtual, NT SERVICE\AFService. No entanto, a conta de serviço do servidor
PI AF pode ser alterada. Se a conta de serviço do servidor PI AF 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 do servidor PI AF leia o Active Directory, esta será a opção mais simples.
◦ Usar a conta que o AF Client está executando como
Selecione essa opção para usar as credenciais da conta de usuário na qual é executado o
aplicativo do cliente que está se conectando. Se o serviço do servidor PI AF estiver em
execução em uma conta (uma conta virtual, NT SERVICE\AFService é 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 PI AF SDK estiver usando uma personificação no meio de uma camada, como um
Web Service.
◦ Usar a conta especificada
Essa 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 servidor do PI AF estiverem em domínios
diferentes ou quando as contas nas primeiras duas opções não tiverem 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.
7. 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.
8. Escolha uma configuração para Retornar todas as pessoas.

Guia do Usuário do PI System Explorer 25

Conexões de servidor e banco de dados

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.

Conexões do PI Data Archive

O administrador precisa selecionar um PI Data Archive padrão, no caso de ele não ter sido
selecionado durante a instalação do PI AF Client.

Nesta seção
• Conectar ao PI Data Archive
• Adicionar PI Data Archives a listas do servidor conectadas
• Visualizar status de buffering para PI Data Archives conectados

Conectar ao PI Data Archive

Use a janela Servidores para revisar as conexões do servidor conhecido PI Data Archive e
conectar-se a diferentes servidores, conforme necessário.

Procedimento
1. Clique em Arquivo > Conexões.
Na janela Servidores, você verá uma lista de servidores conhecidos, identificados pelos
seguintes ícones.
Um servidor PI AF desconectado na Tabela de Servidores conhecidos.
Um servidor PI AF conectado.
O servidor PI AF conectado padrão.
Um PI Data Archive na Tabela de Servidores conhecidos.
O PI Data Archive conectado padrão.

Nota:
O ícone de aviso ( ) ao lado de um servidor indica que o PI Data Archive está
executando uma versão não suportada, como a versão 3.4.375 ou 3.4.370. O cliente PI
AF não pode se conectar a um servidor PI Data Archive que esteja executando um
software anterior à versão 3.4.370.
2. Para conectar-se ao PI Data Archive, escolha uma das seguintes ações:
Para... Faça o seguinte...
Conectar-se a um PI Data Archive diferente Selecione um servidor na lista e clique em
Conectar.

26 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

Conectar-se a um servidor como um usuário a. Clique com o botão direito em um servidor na

diferente (por exemplo, de um computador
compartilhado)
Conectar-se a um servidor que não seja exibido
na Tabela de Servidores conhecidos
Configurar um servidor diferente como padrão PI Clique com o botão direito em um servidor na
Data Archive
lista e clique em Conectar como.
b. Na janela Conectar-se ao PI Data Archive
server, insira um nome e senha da conta de
usuário do Windows.
c. Clique em OK.
Clique em Adicionar servidor de dados. Para
obter mais informações, consulte Adicionar PI
Data Archives a listas do servidor conectadas.
lista e clique em Configurar como Data Archive
padrão. Um ícone é exibido ao lado do servidor
que agora é o padrão.

3. Clique em Fechar.

Nesta seção
• Problemas de conexão do PI Data Archive
• Configurar clientes para permitir prompts de login explícitos

Problemas de conexão do PI Data Archive

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 Data Archive, 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 Data Archive.
• Um usuário padrão com uma senha em branco para fazer login no PI Data Archive.
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 Data Archive
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
se Permitir prompt de login estiver configurado. Essa configuração controla o que acontece
quando a autenticação do PI Data Archive falha. Se a configuração Permitir prompt de login
estiver ativada, uma janela será aberta solicitando ao usuário um nome de usuário e uma
senha. Se a configuração estiver desativada, uma mensagem de erro será exibida. A
configuração é específica a cada computador cliente.
• Conexões de usuário padrão não são mais suportadas.
Para resolver as condições de erro, configure os PI mappings para conectar usuários ao PI Data
Archive. Para obter mais informações, consulte o tópico do PI System Management Tools
"Identities, Users, and Groups" in Live Library (https://livelibrary.osisoft.com) (Identidades,
usuários e grupos).

Guia do Usuário do PI System Explorer 27

Conexões de servidor e banco de dados

Mensagens de erro de conexão do PI Data Archive

Mensagem de erro Condições de falha de conexão
Privilégios insuficientes para acessar o PI Data As conexões de usuário padrão estão ativadas no
Archive. PI SDK.
Sem acesso - Objeto seguro
As conexões de usuário padrão ao PI Data Archive
estão ativadas para este cliente, mas não são
suportadas pelo PI AF.

Privilégios insuficientes para acessar o PI Data Conexões de usuário padrão são o único método de
Archive. Métodos de autenticação sem suporte autenticação ativado no PI SDK.
estão ativados.
Sem acesso - Objeto seguro
As conexões de usuário padrão ao PI Data Archive
estão ativadas para este cliente, mas não são
suportadas pelo PI AF.

Privilégios insuficientes para acessar o PI Data As configurações de login explícito não foram
Archive. feitas no registro.
Sem acesso - Objeto seguro
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

Se todos os protocolos configurados falharem, use o utilitário PI SDK para permitir que um
prompt de login seja exibido.

Procedimento
1. Abra PISDKUtility no menu Iniciar do Windows.
2. Clique em Conexões > Opções.
3. Na janela Opções de conexão, marque a caixa de seleção Permitir prompt de login (se todos
os protocolos configurados falharem).
4. Clique em OK.
5. Clique em Arquivo > Sair de PISDKUtility.

Adicionar PI Data Archives a listas do servidor conectadas

Se o PI Data Archive ao qual você deseja se conectar não for exibido atualmente na tabela de
servidores conhecidos, adicione-o à janela Propriedades do PI Data Archive.

Procedimento
1. Clique em Arquivo > Conexões.
2. Na janela Servidores, clique em Adicionar servidor de dados.
3. Na janela Propriedades do PI Data Archive, insira as propriedades conforme necessário.
4. Opcional. Você pode alterar o nome padrão no campo Nome:

28 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

a. Clique em Renomear.
b. No campo Novo nome da janela Novo nome do PI Data Archive, insira um nome para o
novo PI Data Archive. O nome não precisa ser igual ao nome do host.
c. Clique em OK.
5. Insira o nome do host no campo Host. Você pode inserir:
◦ Um nome de domínio totalmente qualificado.
◦ Um nome de servidor.
◦ Um endereço IP. Um endereço IPv6 deve ser colocado entre colchetes [ ].
6. Exceto se o aplicativo em particular exigir uma porta diferente, aceite o valor padrão no
campo Porta.
Nota:
Será possível modificar o nome e a porta do host apenas quando não estiver conectado
no servidor.
7. Os valores padrão para os campos Tempo limite da conexão e Tempo limite de dados são
aceitáveis na maioria dos casos. Caso ocorram tempos limites da conexão ao se conectar ao
PI Data Archive do PI System Explorer, aumente o tempo no campo Tempo limite da
conexão. Caso ocorram erros de tempo limite ao acessar dados do PI Data Archive, aumente
o tempo no campo Tempo limite de dados.
8. Opcional. Insira um nome de alias no campo Aliases.
Os aliases são nomes alternativos que podem ser usados para o PI Data Archive. Os aliases
do PI Data Archive estão armazenados localmente somente no cliente.
9. Clique em Conectar para conectar-se ao PI Data Archive.
Nota:
Os campos ID, Fuso horário e Versão não são editáveis. ID é o PI Data ArchiveID, Fuso
horárioPI Data Archive é o fuso horário local e Versão é a versão do PI Data Archive.
10. Clique em OK.

Visualizar status de buffering para PI Data Archives conectados

Se o PI Buffer Subsystem 4.3 ou posterior estiver instalado e em execução, você poderá
visualizar o status do buffer de um PI Data Archive conectado.

Procedimento
1. Clique em Arquivo > Conexões.
Na janela Servidores, cada servidor PI Data Archive para o qual uma conexão é configurada
exibe um status de buffering na coluna Status de buffer.
Nota:
O PI Buffer Subsystem versão 3.4.380 e anteriores exibem o status Desconhecido.
2. Para visualizar mais detalhes e gerenciar o buffering para um PI Data Archive específico,
clique em Buffering Manager para abrir a ferramenta Buffering Manager.
Nota:
Você também pode abrir o Gerenciador de armazenamento em buffer a partir do PI
System Explorer, no menu Ferramentas.

Guia do Usuário do PI System Explorer 29

Conexões de servidor e banco de dados

Conexões de banco de dados PI AF

O PI AF armazena objetos da estrutura de ativos (elementos, templates etc.) nos bancos de
dados PI AF. É possível ter vários bancos de dados no PI AF, mas somente um pode ser
conectado por vez. Normalmente, você trabalha com os bancos de dados do PI AF no PI System
Explorer ou no PI Builder. Ao iniciar o PI System Explorer, ele se conecta 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 pelos clientes do PI AF, como o PI Web API,
conforme interagem com o PI AF. Não use esse banco de dados em dados próprios do
aplicativo.

Vídeos
Para obter informações sobre como criar bancos de dados do PI AF, assista a este vídeo:
https://www.youtube.com/watch?v=P7Zopif-j-c
Para obter informações sobre como trabalhar com vários bancos de dados do PI AF, assista a
este vídeo:
https://www.youtube.com/watch?v=CN0R7cW3BUc
Para obter informações sobre o banco de dados de configuração, assista a este vídeo:
https://www.youtube.com/watch?v=bfTnAeSinmo

Nesta seção
• Criar bancos de dados PI AF
• Visualizar ou editar propriedades de bancos de dados PI AF
• Conectar a um banco de dados em um PI AF Server diferente
• Configurar o banco de dados padrão
• Renomear bancos de dados
• Pesquisar bancos de dados PI AF
• Atualizar a lista de bancos de dados
• Exclusão do banco de dados

Criar bancos de dados PI AF

É possível criar um banco de dados PI AF vazio sem nenhum conteúdo pré-configurado ou
carregar uma biblioteca que foi salva em um servidor PI AF conectado.

Procedimento
1. Escolha uma das seguintes ações:
◦ Pressione Ctrl+O.
◦ Na barra de ferramentas do PI System Explorer, clique em .
◦ Clique em Arquivo > Banco de dados.
2. Na lista suspensa Servidor de ativos na janela Selecionar banco de dados, selecione um
servidor conectado no qual você tenha direitos de acesso de administrador para criar um

30 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

banco de dados. Como alternativa, clique em e selecione um servidor da janela PI AF

Servers.
3. Clique em Novo banco de dados.
4. Na janela Propriedades do banco de dados, insira um nome exclusivo no campo Nome.
5. Opcional. Insira uma descrição no campo Descrição.
6. Escolha uma das seguintes ações:
Para... Faça o seguinte...
Criar um novo banco de dados sem conteúdo Deixe o campo Carregar biblioteca (se exibido)
configurado configurado como <None>.
Criar um banco de dados com objetos Selecione uma biblioteca na lista suspensa
configurados a partir de uma biblioteca salva Carregar biblioteca. Para obter mais informações,
consulte Bibliotecas salvas do PI AF.
Criar propriedades estendidas Consulte Armazenamento de informações
específicas de aplicativo.
Configurar permissões de acesso para o novo Consulte Configurar a segurança para um único
banco de dados banco de dados do PI AF.

7. Clique em OK. O novo banco de dados é adicionado à lista Banco de dados na janela
Selecionar banco de dados.

Visualizar ou editar propriedades de bancos de dados PI AF

Use a janela Propriedades do banco de dados para verificar quantos objetos existem em cada
tipo de coleção em um banco de dados PI AF e também para revisar ou adicionar propriedades
estendidas e permissões de acesso.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Selecionar banco de dados, clique com o botão direito em um banco de dados e
clique em Propriedades.
3. Na janela Propriedades do banco de dados, escolha uma das seguintes ações:
Para... Faça o seguinte...
Revisar o número de objetos no banco de dados Clique na guia Contagens.
Revisar ou modificar o nome e a descrição do Na guia Geral, faça alterações conforme
banco de dados necessário nos campos Nome e Descrição.
Revisar ou modificar propriedades estendidas a. Na guia Geral, clique em Propriedades
estendidas.
b. Na janela Propriedades estendidas, faça
alterações conforme necessário nos campos
Nome e Valor. Para criar uma nova
propriedade, clique em Nova propriedade
estendida. Para obter mais informações,
consulte Criar propriedades estendidas.
Revisar ou modificar a segurança do banco de a. Na guia Geral, clique em Segurança.
dados
b. Na janela Configuração de segurança, faça
alterações conforme necessário. Para obter
mais informações, consulte Configurar a
segurança para um único banco de dados do
PI AF.

Guia do Usuário do PI System Explorer 31

Conexões de servidor e banco de dados
Revisar as propriedades do servidor conectado
Carregar uma biblioteca salva
4. Clique em OK.
Conectar a um banco de dados em um PI AF Server diferente
Use a janela PI AF Servers para localizar e se conectar ao servidor PI AF que contém o banco de
dados com o qual você deseja trabalhar.
Procedimento
1. Na janela Selecionar banco de dados, clique em
2. Na janela PI AF Servers, revise a lista de servidores. Observe que o banco de dados padrão
em cada servidor conectado também é exibido.
3. Escolha uma das seguintes ações.
Para...
Selecionar o servidor em que o banco de dados
está localizado
Verificar as propriedades de um servidor
Conectar-se a um servidor
Conectar-se a um servidor como um usuário
diferente (por exemplo, de um computador
compartilhado)
Revisar as permissões de acesso para um
servidor conectado
32 Guia do Usuário do PI System Explorer
a. Na guia Geral, clique em .
b. Na janela Propriedades do PI AF Server, revise
as propriedades na guia Geral, conforme
descrito em Visualizar propriedades gerais
do PI AF Server conectado.
a. Na guia Geral, selecione uma biblioteca salva
na lista Carregar biblioteca. Para obter mais
informações sobre bibliotecas salvas,
consulte Bibliotecas salvas do PI AF.
b. Clique em Aplicar.
.
Faça o seguinte...
Clique duas vezes em um servidor conectado
( ). A janela PI AF Servers fecha e o servidor
selecionado é exibido no campo Servidor de
ativos.
Selecione um servidor e clique em Propriedades.
Clique com o botão direito em um servidor que
não esteja conectado ( ) e clique em Conectar.
a. Clique com o botão direito em um servidor
que não esteja conectado e clique em
Conectar como.
b. Na janela Conectar-se ao PI AF Server server,
insira um nome e senha da conta de usuário
do Windows.
c. Clique em OK.
a. Clique com o botão direito em um servidor
conectado e clique em Segurança.
b. Na janela Configuração de segurança,
verifique as configurações para as
identidades listadas, conforme necessário.
Nota:
Se você tiver privilégios administrativos no
servidor, também pode modificar a
configuração de segurança. Consulte
Configurar a segurança para novos bancos
de dados do PI AF.
 Conexões de servidor e 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 PI System Explorer foi fechado pela última vez.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Selecionar banco de dados, clique com o botão direito em um banco de dados e
clique em Configurar como banco de dados padrão. Um ícone de visto ( ) é exibido sobre o
ícone do banco de dados que agora é o padrão.
3. Clique em OK.

Renomear bancos de dados

É possível alterar o nome de um banco de dados PI AF conforme necessário.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Selecionar banco de dados, clique com o botão direito em um banco de dados e
clique em Renomear.
3. Insira um nome válido para o banco de dados. Para regras sobre nomes de objetos, consulte
Caracteres válidos em nomes de objetos PI AF.
4. Clique em OK.

Pesquisar bancos de dados PI AF

Para localizar um banco de dados PI AF específico em um servidor PI AF selecionado, use o
recurso Pesquisar.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Selecionar banco de dados, comece digitando o nome de um banco de dados no
campo Bancos 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. Selecione 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

Quando outros usuários adicionam bancos de dados ao servidor PI AF, esses bancos de dados
podem não ser exibidos até a atualização ser feita.

Guia do Usuário do PI System Explorer 33

Conexões de servidor e banco de dados

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
2. Na janela Selecionar banco de dados, clique com o botão direito na lista de bancos de dados e
clique em Atualizar.

Exclusão do banco de dados

Quando você exclui um banco de dados, todas as informações contidas nesse banco de dados
são removidas. Antes de excluir um banco de dados, portanto, verifique se você selecionou o
banco de dados que deseja excluir.
CUIDADO:
Ela não pode ser desfeita. No entanto, é possível recuperar os dados restaurando o último
backup do SQL Server.

Conexões coletivas do PI AF e PI Data Archive

Um administrador precisa configurar as preferências de conexão se um coletivo do PI AF ou PI
Data Archive está sendo criado.

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 ao
coletivo PI AF ou PI Data Archive, se os prompts de login são permitidos e se deseja que os
servidores sejam adicionados à Tabela de servidores conhecidos.

Procedimento
1. No PI System Explorer, selecione Ferramentas > Opções > Opções de servidor.
2. Na seção Configurações de conexão do PI AF Server no PI System Explorer, defina como o PI
System Explorer deve se conectar ao servidor PI AF:
Configuração Descrição
Preferência de conexão Use essa preferência para influenciar a seleção de um membro do
coletivo quando uma conexão é feita a um coletivo do PI AF.
◦ Preferir primário
O PI System Explorer tenta 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 são usadas
para influenciar na seleção da conexão do servidor. Esta é a
configuração padrão.
◦ Exigir primário
O PI System 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 System Explorer pode se conectar a qualquer membro
disponível no coletivo e usa as configurações de prioridade
individual do membro coletivo para influenciar a seleção da
conexão do servidor.

34 Guia do Usuário do PI System Explorer


Configuração
Comportamento de resolução
do nome do servidor
Permitir prompt de login
3. Na seção Configurações de conexão do PI Data Archive no PI System Explorer, defina como
o PI System Explorer deve se conectar ao PI Data Archive:
Configuração
Preferência de conexão
Conexões de servidor e banco de dados
Descrição
Use essa preferência para informar ao PI System Explorer qual
ação deve ser executada quando ele tentar se comunicar com um
ou mais servidores PI AF que não estão na Tabela de servidores
conhecidos.
◦ Adicionar automaticamente
Adiciona um servidor automaticamente à Tabela de
servidores conhecidos se o nome do computador for válido e
o PI System Explorer puder localizar o nome de computador
do servidor na rede.
◦ Adicionar automaticamente se resolúvel
Adiciona um servidor à Tabela de servidores conhecidos
apenas quando o nome do servidor é resolvido com sucesso
por um servidor DNS.
◦ Não adicionar automaticamente
Não faz nenhuma tentativa de localizar um servidor, se não
puder ser localizado no coletivo existente.
Selecione essa opção para que o prompt de login apareça quando
uma conexão com o servidor falhar devido a uma exceção de
segurança..
Descrição
Essa preferência é usada para influenciar a seleção de um membro
do coletivo quando uma conexão é feita a um coletivo do PI Data
Archive.
◦ Preferir primário
O PI System Explorer tenta 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 são usadas
para influenciar na seleção da conexão do servidor. Esta é a
configuração padrão.
◦ Exigir primário
O PI System 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 System Explorer pode se conectar a qualquer membro
disponível no coletivo e usa as configurações de prioridade
individual do membro coletivo para influenciar a seleção da
conexão do servidor.
Guia do Usuário do PI System Explorer 35
Conexões de servidor e banco de dados

Configuração
Comportamento de resolução
do nome do servidor
Descrição
Use essa preferência para informar ao PI System Explorer qual
ação deve ser executada quando ele tentar se comunicar com um
ou mais servidores PI Data Archive que não estão na Tabela de
servidores conhecidos.
◦ Adicionar automaticamente
Adiciona um servidor automaticamente à Tabela de
servidores conhecidos se o nome do computador for válido e
o PI System Explorer puder localizar o nome de computador
do servidor na rede.
◦ Adicionar automaticamente se resolúvel
Adiciona um servidor à Tabela de servidores conhecidos
apenas quando o nome do servidor é resolvido com sucesso
por um servidor DNS.
◦ Não adicionar automaticamente
Não faz nenhuma tentativa de localizar um servidor, se não
puder ser localizado no coletivo existente.

4. Em Protocolos na seção Configurações de conexão do PI Data Archive, defina os protocolos

de autenticação e a ordem em que eles são usados quando houver tentativas de conexão a
servidores conhecidos.
O PI System Explorer tenta se conectar usando o primeiro protocolo listado. Se a primeira
tentativa falhar, ele continua tentando se conectar usando outro protocolo na lista (se
selecionado). Se as tentativas usando todos os protocolos falharem e Permitir prompt de
logon estiver selecionado, a caixa de diálogo PI Data ArchiveLogin do é exibida.

a. Para estabelecer a ordem usada ao se conectar a um servidor, use o botão de setas para
mover protocolos.
b. Selecione a opção Permitir prompt de login se deseja que o prompt de login seja exibido
quando uma conexão com o servidor falhar devido a uma exceção de segurança.
5. Clique em OK.

Alternar membros do coletivo

Quando você estabelece conexão com um coletivo do PI AF, o PI AF conecta-se
automaticamente ao membro do coletivo com a mais alta prioridade (menor número). É
possível alternar a conexão com 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, clique em Arquivo > Conexões.
2. Clique com o botão direito no coletivo e clique em Alternar membro do coletivo.

Alternar para um membro do coletivo específico

Quando você estabelece conexão com um coletivo do PI AF, você está automaticamente
conectado ao membro do coletivo com a mais alta prioridade (menor número). É possível
trocar para um membro específico do coletivo.

Procedimento
1. No PI System Explorer, selecione Arquivo > Conexões.
2. Clique com o botão direito no coletivo e clique em Conectar ao membro do coletivo.

36 Guia do Usuário do PI System Explorer

 Conexões de servidor e banco de dados

3. Na janela Escolher membro do coletivo, selecione o membro do coletivo na lista Membro do

coletivo ao qual deseja se conectar.
4. Clique em OK. Agora, o usuário está conectado ao membro do coletivo selecionado.

Guia do Usuário do PI System Explorer 37

Conexões de servidor e banco de dados

38 Guia do Usuário do PI System Explorer

Importação e exportação de banco de dados
É possível exportar um banco de dados do PI System Explorer em XML e restaurá-lo a partir
desse 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, conforme descrito em Salvar bancos de dados como biblioteca.

Vídeos
Para obter informações sobre como importar e exportar bancos de dados com o PI System
Explorer, assista a este vídeo:
https://www.youtube.com/watch?v=ClGTy_lkoTg
Para obter informações sobre como importar e exportar bancos de dados com utilitários de
importação e exportação, assista a este vídeo:
https://www.youtube.com/watch?v=zc5pcH1XvMo

Nesta seção
• Exportar um banco de dados para XML
• Restaurar bancos de dados de arquivos XML exportados
• Exportação de objetos de biblioteca para outro banco de dados
• Utilitário AFExport
• Utilitário AFImport

Exportar um banco de dados para XML

Este procedimento arquiva bancos de dados PI 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. Veja
Utilitário AFExport.

Procedimento
1. Clique em Arquivo > Exportar arquivo.
2. Na janela Exportar para arquivo, 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
• Todos os objetos referenciados
• Formato de arquivo para exportação e restauração

Guia do Usuário do PI System Explorer 39

Importação e exportação de banco de dados
Opções de exportação XML
A janela Exportar para arquivo contém as opções de exportação a seguir.
Opção de exportação
Incluir todos os objetos
referenciados
Incluir configurações de
segurança
XML simples
Simplificar strings de
configuração
Incluir valores padrão
Incluir IDs exclusivos
Somente objetos da biblioteca
Incluir estruturas de evento,
transferências e casos
Todos os objetos referenciados
A tabela a seguir lista os objetos que são exportados quando você seleciona Incluir todos os
objetos referenciados.
Tipo de objeto XML
AFAnalysis
40 Guia do Usuário do PI System Explorer
Resultado
Faz com que as referências dependentes sejam exportadas,
conforme detalhado na tabela Todos os objetos referenciados. Use
essa opção para facilitar a movimentação de objetos entre diferentes
bancos de dados do PI AF.
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.
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 atributo, elementos e estruturas de
eventos.
Remove identificadores do PI Data Archive e de tags das strings de
configuração para referências do ponto PI. Além disso, os
parâmetros de substituição serão resolvidos.
Nota:
Essa opção desacelera o processo de exportação porque exige
a avaliação das strings de configuração salvas.
Inclui os valores padrão atribuídos aos objetos. 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.
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.
Desativa as opções de estruturas de evento, transferências e casos.
Exporta estrutura de evento, transferências e casos.
Referência incluída
AFAnalysisCategories referenciado
AFAnalysisTemplate em Template
AFElementTemplate em CaseTemplate
AFElement em Target
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
 Importação e exportação de banco de dados

Tipo de objeto XML Referência incluída

AFAnalysisTemplate AFAnalysisCategories referenciado
AFElementTemplate em CaseTemplate
AFElement em Target
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFAttribute AFEnumerationSets referenciado em ValueTypeQualifier quando
não do template
AFAttributeTemplate Referenciado AFEnumerationSets em ValueTypeQualifier
AFCase AFElementCategories referenciado
AFEnumerationSets referenciado em atributos sem templates
Todos os filhos AFElements
Todos AFConnections (não apenas aqueles adicionados ou removidos)
AFContact AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFDatabase UOMDatabase
AFContacts referenciado
AFNotificationContactTemplates referenciado
AFSecurityIdentities (se Incluir configurações de segurança também
for selecionada)
AFElement e AFModel AFElementTemplate em Template
AFElementCategories referenciado
AFEnumerationSets referenciado em atributos sem templates
AFReferenceTypes para filhos referenciados
Mesmo que acima para todos os elementos filhos
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFElementTemplate Base AFElementTemplates
AFElementTemplates referenciado em
AFPort.AllowedElementTemplate
AFReferenceTypes que referencia especificamente este template
AFElementCategories referenciado
AFEnumerationSets referenciado em templates de atributos
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFEnumerationSet AllReferences adiciona AFSecurityIdentities de
SecurityAccessControl (se Incluir configurações de segurança
também for selecionada)
AFEventFrame AFElementTemplate em Template
AFElementCategories referenciado
AFEnumerationSets referenciado em atributos sem templates
AFReferenceType dos pais
AFElements referenciado
Mesmo que acima para todos as estruturas de evento filho
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)

Guia do Usuário do PI System Explorer 41

Importação e exportação de banco de dados

Tipo de objeto XML Referência incluída

AFModelAnalysis AFAnalysisCategories referenciado
AFElementTemplate em Template
AFElementTemplate em CaseTemplate
AFElement em Target
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFNotificationTemplate AFNotificationContacts
AFAnalysisTemplate
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFNotification AFNotificationTemplate em Template
AFNotificationContacts
AFAnalysis
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFNotificationContact AFNotificationContactTemplate
Filho AFNoticationContacts
AFContact referenciado
AFNotificationContactTemplate Filho AFNotificationContactTemplates
AFContacts referenciado
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFReferenceType AFReferenceTypeCategories referenciado
AFElementTemplates de AllowedParentElementTemplate e
AllowedChildElementTemplate
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFSecurityIndentity AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFSecurityMapping AFSecurityIdentity mapeado para
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFTable AFTableConnection
AFTableCategories referenciado
AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFTableConnection AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)
AFTransfer AFElementTemplate em Template
AFElementCategories referenciado
AFEnumerationSets referenciado em atributos sem templates
AFElements referenciado em Source e Destination
UOMDatabase AFSecurityIdentities de SecurityAccessControl (se Incluir
configurações de segurança também for selecionada)

42 Guia do Usuário do PI System Explorer

 Importação e exportação de banco de dados

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 bancos de dados de arquivos XML exportados

É possível restaurar um banco de dados que foi exportado para XML importando objetos do
arquivo XML.
Também é possível importar objetos PI AF de um utilitário de linha de comando. Consulte
Utilitário AFImport.

Procedimento
1. Clique em Arquivo > Importar do arquivo.
2. Na janela Importar do arquivo, selecione o arquivo XML que contém os dados e selecione as
opções apropriadas.
Opção Importar Descrição
Permitir criação Permite a criação de novos objetos. Se você
deseja atualizar os itens existentes, desmarque
esta opção para evitar a criação acidental de
novos objetos.
Permitir atualização Permite que os objetos existentes sejam
atualizados. Se deseja apenas adicionar novos
itens, desmarque esta opção para evitar que os
objetos existentes sejam acidentalmente
substituídos.
Check-in automático Permite que a operação de importação faça
automaticamente o check-in de objetos à medida
que a importação continua. Isso minimiza os
requisitos máximos de memória para a operação.
Use essa opção ao importar grande número de
objetos.
Criar ou atualizar pontos PI Faz com que os atributos com uma configuração
de ponto PI especificada no arquivo XML sejam
atualizados se já existirem ou sejam 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.

Guia do Usuário do PI System Explorer 43

Importação e exportação de banco de dados

Nota:
O ponto PI 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.

Exportação de 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
• Bibliotecas salvas do PI AF
• Salvar bancos de dados como biblioteca
• Carregar bibliotecas de banco de dados
• Revisar propriedades de bibliotecas carregadas

Bibliotecas salvas do PI AF
A biblioteca salva 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, bem como banco de dados de unidades de medida, que sempre está incluído. Também
existe a opção de incluir outros objetos, como elementos e notificações.
Nota:
Bibliotecas são armazenadas nos arquivos XML no PI AF banco de dados do SQL Server
(PIFD), onde são facilmente acessadas por outros usuários. Por outro lado, a opção
Exportar para arquivo permite que um banco de dados completo de objetos, como um
arquivo XML, seja exportado para o computador ou rede. O arquivo exportado pode ser
importado por completo para um servidor diferente.

Salvar bancos de dados como biblioteca

Objetos de banco de dados são salvos como uma biblioteca quando se deseja tornar esse
objetos disponíveis para importação para um banco de dados diferente no servidor PI AF.

Procedimento
1. Clique em Arquivo > Salvar como biblioteca.
2. Na janela Salvar banco de dados como biblioteca, insira um nome no campo Nome de
biblioteca. O nome de biblioteca não precisa ser exclusivo caso se planeje sobrescrever uma
biblioteca existente.
3. Opcional. Insira uma descrição do conteúdo da biblioteca no campo Descrição.
4. Para substituir uma biblioteca existente, marque a caixa de seleção Substituir biblioteca
existente sem solicitação.
5. Para incluir objetos como elementos e notificações na biblioteca, marque a caixa de seleção
Incluir objetos fora da biblioteca.
6. Clique em OK.

44 Guia do Usuário do PI System Explorer

 Importação e exportação de banco de dados

Carregar bibliotecas de banco de dados

Uma biblioteca de banco de dados é carregada de um conjunto de bibliotecas que foram
anteriormente salvas no banco de dados PI AF.

Procedimento
1. Clique em .
2. Na janela Selecionar Banco de dados, selecione o banco de dados no qual deseja carregar
uma biblioteca e clique em OK.
3. Clique em Arquivo > Carregar biblioteca.
4. Na janela Carregar biblioteca no banco de dados, selecione uma biblioteca da lista e clique em
OK.

Resultados
Os objetos na biblioteca carregada preenchem o banco de dados atual. Para confirmar quantos
objetos são carregados, visualize a guia Contagem na janela Propriedades do banco de dados
conforme descrito em Visualizar ou editar propriedades de bancos de dados PI AF.

Revisar propriedades de bibliotecas carregadas

Visualize as propriedades das bibliotecas que foram carregadas no servidor PI AF na janela
Propriedades do PI AF Server. É possível alterar o nome e a descrição de uma biblioteca.

Procedimento
1. Clique em Arquivo > Propriedades do servidor.
2. Na janela Propriedades do PI AF Server, clique na guia Bibliotecas.
As bibliotecas instaladas atualmente são listadas.
3. Clique com o botão direito na biblioteca que deseja revisar e clique em Propriedades.
4. Opcional. Na janela Propriedades da biblioteca, é possível alterar o nome e a descrição da
biblioteca conforme necessário.
5. Clique em OK.

Utilitário AFExport
O utilitário AFExport é um aplicativo de linha de comando que pode ser usado para arquivar
bancos de dados PI 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 PI AF. É possível também exportar coleções de objetos doPI AF
do PI System Explorer. Consulte Exportar um banco de dados para XML.
O utilitário AFExport.exe está localizado na pasta \PIPC\AF.
Para executar o utilitário PI AF Export, abra uma janela de comando e navegue até a pasta PIPC
\AF. Use a seguinte sintaxe: AFExport.exe e escolha os parâmetros indicados no Parâmetros
do utilitário AFExport. Para exibir todos os parâmetros, digite:
AFExport /?

Nesta seção
• Diretrizes para exportar coleções

Guia do Usuário do PI System Explorer 45

Importação e exportação de banco de dados

• Parâmetros do utilitário AFExport

• Caminhos de exportação de amostra

Diretrizes para exportar coleções

Siga estas diretrizes enquanto você se prepara para exportar uma coleção:
• Especifique as coleções pelo nome de SDK PI AF delas seguido de "[ ]".
• 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 esse local no
caminho será presumida.
• A coleção filho padrão de um servidor PI AF é Databases.
• A coleção filho padrão de um banco de dados é Elements.
• A coleção filho padrão de um elemento é Elements.
• A coleção filho padrão do banco de dados de UDM é UOM.
• Uma barra vertical (|) indica um atributo ou uma coleção de templates de atributos.

Parâmetros do utilitário AFExport

O utilitário AFExport suporta os seguintes parâmetros.
Parâmetro Forma curta Descrição
Path Caminho para o objeto que você deseja
exportar. Normalmente, no formato: \
Detalhes e exemplos adicionais seguem
\afserver\database. Use "." para
esta tabela.
exportar o banco de dados padrão.
Consulte Caminhos de exportação de
amostra.
/File:string /F Especifique um arquivo de saída. Se não
especificado, a saída será enviada para o
console.
/StartTime:string /T Especifique uma hora de início para que
estruturas de evento, transferências e
casos sejam exportados; isso ocorre
entre as horas de início e término
especificadas.
/EndTime:string /E Especifique um horário de término ao
exportar estruturas de evento,
transferências e casos.
/AllReferences[-] /A Exporte qualquer objeto referenciado de
um objeto especificado do PI AF. Este
parâmetro não pode ser usado com o
parâmetro No References.
/NoReferences[-] /N Não exporte nenhum objeto
referenciado, incluindo objetos filhos.
Este parâmetro não pode ser usado com
o parâmetro All References.

46 Guia do Usuário do PI System Explorer

 Importação e exportação de banco de dados

Parâmetro Forma curta Descrição

/DefaultValues[-] /D Quando este parâmetro não for
especificado, as propriedades
configuradas para os valores padrão não
serã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.
/Library[-] /L Exporte apenas os objetos de biblioteca
de um banco de dados. Os objetos de
biblioteca incluem todas as categorias,
templates, conjuntos de enumeração,
tipos de referência e tabelas.
/Security[-] /Y Exporte as 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.
/SimplifiedConfigStrings[-] /Sc Exporte as strings de configuração para
templates de atributos ou atributos
derivados de templates de atributos sem
substituir parâmetros e não exporte
UniqueIDs ou point identifiers nas
strings de configuração.
/UniqueIDs[-] /U Exporte IDs exclusivos de todos os
objetos. Isso permite que o restante dos
objetos seja reimportado para o mesmo
banco de dados. Este parâmetro
aumenta o tamanho do arquivo de saída
e pode aumentar o tempo necessário
para a importação.
/Silent[-] /S Modo silencioso. Impede que
mensagens informativas sejam exibidas.
Se nenhum arquivo de saída for
especificado, esta opção será
automaticamente marcada.
/Summary[-] /M Modo Resumo. Envia apenas
informações mínimas sobre o progresso.
Este parâmetro não é válido com o
modo Silent ou se nenhum arquivo de
saída for especificado.
/User:string /user Use para especificar uma conta de
usuário Windows diferente para se
conectar ao servidor PI AF.
/Password:string /pw Se um nome de usuário for especificado,
especifique a senha de credenciais da
rede.
/Version /V Use para exibir as informações da
versão. Todos os outros parâmetros são
ignorados.

Guia do Usuário do PI System Explorer 47

Importação e exportação de banco de dados

Parâmetro Forma curta Descrição

/Flat[-] /flat Exporte o objeto hierárquico 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.
/Paste[-] /Pa A operação Colar se comporta como um
típico copiar/colar.
/?, /help Imprime o conteúdo desta tabela.
@file Use o arquivo especificado para
fornecer argumentos de entrada
adicionais. O arquivo deve conter um
argumento por linha. As linhas de
comentários começam com o caractere
#.

Caminhos de exportação de amostra

A tabela a seguir contém sintaxes de amostra para exportar diferentes componentes do banco
de dados PI AF.
Para exportar... Utilize esta sintaxe...
O banco de dados padrão .
O banco de dados MyDatabase no servidor PI AF \\.\MyDatabase
padrão
O elemento MyElement no banco de dados \\MyAFServer\MyDatabase\MyElement
MyDatabase no servidor PI AF denominado
MyAFServer
Todos os templates de elemento no banco de \\.\MyDatabase\ElementTemplates[]
dados MyDatabase
Template de elemento T1 no banco de dados \\.\MyDatabase\ElementTemplates[T1]
MyDatabase
Todos os conjuntos de enumeração no banco de \\MyAFServer\.\EnumerationSets[]
dados padrão MyAFServer
Todos os atributos de MyChildElement no banco \\MyAFServer\MyElement\MyChildElement
de dados padrão MyAFServer \Attributes[]
O banco de dados de UDM (UOMDatabase é \\.\UOMDatabase
sensível a maiúsculas e minúsculas)
Todas as tabelas no banco de dados padrão \\MyAFServer\.\Tables[]
MyAFServer

Utilitário AFImport
O utilitário AFImport, é um aplicativo de linha de comando que pode ser usado para restaurar
objetos PI 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 bancos de
dados de arquivos XML exportados.
O utilitário AFImport.exe está localizado na pasta \PIPC\AF.

48 Guia do Usuário do PI System Explorer

 Importação e exportação de banco de dados

Para executar o utilitário AFImport, abra uma janela de comando e navegue até a pasta PIPC
\AF. Use a seguinte sintaxe: AFImport.exe e escolha os parâmetros indicados no Parâmetros
do utilitário AFImport. Para exibir todos os parâmetros, digite:
AFImport /?

Parâmetros do utilitário AFImport

O utilitário AFImport é compatível com os seguintes parâmetros.
Parâmetro Forma curta Descrição
Path Caminho para o objeto para o qual você
deseja importar. Normalmente, no
formato: \\afserver\database. Use "."
para importar para o banco de dados
padrão.
/File:string /F Especifique um arquivo de entrada. Se
não for especificado, a operação de
importação fará a leitura a partir da
entrada padrão.
/AutoCheckIn[-] /A Faça o check-in automático das
alterações durante uma operação de
importação. Valor padrão: True
/Create[-] /C Permita a operação de importação para
criar novos objetos. Valor padrão: True
/Update[-] /U Permita a operação de importação para
atualizar os objetos existentes. Valor
padrão: True
/CreateUpdatePIPoints[-] /P Crie ou atualize a configuração do ponto
PI para os elementos recém-criados.
Observe que esta opção pode afetar
substancialmente o desempenho da
importação.
/DisableConfigStringValidation /D Desativa a validação das definições da
[-] string de configuração para referências
de dados e canais de entrega, que
podem melhorar a velocidade da
operação de importação. No entanto,
isso ignorará a procura de pontos PI,
que corrige ou adiciona IDs de servidor
e de ponto às strings de configuração.
/GenerateUniqueNames[-] /G Gere nomes exclusivos para objetos
quando já existir um objeto com o
mesmo nome.
/Paste[-] /Pa A operação de colagem se comporta
como se este fosse um processo de
copiar/colar. Dependendo da origem de
importação dos dados, isso afeta a
geração de um novo nome.
/ContinueOnError /CE Especifique o comportamento do
processo de importação quando ocorrer
um erro recuperável. As três opções
disponíveis são Yes, No e Prompt. O
valor padrão é Prompt, exceto se estiver
em execução silenciosa, neste caso, o
padrão será o cancelamento do processo
de importação.

Guia do Usuário do PI System Explorer 49

Importação e exportação de banco de dados

Parâmetro Forma curta Descrição

/Silent[-] /S Modo silencioso. Impede que
mensagens informativas sejam exibidas.
/Summary[-] /M Modo Resumo. Envia apenas
informações mínimas sobre o progresso.
/User:string /user Use para especificar uma conta de
usuário Windows diferente para se
conectar ao servidor PI AF.
/Password:string /pw Se um nome de usuário for especificado,
especifique a senha de credenciais da
rede.
/Version /V Exibe as informações da versão. Todos
os outros parâmetros são ignorados.
@file Leia o arquivo de resposta para verificar
mais opções. O arquivo de resposta
contêm um parâmetro por linha. As
linhas de comentários começam com o
caractere #.

50 Guia do Usuário do PI System Explorer

Recuperação de informações sobre ativos
O PI System Explorer fornece uma variedade de métodos que você pode usar para localizar e
avaliar os ativos no seu banco de dados PI AF, incluindo um navegador, janelas de pesquisa,
tendências para verificar fórmulas e cálculos, bem como gerenciamento de versão. Você
também pode analisar dados de séries cronológicas para atributos que contenham ou façam
referência a esses dados.

Nesta seção
• Navegação de ativos
• Pesquisas de ativos e dados de ativos
• Tendências no PI System Explorer
• Gerenciamento de versão para equipamentos e processos
• Exibição de versões de objetos diferentes e objetos obsoletos
• Visualizar dados das séries de tempo

Navegação de ativos
Use o navegador do PI System Explorer para exibir os objetos ativos no banco de dados PI AF.
O navegador exibe os seguintes ativos, dependendo do tipo de ativo que você selecionou no
painel do navegador:
• Elementos
Exibe ativos de elementos e pesquisas de elementos em um formato de árvore. Você pode
controlar quantos elementos são exibidos por página.
• Event frames
Exibe coleções de estrutura de evento e de pesquisa de transferência. Uma vez que os
modelos de ativo podem consistir em 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. As pesquisas recentes também são listadas na
coleção de pesquisas.
• Biblioteca
Exibe coleções de objetos para Templates (para elementos, estruturas de evento, modelos e
transferências), Conjuntos de enumeração, Tipos de referência, Tabelas, Conexões de
tabela e Categorias (para análises, atributos, elementos, regras de notificação, tipos de
referência e tabelas). Para ver todos os objetos de um determinado tipo, expanda a coleção
para esse tipo.
• Unidade de Medida
Exibe todas as classes de UDM no banco de dados Unidade de medida. Ao selecionar uma
classe, as UDMs pertencentes a essa classe são listadas no visualizador e na calculadora de
conversão.
• Contatos
Exibe uma lista de pesquisas de contato, equipes de escalonamento, grupos e delivery
endpoints autônomos para usar com as notificações.

Nesta seção
• Navegação de elemento

Guia do Usuário do PI System Explorer 51

Recuperação de informações sobre ativos

• Configurar tamanho de página do navegador

• Abrir janelas adicionais do navegador

Navegação de elemento
Os elementos são exibidos como uma árvore 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 do elemento
referenciado .

Configurar tamanho de página do navegador

O painel 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 acontecer, você verá e no navegador.
Por padrão, o número máximo de objetos exibidos no navegador é 1000, mas é possível alterar
esse número.

52 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Procedimento
1. No PI System Explorer, selecione Ferramentas > Opções.
2. Na guia Geral, digite o número máximo de objetos que podem ser exibidos no navegador no
campo Tamanho máximo de página com ramificações em árvore.
3. Clique em OK.

Abrir janelas adicionais do navegador

Ocasionalmente, você pode achar conveniente abrir janelas adicionais do navegador. Por
exemplo, você pode ter o banco de dados de unidade de medida exibido em uma instância do
navegador durante a criação de um novo template no navegador de Biblioteca.

Procedimento
1. No painel do navegador, clique com o botão direito no item que deseja abrir em outra janela.
2. Selecione Abrir em nova janela.
3. Para se movimentar entre janelas, clique no ícone PI System Explorer na barra de tarefas do
Windows e selecione a miniatura da janela desejada.

Pesquisas de 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
• Pesquisar paginação de resultados
• Tamanhos máximos de consultas
• Pesquisas em uma data específica
• Pesquisar pontos PI
• Gerenciar resultados da pesquisa
• Pesquisar elementos
• Pesquisar atributos em elementos
• Pesquisar estruturas de evento
• Pesquisar atributos nas estruturas de eventos
• Pesquisar transferências
• Pesquisar atributos em transferências

Guia do Usuário do PI System Explorer 53

Recuperação de informações sobre ativos

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 evento 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ções , insira os
critérios da pesquisa e pressione Enter. Os resultados da pesquisa são exibidos no
visualizador e no navegador.
Nota:
Os resultados da pesquisa que são exibidos no navegador permanecem lá para fácil
acesso, caso sejam necessários mais tarde. Você pode 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.

Pesquisar paginação de resultados

Quando grandes números de elementos ou estruturas de eventos são pesquisados, é possível
usar a opção Configurar 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 Configurar tamanho máximo da consulta para o número de objetos que se deseja
verificar nos resultados da pesquisa de uma única vez. Se a pesquisa retornar um número
maior de objetos que o valor Configurar tamanho máximo da consulta especificado, os
resultados serão paginados.
Por exemplo, se o valor Configurar tamanho máximo da consulta for 100.000, o servidor PI AF
tentará encontrar 100 mil objetos correspondentes antes de retornar os resultados. Talvez
você não queira aguardar que o servidor encontre esse número de correspondência, nem
queira verificar tantas correspondências em uma única página de resultados da pesquisa. Se
Configurar tamanho máximo da consulta for alterado para 100, o servidor PI AF enviará os
resultados depois que cada 100 correspondências forem encontradas, e 100 objetos serão
exibidos nos resultados da pesquisa.

Regras de resultado da pesquisa

• Apenas os resultados da pesquisa de elementos, transferências e estruturas de eventos são

paginados.
• A configuração Configurar tamanho máximo da consulta só pode ser aplicada a pesquisa
rápidas de elementos, transferências ou estruturas de eventos. Se você estiver pesquisando
outros objetos, a pesquisa ignorará o valor Configurar tamanho máximo da consulta.
• Nas janelas de pesquisa, o valor Resultados por página substitui o valor Configurar
tamanho máximo da consulta.

Tamanhos máximos de consultas

Um padrão de sistema controla o número de objetos que podem ser retornados por uma
consulta de pesquisa. Os usuários podem substituir o padrão do sistema especificando um

54 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

valor diferente nas janelas Pesquisa de elemento, Pesquisa de atributo, Pesquisa de estrutura
de evento e Pesquisa de transferência.

Padrão do sistema
Configure a opção Tamanho máximo da consulta em Ferramentas > Opções. Isso configura o
valor padrão do PI System Explorer.

Tamanhos personalizados
É possível substituir o padrão do sistema para uma pesquisa específica configurando um valor
personalizado para Máximo de resultados. Para estrutura de evento, especifique um valor
personalizado no campo Resultados por página.

Pesquisas 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 em 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
quais objetos são 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, estabeleça um contexto de tempo na janela Configurar contexto de tempo, conforme
descrito em Configurar o contexto de tempo para os valores de atributo exibidos.

Pesquisar pontos PI
Use a janela Pesquisa por Tag para recuperar as tags do PI que correspondam aos seus critérios
de consulta de pesquisa. No PI AF e no PI Builder 2017 ou versões posteriores, você pode criar
uma consulta de pesquisa baseada em atributos da tag do PI e em valores da tag do PI.
Dica:
Para criar referências de dados da tag do PI diretamente de tags do PI recuperadas de
uma pesquisa por tag do PI, selecione Visualizar > Paleta > Pesquisa por Tag. Para obter
mais informações, consulte Criar referências de dados do ponto do PI direto a partir dos
resultados da pesquisa de tag.

Procedimento
1. No painel do navegador, clique em Elementos.
2. Selecione Pesquisar > Pesquisa por Tag.
3. Na janela Pesquisa por Tag, escolha os computadores do PI Data Archive nos quais deseja
pesquisar.
Para adicionar ou alterar computadores do PI Data Archive, escolha uma das seguintes
ações:

◦ Clique em ao lado do campo Servidor(es) e clique em um PI Data Archive da lista.

◦ Clique em e, então, clique duas vezes no PI Data Archive que você deseja adicionar da
lista da janela PI Data Archives.
◦ Para remover um PI Data Archive selecionado, selecione o nome do servidor no campo
Servidor(es), clique com o botão direito na seleção e clique em Excluir.
Os servidores são adicionados em ordem alfabética à seleção existente. Você pode adicionar
várias seleções das duas listas.

Guia do Usuário do PI System Explorer 55

Recuperação de informações sobre ativos

4. As consultas de pesquisa por tag do PI são criadas na caixa de texto ao lado do botão
Pesquisar. A consulta de pesquisa compreende um nome de filtro, que pode ser uma string
de texto, um atributo da tag do PI (padrão: tag) ou um valor da tag do PI (por exemplo,
Value), um operador (padrão: :=) e um filtro de consulta (padrão: * ou todas as tags do PI).
Para obter uma descrição completa da sintaxe de uma consulta de tag do PI, consulte a
seção Sintaxe para pesquisas por tags do PI.
Exemplos de consultas de atributos:

◦ sin*
◦ tag:=sin*
◦ tag:<>sin* datatype:float
◦ step:0 AND pointsource:L
◦ tag:<>sin* AND PointType:Float64
Exemplos de consultas de valor (que podem ser combinadas a consultas de atributos):

◦ Value:>1000
◦ tag:<>sin* AND Value:>10
◦ PointType:Int32 AND Value:>10
◦ PointSource:L AND Annotated:1 AND TimeStamp:t
◦ creationdate:>y-1d AND future:true AND timestamp:<*
Por padrão, o PI AF pesquisa nomes de tags que começam com a string da consulta e
incluem a descrição da tag (o que significa que os filtros Começa com e Incluir descrição na
pesquisa já estão selecionados).
Nota:
Em PI AF 2017, as consultas que contenham somente uma string de texto (como
*sine*) e não contenham um nome de filtro de consulta pesquisam a tag e atributo
"descriptor". Contudo, as consultas que contenham um nome de filtro de consulta
(como name:*sine*), pesquisam somente atributos da tag. Em versões anteriores do
PI AF, as consultas que continham um nome de filtro de consulta pesquisavam o
atributo "descriptor" e o filtro da consulta, exceto se o atributo "descriptor" fosse
especificado como parte do filtro da consulta.
Para criar uma consulta de pesquisa, escolha uma das ações a seguir.
Para... Faça o seguinte...
Limpar critérios selecionados anteriormente Clique em Redefinir.
Todas as consultas são limpas, além do filtro
Incluir descrição na pesquisa.

Excluir descrições de tags de uma consulta a. Clique em .

Digite uma consulta diretamente na caixa
Pesquisar texto
b. Limpe Incluir descrição na pesquisa.
a. Digite o primeiro caractere da consulta.
b. Selecione na lista de atributos de tag e
valores correspondentes ou continue
digitando um atributo da tag ou valor
manualmente.
c. Insira os critérios a serem correspondidos.

56 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Incluir atributos da tag do PI comuns em uma a. Clique em .

consulta
b. Insira os critérios em um dos campos a
seguir:
▪ Nome (alias para o atributo tag)
▪ Origem do ponto
▪ Tipo de dados (alias para o atributo
pointtype)
▪ Classe da tag (alias para o atributo
ptclassname)
c. Para inserir critérios para unidades de
engenharia e descrição, clique em Adicionar
critérios ou pressione ALT+C. Em seguida,
clique em Unidades de engenharia e/ou
Descrição.
Os critérios são anexados à string na caixa
Pesquisar Texto, separados por um espaço.
Nota:
A consulta de pesquisa retorna somente
tags do PI que correspondem a todos os
critérios.

Incluir valores da tag do PI em uma consulta a. Clique em .

b. Clique em Adicionar critérios ou pressione

ALT+C.
c. Clique em qualquer um dos critérios a seguir:
▪ Valor
▪ TimeStamp
▪ IsGood
▪ Anotado
▪ Substituído
▪ Questionável
d. Insira os critérios nos campos selecionados
conforme solicitado.
Os critérios são anexados à string na caixa
Pesquisar Texto da consulta, separados por um
espaço.
Nota:
A consulta de pesquisa retorna somente
tags do PI que correspondem a todos os
critérios.

Limpar uma consulta existente ou remover um Clique em .

critério da área de pesquisa expandida
Usar consulta anterior a. Clique em .
b. Clique em Pesquisas Recentes.
c. Selecione a consulta existente na lista.
Filtrar nomes de tags por conteúdo, a. Clique em .
correspondente exato ou terminação
b. Clique no filtro adequado:
▪ Contém
▪ Correspondente Exato
▪ Termina Com

Guia do Usuário do PI System Explorer 57

Recuperação de informações sobre ativos

5. Clique em Pesquisar para obter as tags correspondentes na tabela de resultados.

6. Escolha uma das seguintes ações.
Para...
Revisar dados de séries cronológicas
Criar uma tendência
Adicionar uma tag do PI a uma tendência
existente
Revisar os valores atuais da tag do PI,
timestamps e atributos
Criar uma referência de dados da tag do PI
Faça o seguinte...
Clique com o botão direito em uma tag do PI e
clique em Dados de Série de Tempo. Para obter
mais informações, consulte Visualizar dados das
séries de tempo.
Clique com o botão direito em uma tag do PI e
clique em Tendência. Para obter mais
informações, consulte Criar tendências.
Clique com o botão direito em uma tag do PI e
clique em Add to Trend (Adicionar à tendência).
Clique com o botão direito em uma tag do PI e
clique em Propriedades.
Somente para os resultados de pesquisa exibidos
na paleta.
Arraste uma tag do PI para a grade Atributos.
Para obter mais informações, consulte Criar
referências de dados do ponto do PI direto a
partir dos resultados da pesquisa de tag.

Alterar as colunas na tabela de resultados Clique em e desmarque as colunas que você

Adicionar colunas de atributos à tabela de
resultados
Restaurar as colunas originais na tabela de
resultados
deseja remover.
a. Clique com o botão direito no cabeçalho de
uma coluna e clique em Adicionar coluna.
b. Na janela Selecionar Atributos do Ponto,
selecione os atributos de tag a serem
adicionados.
c. Clique em OK.
Clique com o botão direito no cabeçalho de uma
coluna e clique em Restaura colunas originais.

7. Clique em OK.
Os resultados são exibidos no visualizador. Cada pesquisa é listada temporariamente no
navegador com um rótulo Resultados da Pesquisa por Tags. Para diferenciar as pesquisas,
você pode alterar um rótulo clicando com o botão direito e clicando em Renomear.

Sintaxe para pesquisas por tags do PI

Consulte as seções a seguir para obter detalhes sobre a sintaxe para construir consultas de tags
do PI em PI AF e PI Builder. Para obter informações detalhadas sobre a sintaxe de consulta de
tags do PI, consulte a seção “Visão geral da sintaxe de consulta de PIPoint” no PI System
Explorer: Ajuda > Referência AF SDK > Visão geral, ou vá para a página de Suporte técnico
Visão geral da sintaxe de consulta de PIPoint (https://techsupport.osisoft.com/
Documentation/PI-AF-SDK/html/b8fbb6da-7a4b-4570-a09d-7f2b85ed204d.htm).

Filtros de condição
Para criar uma consulta de tags do PI, insira um ou mais filtros de condição do AND que
também podem ser combinados com uma condição OR conforme necessário. Cada condição
AND contém uma ou mais consultas, separadas por espaço ou AND. A consulta consiste em um
nome do filtro de consulta, um operador e o filtro da consulta. Dessa forma, você pode
especificar diversas condições com uma única consulta, conforme exibido no exemplo a seguir:

58 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

(tag:<>sin* AND PointType:Float64) OR (tag:="*Tank*" AND DataType:=Int32)

Nota:
É possível usar parênteses somente entre condições OR.
É possível fazer referência a um nome de filtro uma vez por condição AND da sequência de
consultas. Por exemplo, PointId:>5 AND PointId:<10 gera um erro, ao passo que
PointType:=Int32 OR PointType:=Float32 é válido.
Para maior eficiência, crie sua consulta de forma a eliminar a maioria dos itens dos resultados
recuperados com seus primeiros filtros de condição.

Nomes de filtros de consulta

Ao fazer uma consulta com base em atributos da tag do PI, o nome do filtro da consulta é um
nome ou alias do atributo da tag do PI. Os aliases comuns são:
Nome do alias Nome do atributo
Nome Tag
DataType PointType
Descrição Descritor
PointClass PtClassName

A partir de PI AF 2017, é possível fazer consultas com base em valores, além de consultas de
tags do PI com base em atributo. Contudo, não é possível usar a condição OR para consultar um
valor de tag do PI. Por exemplo, ocorreria um erro se as seguintes consultas fossem inseridas:
• IsGood:false OR Annotated:true
• PointType:Float AND Value:>10 porque PointType:Float é convertido de forma
implícita para 'PointType:=Float16 OR PointType:=Float32 OR
PointType:=Float64'
• PointType:Int AND Value:>10 porque PointType:Int é convertido de forma implícita
para 'PointType:=Int16 OR PointType:=Int32'
• sin* AND Value:>10 porque sin* é convertido de forma implícita para 'tag:=sin* OR
Descriptor:=sin*' se a configuração de filtro padrão para Incluir descrição na pesquisa
for selecionada. Para ser válido, seria necessário limpar o filtro Incluir descrição na pesquisa.

Caracteres coringa
É possível usar os caracteres especiais a seguir em uma consulta de tags de PI.
Nota:
Os resultados dos exemplos abaixo presumem que a opção de pesquisa padrão esteja sendo
usada; essa opção pesquisa nomes de tags do PI que iniciam com a string pesquisada.

Caractere Descrição Exemplo

especial
* Substituir qualquer número de
caracteres não especificados
sin*
Retorna todas as tags do PI que têm nomes que
começam com "sin", por exemplo, sinusoid e
sinusoidu.

? Substituir um único caractere CD?158

não especificado
Retorna todas as tags do PI que têm nomes que
começam com "CD", seguidas por qualquer
caractere único, seguido por "158" (por exemplo,
CD1158, CDA158 e assim por diante).

Guia do Usuário do PI System Explorer 59

Recuperação de informações sobre ativos

Caractere Descrição Exemplo

especial
: ou := Ao pesquisar todos os pontos PI pointsource:R
com um valor de atributo
Retorna todas as tags do PI que têm o valor
específico (diferente do nome),
pointsource R.
separa o atributo e o valor
pesquisado. "ba:temp.1"
Dica: ba\:temp.1
Ao pesquisar um nome de
tag do PI contendo uma Qualquer um dos exemplos acima retorna a tag do
vírgula, coloque o nome PI denominada ba:temp.1.
entre aspas duplas ou
coloque uma barra
invertida antes da vírgula.

'' Delimitadores para strings de '*Owner Change*'

pesquisa que contêm espaços ou
ou ou
caracteres especiais
"" "*Owner Change*"
Retorna todas as tags do PI que têm nomes que
contêm Alteração do proprietário.
"ba:temp.?"
Retorna todas as tags do PI contendo nomes
iniciando com ba:temp. e terminando com um
único caractere.

Operadores
A tabela a seguir lista os operadores que podem ser usados em uma condição AND.
Operador Descrição Exemplo
= O operador EQUALS. Tag:Tank* ou Tag:=Tank*
<> O operador NOT EQUALS. PointType:<>Int32
< O operador LESS THAN. Descriptor:<M
<= O operador LESS THAN OR EQUAL. Tag:<=Tank
> O operador GREATER THAN . Tag:>Tank
>= O operador GREATER THAN OR EQUAL. Tag:>=Tank

Nas consultas de valor da tag do PI com um tipo de dado de Sequência de Caracteres, não é
possível usar os seguintes operadores: <<=, > ou >=. Além disso, quando se espera valores
booleanos (como com consultas de valor da tag Substituted, Questionable, Annotated e
IsGood), é possível usar somente os operadores = e <>.

Restrições de sintaxe

• Não é possível consultar atributos de tag de dados futuros, como creationdate:>y-1d

AND future:true, em servidores PI Data Archive anteriores a 3.4.395.
• Não é possível consultar atributos de tag de dados futuros, como PtSecurity e
DataSecurity, em servidores PI Data Archive anteriores a 3.4.380.

60 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Gerenciar resultados da pesquisa

O PI System Explorer exibe todos os resultados da pesquisa no navegador, onde você pode
salvá-los em uma coleção de pesquisas para reutilização, para renomeá-los ou editar os
critérios. Todos os resultados de pesquisa não salvos são indicados por um asterisco.
Nota:
Todos os resultados de pesquisa não salvos são excluídos quando você sair do PI System
Explorer.

Procedimento
1. Opcional. Para trabalhar de uma lista de resultados de pesquisa no visualizador e não no
navegador, escolha uma das seguintes ações:
Para...
Gerenciar uma pesquisa de elemento ou atributo
Gerenciar uma pesquisa de estruturas de evento
Gerenciar uma pesquisa de transferência
Faça o seguinte...
a. No navegador, clique em Elementos.
b. No navegador, clique na coleção Pesquisas de
elemento.
a. No navegador, clique em Estruturas de
evento.
b. No navegador, clique na coleção Pesquisas de
estrutura de evento.
a. No navegador, clique em Estruturas de
evento.
b. No navegador, clique na coleção Pesquisas de
transferência.

2. Selecione uma pesquisa e escolha uma das seguintes ações:

Para...
Salvar um resultado de pesquisa
Renomear um resultado de pesquisa
Copiar um resultado de pesquisa
Editar critérios para um resultado de pesquisa
Excluir um resultado de pesquisa
Faça o seguinte...
Clique com o botão direito em um nome de
resultado de pesquisa não salvo e clique em
Salvar.
a. Clique com o botão direito em um nome de
resultado de pesquisa e clique em Renomear.
b. Digite um novo nome de resultado de
pesquisa.
Clique com o botão direito no nome de resultado
de pesquisa e clique em Copiar.
a. Clique com o botão direito em um nome de
resultado de pesquisa e clique em
Propriedades. (No visualizador, é possível
também clicar duas vezes em um nome de
resultado de pesquisa.)
b. Modifique os critérios de pesquisa conforme
necessário e clique em OK.
a. Clique com o botão direito em um nome de
resultado de pesquisa e clique em Excluir.
b. Clique em Sim na janela de confirmação
Excluir.

Guia do Usuário do PI System Explorer 61

Recuperação de informações sobre ativos

Reorganizar resultados de pesquisa de estrutura No navegador apenas:

de evento ou de transferência
Exibir o caminho completo para elementos ou
event frames
a. Clique com o botão direito em um nome de
resultado de pesquisa de estrutura de evento
ou transferência e clique em Organizar por.
b. Selecione uma das seguintes opções:
▪ Organizar por nome
▪ Organizar por hora de término
▪ Organizar por hora de início
▪ Organizar por categoria
▪ Organizar por template
Somente no visualizador:
a. Clique com o botão direito no cabeçalho da
coluna (ou abaixo da grade de resultados da
pesquisa).
b. Clique em Exibir Caminhos Completos.

Pesquisar elementos
Use a janela Pesquisa de elemento para recuperar os dados do elemento que correspondam aos
seus critérios de pesquisa.

Procedimento
1. No painel do navegador, clique em Elementos.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de elemento.
◦ No navegador, clique com o botão direito no nó da raiz Pesquisas de elemento e
selecione Nova pesquisa.
3. Configure a janela Pesquisar 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, Correspondência
Exata, 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.

▪ Raiz da Pesquisa de Elemento

Insira o elemento que deseja usar como o nível de raiz ou base para a pesquisa de
elementos. Insira 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 de Elemento poderá melhorar o
desempenho da pesquisa.

62 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos
▪ Todos os Descendentes
Selecione Verdadeiro para recuperar qualquer subelemento da hierarquia que
corresponda aos critérios especificados. Selecione Falso para recuperar apenas os
elementos do nível raiz correspondentes aos critérios especificados.

▪ Template
Selecione o template no qual os elementos recuperados devem ser baseados. Depois
de selecionar o template, será possível adicionar critérios para encontrar elementos
por valor do atributo.

▪ Categoria
Selecione a categoria à qual os elementos recuperados devem corresponder.
c. Se desejado, clique em Adicionar Critérios, 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. Especifique até três condições para um
valor de atributo. Para cada condição, especifique um nome do atributo, o operador e
o valor do atributo, por exemplo, Temperature >= 98.

▪ Descrição
Insira uma string (até 440 caracteres) à qual os elementos recuperados devem
corresponder.

▪ Tipo de Elemento
Selecione o tipo ao qual os elementos recuperados devem corresponder.

▪ É anotado
(PI AF 2017 ou versões posteriores) Defina como True para recuperar somente
elementos que tenham anotações. Defina como False para recuperar somente
elementos que não tenham anotações.

▪ Data de criação
(PI AF 2017 ou versões posteriores) Selecione um operador e insira uma data ou
abreviação de tempos relativos do PI ( >= *-30d é o padrão) para recuperar os
elementos criados no período especificado. Também é possível clicar em para
selecionar uma data na janela Seletor de data e hora. É possível selecionar Data de
criação mais uma vez e filtrar a pesquisa de modo a exibir resultados entre dois
valores (< *+1d é o padrão).

▪ Modificar data
(PI AF 2017 ou versões posteriores) Selecione um operador e insira uma data ou
abreviação de tempos relativos do PI ( >= *-30d é o padrão) para recuperar os
elementos modificados no período especificado. Também é possível clicar em para
selecionar uma data na janela Seletor de data e hora. É possível selecionar Modificar
data mais uma vez e filtrar a pesquisa de modo a exibir resultados entre dois valores
(< *+1d é o padrão).

Guia do Usuário do PI System Explorer 63

Recuperação de informações sobre ativos

Nota:
A data de modificação de um elemento é atualizada sempre que uma anotação ou
um elemento filho é adicionado, bem como quando uma alteração em sua
configuração é feita no banco de dados.
A maioria das alterações de template ou modificações de um valor do atributo que
não seja item de configuração não afetará a data de modificação de um elemento.

▪ Resultados por página

Insira o número máximo de elementos a serem mostrados em uma única página de
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.
4. 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.
5. Selecione os resultados que se deseja usar e clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

Configurar as condições para um valor de atributo

Você pode restringir a pesquisa baseada no valor de um atributo. Depois de especificar um
template, use o campo Valor do Atributo para configurar até três condições que a pesquisa
deve atender com relação a um valor do atributo.

Procedimento
1. Clique em Exibir opções de atributo e selecione um atributo.

O menu agrupa os atributos nas seguintes categorias:

◦ Atributos indexados
Atributos indexados, incluindo atributos de configuração.

◦ Atributos de configuração
Atributos de configuração que não são indexados.

◦ Outros atributos
Atributos que não são de configuração e não sã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 atributos com os 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.
Para os tipos de valores de atributo Single e Double, as consultas não oferecem suporte ao
operador In.

64 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Para os tipos de valores de atributo String, Boolean e Int64, as consultas não oferecem
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.

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 do navegador, clique em Elementos.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de atributo.
◦ No navegador, clique com o botão direito na coleção Pesquisas de elemento e selecione
Nova pesquisa por atributos.
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.

▪ Descrição do atributo
Insira uma string (até 440 caracteres) à qual os atributos recuperados devem
corresponder.

▪ Categoria de atributo
Selecione a categoria à qual os atributos recuperados devem corresponder.

▪ Tipo de valor do atributo

Selecione o tipo de valor que os atributos recuperados devem armazenar.

▪ Máximo de resultados
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:

Guia do Usuário do PI System Explorer 65

Recuperação de informações sobre ativos
▪ Raiz da Pesquisa
Insira o elemento que deseja usar como o nível de raiz ou base para a pesquisa de
atributos. Insira 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 Subelementos para pesquisar a raiz inserida e
todos os subelementos. Desmarque esta caixa de seleção para pesquisar apenas na
raiz inserida.

▪ Nome
Insira o nome dos elementos nos quais deseja pesquisar os atributos. Caracteres
especiais podem ser inseridos para substituir parte de um nome. Consulte Caracteres
especiais nas pesquisas por nome.

▪ Descrição
Insira uma string (até 440 caracteres) para recuperar apenas os elementos
correspondentes.

▪ Categoria
Selecione a categoria dos elementos nos quais deseja pesquisar os atributos.

▪ Template
Selecione o template dos elementos nos quais deseja pesquisar os atributos.

▪ Tipo
Selecione o tipo dos elementos nos quais deseja pesquisar os atributos.
Se valores para múltiplas configurações forem especificados, a pesquisa retornará apenas os
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 pesquisar os atributos em
elementos particulares e selecione os atributos para adicioná-los à tabela Resultados da
pesquisa.
Lembre-se: os atributos disponíveis por pesquisa e os atributos disponíveis pela navegação
na hierarquia de elementos dependem das propriedades de configuração dos atributos.
5. Selecione os itens na lista de resultados de pesquisa e clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

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.

66 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Caractere especial Objetivo

? 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 evento

Use a janela Pesquisa de estrutura de evento para recuperar os dados de estrutura de evento
que correspondam aos seus critérios de pesquisa.

Procedimento
1. No painel do navegador, clique em Estruturas de evento.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de estrutura de evento.
◦ No navegador, clique com o botão direito na coleção Pesquisas de estrutura de evento e
selecione Nova pesquisa.
3. Configure a janela Pesquisa de Event Frame para encontrar os event frames desejados no
banco de dados do PI AF.
Se forem especificados valores para múltiplas configurações, a pesquisa retornará apenas os
event frames que atenderem a todas as configurações especificadas.

a. Na lista Ações , selecione o tipo de filtro a ser aplicado: Contém, Correspondência

Exata, Começa Com ou Termina Com.
b. Em Critérios, configure os campos para restringir os event frames recuperados:

▪ Pesquisar
Selecione o método a ser usado para especificar quando os event frames desejados
ocorreram. A janela mostra os campos apropriados para o método selecionado.
Por exemplo, selecione Ativo Entre para especificar o horário de início e de término e
encontrar os event frames ativos a qualquer momento no período. Selecione
Começando Depois para especificar apenas uma hora de início e encontrar os event
frames que iniciam depois dessa hora.

▪ Em andamento
Se disponível, marque esta caixa de seleção para restringir ainda mais as
correspondências dos event frames com os que ainda não terminaram.

▪ Início da pesquisa
Uma expressão do PI time que especifica o início do período usado para pesquisar os
event frames.

▪ Final da pesquisa
Uma expressão do PI time que especifica o final do período usado para pesquisar os
event frames.

Guia do Usuário do PI System Explorer 67

Recuperação de informações sobre ativos

Opcional. Na lista ao lado desse campo, selecione uma hora definida para preencher
automaticamente os campos Início da Pesquisa e Fim da Pesquisa.

▪ Todos os Descendentes
Marque esta caixa de seleção para pesquisar todos os níveis da hierarquia de event
frames abaixo da raiz especificada para obter os event frames correspondentes.

▪ Nome
Insira o nome do event frame 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.

▪ Nome do Elemento
Insira um elemento do PI AF que deve ser o pai de qualquer event frame recuperado.
Caracteres especiais podem ser inseridos para substituir parte de um nome. Consulte
Caracteres especiais nas pesquisas por nome.

▪ Categoria
Selecione a categoria à qual os event frames recuperados devem corresponder.

▪ Resultados por Página

Insira o número máximo de event frames a serem mostrados em uma única página de
resultados da pesquisa.
c. Se desejado, clique em Adicionar Critérios, selecione mais campos a serem inseridos na
janela e configure-os para restringir os event frames recuperados:

▪ Template
Selecione o template no qual os event frames recuperados devem ser baseados.
Depois de selecionar o template, será possível adicionar critérios para encontrar
elementos por valor do atributo.

▪ Nome da análise
Insira o nome da análise a partir da qual foram geradas as estruturas de evento
recuperadas. Você pode usar caracteres coringas conforme necessário.

▪ Valor do Atributo
Disponível se um template for especificado. É possível especificar até três condições
para um valor de atributo. Para cada condição, especifique um nome do atributo, o
operador e o valor do atributo, por exemplo, Temperature >= 98. Para obter mais
detalhes, consulte Configurar as condições para um valor de atributo.

▪ Duração
Selecione um operador e insira um valor, que pode incluir uma abreviatura de PI time.
Por exemplo, selecione >= e insira 1d para recuperar eventos que duram pelo menos
um dia. É possível selecionar Duração mais uma vez e filtrar a pesquisa para
resultados entre dois valores. Por exemplo, selecione <= e insira 2d para recuperar
eventos que duraram entre um e dois dias.

▪ Raiz da Pesquisa de Event Frame

Insira o event frame que deseja usar como o nível de raiz ou base para a pesquisa de
event frames. Insira o nome exato ou clique em Procurar para abrir a janela
Navegador de Event Frames, na qual é possível ver a hierarquia de event frames e
selecionar um event frame. Não é possível incluir caracteres curinga no nome

68 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

inserido. Se um event frame não for especificado, será necessário definir o nível
principal da hierarquia de event frames como sendo a raiz. Dependendo da
complexidade da sua hierarquia de PI AF, a especificação de um event frame no
campo Raiz de Pesquisa de Event Frame poderá melhorar o desempenho da pesquisa.

▪ Pode Ser Reconhecido

(PI AF 2016 ou versões posteriores). Defina como True para recuperar event frames
que podem ser reconhecidos. A capacidade de reconhecer event frames é
determinada no template em que o event frame é baseado.

▪ É Reconhecido
(PI AF 2016 ou versões posteriores). Defina como True para recuperar event frames
que foram reconhecidos. Defina como False para recuperar event frames que não
foram reconhecidos.

▪ É Anotado
(PI AF 2016 ou versões posteriores). Defina como True para recuperar somente event
frames que tenham anotações. Defina como False para recuperar somente event
frames que não tenham anotações.

▪ Severidade
(PI AF 2016 ou versões posteriores). Selecione um operador e uma configuração de
gravidade da lista. Por exemplo, selecione >= Pequena para recuperar event frames
que tenham pelo menos uma configuração de gravidade Pequena. É possível
selecionar Gravidade outra vez e filtrar a pesquisa para resultados entre duas
configurações de gravidade. Por exemplo, selecione <= Crítica para recuperar event
frames que tenham configurações de gravidade Pequena, Grande e Crítica.

▪ Data de criação
(PI AF 2017 ou versões posteriores) Selecione um operador e insira uma data ou
abreviação de tempos relativos do PI ( >= *-30d é o padrão) para recuperar as
estruturas de evento criadas no período especificado. Também é possível clicar em
para selecionar uma data na janela Seletor de data e hora. É possível selecionar Data
de criação mais uma vez e filtrar a pesquisa de modo a exibir resultados entre dois
valores (< *+1d é o padrão).

▪ Modificar data
(PI AF 2017 ou versões posteriores) Selecione um operador e insira uma data ou
abreviação de tempos relativos do PI ( >= *-30d é o padrão) para recuperar as
estruturas de evento modificadas no período especificado. Também é possível clicar
em para selecionar uma data na janela Seletor de data e hora. É possível selecionar
Modificar data mais uma vez e filtrar a pesquisa de modo a exibir resultados entre
dois valores (< *+1d é o padrão).
Nota:
A data de modificação de uma estrutura de evento é atualizada sempre que um
valor, uma anotação ou estrutura de evento filho é adicionado, bem como quando
uma alteração à sua configuração é inserida no banco de dados.
A maioria das alterações de template ou modificações de um valor do atributo que
não seja um item de configuração não afetará a data de modificação de uma
estrutura de evento.

Guia do Usuário do PI System Explorer 69

Recuperação de informações sobre ativos

4. Clique em Pesquisar para recuperar as estruturas de evento correspondentes na tabela

Resultados.
5. Clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

Pesquisar atributos nas estruturas de eventos

Use a janela Pesquisa de atributo de event frame para recuperar os dados do atributo de event
frame que correspondam aos seus critérios de pesquisa.

Procedimento
1. No painel do navegador, clique em Estruturas de evento.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de atributo de estrutura
de evento.
◦ No navegador, clique com o botão direito na coleção Pesquisas de estrutura de evento e
selecione Nova pesquisa por atributos.
3. Configure a janela Pesquisa de atributo de event frame para encontrar os atributos desejados
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.

▪ Descrição do atributo
Insira uma string (até 440 caracteres) à qual os atributos recuperados devem
corresponder.

▪ Categoria de atributo
Selecione a categoria à qual os atributos recuperados devem corresponder.

▪ Tipo de valor do atributo

Selecione o tipo de valor que os atributos recuperados devem armazenar.

▪ Máximo de resultados
Insira o número máximo de atributos correspondentes a serem recuperados.
b. Na área Critérios de event frame, 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 Início da pesquisa e Final da pesquisa.

▪ Início da pesquisa / Final da pesquisa

Selecione ou insira a hora de início e término do período da pesquisa.

70 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos
▪ Raiz da Pesquisa
Insira o evento frame 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 event
frame, na qual é possível ver a hierarquia e selecionar um event frame. 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 subevent frames para pesquisar a raiz inserida e
todos os seus filhos. Desmarque esta caixa de seleção para pesquisar apenas na raiz
inserida.

▪ Nome
Insira o nome dos event frames nos quais os atributos serão pesquisados. Caracteres
especiais podem ser inseridos para substituir parte de um nome. Consulte Caracteres
especiais nas pesquisas por nome.

▪ Descrição
Insira uma string de descrição com até 440 caracteres para recuperar apenas os
elementos correspondentes.

▪ Duração
Insira os valores de duração máxima e mínima para limitar a pesquisa de atributos a
event frames cuja duração está dentro dos limites.

▪ Categoria
Insira a categoria de event frames nas quais os atributos serão pesquisados.

▪ Template
Selecione o template de event frames nas quais os atributos serão pesquisados.
Se valores para múltiplas configurações forem especificados, a pesquisa retornará apenas os
atributos que atendam a todas as configurações especificadas.
4. Clique em Pesquisar para recuperar os atributos correspondentes na tabela Resultados da
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 de pesquisa e clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

Pesquisar transferências
Use a janela Critérios de pesquisa de transferência para recuperar os dados do atributo de
transferência que correspondam aos seus critérios de pesquisa.

Guia do Usuário do PI System Explorer 71

Recuperação de informações sobre ativos

Procedimento
1. No painel do navegador, clique em Estruturas de evento.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de transferência.
◦ No navegador, clique com o botão direito na coleção Pesquisas de transferência e
selecione Nova pesquisa.
3. Configure a janela Critérios de pesquisa de transferência para encontrar as transferências
desejadas no banco de dados do PI AF:

◦ Pesquisar
Selecione os critérios para encontrar transferências que sobrepõem o período
especificado em Início da pesquisa e Final da pesquisa.

◦ Início da pesquisa / Final da pesquisa

Selecione ou insira a hora de início e término do período da pesquisa.

◦ Nome
Insira o nome das transferências nas quais deseja pesquisar. Caracteres especiais podem
ser inseridos para substituir parte de um nome. Consulte Caracteres especiais nas
pesquisas por nome.

◦ Descrição
Insira uma string de descrição com até 440 caracteres para recuperar apenas as
transferências correspondentes.

◦ Origem
Insira ou clique em para abrir a janela Navegador de elementos, onde é possível
visualizar a hierarquia de elementos e selecionar o elemento de origem para as
transferências que deseja incluir na pesquisa. Clique no botão Qualquer para redefinir
para o padrão <Any>.

◦ Destino
Insira ou clique em para abrir a janela Navegador de elementos, onde é possível
visualizar a hierarquia de elementos e selecionar o elemento de destino para as
transferências que deseja incluir na pesquisa. Clique no botão Qualquer para redefinir
para o padrão <Any>.

◦ Template
Selecione o template das transferências no qual deseja pesquisar.

◦ Máximo de resultados
Insira o número máximo de transferências correspondentes a serem recuperadas.
Se valores para múltiplas configurações forem especificados, a pesquisa retornará apenas as
transferências que atendam a todas as configurações especificadas.
4. Clique em Pesquisar para recuperar as transferências correspondentes na tabela Resultados
da pesquisa.

72 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Os resultados podem ser limitados ainda mais para listar apenas as transferências que
correspondem ao texto inserido no campo Resultados da pesquisa.
5. Clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

Pesquisar atributos em transferências

Use a janela Pesquisa de atributo de transferência para recuperar os dados do atributo de
transferência que correspondam aos seus critérios de pesquisa.

Procedimento
1. No painel do navegador, clique em Estruturas de evento.
2. Escolha uma das seguintes ações:
◦ No menu do PI System Explorer, selecione Pesquisar > Pesquisa de atributo de
transferência.
◦ No navegador, clique com o botão direito na coleção Pesquisas de transferência e
selecione Nova pesquisa por atributos.
3. Configure a janela Pesquisa de atributo de transferência 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.

▪ Descrição do atributo
Insira uma string (até 440 caracteres) à qual os atributos recuperados devem
corresponder.

▪ Categoria de atributo
Selecione a categoria à qual os atributos recuperados devem corresponder.

▪ Tipo de valor do atributo

Selecione o tipo de valor que os atributos recuperados devem armazenar.

▪ Máximo de resultados
Insira o número máximo de atributos correspondentes a serem recuperados.
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 Início da pesquisa e Final da pesquisa.

▪ Início da pesquisa / Final da pesquisa

Selecione ou insira a hora de início e término do período da pesquisa.

Guia do Usuário do PI System Explorer 73

Recuperação de informações sobre ativos
▪ Nome
Insira o nome das transferências nas quais deseja pesquisar os atributos. Caracteres
especiais podem ser inseridos para substituir parte de um nome. Consulte Caracteres
especiais nas pesquisas por nome.

▪ Descrição
Insira uma string de descrição com até 440 caracteres para recuperar apenas os
atributos correspondentes.

▪ Origem
Insira ou procure e selecione o elemento de origem das transferências cujos atributos
deseja incluir na pesquisa.

▪ Destino
Insira ou procure e selecione o elemento de destino das transferências cujos atributos
deseja incluir na pesquisa.

▪ Template
Selecione o template das transferências no qual deseja pesquisar os atributos.

▪ Categoria
Selecione a categoria das transferências na qual deseja pesquisar os atributos.
Se valores para múltiplas configurações forem especificados, a pesquisa retornará apenas os
atributos que atendam a todas as configurações especificadas.
4. Clique em Pesquisar para recuperar os atributos correspondentes na tabela Resultados da
pesquisa.
Os resultados podem ser limitados ainda mais para listar apenas os atributos que
correspondem ao texto inserido no campo Resultados da pesquisa.
5. Clique em OK.
Os resultados são exibidos no visualizador e na árvore do navegador. Para obter mais
informações sobre como trabalhar com resultados de pesquisa, consulte Gerenciar
resultados da pesquisa.

Tendências no PI System Explorer

Ao procurar elementos no PI System Explorer, é possível criar rapidamente tendências simples
para verificar as fórmulas, cálculos e outras medidas que você está criando no PI AF. Por
exemplo, enquanto você está projetando uma fórmula do PI AF, você pode desejar verificar os
resultados das últimas horas. Ou, se estiver criando atributos de ponto PI que envolvam
resumos, pode ser útil verificar como eles estão nas últimas horas.
Você pode adicionar atributos PI 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 as horas de início e de término 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. É possível também clicar com o botão
direito no cursor de tendência e selecionar comandos de um menu de contexto.
É possível também verificar uma tendência de um atributo quando você visualiza os dados das
séries cronológicas (clicando com o botão direito em um atributo e clicando em Dados de

74 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

séries cronológicas). A tendência é mostrada automaticamente na parte inferior da janela

Dados de cronológica.

Criar tendências
Para verificar fórmulas, cálculos e outras medidas em PI AF, crie uma tendência.

Antes de Iniciar
A OSIsoft recomenda usar ferramentas de visualização, como o PI Vision, o PI ProcessBook e o
PI WebParts para criar e salvar as tendências que você planeja usar mais de uma vez.

Procedimento
1. No menu PI System Explorer, selecione Visualizar > Mostrar tendência.
2. Na janela Tendência, escolha uma das ações a seguir.
Para... Faça o seguinte...
Adicionar um atributo à tendência a. Clique em Adicionar atributos.
b. Na janela Pesquisa de atributo, especifique os
parâmetros de pesquisa nos campos Nome
do atributo, Categoria do atributoe em
outros campos para localizar o atributo de
interesse.
c. Expanda a hierarquia de elementos na área
Resultados da pesquisa e selecione o atributo.
d. 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).
Ajuste a duração Especifique as horas nos campos Hora de início e
Hora de término.
Adicionar um ponto PI à tendência a. Clique em Adicionar pontos PI.
b. Na janela Pesquisa da tag, pesquise o ponto PI
que deseja verificar e selecione-o nos
resultados.
c. Clique em OK.
O ponto PI é adicionado à tendência.
Ajuste quais rastreios são visíveis na tendência Clique em Linhas e desmarque a caixa de seleção
de atributos ou pontos que não deseja ver.

3. Adicione quaisquer atributos PI 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.
É possível arrastar atributos e pontos PI de outros resultados da pesquisa e soltá-los na
tendência para adicioná-los. Como alternativa, é possível clicar com o botão direito em um
atributo ou ponto e clicar em Adicionar à tendência.

Gerenciamento de versão para 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 ocorreu uma alteração, é recomendável criar uma

Guia do Usuário do PI System Explorer 75

Recuperação de informações sobre ativos

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.
Você pode também indicar um elemento, modelo ou tabela que não está no serviço após uma
data específica selecionando essa data como sua data obsoleta.

Vídeos
Para obter uma visão geral do gerenciamento de versões, assista a este vídeo:
https://www.youtube.com/watch?v=8cHFHW1SID0
Para obter informações sobre como criar versões de elementos e tabelas, assista a este vídeo:
https://www.youtube.com/watch?v=j2ilXV2XmV0

Nesta seção
• Criar versões para elementos ou modelos
• Criar versões de tabela
• Comparar duas versões

Criar versões para elementos ou modelos

Crie uma nova versão quando precisar rastrear as alterações em um ativo.

Antes de Iniciar
A criação de uma nova versão faz um check-in no elemento ou no modelo.

Procedimento
1. No navegador, clique em Elementos e selecione o elemento ou o modelo cuja versão deseja
criar no navegador de Elementos.
2. Clique na guia Versão no visualizador e clique em Nova versão. (Também é possível clicar
com o botão direito no elemento ou no modelo no navegador e selecionar Criar versão.)
3. Na janela Criar versão, insira uma Data efetiva para a versão ou clique em para
selecionar uma e clique em OK. O PI System Explorer criar uma nova versão.

Criar versões de tabela

Crie uma nova versão quando precisar rastrear as alterações em uma tabela.

Antes de Iniciar
A criação de uma nova versão faz o check-in na nova tabela.

Procedimento
1. No navegador, clique em Biblioteca e selecione a tabela cuja versão deseja criar no
navegador de Biblioteca.
2. Clique com o botão direito na coleção Tabelas e clique em Nova tabela.

76 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

3. Clique na guia Versão no painel do visualizador e clique em Nova versão. (Também é

possível clicar com o botão direito no elemento ou no modelo no navegador e selecionar
Criar versão.) .
4. Na janela Criar versão, insira uma Data efetiva para a versão ou clique em para
selecionar uma e clique em OK. O PI System Explorer criar uma nova versão.

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.

Exibição de 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 versões
anteriores e todos os objetos que tenham uma data Obsoleta especificada (mesmo que essa
data esteja no futuro). Como resultado, quando uma data Obsoleta é especificada para um
objeto e tem check-in feito, ela imediatamente desaparece do PI System Explorer.
No entanto, é possível localizar e visualizar um objeto obsoleto ou uma versão particular de um
objeto configurando Data da consulta para um tempo fixo no qual o objeto ou a versão seja
atual. Para exibir um elemento que se tornou efetivo em 1º de janeiro de 2010 e obsoleto em 1º
de janeiro de 2011, por exemplo, configure Data da consulta para qualquer momento entre
essas duas datas.

Vídeo
Para obter informações sobre como exibir versões diferentes, assista a este vídeo:
https://www.youtube.com/watch?v=MwFrhzjPrns

Nesta seção
• Data da consulta e horário PI System Explorer
• Mostrar datas e horas específicas
• Contexto de tempo para valores do atributo

Data da consulta e horário PI System Explorer

Data da Consulta determina os valores de tempo que o PI System Explorer usa para:

Guia do Usuário do PI System Explorer 77

Recuperação de informações sobre ativos

• 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 datas e horas específicas

Ao definir a 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.
2. Na janela Seletor de data e hora, escolha a data e hora. Para definir uma data de consulta
como a data e hora atuais, clique no botão Definir para agora.

78 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

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, selecione a opção Definir para mais recente.
3. Clique em OK.

Vídeo
Para obter informações sobre como configurar uma data de consulta específica, assista a este
vídeo:
https://www.youtube.com/watch?v=_381ZTzkFo4

Contexto de tempo para valores do atributo

O tempo ou intervalo de tempo que o PI System Explorer usa para exibir valores de atributo é
determinado pelos valores configurados na janela 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 na janela
Definir contexto de tempo.
As configurações de tempo e intervalo de tempo na janela 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.

Configurar o contexto de tempo para os valores de atributo exibidos

Alguns valores de atributo refletem um intervalo de tempo, por exemplo, a média dos valores
do ponto na última hora. Você pode usar Definir contexto de tempo para especificar um
intervalo de tempo diferente para os valores de atributo exibidos.

Procedimento
1. Na barra de ferramentas do PI System Explorer, clique em .
Como alternativa, clique em Ferramentas > Opções e selecione a guia Contexto de tempo.
2. Na janela Definir contexto de tempo, selecione uma das opções a seguir. 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.
Horário 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.

Guia do Usuário do PI System Explorer 79

Recuperação de informações sobre ativos

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/hora da consulta definida para Disponibilizado por último.
4. Clique em Aplicar para ver as alterações e em OK para salvá-las.

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 visualizar como suas configurações de referência
de dados funcionarão com seus dados coletados em outras ferramentas cliente do PI, como o PI
ProcessBook, o PI Vision, o PI DataLink e o PI WebParts.
Nota:
Algumas configurações de atributo não aceitam esses tipos de dados. Consulte Restrições
na visualização dos dados da série cronológica.

Procedimento
1. Clique com o botão direito no atributo no visualizador e clique em Dados de série
cronológica.
2. Na janela Dados de séries cronológicas, escolha a guia que representa os tipos de dados que
você deseja ver:
◦ Archive
Para pontos PI. Mostra os valores arquivados na hora especificada. As configurações
incluem Tipo de limite e Expressão de filtro.
◦ Amostragem
Retorna valores interpolados e uniformemente espaçados em um intervalo regular. Você
pode incluir uma Expressão de filtro.
◦ Gráfico
Recupera valores no intervalo de tempo especificado, adequado para gráficos em um
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 Estatísticas de resumo para valores de atributo que aceitam esse recurso. Você
pode especificar a Ponderado.
◦ Pipe de dados
Permite monitorar e exibir alterações nos dados dos atributos. Para os atributos com
suporte a dados futuros, você pode especificar como o pipe de dados retornará os dados
com o Modo de horizonte de evento e as propriedades de offset. Para as guias históricas,
o modo Horizonte de eventos não tem efeito.

Nesta seção
• Tipo de limite
• Expressão de filtro
• Estatísticas
• Ponderado
• Modo de horizonte de evento
• Restrições na visualização dos dados da série cronológica

80 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

• Abreviações de configuração do atributo

Tipo de limite
Especifique um tipo de limite para determinar como as pesquisas 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 ocorridos nas horas inicial e final, se existirem, ou os valores mais próximos
dentro do intervalo.
• Fora
Retorna os valores mais próximos ocorridos imediatamente fora do intervalo.
• Interpolado
Retorna valores interpolados nas horas inicial e final.

Expressão de filtro
Adicione uma expressão de filtro para filtrar valores de eventos 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 do cálculo. Também é possível usar uma PI

Performance Equation válida na expressão de filtro para criar expressões mais complexas com
o fim de remover picos atípicos em valores de dados, por exemplo.
Variáveis de expressão são limitadas a atributos ou pontos PI originados de um único PI Data
Archive. Atributos resolvidos para um valor estático (nenhuma referência de dados
configurada) também são aceitáveis. Consulte Referências indiretas do ponto do PI 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 que está sendo consultado.
‘Level’ Referência ao atributo Level no mesmo nível de
hierarquia do atributo no elemento ou estrutura de
evento.
‘..’ Referência ao atributo pai de um atributo que está
sendo consultado. Válido apenas para atributos filhos
alojados.
‘.|HighLimit’ Referência ao atributo filho HighLimit do atributo que
está sendo consultado.
‘|Temperature’ Referência ao atributo Temperature no nível de
hierarquia superior no elemento atual ou estrutura de
evento.
‘\\MyPIServer\sinusoid’ Caminho absoluto para um ponto PI. Ele deve estar no
mesmo PI Data Archive do atual atributo consultado.
‘\\myAFServer\myDatabase\myElement| Caminho absoluto para um atributo PI AF.
myAttribute’

Guia do Usuário do PI System Explorer 81

Recuperação de informações sobre ativos

Expressão de filtro Função

‘\myRootElement|myAttribute’ Caminho relativo do banco de dados para um atributo
PI AF.

Exemplos de variável do ponto PI

Expressão de filtro Função
‘.’ Referência ao ponto PI que está sendo consultado.
‘sinusoid’ Referência ao ponto PI sinusoid no mesmo PI Data
Archive.

Estatísticas
A guia Resumo fornece as seguintes estatísticas para os atributos que as suportam:

• Percentual válido
Exibe a porcentagem de tempo no qual valores válidos são retornados no intervalo de
tempo total. Valores válidos são valores de evento determinados como válidos e sem estado
de erro.
• Média
Calcula a média dos 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 no intervalo.
• Desvio padrão
Calcula o desvio padrão dos valores no intervalo.
• Desvio padrão do preenchimento
Calcula o desvio padrão do preenchimento dos valores durante o intervalo.
• Contagem
Retorna o número de valores armazenados durante o intervalo.

Ponderado
A guia Resumo permite selecionar a Ponderação para os cálculos estatísticos:

• Ponderado no tempo
Padrão. Pondera cada valor do evento pelo comprimento de tempo ao qual ele é aplicado.
• Contínuo ponderado no tempo
Pondera o tempo dos valores, mas faz toda a interpolação entre os valores como se eles
representassem dados contínuos (interpolação padrão), independentemente de o atributo
ser ou não nivelado.
• Descontínuo ponderado no tempo

82 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Pondera o tempo dos valores, mas faz toda a interpolação entre os valores como se eles
representassem dados descontínuos e não relacionados (gráfico de escada),
independentemente de o atributo ser ou não nivelado.
• Ponderado em eventos
Pondera cada evento igualmente. 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:
◦ usar os eventos em ambos os limites quando houver somente um intervalo de cálculo
◦ incluir os eventos na hora de início quando houver vários intervalos e eles estiverem em
ordem crescente de tempo
◦ incluir os eventos na hora de término quando houver vários intervalos e eles estiverem
em ordem decrescente de tempo
• Ponderado em eventos – Excluir evento mais antigo
EventWeighted, exceto que o evento na hora de início (primeira hora) de um intervalo não é
usado nesse intervalo.
• Ponderado em eventos – 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.
• Ponderado em eventos – Incluir ambos os términos:
Eventos nas duas extremidades dos limites do intervalo estão inclusos nos cálculos de
evento ponderado.

Modo de horizonte de evento

O modo de horizonte de evento controla quando os eventos para os atributos que suportam
dados futuros são retornados no canal de dados PI AF. Os valores possíveis são descritos na
tabela a seguir.
Valor Descrição
Final do fluxo Os eventos são retornados como foram criados,
sem levar em conta a hora atual.
Time Offset Os eventos são retornados apenas depois de
atravessar o offset de tempo relativo, de agora
para o futuro.
Por exemplo, com um offset de tempo zero, as
alterações de dados de tag do futuro não são
retornadas até que o timestamp seja menor ou
igual à hora atual.
Offset de tempo com evento externo Os eventos são retornados apenas se ocorrerem
antes do offset de tempo relativo para o futuro, ou
se for o próximo evento que atravessaria este
horizonte temporal.
Por exemplo, com um offset de tempo de uma hora,
as alterações de dados de tag do futuro são não
retornadas até o seu timestamp seja menor ou
igual à hora atual mais uma hora, ou se for o
próximo evento conhecido após o horizonte
temporal de uma hora. Esse modo é útil para a
calcular tendência dos dados no futuro.

Guia do Usuário do PI System Explorer 83

Recuperação de informações sobre ativos

Restrições na visualização dos dados da série cronológica

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, incluindo o PI
DataLink, o PI Vision, o PI ProcessBook e o PI WebParts.
Para obter uma descrição das abreviações de configuração de atributo no título da tabela e
para obter definições de cada tipo de configuração de atributo, consulte Abreviações de
configuração do atributo.
Função PI PI-Arc PI-Rel PI-TR PI-TR- NO- F CC CTS
Rel DR
InterpolatedValue OptIn Código
InterpolatedValues OptIn Código
InterpolatedValuesAtTimes OptIn Código
RecordedValue OptIn Código
RecordedValues OptIn Código
RecordedValuesAtTimes OptIn Código
RecordedValuesByCount OptIn Código
Async OptIn Código
PlotValues OptIn Código
Resumo OptIn Código
Resumos OptIn Código
FilteredSummaries Código
UpdateValue Código
UpdateValues Código
Anotações Código
Filtros Código
AFDataPipe OptIn Código

Abreviações de configuração do atributo

Esta tabela define as abreviações de configuração do atributo usadas em Restrições na
visualização dos dados da série cronológica.
Abreviação Significado Descrição
PI Ponto PI configurado de maneira Nenhuma configuração adicional
simples é necessária. TimeMethod é
Automático, Interpolado ou
AtOrBefore.
PI-Arc Ponto PI especificado pela TimeMethod é Antes, Exato,
recuperação de archive AtOrAfter, Após.
PI-Rel Ponto PI de tempo relativo Ponto PI configurado de maneira
simples com tempo relativo
configurado. TimeMethod é
Automático, Interpolado ou
AtOrBefore.

84 Guia do Usuário do PI System Explorer

 Recuperação de informações sobre ativos

Abreviação Significado Descrição

PI-TR Ponto PI apenas do intervalo de
tempo
PI-TR-Rel Intervalo de tempo com tempo
relativo
No-DR Nenhuma referência de dados
F Referência de dados com base
em cálculo com entradas de
séries cronológicas, como
fórmula, String Personalizado e
URI Builder.
CC Referência de dados
personalizada baseada em
cálculo
CTS Referência de dados
personalizada que gera seus
próprios dados de série
cronológica
TimeMethod não é suportado.
TimeMethod é configurado para
TimeRange ou
TImeRangeOverride.
A referência de dados está
configurada como Nenhum.
Se não houver nenhuma entrada,
o comportamento será
semelhante a No-DR.
OptIn indica que uma referência
de dados personalizada pode ser
gravada com um determinado
método, para declarar quais
atributos ela usa como entradas,
e como outro método, que
transforma as entradas em
saídas. Com o suporte da entrada,
o AF SDK usa esses métodos para
emular os outros, usando uma
série cronológica gerada com os
dados de entrada.
Code indica que o código é
necessário para cada método, se
a série cronológica vier do
sistema de registros ao qual está
sendo feita a conexão.

Guia do Usuário do PI System Explorer 85

Recuperação de informações sobre ativos

86 Guia do Usuário do PI System Explorer

Organização dos modelos de ativos no PI AF
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 PI AF elementos são
organizados em uma estrutura de árvore. 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.
Também é possível organizar por meio de categorias para agilizar e simplificar a busca e
pesquisa de informações. Pense nas categorias como rótulos que podem ser aplicados aos
objetos PI AF. Cada objeto pode ter várias categorias.
Nota:
Também é possível organizar ativos em um processo. Consulte Processar modelos no PI
AF.

Nesta seção
• A estrutura dos modelos de ativo do PI AF
• O design das hierarquias de ativos do PI AF
• Referências do elemento na hierarquia de ativos
• Categorização de objetos

A estrutura dos modelos de ativo do PI AF

Os objetos do PI AF são organizados em uma estrutura de árvore, semelhante à estrutura de
arquivos em um computador com Windows. No Windows, em vez de ter milhares de arquivos
no desktop, normalmente os arquivos são agrupados em pastas. O mesmo conceito se aplica
aos elementos do PI AF. Organizar elementos em hierarquias facilita a navegação dos
elementos e fornece insights sobre como os elementos se relacionam entre si.
Quando você cria um modelo de ativo, você precisa decidir sobre a estrutura que permitirá aos
usuários localizar ativos diferentes com facilidade. Considere quem são seus usuários e o que
eles procuram. 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.

Modelo de ativo organizado por tipo de equipamento

Por outro lado, se você tiver várias fábricas em locais diferentes, o mesmo engenheiro de
manutenção poderá querer ver todos os equipamentos localizados na própria fábrica. A
ilustração a seguir mostra os mesmos elementos organizados por planta.

Guia do Usuário do PI System Explorer 87

Organização dos modelos de ativos no PI AF

Modelo de ativo organizado por local

Você não está restrito a apenas uma estratégia organizacional. Você pode usar uma referência
de elemento para incluir o mesmo ativo em mais de um lugar 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, você pode dispor a organização do equipamento sob a organização

geográfica.

O design das hierarquias de ativos do PI AF

O objetivo é criar uma hierarquia de ativos (elementos) que fará sentido para as pessoas que
precisarem usá-la. Se houver diferentes tipos de usuários, talvez seja necessário criar a mais de
uma estrutura de árvores.
Se você acabou de começar, não tente fazer tudo de uma 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.

88 Guia do Usuário do PI System Explorer

 Organização dos modelos de ativos no PI AF

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. Como opção, você pode organizar a árvore por tipo de
equipamento e, depois, 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 Vision expõe a árvore para os usuários que pesquisam
ativos relacionados. No PI Vision, os ativos relacionados são elementos criados com o
mesmo template.

Vídeos
Para obter informações sobre como criar elementos, assista a este vídeo:
https://www.youtube.com/watch?v=d-kPQGabJuY
Para obter informações sobre como criar hierarquias de elementos, assista a este vídeo:
https://www.youtube.com/watch?v=hpiQSzubDu8

Referências do elemento na hierarquia de ativos

Podem-se usar referências de elemento para adicionar mais de uma vez o mesmo elemento à
hierarquia de elementos, conforme descrito em A estrutura dos modelos de ativo do PI AF. 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 única referência de elemento
• Criar várias referências de elemento
• Localizar outras referências no mesmo elemento
• Alterar tipos de referência
• Criação de tipos de referência personalizada

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. O
PI AF fornece três tipos de referência definidos pelo sistema:

• Pai-filho
• Composição
• Referência fraca

Guia do Usuário do PI System Explorer 89

Organização dos modelos de ativos no PI AF

Também é possível criar tipos de referência personalizada, como descrito em Criação de tipos
de referência personalizada e Templates filhos.

Vídeos
Para obter informações sobre como usar tipos de referência, assista a este vídeo:
https://www.youtube.com/watch?v=OL43oUyuFEI
Para obter informações sobre como criar tipos de referência personalizados, assista a este
vídeo:
https://www.youtube.com/watch?v=VcXsWfUEYQ8
Para saber a conclusão do exemplo de tipo de referência, assista a este vídeo:
https://www.youtube.com/watch?v=Vwta8GG4Jgk

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. O tipo de referência é forte, uma vez que permite que o
elemento filho tenha muitos pais e exista enquanto tiver um ou mais pais fortemente
relacionados. O elemento filho somente será excluído quando o seu último elemento pai for
excluído. Use o tipo de referência pai-filho quando deseja que o elemento filho exista enquanto
seu tipo de referência for forte para pelo menos um pai, mas não deseja que o elemento filho
seja tratado 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 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 terá uma
referência pai-filho com o elemento da companhia. Se ele também for removido da companhia,
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 do sensor para fazer uma alteração,
também será feito check-out do outro elemento do sensor e do elemento do medidor juntos.

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

90 Guia do Usuário do PI System Explorer

 Organização dos modelos de ativos no PI AF

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 única referência de elemento

Crie uma única referência de elemento para estabelecer uma relação hierárquica entre dois
elementos.

Procedimento
1. No navegador de Elementos, clique no elemento que deseja referenciar e arraste-o para o
elemento pai apropriado.
2. Na janela Escolher tipo de referência, 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 referenciado
indica que eles são referências.

Vídeo
Para obter informações adicionais sobre como criar um tipo de referência de elemento, assista
a este vídeo:
https://www.youtube.com/watch?v=Q1kK71JrhLo

Criar várias referências de elemento

Crie múltiplas referências de elemento para estabelecer uma relação entre um elemento e
outros elementos na hierarquia.

Procedimento
1. No navegador de Elementos, clique com o botão direito em um elemento e clique em Novo >
Adicionar referências de elemento.
Observe que também é possível selecionar um elemento e arrastá-lo para o pai.
2. Na janela Adicionar elemento(s), clique no botão Localizar múltiplos elementos.
3. Na janela Pesquisar elemento, 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.
5. Na janela Adicionar elementos, 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 referenciado
indica que eles são referências.

Guia do Usuário do PI System Explorer 91

Organização dos modelos de ativos no PI AF

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 de Elementos.
2. Na guia Geral, clique no link Pais.
Os pais do elemento são exibidos na janela Parents de Element.
3. Clique em Fechar.

Alterar tipos de referência

É possível alterar o tipo de referência de um elemento filho e um event frame que tem pelo
menos um pai na hierarquia e não está no nível raiz da hierarquia (onde o tipo de referência
deve ser pai-filho).

Procedimento
1. Escolha uma das seguintes ações:
Para... Faça o seguinte...
Alterar um tipo de referência de elemento filho a. No navegador, selecione Elementos.
b. No navegador, expanda a árvore Elementos e
localize o elemento filho com mais de um pai.
c. Clique com o botão direito no elemento filho
e clique em Converter > Alterar tipo de
referência.
Alterar um tipo de referência de event frame a. No navegador, selecione Estruturas de
filho evento.
b. No navegador, expanda a árvore de estrutura
de evento e localize a estrutura de evento
filho com mais de um pai.
c. Clique com o botão direito na estrutura de
evento filho e clique em Converter > Alterar
tipo de referência.

2. Na janela Alterar tipo de referência, selecione um pai na lista Pai.

3. Selecione um novo tipo de referência na lista Novo tipo de referência. Somente os tipos de
referência válidos para o pai selecionado estão disponíveis.
4. Para estabelecer o pai selecionado como o pai primário (quando o tipo de referência
selecionado for válido), marque a caixa de seleção Pai principal.
Nota:
Para ser válido, o tipo de referência escolhido deve ser forte e nenhuma referência de
composição pode ser definida para o elemento ou event frame.
5. Clique em OK.

92 Guia do Usuário do PI System Explorer

 Organização dos modelos de ativos no PI AF

Criação de 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 PI AF oriente os usuários
quando eles criam novos elementos. Consulte Templates filhos para obter informações sobre a
criação de referências de template.

Criar tipos de referência personalizadas

Tipos de referência personalizados são criados em templates filhos. Você também pode criá-los
para definir a sua própria hierarquia de elementos usando uma relação mais específica. Os
tipos de referência personalizados devem ser baseados em um dos tipos de referência
predefinidos.

Procedimento
1. No navegador de Biblioteca, clique com o botão direito na coleção Tipos de referência e
selecione Novo tipo de referência.
2. No campo Nome, insira um nome para o tipo de referência.
3. Nos campos Nome do filho e Nome do pai, insira nomes para o filho e o pai.
4. Opcional. No campo Categorias, clique em e selecione uma ou mais categorias às quais o
tipo de referência pertence, na janela Categorizar. Você também pode inserir uma ou mais
categorias de tipo de referência diretamente, separadas por um ponto e vírgula.
5. No campo Força da referência, selecione Forte, Fraco ou Composição na lista. Consulte Tipos
de referência para obter as definições de forças do tipo de referência.
6. Nos campos Template de elemento pai permitido e Template de elemento filho permitido,
selecione na lista um ou mais templates aos quais os filhos e os pais do tipo de referência
pertencem. Você também pode inserir os templates diretamente, separados por um ponto e
vírgula.
Nota:
É possível criar tipos de referência com mais rapidez na coleção Templates de
elemento usando os templates de referência (consulte Criar referências de template
filho).

Categorização de objetos
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 suporta os seguintes tipos de categorias:

Guia do Usuário do PI System Explorer 93

Organização dos modelos de ativos no PI AF

• Análise
• Atributo
• Elemento
• Regra de notificação
• Tipo de referência
• Tabela

Vídeos
Para obter informações sobre como criar categorias, assista a este vídeo:
https://www.youtube.com/watch?v=ux3qiQVSePU
Para obter informações sobre como atribuir categorias, assista a este vídeo:
https://www.youtube.com/watch?v=5wkvG-1jOgM
Para obter informações sobre como agrupar por categoria, assista a este vídeo:
https://www.youtube.com/watch?v=A0OlJZ19qWA

Nesta seção
• Criar novas categorias
• Atribuir objetos a categorias

Criar novas categorias

Criar categorias para tipos de objetos específicos. Como alternativa, use o PI Builder para criar
várias categorias com base em uma planilha do Excel.

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, em Categorias, clique com o botão direito no tipo de objeto de
categoria e selecione Nova categoria.
3. Na janela Object_TypeCategory Properties (Propriedades da categoria), insira um nome para
a categoria no campo Nome.
4. Opcional. Insira uma descrição da categoria no campo Descrição.
5. Clique em OK.
6. Opcional. Clique no link Segurança se desejar configurar as permissões de acesso
personalizadas para a categoria além das que já estão estabelecidas no nível do banco de
dados, servidor ou coleção. Para obter mais informações, consulte Configurar segurança
para objetos.

Atribuir objetos a categorias

Atribua objetos às categorias que você criou para cada tipo de categoria.

Procedimento
1. No visualizador, use as teclas padrão do Windows para destacar objetos contíguos (SHIFT
+<click>) ou não contíguos (CTRL+<click>) que deseja classificar.
2. Clique com o botão direito e selecione Categorizar.

94 Guia do Usuário do PI System Explorer

 Organização dos modelos de ativos no PI AF

3. Na janela Categorizar, selecione uma ou mais categorias a serem atribuídas aos objetos
selecionados.
a. Se a categoria necessária não estiver na lista, clique no botão Nova Categoria.
b. Na janela Atribuir propriedades das categorias, crie a nova categoria e clique em OK.
4. Clique em OK. As categorias são aplicadas e exibidas no campo Categorias no painel de
configuração para cada objeto.
a. Se qualquer objeto selecionado for criado a partir de templates, você pode modificar o
template ou não adicionar a categoria a esse objeto em particular.

Escolha uma das seguintes opções:

▪ Clique Modificar o template e adicionar a categoria para modificar todos os atributos
derivados do template com a categoria.
▪ Clique em Não adicionar categoria para impedir que a categoria seja atribuída ao
objeto.
b. Para aplicar a opção a outros atributos selecionados que são derivados dos templates,
marque a caixa de seleção Aplicar opção aos templates restantes.
c. Clique em OK.

Guia do Usuário do PI System Explorer 95

Organização dos modelos de ativos no PI AF

96 Guia do Usuário do PI System Explorer

Representação de ativos no PI AF
Cada objeto físico incluído no modelo é representado por um elemento do 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 do ponto PI, uma fórmula, um valor de um banco de dados
relacional externo e muito mais.

Templates
É possível criar cada elemento individualmente, mas a OSIsoft recomenda basear os elementos
individuais em um template de ativo que represente o tipo de equipamento. Os templates de
elemento permitem:
• Configurar o template apenas uma vez, eliminando a necessidade de configurar
individualmente cada elemento com base no template.
• Atualizar a estrutura de elementos em todos os elementos pertencentes ao template.
• Manter a consistência no modelo do ativo.
• Ativar recursos poderosos nos aplicativos cliente do PI AF.

Nesta seção
• Representação de ativo com templates
• Estratégia de template
• Templates de elemento
• Templates filhos
• Representação de ativo com elementos
• Armazenamento de informações específicas de aplicativo

Representação de ativo com templates

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. É possível 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.

Guia do Usuário do PI System Explorer 97

Representação de ativos no PI AF

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:
É possível também criar templates para estruturas de evento, transferências, modelos e
notificações.

Estratégia de template
Em quase todo caso, a melhor opção é basear os elementos em templates. Você não apenas
economiza tempo, mas também garante uma definição consistente entre 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.

Templates base
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 amplitude com a qual você define o template, talvez você perceba que a lista de
atributos é levemente diferente para subconjuntos de ativos diferentes. Nessa situação, use um
template base (para obter mais informações, consulte Templates base). A alternativa é usar um
template diferente para cada subconjunto de ativos.

Extensões
Você também pode configurar templates de elementos para incluir atributos (bem como
categorias e portas) que não sejam definidos ou mantidos pelo template (para obter mais
informações, consulte Extensões). É possível adicionar atributos simples e específicos aos
ativos sem a necessidade de adicioná-los em todas as instâncias do template.
Nota:
Análises e notificações não são afetadas pelo fato de a caixa de seleção Permitir extensões
estar ou não habilitada.

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.

98 Guia do Usuário do PI System Explorer

 Representação de ativos no PI AF

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.

Vídeo
Para obter informações sobre como criar templates de elementos, assista a este vídeo:
https://www.youtube.com/watch?v=VYWXctstVg0

Nesta seção
• Atributo padrão
• Templates base
• Extensões
• Criar templates de elemento
• Localizar referências de template
• Definir templates para outros objetos

Atributo padrão
O atributo padrão é um atributo que é mais representativo do elemento. Por exemplo, se um
usuário tivesse feito referência de um tanque, talvez Level seria o melhor atributo individual a
ser usado. Para um medidor elétrico, o melhor atributo a ser usado poderia ser Voltage. O
atributo deve estar no nível superior da hierarquia de atributos do elemento.
Notificações e Asset Analytics podem usar o atributo padrão para simplificar algumas tarefas.
Por exemplo, se uma comparação entre dois medidores elétricos fosse criada e os atributos a
serem comparados não tivessem sido especificados, a comparação seria realizada usando o
atributo Voltage dos medidores, pois o atributo Voltage tornou-se o atributo padrão.

Templates base
Um template base é melhor empregado ao modelar elementos que compartilhem a maioria dos
atributos, mas tenham alguns atributos diferentes. Um template base transmite todos os seus
atributos (bem como portas e análises) para qualquer template criado a partir dele. Quando
um elemento é criado posteriormente desses templates, esse elemento contém não somente
cada atributo (bem como portas e análises) do template base, mas também aqueles do
template derivado.

Exemplo de template base

Suponha que exista um conjunto de tanques, alguns com duas válvulas e alguns com uma
válvula, é possível criar um template de elemento para os templates com uma válvula e usá-lo
como o template base para os templates derivados que foram criados para os modelos com
duas válvulas. Ao criar objetos com base no modelo com duas válvulas, eles herdam todos os
atributos do modelo com uma válvula, assim como quaisquer atributos extras definidos para o
modelo de duas válvulas.

Guia do Usuário do PI System Explorer 99

Representação de ativos no PI AF

Templates derivados
Um template base é definido com a seleção de uma lista de Template base na guia Geral do
template de elemento que está sendo definido, ou é possível clicar com o botão direito em um
template de elemento que já esteja sendo exibido no navegador de Biblioteca e clique em Novo
> Novo template derivado. O novo template é imediatamente adicionado ao navegador de
Biblioteca com um novo nome Base_TemplateDerivado1. É possível, então, redefinir a
definição, incluindo o nome, conforme descrito em Criar templates de elemento.
Dica:
Para impedir que um template de atributo que foi herdado de um template base seja
visível para os usuários ou um aplicativo cliente como o PI Vision, crie um template de
atributo com o mesmo nome no template derivado e selecione Excluído como sua
configuração de Propriedades. Para obter mais informações, consulte Propriedade do
atributo excluído.

Herança de template
Por padrão, os templates de elemento são organizados por nome no navegador de Biblioteca.
Para determinar a relação que existe entre os templates, é possível organizá-los por herança de
template. Você pode clicar com o botão direito na coleção Templates de elemento e clicar em
Organizar por > Organizar por herança. Expanda templates com ao lado deles para revelar
templates derivados.

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.
Nota:
Se houver um template que permita extensões, e ele for alterado mais tarde para cancelar
a permissão das extensões, nenhum outro atributo de elemento estendido novo poderá
ser adicionado aos elementos baseados nesse template. No entanto, todos os atributos de
elemento estendidos serão mantidos.
As extensões permitem flexibilidade em casos nos quais ativos sejam semelhantes em muitas
áreas, mas haja diversas 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, um volante 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 destinam-se a lidar com esse tipo de variação.
Quando as extensões são habilitadas, é possível basear todos os elementos em um template,
enquanto adiciona mais informações a cada elemento, conforme necessário. No entanto, 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:
Análises e notificações não são afetadas pelo fato de a caixa de seleção Permitir extensões
estar ou não habilitada.

100 Guia do Usuário do PI System Explorer

 Representação de ativos no PI AF

Criar templates de elemento

Crie e configure um template de elemento para garantir definições consistentes para elementos
na estrutura do ativo.

Procedimento
1. No navegador de Biblioteca, clique com o botão direito na coleção Templates de elemento e
clique em Novo template.
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:

◦ Template base
É possível basear o template em um template existente. Selecione o template base na
lista.

◦ Tipo
Selecione Elemento a menos que esteja trabalhando com modelos. Para obter mais
informações, consulte Tipos de elemento em modelos.

◦ Categorias
Opcional. Podem-se organizar objetos agrupando-os em categorias. Para navegar nas
categorias disponíveis, clique em . Consulte Atribuir objetos a categorias.

◦ Atributo padrão
Opcional. Selecione um atributo padrão na lista suspensa. Consulte Atributo padrão.

◦ Padrão de nomeação
Opcional. Se deixado em branco, o PI System Explorer usa o campo Nome do template do
elemento e adiciona um asterisco para adicionar um número incremental, conforme
necessário.
É possível inserir uma string de texto ou clicar em para escolher parâmetros de
substituição para definir um padrão de nomenclatura. Cada elemento derivado do
template terá um nome único e identificável. Para garantir que os novos elementos
criados do template tenham um número incremental, insira * no final de qualquer
padrão que você inserir aqui.
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 no elemento e clique em Reavaliar
padrão de nomenclatura.
Nota:
O nome gerado pelo padrão de nomenclatura deve ser inferior ao comprimento
máximo de 260 caracteres.

◦ Permitir extensões
Marque esta caixa de seleção para permitir que atributos adicionais (bem como as
categorias e portas) sejam definidos para um elemento, além daqueles definidos no
template. Consulte Extensões.

Guia do Usuário do PI System Explorer 101

Representação de ativos no PI AF

Nota:
Análises e notificações não são afetadas pelo fato de a caixa de seleção Permitir
extensões estar ou não habilitada.

◦ Propriedades estendidas
Este link é um recurso avançado. Para obter mais informações, consulte Armazenamento
de informações específicas de aplicativo.

◦ Localização
Clique nesse link se deseja configurar características de atributo de localização para o
elemento. No entanto, você também pode configurá-las em um atributo, se preferir.
Observe que você só pode atribuir um conjunto de atributos de localização por elemento.
Para obter mais informações, consulte Características de atributo.

◦ Segurança
Clique neste link se quiser configurar as permissões de acesso personalizado para o
template do elemento, além das que já estão estabelecidas no nível do servidor e do
banco de dados. Para obter mais informações, consulte Configurar segurança para
objetos.
3. Use a guia Templates de atributo para criar um template de atributo para cada propriedade
ou item de dados do template. Consulte Criar templates de atributo.
4. Se estiver criando um modelo, 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 Processar
modelos no PI AF.
5. Opcional. Clique na guia Templates de análise para criar um template de análise para o
template de elemento. Para obter mais informações, escolha uma das seguintes opções:
◦ Para criar um template de análise de expressão, consulte Criar um template de análise da
expressão.
◦ Para criar um template de análise de somatório, consulte Criar um template de análise de
somatório.
◦ Para criar um template de análise de geração da estrutura de evento, consulte Criar um
template de análise de geração da estrutura de eventos.
◦ Para criar um template de análise de SQC, consulte Criar um template de análise SQC.
6. Opcional. Use a guia Templates de regra de notificação para selecionar ou criar um template
de regra de notificação para o template de elemento. Para obter mais informações, consulte
Criar um template de regra de notificação.
7. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Localizar referências de template

Localize onde um template é usado no PI System Explorer.

Procedimento
1. No navegador de Biblioteca, escolha uma das seguintes opções:
◦ Para localizar um template de elemento, expanda Templates > Templates de elemento e
selecione um template.
◦ Para localizar um template de estrutura de evento, expanda Templates > Templates de
estrutura de evento e selecione um template.
2. Escolha uma das seguintes opções:

102 Guia do Usuário do PI System Explorer


Para localizar...
Templates derivados
Elementos criados do template
Elementos derivados do template
Templates pais referenciados
Templates filhos referenciados
Representação de ativos no PI AF
Faça o seguinte...
Clique em Templates derivados.
A janela Encontrar Padrões Derivados para
Element_Template mostra todos os templates de
elementos que tenham o template de elemento
selecionado como seu template base. A lista
também inclui os templates de elemento
indiretamente derivados pelo template
selecionado, por vários templates.
Clique em Elementos.
A janela Find Elements for (Encontrar elementos
para) Element_Template mostra todos os
elementos, modelos, transferências e event
frames que foram criados diretamente do
template de elemento selecionado.
Nota:
Para exibir o caminho completo para
elementos, clique com o botão direito no
cabeçalho da coluna (ou abaixo da grade de
resultados da pesquisa) e clique em Exibir
Caminhos Completos.
Clique em Elementos derivados.
A janela Find Derived Elements for (Encontrar
padrões derivados para) Element_Template
mostra todos os elementos, modelos,
transferências e event frames que foram criados
do template de elemento selecionado e também
de qualquer template derivado dele.
Nota:
Para exibir o caminho completo para
elementos derivados, clique com o botão
direito no cabeçalho da coluna (ou abaixo
da grade de resultados da pesquisa) e
clique em Exibir Caminhos Completos.
Clique em Templates pais referenciados.
A janela Encontrar Templates Pai Referenciados
para Element_Template mostra templates de
elemento que foram especificamente vinculados
a este template de elemento como um pai por
meio de um tipo de referência. A lista inclui
templates que foram indiretamente vinculados
por meio de herança de template.
Clique em Templates filhos referenciados.
A janela Encontrar Templates Filho Referenciados
para Element_Template exibe templates de
elementos que foram especificamente vinculados
a esse template de elemento como um filho por
meio de um tipo de referência. A lista inclui
templates que foram indiretamente vinculados
por meio de herança de template.
Guia do Usuário do PI System Explorer 103
Representação de ativos no PI AF

Estruturas de evento criadas do template Clique em Estruturas de evento.

A janela Encontrar Estruturas de Evento para
Event_Frame_Template mostra todos os event
frames que foram criados diretamente do
template de event frame selecionado.
Nota:
Para exibir o caminho completo para event
frames, clique com o botão direito no
cabeçalho da coluna (ou abaixo da grade de
resultados da pesquisa) e clique em Exibir
Caminhos Completos.

Estruturas de evento derivadas do template Clique em Estruturas de evento derivadas.

A janela Encontrar event frames derivados para
Event_Frame_Template exibe todos os event
frames que foram criados a partir do template
selecionado, bem como de qualquer template
derivado dele.
Nota:
Para exibir o caminho completo para event
frames derivados, clique com o botão
direito no cabeçalho da coluna (ou abaixo
da grade de resultados da pesquisa) e
clique em Exibir Caminhos Completos.

Definir templates para outros objetos

Além dos templates de elemento, é possível definir templates conforme necessário para
estruturas de evento, 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.

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, abra Templates para exibir as seguintes coleções de objetos:
◦ Templates de elemento
◦ Templates de estrutura de evento
◦ Templates de modelo
◦ Templates de notificação
◦ Templates de transferência
3. Clique com o botão direito na coleção e selecione Novo template.
O novo template exibe estas guias:
◦ Geral
◦ Templates de atributo
◦ Portas (não disponível para templates de estrutura de evento)
◦ Templates de análise (apenas templates de elementos)

104 Guia do Usuário do PI System Explorer

 Representação de ativos no PI AF

4. Preencha essas guias apenas conforme o desejado para um template. Consulte Criar
templates de elemento.
5. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Templates filhos
Em alguns casos, talvez você queira 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 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 Motor seja criado. O PI System Explorer
não cria automaticamente o elemento filho, Shaft. No entanto, ao criar um elemento filho
manualmente no elemento do motor, o tipo de referência Motor-Shaft é adicionado à lista de
tipos de referência e o template Shaft aparece na lista Template de elemento.

Criar referências de template filho

Crie uma referência de template filho quando for necessário estabelecer relações pai-filho
entre dois templates de elemento.

Procedimento
1. No navegador de Biblioteca, clique com o botão direito no template ao qual deseja adicionar
a referência de template filho e clique em Novo > Novo template referenciado.
2. Na janela Configurar nome do template de elemento referenciado, digite um nome para o
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ências.
3. Opcional. Para definir um tipo de referência diferente de pai-filho forte, marque a caixa de
seleção Editar tipo de referência.
a. Na janela Propriedades do tipo de referência, selecione a força de referência desejada na
lista Força de referência.
b. Clique em Fazer check-in.
c. Clique em OK para fechar a janela.
4. Complete a definição do template de elemento, conforme descrito em Criar templates de
elemento.

Guia do Usuário do PI System Explorer 105

Representação de ativos no PI AF

Representação de ativo com elementos

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 elementos com base em um template
• Criar elementos não baseados em um template
• Localizar onde um elemento é usado
• Exclusão de elementos
• Redefinição do atributo de valor para as propriedades originais
• Converter elementos em templates de elementos
• Alterar templates de elementos

Criar elementos com base em um template

Use os templates de elemento que você definiu para criar elementos na hierarquia do ativo.

Procedimento
1. No navegador de Elementos, clique com o botão direito na coleção de elementos ou em um
elemento individual e clique em Novo elemento.
2. Na janela Escolher template de elemento, selecione um template de elemento no campo
Template de elemento.
3. No campo Adicionar elemento filho usando o tipo de referência, selecione um tipo de
referência na lista de tipos disponíveis.
Os tipos de referência disponíveis dependem do template de elemento selecionado e dos
tipos de referência definidos no banco de dados. Se você não tiver certeza de qual tipo de
referência usar, selecione o tipo de referência padrão, pai-filho.
4. Clique em OK.
As guias de propriedade para o novo elemento são exibidas no visualizador. Como 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).
5. Nos campos Nome e Descrição, digite um nome e uma descrição para o elemento.
6. Opcional. Execute as ações a seguir conforme necessário.
◦ Clique no link Propriedades estendidas para criar propriedades para aplicativos clientes,
como PI ProcessBook e PI WebParts. Para obter mais informações, consulte
Armazenamento de informações específicas de aplicativo.
◦ Clique no link Anotações para inserir uma nota para o elemento. Para obter mais
informações, consulte Anotações de elemento.
◦ Clique no link Segurança para configurar permissões de acesso personalizadas para o
elemento. Para obter mais informações, consulte Segurança do objeto PI AF.
7. Opcional. Clique na guia Atributos para revisar os atributos definidos pelo template. Não é
possível adicionar novos atributos, exceto se o template permitir extensões.

106 Guia do Usuário do PI System Explorer

 Representação de ativos no PI AF

8. Opcional. Clique na guia Regras de notificação para revisar as regras de notificação

definidas pelo template. Não é possível adicionar novas regras de notificação, a menos que o
template permita extensões.
9. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Criar elementos não baseados em um template

Embora seja possível criar elementos que não sejam baseados em um template, a OSIsoft
recomenda que eventualmente você baseie seus elementos em templates para que possa
aproveitar os excelentes recursos baseados em template disponíveis nos aplicativos clientes. É
possível usar o recurso Converter em Template, conforme descrito em Converter elementos em
templates de elementos.

Procedimento
1. No navegador de Elementos, clique com o botão direito na coleção de elementos ou em um
elemento individual e clique em Novo elemento.
2. Na janela Escolher template de elemento, selecione um tipo de referência no campo
Adicionar elemento filho usando o tipo de referência.
Os tipos de referência disponíveis dependem do template de elemento e um dos tipos de
referência definidos no banco de dados. Se não tiver certeza de qual tipo de referência usar,
provavelmente você escolherá o tipo de referência padrão, pai-filho.
3. No campo Template de elemento, clique em <None>.
4. Clique em OK.
As guias de propriedade para o novo elemento são exibidas no visualizador.
◦ Use a guia Geral para executar a configuração básica do elemento.
◦ 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.
◦ Use a guia Atributos para criar um atributo para cada propriedade ou dado.
◦ Use a guia Portas apenas se você estiver modelando um processo.
◦ Use a guia Análises para selecionar uma análise para o elemento.
◦ Use a guia Regras de notificação para selecionar ou criar uma regra de notificação para o
elemento.
◦ Use a guia Versão para adicionar informações sobre a versão para o elemento.
5. Opcional. Execute as ações a seguir conforme necessário.
◦ Clique no link Propriedades estendidas para criar propriedades para aplicativos clientes,
como PI ProcessBook e PI WebParts. Para obter mais informações, consulte
Armazenamento de informações específicas de aplicativo.
◦ Clique no link Anotações para inserir uma nota para o elemento. Para obter mais
informações, consulte Anotações de elemento.
◦ Clique no link Segurança para configurar permissões de acesso personalizadas para o
elemento. Para obter mais informações, consulte Segurança do objeto PI AF.
6. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Guia do Usuário do PI System Explorer 107

Representação de ativos no PI AF

Localizar onde um elemento é usado

Use os links Localizar na guia Geral para um elemento selecionado, para localizar onde e como
é usado no template ativo.

Procedimento
1. Selecione um elemento no navegador de Elementos.
2. Escolha uma das seguintes opções:
Para localizar... Faça o seguinte...
Elementos pais Clique no link Pais. A janela Parents de Element é
aberta.
Elementos filho a. Clique no link Filhos.
b. Na janela Pesquisa de elemento, insira o texto
do nome do elemento no campo de pesquisa.
Para refinar sua pesquisa, insira critérios
adicionais na seção Critérios.
c. Clique em Pesquisar.
Os elementos correspondentes são exibidos
na seção Resultados.
Event frames conectados ao elemento Clique no link Event frames.
◦ Se uma correspondência for localizada,
Encontrar Estruturas de Evento para Element
exibirá uma lista de todos os event frames
que referenciam o elemento.
◦ Se nenhuma correspondência for encontrada,
uma mensagem No Event Frames Found
será exibida.

Exclusão de elementos
Quando um elemento é excluído no PI AF 2.4 e posterior, 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, faça-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.
Use o utilitário de linha de comando afdiag com o parâmetro /
EnablePropagationOfTargetDeletion:
afdiag /EnablePropagationOfTargetDeletion-

Saiba que a desativação da configuração pode causar problemas como:

• As notificações são deixadas em aberto (e permanecem ativas)

• Novas notificações não são criadas
• E-mails esperados não são enviados

Redefinição do atributo de valor para as propriedades originais

Quando você criou elementos baseados em templates em um ambiente de teste e mais tarde
deseja transferir o seu trabalho para um ambiente de produção, é possível redefinir todos os
atributos de um elemento com as propriedades originais, conforme definido por um template.

108 Guia do Usuário do PI System Explorer

 Representação de ativos no PI AF

É possível clicar com o botão direito em um atributo do elemento e clicar em Redefinir para
template.
Por exemplo, suponha que o atributo PI AF foi configurado para usar o nome do PI Data
Archive como parte da configuração do atributo no ambiente de teste. Será desejável que isso
reflita o novo nome do PI Data Archive quando o trabalho for transferido para ao ambiente de
produção.

Converter elementos em templates de elementos

A OSIsoft recomenda que os elementos sejam baseados em templates. Se você criou elementos
e atributos e não os baseou originalmente em um template, poderá mais tarde convertê-los em
um template.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, localize o elemento que deseja converter em um template.
3. Clique com o botão direito no elemento e clique em Converter > Converter em template.
Um template denominado ElementNameTemplate é criado e exibido no campo Template na
guia Geral.
4. Opcional. Para renomear o template, clique em Biblioteca no navegador.
a. No navegador de Biblioteca, localize o novo template na ramificação Templates de
elementos.
b. Clique com o botão direito no template e clique em Renomear.
c. Modifique o nome padrão conforme necessário. O novo nome deve ser exclusivo em
todos os templates.

Alterar templates de elementos

É possível alterar o template no qual um elemento existente está baseado ou adicionar um
template a um elemento que não está baseado em um template.

Antes de Iniciar
Tenha cuidado ao alterar um template de elemento, pois pode haver consequências
indesejadas. Por exemplo, os atributos podem ser excluídos se forem definidos pelo template
antigo e não estiverem presentes no novo template. Certifique-se de que atributos com o
mesmo nome no template antigo e no template novo tenham o mesmo tipo de dados.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador Elementos, clique com o botão direito no elemento que você deseja alterar e
clique em Converter > Alterar template.
3. Na janela Escolher template de elemento, selecione um template na lista Template de
elemento.
a. Opcional. Para exibir apenas templates em uma categoria específica, selecione uma
categoria na lista Templates de categoria.
4. Clique em OK.

Guia do Usuário do PI System Explorer 109

Representação de ativos no PI AF

Armazenamento de informações específicas de aplicativo

Propriedades estendidas são aquelas que outros aplicativos definem em objetos do PI AF. Por
exemplo, o PI WebParts armazena o ícone e a URL nas propriedades estendidas de um
elemento do PI AF. Normalmente, os aplicativos usam as informações armazenadas na janela
Propriedades estendidas de maneira programática usando o AF SDK.
Um link Propriedades estendidas é exibido na guia Geral de muitos tipos de objetos no PI
System Explorer. Esse link pode ser usado para configurar uma ou mais propriedades
adicionais de um objeto.
Nota:
Os usuários não precisam usar esse recurso avançado do PI AF.

Criar propriedades estendidas

Em geral, os aplicativos clientes como PI WebParts e PI ProcessBook usam o recurso
Propriedades estendidas para gravar as propriedades e os usuários não precisam usar esse
recurso avançado.

Procedimento
1. Clique no link Propriedades estendidas.
2. Na janela Propriedades estendidas, escolha uma das seguintes ações:
◦ Para criar a primeira propriedade estendida, clique no link Nova propriedade estendida.
◦ Para criar uma propriedade estendida adicional, clique com o botão direito na coluna
Nome e selecione Nova propriedade estendida.
3. No campo Nome, exclua o texto padrão e digite o nome da propriedade estendida.
4. Clique no campo Valor e escolha entre as seguintes opções:
◦ Digite uma string. Para visualizar o texto que você está digitando, pressione F2 e digite na
janela Visualizador de texto.
◦ Clique em e selecione na lista de Tipos básicos, Tipos de matriz e Objetos.
▪ Se você escolher um objeto como Atributo ou Elemento, clique em e localize o
objeto desejado.
▪ Se você escolher Arquivo, clique em e selecione Carregar para localizar o arquivo
desejado.
5. Clique em Fechar.

110 Guia do Usuário do PI System Explorer

Associação de dados com ativos do PI AF
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 pontos do PI, originar em
fórmulas ou manter dados fora do PI System através do uso de tabelas PI AF.

Conjuntos de enumerações
Se um atributo for necessário para armazenar apenas valores predefinidos, você poderá usar
um enumeration set. 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 PI AF.

Vídeos
Para obter informações sobre como criar atributos de elementos, assista a este vídeo:
https://www.youtube.com/watch?v=pLmIPOOIcEw
Para obter informações sobre como criar atributos filhos, assista a este vídeo:
https://www.youtube.com/watch?v=BiXA13ptVTM

Nesta seção
• Templates de atributo
• Conjuntos de enumerações

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.
Em vez de criar atributos em cada elemento, OSIsoft recomenda criar templates de atributo em
um template de elemento. Sempre que você criar elementos baseados nesse template, o PI AF
cria automaticamente o atributo. Ainda é necessário atribuir um valor a cada atributo.

Vídeo
Para obter informações sobre como criar templates de atributos, assista a este vídeo:
https://www.youtube.com/watch?v=dCx5_Aw5x24

Propriedades do atributo
Você precisa configurar as propriedades para cada atributo do elemento. Depois de atribuir as
propriedades em um template de atributo, os usuários só podem modificar a propriedade
Excluir em atributos individuais.

Guia do Usuário do PI System Explorer 111

Associação de dados com ativos do PI AF

Propriedade do atributo do item de configuração

Você atribui a propriedade Item de configuração para um atributo que represente as
propriedades inerentes 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 ponto PI 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 dos dados do ponto PI)
• volume (referência dos dados do ponto PI)
Os primeiros cinco atributos normalmente seriam itens de configuração, uma vez que esses
valores não mudarão a menos que você altere o equipamento. Os últimos dois atributos não
seriam itens de configuração, já que os valores mudam todo o tempo.

Propriedade do atributo excluído

Você exclui um atributo nas situações em que nem todos os atributos em um template de
elemento são aplicáveis. Por exemplo, suponha que você tem cinco templates de atributos
definidos em um template de elemento nomeado Meter, que você usa para criar elementos
representando vários tipos diferentes de medidores em uso em suas instalações. Em alguns
tipos de medidor (meterA), apenas três atributos do template Meter são aplicáveis, ao passo
que nos demais (meterB) todos os cinco atributos se aplicam. Em medidores do tipo A, você
deve selecionar a propriedade Excluído para os dois atributos que são inaplicáveis. Para efeitos
práticos, esses dois atributos "parecem" inexistentes para a maioria dos aplicativos clientes PI
AF, uma vez que as pesquisas recuperam o valor do estado digital No Result.
Nota:
Um atributo excluído não pode ser utilizado para retornar elementos e estruturas de
evento que são referenciados por um valor de atributo excluído.
Quando a propriedade Excluído é atribuída em um template de atributo, ela é indicada pelo
ao lado do nome do atributo se a opção Mostrar atributos excluídos estiver ativada. Os
atributos que são derivados desse template aparecem em uma guia Atributos do elemento,
com na coluna Template e Excluído na coluna Valor. Você pode alternar a exibição desses
atributos com o comando Ocultar atributos excluídos e Mostrar atributos excluídos no menu
de contexto da guia Atributos. Observe que quando Mostrar atributos excluídos estiver ativado,
os usuários podem alterar a configuração da propriedade Excluído para um atributo a partir da
configuração atribuída em um template de atributo.

112 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Ou então, você pode desmarcar a opção Mostrar atributos excluídos em Ferramentas > Opções
para ocultar os atributos excluídos em todo o PI System Explorer. Quando os atributos estão
ocultos, a mensagem Excluded attributes are hidden é exibida na guia Atributos.

Propriedade do atributo oculto

Um atributo oculto é aquele que não pode ser recuperado nas pesquisas de aplicativos cliente
do PI AF, como o PI Vision. Essa propriedade é útil se um atributo estiver sendo usado para
armazenar um resultado intermediário, como um resultado de pesquisa de tabela que depois
pode ser recuperado por uma referência de dados de tag do PI, ou se o atributo estiver sendo
usado apenas para preencher um nome de tag do PI em um parâmetro de substituição.
Ela também pode ser útil para configurar uma propriedade de atributo como Oculto em um
template, quando a configuração não foi totalmente concluída no próprio elemento. Por
exemplo, os elementos estão sendo criados a partir de um template com uma referência de
dados do ponto PI, mas como alguma instrumentação está ausente, os pontos PI ainda não
existem para todos os elementos. Configurando os atributos para a instrumentação ausente
como Oculto, um aplicativo do cliente PI AF é impedido de obter um resultado de erro em uma
pesquisa.
Quando a propriedade Oculto é atribuída a um atributo em um template de atributo, a
propriedade é indicada por na coluna Oculto ao lado do nome do atributo. O mesmo ícone é
exibido ao lado do nome do atributo na guia Atributos quando o template é atribuído a um
elemento.

Propriedade do atributo indexado

Você indexa um atributo para otimizá-lo com o fim de obter resultados de pesquisa e
recuperação de valores rápidos. Os índices só melhoram o desempenho de atributos cujos
valores estão armazenados no banco de dados PI AF. Isso significa que você não tem qualquer
benefício indexando atributos que obtêm os seus valores de referências de dados, como é o
caso dos pontos PI e tabelas vinculadas. Para estruturas de evento, no entanto, quando os
valores dos atributos são capturados, eles são gravados no PI AF Server e, como resultado,
podem se beneficiar com a indexação.
Nota:
Apenas os primeiros 40 caracteres dos atributos indexados com um tipo de valor String
são usados em pesquisas.
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, você indexa o atributo que acredita que os usuários provavelmente pesquisam com
frequência. Por exemplo, caso deseje localizar ativos pesquisando por um número de série,
será necessário indexar o atributo do número de série.

Propriedade de atributo de entrada manual de dados

Você indica um flag para um atributo para a entrada manual de dados, a fim de permitir que os
aplicativos cliente (como o PI Vision e o PI Manual Logger) orientem os usuários para inserir
dados para esse atributo. Por exemplo, em uma versão futura do PI Manual Logger, essa
propriedade identificará tags em um tour que os operadores devem coletar manualmente, em
contraste com tags que são coletadas automaticamente por meio de uma interface ou de um
conector.

Guia do Usuário do PI System Explorer 113

Associação de dados com ativos do PI AF

Para determinar quais atributos têm essa propriedade, adicione uma coluna de Entrada
Manual de Dados a uma grade de atributo no visualizador Elementos, em que os atributos com
essa propriedade são exibidos como True.

Características de atributo
As características de atributo identificam características comumente encontradas ou
comportamentos relacionados de um atributo pai. PI AF dá suporte às características de
atributo para condições limite, valores previstos, informações de geolocalização e start triggers
de análise. Usuários e aplicativos cliente como o PI Vision podem, então, encontrar, exibir e
analisar esses atributos relacionados de maneira mais eficaz.
Para definir e acessar as características de atributo, o PI AFcliente e o servidor precisam estar
rodando o PI AF 2016.

Características de atributo de limite

É possível usar características de atributo de limite para identificar o intervalo esperado de
uma variável de processo ou de um atributo de medida. Características de atributo de limite
são geralmente definidas em outro local (por exemplo, em um sistema de controle) ou
representam propriedades próprias do atributo pai, como temperatura. Um uso típico seria
configurar as condições para um alarme. O PI Vision,por exemplo, usa a maioria dos atributos
de limite como entrada ao configurar comportamento de múltiplos estados para um alarme
visual.
As características de atributo de limite são atributos filhos da medida que eles descrevem e
têm o mesmo tipo de valor e UDM que o pai. A única exceção é quando o valor de uma
característica de atributo de limite é obtida de uma referência de dados, nesse caso a fonte
UDM de uma referência de dados definida pode ser diferente. Também é possível apenas
definir as características de atributo de limite para atributos pais que são numéricos. Observe
que apenas é possível atribuir uma característica de atributo de limite uma vez para um
atributo pai.
As características limite a seguir são definidas:
Característica de Descrição
atributo de limite
Minimum Indica que o valor de medida ou a saída de processo menos possíveis.
LoLo Indica um valor de medida ou uma saída de processo muito baixos, tipicamente
anormal, iniciando um alarme.
Lo Indica um valor de medida ou uma saída de processo baixos, tipicamente iniciando
um aviso.
Destino Indica o valor de medida ou a saída de processo almejados.
Hi Indica um valor de medida ou uma saída de processo altos, tipicamente iniciando
um aviso.
HiHi Indica um valor de medida ou uma saída de processo muito altos, tipicamente
anormal, iniciando um alarme.
Maximum Indica o valor de medida ou a saída de processo mais possíveis.

Vídeo
Para obter informações sobre como configurar as características de atributo de limite, assista a
este vídeo:
https://www.youtube.com/watch?v=jO2dVYsBvds

114 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Características de atributo de previsão

Em geral, usa-se características de atributo de previsão como valores previstos para
comparação com os valores reais do atributo pai. Normalmente, essas características de
atributo representam pontos de dados futuros PI, porém não são uma exigência. Aplicativos
clientes podem facilmente relacionar esses atributos e criar uma tendência em conjunto.
As características de atributo de previsão são atributos filho do atributo que eles descrevem e
têm o mesmo tipo de valor e UDM do pai. A única exceção é quando o valor de uma
característica de atributo de previsão é obtido de uma referência de dados, nesse caso a fonte
UDM de uma referência de dados definida pode ser diferente. É possível também criar
características de atributo de previsão para atributos pai que são de qualquer tipo de valor.
Observe que é possível ter múltiplas características de atributo de previsão definidas para um
atributo pai.

Características de atributo de localização

Use os atributos de localização para definir as informações de longitude, latitude e altitude
para um ativo. É possível usar essas informações para identificar a localização do ativo em um
mapa.
É possível criar características de atributo de localização em um elemento ou nos atributos
filho de um elemento. No entanto, é possível criar apenas uma de cada característica de
atributo por elemento. A UDM para as características de atributos de latitude e longitude deve
ser grau (o padrão) ou pelo menos um ângulo, enquanto a característica de atributo de altitude
pode ser metros (o padrão) ou outra UDM na classe de Comprimento. O tipo de valor para
todas as características de atributos de localização deve ser numérico (duplo).

Características de atributo de start trigger de análise

Quando usuários configuram as análises para gerar estruturas de evento, eles podem,
opcionalmente, escolher armazenar o nome do start trigger no valor de um atributo (string) e
marcar aquele atributo com a característica de start trigger de análise. Isso permite que
clientes como o PI Vision indiquem o gatilho inicial que criou esse event frame em particular.
Para obter mais informações, consulte Análises de geração da estrutura de eventos.

Configurar características de atributos de limite

Configure para sete características de limite para um template de atributo ou um atributo de
elemento para permitir que os usuários definam o intervalo esperado de uma variável de
processo ou uma medida.

Procedimento
1. Escolha uma das seguintes ações:
Para configurar uma característica de limite para Faça o seguinte...
um...
Template de atributo a. No navegador de Biblioteca, selecione um
template de elemento.
b. No visualizador, clique na guia Templates de
atributo.
Atributo de elemento a. No navegador de Elementos, selecione um
elemento.
b. No visualizador, clique na guia Atributos.

2. Selecione o atributo para o qual deseja configurar uma ou mais características de limite.
3. Escolha uma das seguintes ações:

Guia do Usuário do PI System Explorer 115

Associação de dados com ativos do PI AF

◦ Clique com o botão direito e clique em Limites.

◦ Na parte inferior da área de configuração, clique no link Limites.
4. Na janela Limites, marque a caixa de seleção ao lado da característica de limite que deseja
configurar.
5. Em Atributo, escolha uma das seguintes ações:
◦ Deixe o nome do atributo padrão como está.
◦ Substitua o nome do atributo padrão por um nome revisado de sua escolha.
◦ Se já existir um atributo filho que você queira atribuir à característica de limite,
selecione-o na lista suspensa.
Nota:
As características de atributos de limite que já foram definidas são exibidas em
negrito.
6. Escolha uma das seguintes ações:
Para configurar um... Faça o seguinte...
Valor para a característica de limite Em Valor, insira um valor de limite.
Valor para a característica de limite de uma a. Em Referência de dados, selecione um tipo de
referência de dados referência de dados.
b. Em Configurações, clique em para
configurar a referência de dados.
Nota:
A UDM de origem de uma referência de
dados pode ser diferente daquela do
atributo pai.
c. Clique em OK para fechar a janela de
referência de dados.
O resultado da referência de dados avaliada é
exibido.

7. Repita as etapas de 4 a 6 para configurar valores para outras características de limite.

8. Clique em OK quando sua lista de características de limite para o atributo pai selecionado
estiver concluída.

Configurar características de atributos previstas

Configure uma ou mais características previstas para um template de atributo ou um atributo
de elemento para permitir que usuários e aplicativos clientes comparem os valores previstos
com valores reais e definam uma tendência.

Procedimento
1. Escolha uma das seguintes ações:
Para configurar uma característica prevista para Faça o seguinte...
um...
Template de atributo a. No navegador de Biblioteca, selecione um
template de elemento.
b. No visualizador, clique na guia Templates de
atributo.

116 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Atributo de elemento a. No navegador de Elementos, selecione um

elemento.
b. No visualizador, clique na guia Atributos.

2. Selecione o atributo para o qual deseja configurar uma ou mais características previstas.
3. Escolha uma das seguintes ações:
◦ Clique com o botão direito e clique em Previsões.
◦ Na parte inferior da área de configuração, clique no link Previsões.
4. Na janela Previsões, clique no botão ou link Nova previsão.
5. Em Atributo, escolha uma das seguintes ações:
◦ Deixe o nome do atributo padrão como está.
◦ Substitua o nome do atributo padrão por um nome revisado de sua escolha.
◦ Se já existir um atributo filho que você queira atribuir à característica prevista, selecione-
o na lista suspensa.
Nota:
As características de atributos previstas que já foram definidas são exibidas em
negrito.
6. Escolha uma das seguintes ações:
Para configurar um... Faça o seguinte...
Valor para a característica prevista Em Valor, insira um valor previsto.
Valor de uma referência de dados a. Em Referência de dados, selecione um tipo de
referência de dados.
b. Em Configurações, clique em para
configurar a referência de dados.
Nota:
A UDM de origem de uma referência de
dados pode ser diferente daquela do
atributo pai.
c. Clique em OK para fechar a janela de
referência de dados.
O resultado da referência de dados avaliada é
exibido.

7. Você pode configurar tantos valores previstos quantos forem necessários. Repita as etapas
de 4 a 6.
8. Clique em OK quando sua lista de atributos previstos para o atributo pai selecionado estiver
completa.

Configurar características de atributos de localização

Configure uma ou mais características de localização em um template de elemento ou em um
elemento para permitir que os usuários possam identificar a localização de um ativo em um
mapa.

Antes de Iniciar
Você só pode atribuir um conjunto de características de atributo de localização por elemento.

Guia do Usuário do PI System Explorer 117

Associação de dados com ativos do PI AF

Procedimento
1. Escolha uma das seguintes ações:
Para configurar uma característica de localização Faça o seguinte...
em...
Template de elemento a. No navegador de Biblioteca, selecione um
template de elemento.
b. Escolha uma das seguintes ações:
▪ Clique com o botão direito e clique em
Localização.
▪ Na guia Geral, clique no link Localização.
Elemento a. No navegador de Elementos, selecione um
elemento.
b. Escolha uma das seguintes ações:
▪ Clique com o botão direito e clique em
Localização.
▪ Na guia Geral, clique no link Localização.

Nota:
Você também pode configurar as características de localização no template de atributo
de um template de elemento ou um atributo do elemento. Em um template de
elemento, clique com o botão direito em um template de atributo e clique em Local do
template de elemento. Em um elemento, clique em um atributo de elemento e clique
em Local do elemento.
2. Na janela Localização de Element, marque a caixa de seleção ao lado da característica que
você deseja aplicar ou marque a caixa de seleção no cabeçalho da coluna para selecionar
todas as características.
3. Em Atributo, escolha uma das seguintes ações:
◦ Deixe o nome do atributo padrão como está. O nome do atributo padrão exibe o caminho
relativo para o elemento.
◦ Substitua o nome do atributo padrão por um nome de sua escolha. Certifique-se de que o
caminho completo para o elemento seja mantido.
◦ Se já existir um atributo filho que você queira atribuir à característica de localização,
selecione-o na lista suspensa.
Nota:
As características de atributos de localização que já foram definidas são exibidas em
negrito.
4. Escolha uma das seguintes ações:
Para configurar um... Faça o seguinte...
Valor para a característica de localização Em Valor, insira um valor de localização.

118 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Valor de uma referência de dados a. Em Referência de dados, selecione um tipo de

referência de dados.
b. Em Configurações, clique em para
configurar a referência de dados.
c. Clique em OK para fechar a janela de
referência de dados.
O resultado da referência de dados avaliada é
exibido.

5. Clique em OK quando sua lista de atributos de localização para o atributo de elemento

selecionado estiver completa.

Criar templates de atributo

Use templates de atributo para criar um conjunto padrão de atributos que estão associados a
um template de elemento.

Procedimento
1. No navegador de Biblioteca, selecione um template de elemento.
2. Para criar um novo template de atributo, escolha uma das seguintes ações:
◦ Na barra de ferramentas, clique em Novo template de atributo.
◦ Clique com o botão direito no template de elemento no navegador e clique em Novo >
Novo template de atributo.
3. Nos campos Nome e Descrição, insira um nome e uma descrição exclusivos para o template
de atributo.
Nota:
Quando você precisa procurar um atributo, pode pesquisar até 440 caracteres de uma
descrição.
4. Defina os campos de configuração, conforme necessário.
Campo Descrição
Propriedades Selecione uma ou mais das seguintes propriedades, conforme necessário.
◦ Item de configuração
◦ Excluído
◦ Oculto
◦ Indexado
◦ Entrada de dados manual
Para obter mais informações sobre essas propriedades, consulte
Propriedades do atributo.
Você também pode configurar o template de atributo atual para ser um
característica de atributo de localização para um elemento pai. Selecione
um dos seguintes:
◦ Longitude
◦ Latitude
◦ Altitude
Nota:
Ao configurar um template de atributo filho, você pode também
selecionar o limite e as características de atributo previstas,
dependendo do tipo de valor do template de atributo pai. Para obter
mais informações, consulte Características de atributo.

Guia do Usuário do PI System Explorer 119

Associação de dados com ativos do PI AF

Categorias Clique em e selecione uma ou mais categorias previamente definidas na

janela Categorias. Você também pode criar uma nova categoria. Para obter
mais informações, consulte Categorização de objetos.
UDM Padrão Selecione uma UDM da lista. Para obter mais informações sobre UDMs,
consulte Unidades de medida no PI AF.
Nota:
Embora o usuário possa alterar a UDM exibida para um atributo no
PI System Explorer, 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. Para obter mais informações, consulte Definir valores constantes
para templates de atributos.
Nota:
Apesar de permitido, o tipo de valor Qualquer não é recomendado. Quando o tipo
de valor não é especificado, muitos aplicativos clientes podem ter dificuldade em
trabalhar com esse atributo. Por exemplo, o PI OLEDB Enterprise, o PI ProcessBook
e o PI Vision teriam uma capacidade reduzida com esses atributos, sendo incapazes
de criar a tendência de um valor numericamente. Além disso, recursos padrão do PI
AF como conversão automática de UDM, fórmulas e analítica, não podem funcionar
com atributos que não têm nenhum tipo de valor.
◦ Para valores e matrizes da tag do PI, fórmulas e dados de tabela (incluindo os dados de
bancos de dados relacionais), clique em Configurações para configurar uma referência de
dados. Para obter mais informações, consulte Configuração de referências de dados.
6. Opcional. Insira um valor padrão no atributo no campo Valor padrão.
7. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

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.
• Para as referências de dados, crie a instância da referência. Para isso, clique com o botão
direito no elemento no navegador e selecione Criar ou atualizar referência de dados. Para
obter mais informações, consulte Atualizações de valor do atributo das referências de dados
da tag do PI.
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 Vision. Consulte
Restrições na visualização dos dados da série cronológica para obter mais informações.

Tipos de dados do PI AF
A tabela a seguir contém as definições dos tipos de dados em uso no PI AF.

120 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Tipo de dados PI Data Descrição Intervalo

Archive
equivalente
Boolean Nenhum Um tipo de dados que rastreia True ou False
as condições de verdadeiro ou
Um atributo Boolean pode ser armazenado em
falso
um ponto PI do tipo String e em qualquer
uma das tags Integer, mas Digital é a
representação preferida.

Byte Nenhum Um tipo de dados não assinado 0 a 255

de 8 bits
Esses valores podem ser representados em um
tipo de dados maior do PI, como Int16. No
entanto, se PI Data Archive contiver dados fora
do intervalo de bytes, um erro é retornado
quando recuperado por meio do PI AF.

DateTime Timestamp Data e hora armazenados • Se armazenado no PI Data Archive: 1 de

internamente em 64 bits janeiro de 1970 a 19 de janeiro de 2038,
com uma precisão de 15 microssegundos
• Se não armazenado no PI Data Archive: 1 de
janeiro de 0001 a 31 de dezembro de 9999,
com uma precisão de 100 nanossegundos
Double Float64 Número de ponto flutuante de ±5,0e−324 a ±1,7e308, 15 dígitos de precisão
64 bits
GUID Nenhum Um tipo de dados exclusivo de 00000000-0000-0000-0000-000000000000 a
128 bits utilizado para a ffffffff-ffff-ffff-ffff-ffffffffffff
identificação global de objetos
Os valores acima podem ser representados
como um tipo de dado do PI String.

Int16 Int16 Um inteiro assinado de 16 bits -32.768 a 32.767

Int32 Int32 Um inteiro assinado de 32 bits -2.147.483.648 a 2.147.483.647
Int64 Nenhum Um inteiro assinado de 64 bits -9.223.372.036.854.775.808 a
9.223.372.036.854.775.807
Não há nenhum equivalente de um Int64 em
PI Data Archive. Para representações não
numéricas (como um número de ID), uma
string pode ser utilizada. Para representações
numéricas, Float64 fornece alguma
equivalência, mas estará sujeito a problemas de
arredondamento com números muito grandes
(positivos ou negativos).

Single Float32 Número de ponto flutuante de ±1,5e−45 a ±3,4e38, 7 dígitos de precisão

32 bits
String String Uma sequência de caracteres PI Data Archive strings limitadas a 976
múltiplos caracteres e não são unicode

Definir valores constantes para templates de atributos

Você pode atribuir valores constantes diretamente em um template de atributo. Embora não
seja possível configurar os valores de atributo atuais em templates de atributos, é possível
definir os valores padrão.

Guia do Usuário do PI System Explorer 121

Associação de dados com ativos do PI AF

Procedimento
1. No visualizador, use o campo Tipo de valor para selecionar o tipo de dados do atributo. Há
quatro grupos de tipos de valores:
◦ Tipos básicos
Um tipo de dados suportado pelo PI AF, conforme descrito em Tipos de dados do PI AF.
◦ Tipos de matriz
Uma matriz contém qualquer um dos tipos Básicos como elementos.
◦ Conjuntos de enumerações
Um conjunto de enumeraçõ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, você pode selecionar um valor na lista. Use a opção Conjuntos de enumeração
para selecionar qualquer um dos conjuntos de enumeração já criados no banco de dados
PI AF.
◦ Objetos
Um objeto pode ser outro atributo PI AF, um elemento ou um arquivo de sistema
operacional.
2. Clique no campo Valor Padrão.
O formato do campo Valor Padrão é alterado de acordo com o Tipo de valor.
3. Configure o valor do atributo, conforme descrito no procedimento apropriado para o tipo de
dado do atributo.

Configurar valores para tipos de dados básicos

Depois de configurar o Tipo de valor para um dos tipos de dados básicos, defina o valor do
atributo.

Procedimento
1. Clique no campo Valor Padrão. O formato do campo é alterado de acordo com o tipo de
valor. Consulte Tipos de dados do PI AF.
2. Insira o valor do atributo no campo Valor padrão. 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 DateTime, ele envia a data e a hora resultantes.

Exemplos
Se o tipo de valor for DateTime, será possível inserir a hora em qualquer formato de string com
suporte do PI AF (inclusive formatos do horário PI) ou do objeto DateTime 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 começando com http://, ftp://, file:// e www.
são reconhecidas como links, mas não as que começam com C:\ e abc.com. No PI System
Explorer, os links aparecem sublinhados e têm uma dica de ferramenta associada a eles.

122 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Configurar valores para tipos de dados de matriz

Depois de configurar o Tipo de valor para um dos tipos de dados de matriz, é possível definir o
valor do atributo.

Procedimento
1. Clique no campo Valor Padrão.
2. Clique em ao lado do campo Valor Padrão.

3. Na janela Matriz, defina a sua matriz. O campo Valor Padrão é configurado para o formato
apropriado do tipo de dados selecionado para os elementos da matriz. Consulte Tipos de
dados do PI AF.
4. 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 valores de enumeration set

Ao selecionar um enumeration set para o Tipo de valor, é possível escolher o valor de um
atributo da lista predefinida de valores constantes desse conjunto.

Procedimento
1. Clique no campo Valor Padrão. O campo Valor Padrão torna-se um menu suspenso com
valores do enumeration set selecionado.
2. Selecione um valor na lista de constantes predefinidas. Depois da confirmação das
alterações, o PI System Explorer envia o valor resultante ao PI AF.

Configurar valores para tipos de dados de objeto

Depois de configurar o Tipo de valor para um dos tipos de dados Objeto, defina o valor do
atributo.

Procedimento
1. Clique no campo Valor Padrão. O botão de ação ao lado do campo é alterado de acordo com
o tipo de valor selecionado.
Tipo de valor Ação
<Anything> Apesar de permitido, o tipo de valor Qualquer não é recomendado.
Nota:
Quando o tipo de valor não é especificado, muitos aplicativos clientes
podem ter dificuldade em trabalhar com esse atributo. Por exemplo,
o PI OLEDB Enterprise, o PI ProcessBook e o PI Vision teriam uma
capacidade reduzida com esses atributos, sendo incapazes de criar a
tendência de um valor numericamente. Além disso, recursos padrão
do PI AF como conversão automática de UDM, fórmulas e análise, não
podem funcionar com atributos que não têm nenhum tipo de valor.

Atributo Clique em para abrir a janela Pesquisa por atributos. Insira os critérios
de pesquisa, conforme descrito em Pesquisar atributos em elementos.
Elemento Clique em para abrir a janela Navegador de Elementos, na qual você
pode localizar e selecionar um elemento.

Guia do Usuário do PI System Explorer 123

Associação de dados com ativos do PI AF

Tipo de valor Ação

Arquivo Clique em e selecione Carregar. Localize e selecione um arquivo na
janela Abrir.
CUIDADO:
Antes de carregar 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,
nesses casos será exibida uma mensagem de aviso perguntando se
você tem certeza de que 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.

2. Clique em OK. Depois da confirmação das alterações, o PI System Explorer envia o valor
resultante ao PI AF.

Adicionar extensões de atributo aos elementos baseados em template

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.

Antes de Iniciar
A caixa de seleção Permitir extensões na guia Geral do template de elemento em que o atributo
é baseado deve estar marcada.

Procedimento
1. No navegador de Elementos, selecione o elemento ao qual um atributo será adicionado.
2. Escolha uma das seguintes ações.
◦ Na barra de ferramentas, clique em Novo atributo.
◦ Clique com o botão direito no elemento no navegador e clique em Novo > Novo atributo.
◦ Selecione a guia Atributos no visualizador, clique com o botão direito e clique em Novo
atributo no menu de contexto.
3. Nos campos Nome e Descrição, insira um nome e uma descrição exclusivos para o template
de atributo.
Nota:
Quando você precisa procurar um atributo, pode pesquisar até 440 caracteres de uma
descrição.
4. 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.

124 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

Nota:
Apesar de permitido, o tipo de valor Qualquer não é recomendado. Quando o tipo
de valor não é especificado, muitos aplicativos clientes podem ter dificuldade em
trabalhar com esse atributo. Por exemplo, o PI OLEDB Enterprise, o PI ProcessBook
e o PI Vision teriam uma capacidade reduzida com esses atributos, sendo incapazes
de criar a tendência de um valor numericamente. Além disso, recursos padrão do PI
AF como conversão automática de UDM, fórmulas e analítica, não podem funcionar
com atributos que não têm nenhum tipo de valor.
Opcional. Insira ou modifique o valor padrão para o atributo no campo Valor.
◦ Para fórmulas, valores de ponto PI, matrizes de ponto PI e dados de tabela (inclusive
dados de bancos de dados relacionais), clique em Configurações para configurar uma
referência de dados.
Consulte Configuração de referências de dados para obter informações sobre como
configurar diferentes tipos de referência de dados.
5. Defina outros campos de configuração, conforme necessário.
Campo Descrição
Propriedades Selecione uma ou mais das seguintes propriedades, conforme necessário.
◦ Item de configuração
◦ Excluído
◦ Oculto
◦ Indexado
Para obter mais informações, consulte Propriedades do atributo.
Categorias Clique em e selecione uma ou mais categorias previamente definidas na
janela Categorias. Você também pode criar uma nova categoria. Para obter
mais informações, consulte Categorização de objetos.
UDM Padrão Selecione uma UDM na lista suspensa. Para obter mais informações,
consulte Unidades de medida no PI AF.
Nota:
É possível alterar a unidade de medida exibida no atributo no PI
System Explorer; no entanto, a UDM definida no template não é
alterada.

6. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Conjuntos de enumerações
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.
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.

Guia do Usuário do PI System Explorer 125

Associação de dados com ativos do PI AF

Vídeo
Para obter informações sobre como criar enumeration sets, assista a este vídeo:
https://www.youtube.com/watch?v=nH7zvsb8kBE

Criar enumeration sets

Os enumeration sets devem ser criados para poder estabelecer valores predefinidos para um
template de atributo.

Procedimento
1. No navegador, clique em Biblioteca.
2. Para criar um novo enumeration set, escolha uma das seguintes ações:
◦ Na barra de ferramentas, clique em Novo enumeration set.
◦ No navegador, clique com o botão direito na coleção Enumeration sets e clique em Novo
enumeration set.
3. No campo Nome da janela Enumeration Set Properties (Propriedades do enumeration set),
insira um nome exclusivo para o enumeration set.
4. Opcional. No campo Descrição, insira uma descrição para o enumeration set.
5. Se você deseja usar valores hexadecimais, marque a caixa de seleção Hexadecimal.
6. Crie uma lista de valores e nomes exclusivos para cada membro do enumeration set. Você
também pode fornecer uma descrição opcional.

◦ Valor é um valor numérico exclusivo associado à enumeração. O valor fornece uma

representação mais rápida e com uso menos intenso de memória de um valor da
enumeração.
◦ Nome é uma string exclusiva que descreve a condição ou o estado representado. O nome
é o meio preferido de acessar uma enumeração.
7. Opcional. Se você deseja configurar permissões de acesso para o novo enumeration set
diferentes daquelas herdadas da coleção Enumeration sets, clique no link Segurança. Para
obter mais informações, consulte Configurar segurança para objetos.
8. Na barra de ferramentas ou na janela Enumeration Set Properties (Propriedades do
enumeration set), clique em Check-in.

126 Guia do Usuário do PI System Explorer

 Associação de dados com ativos do PI AF

O que Fazer Depois

No navegador Biblioteca, você pode clicar com o botão direito em um enumeration set e
adicionar ou renumerar os valores conforme necessário. No entanto, saiba que se você
renumerar ou excluir valores, invalidará os objetos nos quais esse valor está sendo usado
atualmente.

Renumerar valores de enumeração

É possível renumerar um conjunto de enumeração, embora você invalide os objetos nos quais o
valor está sendo usado atualmente.

Procedimento
1. Clique com o botão direito em um campo e selecione Renumerar valores de enumeração.
A janela de confirmação Alterar valor de enumeração explica que você invalidará os objetos
que já estiverem usando o conjunto de enumeração existente.
2. Para continuar, clique em Sim.
3. No campo Valores iniciais da janela Renumerar, use os ícones de seta para aumentar ou
diminuir o valor.
4. No campo Incrementar por, use os ícones de seta para selecionar um valor de incremento.
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, haverá a
possibilidade de que os valores gerados sejam idênticos aos valores acima da linha
selecionada. A seguinte mensagem de erro é exibida:
Attempting to change the enumeration values would overlap previous
enumeration values prior to the selected row.

Guia do Usuário do PI System Explorer 127

Associação de dados com ativos do PI AF

128 Guia do Usuário do PI System Explorer

Configuração de 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. Os atributos que as
incluem são chamados de atributos de referência de dados. É possível criar uma referência de
dados para as seguintes fontes:

• Ponto PI
Use o valor do ponto PI, o valor do resumo ou outras operações no valor do ponto.

• Matriz de ponto PI
Use uma referência de dados da matriz do ponto PI para criar um único valor de uma matriz
dos pontos PI.

• Fórmula
Crie fórmulas para produzir um resultado de cálculo que defina o valor do atributo. O
cálculo pode incluir atributos e também atributos de referências de dados.

• Pesquisa de tabela
Defina uma tabela internamente, importe os valores de uma tabela externa (não PI) ou
vincule aos valores em uma tabela externa.

• Builder da string
Use os parâmetros e as funções de substituição para manipular os valores e obter uma
string.

• Builder do URI
Use os valores dos atributos atuais e os parâmetros de substituição para criar links
dinâmicos para atributos. Você pode usar o atributo em uma notificação ou em um
aplicativo cliente, como o PI Vision.

Nesta seção
• Strings de configuração de atributo no PI System Explorer
• Parâmetros de substituição em referências de dados
• Referências de dados do ponto do PI
• Referências de dados de matriz do ponto do PI
• Referências de dados da fórmula
• Referência de dados do Builder da String
• Referência de dados em busca por tabela
• Referências de dados em Builder do URI

Strings de configuração de atributo no PI System Explorer

Uma string de configuração do atributo descreve uma referência de dados. A sintaxe para uma
string de configuração depende do tipo de referência de dados.

Guia do Usuário do PI System Explorer 129

Configuração de referências de dados

A string de configuração para as referências de dados do Builder da String pode conter

parâmetros de substituição. Nos padrões do atributo, qualquer string de configuração pode
conter parâmetros de substituição. Consulte Lista de parâmetros de substituição do PI AF.
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 são diretamente editadas na caixa de texto.
A tabela a seguir contém exemplos das strings de configuração para diferentes tipos de
referências de dados.
Tipo de referência de Amostra de string de configuração
dados
Fórmula D=Density;V=Volume;[D*V]
A=Attribute3;[A*3];UOM=cm
Ponto PI \\MyPIDataArchiveServer\sinusoid
\\192.168.0.255\ChocMilkMeter;TimeMethod=TimeRange;
RelativeTime=-1h;TimeRangeMethod=Total;ReadOnly=False
Matriz de Ponto PI \\MyPIDataArchiveServer\Point.1|Point.2|Point.3
Construtor de String "%Attribute% value is";'Attribute1';
Table Lookup SELECT Density FROM [Material Specifications] WHERE
MaterialID = @Product
URI Builder https://MyDataServer.int:443/Vision/#Displays/215915/Mine-
Truck-10-Brake-Temp?Asset=\\%System%\%Database%\%Element
%&StartTime=03%2F21%2F2016 09:26:00&EndTime=&Mode=kiosk

Nesta seção
• Strings de configuração para referências de dados do PI Point
• Sintaxe de caminho para referências a outros atributos

Strings de configuração para referências de dados do PI Point

A string de configuração dos atributos para as referências de dados de ponto PI deve conter o
caminho para o ponto. A string também pode conter parâmetros que especificam o valor que a
referência de dados retorna. Se especificada em um template de atributo, a string pode conter
parâmetros que especificam o ponto a ser criado. Na string, os parâmetros são separados por
ponto-e-vírgula.

Exemplos
• Referência simples a um ponto em um servidor PI Data Archive chamado
MyPIDataArchiveServer:
\\MyPIDataArchiveServer\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:
\\MyPIDataArchiveServer\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:
\\MyPIDataArchiveServer\sinusoid;TimeMethod=NotSupported;
TimeRangeMethod=Total;RateConversion=day
• String de configuração de um template de atributo que usa parâmetros de substituição:

130 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

\\%Server%\%Element%.%Attribute%
• Mesma string de configuração, mas com criação de tag habilitada e configuração da tag
especificada:
\\%Server%\%Element%.%Attribute%;ptclassname=classic;pointtype=Float32;
engunits=m3/s;location1=1;location2=30;location4=1;location5=1;pointsource=R

Parâmetros de referência de dados que especificam valores a serem

retornados
As strings de configuração para as referências de dados de ponto PI podem incluir parâmetros
opcionais que especificam o valor que a referência de dados retorna. A tabela a seguir lista os
parâmetros disponíveis:
Parâmetro Sintaxe Exemplo
TimeMethod TimeMethod=time_method TimeMethod=Automatic
em que time_method é um dos seguintes:
• After
• AtOrAfter
• Before
• AtOrBefore
• Automatic
• ExactTime
• Interpolated
• NotSupported
• TimeRange
• TimeRangeOverride

RelativeTime RelativeTime=[*] +|- integer time_unit RelativeTime=-1h

em que time_unit é um dos seguintes:
• y
• M
• d
• h
• m
• s

TimeRangeMethod TimeRangeMethod=method_name TimeRangeMethod=Total

em que method_name é um dos seguintes
• Maximum
• Minimum
• PopulationStandardDeviation
• Range
• StandardDeviation
• StartTime
• Total

TimeRangeMinPercentGood1 TimeRangeMinPercentGood= percentage

Guia do Usuário do PI System Explorer 131

Configuração de referências de dados

Parâmetro Sintaxe Exemplo

CalculationBasis1 CalculationBasis= calculation_basis
em que calculation_basis é um dos seguintes:
• EventWeighted
• EventWeightedExcludeEarliestEvent
• EventWeightedExcludeMostRecentEvent
• EventWeightedIncludeBothEnds
• TimeWeighted
• TimeWeightedContinuous
• TimeWeightedDiscrete

RateConversion2 RateConversion=uom RateConversion=minute

em que uom é uma unidade de medida definida

CaseMethod CaseMethod=case_method CaseMethod=EndTime

em que case_method é um dos seguintes:
• StartTime
• EndTime
• TimeRange
• Automatic

UOM UOM=uom UOM=°C

em que uom é uma unidade de medida definida

ReadOnly ReadOnly=boolean ReadOnly=false

em que boolean é um dos seguintes:
• true
• false
1 Usado ao especificar o TimeRangeMethod.

2 Usado apenas quando TimeRangeMethod=Total.

Parâmetros de referência de dados que especificam o ponto PI a ser

criado
Nos templates de atributos que especificam novos pontos PI, as strings de configuração para as
referências de dados de ponto PI incluem parâmetros que especificam o tipo de ponto a ser
criado. Os parâmetros de criação de ponto consistem em um atributo de ponto e um valor. Para
especificar um novo ponto PI, os templates de atributo devem incluir o atributo pointtype
como parâmetro; outros atributos são opcionais.

Exemplos
• Crie um ponto PI do tipo Float64 e use as configurações padrão para o restante da
configuração do ponto:
\\%Server%\%Element%.%Attribute%;pointtype=Float64
• Crie um ponto PI que configure os atributos de ponto mostrados na tabela a seguir:
Atributo de ponto Configuração
ptclassname classic
pointtype Float32
pointsource R

132 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Atributo de ponto Configuração

location4 1
location5 2
span 200
zero 1100

\\%Server%\%Element%.%Attribute%;ptclassname=classic;pointtype=Float32;
location4=1;location5=2;pointsource=R;span=200;zero=1100

Sintaxe de caminho para referências a outros atributos

Para referenciar outros atributos, usam-se caminhos que localizam os atributos no servidor, no
banco de dados e no elemento nos quais eles residem.
• Use um caminho absoluto para especificar o servidor atual, o banco de dados e o elemento
em que um atributo está localizado. Por exemplo:
\\MyPIDataArchive\MyAFDatabase\MyElement|Attribute1
• Use um caminho relativo para identificar um atributo com base em seu nome e lugar na
hierarquia de elementos e atributos. Por exemplo:
..\Element2|Attribute1

Componentes de um caminho
Um caminho é composto de partes, sendo que cada parte representa um objeto ou uma lista de
objetos. Cada parte do caminho normalmente é separada por uma única barra invertida (\),
com as seguintes exceções:
• Os atributos do PI AF e templates de atributo do PI AF são precedidos pelo caractere de
barra vertical (|).
• O PI Data Archive é precedido por duas barras invertidas (\\).
Você pode especificar um PI Data Archive e um banco de dados por nome ou por identificador
global exclusivo (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

Nesta seção
• Sintaxe de caminho para computadores do PI Data Archive
• Sintaxe de caminho para bancos de dados do PI AF
• Sintaxe para caminhos relativos
• Sintaxe de caminho para objetos dinâmicos
• Sintaxe de caminho para tipos de coleção
• Sintaxe de caminho para filtros
• Caracteres coringa nos filtros de Nome

Guia do Usuário do PI System Explorer 133

Configuração de referências de dados

Sintaxe de caminho para computadores do PI Data Archive

Para indicar um caminho totalmente qualificado do PI Data Archive, inicie o caminho com duas
barras invertidas (\\) seguidas pelo PI Data Archive.
Para indicar o sistema atual, comece um caminho relativo com duas barras invertidas seguidas
por um ponto (\\.). Por exemplo, para fazer referência a um banco de dados chamado
Database2 no sistema atual, digite:
\\.\Database2

Para especificar uma coleção de PI Data Archives, use o seguinte formato:

\\PIDataArchives[MyPIDataArchiveName]

Sintaxe de caminho para bancos de dados do PI AF

O banco de dados do PI AF segue a especificação do PI Data Archive.
Você pode iniciar um caminho relativo com uma única barra invertida (\) para indicar o banco
de dados atual. Por exemplo, os caminhos a seguir fazem referência a objetos no banco de
dados atual:
\Element2
\Tables[MyTable]

Nota:
É possível 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]

Sintaxe para caminhos relativos

Use dois pontos finais (..) para indicar o objeto pai. O exemplo a seguir faz referência a
Attribute1 de Element2 que está no banco de dados atual:
..\Element2|Attribute1

O ponto isolado (.) representa o objeto atual. É possível usá-lo para criar um caminho relativo
pelo objeto atual.
• Quando o objeto atual é um atributo PI AF, um ponto único seguido por uma barra invertida
(.\) representa o elemento PI AF de propriedade. Por exemplo:
.\|Attribute1
• Um ponto único seguido por uma barra vertical (.|) faz referência a um atributo filho PI AF,
por exemplo:
.|Attribute1|Attribute2
• Quando o objeto atual é um elemento do PI AF, um caminho relativo é criado do banco de
dados, por exemplo:
\Element1\Element2|Attribute1

Sintaxe de caminho para objetos dinâmicos

Caminhos para objetos dinâmicos também são aceitos. Para criar um atributo de matriz do
ponto PI com os valores Sinusoid e Sinusoidu, por exemplo:
PI Point Array.\\piserver2\sinusoid|sinusoidu

134 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Se o caminho direciona a um ponto PI, um atributo dinâmico é criado. Para criar um atributo
com a referência de dados configurada para ler valores do ponto PI Sinusoid, por exemplo:
\\piserver2\sinusoid

Sintaxe de caminho para tipos de coleção

Cada objeto pai tem um tipo de coleção padrão. Por exemplo, um PI Data Archive tem uma
coleção padrão de bancos de dados, e um banco de dados do PI AF tem uma coleção padrão de
elementos.
Use um período simples entre chaves ([.]) para representar o objeto padrão do objeto pai. O
seguinte exemplo se refere a Element1 do banco de dados padrão no sistema atual:
\\.\Databases[.]\Element1

Sintaxe de caminho para filtros

Um filtro de coleção é iniciado com o sinal de arroba (@) seguido pelo nome do filtro. Estes são
os filtros suportados: @Category, @Description, @Index, @Name, @ReferenceType,
@Template, @Trait, @Type e @UOM.
A especificação do filtro deve estar entre colchetes ([ e ]).
Também é possível especificar vários filtros, que são avaliados na ordem especificada. Por
exemplo:
\\MySystem\MyDatabase\Elements[@Template=Tank][@Category=Tutorial]|
Attributes[@Category=Tutorial]

Exemplo de filtro de categoria

O seguinte exemplo retorna o atributo Volume de todos os elementos na categoria, Tutorial,
que pertence ao banco de dados chamadoMyDatabase:
\\MySystem\Databases[MyDatabase]\Elements[@Category=Tutorial]|Volume

Exemplo de filtro de tipo

O exemplo a seguir retorna os atributos de Element1 que são do tipo Int32:
\Element1|Attributes[@Type=System.Int32]

Exemplo de filtro de unidade de medida

O seguinte exemplo retorna os atributos de Element1 que têm metros como a unidade de
medida:
\Element1|Attributes[@UOM=meter]

Exemplo de filtro de índice

Use o filtro de índice [@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 do PI AF no sistema atual:
\\Systems[MySystem]\Databases[@Index=3]

O nome do filtro de índice é opcional quando outro filtro é especificado antes dele. Por
exemplo:
\Element#1\Elements[@Name=Tank*][3]

Guia do Usuário do PI System Explorer 135

Configuração de referências de dados

Caracteres coringa nos filtros de Nome

Você pode inserir um caractere coringa de asterisco (*) no nome de qualquer objeto para que
ele corresponda a zero ou mais objetos.
Nota:
Para corresponder a um asterisco literal, preceda o asterisco por uma barra invertida
(\*).

Exemplos
\\MySystem\MyDatabase\[@Name=E*]
\\MySystem\MyDatabase\Elements[@Name=E*][@Index=3]

Parâmetros de substituição em referências de dados

Os parâmetros de substituição são variáveis que você coloca nos templates de atributos para
referências de dados como tag do PI, String Builder e URI Builder. O PI AF resolve os
parâmetros de substituição quando cria a referência de dados para um atributo com base nesse
template. Por exemplo, podem-se usar os parâmetros de substituição:

• Para configurar um template de referência de dados do ponto PI 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 ponto
PI.

Vídeos
Para obter informações sobre como usar parâmetros de substituição em templates, assista a
este vídeo:
https://www.youtube.com/watch?v=8jpOjDRwQf0
Para obter informações sobre como usar parâmetros de substituição à medida que você cria
tags do PI, assista a este vídeo:
https://www.youtube.com/watch?v=pTo9nd_L4vI

Nesta seção
• Símbolos usados em parâmetros de substituição
• Substituições de nome
• Referências a valores de atributos
• Lista de parâmetros de substituição do PI AF
• Strings de formato para os parâmetros de substituição de tempo
• Localizar o PI Data Archive padrão

Símbolos usados em parâmetros de substituição

Use os símbolos na tabela a seguir para construir um parâmetro de substituição.
Símbolo Descrição Exemplos
%…% Considera a expressão como um %Element%
parâmetro substituto.
%Attribute%

136 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Símbolo Descrição Exemplos

. Elemento ou atributo atual. Use .\ %.\ChildElement|Attribute%
para navegar até o elemento atual.
Use .| para navegar para atributos
filhos do atributo atual.
.. Navega um nível acima. %..\..\Element%
%..|Attribute%

\ Separa componentes de um %..\Element%

caminho, exceto atributos.
| Separa atributos em um caminho.
@ Referencia o valor do objeto em vez
de seu nome.
Nota:
Apenas referências do ponto
PI usam a sintaxe de
substituição de valores de
atributos. Outras referências
de dados, como fórmula,
pesquisa em tabela e string
personalizada, têm uma
sintaxe mais simples para
referenciar os valores de
atributo.
%..|Attribute%
• Valor do atributo no mesmo nível do atributo:
%@Attribute%
• Valor do atributo no nível raiz do mesmo elemento:
%@|Attribute%
• Valor do atributo no nível do atributo pai:
%@..|Attribute%
• Valor do atributo no nível do elemento pai:
%@..\|Attribute%
• Valor do atributo secundário do mesmo elemento:
%@.|Attribute%
• Valor do atributo do elemento secundário:
%@.\ChildElement\ChildOfChild|Attribute%
• Valor do atributo do elemento primário de estrutura
de evento:
%@.\Elements[.]|Attribute%

Substituições de nome
Ao usar uma substituição de nome, o PI AF executa 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 lista os parâmetros de substituição
disponíveis e o que eles representam. Por exemplo, %Element% é um parâmetro de
substituição que representa o nome do elemento. Depois de criar um elemento com base nesse
template, você configura o PI AF para criar a referência de dados (Atualizações de valor do
atributo das referências de dados da tag do PI). Quando o PI AF cria a referência, ele substitui o
nome do elemento atual sempre que a configuração disser %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

Referências a valores de atributos

Ao configurar um atributo de referência de dados do ponto PI, é possível usar parâmetros de
substituição para fazer referência ao valor de outro atributo. É possível usar referências do

Guia do Usuário do PI System Explorer 137

Configuração de referências de dados

valor de atributo para especificar um valor na caixa Tempo relativo ou na configuração do

atributo do ponto para pontos PI gerados automaticamente. A sintaxe é:
%@AttributeName%

onde 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ências indiretas do ponto do PI para definir o
caminho para o atributo desejado.
O PI AF não atualiza o valor do atributo com o passar do tempo. Quando uma substituição é
utilizada no nome da tag, o valor é resolvido apenas no momento em que a referência de dados
é carregada. Se um parâmetro de substituição for usado para definir os atributos de ponto, o PI
AF utiliza o valor do atributo no momento exato em que você criou ou atualizou a referência
dos dados (consulte Atualizações de valor do atributo das referências de dados da tag do PI
para obter mais informações). Esse valor é uma constante. O PI AF não avalia esse valor 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 ponto PI (consulte Criar intervalos de
durações configuráveis).

Lista de parâmetros de substituição do PI AF

O PI AF interpreta vários parâmetros de substituição.

Parâmetros de substituição de nome

A tabela a seguir lista os parâmetros de substituição de nome com suporte do PI AF:
Nome do parâmetro Substituição
%Analysis% Nome de análise, se for possível ser obtido do contexto.
%Attribute% Nome do atributo ou template do atributo que contém esta
referência de dados.
%|Attribute% Nome do atributo raiz ou template do atributo que contém esta
referência de dados.
%..|Attribute% Nome do atributo pai ou template do atributo que contém esta
referência de dados.
%Database% Nome do banco de dados do PI AF no qual o atributo reside.
%Destination% Nome do elemento de destino para a transferência no qual o atributo
reside.
%Element% Nome do elemento no qual o atributo reside. Para estruturas de
evento, refere-se ao nome do elemento referenciado primário.
%\Element% Nome do elemento raiz no qual o atributo reside.
%..\Element% Nome do elemento pai do elemento no qual o atributo reside. Para
recuperar ancestrais adicionais, use a notação ..\, como %..\..
\Element%.
%EventFrame% Nome do event frame no qual o atributo reside.
%\EventFrame% Nome do event frame raiz no qual o atributo reside.
%..\EventFrame% Nome da estrutura de evento pai na qual o atributo reside. Para
recuperar ancestrais adicionais, use a notação ..\, como %..\..
\EventFrame%.
%Model% Nome do modelo, se for possível obtê-lo do contexto.

138 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Nome do parâmetro Substituição

%Server% Nome do PI Data Archive padrão do computador no qual o atributo é
criado. Durante a criação do atributo no PI System Explorer, esse é o
PI Data Archive padrão do computador no qual o PI System Explorer
está em execução.
Nota:
O parâmetro %Server% não resolve para o computador em que
o banco de dados do PI AF reside. O parâmetro %Server% pode
resolver para um PI Data Archive diferente, dependendo do
padrão no PI AF Client.

%Source% Nome do elemento de origem para a transferência no qual o atributo

reside.
%System% Nome do servidor ou coletivo do PI AF no qual o atributo reside.
%Template% Nome do template no qual o elemento ou event frame se baseia. Por
exemplo, se você criou o elemento Valve101 a partir de um
template denominado Valve, o texto de substituição seria Valve.
%\Template% Nome do template raiz no qual o elemento ou a estrutura de evento
se baseia.
%..\Template% Nome do template pai no qual o elemento ou a estrutura de evento
se baseia. Para recuperar ancestrais adicionais, use a notação ..\,
como %..\..\Template%.
%Transfer% Nome da transferência na qual o atributo reside.

Parâmetros de substituição do tempo

O PI AF oferece suporte a parâmetros de substituição que especificam um determinado tempo
e fuso horário, dependendo do contexto. Opcionalmente, é possível aumentar esses parâmetros
suportados incluindo uma string de formato que especifica o formato da string de tempo.
Consulte Strings de formato para os parâmetros de substituição de tempo.
A tabela a seguir lista os parâmetros de substituição de tempo com suporte do PI AF:
Nome do parâmetro Substituição
%Duration% Informações de Data e Hora entre a hora de início e a hora de
término, caso possam ser obtidas a partir do contexto do horário.
Em estruturas de evento abertas, obtém as informações de Data e
Hora da hora de início até o horário atual. As informações de Data e
Hora usam um formato diferente de outros parâmetros de
substituição de hora.
• É possível usar formatos padrão como “c” (constante), “g” (geral,
curto) ou “G” (geral, longo), por exemplo: %Duration:c%. Para
obter mais informações, consulte o artigo da MSDN Cadeias de
caracteres de formato TimeSpan padrão (https://
msdn.microsoft.com/en-us/library/ee372286).
• Também é possível usar um formato de informações de Data e
Hora personalizado, conforme descrito no artigo da MSDN
Cadeias de caracteres de formato TimeSpan personalizado
(https://msdn.microsoft.com/en-us/library/ee372287).
Observe que é necessário definir os símbolos que separam dias
de horas, e assim por diante, com uma string literal. Por exemplo,
%Duration:d\.hh\:mm\:ss% define um ponto final (.) como
separador entre dias e horas, e dois pontos (:) como separador de
horas, minutos e segundos.

Guia do Usuário do PI System Explorer 139

Configuração de referências de dados

Nome do parâmetro Substituição

%EndTime% Hora de término local, se for possível ser obtida do contexto
temporal. Para objetos com base em event frame que ainda não
tenham um horário de término especificado, o resultado é uma
string vazia.
%StartTime% Hora de início local, se for possível ser obtida do contexto temporal.
%Time% Hora local, se for possível ser obtida do contexto temporal.
%UtcEndTime% Hora de término do Horário Universal Coordenado (UTC), se for
possível ser obtida a partir do contexto temporal. Para objetos com
base em event frame que ainda não tenham um horário de término
especificado, o resultado é uma string vazia.
%UtcStartTime% Hora de início do Horário Universal Coordenado (UTC), se for
possível ser obtida a partir do contexto temporal.
%UtcTime% Hora do Horário Universal Coordenado (UTC), se for possível ser
obtida a partir do contexto temporal.

Parâmetros de substituição de ID
A tabela a seguir lista os parâmetros de substituição de ID com suporte do PI AF:
Nome do parâmetro Substituição
%AnalysisId% ID da análise à qual o atributo está associado.
%AttributeId% ID do atributo que mantém essa referência de dados.
%|AttributeId% ID do atributo raiz ou template do atributo raiz no qual o atributo
reside.
%..|AttributeId% ID do atributo pai ou template do atributo pai no qual o atributo
reside. Ancestrais adicionais podem ser recuperados usando a
notação ..|, como %..|..|AttributeId%.
%DatabaseId% ID do banco de dados no qual o atributo reside.
%ElementId% ID do elemento no qual o atributo reside. Para estruturas de eventos,
refere-se ao ID do elemento referenciado primário.
%\ElementId% ID do elemento raiz no qual o atributo reside. Para event frames, isso
refere-se ao ID do elemento referenciado primário do event frame
raiz no qual o atributo reside.
%..\ElementId% ID do elemento pai no qual o atributo reside. Para event frames, isso
refere-se ao ID do elemento referenciado primário do event frame
pai no qual o atributo reside. Ancestrais adicionais podem ser
recuperados usando a notação ..\, como %..\..\ElementId%.
%EventFrameId% ID do event frame no qual o atributo reside.
%\EventFrameId% ID do event frame raiz no qual o atributo reside.
%..\EventFrameId% ID do event frame pai no qual o atributo reside. Ancestrais adicionais
podem ser recuperados usando a notação ..\, como %..\..
\EventFrameId%.
%Id% ID de objeto.
%ModelId% ID do modelo no qual o atributo reside.
%SystemId% ID do servidor do PI AF no qual o atributo reside.
%TransferId% ID da transferência na qual o atributo reside.

Parâmetros de substituição de descrição

A tabela a seguir lista os parâmetros de substituição de descrição com suporte do PI AF:

140 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Nome do parâmetro Substituição

%Description%
%|Description%
%..|Description%
%ElementDescription%
%\ElementDescription%
%..\ElementDescription%
%EventFrameDescription%
%\EventFrameDescription%
%..\EventFrameDescription%
Descrição do atributo que contém essa referência de dados.
Descrição do atributo pai ou template do atributo pai no qual o
atributo reside.
Descrição do atributo raiz ou template do atributo raiz no qual o
atributo reside. Ancestrais adicionais podem ser recuperados
usando a notação ..|, como %..|..|Description%.
Descrição do elemento no qual o atributo reside.
Descrição do elemento raiz no qual o atributo reside. Para event
frames, isso refere-se à descrição do elemento referenciado
primário do event frame raiz no qual o atributo reside.
Descrição do elemento pai no qual o atributo reside. Para event
frames, isso refere-se à descrição do elemento referenciado
primário do event frame pai no qual o atributo reside. Ancestrais
adicionais podem ser recuperados usando a notação ..\, como
%..\..\ElementDescription%.
Descrição do event frame no qual o atributo reside.
Descrição do event frame raiz no qual o atributo reside.
Descrição do event frame pai no qual o atributo reside. Ancestrais
adicionais podem ser recuperados usando a notação ..\, como
%..\..\EventFrameDescription%.

Parâmetros de substituição de caminho

As substituições de caminho geralmente não podem ser usadas para criar referências a outros
atributos porque elas contêm caracteres de barra invertida. Os parâmetros de substituição de
Caminho são mais úteis nas Referências em String Personalizado ao construir caminhos para a
saída para as strings. O caminho que é produzido não inclui o servidor ou o banco de dados do
PI AF.
A tabela a seguir lista os parâmetros de substituição de caminho com suporte do PI AF:
Nome do parâmetro Substituição
%ElementPath% Caminho do elemento base, do elemento de um atributo ou do
elemento referenciado primário de um event frame.
%..\ElementPath% Caminho do elemento pai no qual o atributo reside. Para event
frames, isso refere-se ao caminho do elemento referenciado
primário do event frame pai no qual o atributo reside. Ancestrais
adicionais podem ser recuperados usando a notação ..\, como %..
\..\ElementPath%.
%EventFramePath% Caminho do event frame ou do elemento de um atributo de um event
frame.
%..\EventFramePath% Caminho do event frame pai no qual o atributo reside. Ancestrais
adicionais podem ser recuperados usando a notação ..\, como %..
\..\EventFramePath%.

Parâmetro de variável de ambiente

A tabela a seguir lista os parâmetros de variável de ambiente com suporte do PI AF:
Nome do parâmetro Substituição
%Environment Variable% Valor da variável de ambiente de sistema correspondente. Por
exemplo, %COMPUTERNAME% é substituído pelo nome do computador
no qual a referência de dados está sendo executada.

Guia do Usuário do PI System Explorer 141

Configuração de referências de dados

Strings de formato para os parâmetros de substituição de tempo

Nos parâmetros de substituição de tempo, é possível incluir uma string de formato que
especifica o formato da string de tempo.

Formato padrão de data e hora

Use qualquer string de formato padrão suportada pelo método DateTime.ToString, descrito
no artigo do MSDN Strings padrão de formato de data e hora (https://msdn.microsoft.com/en-
us/library/az4se3k1%28v=vs.110%29.aspx#Sortable). Na especificação do parâmetro de
substituição do tempo, separe a substituição e a string de formato com dois-pontos. Por
exemplo, o %TIME:d% especifica a hora local em um padrão de data abreviada.
A tabela a seguir fornece uma descrição resumida das strings de formato do DateTime:
Especificador de Descrição Exemplo
formato
d Padrão de data abreviada 15/06/2009 (en-US)
15/06/2009 (fr-FR)
15/06/2009 (ja-JP)

D Padrão de data por extenso segunda-feira, 15 de junho de 2009 (en-

US)
Montag, 15. Juni 2009 (de-DE)

f Padrão de data/hora completa (hora Segunda-feira, 15 de junho de 2009

abreviada) 13:45 (pt-BR)
F Padrão de data/hora completa (hora Segunda-feira, 15 de junho de 2009
longa) 13:45:30 (pt-BR)
g Padrão de data/hora geral (hora 15/06/2009 13:45 (pt-BR)
abreviada)
15/06/2009 13:45 (es-ES)
2009/6/15 13:45 (zh-CN)

G Padrão de data/hora geral (hora longa) 15/06/2009 13:45:30 (pt-BR)

15/06/2009 13:45:30 (es-ES)
2009/6/15 13:45:30 (zh-CN)

m Padrão de mês/dia 15 de junho (pt-BR)

O, o Padrão de data/hora de ida e volta 2009-06-15T13:45:30.0000000-07:00
R, r Padrão RFC1123 Seg, 15 Jun 2009 20:45:30 GMT
s Padrão de data/hora classificável 2009-06-15T13:45:30
t Padrão de hora abreviada 13:45 (en-US)
T Padrão de hora longa 13:45:30 (en-US)
u Padrão de data/hora universal 2009-06-15 20:45:30Z
classificável
U Padrão de data/hora universal completo Segunda-feira, 15 de junho de 2009
20:45:30 (pt-BR)
Y, y Padrão de mês/ano Junho de 2009 (pt-BR)
Qualquer outro Especificador desconhecido
caractere único

142 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Formato personalizado de data e hora

Você também pode construir padrões personalizados na string do formato de data e hora
usando especificadores de tempo descritos no artigo do MSDN Strings personalizadas do
formato de data e hora (https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.
110).aspx). Por exemplo, o %TIME:yyyy/MM/dd HH:mm:ss.ffffff% produz uma saída
semelhante a 31/03/2015 09:28:03.843512.

Localizar o PI Data Archive padrão

O parâmetro de substituição %Server% resolve o nome do PI Data Archive padrão do
computador no qual o atributo foi criado. Se você criar o atributo no PI System Explorer, esse é
o PI Data Archive padrão do computador no qual o PI System Explorer está em execução.
Nota:
Como o parâmetro %Server% pode resolver para um PI Data Archive diferente com base
no cliente, ele não é recomendado para instalações que possam ter mais que um PI Data
Archive disponível.

Procedimento
1. No computador em que o PI System Explorer está em execução, abra o PI SDK Utility. Com
os padrões de instalação do PI Data Archive, você escolheria Iniciar > Todos os programas >
PI System > Sobre o PI-SDK
2. Na janela PI SDK Utility, escolha Arquivo > Conexões.
3. Na janela PI Connection Manager, escolha Conexões > Opções. A janela Opções de conexão é
aberta com o servidor padrão listados em Configurações padrão do servidor.

Referências de dados do ponto do PI

Uma referência de dados de ponto do PI é uma referência de um atributo PI AF a um ponto do
PI. 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. É possível criar uma referência de
dados do ponto PI para:

• Um atributo de elemento ou template do atributo do elemento

• Um atributo de transferência ou template do atributo de transferência
• Um atributo de event frame ou template do atributo de event frame
Uma referência de dados do ponto do PI a um template de atributo tem recursos extras. Ao
criar uma referência de dados do ponto PI em um template de atributo, é possível:

• Criar automaticamente tags referenciadas por atributos baseados no template.

• Criar um esquema de nomeação para atributos baseados no template para que os atributos
criados com base nele tenham nomes exclusivos conforme uma estrutura consistente.
Para fazer referência ao ponto do PI, use uma referência direta ou indireta. Existem dois
métodos rápidos para criar uma referência direta, enquanto você precisa usar a janela
Referência de dados do ponto do PI para criar uma referência direta mais complexa ou uma
referência indireta.

Vídeos
Para obter informações sobre como configurar referências de dados da tag do PI, assista a este
vídeo:

Guia do Usuário do PI System Explorer 143

Configuração de referências de dados

https://www.youtube.com/watch?v=CRejcRe22SA
Para obter informações sobre UDMs em referências de dados da tag do PI, assista a este vídeo:
https://www.youtube.com/watch?v=023T5si2Dtw

Nesta seção
• Referência direta do ponto do PI
• Referências indiretas do ponto do PI
• Criar referências de dados do ponto do PI direto a partir dos resultados da pesquisa de tag
• Configurar referências de dados do ponto do PI direto ou indireto
• Considerações da unidade de medida
• Configuração dos métodos de recuperação para valores do atributo
• Atualizações do valor do ponto PI de uma referência de dados
• Atualizações de valor do atributo das referências de dados da tag do PI
• Configurar a criação automática de pontos PI
• Editar propriedades do ponto do PI
• Visualizar parâmetros de substituição nas referências de dados do ponto PI

Referência direta do ponto do PI

Na string de configuração, uma referência de dados direta usa duas barras invertidas (\\) para
fazer referência a um ponto do PI em um PI Data Archive. Por exemplo, a seguinte string de
configuração faz referência ao ponto sinusoide em um PI Data Archive chamado MyPIServer:
\\MyPIServer\sinusoid

Nos templates de atributo, também é possível usar os parâmetros de substituição na

referência. Por exemplo, a seguinte string de configuração faz referência ao ponto sinusoide no
PI Data Archive padrão do banco de dados PI AF para o atributo:
\\%Server%\sinusoid

Para obter mais informações sobre parâmetros de substituição, consulte Parâmetros de

substituição em referências de dados.

Referências indiretas do ponto do PI

É 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 ponto do PI 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.
Usado em combinação com templates, isso reduz significativamente a quantidade de
configuração necessária por instância do elemento.

144 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Caminho relativo
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 do ponto PI, 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 do ponto do PI.
A seguinte tabela mostra as configurações comuns das referências indiretas:
Objeto Sintaxe de amostra
Atributo de nível superior do |topLevelAttribute
mesmo elemento
Atributo pai ..
Atributo filho .|childAttribute
Atributo irmão (quando não for ..|siblingAttribute
um atributo de nível superior)
Da estrutura de evento para o .\Elements[.]|Attribute
elemento pai
Da estrutura de evento para o .\Elements[.]\..\|Attribute
atributo de elemento pai
Da estrutura de evento para o .\Elements[.]\ChildElementName|Attribute
atributo de elemento filho
Caminho do banco de dados \TopLevelElement|myAttribute
Caminho completo \\myServer\myDatabase\myElement|myAttribute

Para obter detalhes adicionais sobre a sintaxe do caminho relativo, consulte Sintaxe de
caminho para referências a outros atributos.

Criar referências de dados do ponto do PI direto a partir dos resultados da

pesquisa de tag
Você pode arrastar uma tag do PI dos resultados da Pesquisa por Tag na paleta para configurar
o nome, a descrição (se a tag do PI tiver um descritor) e o tipo de uma referência de dados de
tag do PI. Se a propriedade de unidades de engenharia da tag do PI corresponder a uma
unidade de medida existente, incluindo maiúsculas e minúsculas, o campo UDM padrão
também será configurado.

Procedimento
1. Para configurar uma referência de dados do ponto do PI:
◦ No navegador de Elementos, selecione o elemento desejado.
◦ Em um template de elemento, selecione o template de elemento desejado no navegador
de Biblioteca.
2. Clique na guia Atributo ou Templates de atributo, selecione o atributo.

Guia do Usuário do PI System Explorer 145

Configuração de referências de dados

3. Selecione Visualizar > Paleta > Pesquisa por Tag ou pressione CTRL+SHIFT+8.
4. Na janela Pesquisa por Tag, crie uma consulta de pesquisa para recuperar as tags do PI que
você deseja usar como referências de dados. Para obter mais informações sobre como
pesquisar tags do PI, consulte Pesquisar pontos PI e Sintaxe para pesquisas por tags do PI.
5. Clique em Pesquisar para obter as tags correspondentes na tabela de resultados.
6. Faça o seguinte:
◦ Para criar um novo atributo, arraste uma tag do PI dos resultados da pesquisa para a
grade Atributos. Um novo atributo configurado como uma referência de dados baseada
na tag do PI é adicionado à grade.
◦ Para configurar um atributo existente, selecione o atributo no visualizador e arraste uma
tag do PI dos resultados da pesquisa para o campo Configurações do atributo, para
configurar o atributo como uma referência de dados baseada na tag do PI.
7. Clique em Fazer check-in para salvar a nova referência de dados.

Configurar referências de dados do ponto do PI direto ou indireto

Use a janela Referência de dados do ponto do PI para configurar referências de dados do ponto
do PI nos atributos do elemento.

Procedimento
1. Na guia Atributos no visualizador, selecione um atributo.
2. Na seção de configuração do atributo, selecione Ponto PI na lista Referência de dados.
3. Clique em Configurações.
Dica:
Você pode clicar no campo Configurações e inserir um nome de tag para criar uma
referência de dados de ponto do PI direto no formato \\serverName\tagname. O PI
System Explorer recupera o nome da tag do PI Data Archive padrão. Por exemplo, se
você inserir sinusoid, a referência de dados do ponto do PI exibe \
\yourDefaultDataArchive\sinusoid.
4. Na janela Referência de dados do ponto do PI, escolha entre as seguintes ações para criar a
referência de dados.

146 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Para... Faça o seguinte...

Criar uma referência de dados do ponto do PI
direto
Criar uma referência de dados do ponto do PI
indireto
a. Deixe o servidor padrão ou escolha um PI
Data Archive diferente na lista Servidor de
dados.
Nota:
Se o PI Data Archive desejado não aparecer
na lista, clique em e selecione um PI
Data Archive na janela Arquivos de dados do
PI.
b. No campo Nome da tag, digite o nome do
ponto ou clique em para procurar um
ponto no PI Data Archive selecionado.
Dica:
É possível inserir um parâmetro de
substituição em vez do nome da tag. Se
você estiver criando uma referência em um
template de atributo, é possível usar
parâmetros de substituição nos campos
Servidor de dados e Nome da tag. Consulte
Lista de parâmetros de substituição do PI
AF.
a. Escolha a opção Atributo.
b. Digite um caminho relativo para o atributo ou
selecione um caminho na lista suspensa
atributos que têm referências de dados do
ponto do PI.
Para digitar um caminho, use a sintaxe
descrita em Referências indiretas do ponto
do PI. O atributo que é referenciado também
deve ter uma referência de dados da tag do
PI.

5. Opcional. Especifique as unidades que o ponto do PI referenciado usa. Consulte

Considerações da unidade de medida.
Nota:
Para totais ponderados no tempo nos atributos da referência de dados da tag do PI
referenciados, selecione uma UDM na lista Unidades de origem que corresponda à
UDM do atributo de origem. Mesmo que as unidades da origem padrão pareçam
corresponder à UDM do atributo de origem, não selecione <Default>; em vez disso,
selecione a UDM codificada apropriada na lista.
6. Na seção Métodos de recuperação do valor, 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 dos métodos de
recuperação para valores do atributo.
7. Use a caixa de seleção Somente leitura para especificar se o PI AF deve gravar o valor do
atributo novamente no ponto de origem. Por padrão, o PI AF não grava dados no ponto do
PI referenciado (a caixa de seleção Somente leitura está marcada). Consulte Atualizações do
valor do ponto PI de uma referência de dados.

Guia do Usuário do PI System Explorer 147

Configuração de referências de dados

Considerações da unidade de medida

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

Configuração dos métodos de recuperação para valores 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.

Vídeos
Para obter informações sobre como recuperar valores agregados nas referências de dados de
tag do PI, assista a este vídeo:
https://www.youtube.com/watch?v=GU3kp7W7a6w
Para obter informações sobre como recuperar um único valor em uma referência de dados de
tag do PI, com deslocamento de um período, assista a este vídeo:
https://www.youtube.com/watch?v=4Mv5aZWz2j8

Nesta seção
• Tempo relativo
• Configurar a recuperação de valor por tempo
• Configurar a recuperação de valor por intervalo de tempo
• Intervalos de tempos para estruturas de eventos e transferências

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

148 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

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 na lista Por tempo.
Opção Descrição
Após Retorna o primeiro valor registrado depois do
tempo solicitado pelo aplicativo cliente.
Em ou Antes Retorna um valor registrado 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 Retorna um valor registrado no tempo solicitado
pelo aplicativo cliente. Se não houver nenhum
valor no tempo especificado, o próximo valor
gravado será retornado.
Automático Retorna um ponto contínuo (atributo step = 0)
tratado como Interpolado, enquanto um ponto
discreto (atributo step = 1) é tratado como "Em
ou Antes".
Antes Retorna o primeiro valor registrado antes do
tempo solicitado pelo aplicativo cliente.
Tempo exato Retorna um valor registrado no tempo solicitado
pelo aplicativo cliente. Se não houver nenhum
valor gravado no momento, um erro será
retornado.
Interpolado Retorna um valor interpolado para o 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 Substituição do
intervalo de tempo. Essas opções destinam-se aos valores do atributo baseados nos
cálculos do intervalo de tempo.
2. Deixe o campo Tempo relativo vazio, exceto se desejar configurar um atraso de tempo.
3. Na lista Por intervalo de tempo, selecione Hora de término.
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.

Guia do Usuário do PI System Explorer 149

Configuração de referências de dados

Procedimento
1. Faça as configurações Recuperação de valor, conforme descrito em Configurar a
recuperação de valor por tempo.
2. No campo Tempo relativo, digite o tempo relativo do atraso. Use a expressão de tempo
relativo PI. Consulte Tempo relativo.
Nota:
É possível usar parâmetros de substituição para ler o tempo relativo do valor de outro
atributo. Consulte Referências a valores de atributos.
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 das seguintes opções na lista Por tempo.
Opção Descrição
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 tempo em vez
de um intervalo de tempo. Se essa opção for
selecionada, digite a expressão de tempo relativa
PI no campo Tempo relativo. Consulte Criar
intervalos de tempo padrão para os atributos do
elemento para obter detalhes.
Substituição de 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 para o intervalo (Criar intervalos de
durações configuráveis) ou calcular a duração
dinamicamente (Configurar cálculos dinâmicos
de intervalo de tempo).

2. Selecione uma das seguintes opções na lista Por intervalo de tempo.

Opção Descrição
Média O valor médio no intervalo de tempo.
Contagem Se Base de cálculo estiver configurado para
Ponderado pelo evento, a opção 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.

150 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Máximo O valor máximo no intervalo de tempo.

Nota:
O valor do timestamp exibe a hora em que
o valor máximo ocorreu.

Mínimo O valor mínimo no intervalo de tempo.

Nota:
O valor do timestamp exibe a hora em que
o valor mínimo ocorreu.

Desvio padrão populacional Selecione o desvio padrão populacional 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 você escolher a opção Hora de início, não
poderá escolher Não suportado na lista Por
tempo, caso contrário, a seguinte
mensagem de erro será exibida:
The TimeMethod must be supported
to support the TimeRangeMethod of
"Start Time".

3. Se a lista Base de cálculo for habilitada, selecione uma das opções a seguir.
Nota:
Se você selecionar uma das opções de tempo ponderado para uma totalização, as
unidades de origem serão convertidas em uma taxa. Selecione uma unidade de tempo
na lista ao lado do campo Unidades de origem.

Opção Descrição
Evento ponderado Avalia 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 realizar um cálculo bem-sucedido.
Dois eventos são necessários ao desvio padrão.
Ao manipular os eventos no limite do cálculo, o
PI AF usa as seguintes regras:
◦ Os eventos em ambos os limites são usados
quando há apenas um intervalo de cálculo.
◦ Os eventos na hora de início são incluídos
quando houver múltiplos intervalos e eles
estiverem em ordem crescente de tempo.
◦ Os eventos na hora de término são incluídos
quando houver múltiplos intervalos e eles
estiverem em ordem decrescente de tempo.
Evento ponderado exclui o evento mais recente Comporta-se da mesma forma que Evento
ponderado, exceto na manipulação de eventos no
limite dos intervalos de resumo em um cálculo de
múltiplos intervalos. Use essa opção para
impedir que os eventos no limite dos intervalos
sejam contados duplamente em ambos os
intervalos. Com essa opção, os eventos na hora
de término (hora mais recente) de um intervalo
não são usados nesse intervalo.

Guia do Usuário do PI System Explorer 151

Configuração de referências de dados

Evento ponderado exclui o evento mais antigo
Evento ponderado inclui ambas as extremidades
Tempo ponderado
Tempo ponderado contínuo
Tempo ponderado discreto
Semelhante à opção Evento ponderado exclui o
evento mais recente. Os eventos na hora de início
(hora mais antiga) de um intervalo não são
usados nesse intervalo.
Eventos nas duas extremidades dos limites do
intervalo estão inclusos nos cálculos de evento
ponderado.
Pondera os valores no cálculo pelo tempo no qual
eles são aplicados. A interpolação é baseada no
atributo step do ponto. Eventos interpolados são
gerados nos limites, se necessário.
Aplica a ponderação como no Tempo ponderado,
mas faz todas as interpolações entre valores,
como se eles representassem dados contínuos
(interpolação padrão), independentemente do
atributo step do ponto.
Aplica a ponderação como no Tempo ponderado,
mas faz a interpolação entre valores, como se
eles representassem valores discretos não
relacionados (análise em escada),
independentemente do atributo step do ponto.

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
• Criar intervalos de durações configuráveis
• Configurar cálculos dinâmicos de intervalo de tempo
• Criar intervalos de tempo padrão para os atributos do elemento

Criar intervalos de durações configuráveis

Para garantir que os intervalos de tempo tenham sempre o mesmo comprimento, configure
substituições do intervalo de tempo.

Procedimento
1. Na lista Por tempo, selecione Substituição do intervalo de tempo.
2. No campo Tempo relativo, digite uma expressão de tempo relativo de PI (Tempo relativo).
O PI AF cria um intervalo de tempo baseado na hora de término fornecida pelo aplicativo
cliente e no deslocamento definido pelo tempo relativo.
Nota:
É possível usar parâmetros de substituição para ler o tempo relativo do valor de outro
atributo (Referências a valores de atributos). Se isso for feito, o PI AF avaliará o valor
do atributo de referência no momento de cada solicitação de dados.

Exemplo
Para criar uma média de rolagem de uma hora, use as seguintes configurações:

152 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

• Na lista Por tempo, selecione Substituição do 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álculos dinâmicos de intervalo de tempo

Use um atributo PI AF para calcular o intervalo de tempo com base em fatores variáveis. É
possível usar o valor do atributo atual para determinar dinamicamente o intervalo de tempo.
Os valores de atributo devem ser tempos relativos PI válidos, conforme descrito em Tempo
relativo.

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. Configurar a referência de dados do ponto PI.
a. Na lista Por tempo, selecione Substituição do intervalo de tempo.
b. No campo 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 verificar um exemplo passo a passo.

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. Criar um conjunto de enumerações, MyEnumSet, contendo estes três valores:
-30m
-1h
-2h

Guia do Usuário do PI System Explorer 153

Configuração de referências de dados

Nota:
Os valores devem ser expressões de tempo relativas válidas, conforme descrito em
Tempo relativo.
2. Crie um atributo chamado TimeRangeAttribute, que faz referência ao conjunto de
enumerações MyEnumSet.
Especifique o conjunto de enumerações ao configurar o atributo. Na lista Tipo do valor,
selecione Conjuntos de enumerações > MyEnumSet.
3. Crie outro atributo chamado DataReferenceAttribute com uma referência de dados
configurada do ponto do PI
a. No PI Point, selecione qualquer ponto que tenha um valor numérico. Nesse exemplo, o
ponto sinusoid será usado em um PI Data Archive chamado PISRV1.
b. Na lista Por tempo, selecione Substituição do intervalo de tempo.
c. Na caixa Tempo relativo, digite: %@TimeRangeAttribute%
d. Na lista Por intervalo de tempo, selecione Média.

Resultados
O atributo TimeRangeAttribute permite escolher o intervalo de tempo para o cálculo.

Criar intervalos de tempo padrão para os atributos do elemento

É 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 um aplicativo cliente fornece
um tempo específico, em vez de um intervalo de tempo.

154 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Nota:
Os atributos de estrutura de evento e transferência tratam os intervalos de tempo de
maneira diferente, conforme descrito em Intervalos de tempos para estruturas de
eventos e transferências.

Procedimento
1. Na janela Referência de dados do ponto PI (ou Referência de dados da matriz do ponto PI), use
as seguintes configurações de recuperação de valor:
a. Na lista Por tempo, selecione Intervalo de tempo.
b. No campo Tempo relativo, digite uma expressão de tempo relativa PI, conforme descrito
em Tempo relativo.
Nota:
Também é possível usar parâmetros de substituição para ler o tempo relativo do
valor de outro atributo, conforme descrito em Referências a valores de atributos.
O PI AF cria um intervalo de tempo baseado no tempo especificado pelo aplicativo cliente e
no deslocamento definido pelo tempo relativo.

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:
1. Na lista Por tempo, selecione Intervalo de tempo.
2. No campo Tempo relativo, digite:
-1h
3. Na lista Por intervalo de tempo, selecione Total.

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 o aplicativo chamador não fornece nenhum contexto de tempo, o PI AF calcula o

valor do atributo usando o intervalo de tempo do event frame ou da transferência. Por
exemplo, se um atributo contiver um ponto PI configurado com uma opção de resumo do
intervalo de tempo, o resumo será realizado durante o intervalo de tempo da estrutura de
eventos ou da transferência.
Se um atributo contiver um ponto PI configurado com apenas uma opção de tempo padrão,
o PI AF retornará o valor do ponto na hora de término da estrutura de evento.
• Quando o aplicativo chamador fornece um único timestamp, o PI AF retorna o valor da hora
especificada, mesmo se a hora estiver fora do intervalo da estrutura de evento ou da
transferência.
• Se o aplicativo chamador fornecer um intervalo de tempo, o PI AF usará a intersecção do
intervalo fornecido e do intervalo da estrutura de evento. Se não houver intersecção, um
evento "Nenhum dado" será retornado.
A área sombreada da figura a seguir representa a intersecção entre o intervalo de tempo da
estrutura de evento e o solicitado. Para atributos que contêm um ponto PI configurado com
uma opção de resumo de intervalo de tempo, o resumo será realizado por essa intersecção.

Guia do Usuário do PI System Explorer 155

Configuração de referências de dados

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

valor na hora de início da intersecção será retornado.

Intersecção entre o intervalo de tempo da estrutura de evento e o intervalo de tempo solicitado

Atualizações do valor do ponto PI de uma referência de dados

Um atributo com uma referência de dados do ponto PI pode gravar um valor em um ponto PI.
Na janela de configuração Referência de dados do ponto PI, a caixa de seleção Somente leitura
determina se o atributo pode gravar dados no ponto PI referenciado. Por padrão, a caixa está
selecionada (Somente leitura = verdadeiro), o que significa que o atributo do PI AF não pode
alterar o valor do ponto PI.
Em raras ocasiões, é possível 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 ponto PI 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.
Nota:
Aplicativos que usam o método AF SDK UpdateValue , como o PI Analysis Service,
podem gravar dados no ponto PI, independentemente de a caixa de seleção Somente de
leitura estar selecionada ou não.

Atualizações de valor do atributo das referências de dados da tag do PI

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 ponto do PI associadas a esse elemento. Para criar
as referências de dados, clique com o botão direito no elemento no navegador Elementos (ou
Event Frames) e clique em Criar ou Atualizar Referência de Dados. O PI AF substitui todos os
parâmetros de substituição pelos valores correspondentes no momento, além de criar e
bloquear a referência de dados.

156 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Bloqueio da referência de dados

Quando uma referência de dados é bloqueada, as alterações no template do atributo não
afetam mais as instâncias do atributo. Os parâmetros de substituição também não são mais
avaliados. No entanto, os campos a seguir são exceções:
• Uma referência de valor de atributo é inserida no campo Tempo relativo, conforme
observado em Referências a valores de atributos.
• Qualquer alteração no atributo da tag feita na janela Configurações de criação de tag.
Por exemplo, se for feita uma alteração no atributo de uma tag ou se for definido um atributo
de uma tag pelos parâmetros de substituição, a referência de dados dos atributos derivados
ainda será afetada sempre que você clicar com o botão direito em um elemento e clicar em
Criar ou Atualizar Referência de Dados.

Redefinição da referência de dados

Depois que um valor de atributo foi bloqueado, é possível usar o recurso Redefinir para
Template para restaurar as propriedades originais do template em um elemento, conforme
descrito em Redefinição do atributo de valor para as propriedades originais.

Atribuir indicadores para atualizações de referência de dados do ponto

PI
O PI System Explorer emprega indicadores visuais distintos para atributos que suportam a
opção Criar ou atualizar referência de dados. Um flag 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 está associado a um template contendo regras de criação do ponto. 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 PI AF. Isso pode ocorrer quando um ponto é renomeado ou quando
o PI Data Archive 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 Propriedade do atributo do item de
configuração para obter mais informações.
Nota:
A opção Criar ou atualizar referência de dados não é aplicável aos atributos de
itens 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 com o botão direito em um elemento ou atributo e clicando em Criar ou
atualizar ponto PI.
A operação Criar ou atualizar referência de dados atualiza uma referência de dados do ponto PI
com quaisquer alterações que tenham sido feitas no ponto PI (os parâmetros de substituição
são resolvidos e as IDs de pontos e servidores, atualizadas). Se o ponto PI ainda não existir, e a
configuração contém uma opção de criação de ponto, ele é criado.

Guia do Usuário do PI System Explorer 157

Configuração de referências de dados

Exemplo de atualização do atributo

Quando você vir o indicador exibido para um atributo, pode atualizar sua configuração
clicando com o botão direito e clicando em Criar ou atualizar ponto PI.
Nota:
O ícone não determina antecipadamente se quaisquer alterações para o tag ou sua
configuração ocorrerão.

Indicador de atributo com dica de ferramenta

Conforme indicado pela dica de ferramenta mostrada acima, quando você atualiza a
configuração as regras de substituição do nome do ponto são resolvidas e o ID do ponto é
armazenado nos metadados do atributo. Isso resulta em uma inicialização subsequente mais
rápida.

Configurar a criação automática de pontos PI

Em um template de atributo, é possível configurar uma referência de dados do ponto PI para
criar pontos PI automaticamente.

Procedimento
1. No navegador de Biblioteca, selecione um template de elemento.
2. Clique na guia Templates de atributo.
3. Adicione um novo template de atributo ao template de elemento, conforme descrito em
Criar templates de atributo.
4. Na lista Referência de Dados, selecione Ponto PI.
5. Clique em Configurações.
6. No campo Nome da tag na janela Referência de dados do ponto PI, configure os nomes dos
pontos PI para os pontos gerados. Use parâmetros de substituição para permitir que PI AF
crie nomes de pontos automaticamente para os pontos que ele gera.
a. Clique em para selecionar a substituição do nome e os valores dos atributos atuais
relacionados de um menu de contexto. Para obter mais informações sobre valores de
substituição de nomes, consulte Lista de parâmetros de substituição do PI AF.

158 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Nota:
Se a substituição de valor do atributo atual for uma string que contém espaços, será
necessário colocar o nome inteiro da tag entre aspas duplas. Concatene a string
inteira primeiro e, em seguida, substitua o valor na parte do nome da tag da string
por Builder da String. Por exemplo:
"\\%Server%\%Element%.%ID%.%@ConcatStringName%;pointtype=String"

b. Marque a caixa de seleção Criação de tag.

c. Clique em .
d. Na janela Configurações da criação de tag, especifique uma classe do ponto e um tipo de
ponto nos campos Classe do ponto e Tipo de ponto. Para obter mais informações sobre
classes e atributos da tag do PI, consulte "Classes e atributos da tag do PI" in Live Library
(https://livelibrary.osisoft.com).
e. Os valores de atributo padrão são exibidos para a classe da tag selecionada. É possível
editar os atributos do ponto PI padrão ou clicar em Importar para importar valores de
atributos do ponto PI de um ponto existente localizado na janela Pesquisa de tag.
7. Para visualizar como os parâmetros de substituição selecionados são resolvidos, clique no
link Selecionar instância do exemplo na seção Visualizar.
8. Na janela Find Derived Elements for (Encontrar elementos derivados para)
Element_Template, selecione um elemento de amostra.
9. Clique em OK.
Os campos ConfigString e Valor exibem a resolução dos parâmetros de substituição que
você selecionou, bem como as configurações de criação de tag.
10. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.
11. Crie um novo elemento com base no template de elemento e clique na guia Atributos.
12. Clique com o botão direito no atributo de referência de dados do ponto PI e clique em Criar
ou atualizar referência de dados.
13. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Resultados
Todos os pontos aos quais os novos elementos fazem referência são criados. 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.

O que Fazer Depois

Após a criação dos pontos PI, pode levar algum tempo antes que os valores sejam gravados no
PI Data Archive pela interface especificada. Até lá, os valores são exibidos como Pt. criado.

Editar propriedades do ponto do PI

Edite uma propriedade do ponto do PI quando você precisar fornecer mais informações sobre
um ponto do PI que os valores de propriedade da tag padrão. Por exemplo, pode ser útil
fornecer um descritor de um ponto do PI que é criado como uma saída de análise.

Procedimento
1. No navegador de Elementos, localize o elemento que contém o ponto PI que deseja editar.
2. Clique na guia Atributos e selecione o atributo com a referência de dados do ponto do PI.
3. Clique em Configurações.

Guia do Usuário do PI System Explorer 159

Configuração de referências de dados

4. Na janela Referência de dados do ponto do PI, clique em .

5. Na janela Propriedades do ponto do PI, escolha uma das seguintes ações:
Para... Faça o seguinte...
Editar um valor de propriedade a. Clique no campo Valor ao lado de uma
propriedade.
b. Inserir um valor revisado.
Restaurar um valor editado como PI Data Archive a. Clique no campo Valor ao lado de uma
padrão propriedade editada.
b. Clique em e selecione Restaurar valor
padrão.

6. Clique em OK.

Visualizar parâmetros de substituição nas referências de dados do ponto PI

Visualize como os parâmetros de substituição são resolvidos conforme você configura uma
referência de dados do ponto PI em um template de atributo.

Procedimento
1. No navegador de Biblioteca, selecione um template de elemento.
2. Clique na guia Templates de atributo.
3. Adicione um novo template de atributo ao template de elemento, conforme descrito em
Criar templates de atributo.
4. Na lista Referência de Dados, selecione Ponto PI.
5. Clique em Configurações.
Os valores de substituição padrão são exibidos no campo Nome da tag.
6. Use parâmetros de substituição para permitir que PI AF crie nomes de pontos
automaticamente para os pontos que ele gera. Clique em para selecionar a substituição
do nome e os valores dos atributos atuais relacionados de um menu de contexto. Para obter
mais informações sobre valores de substituição de nomes, consulte Lista de parâmetros de
substituição do PI AF.
7. Para visualizar como os parâmetros de substituição selecionados são resolvidos, clique no
link Selecionar instância do exemplo na seção Visualizar.
8. Na janela Find Derived Elements for (Encontrar elementos derivados para) Element_Template,
selecione um elemento de amostra.
9. Clique em OK.
Os campos ConfigString e Valor exibem a resolução dos parâmetros de substituição que
você selecionou, bem como as configurações de criação de tag e os métodos de recuperação
de valores (se selecionado).
10. Escolha uma das seguintes ações:
◦ Para confirmar a configuração da referência de dados do ponto PI, clique em OK.
◦ Para alterar as configurações, clique em Cancelar e recomece clicando em Configurações.

160 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Referências de dados de matriz do ponto do PI

Use a referência de dados da matriz do ponto do PI para vincular atributos de elementos a
matrizes dos pontos do PI para ler ou gravar o valor deles. Cada nome de tag especificado
corresponde a uma única entrada na matriz. Configure a referência de dados da matriz do
ponto PI da mesma maneira que faria na referência de dados do ponto PI, com exceção do
campo Nomes de tag na janela Referência de dados da matriz do ponto PI.

Vídeo
Para obter informações sobre como configurar referências de matriz de tags do PI, assista a
este vídeo:
https://www.youtube.com/watch?v=ozyS9QFFZgM

Criar referência de dados da matriz do ponto do PI

Crie uma referência de dados da matriz do ponto do PI para vincular atributos de elementos a
matrizes dos pontos do PI para ler ou gravar o valor deles.

Procedimento
1. Para configurar uma referência de dados de matriz do ponto do PI:
◦ No navegador de Elementos, selecione o elemento desejado.
◦ Em um template de elemento, selecione o template de elemento desejado no navegador
de Biblioteca.
2. Clique na guia Atributo ou Templates de atributo, selecione o atributo.
3. No painel de configuração do atributo, escolha Matriz do ponto PI na lista Referência de
dados.
4. Clique no botão Configurações.
5. Na janela Referência de dados da matriz do ponto PI, deixe o servidor padrão ou escolha um
PI Data Archive diferente na lista Servidor de dados.
Nota:
Se o PI Data Archive desejado não aparecer na lista, clique em e selecione um PI
Data Archive na janela Arquivos de dados do PI.
6. No campo Nome da tag, escolha uma das seguintes ações:
◦ Para inserir pontos do PI diretamente, insira nomes de pontos separados pelo símbolo da
barra vertical (|). Por exemplo:
CDM158|CDT158|SINUSOID
◦ Para procurar pontos do PI, clique em e insira os critérios de pesquisa na janela
Pesquisa de tag. Selecione vários pontos do PI no PI Data Archive selecionado.
7. Opcional. Especifique as unidades que os pontos do PI referenciados usam. Consulte
Considerações da unidade de medida.
8. Na seção Métodos de recuperação do valor, especifique como o atributo obtém seu valor.
Por exemplo, o valor do atributo pode ser o mesmo dos valores do ponto ou pode ser um
resultado de um cálculo nos valores do ponto. Consulte Configuração dos métodos de
recuperação para valores do atributo.
9. Use a caixa de seleção Somente leitura para especificar se o PI AF deve gravar o valor do
atributo novamente nos pontos de origem. Por padrão, o PI AF não grava dados nos pontos

Guia do Usuário do PI System Explorer 161

Configuração de referências de dados

do PI referenciados (a caixa de seleção Somente leitura está marcada). Consulte

Atualizações do valor do ponto PI de uma referência de dados.

Referências de dados da fórmula

Use referências de fórmula para criar cálculos personalizados com base em outros atributos de
elemento. Os cálculos podem estar na forma de uma fórmula simples ou de uma sequência de
cálculos. As referências de dados da fórmula podem ter vários atributos de entrada.

Vídeos
Para obter informações sobre como criar referências de fórmula, assista a este vídeo:
https://www.youtube.com/watch?v=vReXkkMueIo
Para obter informações sobre UDMs nas referências de fórmula, assista a este vídeo:
https://www.youtube.com/watch?v=0A_Uy5_nbCs

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

Operadores de referências de dados da fórmula

É possível usar os seguintes operadores nas referências de fórmula (em ordem de
precedência):
Operador Precedência
Parêntese 9 (realizado primeiro)
Menos unário 8
^ 7
* / mod 6
+- 5
< > <= >= == <> 4
NOT 3
AND 2
OR 1 (realizado por último)

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.
É possível escolher If-Then-Else, um operador composto com operandos usado 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 expr1 será
retornado; caso contrário, o valor expr2 será retornado.

162 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Funções de referências de dados da fórmula

PI AF oferece as seguintes funções em uma referência de fórmula.
Função Descrição
abs(X) Valor absoluto de X.
acos(X) Arco cosseno de X.
asin(X) Arco seno de X.
atan(X) Arco tangente de X.
badval(x) Retorna 1 se o valor tiver um status ruim, um valor de ponto flutuante que
não seja um número (NaN) ou não for um valor numérico, do contrário
retorna 0.
ceiling(X) Inteiro menor não inferior 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.
digstate() Retorna um valor de estado digital do sistema.
• Se for bem-sucedido, o estado digital do sistema é retornado como um
valor de enumeração do sistema. Para versões PI AF Client anteriores a
2.4, o valor é retornado como um estado digital PI SDK, pois o valor de
enumeração de sistema definido não existiu.
• Se não for bem-sucedido, o valor é retornado como uma string.
Em ambos os casos, o flag AFValue.IsGood fica definido para falso e o
atributo fica sinalizado na exibição de atributos com o ícone .

e() Valor da base de logaritmo natural.

exp(X) Base de logaritmo natural e elevada à potência de X.
floor(X) Inteiro maior não inferior a X.
ln(X) Logaritmo natural de X.
log(X) Logaritmo de X usando base 10.
logbase(X,Y) Logaritmo de X usando base Y.
max(X,Y) Maior de X e Y.
min(X,Y) Menor de X e Y.
normalrnd(X,Y) Número aleatório que mapeia a curva de distribuição normal. X é a média e Y
é o desvio padrão.
pi() Valor de pi.
poisson(X) Número aleatório que mapeia a distribuição Poisson. X é a média.
pow(X,Y) X elevado à potência de Y.
rand() Número aleatório uniforme. Os valores podem estar entre 0 e menos que 1.0
rand(X,Y) Número aleatório uniforme. Os valores podem estar entre X-Y/2 e inferior a X
+Y/2.
remainder(X,Y) Retorna o lembrete resultante da divisão de X por Y.
round(X) X arrendondado ao número inteiro mais próximo.
roundfrac(X,Y) X arredondado ao número de dígitos fracionais especificados por Y. Y é um
número inteiro.

Guia do Usuário do PI System Explorer 163

Configuração de referências de dados

Função Descrição
sec(X) Secante de X.
sech(X) Secante hiperbólica de X.
sign(X) Retorna 1 se X for superior a zero e -1 se X for inferior a 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, você precisa configurar as entradas e a saída
da equação com a UM 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, especifique a UDM na qual deseja que o resultado apareça. Isso
deve ser consistente com as UDMs das entradas (valores de atributos).

Exemplo de UDM em uma referência de dados da fórmula

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.

Configurar referências de dados de fórmula

Crie referências de dados de fórmula para executar cálculos personalizados.

Antes de Iniciar
A referência de dados de fórmula não dá suporte a strings ou outros tipos de valores não
numéricos.

Procedimento
1. Escolha uma das seguintes ações.
◦ No navegador de Elementos, selecione o elemento desejado.
◦ Em um template de elemento, selecione o template de elemento desejado no navegador
de Biblioteca.
2. Clique na guia Atributo ou Templates de atributo, selecione o atributo.
3. Na lista suspensa Referência de dados, escolha Fórmula.
4. Clique no botão Configurações para abrir a janela de configuração Referência de dados da
fórmula.

164 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

5. Se a equação precisar de um valor de atributo, clique em para adicioná-lo como um

parâmetro (Definir parâmetros para referências de dados de fórmula).

6. 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.
7. Clique em para começar a definir a equação. Para obter mais informações, consulte

Definir equações para referências de dados de fórmula.

8. No campo Unidade de medida, especifique a unidade de medida que o resultado da fórmula
ou sequência de cálculo produzirá, conforme descrito em Unidades de medida nas
referências de dados da fórmula.
9. No campo 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.
10. No campo 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.
11. 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.
12. Clique em OK.
13. Configure o resto das configurações do atributo como faria com qualquer outro atributo.

Nesta seção
• Definir parâmetros para referências de dados de fórmula
• Definir equações para referências de dados de fórmula

Definir parâmetros para referências de dados de fórmula

Quando as equações requerem valores de atributos, adicione esses atributos como parâmetros
na janela Configuração da fórmula.

Procedimento
1. Clique em ao lado do campo Parâmetros.

Nota:
Também é possível clicar em uma linha vazia e inserir uma variável (a-z).
2. Na janela Configuração de parâmetro, 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.

Guia do Usuário do PI System Explorer 165

Configuração de referências de dados

◦ 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. Observe que esta não é a UDM do
atributo, mas sim a UDM que a sua fórmula requer dessa entrada, conforme descrito em
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 equações para referências de dados de fórmula

Definir equações para usar em referências de dados de fórmula.

Procedimento
1. Para adicionar uma nova linha de fórmula, clique em ao lado do campo Equações.
Também é possível clicar na área de texto e digitar uma equação.
2. Digite uma equação diretamente ou crie sua equação a partir de uma lista de variáveis,
operadores, funções e parâmetros de substituição disponíveis. Clique em para realizar
uma das seguintes ações:
Para... Faça o seguinte...
Inserir uma variável Clique em Variáveis e em uma letra na lista
alfabética.
Inserir um operador Clique em Operadores e em um operador na lista.
Os operadores válidos estão listados em
Operadores de referências de dados da fórmula.
Inserir uma função Clique em Funções e em uma função na lista. As
funções válidas estão listadas em Funções de
referências de dados da fórmula.
Inserir um parâmetro de substituição Clique em Parâmetros de substituição e em um
parâmetro de substituição de tempo. Para
elementos e transferências, somente %Time%
está disponível, mas para event frames você pode
selecionar %StartTime, %EndTime%, %UtcTime%,
%UtcStartTime%, %UtcEndTime% e %Duration
%. Para obter mais informações sobre esses
parâmetros, consulte Lista de parâmetros de
substituição do PI AF.
Os números são convertidos em um double, os
spans de tempo em uma duração em segundos, e
os timestamps em segundos UTC.

3. Para adicionar outra linha à fórmula, clique em e continue a fórmula. Repita conforme
necessário até concluir a fórmula.
4. Para alterar a fórmula, escolha uma das seguintes ações:
Para... Faça o seguinte...
Remover a equação selecionada da sequência de Selecione a linha que deseja remover e clique em
cálculo .

166 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Remover todas as equações da sequência de Clique em .

cálculo
Mover uma equação para cima ou para baixo na Selecione a linha a ser movida e clique em ou
sequência de cálculo .

Referência de dados do Builder da String

A referência em String personalizada permite aplicar funções de manipulação de string, como
concatenação, ao valor de um atributo e produzir uma string reformatada. Isso é útil quando
você precisa obter uma string ou tipo de valor numérico de outros atributos de elemento. As
referências em string personalizada não fazem conversões nem cálculos de unidades de
medida. Quando você usa a referência em String personalizada em um template, a substituição
de valores ocorre no momento da execução.

Sintaxe das expressões

Observe as seguintes regras ao construir uma expressão:
• É possível construir uma expressão em uma única linha usando pontos-e-vírgula para
separar os itens.
• Você também pode inserir cada termo em uma linha, o que elimina o ponto e vírgula e torna
a estrutura da expressão mais evidente.
• Coloque os parâmetros de substituição entre aspas duplas para que o resultado seja tratado
como uma string literal.
• Você pode incluir qualquer caractere do teclado em uma string entre aspas, por exemplo,
traços, barras invertidas, dois-pontos, ponto e vírgula e assim por diante. Para incluir o
caractere de aspas duplas em uma string, digite dois caracteres de aspas duplas
consecutivos dentro da string, por exemplo, """t""e""s""t""" produz "t"e"s"t".
• Você pode incluir caminhos de atributos entre aspas simples para exibir o valor do atributo
referenciado no resultado.
• Você deve evitar o uso de strings sem aspas porque pode obter resultados irregulares.

Nesta seção
• Referências de atributo no Builder da String
• Implementação de função no String Builder
• Criar referências de dados do Builder da string

Referências de atributo no Builder da String

Para fazer referência a outros atributos, use a sintaxe na tabela a seguir.
Objeto Sintaxe
Atributo irmão siblingAttribute
Atributo de nível superior do |topLevelAttribute
mesmo elemento
Atributo pai ..
Atributo do elemento pai .\|myAttribute
Atributo filho .|childAttribute
Da estrutura de evento para o .\Elements[.]|myAttribute
elemento primário
Caminho relativo do banco de dados \TopLevelElement|myAttribute

Guia do Usuário do PI System Explorer 167

Configuração de referências de dados

Objeto Sintaxe
Caminho completo \\myServer\myDatabase\myElement|myAttribute

Exemplos
Suponha que você deseja recuperar o valor do ponto PI Environment do elemento pai
Cracking Process:

No elemento filho Equipment, você usaria a sintaxe ..\|myAttribute e inseriria '..\|

Environment' na janela Referência de dados do Builder da String:

Um valor semelhante ao seguinte é exibido no campo Valor: 65.2221603393555.

Implementação de função no String Builder

No String Builder, é possível usar várias funções de manipulação de texto, bem como a função
Format.

Extração de texto e manipulação de caso

Essas funções podem ser usadas para manipular o caso de uma string e extrair certas seções.
A sintaxe para as funções de manipulação de texto no String Builder é descrita na tabela a
seguir:
Left(string, length) Retorna uma string que contém o número especificado de caracteres
(length) a partir da esquerda da entrada (string).
Exemplo: Left("Temperature",4) retorna Temp

Right(string, length) Retorna uma string que contém o número especificado de caracteres
(length) a partir da direita da entrada (string).
Exemplo: Right("GasTemp",4) retorna Temp

Mid(string, start, length é opcional. Retorna uma substring a partir da posição

[length]) especificada (start) da entrada (string). Quando o número de
caracteres (length) é incluído, retorna o número especificado de
caracteres.
Exemplo: Mid("GasPressure",4,8) retorna Pressure

168 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

UCase(string) Converte string em maiúsculas.

Exemplo: UCase("Temperature") retorna TEMPERATURE

LCase(string) Converte string em minúsculas.

Exemplo: LCase("TEMPERATURE") retorna temperature

Trim(string) Remove espaços vazios nos dois lados de string.

Exemplo: Trim(" Temperature ") retorna Temperature

RTrim(string) Remove espaços em branco à esquerda de string.

Exemplo: RTrim(" Temperature ") retorna " Temperature"

LTrim(string) Remove espaços em branco à direita de string.

Exemplo: LTrim(" Temperature ") retorna "Temperature "

Replace(string, string, No string original, substitui o string especificado pelo novo

string) string.
Exemplo: Replace("Temperature","Temp","External Temp")
retorna "External Temperature"

Também é possível aninhar funções de manipulação de texto.

• Por exemplo, para um atributo designado GasPressure, use a função Mid em combinação
com a função UCase para retornar a seguinte expressão: GASPR
Mid(UCase("%Attribute%"), 1, 5);
• Ou então, para o mesmo atributo, use a função Mid em combinação com a função LCase
para retornar a seguinte expressão: pressure
Mid(LCase("%Attribute%"), 4, 8);

Função do formato
A função Format permite converter números reais, inteiros e timestamps em uma string de
acordo com o formato e especificação opcional da cultura.
Nota:
Ao contrário de outras funções de string, a sintaxe de Format(DateTime, ... ) segue a
sintaxe C# .
A sintaxe para a implementação de Function no String Builder é descrita na tabela a seguir:
Números reais Format(real, format) O formato segue a sintaxe de estilo do
Performance Equation (PE) como
Format (real, format, culture)
"%0.3f", em que o número antes da
decimal indica o número mínimo total
de caracteres para a saída, o
preenchimento com espaços em branco
e o número após a casa decimal indica o
número de dígitos para mostrar após o
ponto decimal.
A cultura também pode ser especificada
usando uma tag da linguagem IETF
como "en", "en-US", "de", que
especifica a língua e a cultura e regiões
opcionais.

Guia do Usuário do PI System Explorer 169

Configuração de referências de dados

Números inteiros Format(integer, format) O formato segue a sintaxe de estilo do

Performance Equation (PE) como
Format(integer, format,
"%4d", em que o número indica o
culture)
número mínimo total de caracteres para
a saída e o preenchimento com espaços
em branco se necessário.
A cultura também pode ser especificada
usando uma tag da linguagem Internet
Engineering Task Force (IETF) como
"en", "en-US", "de", que especifica a
língua e a cultura e regiões opcionais.

Horários Format(datetime, format) O formato segue a sintaxe C#

Format(datetime, format, DateTime.ToString(format) e pode
culture) ser uma sintaxe predefinida ou
personalizada.
O formato DateTime usa configurações
de cultura invariáveis. Para exibir datas
e horas para uma cultura específica,
adicione uma tag de linguagem de
Internet Engineering Task Force (IETF),
como "fr-FR" e "fr-CA", conforme
descrito no artigo da MSDN Tabela de
nomes de cultura de linguagem, códigos
e método de valores ISO (https://
msdn.microsoft.com/en-ca/library/
ee825488(v=cs.20).aspx).
Para obter mais informações sobre
formatos de data e hora, consulte
Strings de formato para os parâmetros
de substituição de tempo.

Exemplo de formato numérico

Suponha que você deseja formatar o valor do ponto do PI Environment que já recuperou do
elemento pai Cracking Process. Na janela Referência de dados do String Builder, selecione a
linha que contém a expressão da string, clique em e selecione Funções > Format(Real,
"%3.3f") para modificar a expressão:

O campo Valor muda de 65.2221603393555 para 65.222.

Para alterar o valor cultural do padrão dos EUA para um formato de cultura espanhola,
selecione Funções > Format(Real, "%3.3f", "en-US") e altere a string "en-US" para "es":

O campo Valor muda de 65.222 para 65,222.

170 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

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.

Exemplo de formato de data/hora

Suponha que você deseja recuperar e formatar o valor In Service Date do elemento filho
Condenser:

No elemento pai Power and Steam Generation, você criaria um atributo nomeado
Condenser Service Date. Use a sintaxe .\childElement|Attribute e insira '.
\Condenser|In Service Date' na janela Referência de dados do String Builder:

O valor In Service Date é recuperado e exibido no campo Valor: 2/25/2009 12:00:00 AM

Para alterar o formato do padrão dos EUA para a data completa em formato Universal da
cultura alemã, altere a expressão para Format(.\Condenser|In Service
Date,"U","de"). O formato do valor do atributo Condenser Service Date é convertido da
maneira correspondente:

Criar referências de dados do Builder da string

Crie uma referência de dados do Builder da String quando precisar aplicar as funções de
manipulação de string, como concatenação, a um valor de atributo e gerar uma string
reformatada.

Antes de Iniciar
Quando uma referência de dados do Builder da String é usada em um template, o valor de
substituição ocorre no tempo de execução.

Procedimento
1. Escolha uma das seguintes ações:
◦ No navegador de Elementos, selecione o elemento desejado.
◦ No navegador de Estruturas de evento, selecione a estrutura de evento desejada.
◦ Em um template de elemento, selecione o template de elemento desejado no navegador
de Biblioteca.
2. Clique na guia Atributo ou Templates de atributo, selecione o atributo.

Guia do Usuário do PI System Explorer 171

Configuração de referências de dados

3. No painel de configuração do atributo, escolha Builder da String na lista suspensa

Referência de dados.
4. Clique em Configurações.
5. Na janela Referência de dados do Builder da String, clique em .
6. Na linha realçada, pressione F2 ou clique em e selecione uma das seguintes opções:

Opção Descrição
Literais Uma string de texto entre aspas duplas:
"Amostra"
Valores de atributo Uma lista de outros atributos para o elemento ou
template de elemento selecionado. Observe que
os atributos devem aparecer entre aspas simples.
Valores de atributo relacionados Uma lista das seguintes referências de atributo:
◦ '\\<Server>\<Database>\<Element>|
<Attribute>'
◦ '\\.\<Database>\<Element>|<Attribute>'
◦ '\<Root Element>|<Attribute>'
◦ '.\<Child Element>|<Attribute>'
◦ '..\|<Primary Parent Attribute>'
◦ '..\<Sibling Element>|<Attribute>'
Você também pode selecionar Pesquisar para
inserir critérios de pesquisa na janela Pesquisa de
atributo.

Parâmetros de substituição Uma lista de 20 parâmetros de substituição

comumente utilizados. Para obter mais
informações, consulte Lista de parâmetros de
substituição.
Funções Uma lista das seguintes funções:
◦ Left(string, length)
◦ Right(string, length)
◦ Mid(string, length)
◦ Mid(string, início, comprimento)
◦ UCase(string)
◦ LCase(string)
◦ Trim(string)
◦ RTrim(string)
◦ LTrim(string)
◦ Replace(string, string, string)
◦ Format(Real, "%3.3f")
◦ Format(Real "%3.3f", "en-US")
◦ Format(DateTime, "yyyy-MM-dd HH:mm:ss")
◦ Format(DateTime, "yyyy-MM-dd HH:mm:ss",
"en-US")
Para obter exemplos de como essas funções
podem ser usadas, consulte Implementação de
função no String Builder.

7. Crie adicionalmente a sua expressão. Você pode digitar um ponto e vírgula (;) e continuar
na mesma linha ou clicar em para continuar em outra linha. É possível utilizar os
seguintes ícones para manipular a expressão:

172 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Para... Faça o seguinte...

Anexar uma nova string Clique em .

Remover uma string Selecione uma linha e clique em .

Remover todas as strings Clique em .

Mover uma string uma linha acima Selecione uma linha abaixo da linha superior e
clique em .

Mover uma string uma linha abaixo Selecione uma linha acima da linha inferior e
clique em .

Ao criar a expressão de string, é possível visualizar o resultado da expressão no campo

Valor.
8. Quando a expressão de string estiver concluída, clique em OK.

Exemplos

• É possível inserir os seguintes parâmetros de substituição em uma única linha para

concatenar uma string de pathname. Por exemplo:
"%Database%";"\";"%Element%";"|";"%Attribute%";

Essa referência de dados produziria uma saída semelhante a: DB26\WX12000|pressure.

• É possível criar uma expressão em linhas separadas para mostrar a duração de um evento.
Por exemplo:
a. Clique em , pressione F2 e selecione Parâmetros de substituição > "%StartTime%".
b. Clique em e digite os caracteres: " to "
c. Clique em , pressione F2 e selecione Parâmetros de substituição > "%EndTime%".
O campo Valor mostra um intervalo de data e hora:

Guia do Usuário do PI System Explorer 173

Configuração de referências de dados

Referência de dados em busca por tabela

Você pode configurar um atributo para obter seu valor de uma tabela do PI AF. É possível
definir a tabela PI AF inteiramente no PI AF ou vincular a ou importar de uma fonte de dados
de fora do PI System (como uma tabela do Microsoft SQL ou uma planilha do Microsoft Excel).

Pesquisa de tabela
A referência de dados em busca por tabela destina-se a ser uma busca por tabela simples. Ela
usa o método.NET System.Data.DataTable.Select da Microsoft e segue as regras de
expressão de filtro desse método. Observe que nem todos os recursos são implementados no PI
AF. Por exemplo, uma referência de dados em busca por tabela não inclui funcionalidades como
funções da coluna e referência à relação pai/filho.
Nota:
A referência em busca por tabela não é otimizada para tratar os dados de uma tabela
externa como uma série cronológica e consultá-la. Para atingir desempenho ideal, esses
dados devem ser armazenados em tags do PI em um PI Data Archive.

Metodologia de busca por tabela

Crie um perfil de tabela no navegador Biblioteca e estabeleça nele as configurações gerais para
o fuso horário e o intervalo de cache para atualização de dados, bem como as definições das
colunas da tabela e as conexões com fontes de dados externos ao PI System se você estiver
vinculando ou importando dados externos.
Se estiver vinculando fontes de dados externos, pense em criar perfis de conexão da tabela
reutilizáveis no navegador Biblioteca, conforme descrito em Criar conexões de tabela
reutilizáveis.

Vídeos
Para obter informações sobre como criar tabelas internas para referências em buscas por
tabelas, assista a este vídeo:
https://www.youtube.com/watch?v=3gQzzNWzd6o
Para obter informações sobre como configurar referências em buscas por tabelas, assista a este
vídeo:
https://www.youtube.com/watch?v=hoy7QarxF1o

Nesta seção
• Criar tabelas do PI AF
• Criar definições para colunas de tabelas
• Preencher tabelas manualmente
• Referências de dados de fora do PI System
• Configurar referências de dados em busca por tabela

Criar tabelas do PI AF
Crie um perfil de tabela para que os atributos possam obter seus valores de uma tabela interna
ou externa.

174 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Procedimento
1. No navegador de Biblioteca, clique com o botão direito na coleção Tabelas e clique em Nova
tabela.
2. Na guia Geral, digite um Nome e Descrição para a tabela.
3. Opcional. Atribua uma ou mais categorias à tabela. Insira os nomes das categorias de tabela
diretamente, separados por dois pontos ou clique em e selecione-os na janela
Categorizar.
4. Decida como os valores DateTime devem ser armazenados na tabela. Ao configurar o valor
para a tabela geral, não será preciso especificá-lo sempre que criar uma referência em busca
por tabela.
a. No campo Fuso Horário, selecione um fuso horário da lista.
b. Marque ou desmarque a caixa de seleção Converter para local. Escolha uma das seguintes
opções:
◦ Para converter valores DateTime na hora local, marque a caixa de seleção Converter
para local.
◦ Para exibir valores DateTime no fuso horário selecionado no campo Fuso horário,
desmarque a caixa de seleção Converter para local.
Nota:
Quando um aplicativo cliente consulta a tabela, o fuso horário no qual os valores
DateTime são exibidos é determinado pela marcação da caixa de seleção Converter
para local. O PI System Explorer usa essa configuração para determinar o
DateTimeMode exato a ser usado em uma tabela de dados do Microsoft .NET,
conforme descrito em Configurações de conversão para fusos horários.
5. No campo Intervalo do cache, insira o tempo necessário até que os dados armazenados em
cache da tabela sejam atualizados. Na lista, selecione se o valor está em segundos, minutos,
horas ou dias. O valor padrão é zero, o que indica uma atualização manual.
Nota:
A atualização automática é desativada se a tabela tem alterações não salvas no
servidor.
Nota:
Com as atualizações manuais, os dados da tabela devem ser atualizados clicando com
o botão direito na tabela do navegador Biblioteca e clicando em Atualizar. Caso
contrário, os dados de tabela que estão sendo consultados pelos aplicativos cliente
serão atualizados somente quando o aplicativo for reiniciado. Por exemplo, quando o
PI System Explorer é aberto ou sempre que o pool de aplicativos do Microsoft Internet
Information Services (IIS) reciclar o cliente (o padrão é a cada 29 horas).
6. Faça check-in do trabalho.
Nota:
Os campos Conexão e Consulta são somente leitura. O PI AF preenche esses campos
quando você vincula ou importa uma tabela externa.

O que Fazer Depois

Defina e preencha a tabela em uma destas três formas:
• Defina e preencha manualmente a tabela no PI System Explorer. Primeiro, crie definições de
colunas na guia Definir Tabela, conforme descrito em Criar definições para colunas de

Guia do Usuário do PI System Explorer 175

Configuração de referências de dados

tabelas. Em seguida, insira os dados na guia Tabela, conforme descrito em Preencher tabelas
manualmente.
• Importe uma tabela de fora do servidor PI AF. Consulte Acesso aos dados do Microsoft
Access ou Excel.
• Vincule a uma tabela de fora do servidor PI AF. Consulte Acesso aos dados do Microsoft
Access ou Excel.

Configurações de conversão para fusos horários

O cálculo preciso de conversão de tempo depende do seguinte:
• O valor que você seleciona na lista Fuso horário. Os horários são prefixados com Universal
Coordinate Time (UTC), Greenwich Mean Time (GMT) ou fuso horário (TZ). A lista também
inclui a opção None.
• Se você marcou ou desmarcou a caixa de seleção Converter para local.
• Se esta é uma tabela interna (importada ou definida no PI AF) ou externa (vinculada).
A tabela a seguir explica como as horas exibidas são determinadas para cada combinação
possível. As opções exatas na lista Fuso horário dependem do seu sistema operacional.
Fuso horário Converter Interno/ Comportamento
para local externo
None Interno Os campos que contêm o tipo de dado DateTime são
automaticamente ajustados para diferenças de fuso
horário e retornam a hora local no cliente.
Externo Supõe-se que os campos que contêm o tipo de dado
DateTime estejam no fuso horário do servidor PI AF e
sejam ajustados para a hora local do cliente.
None Interno Os campos que contém o tipo de dado DateTime não são
convertidos. Útil para armazenar campos de data quando a
conversão não é desejada, como data de nascimento.
Externo Os campos que contém o tipo de dado DateTime não são
convertidos. Útil para armazenar campos de data quando a
conversão não é desejada, como data de nascimento.
UTC ou Interno Os campos que contêm o tipo de dado DateTime são
ajustados para horas locais no cliente.
GMT
Externo Os campos que contêm o tipo de dado DateTime são
externamente armazenados como UTC, mas são ajustados
para a hora local no cliente, representada como UTC.
UTC ou Interno Os campos que contém o tipo de dado DateTime são
sempre representados como UTC.
GMT
Externo Os campos que contêm o tipo de dado DateTime são
externamente armazenados como UTC e deixados como
UTC no cliente.
TZ Interno Os campos que contêm o tipo de dado DateTime são
ajustados para diferenças de fuso horário e são horas
locais no cliente. Normalmente, a combinação não é
necessária, exceto quando dados externos estão sendo
exportados para o PI System Explorer.
Externo Os campos que contêm o tipo de dado DateTime são
ajustados para diferenças de fuso horário e para a hora
local no cliente, representada como UTC.

176 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Fuso horário Converter Interno/ Comportamento

para local externo
TZ Interno Os campos que contêm o tipo de dado DateTime são
deixados no fuso horário especificado. Uma referência de
dados em busca por tabela é ajustada conforme
apropriado; no entanto, outros aplicativos podem não ser.
Externo Os campos que contêm o tipo de dado DateTime são
deixados no fuso horário original especificado,
representado como UTC. Uma referência de dados em
busca por tabela é ajustada conforme apropriado; no
entanto, outros aplicativos podem não ser.

Criar definições para colunas de tabelas

Para criar uma tabela manualmente, comece definindo as colunas da tabela.

Procedimento
1. Depois de concluir as configurações gerais da tabela na guia Geral, clique na guia Definir
Tabela.
2. Determine o número de colunas na tabela e clique uma vez em para cada coluna a ser
definida.
3. Clique na célula Nome e substitua o rótulo padrão pelo nome de coluna desejado.
4. Clique na célula Tipo de valor adjacente e selecione um tipo de dado em uma lista de Tipos
Básicos ou Tipos de Array. Para obter uma descrição dos tipos de dados, consulte Tipos de
dados do PI AF.
Dica:
Se qualquer tipo de valor for configurado como DateTime ou String, a OSIsoft
recomenda deixar o valor do fuso horário da coluna configurado como Nenhum e
selecionar um valor de fuso horário para a tabela geral no campo Fuso Horário na guia
Geral. Esse valor substitui os fusos horários definidos em colunas específicas da
tabela.
5. Opcional. Clique na célula Unidade de Medida e escolha uma das seguintes ações:
◦ Comece a digitar e selecione uma unidade de medida na lista de UDMs correspondentes.
◦ Clique em e selecione na lista completa de UDMs.
Dica:
A OSIsoft recomenda que você configure uma unidade de medida para uma coluna da
tabela para que não seja necessário especificar uma cada vez que você selecionar a
coluna em uma referência de dados em busca por tabela.
6. Repita as etapas 3 a 5 para cada coluna na tabela.
7. Para modificar a definição da coluna da tabela, clique com o botão direito em uma linha na
grade e selecione uma opção. Como alternativa, use os ícones a seguir.
Para... Faça o seguinte...
Inserir uma nova coluna Clique em .

Mover uma coluna uma linha acima Selecione uma linha abaixo da linha superior e
clique em .

Mover uma coluna uma linha abaixo Selecione uma linha acima da linha inferior e
clique em .

Guia do Usuário do PI System Explorer 177

Configuração de referências de dados

Remover uma coluna Selecione uma coluna e clique em .

O que Fazer Depois

Quando você terminar de definir as colunas da tabela, clique na guia Tabela para poder inserir
os dados de linha para cada coluna manualmente.

Preencher tabelas manualmente

Depois de concluir as definições das colunas da tabela, insira os dados das linhas para cada
coluna.

Procedimento
1. Clique na guia Tabela. Com base nas colunas da tabela criada na guia Definir tabela, insira as
informações apropriadas nas linhas de cada coluna.
2. Escolha uma das seguintes ações:
Para...
Inserir uma nova linha
Copiar e colar linhas de uma planilha do Excel
Substituir dados para células específicas
Remover uma linha
Faça o seguinte...
Clique com o botão direito na grade da tabela e
clique em Inserir ou em Novo.
a. Na planilha, copie as linhas desejadas.
b. Na grade da tabela, clique com o botão direito
em uma nova linha ou em um intervalo de
linhas e clique em Colar.
a. Use as teclas de seleção padrão do Windows
(como SHIFT+<click> e CTRL+<click>) para
selecionar células contíguas e não contíguas
na tabela, conforme descrito em Selecionar
vários objetos no visualizador.
b. Clique com o botão direito na seleção e,
então, clique em Limpar células.
c. Insira novos dados nas células que foram
limpas.
Clique com o botão direito na linha a ser
removida e selecione Excluir.

3. Para salvar o seu trabalho, pressione CTRL+S ou clique em Check-in.

Referências de dados de fora do PI System

Você também pode usar tabelas PI AF para acessar dados externos ao PI System. Esses dados
podem estar no Microsoft Excel, Access ou SQL Server ou em outras fontes de dados OLE DB/
ODBC. Você pode importar a tabela ou link para ele após ter definido a estrutura da tabela,
conforme descrito em Criar tabelas do PI AF e Criar definições para colunas de tabelas.

Tabelas importadas
As tabelasPI 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
porque, diferentemente das tabelas vinculadas, os dados da tabela são gerenciados no PI AF.
Após a importação inicial, não há mais relação entre a tabela externa e a tabela PI AF. Os dados
podem ser editados diretamente no PI AF.

178 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Uma boa prática é limitar o número de linhas de dados das tabelas importadas em até 10.000.
As tabelas importadas não foram criadas para armazenar bancos de dados muito grandes. Se
for necessário acessar muitos dados nas tabelas PI AF, vincule às tabelas externas, que não têm
esses limites de armazenamento. Como alternativa, divida a tabela durante a importação.

Tabelas vinculadas
Às vezes, as tabelas vinculadas são chamadas de tabelas externas, pois os dados de origem não
são armazenados no banco de dados PI AF. Não é possível editar uma tabela externa pelo PI AF.
As tabelas vinculadas exigem uma configuração de segurança adicional, pois é necessário
configurar como o PI AF se conecta à fonte de dados externa. É necessário configurar uma
conexão da tabela reutilizável, em que você configura o tipo de autenticação para acessar a
tabela externa.

Vídeos
Para obter informações sobre como importar dados de tabelas externas, assista a este vídeo:
https://www.youtube.com/watch?v=MmXmnac969s
Para obter informações sobre como vincular os dados em tabelas externas e sobre segurança
SQL, assista a este vídeo:
https://www.youtube.com/watch?v=JnhodkkyHks

Nesta seção
• Autenticação de tabelas vinculadas
• Criar conexões de tabela reutilizáveis
• Acessar dados do Microsoft Access ou do Excel
• Acesso aos dados do SQL Server

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 servidor do PI AF com
o mesmo tamanho de bit (normalmente, 64 bits).
Ao configurar a tabela vinculada, é necessário especificar as credenciais que o servidor PI AF
usa para se conectar ao banco de dados. As opções de autenticação são:
• Personificar cliente
Se o banco de dados de origem suportar a autenticação do Windows, use a identidade do
Windows do cliente que está solicitando os dados. Isso é uma personalização da conexão.
Este é o método mais seguro de autenticação e deve ser usado onde for possível.
• Fornecer senha
Se o banco de dados de origem não suportar a autenticação do Windows ou se o banco de
dados e o servidor PI AF estiverem em domínios diferentes e não confiáveis, especifique um
nome de usuário e uma senha com o acesso necessário no banco de dados de origem. PI AF
usa esta conta codificada para ler os dados na fonte de dados externos. Por exemplo, o
banco de dados MySQL não tem suporte à autenticação do Windows, por isso, o nome de
usuário e a senha de uma conta seriam usados no banco de dados MySQL.

Guia do Usuário do PI System Explorer 179

Configuração de referências de dados

Nota:
É possível inserir um ID de usuário e uma senha como parte da string de conexão e
salvá-la com uma conexão de tabela PI AF, independentemente de o suporte para
tabelas PI AF externas para usuários não personificados ter sido ativado
anteriormente ou não (com o comando afdiag /DTImp).
• Nenhum contexto de segurança adicional
Essa 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 essa 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.
CUIDADO:
Tenha cuidado ao configurar a segurança SQL de maneira que a identidade do servidor
PI AF não tenha mais privilégio do que o necessário para recuperar os dados. Apenas
administradores do PI AF têm permissão para configurar tabelas externas por motivos
de segurança. Por esse motivo, certifique-se de que a identidade de PI AF
Administrators e o direito de acesso Admin sejam atribuídos apenas a um conjunto
limitado de usuários quando este 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
• Recomendações de acesso a dados para tabelas vinculadas
• Configurações de segurança para tabelas vinculadas

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 servidor PI AF restringem ou impedem o uso delas. O
administrador do sistema pode:
• Solicitar privilégios administrativos no servidor PI AF 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 servidor PI AF.

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 do servidor PI AF para vincular a
um banco de dados externo.
• Tabelas vinculadas não personificadas (externas) são ativadas no servidor PI AF.

180 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Por padrão, as tabelas vinculadas não personificadas estão desativadas no servidor PI AF.
Para que um usuário execute um ataque, ele precisaria ativar as tabelas externas não
personificadas.
• A conta do servidor PI AF tem direitos administrativos no SQL Server.
Por padrão, o servidor PI AF é executado em uma conta virtual NT SERVICE\AFService 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 servidor PI AF no
computador ou SQL Server quando consultas não personificadas estiverem sendo
executadas.

Recomendações de acesso a dados para tabelas vinculadas

A OSIsoft recomenda que você observe as seguintes diretrizes ao vincular 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 PI AF no servidor PI AF ou no
SQL Server, quando executando com consultas não personificadas.
• Você deve ter privilégios administrativos no servidor PI AF para configurar uma tabela
externa que execute consultas não personificadas.

Configurações de segurança para tabelas vinculadas

Use o utilitário PI AF Diagnostics (afdiag localizado na pasta \PIPC\AF) para ativar ou
desativar o suporte para tabelas externas PI AF. Como o utilitário realiza uma conexão direta
com o banco de dados do SQL Server associado, ele exige a função sysadmin ou db_AFadmin
do SQL Server.
Use o utilitário PI AF Diagnostics para ajustar as configurações de segurança das tabelas
externas.
Tarefa Comando Configuração padrão
Ative o suporte a tabelas PI AF externas afdiag/DT ativado
Desative o suporte a tabelas PI AF externas afdiag/DT-
Ative o suporte a tabelas PI AF externas para afdiag/DTImp desativado
usuários não representados
Desative o suporte a tabelas PI AF externas para afdiag/DTImp-
usuários não representados
Altere as configurações de segurança para uma No navegador de Por padrão, a
tabela PI AF específica Biblioteca, clique com o configuração da tabela
botão direito na tabela e requer privilégios
selecione Segurança. administrativos no
servidor PI AF.
Altere as configurações de segurança de todas as No navegador de Por padrão, a
tabelas Biblioteca, clique com o configuração da tabela
botão direito em requer privilégios
Tabelas e clique em administrativos no
Segurança. servidor PI AF.

Guia do Usuário do PI System Explorer 181

Configuração de referências de dados

Nota:
Você não tem que ativar o suporte para tabelas PI AF externas para usuários não
representados. É possível incluir um ID de usuário e senha como parte da string de
conexão em uma conexão de tabela PI AF e fazer check-in nela, independentemente de o
suporte para tabelas PI AF externas para usuários não representados estar ou não
ativado. A conexão de tabela PI AF definida pode ser usada dentro de uma definição de
tabela PI AF. Isso significa que se um login do SQL Server tiver permissão para acessar os
dados referenciados na string de conexão, uma tabela PI AF vinculada a essa conexão de
tabela PI AF pode recuperar os dados externos.

Criar conexões de tabela reutilizáveis

Crie uma conexão OLE DB 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 OLE DB de 64 bits, que são necessários para o PI AF Server de 64 bits.

Procedimento
1. No navegador, clique em Biblioteca.
2. Escolha uma das seguintes ações:
◦ Selecione Conexões de tabelas e clique em Nova conexão da tabela na barra de
ferramentas.
◦ No navegador, clique com o botão direito em Conexões de tabelas e clique em Nova
conexão da tabela.
As propriedades de conexão da tabela são exibidas no visualizador com um nome padrão no
campo Nome.
3. Opcional. Edite o nome padrão e adicione uma descrição para a conexão da tabela no campo
Descrição.
4. No campo Conexão, é possível inserir uma string de conexão diretamente ou clicar em Criar
para configurar a conexão na janela Propriedades do link de dados.
5. Na guia Provedor de Propriedades do link de dados, selecione um provedor OLE DB e siga as
instruções na tela para configurar a conexão.
Para obter ajuda com o Microsoft Data Link, clique em Ajuda em qualquer guia, vincule à
página Recursos MSDN e insira Data Link Properties Dialog Box no campo de
pesquisa.
6. No visualizador, selecione uma opção Segurança. Talvez algumas opções não estejam
disponíveis.
◦ Personificar cliente (recomendado)
◦ Selecione Fornecer senha e insira uma senha para a conexão da tabela.
◦ Não há contexto de segurança adicional
Consulte Autenticação de tabelas vinculadas para obter informações sobre essas opções.
7. Na barra de ferramentas, clique em Fazer check-in para fazer check-in e salvar a conexão da
tabela.

182 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Acessar 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. Se você precisar atualizar os
dados importados em uma tabela, clique com o botão direito na tabela no navegador de
Biblioteca e clique em Reimportar tabela.
Você pode vincular ou importar dados de uma tabela do Microsoft Access ou de uma planilha
do Microsoft Excel depois de executar as seguintes etapas:
• Especifique o banco de dados ou o workbook de origem.
• Crie uma consulta que retorna os dados desejados.
• Insira quaisquer credenciais de login necessárias para acessar o banco de dados ou o
workbook.
As instruções exatas dependem da configuração do hardware e do que você está tentando
fazer:
Servidor PI AF de 32 bits Siga as instruções em Vincular ou importar dados.
Servidor PI AF de 64 bits • Para importar, siga as instruções em Vincular ou importar dados.
• Para vincular, siga as instruções em 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 no PI AF de 32 bits e 64 bits e como vinculá-
los aos dados de um servidor do PI AF de 32 bits apenas. Para vincular os 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 como descrito em Criar
tabelas do 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. Vincular apenas: 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.

Guia do Usuário do PI System Explorer 183

Configuração de referências de dados

◦ Office 97-2003: selecione Microsoft Jet 4.0 OLE DB Provider.

◦ Office 2007 e posterior: 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 servidor PI AF.
◦ 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. Excel apenas: 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 posterior: 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 é 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
servidor PI AF 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.

184 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Procedimento
1. No PI System Explorer, navegue até a tabela PI AF ou crie uma como descrito em Criar
tabelas do 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 servidor PI AF), conforme nos seguintes exemplos:
◦ Exemplo do Microsoft Excel:
Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\example.xlsx;Extended
Properties="Excel 12.0 Xml";
◦ 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.

Acesso aos 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 vincular ou importar dependem do
método de conexão escolhido, conforme descrito em Autenticação de tabelas vinculadas.

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
• Configurar a segurança no banco de dados da tabela de destino
• Importar ou vincular tabelas do SQL Server

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

Vincule ou importe dados de uma tabela do SQL Server com a opção Personificar cliente.
Consulte Recomendações de acesso a dados para tabelas vinculadas.

Guia do Usuário do PI System Explorer 185

Configuração de referências de dados

Nota:
Na vinculação com um SQL Server que não está no mesmo computador do PI AF Server,
talvez seja necessário configurar Kerberos para permitir que a identidade do cliente seja
encaminhada do PI AF Server para o SQL Server.

Procedimento
1. Criar um grupo de usuários local para clientes personificados.
2. Configurar a segurança no banco de dados da tabela de destino.
3. Importar ou vincular tabelas do SQL Server.

Criar um grupo de usuários local para clientes personificados

Se a tabela à qual você deseja se conectar residir em uma instância do SQL Server diferente
daquela em que reside o banco de dados SQL PI AF (PIFD), certifique-se de que a tabela seja
acessível por meio da autenticação do Windows.

Procedimento
1. No computador em que a instância do SQL Server reside, 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 em Grupos e selecione Novo grupo.
4. Na janela Novo grupo, crie um grupo de usuários local para os usuários que requerem
acesso à tabela de 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.

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 para a conta de serviço de aplicativo PI AF
2. Configurar a segurança no banco de dados da tabela de destino
3. Importar ou vincular tabelas do SQL Server

Criar um grupo de usuários local para a conta de serviço de aplicativo PI AF

Se a tabela à qual você deseja se conectar residir em uma instância do SQL Server diferente
daquela em que reside o banco de dados PI AF (PIFD), certifique-se de que a tabela seja
acessível à conta de serviço do aplicativo PI AF.

Procedimento
1. No computador em que a Instância do SQL Server reside, clique em Iniciar > Ferramentas
administrativas > Gerenciamento do computador.

186 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

O aplicativo Gerenciamento do Computador é iniciado.

2. Expanda Usuários e grupos locais.
3. Clique com o botão direito em Grupos e selecione Novo grupo.
4. Na janela Novo grupo, crie um grupo de usuários local para manter a identidade do PI AF
Server Application Service.
5. Adicione a conta do usuário associado ao PI AF Server Application Service ao novo grupo. Se
o PI AF Server Application Service estiver em execução na conta NT AUTHORITY
\NetworkService, adicione a conta do computador do servidor PI AF a este grupo.
Nota:
Se o PI AF Server Application Service estiver em execução como a conta Sistema local
ou Serviço local, provavelmente será necessário usar a autenticação do SQL Server
(modo de autenticação SQL Server e Windows) em vez 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.

Antes de Iniciar
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.

Procedimento
1. Criar um usuário SQL Server.
2. Configurar a segurança no banco de dados da tabela de destino.
3. Importar ou vincular tabelas do SQL Server.

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 PI 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.
7. Selecione a página Mapeamento do usuário.
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.

Guia do Usuário do PI System Explorer 187

Configuração de referências de dados

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.

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.

Importar ou vincular tabelas do SQL Server

Se você estiver importando de ou vinculando a tabelas do Microsoft SQL Server, o processo é
essencialmente o mesmo. As instruções a seguir descrevem como vincular a uma tabela PI AF
existente 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.

188 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

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:

◦ Para segurança Integrada, selecione a opção Use Windows NT Integrated Security.

◦ Para 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.
Nota:
Verifique se o suporte para tabelas externas do PI AF para usuários não personificados
foi ativado com o comando afdiag /DTImp.
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 PI AF
Server Application 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.
Se a string de conexão exigir um ID de usuário e uma senha, clique no botão Fornecer senha
e insira a senha de login do SQL usada para testar a conexão. Isso substitui o valor no campo
Senha.
11. Para exibir os dados recuperados pela consulta, veja a guia Tabela.

Configurar referências de dados em busca por tabela

Crie uma referência de dados em busca por tabela quando desejar que um atributo obtenha seu
valor de uma coluna da tabela.

Procedimento
1. No navegador de Elementos ou Biblioteca, selecione o elemento ou template de elemento
desejado.
2. No visualizador, selecione o atributo ou o template de atributo para o qual deseja um valor
da busca por tabela.
3. No campo Referência de dados na paleta, escolha Busca por tabela na lista.

Guia do Usuário do PI System Explorer 189

Configuração de referências de dados

4. Clique em Configurações.
5. Na janela Referência de dados em busca por tabela, selecione uma tabela definida
anteriormente na lista suspensa Tabela. Você também pode escolher uma das opções a
seguir:
◦ Clique em (Gerenciar tabelas) para abrir uma lista de tabelas que podem ser
pesquisadas ou filtradas. Para selecionar uma tabela, destaque-a na lista e clique em OK.
◦ Clique em (Propriedades de tabelas) para visualizar ou editar propriedades para a
tabela selecionada.
◦ Clique em (Criar nova tabela) para definir uma nova tabela.

6. Na lista Coluna de resultados, selecione a coluna na tabela da qual deseja ler o valor.
Nota:
Marque a caixa de seleção Nivelado para obter o valor a ser nivelado quando analisado
em uma tendência. Com essa configuração, não existe interpolação entre os valores da
tabela.
7. Na lista Unidade de medida, selecione a unidade de medida apropriada na qual são
armazenados os dados em uma coluna de resultados.
Nota:
É preferível configurar o UDM diretamente na definição da tabela para que não seja
necessário especificá-lo com cada busca por tabela.
8. Em Fuso horário, é possível definir uma configuração se ela não tiver sido definida
anteriormente na definição da tabela ou da coluna.
9. Na lista Regra, escolha uma opção:
◦ Select first row matching criteria
Use a lista Ordenar por para especificar a ordem de classificação. Essa classificação é
usada para selecionar uma linha quando mais de uma corresponder aos critérios. Para
obter mais informações, consulte Selecionar os critérios correspondentes da primeira
linha.
◦ 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.
Para obter mais informações, consulte Resumir todos os critérios de correspondência de
linhas.
◦ 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 cronológicas. Na lista Coluna de horas, selecione a
coluna da tabela que contém os timestamps que você deseja usar. Apenas as colunas com
um tipo de valor de DateTime são listadas. A cláusula WHERE não é exigida quando esta
opção é escolhida. Para obter mais informações, consulte Dados de séries cronológicas
fornecidos na tabela.
10. No painel Where, 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 Cláusula WHERE
completa. Consulte WHERE Sintaxe da cláusula para obter mais informações.

190 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

◦ Na lista Coluna, selecione a coluna da tabela a ser usada na consulta.

◦ Na lista Operador, selecione o operador relacional a ser usado na consulta.
◦ Na lista Atributo ou Valor, selecione um atributo ou um valor literal a ser usado na
consulta.
◦ Clique em Adicionar E ou Adicionar Ou para gravar a cláusula WHERE no campo Cláusula
WHERE completa com um operador AND ou OR.
◦ Edite a cláusula no campo Cláusula WHERE completa conforme necessário.
Nota:
Os botões Adicionar E ou Adicionar Ou geram automaticamente a sintaxe necessária, o
UDM e as conversões de fuso horário sempre que possível.
11. 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 Parâmetros para consultas de tabelas vinculadas.
12. Opcional. Para Valores de substituição, escolha os atributos ou valores literais a serem
retornados quando a consulta da tabela não puder localizar uma linha correspondente ou
encontrar um resultado nulo.

Nesta seção
• Selecionar os critérios correspondentes da primeira linha
• Resumir todos os critérios de correspondência de linhas
• Dados de séries cronológicas fornecidos na tabela
• WHERE Sintaxe da cláusula
• Parâmetros para consultas de tabelas vinculadas

Selecionar os critérios correspondentes da primeira linha

A regra Select first row matching criteria permite especificar a primeira linha que
corresponde ao valor retornado da cláusula WHERE.

Sintaxe
SELECT column FROM table WHERE where clause ORDER BY column ASC|DESC; options and
parameters

Argumentos
• SELECT column
Se um nome de coluna contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ].

• DE: table
Se um nome de tabela contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ].

• WHERE clause
Além dos operadores relacionais =, <>, >, >=, <, <=, LIKE e IN, é possível especificar
INTERPOLATE(column, value) para interpolar um valor para a coluna de resultados com
base em uma interpolação da coluna de entrada especificada. O operador INTERPOLATE
pode ser usado apenas uma vez em uma única cláusula WHERE.

Guia do Usuário do PI System Explorer 191

Configuração de referências de dados

Exemplo de interpolação
Em uma tabela de correia de tanque que contém uma coluna Nível e uma coluna Volume, a
seguinte string de configuração interpola o volume com base na leitura de nível:
SELECT Volume FROM MyTable WHERE INTERPOLATE(Level, @MyLevelReading)

Presuma que a tabela de amostra tenha as seguintes linhas:

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 de 2.2 resulta em um volume retornado de 22.0.

Para obter mais informações sobre a sintaxe da cláusula WHERE, consulte WHERE Sintaxe da
cláusula.

• ORDER BY column
Opcional. Especifica a ordem de classificação para que a linha correta seja usada quando
mais de uma linha corresponder à cláusula WHERE. Ordem crescente (ASC) é o padrão, a
menos que decrescente (DESC) seja especificado.

• Opções
É possível inserir as seguintes opções em uma lista separada por ponto e vírgula.
Nivelado Quando definido para true, o valor retornado aparece em um gráfico como
nivelado nos aplicativos.
TZ=time zone Especifica o fuso horário da tabela de origem.
Nota:
Geralmente, é preferível definir o fuso horário na descrição geral da
tabela ou na definição da coluna de tabela, para que não seja
necessário especificá-lo a cada pesquisa de tabela.

UDM=uom Especifica a unidade de medida para o valor retornado pela coluna de

resultado.
Nota:
É possível também definir a unidade de medida na definição da
tabela ou na definição da coluna de tabela, para que não seja
necessário especificá-la a cada pesquisa de tabela.

RWM=value Especifica o valor a ser retornado quando não há correspondência de

coluna. Se o valor for No Data, o estado digital Nenhum Dado será
retornado.
RWN=value Especifica o valor a ser retornado quando a coluna de resultado é nula. Se o
valor for No Data, o estado digital Nenhum Dado será retornado.

• Parâmetros
É possível inserir parâmetros em uma lista separada por ponto e vírgula. Inicie cada
parâmetro com o caractere @ no formato @parameter=value (value está descrito em
"Atributo ou Valor" em WHERE Sintaxe da cláusula). Para obter mais informações sobre a
utilização de parâmetros, consulte Parâmetros para consultas de tabelas vinculadas.

192 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Exemplos
• SELECT [Installation Date] FROM [Equipment Specifications] WHERE [Asset ID] =
'%Element%'

Resumir todos os critérios de correspondência de linhas

A regra Summarize all rows matching criteria permite a realização de uma operação
de resumo nas linhas em uma coluna de tabela que corresponde aos seus critérios de seleção.

Sintaxe
SELECT summary(column) FROM table WHERE where clause; options and parameters

Argumentos
• SELECIONE summary(column)
Se um nome de coluna contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ]. É possível selecionar uma das seguintes operações de
resumo.
Operação Descrição
Soma O total de todos os valores de linha.
Avg A média de todos os valores de linha.
Min O valor mínimo de todas as linhas.
Max O valor máximo de todas as linhas.
Contagem O número de linhas.
StDev A extensão de desvio para todos os valores de linha.
Var A medida média da diferença dos valores de linha a partir da média.
None Quando nenhuma operação é especificada:
◦ 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, uma matriz com um valor de
cada coluna de todas as linhas que correspondem à cláusula WHERE será
retornada.

• DE: table
Se um nome de tabela contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ].

• WHERE clause
Para obter mais informações sobre a sintaxe da cláusula WHERE, consulte WHERE Sintaxe da
cláusula.

• Opções
É possível inserir as seguintes opções em uma lista separada por ponto e vírgula.
Nivelado Quando definido para true, o valor retornado aparece em um gráfico como
nivelado nos aplicativos.

Guia do Usuário do PI System Explorer 193

Configuração de referências de dados

TZ=time zone Especifica o fuso horário da tabela de origem.

Nota:
Geralmente, é preferível definir o fuso horário na descrição geral da
tabela ou na definição da coluna de tabela, para que não seja
necessário especificá-lo a cada pesquisa de tabela.

UDM=uom Especifica a unidade de medida para o valor retornado pela coluna de

resultado.
Nota:
É possível também definir a unidade de medida na definição da
tabela ou na definição da coluna de tabela, para que não seja
necessário especificá-la a cada pesquisa de tabela.

RWM=value Especifica o valor a ser retornado quando não há correspondência de

coluna. Se o valor for No Data, o estado digital Nenhum Dado será
retornado.
RWN=value Especifica o valor a ser retornado quando a coluna de resultado é nula. Se o
valor for No Data, o estado digital Nenhum Dado será retornado.

• Parâmetros
É possível inserir parâmetros em uma lista separada por ponto e vírgula. Inicie cada
parâmetro com o caractere @ no formato @parameter=value (value está descrito em
"Atributo ou Valor" em WHERE Sintaxe da cláusula). Para obter mais informações sobre a
utilização de parâmetros, consulte Parâmetros para consultas de tabelas vinculadas.

Dados de séries cronológicas fornecidos na tabela

A regra Table provided time series data permite a seleção de uma tabela contendo
valores com um tipo de dado DateTime e a especificação da coluna que contém os dados de
séries cronológicas.

Sintaxe
SELECT column FROM table WHERE where clause; TC=column; options and parameters

Argumentos
• SELECIONE column
Se um nome de coluna contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ].

• FROM table
Se um nome de tabela contiver caracteres que não sejam alfanuméricos, incluindo espaços,
ele deve estar entre colchetes [ ].

• WHERE clause
Opcional. Para obter mais informações sobre a sintaxe da cláusula WHERE, consulte WHERE
Sintaxe da cláusula.

• TC column
Especifica a coluna que contém valores de séries cronológicas. Se um nome de coluna
contiver caracteres que não sejam alfanuméricos, incluindo espaços, ele deve estar entre
colchetes [ ].

194 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

• Opções
É possível inserir as seguintes opções em uma lista separada por ponto e vírgula.
Nivelado Quando definido para true, o valor retornado aparece em um gráfico como
nivelado nos aplicativos.
TZ=time zone Especifica o fuso horário da tabela de origem.
Nota:
Normalmente, é preferível definir o fuso horário na descrição geral
da tabela, para que não seja necessário especificá-lo a cada pesquisa
de tabela.

UDM=uom Especifica a unidade de medida para o valor retornado pela coluna de

resultado.
Nota:
É possível também definir a unidade de medida na definição da
tabela ou na definição da coluna de tabela, para que não seja
necessário especificá-la a cada pesquisa de tabela.

RWM=value Especifica o valor a ser retornado quando não há correspondência de

coluna. Se o valor for No Data, o estado digital Nenhum Dado será
retornado.
RWN=value Especifica o valor a ser retornado quando a coluna de resultado é nula. Se o
valor for No Data, o estado digital Nenhum Dado será retornado.

• Parâmetros
É possível inserir parâmetros em uma lista separada por ponto e vírgula. Inicie cada
parâmetro com o caractere @ no formato @parameter=value (value está descrito em
"Atributo ou Valor" em WHERE Sintaxe da cláusula). Para obter mais informações sobre a
utilização de parâmetros, consulte Parâmetros para consultas de tabelas vinculadas.

WHERE Sintaxe da cláusula

A cláusula WHERE usa a sintaxe SQL e está em conformidade, de maneira geral, com a sintaxe
descrita na página MSDN DataColumn.Expression Property (https://msdn.microsoft.com/en-
us/library/system.data.datacolumn.expression(v=vs.110).aspx). É possível digitar a cláusula
diretamente no campo Completar cláusula WHERE na janela Referência de dados em Busca por
Tabela ou permitir que o PSE forneça a sintaxe correta usando a Coluna , Operador, e as listas
Atributo ou Valor na seção Where. A cláusula WHERE é opcional para a regra Table provided
time series data.
A sintaxe de cláusula WHERE segue as seguintes instruções.
Coluna Nomes de coluna contendo símbolos que não são alfanuméricos devem estar
entre parênteses:
[Asset ID] ='%Element%'

Operador • O operador INTERPOLATE está disponível com a regra Select first

row matching criteria.
• Os operadores de comparação =, <>, >, >=, <, <=, IN e LIKE são suportados
por todas as regras de busca.
É possível usar os caracteres * e % alternadamente para caracteres
coringa em uma comparação LIKE. Um coringa é permitido no início e no
fim de um padrão, ou no fim de um padrão, ou no início de um padrão,
mas não no meio de uma string. Se uma string em uma cláusula LIKE
contiver um * ou %, esses caracteres devem estar entre colchetes [ ].

Guia do Usuário do PI System Explorer 195

Configuração de referências de dados

Atributo ou valor @attribute

Retorna o valor do atributo PI AF. O atributo deve estar entre colchetes [ ] se
contiver qualquer caractere que não seja alfanumérico, incluindo espaços, ou
se incluir uma especificação de UDM ou de fuso horário. Por exemplo:
[height] >= @[Level Gauge;UOM=m]

literal
• Strings devem estar entre aspas simples.
• Valores numéricos não são colocados entre aspas e não devem estar em
formato invariante (onde o caractere decimal é '.').
• Timestamps são melhor especificados no formato yyyy.mm.dd
hh.mm.ss (0-23 para hh) e colocados no caractere #. Por exemplo:
#2015.01.30 14:00:00#
substitution
Selecione ou insira um parâmetro de substituição no formato
'%substitution parameter%'. Para obter mais informações sobre
parâmetros de substituição, consulte Lista de parâmetros de substituição do
PI AF.

Parâmetros para consultas de tabelas vinculadas

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.
Quando você configura uma tabela vinculada na janela Link de tabela, você pode adicionar
parâmetros de tabela à consulta e definir valores padrão para eles. Em seguida, na janela
Referência em busca por tabela, conforme você define uma referência de dados usando a tabela
vinculada, você pode inserir os valores de parâmetro da tabela específicos a essa 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 podem provir de outros
valores de atributo ou de variáveis de substituição predefinidas, 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

196 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

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.

Referências de dados em Builder do URI

Em versões anteriores do PI Notifications, era possível definir um link da web ou um link para
um aplicativo cliente como o PI WebParts ou o PI Vision como conteúdo dentro de uma
notificação. Entretanto, uma vez que os links foram desconectados dos elementos e atributos
no PI System Explorer, somente usuários com o PI Notifications instalado foram capazes de
encontrar objetos referenciados na própria notificação de email. É possível, também, incluir
conteúdo dinâmico como um valor de um parâmetro.
Com o Builder do URI em PI AF 2016, é possível configurar referências de dados que criam
links dinâmicos em estruturas de evento, transferências, elementos ou modelos e incluem os
mesmos valores de atributo e parâmetros de substituição como outras referências de dados,
como Builder da String ou Formula. O Builder do URI está em conformidade com as regras de
sintaxe padrão (descritas no documento Solicitações de comentários RFC 3986 Sintaxe
genérica de URI (https://tools.ietf.org/html/rfc3986)) e automaticamente lida com o
escapamento de caracteres que são complexos e pesados para inserir manualmente. Ele
suporta links genéricos da web (que usam esquemas http e https), bem como links do PI Vision.
Também é possível usar o PI Notifications 2016 para enviar o link para outros usuários via e-
mail, cliente de mensagens instantâneas ou um aplicativo cliente como o PI Vision.

Criar referências de dados do Builder do URI

Copie um link da web existente ou o link do PI Vision e torne-o dinâmico em uma referência de
dados do URI Builder em que você substitui parte do URI por um valor derivado de um
atributo, uma referência de atributo ou um parâmetro de substituição. Atribua o valor do link
da web dinâmico ou o valor do link do PI Vision a um template de atributo ou atributo.

Antes de Iniciar
Quando uma referência de dados do Builder do URI for usada em um template, a substituição
do valor ocorre no tempo de execução.

Guia do Usuário do PI System Explorer 197

Configuração de referências de dados

Procedimento
1. Abra um navegador da web e localize o link da web ou o link do PI Vision que você usa como
um ponto de partida na criação de um valor do link em um template de atributo ou atributo.
2. Selecione o URI inteiro e copie-o.
3. No painel do navegador do PI System Explorer, escolha uma das seguintes ações.
Para criar uma referência de dados do URI em... Faça o seguinte...
Um template a. Clique em Biblioteca.
b. Expanda Templates na árvore do navegador.
c. Escolha um tipo de template e selecione um
template existente ou clique em Novo
template.
Um elemento a. Clique em Elementos.
b. Selecione um elemento existente na árvore
do navegador ou clique em Novo elemento.
Um modelo a. Clique em Elementos.
b. Selecione um modelo existente na árvore do
navegador ou clique com o botão direito e
clique em Novo modelo.
Uma estrutura de evento a. Clique em Estruturas de evento.
b. Expanda uma coleção de pesquisa para
estruturas de evento na árvore do navegador.
c. Selecione uma estrutura de evento existente
ou clique em Nova estrutura de evento.
Uma transferência a. Clique em Estruturas de evento.
b. Expanda uma coleção de pesquisa para
transferências na árvore do navegador.
c. Selecione uma transferência existente ou
clique em Nova transferência.

4. Escolha uma das seguintes ações.

◦ Na guia Templates de atributos, selecione um template de atributo existente ou clique
em Novo template de atributo para criar um novo template de atributo.
◦ Na guia Atributos, selecione um atributo existente ou clique em Novo atributo para criar
um novo atributo.
5. No painel de configuração de atributo, configure o template de atributo ou o atributo
conforme necessário e escolha Builder do URI na lista suspensa Referência de dados.
6. Clique em Configurações.
7. Na janela Referência de dados do Builder do URI, clique no campo Colar um URI de um
navegador da Web para usar como um template para configuração e cole o URI copiado na
etapa 2.
8. Clique em Continuar.
O URI colado é exibido na janela Referência de dados do Builder do URI e dividido nos
componentes dos campos Esquema, Endereço ou host, Porta e Caminho. Se o URI contiver
consultas e fragmentos, eles também serão exibidos nos campos Consulta e Fragmento.
9. Na janela Referência de dados do Builder do URI, escolha uma das seguintes ações.

198 Guia do Usuário do PI System Explorer

 Configuração de referências de dados

Para configurar... Faça o seguinte...

Um link da Web dinâmico Modifique os componentes do URI colado
conforme necessário.
◦ É possível escolher entre os valores de
Esquema de http e https.
◦ É possível alterar o valor Porta para qualquer
número entre 1 e 65535. Os valores padrão
para os esquemas http e https são 80 e 443
respectivamente.
◦ Para tornar dinâmicas partes do campo
Caminho, selecione um segmento. Em
seguida, clique em e selecione uma das
seguintes opções:
▪ Uma lista de outros atributos para o
objeto selecionado. Observe que os
atributos devem aparecer entre aspas
simples.
▪ Uma lista de referências de atributos.
Você também pode selecionar Pesquisar
para inserir critérios de pesquisa na
janela Pesquisa de atributo.
▪ Uma lista dos parâmetros de substituição
comumente usados. Para obter mais
informações, consulte Lista de parâmetros
de substituição do PI AF.
◦ Na tabela Consulta, é possível modificar as
configurações de Chave e Valor conforme
necessário.
▪ Para adicionar uma chave, clique em .
Nos campos Chave e Valor, digite um
valor ou clique em e selecione entre as
mesmas opções que acima.
▪ Para excluir um parâmetro, selecione uma
chave ou um valor e clique em .

Guia do Usuário do PI System Explorer 199

Configuração de referências de dados

Um link do PI Vision a. Clique na opção PI Vision.

b. No campo Exibir, modifique o valor conforme
necessário. É possível também clicar em e
selecionar uma das seguintes opções:
▪ Uma lista de outros atributos para o
objeto selecionado. Observe que os
atributos devem aparecer entre aspas
simples.
▪ Uma lista de referências de atributos.
Você também pode selecionar Pesquisar
para inserir critérios de pesquisa na
janela Pesquisa de atributo.
▪ Uma lista dos parâmetros de substituição
comumente usados. Para obter mais
informações, consulte Lista de parâmetros
de substituição do PI AF.
c. Na tabela Parâmetros, modifique as
configurações de Chave e Valor conforme
necessário.
▪ Para adicionar uma chave, clique em .
No campo Chave, clique em , selecione
um parâmetro e atribua um valor. Além de
digitar um valor, você pode selecionar
entre as mesmas opções que na etapa b
acima.
▪ Para excluir um parâmetro, selecione uma
chave ou um valor e clique em .

Ao vincular a um display em uma estrutura

de evento, o Builder do URI adiciona
automaticamente os parâmetros Ativo, Hora
de Início e Hora de Término. Para obter mais
informações sobre outros parâmetros,
consulte o tópico do PI Vision "URL
parameters reference" in Live Library
(https://livelibrary.osisoft.com) (Referência
de parâmetros de URL).

10. Clique em OK.

200 Guia do Usuário do PI System Explorer

Unidades de medida no PI AF
O PI AF é enviado com inúmeras classes de unidade de medida e fatores de conversão padrão.
É possível estender essas categorias, adicionando novas unidades de medida, bem como novas
categorias de medida. A implementação do recurso de unidades de medida (UDM) em PI AF é
baseada no Sistema Internacional de Unidades (SI).

Banco de dados de UDM

Todos os bancos de dados PI AF usam o mesmo conjunto de UDMs, que são definidas no banco
de dados de UDM. Todas as UDMs têm o conjunto de permissões de Leitura, mas outras
permissões podem ser configuradas para o banco de dados de UDM como um todo, conforme
descrito em Configurar segurança do banco de dados de UDM.

Classes de UDM e unidades canônicas

No PI AF, cada UDM é baseada em uma classe. Classes representam propriedades de medida,
como temperatura, comprimento, tempo e massa. Cada classe tem uma unidade principal. Essa
é a unidade básica a partir da qual o PI AF converte os valores para outras unidades quando
necessário. Por exemplo, a unidade canônica para a classe Length é meter e a abreviação é m.

Conversões de UDM nos aplicativos clientes

O recurso UDM permite conversões de unidades automáticas nos aplicativos clientes. Por
exemplo, suponha que um atributo PI AF tenha uma UDM de meter. Um usuário do PI
ProcessBook que está visualizando o valor desse atributo pode escolher visualizar o valor em
uma unidade diferente, como foot. O PI AF converte automaticamente os dados de metros
para pés.

Abreviações de UDM
Por padrão, as abreviações de UDM em PI AF não são sensíveis a maiúsculas e minúsculas.
Começando no PI AF 2015 R2 (v 2.7.5), você pode configurar o PI System para suportar
abreviações de UDM sensíveis a maiúsculas e minúsculas, que permitem definir abreviações
que diferem apenas pelo caso, como MV (megavolt) e mV (milivolt) ou s (segundo) e S
(Siemens).
Nota:
Todos os clientes do PI AF devem ser atualizados para o PI AF 2015 R2 ou posterior antes
de poderem acessar um servidor PI AF em que as UDMs sensíveis a maiúsculas e
minúsculas sejam permitidas.

UDMs de integral de tempo

A partir do PI AF 2017, você pode visualizar as UDMs associadas a um total ponderado no
tempo (Automático e Por dia) das UDMs de taxa. As UDMs de taxa são de classes que contêm
tempo no denominador de suas Unidades de Medida de base (por exemplo, Taxa de fluxo de
massa contém Time-1, Pressão contém Time-2). Cada propriedade do total ponderado no
tempo exibe o nome da UDM que resultará de uma chamada de dados de resumo Total (Por
dia) ou TotalWithUOM (Automático).

Vídeo
Para obter informações sobre como editar unidades de medida, assista a este vídeo:
https://www.youtube.com/watch?v=YTG3Dk_SxNM

Nesta seção
• Sensibilidade a maiúsculas e minúsculas de abreviações de UDM

Guia do Usuário do PI System Explorer 201

Unidades de medida no PI AF

• Classes base e derivadas

• Criar unidades de medida
• Criar classes de UDM
• Calculate conversion values for a UOM

Sensibilidade a maiúsculas e minúsculas de abreviações de

UDM
Um PI AF Client que é mais antigo do que PI AF 2015 R2 (v2.7.5) não pode se conectar a um PI
System que foi habilitado para usar abreviações de UDM sensíveis a maiúsculas e minúsculas.
Isso se deve à possibilidade de abreviações de UDM serem mal interpretadas: geralmente, elas
são armazenadas em referências de dados, regras de análise e arquivos do aplicativo cliente,
como planilhas e displays do PI ProcessBook.
Nota:
Deve-se atualizar um PI AF Client para PI AF 2015 R2 ou mais recente antes de ser
possível usar UDMs sensíveis a maiúsculas e minúsculas.

Referências a abreviações de UDM

Quando a sensibilidade a maiúsculas e minúsculas de UDM estiver habilitada no PI AF 2015 R2
ou mais recente, qualquer referência a uma abreviação de UDM armazenada requer que as
maiúsculas e minúsculas corretas para a abreviação sejam usadas. Por exemplo:

• Referências de dados que são configuradas com UDMs (como referência de fórmula) devem
usar a abreviação correta ou a pesquisa UDM falha.
• Regras de análise, como a função Convert falham se configuradas com as maiúsculas e
minúsculas incorretas: Convert('x', 'Kg') em vez de Convert('x', 'kg').
• Aplicativos ou referências de dados que programaticamente acessam o banco de dados de
UDM devem usar as maiúsculas e minúsculas corretas.
Nota:
Não é possível usar a opção de sensibilidade a maiúsculas e minúsculas no PI System para
alertar sobre qualquer uso configurado que contenha maiúsculas e minúsculas
incorretas.

Nomes de UDM
Diferentemente de abreviações de UDM, os nomes de UDM permanecem insensíveis a
maiúsculas e minúsculas em PI AF 2015 R2 ou mais recente quando a sensibilidade a
maiúsculas e minúsculas de UDM está habilitada. Entretanto, quando uma abreviação de UDM é
criada, ela não pode corresponder ao nome de um UDM diferente, mesmo se ele diferir em
maiúsculas e minúsculas.
Por exemplo, o seguinte é válido:
Nome Abreviação
UOM1_name UOM1
UOM2 uom1
UOM3 Uom1

O seguinte é inválido e gera a mensagem de erro: 'uom1' already exists in Unit of

Measure 'UOM1' in Unit-of-Measure Database.

202 Guia do Usuário do PI System Explorer

 Unidades de medida no PI AF

Nome Abreviação
UOM1 udm
UOM2 uom1

Configuração de abreviações de UDM sensíveis a maiúsculas e minúsculas

É possível mudar a configuração de servidor PI AF para UDMs sensíveis a maiúsculas e
minúsculas do estado desabilitado com o utilitário de linha de comando de diagnósticos PI AF
(afdiag).
Para obter mais informações sobre o utilitário afdiag consulte Utilitário PI AF Diagnostics.

Habilitar abreviações de UDM sensíveis a maiúsculas e minúsculas

Para habilitar abreviações de UDM sensíveis a maiúsculas e minúsculas, insira afdiag /ucs
na linha de comando.
Uma nova UDM, millivolt com uma abreviação de UDM mV, é adicionada ao banco de dados
de UDM, contanto que não haja nenhum conflito com unidades de medida existentes.

Desabilitar abreviações de UDM sensíveis a maiúsculas e minúsculas

É possível redefinir o servidor PI AF para abreviações de UDM que não sejam sensíveis a
maiúsculas e minúsculas com o mesmo utilitário afdiag.
Para desabilitar abreviações de UDM sensíveis a maiúsculas e minúsculas, insira afdiag /
ucs- na linha de comando.
Se qualquer abreviação de UDM existente diferir apenas em maiúsculas e minúsculas, o
utilitário não permite que o recurso seja desabilitado e exibe uma lista de abreviações
conflitantes. No mínimo, é necessário remover a unidade de medida de milivolts que foi criada
quando as abreviações de UDM sensíveis a maiúsculas e minúsculas foram habilitadas, pois
millivolt (mV) entra em conflito com megavolt (MV).

Classes base e derivadas

O PI AF predefiniu um pequeno conjunto de classes-base e um grande conjunto de classes
derivadas das classes-base, chamadas de classes derivadas. As classes derivadas são
simplesmente classes que podem ser expressas em termos de classes UDM base. Por exemplo,
tanto a classe Area quanto a classe Volume são derivadas da classe Length. Podem-se definir
praticamente todas as unidades de medidas em termos de um pequeno grupo de classes UDM
base.
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 base ou derivada. Por exemplo, como a classe Area é baseada na classe Length, a
unidade canônica para Area é o metro quadrado (m²).
OPI AF inclui várias UDMs, classes de UDM e fatores de conversão padrão, mas 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, é possível
adicionar uma classe chamada Bytes que pode incluir UDMs de bytes, KB, MB, GB, etc.

Nesta seção
• Classes base UDM
• Classes derivadas de UDM comuns

Guia do Usuário do PI System Explorer 203

Unidades de medida no PI AF

Classes base UDM

As seguintes classes base UDM predefinidas estão disponíveis no PI AF.
Classe Unidade canônica
Corrente elétrica ampere (A)
Comprimento metro (m)
Massa quilograma (kg)
Moles (quantidade de substância) mole (mol)
Ângulo plano radiano (rad)
Quantidade contagem
Proporção percentual (%)
Temperatura kelvin (K)
Horário segundo (s)

Classes derivadas de UDM comuns

As seguintes classes derivadas de UDM predefinidas estão disponíveis em PI AF.
Classe Com base em… Unidade canônica
Velocidade angular Ângulo plano * Tempo-1 radiano por segundo (rad/s)
Área Comprimento 2 metro quadrado (m2)
Densidade Massa*Comprimento-3 quilograma por metro cúbico (kg/m3)
Carga 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)
Força Massa * Comprimento * Tempo-2 newton (N)
Frequência Horário-1 hertz (Hz)
Taxa do fluxo de Massa * Tempo-1 quilograma por segundo (kg/s)
massa
Energia Massa * Comprimento2 * Tempo-3 watt (W)
Pressão Massa * Comprimento-1 * Tempo-2 pascal (Pa)
Energia específica, Comprimento2 * Tempo-2 joule por quilograma (J/kg)
entalpia específica
Velocidade Comprimento * Tempo-1 metro por segundo (m/s)
Volume Comprimento3 metro cúbico (m3)
Taxa de vazão Comprimento3 * Tempo-1 metro cúbico por segundo (m3/s)
volumétrica

Criar unidades de medida

É possível criar unidades de medida para uma classe de UDM no banco de dados de UDM.

204 Guia do Usuário do PI System Explorer

 Unidades de medida no PI AF

Procedimento
1. No navegador, clique em Unidade de medida.
2. No navegador de Unidade de medida, selecione a classe à qual deseja adicionar uma nova
unidade de medida.
3. Escolha uma das seguintes ações.
◦ Na barra de ferramentas, clique em Nova UDM.
◦ Clique com o botão direito na classe no navegador e selecione Nova unidade de medida.
◦ Clique com o botão direito no visualizador de UDM e selecione Nova unidade de medida.
4. Na janela Propriedades da unidade de medida, insira um nome exclusivo para a unidade de
medida no campo Nome.
Nota:
O nome não pode ser o mesmo que uma abreviação de UDM definida anteriormente
ou um nome de UDM.
5. No campo Abreviatura, insira uma abreviação exclusiva para a unidade de medida.
Se a sensibilidade a maiúsculas e minúsculas da UDM tiver sido ativada, você poderá usar a
mesma abreviação que em uma abreviação de UDM definida anteriormente, desde que o uso
de maiúscula ou minúscula seja diferente. Por exemplo, você pode usar FR, fr, Fr e fR para
quatro abreviações de UDM diferentes.
Nota:
A abreviação não pode ser a mesma que um nome de UDM definido anteriormente,
independentemente do caso.
6. Opcional. No campo Descrição, insira uma descrição para a unidade de medida.
7. No campo UDM de referência, selecione a unidade da classe de referência da qual a nova
unidade pode ser convertida. O valor padrão é o mesmo que o valor UDM canônica somente
de leitura.
8. Escolha um dos seguintes métodos de conversão.
CUIDADO:
As conversões que são baseadas na Fórmula têm algumas limitações e também
impacto sobre o desempenho. Você deve selecionar Fórmula apenas quando
conversões Simples são inadequadas.

Opção Descrição
Simples Converte uma UDM com base no fator de escala e
nos valores de deslocamento de base que você
insere nos seguintes campos.
◦ No campo Fator, insira um fator de conversão
da UDM de referência para a nova UDM. Por
exemplo, °C tem um fator de 1 relativo a
kelvin.
◦ No campo Deslocamento, insira um
deslocamento de conversão do valor de UDM
de referência. Por exemplo, °C têm um
deslocamento de 273,15 de Kelvin.
Fórmula Converte uma UDM com base em um cálculo de
conversão complexo. Para obter mais
informações, consulte Cálculo de conversão de
UDM com uma fórmula.

9. Clique em OK para salvar a nova UDM.

Guia do Usuário do PI System Explorer 205

Unidades de medida no PI AF

Cálculo de conversão de UDM com uma fórmula

No geral, a OSIsoft recomenda que você especifique cálculos de conversão de UDM com um
fator de escala e um deslocamento de base do valor da UDM de referência.
CUIDADO:
As conversões que são baseadas na Fórmula têm algumas limitações e também impacto
sobre o desempenho. Você deve selecionar Fórmula apenas quando conversões Simples
são inadequadas.

Limitações do cálculo de conversão

As seguintes restrições existem com os cálculos de conversão de UDM.
Tipo de conversão Limitações
Fator Nenhuma.
Fator com deslocamento Para cálculos de conversão delta, é necessário definir uma UDM
separada. Consulte a classe de UDM de temperatura (Delta) para
obter exemplos.
Fórmula • Os cálculos Delta não recebem UDMs.
• Os cálculos de resumo sobre um intervalo de dados não recebem
UDMs. Isso afeta funções de expressão de análise, como Máximo,
Mínimo, Desvio Padrão Popular, Intervalo, Desvio Padrão e Total.
Também afeta chamadas de dados de Resumo programáticas em
relação a referências de dados do ponto PI com uma UDM
atribuída.
• As pesquisas por valores de atributos excluem os atributos cujo
valor é medido nas UDMs de fórmula.

Avaliação da fórmula de UDM

PI AF usa C# para avaliação da fórmula de UDM. Siga estas diretrizes:

• Grave todas as Unidades de Medida em termos de abreviação UDM. Se uma abreviação não
for um nome de variável C# válido, coloque-a entre parênteses.
• Atenda às regras de avaliação C#.
• Você pode, como opção, chamar métodos estáticos.NET padrão, como Math.Log10(), para
executar o cálculo. Você está limitado ao que está disponível em System Assembly (.NET
Framework Math Class (https://msdn.microsoft.com/en-us/library/System.Math(v=vs.
110).aspx)).

Exemplo de método de conversão de fórmula

Como exemplo, watts (W) é a UDM canônica na classe Power. Para criar uma UDM de
Decibel-milliwatts (dBm) na classe Power, você pode inserir a seguinte fórmula:
W = Math.Pow(10,(dBm - 30)/10)
dBm = 10 * Math.Log10( W ) + 30

Criar classes de UDM

Crie classes de UDM quando você precisar de adições para as classes predefinidas no banco de
dados de UDM.

206 Guia do Usuário do PI System Explorer

 Unidades de medida no PI AF

Procedimento
1. No navegador, clique em Unidade de medida.
2. Escolha uma das seguintes ações.
◦ Na barra de ferramentas, clique no ícone Nova classe.
◦ Clique com o botão direito no navegador de Unidade de medida e selecione Nova classe
da unidade de medida.
3. Na janela Propriedades da classe da unidade de medida, preencha as propriedades na guia
Geral.
a. No campo Nome, insira um nome para a classe. Consulte Caracteres válidos em nomes de
objetos PI AF, se necessário.
b. Opcional. No campo Descrição, forneça uma descrição da classe de UDM.
c. No campo UDM canônica, digite o nome da UDM canônica para esta classe. Se a UDM não
existir, o PI AF a criará quando a nova classe for criada.
d. No campo Abreviatura da UDM canônica, insira uma abreviação exclusiva.
e. No campo Unidades de medida de base, insira um cálculo para a unidade de medida.
Escolha uma das seguintes ações.
Para... Faça o seguinte...
Adicionar um cálculo de classe de base a. Clique em .
b. Na janela Adicionar classe de UDM base,
selecione uma classe base na lista Classes de
UDM base.
c. No campo Potência base, digite o valor do
expoente ou clique em uma das teclas de seta
até que o expoente desejado já exibido.
d. Clique em OK.
e. Repita estas etapas conforme necessário,
para criar um cálculo de multiplicação
(potência base positiva) ou de divisão
(potência base negativa).
Remover um cálculo de classe de base a. Selecione uma entrada do cálculo de classe de
base.
b. Clique em .
c. Na janela de confirmação Excluir, clique em
Sim.

Nota:
Se você estiver definindo uma classe de base, deixe o campo Unidades de medida de
base em branco.
4. Opcional. Você pode adicionar novas unidades de medida à classe que está definindo.
a. Clique na guia Unidades de medida.
b. Clique com o botão direito na lista e selecione Nova unidade de medida.
c. Na janela Propriedades da unidade de medida, defina a nova unidade de medida. Para
obter mais informações, consulte Criar unidades de medida.
5. Clique em OK.

Guia do Usuário do PI System Explorer 207

Unidades de medida no PI AF

Calculate conversion values for a UOM

Use a Calculadora de conversão de unidade de medida para converter uma determinada
quantidade de UM em um valor equivalente para outros membros de sua classe.

Procedimento
1. No navegador, clique em Unidade de medida.
2. No navegador de Unidade de medida, selecione uma classe de UDM.
3. No campo Quantidade do painel Calculadora de conversão, insira a quantidade que deseja
converter.
4. Opcional. No campo UM, altere a unidade de valor do valor padrão para outra unidade de
medida na classe.
Os valores convertidos para cada UM na classe são exibidos.

208 Guia do Usuário do PI System Explorer

Configuração de segurança no PI AF
O PI AF 2015 (versão 2.7) e posterior usa um modelo de segurança que é semelhante ao usado
pelo PI Data Archive. Esse modelo conta com a segurança integrada do Windows para a
autenticação, mas oferece sua própria autorização para os objetos do PI AF usando identidades
e mapeamentos do PI AF.
Nota:
As informações de configuração de segurança descritas nesta seção presumem um
servidor PI AF 2015 e um cliente PI AF 2015.
O modelo de segurança do PI AF permite que os administradores configurem o acesso para
identidades do PI AF em cada nível da hierarquia do PI AF. O PI AF usa a segurança integrada
do Windows para conceder ou negar a conexão com o PI AF Server, para visualizar ou editar
bancos de dados e para alterar coleções.
Para obter informações detalhadas sobre como a segurança é implementada no PI Data
Archive, consulte o PI Data Archive Security Configuration Guide ou consulte o tópico de
configuração de segurança "Introduction to PI Data Archive security" in Live Library (https://
livelibrary.osisoft.com) (Introdução à segurança do PI Data Archive).

Vídeo
Para obter informações sobre como criar, mapear e conceder permissões a identidades do PI
AF, assista a este vídeo:
https://www.youtube.com/watch?v=bWqHvoLuXzs

Nesta seção
• Identidades e mapeamentos PI AF
• Identidades integradas do PI AF
• Hierarquia de segurança
• Herança de permissão
• Direitos de acesso do PI AF
• Opção Negar permissão
• Janela Configuração de segurança
• Segurança do PI AF Server
• Segurança do banco de dados PI AF
• Segurança da coleção PI AF
• Segurança do objeto PI AF
• Configurar segurança do banco de dados de UDM
• Diferenças do modelo de segurança do PI Data Archive

Identidades e mapeamentos PI AF
Uma identidade PI AF representa um conjunto de permissões de acesso no servidor PI AF. Cada
mapeamento PI AF aponta de um usuário ou grupo do Windows a uma identidade PI AF. A
partir do PI AF Server 2015 (v2.7), você não pode conceder diretamente a um usuário ou grupo
do Windows acesso a um recurso do servidor PI AF (como uma coleção de elemento ou

Guia do Usuário do PI System Explorer 209

Configuração de segurança no PI AF

objetos). Em vez disso, você cria uma identidade PI AF que tenha esse acesso e um
mapeamento PI AF entre o usuário ou grupo do Windows e essa identidade PI AF.
Os membros dos grupos do Windows que são mapeados para uma identidade PI AF têm a
concessão automática das permissões de acesso para essa identidade PI AF. Por exemplo, na
ilustração a seguir, a identidade PI AF chamada Engineers tem acesso de leitura/gravação
para a coleção Elementos. Como o grupo do Active Directory (AD) Engineering Team está
mapeado para Engineers, todos os membros desse grupo AD obtêm permissão de leitura/
gravação para a coleção Elementos.

Mapeamento do grupo AD para uma identidade PI AF

Múltiplas identidades
Um único usuário do Windows pode ser mapeado para múltiplas identidades PI AF,
normalmente através de mapeamentos das várias associações de grupo do Windows ao qual
ele pertence. Um usuário recebe permissões com base em todas as identidades PI AF para as
quais ele está mapeado. As permissões efetivas são determinadas usando a união das
permissões permitidas todas as identidades e removendo a união de todas as permissões
negadas. Por exemplo, na ilustração a seguir, o usuário Bob do Windows pertence a ambos os
grupos do AD. Portanto, Bob recebe as permissões que estão configuradas para PI AF
IDENTITY1 e PI AF IDENTITY2.

210 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Usuário do Windows com permissões de acesso cumulativas

Além disso, o usuário deve ter permissão de leitura em um banco de dados PI AF para ser capaz
de ler qualquer objeto dentro dele. Da mesma forma, o usuário deve ter permissão de gravação
em um banco de dados PI AF para ser capaz de gravar qualquer objeto dentro dele.
Para obter mais informações sobre como trabalhar com identidades e mapeamentos, consulte
Gerenciar identidades e Gerenciar mappings.

Identidades integradas do PI AF
PI AF inclui as seguintes identidades integradas PI AF:
PI AF identidade Descrição
Administrators Por padrão, essa identidade tem todas as permissões de acesso para cada
coleção e objeto no servidor PI AF, incluindo todos os bancos de dados. Ela
não pode ser modificada ou excluída. Os mapeamentos, no entanto, podem
ser adicionados e removidos e essa identidade pode ter permissões de
acesso negadas aos objetos, em caso de necessidade.
A OSIsoft recomenda que o acesso a essa identidade seja restrito a apenas
alguns usuários.

Asset Analytics (Parte da instalação do PI Analysis Service.) Essa identidade tem a

permissão de acesso necessária para trabalhar com análises. Por padrão, a
conta usada para executar o PI Analysis Service é mapeada para essa
identidade durante a instalação. Os mappings para essa conta podem ser
adicionados ou removidos.
Asset Analytics (Parte da instalação do PI Analysis Service.) Essa identidade tem
Recalculation permissão Executar, permitindo que os usuários mapeados para ela
realizem a recarga de dados históricos e recalculem as análises.

Guia do Usuário do PI System Explorer 211

Configuração de segurança no PI AF

PI AF identidade Descrição
Engineers Essa identidade tem os mesmos privilégios que Administrators, com
exceção de Admin (a) permissão. Essa identidade também não tem
permissão para excluir bancos de dados PI AF.
A OSIsoft recomenda que essa identidade seja restrita aos usuários que
estão definindo o banco de dados de ativos. Identidades adicionais devem
ser criadas para restringir o escopo do acesso dentro do PI AF.

Notifications (Parte da instalação do PI Notifications Service.) Essa identidade tem a

permissão de acesso necessária para trabalhar com regras de notificação.
Por padrão, a conta usada para executar o PI Notifications Service é
mapeada para essa identidade durante a instalação. Os mappings para essa
conta podem ser adicionados ou removidos.
Owner Essa identidade somente leitura pode ser explicitamente adicionada à
configuração de segurança de objetos específicos do PI AF para permitir
que os usuários administradores configurem privilégios para o
proprietário de um objeto. As seguintes restrições são aplicáveis:
• Não é possível adicionar mappings a essa identidade.
• Não é possível modificar, desativar ou excluir essa identidade.
• Não é possível remover ou negar a permissão de leitura para essa
identidade.
World Essa identidade tem permissões de acesso de leitura em cada coleção e
objeto no servidor PI AF. Ela não pode ser modificada ou excluída. Os
mapeamentos, no entanto, podem ser adicionados e removidos.
Por padrão, essa identidade é mapeada para o grupo de usuários do
Windows Everyone.

Hierarquia de segurança
O PI AF usa a segurança integrada do Windows para autenticar usuários e estabelecer suas
identidades do PI AF por meio de mapeamentos. O PI AF usa as identidades do PI AF para
controlar a leitura, gravação, exclusão e várias outras permissões nos componentes do PI AF
mostrados na ilustração a seguir. Cada objeto do PI AF que pode ser protegido (elemento, event
frame, notificação e assim por diante) por toda a hierarquia tem um descritor de segurança
associado que contém as informações das permissões de acesso desse objeto.
Todos os objetos do PI AF do mesmo tipo pertencem a uma coleção. Por exemplo, todos os
elementos do PI AF em um banco de dados pertencem à coleção Elementos desse banco de
dados. Cada coleção tem também um descritor de segurança associado que contém
informações de permissão de acesso. Os descritores de segurança de algumas coleções são
configurados para um PI AF Server inteiro (como Identities e Mappings), enquanto outros,
(como Analyses, Elements e Event Frames) podem ser configurados para um banco de dados
específico.

212 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Hierarquia do PI AF de coleções que podem ser protegidas

Para obter mais informações sobre a segurança da coleção, consulte Segurança da coleção PI
AF.

Herança de permissão
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 Pai-filho

Quando um objeto ou coleção é criado, um conjunto padrão de permissões de acesso é
atribuído com base nas permissões de acesso que são configuradas no pai. Quando as
permissões de acesso são configuradas em um pai, as seguintes configurações de Permissão do
filho na janela Configuração de segurança são avaliadas:

Guia do Usuário do PI System Explorer 213

Configuração de segurança no PI AF

Opção Descrição
Não modificar as permissões de Impede as permissões de acesso que foram configuradas para o
filho objeto atual ou a coleção que está sendo replicada para coleções
filhos e objetos na hierarquia PI AF.
Essa opção é o padrão quando o servidor PI AF conectado está
executando o 2.5 e versões anteriores.

Atualizar permissões filhos para
identidades modificadas
Para cada item selecionado na lista Itens para configurar na janela
Configuração de segurança, replica as permissões de acesso para
todas as coleções filhos e objetos para cada identidade na lista
Identidades cujas permissões de acesso tenham sido modificadas.
Essa opção é o padrão quando o servidor PI AF conectado está
executando o 2.6 e versões posteriores. Essa opção não está
disponível quando o servidor PI AF conectado está executando o 2.5
e versões anteriores.

Substituir permissões filhos para Para cada item selecionado na lista Itens para configurar na janela
todas as identidades
Configuração de segurança, substitui as permissões filhos para cada
identidade na lista Identidades com permissões de acesso pais.
Dica:
Antes de aplicar essa opção, a OSIsoft recomenda que você
revise as configurações de permissão de acesso para todos os
itens na lista Itens para configurar, para evitar sobrescrever
acidentalmente as permissões personalizadas que podem ter
sido aplicadas em outros lugares na hierarquia da coleção.
Revise o exemplo a seguir para esclarecer.

Exemplos
A seguinte hierarquia tem três elementos, cada um com uma configuração diferente de
permissões de acesso.

Amostra do elemento de hierarquia

• As identidades Administrators e World têm permissões de acesso a todos os três

elementos: EasternUS, SavannahSite e ProductionLine1.
• A identidade Savannah_IT tem acesso ao elemento SavannahSite.
• A identidade SavnEngineers tem acesso ao elemento ProductionLine1.

214 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Permissões de acesso para a hierarquia de amostra

Suponha que você queira adicionar uma identidade CorporateEngineering a cada elemento
na hierarquia. Você adicionaria a identidade ao elemento pai EasternUS:

Adicionar identidade ao elemento pai

Para replicar as permissões pais sem afetar as identidades já atribuídas a permissões de

acesso, configure a opção Permissões filhos como Atualizar as permissões filhos para entradas
modificadas. A string de segurança para todos os três elementos mostra que a identidade
CorporateEngineering foi adicionada, mas as outras identidades permanecem inalteradas:

Guia do Usuário do PI System Explorer 215

Configuração de segurança no PI AF

Replicar identidade e modificar permissões de acesso existentes

Para replicar as permissões pais para todas as identidades abaixo na hierarquia, configure a
opção Permissões filhos como Substituir permissões filhos para todas as identidades. A string
de segurança para todos os três elementos mostra que a identidade CorporateEngineering
foi adicionada, mas substituiu as permissões de acesso pelos atribuídos ao elemento
EasternUS:

Replicar identidade e substituir permissões de acesso existentes

Observe que as identidades Savannah_IT e SavnEngineers não aparecem mais na string de

segurança para os elementos SavannahSite e ProductionLine1 porque não foram incluídas
na lista Identidades do elemento pai EasternUS.

216 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Tipo de referência de 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 fraca

As permissões de acesso nunca são herdadas.

Direitos de acesso do PI AF
A tabela a seguir descreve as permissões de acesso que você pode atribuir a identidades do PI
AF para todos os objetos na hierarquia PI AF.
Direito de acesso Abreviatura Definição
da string de
segurança
Read r Permite que um usuário visualize o objeto. Direitos de
segurança de Read são exigidos para visualizar o objeto nos
aplicativos clientes.
Write w Permite que um usuário crie e modifique um objeto. A exceção é
que estruturas de evento e transferências também exigem a
permissão de Write Data no template de elemento do qual
eles são criados, e casos exigem a permissão de Write Data na
análise na qual estão contidos. Além disso, se os usuários não
tiverem a permissão de Write no banco de dados PI AF, eles
não poderão modificar nenhum objeto dentro do banco de
dados, independentemente da permissão específica para esse
objeto.
Read/Write Permite que um usuário leia e grave no objeto associado.
Quando selecionado, seleciona automaticamente as permissões
de Read e Write.
Read Data rd Permite que um usuário leia os valores que não sejam
referentes à configuração de atributos de elementos (a
propriedade Item de configuração para um atributo é
desmarcada). Além disso, essa permissão controla se um
usuário pode verificar 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 verificar os
casos criados em uma análise específica.
Write Data wd Permite que um usuário grave os valores que não sejam
referentes à configuração de atributos de elementos (a
propriedade Item de configuração para um atributo é
desmarcada). 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.
Read/Write Data Permite que um usuário leia e grave dados no objeto associado.
Quando selecionado, seleciona automaticamente as permissões
de Read e Write Data.

Guia do Usuário do PI System Explorer 217

Configuração de segurança no PI AF

Direito de acesso Abreviatura Definição

da string de
segurança
Delete d Permite que um usuário exclua um objeto. A exclusão dos
direitos de segurança é necessária para excluir um objeto, seja
direta ou indiretamente, removendo-o de outros objetos.
Execute x Permite que o usuário faça uma fila para a recarga de dados
históricos ou para o recálculo de análises no serviço de análise.
Também permite que o usuário realize a maioria das ações em
um caso de análise.
Admin a A capacidade de modificar as configurações de segurança, ou o
proprietário, de um objeto. Os direitos de segurança de
Administração são necessários para forçar um Desfazer
checkout em um objeto que tem seu check-out efetuado para
outro usuário, bem como bloquear e desbloquear uma estrutura
de evento.
Nota:
Usuários com permissão de administração no objeto do
servidor PI AF têm todos os direitos concedidos, não só
para o sistema, mas a todos os objetos dentro do sistema,
incluindo bancos de dados.

Subscribe s Permite que um usuário se inscreva ou remova sua inscrição

para uma notificação.
Subscribe Others so Permite que um usuário inscreva ou remova a inscrição de
outros usuários para uma notificação.
Annotate an Permite que um usuário anote e reconheça a estrutura de
evento.
Nota:
Esse direito de acesso foi adicionado em PI AF 2016. Após
uma atualização de versões anteriores do servidor, os
objetos com o direito de acesso Write Data (wd)
recebem automaticamente o direito de acesso Annotate.
As atualizações de cliente e de servidor devem usar esta
nova permissão.

Opção Negar permissão

Selecione a opção Negar nestes casos:

• Para excluir um subconjunto do mapeamento de identidade que permitiu as permissões.

• Para excluir uma permissão especial quando controle total já tiver sido concedido a uma
identidade.
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.

218 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Janela Configuração de segurança

Você pode abrir a janela Configuração de segurança em qualquer lugar do PI System Explorer
no qual o link Segurança é exibido em uma janela ou no qual Segurança é exibido em um menu
de contexto.

Configuração de segurança

Lista Itens a configurar

O conteúdo da lista Itens a configurar é determinado pelo contexto da hierarquia e indica se
você pode configurar permissões de acesso para toda a hierarquia do PI AF, um só banco de
dados e contêineres ou um só contêiner e um só objeto.

Guia do Usuário do PI System Explorer 219

Configuração de segurança no PI AF

Para configurar permissões de acesso para apenas alguns dos itens, você pode desmarcar
aqueles que não deseja configurar.

Lista Identidades
A lista Identidades contém as identidades que têm permissões para todos os itens marcados na
lista Itens a configurar. Você pode usar as funções Adicionar e Remover para gerenciar as
identidades que serão exibidas na lista.
Se o PI AF Server conectado não der suporte a identidades (versão 2.6 ou anterior), a janela
Configuração de segurança exibirá permissões de acesso para grupos e usuários e você poderá
adicionar e remover contas do Windows usando janelas padrão do Active Directory.

Lista Permissões
Como cada identidade é selecionada na lista Identidades, as permissões associadas às
identidades das entradas marcadas na lista Itens a configurar são mostradas na lista
Permissões. Você pode permitir ou negar permissões conforme desejar para cada identidade
sem perder as alterações. As permissões de acesso que você define para cada identidade são
retidas até que você clique no botão OK, Cancelar ou Aplicar.
Nota:
Se mais de uma entrada em Itens a serem configurados for marcada e a identidade
selecionada atualmente tiver uma ou mais permissões, mas não em todas as entradas
selecionadas na lista Itens, a caixa de seleção dessa permissão exibirá um ponto ( ) para
indicar que algumas entradas na lista Itens têm a permissão definida, mas outras não.

Segurança do PI AF Server
Quando o servidor PI AF é instalado pela primeira vez, o acesso admin (todas as permissões) é
concedido à identidade integrada Administrators e o acesso de leitura a todos os objetos e
coleções é concedido à identidade World. Para todas as outras identidades que são mapeadas
para usuários e grupos do Windows, um administrador precisa configurar o acesso adequado
ao servidor PI AF, bancos de dados, coleções e objetos.

220 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Configurar a segurança para um PI AF Server

Configure as permissões de acesso para um servidor PI AF conectado, para que uma identidade
PI AF possa acessar bancos de dados, coleções e objetos.

Antes de Iniciar
Para se conectar a um servidor PI AF, uma identidade deve ter permissões de leitura para o
objeto do servidor PI AF.

Procedimento
1. Escolha um dos seguintes métodos para abrir a janela Configuração de segurança para um
servidor PI AF:
Para abrir de... Faça o seguinte...
Janela Servidores a. Selecione Arquivo > Conexões.
b. Na janela Servidores, clique com o botão
direito no servidor conectado padrão ( )
PI AF e clique em Segurança.
Janela Propriedades do PI AF Server a. Na barra de ferramentas, clique em .
b. Na janela Propriedades do PI AF Server, clique
no link Segurança.
Janela Selecionar banco de dados a. Na barra de ferramentas, clique no botão
Banco de dados.
b. Na janela Selecionar banco de dados, clique no
botão Editar segurança.

Na lista Itens para configurar da janela Configuração de segurança, o servidor e cada coleção
estão selecionados.
2. Desmarque as coleções que você não deseja atribuir às mesmas configurações de permissão
que o servidor. Por exemplo, você pode querer atribuir direitos de acesso às coleções de
todo o servidor, como Mapeamentos e Identidades, mas usar um conjunto diferente de
permissões de acesso para bancos de dados e suas coleções.
3. Na lista Identidades, revise as identidades existentes e valide as suas permissões. Você
também pode adicionar e remover identidades, conforme necessário.
Para... Faça o seguinte...
Adicionar ou modificar permissões de a. Selecione uma identidade na lista
identidades existentes Identidades.
b. Na lista Permissões para Identity, marque ou
desmarque as caixas de seleção Permitir ou
Negar ao lado das permissões que deseja
configurar.

Guia do Usuário do PI System Explorer 221

Configuração de segurança no PI AF

Adicionar outra identidade à lista Identidades a. Clique em Adicionar.

b. Na janela Selecionar identidade, selecione a
identidade que deseja adicionar.
c. Clique em OK. A identidade é adicionada à
lista.
d. Na lista Permissões para Identity configure as
permissões de acesso conforme necessário
(na configuração padrão todos os itens ficam
selecionados).
Dica:
Se você precisar criar uma nova identidade
e mapeamento, clique em Nova identidade.
Para obter mais informações, consulte
Gerenciar identidades.

Remover uma identidade da lista Identidades a. Selecione uma identidade na lista

Identidades.
b. Clique em Remover.

4. Selecione uma das opções de Permissões filho. Para obter mais informações, consulte
Herança de permissão.
5. Clique em OK.

Segurança do banco de dados PI AF

Para visualizar um banco de dados, uma identidade deve ter pelo menos permissões de leitura
para o objeto de banco de dados. Configure as permissões individualmente para cada banco de
dados, ou para toda a coleção de bancos de dados.
A permissão de gravação em um banco de dados PI 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.

Nesta seção
• Configurar a segurança para novos bancos de dados do PI AF
• Configurar a segurança para um único banco de dados do PI AF

Configurar a segurança para novos bancos de dados do PI AF

Configurar Direitos de acesso do PI AF padrão para todas as identidades que precisem de
acesso a bancos de dados em um servidor PI AF.

Procedimento
1. Na barra de ferramentas, clique no botão Banco de dados.
2. Na janela Selecionar banco de dados, clique no botão Editar segurança.
Na lista Itens para configurar da janela Configuração de segurança, o servidor e cada coleção
estão selecionados.
3. Na lista Itens para configurar, desmarque o servidor e as seguintes coleções: Contatos,
Templates do contato da notificação, Identidades e Mapeamentos. Bancos de dados e todos
Banco de dados - Collections devem estar selecionados.

222 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

4. Na lista Identidades, revise as identidades existentes e valide as suas permissões. Você

também pode adicionar e remover identidades, conforme necessário.
Para...
Adicionar ou modificar permissões de
identidades existentes
Adicionar outra identidade à lista Identidades
Faça o seguinte...
a. Selecione uma identidade na lista
Identidades.
b. Na lista Permissões para Identity, marque ou
desmarque a caixa de seleção Permitir ou
Negar ao lado de cada permissão que deseja
configurar.
c. Repita para cada identidade.
a. Clique em Adicionar.
b. Na janela Selecionar identidade, selecione a
identidade que deseja adicionar.
c. Clique em OK. A identidade é adicionada à
lista.
d. Na lista Permissões para Identity, configure
as permissões de acesso conforme necessário
(a configuração padrão é todos ficarem
marcados).
Dica:
Se você precisar criar uma nova identidade
e mapeamento, clique em Nova identidade.
Para obter mais informações, consulte
Gerenciar identidades.

Remover uma identidade da lista Identidades a. Selecione uma identidade na lista

Identidades.
b. Clique em Remover.

5. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
6. Clique em OK.

Configurar a segurança para um único banco de dados do PI AF

Para um único banco de dados, configure Direitos de acesso do PI AF para as identidades que
precisam de acesso às suas coleções e objetos.

Procedimento
1. Na barra de ferramentas, clique no botão Banco de dados.
2. Na janela Selecionar banco de dados, clique com o botão direito em um banco de dados na
lista Banco de dados e clique em Segurança.
Na lista Itens para configurar da janela Configuração de segurança, o banco de dados e cada
coleção no banco de dados estão selecionados.
3. Opcional. Desmarque qualquer coleção cujas configurações padrão e identidades atribuídas
você não deseja modificar.
4. Na lista Identidades, revise as identidades existentes e valide as suas permissões. Você
também pode adicionar e remover identidades, conforme necessário.

Guia do Usuário do PI System Explorer 223

Configuração de segurança no PI AF

Para... Faça o seguinte...

Adicionar ou modificar permissões de
identidades existentes
Adicionar outra identidade à lista Identidades
a. Selecione uma identidade na lista
Identidades.
b. Na lista Permissões para Identity, marque ou
desmarque as caixas de seleção Permitir ou
Negar ao lado das permissões que deseja
configurar.
c. Repita para cada identidade.
a. Clique em Adicionar.
b. Na janela Selecionar identidade, selecione a
identidade que deseja adicionar.
c. Clique em OK. A identidade é adicionada à
lista.
d. Na lista Permissões para Identity, configure
as permissões de acesso conforme necessário
(a configuração padrão é todos ficarem
marcados).
Dica:
Se você precisar criar uma nova identidade
e mapeamento, clique em Nova identidade.
Para obter mais informações, consulte
Identidades e mapeamentos PI AF.

Remover uma identidade da lista Identidades a. Selecione uma identidade na lista

Identidades.
b. Clique em Remover.

5. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
6. Clique em OK.

Segurança da coleção PI AF
O descritor de segurança para uma coleção PI AF determina as permissões de acesso a essa
coleção, bem como as permissões de acesso padrão a novos objetos na coleção. Por exemplo, as
permissões da coleção Elementos determinam quais identidades podem criar e excluir
elementos. As permissões da coleção Elementos são replicadas como o descritor de segurança
para quaisquer objetos de Elemento recém-criados.
É possível configurar permissões de acesso a coleções em vários pontos na hierarquia PI AF. É
possível configurá-las no nível do servidor para que as permissões atribuídas a identidades no
servidor também sejam atribuídas às mesmas identidades para cada coleção em cada banco de
dados (consulte Configurar a segurança para um PI AF Server). É possível configurá-las no
nível do banco de dados para que as permissões atribuídas a identidades no banco de dados
também sejam atribuídas às mesmas identidades para cada coleção nesse banco de dados
(consulte Configurar a segurança para um único banco de dados do PI AF).
Nota:
Objetos de biblioteca (Templates, Conjuntos de enumeração, Tipos de referência, Tabelas,
Conexões de tabela e Categorias) sempre têm permissão Ler (r) independentemente das
suas configurações de segurança.

224 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Configurar segurança para as coleções

Atribuir permissões de acesso para uma coleção específica em um banco de dados PI AF.

Procedimento
1. Escolha um dos seguintes métodos para abrir a janela Configuração de segurança para uma
coleção de banco de dados:
Para abrir... Faça o seguinte...
Coleção dos elementos No navegador de Elementos, clique com o botão
direito na coleção Elementos ( ) e clique em
Segurança.
Coleção de event frames No navegador de Estruturas de evento, clique com
o botão direito em uma pesquisa de estrutura de
evento ( ) e clique em Segurança.
Coleção de transferência No navegador de Estruturas de evento, clique com
o botão direito em uma pesquisa de transferência
( ) e clique em Segurança.
Coleção de templates de elemento No navegador de Biblioteca, clique com o botão
direito em Templates de elemento e clique em
Segurança.
Nota:
As permissões de acesso para a coleção de
Templates de elemento também
configuram as permissões de acesso para
Templates de event frames, Templates de
modelo e Templates de transferência.

Coleção de conjuntos de enumeração No navegador de Biblioteca, clique com o botão

Coleção de tipos de referência
Coleção de tabelas
Coleção de conexões de tabela
Coleção de categorias
direito em Conjuntos de enumeração e clique em
Segurança.
No navegador de Biblioteca, clique com o botão
direito em Tipos de referência e clique em
Segurança.
No navegador de Biblioteca, clique com o botão
direito em Tabelas e clique em Segurança.
No navegador de Biblioteca, clique com o botão
direito em Conexões de tabela e clique em
Segurança.
No navegador de Biblioteca, clique com o botão
direito em Categorias e clique em Segurança.

Na lista Itens para configurar da janela Configuração de segurança, a coleção está

selecionada.
2. Na lista Identidades, revise as identidades existentes e valide as suas permissões. Você
também pode adicionar e remover identidades, conforme necessário.

Guia do Usuário do PI System Explorer 225

Configuração de segurança no PI AF

Para... Faça o seguinte...

Adicionar ou modificar permissões de
identidades existentes
Adicionar outra identidade à lista Identidades
a. Selecione uma identidade na lista
Identidades.
b. Na lista Permissões para Identity, marque ou
desmarque a caixa de seleção Permitir ou
Negar ao lado de cada permissão que deseja
configurar.
c. Repita para cada identidade.
a. Clique em Adicionar.
b. Na janela Selecionar identidade, selecione a
identidade que deseja adicionar.
c. Clique em OK. A identidade é adicionada à
lista.
d. Na lista Permissões para Identity configure as
permissões de acesso conforme necessário
(na configuração padrão todos os itens ficam
selecionados).
Dica:
Se você precisar criar uma nova identidade
e mapeamento, clique em Nova identidade.
Para obter mais informações, consulte
Gerenciar identidades.

Remover uma identidade da lista Identidades a. Selecione uma identidade na lista

Identidades.
b. Clique em Remover.

3. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
4. Clique em OK.

Segurança do objeto PI AF
É possível configurar permissões de acesso específicas para uma identidade, que diferem das
configurações padrão herdadas de outros lugares na hierarquia do PI AF em qualquer objeto
(ou grupo de objetos) e coleção em um banco de dados.

Configurar segurança para objetos

Configure as permissões de acesso para as identidades de objetos no navegador ou no
visualizador, em situações nas quais o acesso precisa ser diferente das permissões herdadas.
Você também pode configurar as permissões personalizadas para identidades para uma
coleção específica na Biblioteca.

Procedimento
1. Escolha uma das seguintes ações:
Para configurar permissões de acesso para... Faça o seguinte...
Um objeto de navegador Clique com o botão direito no objeto e clique em
Segurança.

226 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Vários objetos a. Com vários objetos listados no visualizador

(depois de uma pesquisa, por exemplo), use
as teclas padrão do Windows para realçar
objetos contíguos (SHIFT+<click>) ou não
contíguos (CTRL+<click>).
b. Clique com o botão direito e clique em
Segurança.

2. Na lista Identidades, revise as identidades e valide as suas permissões. Você também pode
adicionar e remover uma identidade da lista.
Para...
Adicionar ou modificar permissões de
identidades existentes
Adicionar outra identidade à lista Identidades
Faça o seguinte...
a. Selecione uma identidade na lista
Identidades.
b. Na lista Permissões para Identity, marque ou
desmarque as caixas de seleção Permitir ou
Negar ao lado das permissões que deseja
configurar.
c. Repita para cada identidade.
a. Clique em Adicionar.
b. Na janela Selecionar identidade, selecione a
identidade que deseja adicionar.
c. Clique em OK. A identidade é adicionada à
lista.
d. Na lista Permissões para Identity configure as
permissões de acesso conforme necessário
(na configuração padrão todos os itens ficam
selecionados).
Dica:
Se você precisar criar uma nova identidade
e mapeamento, clique em Nova identidade.
Para obter mais informações, consulte
Gerenciar identidades.

Remover uma identidade da lista Identidades a. Selecione uma identidade na lista

Identidades.
b. Clique em Remover.

3. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
4. Clique em OK.

Configurar a segurança de análises e templates de análises

Use a janela Configuração de segurança para gerenciar as permissões de acesso para as
identidades PI AF que podem trabalhar com análises ou templates de análise.
Para obter informações sobre permissões específicas que são necessárias para trabalhar com
análises, consulte Direitos de acesso do PI AF.

Procedimento
1. Escolha uma das seguintes ações:

Guia do Usuário do PI System Explorer 227

Configuração de segurança no PI AF

Para... Faça o seguinte...

Configurar permissões de acesso para uma
análise
Configurar permissões de acesso para um
template de análise
Configurar permissões de acesso para todas as
análises em um banco de dados PI AF
Configurar permissões de acesso para todos os
templates de análise em um banco de dados PI
AF
a. No navegador de Elementos, selecione o
elemento que contém a análise.
b. Clique na guia Análises.
c. Clique com o botão direito no nome de
análise e clique em Segurança.
a. No navegador de Biblioteca, selecione o
template de elemento que contém o template
de análise.
b. Clique na guia Templates de análises.
c. Clique com o botão direito no nome de
análise e clique em Segurança.
a. Na barra de ferramentas, clique em Bancos
de dados.
b. Na janela Selecionar banco de dados, clique
com o botão direito no nome de um banco de
dados na lista e clique em Segurança.
c. Na janela Configuração de segurança,
desmarque a caixa de seleção Item acima da
lista Itens para configurar.
d. Selecione o item database - Análises.
a. Na barra de ferramentas, clique em Bancos
de dados.
b. Na janela Selecionar banco de dados, clique
com o botão direito no nome de um banco de
dados na lista e clique em Segurança.
c. Na janela Configuração de segurança,
desmarque a caixa de seleção Item acima da
lista Itens para configurar.
d. Selecione o item database - Templates de
análises.

2. Na lista Identidades, revise as identidades e valide as suas permissões. Você também pode
adicionar e remover uma identidade da lista, como descrito em Configurar segurança para
objetos.
3. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
4. Clique em OK.

Configurar segurança do banco de dados de UDM

Não é possível definir permissões para UOMs individuais ou categorias de UOM. No entanto, é
possível definir permissões para todo o banco de dados da UDM.

Antes de Iniciar
As UMs sempre têm permissão de Leitura, independentemente das outras configurações de
segurança.

Procedimento
1. No navegador, selecione Unidade de medida.
2. Na barra de ferramentas, clique em Segurança de UDM.

228 Guia do Usuário do PI System Explorer

 Configuração de segurança no PI AF

Na lista Itens para configurar da janela Configuração de segurança, o item Banco de dados da
Unidade de medição está selecionado.
3. Na lista Identidades, revise as identidades existentes e valide as suas permissões. Você
também pode adicionar e remover identidades, conforme descrito em Configurar segurança
para objetos.
4. Na seção Permissões filhos, escolha uma das opções de herança de permissão. Para obter
mais informações, consulte Herança de permissão.
5. Clique em OK.

Diferenças do modelo de segurança do PI Data Archive

Embora o modelo de segurança seja semelhante ao usado pelo PI Data Archive, há uma série de
diferenças:
• O privilégio Negar é suportado. Veja Opção Negar permissão.
• Um conjunto mais amplo de permissões de acesso está disponível. Veja Direitos de acesso
do PI AF.
• O equivalente às identidades PI user e PI group não é suportado.
• PI Trusts e logins explícitos do PI não são suportados.
• Não há suporte para o conceito de um sinalizador que não pode ser excluído em uma
identidade ou mapeamento.
• Mapeamentos não podem ser desativados. Apenas identidades PI AF podem ser
desativadas.
• Uma única identidade de usuário do Windows pode ser mapeada para mais de uma
identidade PI AF.
• Um conjunto integrado diferente de identidades está instalado: Administrators,
Engineers e World.

Guia do Usuário do PI System Explorer 229

Configuração de segurança no PI AF

230 Guia do Usuário do PI System Explorer

Event frames no PI AF
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 recomenda que você use a análise de ativos para rastrear seus
eventos com event frames. PI Datalink, PI Vision e PI WebParts são as ferramentas cliente com
suporte à visualização de event frames.
Uma estrutura de evento engloba o período do evento com dados de ativos relevante e
compreensíveis:

Dados de evento de amostra

Vídeos
Para obter informações sobre event frames, assista a este vídeo:
https://www.youtube.com/watch?v=4XPL7J7u61U
Como alternativa, você pode assistir à playlist completa sobre event frames:
https://www.youtube.com/playlist?list=PLMcG1Hs2JbcunItGs7JS6kFl3WYMb-p3D

Nesta seção
• Estrutura dos event frames
• Vantagens dos event frames
• Exemplos de estruturas de evento
• Event Frames ou Batch?
• Formas de criar estruturas de evento
• Visualização de event frames
• Templates de estrutura de evento
• Criar estruturas de evento
• Captura de valores para estruturas de eventos e transferências

Guia do Usuário do PI System Explorer 231

Event frames no PI AF

• Bloquear event frames ou transferências

• Reconhecimento de estruturas de evento
• Transferências

Estrutura dos event frames

Cada estrutura de evento tem um nome, uma hora de início, uma hora de término, um ou mais
atributos e um ou mais elementos PI AF referenciados. Assim como os elementos, é necessário
criar templates de estrutura de evento com o fim de padronizar e gerenciar os atributos para
os diferentes tipos de eventos.
Com as estruturas de evento, é possível pesquisar facilmente no PI System os eventos, em vez
de pesquisar eventos por tempo. É possível configurar estruturas de evento para retornar
automaticamente todos os dados de eventos relacionados em tempo real, de maneira 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 evento também podem ser configurados para
recuperar dados históricos.

Quando usar estruturas de evento

Há duas categorias de eventos monitoráveis que se enquadrariam ao perfil da estrutura de
evento:
• Eventos "bons": eventos que se deseja monitorar como uma parte normal do negócio, como
o 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 ou excursões.
Esses são eventos que você quer monitorar e relatar de maneira agregada, durante um
período.
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 do PI System que sejam significativas quando elas são
alteradas, e elas devem acionar outras ações?

Vantagens dos event frames

Estas são as vantagens dos event frames:

• Flexibilidade
Event frames:
◦ Referência a vários elementos dentro do mesmo evento.
◦ Dar suporte a vários eventos sobrepostos em um elemento PI AF.
◦ Captura de qualquer evento; uma "batelada" é apenas um tipo de evento capturável.

232 Guia do Usuário do PI System Explorer

 Event frames no PI AF

• Opções de pesquisa fácil

As pesquisas podem ser especificadas em alguns atributos configuráveis de event frame: é
opcional especificar um intervalo de tempo. 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
Os event frames são extremamente escaláveis, enquanto o desempenho da pesquisa diminui
com um número grande (dezenas de milhares) de bateladas.

Exemplos de estruturas de evento

Exemplo de estruturas de evento em uma empresa de geração de energia eólica
Veja o exemplo de uma empresa de geração de energia eólica, que tem diferentes tipos de
moinhos de vento em diferentes locais e usa 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 evento específica.
O elemento windmill de amostra pode incluir esses atributos de ativos e os atributos de
estruturas de evento associados:
Atributo do ativo Atributo da estrutura de evento
RPM Velocidades instantânea e máxima
Tensão Tensão máxima
Energia Energia no momento atual
Guinada Guinada no momento atual
Arremesso Arremesso no momento atual
Pressão do rolamento de óleo Pressão máxima do rolamento de óleo

Como todos os tipos de turbinas compartilham muitos atributos idênticos, é possível criar
apenas um template de estrutura de evento e usá-lo para monitorar eventos semelhantes entre
os diferentes ativos. Por exemplo, talvez o usuário esteja interessado no atributo RPM para
capturar um evento baseado na velocidade. Usar a notação especial .\Elements[.]|RPM no
template permite o uso do template em qualquer moinho de vento e o acesso ao atributo do
elemento referenciado particular.

Exemplo de estruturas de evento usando a análise de ativos

Para obter um exemplo de como criar estruturas de eventos com a análise de ativos, consulte
Criar estruturas de evento automaticamente para acompanhar a ineficiência.

Guia do Usuário do PI System Explorer 233

Event frames no PI AF

Event Frames ou Batch?

O Batch fornece meios para geração de dados de eventos em batelada baseados em tags do PI.
O Event Frames fornece uma maneira de rastrear e analisar dados de processos e negócios
relacionados aos eventos definidos nos atributos do PI AF.
Diferentes empresas e usuários têm diferentes níveis de implementação do PI System e de uso
de seus recursos; por isso, a recomendação para escolher o Batch ou o Event Frames é
extremamente subjetiva. Você deve escolher o Batch ou o Event Frames com base nas
necessidades de negócios e de processos, como:
• Você é um usuário do Batch e usa o RtReports.
Você deve continuar usando o Batch. Entre os casos de uso comuns do Batch estão
execuções de avaliações de papel, operações de processamento de batelada química e assim
por diante.
• Você não usa atualmente o Batch, mas tem casos de uso em batelada ou precisa usar o
RtReports.
Você deve usar o Batch. A OSIsoft fornecerá um caminho de migração no futuro, quando o PI
System for compatível com essas funções.
• Você não usa o Batch e não tem casos de uso em batelada.
Você deve usar o Event Frames. Entre os casos de uso comuns do Event Frames estão a
inatividade ou queda nas usinas de energia, desvios em indústrias de saneamento e assim
por diante.
Nota:
A OSIsoft não recomenda a execução de instâncias duplas ou paralelas das interfaces do
Batch e do Event Frames na produção, pois isso aumenta a complexidade da migração.

Funcionalidade não suportada do PI System com o Event Frames

• RtReports — o PI AF e o Event Frames atualmente não são suportados pelo RtReports; no

entanto, é possível usar os produtos do PI System Access, como o PI OLEDB Enterprise, para
gravar consultas SQL para soluções de geração de relatórios de terceiros.

Formas de criar estruturas de evento

Embora seja possível criar event frames com vários produtos OSIsoft diferentes, a OSIsoft
recomenda o uso do Asset Analytics.

Análises de ativo
O PI Data Archive suporta a criação de eventos de camada única e pode acionar expressões que
abrem ou fecham estruturas de evento. Consulte Análises de geração da estrutura de eventos.

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 do PI BaGen em uma estrutura de gerador de event frames. Use o PI System
Explorer ou o PI Builder para criar os templates de event frames, atributos associados e
referências de tag do PI.
Para obter instruções sobre como criar event frames com o PI EFGen, assista a este vídeo:
https://www.youtube.com/watch?v=UbideDwhawg

234 Guia do Usuário do PI System Explorer

 Event frames no PI AF

Interfaces do PI para sistemas de execução de batelada e fabricação

O PI Batch Framework 3.x e versões posteriores podem criar estruturas de eventos em um
banco de dados do PI AF ou em objetos PI Batch em um banco de dados PI Batch. Para obter
mais informações sobre como criar event frames e usar as interfaces do PI para preencher o
banco de dados do PI AF com dados baseados em eventos, consulte:
• "Interfaces do PI para sistemas de execução de batelada e fabricação" in Live Library
(https://livelibrary.osisoft.com)
• "PI Event Frames Interface Manager" in Live Library (https://livelibrary.osisoft.com)

Interfaces programáveis
Você pode criar seu próprio programa personalizado usando o AF SDK e o PI ACE para criar e
monitorar eventos.

Criação manual de event frames

A OSIsoft não recomenda a criação e o gerenciamento manuais de event frames e recomenda o
uso do PI Data Archive com o suporte ao Asset Analytics ou do PI Batch, dependendo das
necessidades de processo. Consulte Event Frames ou Batch?.

Visualização de event frames

É possível usar as ferramentas cliente PI Datalink, PI Vision e PI WebParts para visualizar event
frames. Também é possível usar o PI OLEDB Enterprise, o PI JDBC Driver ou o PI Web Services
para integrar os dados da estrutura de evento em outras ferramentas de geração de relatório
de terceiros.
Nota:
O PI ProcessBook, PI BatchView e PI Manual Logger atualmente não são compatíveis com
a visualização de estrutura de evento.

• PI Datalink
O suporte de PI Datalink para estruturas de evento inclui a exploração e a comparação de
eventos hierárquicos. Para obter mais informações, consulte "Events in worksheets" in Live
Library (https://livelibrary.osisoft.com) (Eventos em planilhas).

• PI Vision
O PI Vision permite visualizar e analisar os dados do PI System durante o intervalo de
tempo de um determinado evento. Por exemplo, é possível examinar o desempenho de um
ativo durante o turno de um operador ou comparar os dados de vários ativos durante um
período de inatividade.
O PI Vision oferece suporte aos event frames por meio do visualizador "Eventos
relacionados". Para obter mais informações, consulte "Analyzing and comparing events" in
Live Library (https://livelibrary.osisoft.com) (Analisar e comparar eventos).

• PI WebParts
O PI WebParts não inclui recursos específicos relacionados à visualização de estrutura de
evento. No entanto, é possível criar um conjunto de dados baseado em uma fonte de dados
relacionais que recuperam dados da estrutura de evento pelo PI OLEDB Enterprise. Esses
dados da estrutura de evento 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.

Guia do Usuário do PI System Explorer 235

Event frames no PI AF

Templates de estrutura de evento

Usar os templates de estrutura de evento permite a definição e a padronização dos dados
relacionados (atributos da estrutura de evento) associados a diferentes tipos de eventos. Você
pode usar atributos de event frame para fornecer informações adicionais de contexto sobre um
determinado evento que sejam úteis para pesquisas e relatórios. 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. Você pode configurar os event
frames para gravar esses valores para você. Além disso, para cada tipo de evento, é possível
configurar um índice para os atributos mais pesquisados: isso permite pesquisas mais rápidas
e fáceis no PI AF Server ao rastrear vários tipos de eventos ou milhões de eventos.

Referências de dados em templates de event frame

Ao criar event frames dinamicamente com templates de event frame, normalmente precisa
referenciar elementos, atributos, templates ou outros objetos relacionados com base nesses
templates de event frame. Uma vez que cada event frame individual ocorre em um contexto
ligeiramente diferente, você pode usar parâmetros de substituição para referenciar outros
objetos do PI AF dinamicamente, em vez de referências absolutas e estáticas. Por exemplo, você
pode usar um template de event frame de inatividade para diversos recursos, como uma
bomba, um motor, uma caldeira, um compressor e assim por diante.
Nas referências de dados da tag do PI, os parâmetros de substituição são úteis para:
• Criar referências de nome da tag com base em hierarquia ou outros valores de atributo.
• Referenciar outros atributos da tag do PI, como de um event frame para o elemento
referenciado primário.
A principal limitação das referências de dados da tag do PI é que o atributo do elemento
também deve ser uma referência de dados da tag do PI.
Nas referências em String Personalizado, os parâmetros de substituição são úteis para:
• Obter valores numéricos ou valores de string quando os atributos do elemento referenciado
não tiverem uma referência de dados da tag do PI.
• Criar uma string concatenando vários valores de atributos do elemento referenciado e outro
texto.
• Passar um contexto de tempo, incluindo a hora de término do event frame.
• Obter o nome dos elementos referenciados ou seus pais.
A limitação das referências em String Personalizado é que elas não realizam conversões de
unidade de medida, agregações nem cálculos.
É exigida uma sintaxe específica para referenciar atributos de templates de event frame,
conforme descrito em Referências de dados a atributos no elemento referenciado primário e
Referências de dados a atributos em outros elementos.

Vídeo
Para obter informações sobre como configurar templates de event frame, assista a este vídeo:
https://www.youtube.com/watch?v=OgKaw9p4FA0

236 Guia do Usuário do PI System Explorer

 Event frames no PI AF

Elemento referenciado primário

Cada estrutura de evento faz referência a um ou mais elementos. A guia Elementos
Referenciados do event frame lista todos os elementos aos quais o event frame faz referência.
O principal elemento referenciado pelo event frame é chamado de elemento referenciado
primário e é indicado por uma marca de seleção no ícone do elemento:
Por padrão, o primeiro elemento referenciado adicionado é configurado como o elemento
referenciado primário, mas é possível alterá-lo clicando com o botão direito sobre outro
elemento e selecionando Configurar como referência de elemento primário.
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 criar
manualmente um novo elemento referenciado primário.

Referências de dados a atributos no elemento referenciado primário

Nas referências de dados de um template de event frame, você pode referenciar um atributo no
elemento referenciado primário de um event frame com a sintaxe:
.\Elements [.]|AttributeName

. Indica o objeto atual, que é o event frame.

\Elements Especifica a coleção de elementos do objeto atual.
[.] Representa o objeto padrão do objeto pai, que é o
elemento referenciado primário.
|AttributeName Especifica o nome do atributo.

Por exemplo, .\Elements [.]|Flowrate obtém o valor do atributo Flowrate do elemento

referenciado primário.

Referências de dados a atributos em outros elementos

Nas referências de dados de um template de event frame, você pode referenciar outros
elementos e atributos com os filtros de coleção mostrados na tabela a seguir.
Filtro de coleção Exemplo Explicação
@Category .\Elements[@Category=MyCategory] Obtém o valor do primeiro elemento
referenciado que é atribuído à
categoria MyCategory.
@Description .\Elements[@Description=My Description] Obtém o valor do primeiro elemento
referenciado que tem a descrição My
Description.
@Index .\Elements[@Index=3] Obtém o valor do terceiro elemento
referenciado.
.\Elements[@Index=2]|FlowRate Obtém o valor do atributo
FlowRate do segundo elemento
referenciado.

Guia do Usuário do PI System Explorer 237

Event frames no PI AF

Filtro de coleção Exemplo Explicação

@Name .\Elements[@Name=Tank1] Obtém o valor do elemento
nomeado Tank1.
Nota:
É possível usar caracteres
coringa com @Name.

.\Elements[@Name=*2]|FlowRate Obtém o valor do atributo

FlowRate do primeiro elemento
referenciado cujo nome termina em
2.
@ReferenceTyp .\Elements[@ReferenceType=Area] Obtém o valor do primeiro elemento
e referenciado que usa o tipo de
referência Area.
@Template .\Elements[@Template=MyTemplate] Obtém o valor do primeiro elemento
referenciado que usa o template
MyTemplate.
.\Elements[@Template=Pump Template]| Obtém o valor do atributo que tem o
%attribute% mesmo nome do atributo de event
frame do primeiro elemento
referenciado que usa o Pump
Template.
@Trait .\Elements[@Name=Tank*]| Obtém o valor do atributo com uma
Attributes[@Trait=LoLo] característica LoLo no primeiro
elemento referenciado cujo nome
começa com Tank.
@Type .\Elements[@Name=Tank*]| Obtém o valor do primeiro atributo
Attributes[@Type=System.Int32] que tem um tipo de valor Int32 no
primeiro elemento referenciado
cujo nome começa com Tank.
@UOM .\Elements[@Name=Tank*]|[@UOM=meter] Obtém o valor do primeiro atributo
que usa a unidade de medida meter
no primeiro elemento referenciado
cujo nome começa com Tank.

Você também pode combinar os critérios do filtro de coleção, conforme mostrado nos
exemplos a seguir:
Exemplo Explicação
.\Elements[@Name=*2][@Category=Pump]|FlowRate Obtém o valor do atributo
FlowRate do primeiro elemento
referenciado cujo nome termina em
2 e cuja categoria de elemento é
Pump.
.\Elements[@Name=Pump*][@Template=Pump Template]|FlowRate Obtém o valor do atributo
FlowRate do primeiro elemento
referenciado cujo nome começa com
Pump e cujo template de elemento é
Pump Template.

Criar templates de estrutura de evento

Crie e configure templates de estrutura de evento para garantir definições consistentes para
estruturas de evento na estrutura do ativo.

238 Guia do Usuário do PI System Explorer

 Event frames no PI AF

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, clique em Templates de estrutura de evento.
3. Para criar um novo template de estrutura de evento, escolha uma das seguintes ações:
◦ Na barra de ferramentas, clique em Novo template.
◦ Clique com o botão direito em Templates de estrutura de evento e clique em Novo
template.
◦ Clique com o botão direito no painel Templates de estrutura de evento e clique em Novo
template.
4. Na guia Geral da janela Propriedades do template de estrutura de evento, insira um nome
exclusivo e uma descrição para o template de estrutura de evento nos campos Nome e
Descrição.
5. Ajuste as configurações nas guias para configurar o template de estrutura de evento. 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:
Opção Descrição
Template base O template pode ser baseado em um template de
estrutura de evento existente, que você seleciona
na lista suspensa. Para obter mais informações
sobre templates base, consulte Templates base.
Severidade Selecione uma configuração de severidade para
estruturas de evento com base no template. Você
pode escolher Nenhum (padrão), Informações,
Aviso, Menor, Maior e Crítico.
Nota:
As estruturas de evento que já foram
criadas com uma configuração de
severidade específica não serão atualizadas
automaticamente se a configuração
Severidade em um template de estrutura
de evento for alterada posteriormente.

Categorias Opcional. Organize templates de estrutura de

evento agrupando-os em categorias de
elementos. Para procurar as categorias
disponíveis ou para criar uma nova categoria,
clique em .
Atributo padrão Opcional. Após ter criado atributos para o
template, você pode selecionar um atributo
padrão na lista suspensa. Para obter mais
informações, consulte Atributo padrão.

Guia do Usuário do PI System Explorer 239

Event frames no PI AF

Padrão de nomenclatura Opcional. É possível inserir uma string de texto

ou clicar em para escolher entre os seguintes
parâmetros de substituição para definir um
padrão de nomenclatura.
◦ %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%
◦ %UTCSTARTTIME:yyyy-MM-dd HH:mm:ss.fff
%
◦ %TEMPLATE%
◦ %ELEMENT%
◦ %ELEMENTDESCRIPTION%
Você também pode inserir %ANALYSIS% como
um parâmetro de substituição se desejar que um
nome da Analyses do Gerador de Event Frames
seja incluído no padrão de nomenclatura.
Cada elemento derivado do template terá um
nome único e identificável. Para garantir que os
novos elementos criados do template tenham um
número incremental, insira * no final de qualquer
padrão que você inserir aqui.
Alguns parâmetros de substituição talvez não
sejam aplicados quando uma estrutura de evento
derivada for criada. Para assegurar que um nome
de estrutura de evento derivado reflita
totalmente o padrão de nomenclatura, clique
com o botão direito na estrutura de evento e
clique em Reavaliar padrão de nomenclatura.
Nota:
O nome gerado pelo padrão de
nomenclatura deve ser inferior ao
comprimento máximo de 260 caracteres.
Caso seja deixado em branco, o PI System
Explorer usará as seguintes regras:
◦ Os event frames gerados por Analyses do
Gerador de Event Frames usam um padrão de
nomenclatura de: %ANALYSIS%
%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%
◦ Os event frames criados por outros métodos
usam o nome do template de event frame e a
data atual: %TEMPLATE%yyyyMMdd

Permitir extensões Marque esta caixa de seleção para permitir que

atributos adicionais sejam definidos para uma
estrutura de evento, além daqueles definidos no
template. Para obter mais informações, consulte
Extensões.
Nota:
Análises e notificações não são afetadas
pelo fato de a caixa de seleção Permitir
extensões estar ou não habilitada.

Pode ser reconhecido Marque esta caixa de seleção para permitir que
os usuários reconheçam uma estrutura de
evento. Para obter mais informações, consulte
Reconhecimento de estruturas de evento.

240 Guia do Usuário do PI System Explorer

 Event frames no PI AF

Segurança Clique neste link se deseja configurar as

permissões de acesso personalizadas para o
template de estrutura de evento, além das que já
estão estabelecidas no nível do servidor e do
banco de dados. Para obter mais informações,
consulte Configurar segurança para objetos.

6. Use a guia Templates de atributo para criar um template de atributo para cada propriedade
ou item de dados do template. Consulte Criar templates de atributo.

Alterar templates de estrutura de evento

É possível alterar o elemento no qual uma estrutura de evento está baseada ou adicionar um
template a uma estrutura de evento que não está baseada em um template.

Antes de Iniciar
Tenha cuidado ao alterar um template de estrutura de evento, pois pode haver consequências
indesejadas. Por exemplo, os atributos podem ser excluídos se forem definidos pelo template
antigo e não estiverem presentes no novo template. Certifique-se de que atributos com o
mesmo nome no template antigo e no template novo tenham o mesmo tipo de dados.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, clique com o botão direito na coleção Pesquisas de
estrutura de evento e clique em Nova pesquisa.
3. Na janela Pesquisa de estrutura de evento, insira os critérios para localizar a estrutura de
evento que você deseja alterar.
4. Clique com o botão direito na estrutura de evento apropriada no navegador e clique em
Converter > Alterar Template.
5. Na janela Escolher template de estrutura de evento, selecione o template desejado na lista
Template de estrutura de evento.
a. Opcional. Para exibir apenas templates em uma categoria específica, selecione uma
categoria na lista Templates de categoria.
6. Clique em OK.

Criar estruturas de evento

Embora você geralmente use análises de geração de estrutura de evento ou o PI Event Frame
Generator (PI EFGen) para criar estruturas de evento, é possível criar uma estrutura de evento
manualmente. Apenas não é recomendado.

Procedimento
1. No navegador, selecione Estruturas de evento.
2. Para criar um nova estrutura de evento, escolha uma das seguintes ações:
◦ Na barra de ferramentas, clique em Nova estrutura de evento.
◦ No navegador de Estruturas de evento, clique com o botão direito na coleção Pesquisas de
estrutura de evento e clique em Nova estrutura de evento.
◦ No visualizador, clique com o botão direito e clique em Novo > Nova estrutura de evento.
3. Na seção Template de estrutura de evento da janela Escolher template de estrutura de
evento, selecione um template de estrutura de evento e clique em OK.

Guia do Usuário do PI System Explorer 241

Event frames no PI AF

A nova estrutura de evento é exibida no visualizador com quatro guias para configurar a
estrutura de evento.
4. Na guia Geral, insira um nome exclusivo e uma descrição para a estrutura de evento nos
campos Nome e Descrição.
5. Ajuste as configurações nas guias para configurar a estrutura de evento. 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:
Opção Descrição
Template Exibe o template selecionado ao criar a estrutura
de evento. Para revisar as propriedades do
template, clique em .

Severidade Selecione uma configuração de severidade para a

estrutura de evento. Você pode escolher Nenhum
(padrão), Informações, Aviso, Menor, Maior e
Crítico.
Hora de início É padronizado para a data e hora atuais.
Pressione F2 ou clique em para abrir a janela
Seletor de data e hora, no qual é possível
selecionar uma hora de início diferente.
Hora de término É padronizado para nenhuma data ou hora.
Pressione F2 ou clique em para abrir a janela
Seletor de data e hora, no qual é possível
selecionar uma hora de término diferente.
Categorias Opcional. É possível organizar estruturas de
evento agrupando-as em categorias de
elementos. Para navegar nas categorias
disponíveis, clique em .
Atributo padrão Opcional. Este campo é somente leitura se a
estrutura de evento estiver baseada em um
template. Após ter criado atributos para a
estrutura de evento na guia Atributos, você pode
selecionar um atributo padrão na lista suspensa.
Para obter mais informações, consulte Atributo
padrão.
Propriedades estendidas Este link é um recurso avançado. Para obter mais
informações, consulte Armazenamento de
informações específicas de aplicativo.
Anotações Clique neste link se desejar inserir um
comentário e/ou adicionar um anexo de arquivo
específico para a estrutura de evento. Para obter
mais informações, consulte Adicionar anotações
à estrutura de evento.
Segurança Clique neste link se desejar configurar as
permissões de acesso personalizadas para a
estrutura de evento além das que já estão
estabelecidas no nível do servidor e do banco de
dados. Para obter mais informações, consulte
Configurar segurança para objetos.

6. Opcional. É possível escolher entre as seguintes ações, conforme necessário.

242 Guia do Usuário do PI System Explorer

 Event frames no PI AF

Opção Descrição
Capturar valores Para melhorar o desempenho, você pode salvar
os valores de atributo da estrutura de evento em
PI AF em vez de ter referências de dados
calculadas e executadas. Para obter mais
informações, consulte Captura de valores para
estruturas de eventos e transferências.
Bloquear Após a conclusão da ação subjacente para uma
estrutura de evento, como conclusão em batch,
você pode clicar neste link para impedir outras
alterações. Para obter mais informações, consulte
Bloquear event frames ou transferências.
Nota:
Apenas os usuários Administradores
podem desbloquear uma estrutura de
evento.

Reconhecer Se a estrutura de evento for baseada em um

template em que a configuração Pode ser
reconhecido e o direito de acesso de anotação
estão ativados, clique neste link para indicar que
você reconheceu a estrutura de evento. Para
obter mais informações, consulte
Reconhecimento de estruturas de evento.

7. Edite as outras guias conforme necessário.

◦ Para adicionar atributos, consulte Criar atributos em estruturas de evento.
◦ Para configurar um elemento referenciado primário, consulte Elemento referenciado
primário.

Criar atributos em estruturas de evento

Crie atributos em estruturas de evento da mesma maneira que em elementos.

Procedimento
1. No navegador Event Frames, localize e selecione o event frame pai.
2. No visualizador, selecione a guia Atributos.
3. Se não existir nenhum atributo, clique no link Novo atributo. Como alternativa, clique em
Novo atributo na barra de ferramentas.
Nota:
Se a estrutura de evento 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 exclusivo para o atributo.
5. No campo Descrição, insira uma descrição para o atributo.
6. No campo Propriedades, selecione as propriedades de atributos conforme necessário. Para
obter mais informações, consulte Propriedades do atributo.
7. Opcional. No campo Categorias, atribua o atributo a uma categoria. Para navegar nas
categorias disponíveis, clique em .
8. No campo UDM padrão, selecione a unidade de medida para o atributo.
9. No campo Tipo de valor, selecione o tipo de dado do atributo.
10. Para atribuir um valor ao atributo, escolha uma das seguintes ações.

Guia do Usuário do PI System Explorer 243

Event frames no PI AF

Para... Faça o seguinte...

Inserir um valor estático
Derivar ou calcular um valor de uma referência
de dados
Digite um valor no campo Valor.
a. Selecione um tipo de referência de dados na
lista Referência de dados.
b. Clique em Configurações para configurar a
referência de dados. Para obter detalhes
sobre como configurar uma referência de
dados, consulte Configuração de referências
de dados.

Captura de valores para estruturas de eventos e

transferências
Para exibir valores de um event frame ou uma transferência, o PI AF executa referências de
dados para obter valores de atributo associados ao período. No entanto, você pode usar
Capturar valores para salvar esses valores em uma tabela de banco de dados PI AF
(AFEventFrameAttributeValue). Isso pode melhorar o desempenho, já que é mais fácil
exibir os valores salvos que recuperá-los.
Você também pode usar Capturar valores para garantir que os valores de atributo exibidos
para event frames sejam, em qualquer ponto futuro, iguais ao momento em que foram
capturados. Além disso, Capturar valores oferece uma forma de preservar valores que podem
não estar disponíveis depois, como dados de streaming que não persistem em longo prazo.

Recaptura de valor
A recaptura automática ocorre sempre que a hora de início e de término de uma estrutura de
evento ou transferência capturada é modificada.
Sempre que você adiciona novos atributos a uma estrutura de evento ou transferência, deve
recuperar os valores para garantir que os valores também sejam capturados para os novos
atributos.
Observe que, quando você recaptura os valores, a perda de dados poderá ocorrer se uma
referência de dados foi alterada desde a captura do valor inicial: por exemplo, se os valores em
uma tabela acessada por uma referência de dados em busca por tabela foram modificados.

Capturar valores
Capture valores para salvar os valores do atributo da estrutura de evento ou transferência em
uma tabela no banco de dados PI AF. Isso pode melhorar o desempenho, uma vez que o PI AF
não executa nenhuma referência de dados.
Nota:
Se você adicionar novos atributos às estruturas de evento ou transferências com valores
capturados, recupere esses valores para garantir que eles também sejam capturados para
os novos atributos.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, escolha uma das ações a seguir.

244 Guia do Usuário do PI System Explorer


Para capturar valores para...
Todas as transferências ou estruturas de evento
pai em uma coleção
Estruturas de evento filho em uma coleção
Uma única estrutura de evento
Uma única transferência
3. Na janela Capturar ou recapturar valores, verifique o status e clique em Fechar.
Resultados
Um ícone Tem valores capturados ( ) é exibido no visualizador ao lado de cada estrutura de
evento ou transferência que tem um valor capturado.
Event frames no PI AF
Faça o seguinte...
a. Clique com o botão direito em uma pesquisa
ou uma coleção recente.
b. Clique em Capturar ou recapturar valores.
Como alternativa, siga estas etapas:
a. Clique em uma pesquisa ou uma coleção
recente.
b. No visualizador, clique com o botão direito
abaixo da lista de estruturas de evento ou
transferências.
c. Clique em Capturar ou recapturar valores.
a. Clique em uma pesquisa ou uma coleção
recente.
b. No visualizador, clique em ao lado de cada
estrutura de evento para a qual deseja
capturar os valores.
As estruturas de evento filho são exibidas.
c. No visualizador, use as teclas de seleção do
Windows para selecionar estruturas de
evento e estruturas de evento filho:
▪ Para selecionar objetos contíguos,
pressione SHIFT+<click>.
▪ Para selecionar objetos não contíguos,
pressione CTRL+<click>.
▪ Para selecionar todos os objetos exibidos,
pressione CTRL+A.
d. Clique com o botão direito em uma estrutura
de evento selecionada.
e. Clique em Capturar ou recapturar valores.
a. Expanda uma pesquisa ou uma coleção de
estrutura de evento recente.
b. Selecione a estrutura de evento.
c. Escolha uma das seguintes ações.
▪ Na guia Geral, clique no link Capturar
valores.
▪ Clique com o botão direito e clique
Capturar ou recapturar valores.
Nota:
Nas capturas de valores subsequentes, o
link muda para Recapturar valores.
a. Expanda uma pesquisa ou uma coleção de
transferências recente.
b. Selecione a transferência.
c. Clique com o botão direito e clique Capturar
ou recapturar valores.
Guia do Usuário do PI System Explorer 245
Event frames no PI AF

Bloquear event frames ou transferências

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 navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, abra a coleção Pesquisas de estrutura de evento (ou
Pesquisas de transferência) que contém o objeto que você deseja bloquear.
3. Clique com o botão direito no objeto e clique em Bloquear.
4. Para verificar se o objeto está bloqueado, selecione a coleção de estrutura de evento ou de
pesquisa de transferência que contém o objeto.
O objeto é exibido no visualizador ao lado de na coluna Bloquear.

Reconhecimento de estruturas de evento

Em PI AF 2016, é possível requerer que uma estrutura de evento seja reconhecida. O recurso
de reconhecimento é usado pelas notificações e pelos aplicativos cliente do PI AF, como o
PI Vision. O recurso de reconhecimento de event frames substitui a funcionalidade de
notificação de reconhecimento na versão de legado das Notificações.
• Para obter mais informações sobre como configurar o reconhecimento de event frames nas
notificações, consulte Configuração de regras de notificação para análises ou estruturas de
evento.
• Para obter mais informações sobre como visualizar e reconhecer event frames usando o
PI Vision, consulte o tópico do PI Vision "View event details and annotate events" in Live
Library (https://livelibrary.osisoft.com) (Visualizar detalhes do evento e anotar eventos).

Segurança para reconhecimento de estrutura de evento

O usuário necessita de uma PI AF identidade para a qual a permissão para Anotar (an) esteja
habilitada. Para obter mais informações sobre direitos de acesso, consulte Direitos de acesso
do PI AF.

Instalação do reconhecimento de estrutura de evento

A instalação de um reconhecimento é feita pela marcação da caixa de seleção Pode ser
reconhecido conforme a configuração de um template de estrutura de evento. Qualquer
estrutura de evento que seja baseada neste template exibe um link Reconhecer na guia Geral.
Em estruturas de evento baseadas nos templates de estrutura de evento onde a caixa de
seleção Pode ser reconhecido não esteja marcada, o link para Reconhecer fica inativo. Também
não é possível reconhecer estruturas de evento que não sejam baseadas em um template de
estrutura de evento.

Pesquisa de reconhecimento de estrutura de evento

É possível pesquisar estruturas de evento que não podem ser reconhecidas, bem como aquelas
que foram reconhecidas. A condição do reconhecimento é revisada no Visualizador para a

246 Guia do Usuário do PI System Explorer

 Event frames no PI AF

coleção de Pesquisas de estrutura de evento, onde uma coluna Reconhecido é exibida ( ). Os

valores possíveis são:
não é reconhecido
é reconhecido
vazio não reconhecível

Para agrupar event frames de acordo com seu status de reconhecimento, clique no ícone de
coluna .

Reconhecer estruturas de evento

Você reconhece as estruturas de evento no navegador de Estruturas de evento ou na guia Geral
de uma estrutura de evento selecionada no visualizador de Estruturas de evento.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, clique em uma coleção de pesquisa de estrutura de
evento. O conteúdo da coleção é exibido no visualizador.
3. Opcional. Para agrupar estruturas de evento de acordo com seu status de reconhecimento,
clique no ícone da coluna .
4. Escolha uma das seguintes ações.
Para...
Reconhecer uma estrutura de evento
Revisar um reconhecimento
Faça o seguinte...
a. Escolha uma das seguintes ações:
▪ Clique com o botão direito em uma
estrutura de evento no visualizador e
clique em Reconhecer no menu de
contexto.
▪ Clique duas vezes em uma estrutura de
evento no visualizador e, na guia Geral,
clique no link Reconhecer.
b. Clique em Sim em resposta ao prompt Tem
certeza de que deseja
reconhecerEvent_Frame_Name?.
c. Ocorrem as seguintes alterações:
▪ Na coleção Pesquisa de estrutura de
evento que é exibida no visualizador, a
coluna Reconhecido ( ) é alterada para o
status .
▪ Na guia Geral, o campo Reconhecido é
exibido com um registro de data e hora. O
ID de usuário do usuário que fez o
reconhecimento é exibido no campo Por.
a. Na coleção Pesquisa de estrutura de evento
que é exibida no visualizador, clique duas
vezes em uma estrutura de evento que tenha
um status .
b. Na guia Geral, revise o registro de data e hora
no campo Reconhecido e também o ID de
usuário do usuário que fez o reconhecimento.

Guia do Usuário do PI System Explorer 247

Event frames no PI AF

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 transferências
Crie uma transferência no navegador de Estruturas de evento.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, clique na coleção Pesquisas de transferência (ou
Transferências recentes).
3. Para criar uma nova transferência, escolha uma das seguintes ações:
◦ Na barra de ferramentas, clique no botão Nova transferência.
◦ No navegador de Estruturas de evento, clique com o botão direito na coleção Pesquisas
de transferência e clique em Nova transferência.
◦ No visualizador, clique com o botão direito e clique em Nova transferência.
4. Na janela Selecionar template de transferência, selecione um template existente para a
transferência ou selecione <None>.
a. Opcional. Para atribuir a transferência a uma categoria, selecione uma das opções na lista
Templates de categoria.
5. Clique em OK.
A nova transferência é exibida no visualizador com três guias para configurar a
transferência.
6. Na guia Geral, é exibido um nome padrão para a nova transferência e também a hora de
início padrão. Substitua o nome padrão por um nome exclusivo e insira uma descrição para
a transferência nos campos Nome e Descrição.

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

A guia Geral fornece as seguintes configurações:

• Nome: insira um nome exclusivo para a transferência.

• Descrição: opcional. Insira uma descrição para a transferência.

248 Guia do Usuário do PI System Explorer

 Event frames no PI AF

• Template: somente de leitura. Mostra o template escolhido na criação da transferência, se

houver. Para visualizar as propriedades do template, clique em .

• Categorias: somente de leitura para transferências baseadas nos templates. É possível

organizar objetos agrupando-os em categorias (opcional). Para navegar nas categorias
disponíveis, clique em . Consulte Categorização de objetos para obter mais informações.
• Nos campos Hora de início e Hora de término, insira as horas de início e de término para
quando a transferência ocorre. Para procurar uma data, clique em .

• Nos campos Origem e Porta, selecione o elemento e a porta fornecendo o material da

transferência.
• Nos campos Destino e Porta, selecione o elemento e a porta que recebem a transferência.
• Para atribuir um atributo padrão, selecione um atributo na lista Atributo padrão. Observe
que é necessário adicionar atributos na guia Atributos antes que eles sejam exibidos na lista.
Se a transferência for baseada em um template, este será um campo somente leitura que
exibe o atributo especificado no template.
• Para adicionar uma anotação à transferência, clique em Anotações. Para obter mais
informações, consulte Adicionar anotações a transferências.
Nota:
Propriedades estendidas são aquelas que outros aplicativos definem em objetos do PI AF.
Por exemplo, o PI WebParts armazena o ícone e a URL nas propriedades estendidas de
um elemento do PI AF. Tipicamente, os aplicativos usam essas informações armazenadas
em propriedades estendidas de maneira programática usando 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 essa opção 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. É possível organizar objetos
agrupando-os em categorias (opcional). Para navegar nas categorias disponíveis, clique em
. Consulte Categorização de objetos 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.

Guia do Usuário do PI System Explorer 249

Event frames no PI AF

• Valor
Insira um valor estatístico para o atributo. Somente leitura quando uma referência de dados
determina o valor.
• Referência dos dados
Selecione um tipo de referência de dados ou nenhum se este não for um atributo da
referência de dados. Se este for um atributo de referência de dados, clique em
Configurações para configurar a referência de dados. Para obter mais informações, consulte
Configuração de referências de dados.

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 na nova porta e clicar em Propriedades e, em seguida, inserir os
valores na janela Propriedades da porta.
Nota:
Para especificar essa porta como padrão, é necessário abrir a janela Propriedades.

• No campo Nome, insira um nome para a porta.

• No campo Descrição, insira uma descrição para a porta. Uma descrição é opcional.
• Tipo selecione o tipo de porta: Entrada, Saída ou Não direcionada (para metros, por
exemplo).
• No campo Categorias permitidas, selecione as categorias às quais a porta tem autorização
para ser um membro. Clique em para atribuir categorias na janela Categorizar.
• No campo 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.
• No campo Tipo de conexão, clique em e selecione os tipos de conexão permitidos aos
quais a porta pode se conectar. Clique em Qualquer para selecionar todos os tipos.
• No campo Templates permitidos, selecione o tipo de elementos permitidos para a conexão
da lista para a porta. Selecione apenas os elementos criados no template selecionado.

250 Guia do Usuário do PI System Explorer

Anotações no PI AF
A partir do PI AF 2016, o recurso de anotação é usado por aplicativos cliente como o PI Vision,
mas pode facilmente ser usado por administradores para fazer anotações sobre os seguintes
objetos:
• Caso
• Elemento
• Estrutura de evento
• Modelo
• Transferência

Anexos de arquivos
Os usuários podem anexar um único arquivo a uma anotação. Por padrão, os seguintes tipos de
arquivos são permitidos:
Tipo de arquivo Extensão permitida
MS Office csv, docx, pdf, xlsx
Texto rtf, txt
Imagem gif, jpeg, jpg, png, svg, tiff
ProcessBook pdi

O tamanho máximo de arquivos é padronizado para 10 MB.

Os administradores podem usar o Utilitário PI AF Diagnostics (afdiag localizado na pasta
\PIPC\AF) para especificar os tipos de arquivos que podem ser anexados às anotações (com o
parâmetro FileExtensions) e também o tamanho máximo de arquivo (com o parâmetro
FileMaxLength).

Segurança para anotações

Um usuário precisa ter uma identidade PI AF para a qual a permissão Anotar (an) é ativada.
Para obter mais informações sobre direitos de acesso, consulte Direitos de acesso do PI AF.

Nesta seção
• Anotações de elemento
• Anotações de estrutura de evento
• Anotações de transferência

Anotações de elemento
Usuários podem anotar um elemento, bem como fazer upload de um arquivo para criar um link
para uma anotação.

Configuração de anotações de elemento

É possível configurar uma anotação abrindo uma janela de anotações para um elemento
específico que foi selecionado no navegador de Elementos ou no visualizador. Na janela
Anotações é possível adicionar, editar e excluir anotações, bem como fazer upload, mudar e
excluir um anexo para uma anotação.

Guia do Usuário do PI System Explorer 251

Anotações no PI AF

Revisão de anotações de elemento

É possível rever um status de anotação para um elemento no visualizador de Elementos no qual
uma coluna É anotado é exibida ( ).
Para visualizar o conteúdo de uma anotação, mova o cursor do mouse sobre o ícone ao lado
de um elemento para visualizar o texto de anotação. Se um arquivo estiver anexado, o nome
dele também será exibido.

Adicionar anotações aos elementos

É possível adicionar uma ou mais anotações a um elemento.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, escolha uma das ações a seguir.
◦ Clique na coleção Elementos.
◦ Navegue até o elemento específico que você deseja anotar.
3. Para adicionar uma nova anotação, escolha uma das seguintes ações.
◦ No navegador de Elementos, clique com o botão direito em um elemento e clique em
Anotar.
◦ Se um elemento for selecionado no navegador de Elementos, clique no link Anotações na
guia Geral no visualizador.
◦ Se a coleção Elementos for selecionada no navegador, clique com o botão direito em um
elemento no visualizador e clique em Anotar.
Nota:
Para adicionar outra anotação a um elemento anotado anteriormente no
visualizador, clique duas vezes em ao lado do elemento.
4. Na janela Anotações, clique em Nova anotação.
5. Insira uma anotação no campo Comentário.
Nota:
Se você precisar de mais espaço conforme digitar, pressione F2 e insira uma anotação
na janela Visualizador de texto. Clique em OK para fechar a janela.
6. Para anexar um arquivo à anotação, clique em Adicionar anexo.
a. Na janela Abrir, navegue para o diretório em que está localizado o arquivo do qual você
deseja fazer o upload.
b. Selecione o arquivo e clique em Abrir.
O nome do arquivo é exibido no campo Anexo.
7. Clique em Fechar.

Resultados
Quando os elementos estiverem listados no visualizador de Elementos, uma coluna Anotado é
exibida ao lado do elemento. Mova o ponteiro do mouse sobre o ícone para verificar o texto da
anotação. Se um arquivo estiver anexado, o nome dele também será exibido.

252 Guia do Usuário do PI System Explorer

 Anotações no PI AF

Anotações de estrutura de evento

Usuários podem anotar uma estrutura de evento, bem como fazer upload de um arquivo para
criar um link para uma anotação.

Configuração das anotações à estrutura de evento

É possível configurar uma anotação abrindo uma janela Anotações para uma estrutura de
evento específica que foi selecionada no navegador de Estruturas de evento ou no visualizador.
Na janela Anotações é possível adicionar, editar e excluir anotações, bem como fazer upload,
mudar e excluir um anexo para uma anotação.

Pesquisar anotações de estrutura de evento

É possível pesquisar estruturas de evento que foram anotadas. O status de anotação é revisado
no visualizador para uma coleção de Pesquisas de estrutura de evento, onde uma coluna É
anotado é exibida ( ).
Para agrupar estruturas de evento de acordo com seu status de anotação, clique no ícone da
coluna .

Adicionar anotações à estrutura de evento

É possível adicionar uma ou mais anotações a uma estrutura de evento.

Antes de Iniciar
Para fazer anotações em uma estrutura de evento bloqueada, um usuário com permissão de
Administrador deve primeiro desbloqueá-la.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, clique em uma coleção Pesquisas de estrutura de
evento. O conteúdo da coleção é exibido no visualizador. As estruturas de evento com
anotações existentes exibem um ícone É anotado ( ) ao lado.
3. Para adicionar uma nova anotação, escolha uma das seguintes ações.
◦ No visualizador, clique com o botão direito em uma estrutura de evento e clique em
Anotar.
◦ No visualizador, clique duas vezes em uma estrutura de evento e clique no link
Anotações na guia Geral.
◦ No navegador de Estruturas de evento, clique com o botão direito em uma estrutura de
evento em uma coleção de pesquisa de estrutura de evento e clique em Anotar.
◦ Para adicionar outra anotação a uma estrutura de evento anotada anteriormente, clique
duas vezes em ao lado da estrutura de evento.
4. Na janela Anotações, clique em Nova anotação.
5. Insira uma anotação no campo Comentário.
Nota:
Se você precisar de mais espaço conforme digitar, pressione F2 e insira uma anotação
na janela Visualizador de texto. Clique em OK para fechar a janela.
6. Para anexar um arquivo à anotação, clique em Adicionar anexo.

Guia do Usuário do PI System Explorer 253

Anotações no PI AF

a. Na janela Abrir, navegue para o diretório em que está localizado o arquivo do qual você
deseja fazer o upload.
b. Selecione o arquivo e clique em Abrir.
O nome do arquivo é exibido no campo Anexo.
7. Clique em Fechar.

Resultados
Na coluna É anotado, é exibido ao lado da estrutura de evento. Mova o ponteiro do mouse
sobre o ícone para verificar o texto da anotação. Se um arquivo estiver anexado, o nome dele
também será exibido.

Anotações de transferência
Usuários podem anotar uma transferência, bem como fazer upload de um arquivo para criar
um link para uma anotação.

Configuração de anotações de transferência

É possível configurar uma anotação abrindo uma janela de anotações para uma transferência
específica que foi selecionada no navegador de Estruturas de evento ou no visualizador. Na
janela Anotações é possível adicionar, editar e excluir anotações, bem como fazer upload,
mudar e excluir um anexo para uma anotação.

Revisão de anotações de transferência

O status de anotação é revisado no visualizador para uma coleção de pesquisas de transferência,
onde uma coluna É anotado é exibida ( ).
Para agrupar transferências de acordo com seu status de anotação, clique no ícone da coluna .

Adicionar anotações a transferências

É possível adicionar uma ou mais anotações a uma transferência.

Procedimento
1. No navegador, clique em Estruturas de evento.
2. No navegador de Estruturas de evento, clique na coleção Pesquisas de transferência. O
conteúdo da coleção é exibido no visualizador. Transferências com anotações existentes
exibem um ícone É anotado ( ) ao lado.
3. Para adicionar uma nova anotação, escolha uma das seguintes ações.
◦ No visualizador, clique com o botão direito em uma transferência na lista de resultados
da pesquisa e clique em Anotar.
◦ No visualizador, clique duas vezes em uma transferência e clique no link Anotações na
guia Geral.
◦ No navegador de Estruturas de evento, clique com o botão direito em uma transferência
em uma coleção de Pesquisas de transferência e clique em Anotar.
◦ Para adicionar outra anotação a uma transferência anotada anteriormente, clique duas
vezes em ao lado da transferência.
4. Na janela Anotações, clique em Nova anotação.
5. Insira uma anotação no campo Comentário.

254 Guia do Usuário do PI System Explorer

 Anotações no PI AF

Nota:
Se você precisar de mais espaço conforme digitar, pressione F2 e insira uma anotação
na janela Visualizador de texto. Clique em OK para fechar a janela.
6. Para anexar um arquivo à anotação, clique em Adicionar anexo.
a. Na janela Abrir, navegue para o diretório em que está localizado o arquivo do qual você
deseja fazer o upload.
b. Selecione o arquivo e clique em Abrir.
O nome do arquivo é exibido no campo Anexo.
7. Clique em Fechar.

Resultados
Na coluna É anotado, é exibido ao lado da transferência. Mova o ponteiro do mouse sobre o
ícone para verificar o texto da anotação. Se um arquivo estiver anexado, o nome dele também
será exibido.

Guia do Usuário do PI System Explorer 255

Anotações no PI AF

256 Guia do Usuário do PI System Explorer

Análises de ativo
Análise de ativos é o recurso do PI Asset Framework (PI AF) que você usa para criar e
gerenciar análises. Uma análise lê os valores de atributos PI AF, executa cálculos e grava os
resultados para outros atributos. No PI System Explorer, você pode acessar as análises de
ativos quando trabalha com elementos e templates de elemento.

Nesta seção
• Análises
• Análises de expressão
• Análises de somatório
• Análises de geração da estrutura de eventos
• Análises SQC
• Reconciliação de estruturas de evento durante a recarga de dados históricos automática
• Gerenciamento de análises em um elemento
• Gerenciamento de análises em um banco de dados PI AF
• Análises de amostra
• 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

Análises
Uma análise executa cálculos em uma agenda especificada. A análise usa os valores do atributo
PI AF existentes como entradas e produz novas saídas, novos valores calculados ou novas
estruturas de evento. Cada análise tem um template de elemento ou elemento associado.
Os seguintes tipos de análises estão disponíveis:

• Expressão
Calcula um ou mais valores de saída de operadores, valores de entrada e funções específicas.

• Somatório
Calcula as funções estatísticas padrão para um grupo de atributos selecionados, Esse grupo
é selecionado dentre os atributos de um elemento ou dentre o conjunto de todos os
atributos em seus subelementos.

• Geração da estrutura de evento

Inicia ou termina estruturas de evento com base nas condições especificadas.

• SQC
Usa métodos de controle estatístico da qualidade (SQC) para monitorar se os valores dos
atributos estão dentro de limites predeterminados.
Todas as análises podem ser criadas a partir de templates de análise com status Enabled ou
Disabled; por padrão, as análises serão ativadas quando forem criadas. Para criar uma análise

Guia do Usuário do PI System Explorer 257

Análises de ativo

com o status Disabled, desmarque a caixa Enable analyses when created from template
(Ativar análise quando criada de template) no template de análise.
Para obter Analyses do Gerador de Event Frames e análises de SQC com saídas de event frame,
é possível criar um template de regra de notificação clicando em Create a new notification rule
template for Analysis Template Name (Criar um novo template de regra de notificação para) .
Para Expressões do Analyses e Analyses do Gerador de Event Frames, você deve especificar as
entradas nas expressões.
Para análises de expressão e somatórios, é possível mapear as saídas de análise aos atributos
PI AF. Se você mapear saídas para atributos configurados como referências de dados de ponto
PI, a análise salva o histórico da saída para um ponto PI. A OSIsoft recomenda salvar as saídas
da análise para os pontos PI. Você pode usar o ponto PI nas ferramentas de visualização para
visualizar a tendência da análise. Salvar as saídas para pontos PI também resulta em um
desempenho melhor do PI AF que salvar as saídas para atributos sem referências de dados.
Nota:
O PI Analysis Service não usa relatório de exceção ao gravar para a saída configurada
como referências dos dados do ponto PI. Embora as configurações de exceção para a tag
do PI de saída não sejam usadas, as configurações de compressão para a tag do PI de
saída serão usadas para determinar as saídas que serão gravadas no PI Data Archive.

Nesta seção
• Templates de análise
• Agendamento de análise
• Atualizações de análises e templates de análise
• Expressões para análises
• Dados e análises futuros

Templates de análise
Para aplicar uma análise a um template, especifique o elemento diretamente enquanto cria a
análise. No entanto, para aplicar uma análise a um grupo de elementos (criados do mesmo
template de elemento), é muito mais eficaz usar um template de análise do que 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 PI AF. Cada elemento originado em um
template de elemento adquire automaticamente a análise de seus templates de análise.
É possível criar um template de análise em um template de elemento de maneira 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 as análises vinculadas às notificações.
Com o PI Server 2015 R2 e versões posteriores, ao criar um template de análise em um
template de elemento que é derivado de um template de elemento base, você pode escolher
atributos de entrada de templates de atributos definidos em templates de elementos base e
também derivados. Da mesma forma, você pode mapear saídas de análise para atributos de
template base e também derivados.
Nota:
Uma análise originada em um template de análise não pode ser removida diretamente de
um elemento.

258 Guia do Usuário do PI System Explorer

 Análises de ativo

Para criar tipos específicos de templates de análise, consulte:

• Criar um template de análise da expressão
• Criar um template de análise de somatório
• Criar um template de análise de geração da estrutura de eventos
• Criar um template de análise SQC

Agendamento de análise
Cada análise requer que você especifique a agenda. A agenda especifica quando uma análise
será avaliada automaticamente. Existem dois tipos de agenda:

• Periódica
Com a agenda periódica, a avaliação ocorre com base no tempo do relógio. Você pode definir
um horário específico para a avaliação a cada dia ou o tempo entre as avaliações. Com o PI
Server 2015 R2 e versões posteriores, a frequência máxima que pode ser definida para
análises é 120 vezes por segundo.
Nota:
Se você tiver análises configuradas anteriormente para executar mais de 120 vezes
por segundo, será necessário reduzir o período para menos que o máximo permitido,
senão elas gerarão erros durante a execução com PI Server 2015 R2. Da mesma forma,
se estiver definindo um agendamento periódico fora da interface do usuário do PI
System Explorer, certifique-se de que o período seja definido para menos que o
máximo permitido.

• Desencadeado por evento

Na agenda desencadeada por evento, a avaliação ocorre com base nos eventos. Você pode
especificar um ou mais atributos de entrada que desencadeiam uma avaliação sempre que o
valor do atributo mudar.
Nota:
Quando a recarga de dados históricos automática é ativada, os eventos de
acionamento com timestamps antes da hora de início do serviço de análise são
ignorados com o objetivo de avaliação em tempo real. Para mais discussão sobre
avaliação em tempo real e recarga de dados históricos automática, incluindo a
definição do parâmetro de configuração AutoBackfillingEnabled, consulte
Configuração do serviço de análise.
Por padrão, as análises usam a agenda desencadeada por evento, desencadeada em alterações
à qualquer entrada.
Muitos fatores afetam a velocidade em que uma análise executa e grava os valores de saída:
• Arquitetura do sistema, incluindo entradas e saídas
• Configuração da rede
• Carga e desempenho de computadores diferentes
Monitore e teste suas análises, especialmente aquelas agendada com alta frequência, para
garantir que os recursos do sistema suportem a configuração.

Timestamps de saída para análises

Para qualquer análise agendada, o timestamp padrão para os valores de saída é a hora gatilho.
Para a agenda periódica, a hora gatilho é a hora da avaliação agendada; para a agenda

Guia do Usuário do PI System Explorer 259

Análises de ativo

desencadeada por evento, a hora gatilho é a hora em que um atributo especificado altera os
valores.
É possível especificar o timestamp dos valores de saída da análise. Ao especificar um
timestamp de saída, é possível:
• Produzir resultados que tenham um timestamp em um offset especificado desde a hora
gatilho.
• Produzir resultados que tenham um timestamp em um determinado horário a cada dia,
independentemente de quando a análise é avaliada. Por exemplo, é possível garantir um
timestamp de 18:00 para a saída de uma análise que calcula os resultados para um turno de
produção diária que termine às 18:00, mesmo que a análise não seja realmente avaliada até
22:00.
• Avalie uma análise repetidamente para calcular um valor de previsão de uma determinada
data e hora para, conforme as condições de entrada mudarem. Os resultados de cada
avaliação têm o mesmo timestamp: os valores de saída da análise refletem os resultados da
avaliação mais recente.

Especificar timestamp dos resultados da análise

Use a janela Opções avançadas de uma análise para especificar o timestamp dos valores de
saída da análise.

Procedimento
1. No navegador de Elementos, selecione um elemento e no visualizador, clique na guia
Análises.
2. Na lista de análises, selecione uma análise e clique em Avançado na área de agendamento,
próximo à parte inferior da janela.
3. Na janela Opções avançadas, especifique o timestamp de saída:
◦ Hora de acionamento
Valor padrão. O horário em que um agendamento é especificado ou que um valor de
entrada é alterado.
◦ Hora de execução
O horário em que a análise calcula o valor. Ele difere do horário do gatilho no qual o
sistema tem um tempo de atraso ou no qual há tempo de espera de cálculo configurado
(consulte CalculationWaitTimeInSeconds em Configuração do serviço de análise).
◦ Relativo à hora de acionamento
Um horário especificado por uma expressão de tempo do PI. Insira uma expressão de
tempo válida, como o horário relativo à hora de acionamento ou um horário fixo. Na
expressão, a hora atual e a hora de referência implícita são a hora de acionamento (isto é,
o horário em que o agendamento é especificado ou que um valor de entrada é alterado).
Se você inserir um horário fixo, todos os valores de saída da análise terão o timestamp
inserido.
Para obter informações sobre como visualizar gráficos de tendência para tempos de
saída especificados relativos aos tempos do gatilho, consulte Gráficos de tendência em
resultados prévios.

260 Guia do Usuário do PI System Explorer

 Análises de ativo

Gráficos de tendência em resultados prévios

Ao clicar com o botão direito em uma expressão ou somatórios do Analyses e seleciona
Preview Results (Visualizar resultados), é exibido o gráfico de tendências com os valores de
atributos de entrada e saída em diferentes horários do gatilho.
Se você selecionar Relative to Trigger Time e especificar '*-8h' como timestamp de saída,
por exemplo, dois gráficos de tendências serão exibidos, um para a entrada e outro para a
saída. O gráfico de entrada mostra o mesmo intervalo de tempo como a hora de início e de
término configurada; entretanto, o gráfico de saída mostra o tempo que é calculado usando a
substituição do timestamp de saída pelo tempo de gatilho. Cada gráfico de tendência mostra
um máximo de quatro atributos de entrada e quatro de saída; atualmente, os atributos de
entrada ou saída que são exibidos no gráfico são automaticamente selecionados pelo PI
Analysis Service.
Na tabela, a coluna Output Time indica o tempo de saída calculado com a substituição do
timestamp.
Nota:
Os gráficos de Resultados Prévios podem descrever dados que diferem dos resultados
reais do PI Analysis Service. Por exemplo, se os mesmos dados de timestamp são
substituídos várias vezes, a tabela e os gráficos de Resultado Prévio mostram cada valor
gravado do ponto de dados, mais o PI Analysis Service usa somente o última valor
gravado.

Atualizações de 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 afetam sua análise, inclusive a adição ou exclusão de uma
análise
• Alterações em um template de elemento, que se propagam a todos os elementos que vêm de
um template, inclusive a adição ou exclusão de um template de análise
• Alterações em um template de análise, que se propagam a todas as análises que vêm do
template
• Alterações em um template de event frame usado por uma análise; novos event frames são
baseados no template atualizado

Expressões para análises

Para Expressões do Analyses e Analyses do Gerador de Event Frames, você deve especificar as
entradas e os cálculos nas expressões. No PI System Explorer, você insere cada expressão em
uma linha. Cada linha tem as seguintes colunas:

• Nome
Um nome de variável para o valor calculado pela linha. Essa variável é interna para a
análise. É possível usar essa variável como uma entrada para expressões especificadas por
linhas subsequentes na análise.

Guia do Usuário do PI System Explorer 261

Análises de ativo

• Expressão
A especificação de um cálculo realizado. A expressão pode incluir atributos PI AF, variáveis
de linhas anteriores na análise e funções.

• Valor na avaliação
O valor calculado atual da expressão. Clique em Avaliar para calcular novamente.

• Valor no gatilho final

O valor quando o gatilho final foi calculado.

• Atributo de saída
Para análises de expressão, o atributo que armazena o valor calculado. Se a análise contiver
várias expressões, é possível mapear o valor de qualquer expressão para um atributo de
saída. No entanto, pelo menos uma expressão deve ser mapeada para um atributo de saída.
Por exemplo, uma análise de expressão pode conter uma expressão, especificada em uma única
linha.
Nome Expressão Valor na Atributo de saída
avaliação
Variable1 PrevVal('Att1') - 100 505 Analysis1_Output

Também é possível especificar o cálculo de uma análise com múltiplas expressões em várias
linhas. Por exemplo, uma análise pode conter três expressões: as duas primeiras calculam
variáveis V1 e V2, que são utilizados como entradas para a última expressão.
Nome Expressão
V1 'Att1'/2
V2 'Att2' - 'Att3'
Result V1 + 3*V2

As análises com múltiplas expressões avaliam as expressões na ordem: primeiro a linha

superior, depois a linha abaixo e assim por diante. Como as expressões nas linhas inferiores
podem depender dos resultados das linhas superiores, é possível reordenar as linhas para
avaliá-las na ordem correta.
Clique em Adicionar uma nova variável para adicionar uma linha e o ícone para excluí-la.

Dica:
É possível tornar suas expressões mais fáceis de ler adicionando comentários ao lado ou
dentro de uma expressão. Use barra dupla (//) para introduzir um comentário, ou
coloque o comentário entre uma barra e asterisco (/*) e um asterisco e barra (*/).
// Add comments here
IF x THEN y ELSE /*Do this if x is false*/ z

Nesta seção
• Especificação da expressão
• Simplificação da expressão com refatoramento

262 Guia do Usuário do PI System Explorer

 Análises de ativo

Especificação da expressão
Para criar uma expressão, clique na coluna Expressão de uma linha e especifique os atributos
de entrada, variáveis e funções que definem um cálculo. É possível fazer o seguinte:
• Selecionar e inserir atributos e funções na expressão dos painéis Funções e Atributos à
direita da expressão.
• Insira 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.
Os atributos e as expressões de tempo são colocados entre aspas simples.
As strings são colocadas entre aspas duplas.

Simplificação da expressão com refatoramento

Nos aplicativos reais, a expressão em uma análise pode ser extremamente complexa; o
comprimento dos nomes do atributo pode adicionar mais complexidade. Para simplificar uma
expressão complexa, recrie-a em um grupo de pequenas expressões atribuídas a variáveis.
As análises refatoradas são mais fáceis de entender. As análises refatoradas também são mais
fáceis de testar e depurar: é possível avaliar as expressões menores uma de cada vez e isolar os
erros.
Para refatorar uma análise, defina os componentes da análise como expressões separadas e
referencie pelo nome da variável. Por exemplo, é possível definir uma expressão separada que
defina um nome longo de atributo como uma variável separada ou que define um determinado
cálculo como uma variável separada. Para criar essas expressões separadas, basta adicionar
novas linhas de expressão à análise e inserir texto nas colunas Nome e Expressão.
Para reduzir a digitação, selecione um termo em uma expressão, clique com o botão direito na
seleção e clique em Atribuir à variável. Na linha acima da expressão, o PI System Explorer
insere uma nova linha que mapeia o termo selecionado para um novo nome de variável. Na
expressão original, o PI System Explorer substitui o termo pelo novo nome da variável.
É possível editar o nome de qualquer linha. No entanto, se o nome de uma linha da expressão já
usada como variável em outras expressões for alterada, isso quebrará a conexão entre as
expressões.

Exemplo
Suponha que você tenha uma expressão complexa definida em uma única linha:
Nome Expressão
Variable1 2*'LongAttributeName' + Avg('Att2', 'Att3', 'Att4')

É possível refatorar a expressão nas três linhas seguintes, que contêm expressões mais simples.
Observe que a terceira linha usa os nomes das linhas anteriores como variáveis.
Nome Expressão
Variable1 'LongAttributeName'
Variable2 Avg('Att2', 'Att3', 'Att4')
Variable3 2*Variable1 + Variable2

Guia do Usuário do PI System Explorer 263

Análises de ativo

Dados e análises futuros

É possível usar os dados futuros como entrada para uma análise. Também é possível usar uma
análise para produzir dados futuros, especificando um timestamp futuro para a saída a partir
de uma análise.
As expressões podem utilizar valores de eventos futuros como entrada para uma análise. No
entanto, se uma análise utilizar a agenda desencadeada por eventos, as entradas com dados
futuros podem gerar avaliações da análise. Se um atributo gatilho tiver eventos futuros, uma
avaliação ocorre à medida que cada evento se torna atual, quando a hora do relógio coincidir
com a hora exata desse evento.
As seções a seguir mostram dois usos de dados futuros nas análises. O primeiro exemplo
mostra como usar os dados futuros como uma entrada para uma análise. O segundo exemplo
mostra como usar uma análise para produzir dados futuros.

Exemplo: inserir dados futuros para avaliar valores de previsão

Suponha que você precise avaliar valores de previsão para a temperatura externa fornecida
por um serviço de terceiros. Para isso, crie uma análise que encontre a diferença entre a
previsão e os valores reais.
A análise precisa de dois atributos de entrada:

• ActualTemp
Armazena leituras de temperatura quase em tempo real de um termômetro externo.

• ForecastTemp
Armazena dados futuros, nesse caso os valores da hora para a temperatura externa todos os
dias às 6:00, 14:00 e 22:00
A análise calcula a diferença entre os valores ActualTemp e ForecastTemp grava os
resultados em um atributo de saída nomeado DeltaTemp.
Escolha a agenda desencadeada pelo evento para a análise com o atributo ForecastTemp
como o único atributo de entrada gatilho. Na agenda desencadeada pelo evento, uma avaliação
ocorre quando a análise pode detectar um novo evento para um atributo de gatilho. Como esse
atributo gatilho armazena dados futuros, a análise pode detectar um novo evento três vezes
por dia, quando a hora do relógio atingir 6:00, 14:00 e 22:00; isso desencadeia uma avaliação e
um novo resultado para o atributo DeltaTemp.

Exemplo: gere dados futuros para calcular as metas de emissões semanais

Suponha que você precise definir metas semanais para as emissões em uma fábrica de cimento,
que opera sob um CO anual voluntário2 limite. A meta semanal provavelmente mudará a cada
semana em resposta aos níveis de emissão reais da semana passada e ao montante
remanescente sob o limite anual voluntário.
No final de cada semana, você sabe as emissões reais desde o início do ano e pode calcular uma
nova meta de emissões semanais. Você quer que o timestamp para a nova meta seja
exatamente uma semana a partir da hora do cálculo, que coincide com a hora do cálculo das
emissões reais para a próxima semana.
No PI AF, crie atributos para os parâmetros dos cálculos necessários, como o limite anual.
Em seguida, crie uma nova análise de expressão que calcule um atributo de saída nomeado
WeeklyGoal. A análise conclui as seguintes etapas:
1. Localizar as emissões reais desde o início do ano.
2. Localizar a diferença entre o total do ano até a data e o limite anual.

264 Guia do Usuário do PI System Explorer

 Análises de ativo

3. Dividir a diferença pelo número de dias remanescentes no limite anual e multiplicar por
sete para calcular o atributo WeeklyGoal.
4. Salvar o atributo WeeklyGoal como um futuro ponto do PI, que preserva o histórico e
permite a tendência e outros usos.
Ao criar a análise, escolha a agenda periódica para todos os dias às 00:00 A sintaxe da análise
garante que os cálculos só executem no domingo.
Por fim, especifique o timestamp para as saídas da análise. Insira a expressão * + 7d para
definir o timestamp como exatamente sete dias a partir da hora do gatilho. O atributo
WeeklyGoal terá um timestamp que é uma semana no futuro (ou seja, no domingo seguinte às
00:00).

Análises de expressão
A análise de expressão calcula um ou mais valores de saída de operadores, valores de entrada e
funções específicas. Especifique as entradas e cálculos para estas análises nas expressões. É
possível mapear qualquer saída que uma expressão calcule para um atributo. É necessário
mapear pelo menos uma saída para um atributo.
É possível mapear a saída para um atributo existente ou criar um novo atributo ao mapear a
saída. Se você criar um novo atributo ao mapear a saída (na guia Análises no PI System
Explorer), escolha se deseja ou não salvar o histórico de saída; o sistema cria o tipo apropriado
de atributo:
• Se você optar por salvar o histórico de saída, o sistema cria um atributo com um ponto de
referência de dados do PI e cria um ponto do PI no PI Data Archive especificado. Com a saída
salva em um ponto do PI, é possível usar ferramentas de visualização para ver a tendência
associada ao cálculo e recuperar o valor a qualquer momento em que a análise efetuar o
cálculo. A análise calcula e armazena um valor conforme especificado na agenda da análise.
• Se você optar por não salvar o histórico de saída, o PI System Explorer cria um atributo com
uma referência de análise de dados. Uma análise calcula o valor apenas para expressões
mapeadas para atributos com uma referência de análise de dados quando solicitado. Para o
melhor desempenho, mapeie os atributos de saída para atributos com referências de dados
de análise, se você precisar saber apenas o valor mais recente e não precisar dos valores
anteriores.

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

No PI System Explorer, você pode criar um template de análise de expressão para um template
de elemento. No template, é possível criar uma expressão para cada cálculo. Para registrar o
valor que uma expressão calcula, mapeie a saída para um template de atributo. É possível criar
novos templates de atributos a partir do template de análise da expressão.

Antes de Iniciar
Determine os valores de saída que deseja-se calcular e salvar. Identificar as funções, os
operadores e os atributos de entrada necessários para os cálculos.

Guia do Usuário do PI System Explorer 265

Análises de ativo

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, selecione o template de elemento em que deseja criar o
template de análise.
3. No visualizador, clique na guia Templates de análise.
A guia lista todos os templates de análise já definidos para o template de elemento.
4. Crie um template de análise para o template de elemento:
◦ Se nenhum template de análise existir, clique em Criar um template de análise para criar
o primeiro.
◦ Caso contrário, clique em Novo template de análise para criar um.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Expressão.
6. Opcional. Desmarque a caixa de seleção Enable analyses when created from template
(Ativar análises quando criadas do template) para que a análise seja criada no status
Disabled.
Por padrão, uma nova análise será criada com o status Enabled. Desmarque a opção se não
deseja iniciar a análise quando ela for criada.
7. Opcional. Para avaliar expressões temporariamente no template de análise com base nos
valores de um elemento específico, clique no link Selecionar um elemento de exemplo e
selecione um elemento com base no template de elemento atual. Se nenhum elemento tiver
sido criado do template de elemento atual, você deverá criar um elemento primeiro.
Os templates não têm dados concretos associados aos atributos deles. Não é possível avaliar
uma expressão em um template de análise, exceto quando você obtém valores de atributo
de um elemento específico.
O PI System Explorer define Elemento de exemplo para o elemento selecionado.
8. Especifique uma ou mais expressões para a análise.
Insira cada expressão em uma linha. Uma expressão especifica as entradas e cálculos.
Consulte Expressões para análises.
9. Mapeie pelo menos uma expressão a um template de atributo de saída.
a. Na coluna Atributo de saída para a expressão, clique em Mapear.
b. Especifique o template de atributo.

266 Guia do Usuário do PI System Explorer

 Análises de ativo

Para... Faça o seguinte...

Mapear a saída para um template de atributo
existente
Clique no nome do template de atributo.
Selecione um template de atributo com uma
referência de dados de ponto do PI para
armazenar o histórico do cálculo. Para um
melhor desempenho quando você não precisar
do histórico, use um template de atributo com
uma referência de dados de análise.

Mapear a saída para um novo template de a. Clique em Novo template de atributo para
atributo abrir a janela Propriedades do template de
atributo.
b. Indique se o atributo deve salvar o histórico
da saída:
▪ Clique em Sim para criar um atributo com
uma referência de dados do ponto PI. Esse
atributo salva o histórico da saída.
▪ Clique em Não para criar um atributo com
uma referência de dados de análise. Esse
atributo calcula um novo valor quando
solicitado.
c. Configurar o template de atributo para criar:
▪ Nome
Nome do atributo criado.

▪ Descrição
Texto opcional que descreve o atributo.

▪ Servidor de dados
Para os atributos que salvam o histórico
de saída, o servidor PI Data Archive que
armazena a referência de dados do ponto
PI. Por padrão, isso é configurado como
%Server%, que configura o servidor
padrão PI Data Archive.

▪ Tipo de valor
O tipo de dados que o atributo armazena.
Depois de criar o template de atributo, você
pode refinar sua definição na guia Templates
de atributo.
d. Clique em OK para criar o template de
atributo.

10. Opcional. Se você especificar um elemento de exemplo, clique em Avaliar para verificar os
valores de saída das expressões individuais.
11. Especifique o agendamento da análise. Consulte Agendamento de análise.
12. Opcional. Se você especificar um elemento de exemplo, verifique a análise revisando os
resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.

Guia do Usuário do PI System Explorer 267

Análises de ativo

13. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas.
14. Clique em Check-in na barra de ferramentas para salvar o template de análise para o PI AF
Server e criar a análise para qualquer elemento com base no template de elemento.

Criar uma análise de expressão

No PI System Explorer, você pode criar uma análise de expressão única para um elemento
individual. Na análise, é possível criar uma expressão para cada cálculo. Para registrar o valor
que uma expressão calcula, mapeie a saída para um atributo. É possível criar novos atributos à
medida que a análise é configurada.

Antes de Iniciar
Determine os valores de saída que deseja-se calcular e salvar. Identificar as funções, os
operadores e os atributos de entrada necessários para os cálculos.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, selecione o elemento em que deseja criar a análise.
3. No visualizador, clique na guia Análises.
A guia lista todas as análises já definidas para o elemento.
4. Crie uma análise para o elemento:
◦ Se não houver nenhuma análise, clique em Criar análise para criar a primeira.
◦ Caso contrário, clique em Nova análise para criar uma.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Expressão.
6. Especifique uma ou mais expressões para a análise.
Insira cada expressão em uma linha. Uma expressão especifica as entradas e cálculos.
Consulte Expressões para análises.
7. Mapeie pelo menos uma expressão a um atributo de saída.
a. Na coluna Atributo de saída para a expressão, clique em Mapear.
b. Especifique o atributo.

268 Guia do Usuário do PI System Explorer

 Análises de ativo

Para... Faça o seguinte...

Mapear a saída para um atributo existente
Clique no nome do atributo.
Selecione um atributo com uma referência de
dados de ponto PI para armazenar o histórico do
cálculo. Para um melhor desempenho quando
você não precisar do histórico, use um atributo
com uma referência de dados de análise.

Mapear a saída para um novo atributo
a. Clique em Novo atributo para abrir a janela
Propriedades do atributo.
b. Indique se o atributo deve salvar o histórico
da saída:
▪ Clique em Sim para criar um atributo com
uma referência de dados do ponto PI. Esse
atributo salva o histórico da saída.
▪ Clique em Não para criar um atributo com
uma referência de dados de análise. Esse
atributo calcula um novo valor quando
solicitado.
c. Configure o atributo:
▪ Nome
Nome do atributo criado.

▪ Descrição
Texto opcional que descreve o atributo.

▪ Servidor de dados
Para os atributos que salvam o histórico
de saída, o servidor PI Data Archive que
armazena a referência de dados do ponto
PI. Por padrão, isso é configurado como
%Server%, que configura o servidor
padrão PI Data Archive.

▪ Tipo de valor
O tipo de dados que o atributo armazena.
Depois de criar o atributo, você pode refinar
sua definição na guia Atributos.
d. Clique em OK para criar o atributo.

8. Opcional. Clique em Avaliar para verificar os valores de saída nas horas do Valor no gatilho
final e do Valor na avaliação.
9. Especifique o agendamento da análise. Consulte Agendamento de análise.
10. Opcional. Para verificar a análise, revise os resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
11. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas. Isso não executa a análise.
12. Clique em Fazer check-in na barra de ferramentas.
O PI System Explorer salva e faz o check-in da sua análise e começa a executá-la.

Guia do Usuário do PI System Explorer 269

Análises de ativo

Análises de somatório
Os somatórios do Analyses calculam valores estatísticos, como a soma e a média dos atributos
selecionados associados a um elemento. Por exemplo, uma análise de sintetização em um
elemento de fábrica pode usar os valores de atributo de temperatura em todas as bombas na
fábrica para calcula a temperatura média delas.
É possível escolher uma das duas fontes de atributos para incluir em uma análise de
sintetização:

• 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 um cálculo 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

Por 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 somatório no elemento pai (a
refinaria) que calcule a média dos atributos de consumo de energia de seus elementos filhos
(bombas).
Use os critérios de seleção para selecionar atributos para o somatório. É possível selecionar
atributos que correspondam ao texto do nome do atributo que você inseriu ou que estão
associados a um template de categoria ou elemento que você especificou.
Com o PI Server 2015 R2 e versões posteriores, é possível selecionar atributos filhos para
somatórios do Analyses. Para obter mais informações, consulte Criar uma análise de somatório.
Especifique uma ou mais funções para calcular as estatísticas dos atributos selecionados na
sintetização (consulte Funções de análise de somatório). Certifique-se de que cada saída seja
mapeada para um atributo de saída.
Saiba que:
• Selecione os atributos com cuidado para obter resultados sensíveis. Evite selecionar um
conjunto com unidades de medida (UDMs) mistas (como temperatura e massa) ou tipos de
valores mistos (como valores numéricos e timestamps). Contanto que as entradas e saídas
tenham unidades diferentes dentro da mesma classe de UDM, o sistema fará um esforço
razoável para converter as unidades de entrada em unidades de saída para o cálculo.
• É possível adicionar ou excluir elementos ou atributos em sua hierarquia, sem a necessidade
de atualizar as análises de somatório. Porque um somatório identifica os atributos de
entrada sempre que é executado, ele automaticamente inclui todos os novos atributos que
atendam a esses critérios de seleção.
• Alguns atributos selecionados (como aqueles com valores de string) não participarão dos
cálculos de sintetização, que operam apenas em valores numéricos ou DateTime.

Nesta seção
• Funções de análise de somatório
• Criar um template de análise de somatório
• Criar uma análise de somatório

270 Guia do Usuário do PI System Explorer

 Análises de ativo

Funções de análise de somatório

É possível especificar uma ou mais das funções listadas abaixo para calcular estatísticas sobre
os atributos de entrada em uma análise de somatório.
Nota:
Os valores de entrada devem ser todos numéricos ou do tipo de valor DateTime para
produzir resultados para Média, Minimum, Máximoe Contagem. Os valores de entrada
para todas as outras funções devem ser do tipo de valor numérico.

Função Descrição Tipos de dados

suportados
Soma A soma dos valores dos atributos selecionados. Numérico
Média A média dos valores de dois ou mais atributos selecionados. Numérico, DateTime
Minimum O valor mínimo dos atributos selecionados. Numérico, DateTime
Máximo O valor máximo dos atributos selecionados. Numérico, DateTime
Contagem O número de atributos realmente utilizados em cálculos de somatório, que Numérico, DateTime
pode ser diferente do número total de atributos selecionados. Por
exemplo, um atributo que contém um valor de string (como um nome de
peça) pode atender aos critérios de seleção, mas não participaria dos
cálculos de somatório e seria excluído para a Contagem.
Médio O valor médio de três ou mais valores de atributos selecionados; para um Numérico
grupo de valores com número par, a média dos dois valores médios. Um
número igual de valores situados acima e abaixo da mediana.
Desvio O desvio padrão da população, que é calculado utilizando a população Numérico
padrão inteira. Útil quando todos os valores em uma população estiverem
populaciona disponíveis para incluir como entradas para o cálculo.
l
Desvio O desvio padrão da amostra, que é calculado usando valores de uma Numérico
padrão amostra de uma população. Útil para fornecer uma estimativa do desvio
amostral padrão da população quando for impraticável ou impossível incluir todos
os valores da população no cálculo.

Criar um template de análise de somatório

No PI System Explorer, você pode criar um template de análise de somatório para um template
de elemento selecionado. Selecione os valores de entrada de somatório nos atributos do
template de elemento ou nos atributos de um template de elemento filho (cujo elemento pai é
originado no template de elemento). É possível escolher um elemento filho e usar seus
atributos para ajudar no desenvolvimento de um template de análise de somatório.

Antes de Iniciar
Identifique as funções estáticas que deseja que o somatório calcule e onde deseja salvar os
resultados. É possível mapear os resultados de uma função para um atributo existente do
template de elemento ou criar um novo atributo de saída ao configurar um template de análise.

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, selecione o template de elemento em que deseja criar o
template de análise.
3. No visualizador, clique na guia Templates de análise.
A guia lista todos os templates de análise já definidos para o template de elemento.

Guia do Usuário do PI System Explorer 271

Análises de ativo

4. Crie um template de análise para o template de elemento:

◦ Se nenhum template de análise existir, clique em Criar um template de análise para criar
o primeiro.
◦ Caso contrário, clique em Novo template de análise para criar um.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Sintetizar.
6. Opcional. Desmarque a caixa de seleção Enable analyses when created from template
(Ativar análises quando criadas do template) para que a análise seja criada no status
Disabled.
Por padrão, uma nova análise será criada com o status Enabled. Desmarque a opção se não
deseja iniciar a análise quando ela for criada.
7. Em Sintetizar atributos de, indique a fonte dos valores de entrada:
◦ Clique em Elementos filhos de Element Template Name para sintetizar os atributos dos
elementos filho de um elemento baseado no template do elemento atual.
◦ Clique em Este elemento - Element Template Name para sintetizar os atributos de um
elemento baseado no template do elemento atual.
8. Selecione um elemento de exemplo para fornecer atributos candidatos:
a. Clique no link Selecionar um elemento de exemplo para abrir uma janela que mostra os
elementos derivadas do template do elemento selecionado.
b. Selecione um elemento e clique em OK.
9. Selecione os atributos a serem incluídos no somatório:

272 Guia do Usuário do PI System Explorer

 Análises de ativo

Se os atributos para sintetizar vierem de: Então:

Elementos filho a. Na lista Elemento filho da amostra, selecione
o elemento cujos atributos você deseja exibir.
A tabela mostra os atributos do elemento
selecionado. Para melhorar o desempenho, a
tabela mostra apenas um número limitado de
atributos. É possível clicar no link Mostrar
mais atributos abaixo da tabela para mostrar
os atributos adicionais do elemento
selecionado.
b. À esquerda da tabela, especifique os critérios
que selecionam os atributos para sintetizar:
▪ Nome do atributo
Digite um nome de atributo inteiro ou
parte de um nome com caracteres
coringa. Por exemplo, digite temp* para
selecionar todos os atributos que
começam com "temp", como
Temperature e Temp1.
Nota:
A seleção de atributos depende de se
Attribute Level está configurado para
"Nível-raiz" ou "Nível filho".

▪ Nível de atributo
Selecione Nível raiz para escolher entre
atributos de nível superior ou Nível filho
para atributos filhos. Não é possível
selecionar atributos filho e atributos de
nível superior em uma única análise de
somatório.

▪ Categoria de atributo
Selecione uma categoria para limitar os
atributos selecionados aos que estão
nessa categoria.

▪ Categoria de elemento
Selecione uma categoria de elemento para
limitar os atributos selecionados aos que
têm elementos pais nessa categoria.

▪ Template de elemento
Selecione um template de elemento para
limitar os atributos selecionados aos que
têm elementos pais baseados nesse
template.
Nota:
Os critérios se aplicam a todos os atributos
de qualquer elemento filho, não apenas dos
mostrados na tabela.
É possível especificar os critérios que
selecionam atributos não mostrados na
tabela. Por exemplo, se você configurar o
Elemento filho da amostra como um
elemento da categoria CatX, mas configurar a
Categoria de elemento como CatY, não deve
selecionar nenhum dos atributos na tabela,
mas a análise ainda incluirá os atributos no
somatório.
Guia do Usuário do PI System Explorer 273
Análises de ativo

Este elemento À esquerda da tabela, especifique os critérios que

selecionam os atributos para sintetizar:
◦ Nome do atributo
Digite um nome de atributo inteiro ou parte
de um nome com caracteres coringa. Por
exemplo, digite temp* para selecionar todos
os atributos que começam com "temp", como
Temperature e Temp1.
Nota:
A seleção de atributos depende de se
Attribute Level está configurado para
"Nível-raiz" ou "Nível filho".

◦ Nível de atributo
Selecione Nível raiz para escolher entre
atributos de nível superior ou Nível filho para
atributos filhos. Não é possível selecionar
atributos filho e atributos de nível superior
em uma única análise de somatório.

◦ Categoria de atributo
Selecione uma categoria para limitar os
atributos selecionados a essa categoria.

A tabela mostra uma marca de seleção ao lado de qualquer atributo exibido incluído no
somatório.
10. Na tabela de funções, especifique os cálculos de somatório e saída:
a. Marque as caixas de seleção ao lado de qualquer função estatística que deseja que o
somatório calcule.
b. Clique em Mapear para armazenar os resultados de um cálculo para um atributo de
saída.
É possível mapear a saída para um atributo existente ou para um novo atributo de saída.
c. Opcional. Na parte superior da tabela, clique em Avaliar para verificar os valores das
funções selecionadas de saída.
11. Especifique o agendamento da análise. Consulte Agendamento de análise.
12. Opcional. Para verificar a análise, examinar os resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
13. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas.
14. Clique em Check-in na barra de ferramentas para salvar o template de análise para o PI AF
Server e criar a análise para qualquer elemento com base no template de elemento.

Criar uma análise de somatório

No PI System Explorer, crie uma análise de somatório para um elemento selecionado. Selecione
atributos de entrada para o somatório dos atributos do elemento selecionado ou dos atributos
dos elementos filho.

274 Guia do Usuário do PI System Explorer

 Análises de ativo

Antes de Iniciar
Identifique as funções estáticas que deseja que o somatório calcule e onde deseja salvar os
resultados. É possível mapear os resultados de uma função para um atributo existente do
elemento ou criar um novo atributo de saída ao configurar a análise.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, selecione o elemento em que deseja criar a análise.
3. No visualizador, clique na guia Análises.
A guia lista todas as análises já definidas para o elemento.
4. Crie uma análise para o elemento:
◦ Se não houver nenhuma análise, clique em Criar análise para criar a primeira.
◦ Caso contrário, clique em Nova análise para criar uma.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Somatórios
6. Em Sintetizar atributos de, indique a fonte dos valores de entrada:
◦ Clique em Elementos filho de Element Name para sintetizar os atributos de um elemento
filho.
◦ Clique em Este elemento - Element Name para sintetizar os atributos do elemento atual.
7. Selecione os atributos a serem incluídos no somatório:

Guia do Usuário do PI System Explorer 275

Análises de ativo

Se os atributos para somatório vierem de... Faça o seguinte...

Elementos filho a. Na lista Elemento filho da amostra, selecione
o elemento cujos atributos você deseja exibir.
A tabela mostra os atributos do elemento
selecionado. Para melhorar o desempenho, a
tabela mostra apenas um número limitado de
atributos. É possível clicar no link Mostrar
mais atributos abaixo da tabela para mostrar
os atributos adicionais do elemento
selecionado.
b. À esquerda da tabela, especifique os critérios
que selecionam os atributos para sintetizar:
▪ Nome do atributo
Digite um nome de atributo inteiro ou
parte de um nome com caracteres
coringa. Por exemplo, digite temp* para
selecionar todos os atributos que
começam com "temp", como
Temperature e Temp1.
Nota:
A seleção de atributos depende de se
Attribute Level está configurado para
"Nível-raiz" ou "Nível filho".

▪ Nível de atributo
Selecione Nível raiz para escolher entre
atributos de nível superior ou Nível filho
para atributos filhos. Não é possível
selecionar atributos filho e atributos de
nível superior em uma única análise de
somatório.

▪ Categoria de atributo
Selecione uma categoria para limitar os
atributos selecionados aos que estão
nessa categoria.

▪ Categoria de elemento
Selecione uma categoria de elemento para
limitar os atributos selecionados aos que
têm elementos pais nessa categoria.

▪ Template de elemento
Selecione um template de elemento para
limitar os atributos selecionados aos que
têm elementos pais baseados nesse
template.
Nota:
Os critérios se aplicam a todos os atributos
do elemento filho selecionado, não apenas
dos mostrados na tabela.
É possível especificar os critérios que
selecionam atributos não mostrados na
tabela. Por exemplo, se você configurar o
Elemento filho da amostra como um
elemento da categoria CatX, mas configurar a
Categoria de elemento como CatY, não deve
selecionar nenhum dos atributos na tabela,
mas a análise ainda incluirá os atributos no
276 Guia do Usuário do PI System Explorer somatório.
 Análises de ativo

Este elemento À esquerda da tabela, especifique os critérios que

selecionam os atributos para sintetizar:
◦ Nome do atributo
Digite um nome de atributo inteiro ou parte
de um nome com caracteres coringa. Por
exemplo, digite temp* para selecionar todos
os atributos que começam com "temp", como
Temperature e Temp1.
Nota:
A seleção de atributos depende de se
Attribute Level está configurado para
"Nível-raiz" ou "Nível filho".

◦ Nível de atributo
Selecione Nível raiz para escolher entre
atributos de nível superior ou Nível filho para
atributos filhos. Não é possível selecionar
atributos filho e atributos de nível superior
em uma única análise de somatório.

◦ Categoria de atributo
Selecione uma categoria para limitar os
atributos selecionados a essa categoria.

A tabela mostra uma marca de seleção ao lado de qualquer atributo exibido incluído no
somatório.
8. Na tabela de funções, especifique os cálculos de somatório e saída:
a. Marque as caixas de seleção ao lado de qualquer função estatística que deseja que o
somatório calcule.
b. Clique em Mapear para armazenar os resultados de um cálculo para um atributo de
saída.
É possível mapear a saída para um atributo existente ou para um novo atributo de saída.
c. Opcional. Na parte superior da tabela, clique em Avaliar para verificar os valores das
funções selecionadas de saída.
9. Especifique o agendamento da análise. Consulte Agendamento de análise.
10. Opcional. Para verificar a análise, revise os resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
11. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas. Isso não executa a análise.
12. Clique em Fazer check-in na barra de ferramentas.
O PI System Explorer salva e faz o check-in da sua análise e começa a executá-la.

Análises de geração da estrutura de eventos

Uma análise de geração de event frames especifica as condições de início e término de event
frames automaticamente.

Guia do Usuário do PI System Explorer 277

Análises de ativo

Este tipo de análise inclui uma ou duas expressões. Quando uma única condição dispara o
início e o término de uma estrutura de evento, apenas uma expressão start trigger é necessária,
representada pelo campo StartTrigger1. Por exemplo, um valor de temperatura que é elevado
até ficar acima do limite pode iniciar uma estrutura de evento e terminá-la quando o valor
volta a ficar abaixo do limite. Quando as condições de início e término forem 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.
É possível criar vários start triggers para análise e especificar diferentes condições booleanas
para disparar cada estrutura de evento. Para obter mais informações sobre vários start triggers
e a geração de estrutura de evento filho, consulte Geração de estrutura de evento filho com
start triggers múltiplos.
Nota:
Se alterar o nome de um start trigger a partir do nome padrão, você deverá alterar todos
os start triggers e usar nomes exclusivos para cada gatilho.
Um pico nos dados de entrada podem disparar o início de uma estrutura de evento indesejada.
Para reagir aos efeitos dos picos de dados, é possível exigir que o start trigger permaneça
verdadeiro em um intervalo de tempo da configuração antes de criar uma estrutura de evento.
Insira um valor no campo True para para especificar o intervalo de tempo.
É possível também especificar um nível de severidade para o gatilho. As opções para
severidade são: Nenhum, Informações, Aviso, Menor, Maior e Crítico.
Uma análise de geração de event frames é baseada em um template de event frame, que
especifica os atributos dos event frames gerados. Antes de criar uma análise de geração de
event frames, certifique-se de que há um template de event frame apropriado disponível.
Os event frames normalmente incluem uma coleção de elementos referenciados. O elemento
associado a uma análise de geração de event frames se torna o elemento de referência primário
para seus event frames gerados. Para obter mais informações, consulte Elemento referenciado
primário. Outros elementos podem ser referenciados usando caminhos relativos baseados no
elemento referenciado primário, conforme descrito em Referências de dados a atributos em
outros elementos.
Em alguns eventos, como um desligamento forçado, talvez queira-se avaliar as condições
gerando o evento. Para fazer isso, é possível configurar o PI Analysis Service para gerar event
frames de causa raiz. Quando configurado, cada event frame gerado inclui uma causa raiz de
um event frame secundário que captura atributos para um intervalo de tempo especificado um
pouco antes do início do event frame gerado. Para obter mais informações sobre como gerar
um event frame de causa raiz, consulte a etapa 11 em Criar um template de análise de geração
da estrutura de eventos.

Vídeo
Para obter informações sobre como configurar Analyses do Gerador de Event Frames, assista a
este vídeo:
https://www.youtube.com/watch?v=iNYe_YZzj58

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
• Condição de gatilho inicial
• Geração de estrutura de evento filho com start triggers múltiplos

278 Guia do Usuário do PI System Explorer

 Análises de ativo

Criar um template de análise de geração da estrutura de eventos

No PI System Explorer, você pode criar um template de análise de geração da estrutura de
evento para um template de elemento.

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, selecione o template de elemento em que deseja criar o
template de análise.
3. No visualizador, clique na guia Templates de análise.
A guia lista todos os templates de análise já definidos para o template de elemento.
4. Crie um template de análise para o template de elemento:
◦ Se nenhum template de análise existir, clique em Criar um template de análise para criar
o primeiro.
◦ Caso contrário, clique em Novo template de análise para criar um.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Geração da estrutura de evento.
6. Opcional. Desmarque a caixa de seleção Enable analyses when created from template
(Ativar análises quando criadas do template) para que a análise seja criada no status
Disabled.
Por padrão, uma nova análise será criada com o status Enabled. Desmarque a opção se não
deseja iniciar a análise quando ela for criada.
7. Opcional. Para avaliar expressões temporariamente no template de análise com base nos
valores de um elemento específico, clique no link Selecionar um elemento de exemplo e
selecione um elemento com base no template de elemento atual. Se nenhum elemento tiver
sido criado do template de elemento atual, você deverá criar um elemento primeiro.
Os templates não têm dados concretos associados aos atributos deles. Não é possível avaliar
uma expressão em um template de análise, exceto quando você obtém valores de atributo
de um elemento específico.
O PI System Explorer define Elemento de exemplo para o elemento selecionado.
8. Na lista Template da estrutura de evento, selecione o template para a estrutura de evento
que gera essa análise.
9. Especifique as expressões necessárias para a análise:

Guia do Usuário do PI System Explorer 279

Análises de ativo

a. Na linha StartTrigger1, insira a expressão booleana que especifica a condição que inicia
uma estrutura de evento.
b. Opcional. Altere o nome padrão do start trigger.
Nota:
Se alterar o nome de um start trigger a partir do nome padrão, você deverá alterar
os nomes de todos os start triggers e usar nomes exclusivos para cada gatilho.
c. Opcional. No campo True para, insira o período de tempo que a condição start-trigger
deve ser true antes de a análise iniciar uma estrutura de evento.
Nota:
Especifique um valor no campo True para com o fim de reduzir estruturas de
evento indesejadas causadas por flutuações momentâneas nos dados de entrada.
d. Opcional. No campo Severidade, insira a severidade do gatilho. As opções para
severidade são: Nenhum, Informações, Aviso, Menor, Maior e Crítico. Se você tiver
definido vários start triggers, aquele com a severidade mais alta será o start trigger
efetivo; se todos os start triggers tiverem a mesma severidade, o primeiro na lista será o
start trigger efetivo.
e. Adicione vários start triggers clicando em Adicionar um novo start trigger. Para cada
start trigger, insira uma expressão booleana, especifique um valor para True para e
selecione um valor para Severidade.
Nota:
Se você tiver alterado o nome padrão de um start trigger, certifique-se de atribuir
nomes exclusivos a todos os start triggers.
f. Se uma condição diferente finalizar a estrutura de evento, insira a expressão booleana
correspondente na linha EndTrigger.
10. Opcional. Se você especificar um elemento de exemplo, clique em Avaliar para verificar os
valores de saída das expressões individuais.
11. Opcional. Gere um event frame de causa raiz para cada event frame que a análise gerar. Um
event frame de causa raiz captura os dados do ativo, o que pode ajudá-lo a analisar as
condições imediatamente antes do início do event frame.
a. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Generate child root cause event frame before parent event frame starts (Gerar
event frame de causa raiz filho antes do início do event frame pai).
b. No campo Duração, insira o comprimento do event frame de causa raiz.
O event frame de causa raiz começa muito antes do evento pai gerado.
12. Opcional. Mapeie o nome e a expressão de um start trigger para um atributo da estrutura de
evento.
a. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Save start trigger name to event frame attribute (Salvar nome do gatilho
inicial em atributo de event frame) e, em seguida, selecione um atributo (template) ou
crie um novo template de atributo no template de event frame no qual o nome do gatilho
inicial deve ser salvo.
b. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Save start trigger expression to event frame attribute (Salvar expressão do
gatilho inicial em atributo de event frame) e, em seguida, selecione um atributo
(template) ou crie um novo template de atributo no template de event frame no qual a
expressão do gatilho inicial deve ser salva.

280 Guia do Usuário do PI System Explorer

 Análises de ativo

O nome e a expressão do start trigger podem, agora, ser vistos nas estruturas de evento
geradas, nos atributos selecionados.
13. Especifique o agendamento da análise. Consulte Agendamento de análise.
14. Opcional. Se você especificar um elemento de exemplo, verifique a análise revisando os
resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
15. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas.
16. Clique em Check-in na barra de ferramentas para salvar o template de análise para o PI AF
Server e criar a análise para qualquer elemento com base no template de elemento.

Crie uma análise de geração da estrutura de eventos

No PI System Explorer, é possível criar uma Analyses do Gerador de Event Frames para um
elemento individual.

Antes de Iniciar
Verifique se um template de estrutura de evento está disponível para a análise.

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, selecione o elemento em que deseja criar a análise.
3. No visualizador, clique na guia Análises.
A guia lista todas as análises já definidas para o elemento.
4. Crie uma análise para o elemento:
◦ Se não houver nenhuma análise, clique em Criar análise para criar a primeira.
◦ Caso contrário, clique em Nova análise para criar uma.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em Geração da estrutura de evento.
6. Na lista Template da estrutura de evento, selecione o template para a estrutura de evento
que gera essa análise.

Guia do Usuário do PI System Explorer 281

Análises de ativo

7. Especifique as expressões necessárias para a análise:

a. Na linha StartTrigger1, insira a expressão booleana que especifica a condição que inicia
uma estrutura de evento.
b. Opcional. Altere o nome padrão do start trigger.
Nota:
Se alterar o nome de um start trigger a partir do nome padrão, você deverá alterar
todos os start triggers e usar nomes exclusivos para cada gatilho.
c. Opcional. No campo True para, insira o período de tempo que a condição start-trigger
deve ser true antes de a análise iniciar uma estrutura de evento.
Nota:
Especifique um valor no campo True para com o fim de reduzir estruturas de
evento indesejadas causadas por flutuações momentâneas nos dados de entrada.
d. Opcional. No campo Severidade, insira a severidade do gatilho. As opções para
severidade são: Nenhum, Informações, Aviso, Menor, Maior e Crítico. Se você tiver
definido vários start triggers, aquele com a severidade mais alta será o start trigger
efetivo; se todos os start triggers tiverem a mesma severidade, o primeiro na lista será o
start trigger efetivo.
e. Adicione vários start triggers clicando em Adicionar um novo start trigger. Para cada
start trigger, insira uma expressão booleana, especifique um valor para True para e
selecione um valor para Severidade.
Nota:
Se você tiver alterado o nome padrão de um start trigger, certifique-se de atribuir
nomes exclusivos a todos os start triggers.
f. Se uma condição diferente finalizar a estrutura de evento, insira a expressão booleana
correspondente na linha EndTrigger.
g. Clique em Adicionar uma nova expressão para inserir uma nova linha de expressão, em
que é possível especificar uma variável e uma expressão para usar em uma das
expressões de gatilho.
Consulte Expressões para análises.
8. Opcional. Clique em Avaliar para verificar os valores de saída nas horas do Valor no gatilho
final e do Valor na avaliação.
9. Opcional. Gere um event frame de causa raiz para cada event frame que a análise gerar. Um
event frame de causa raiz captura os dados do ativo, o que pode ajudá-lo a analisar as
condições imediatamente antes do início do event frame.
a. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Generate child root cause event frame before parent event frame starts (Gerar
event frame de causa raiz filho antes do início do event frame pai).
b. No campo Duração, insira o comprimento do event frame de causa raiz.
O event frame de causa raiz começa muito antes do evento pai gerado.
Nota:
O event frame de causa raiz é criado apenas para a primeira instância, não para
cada vez que o gatilho for True.
10. Opcional. Mapeie o nome e a expressão de um start trigger para um atributo da estrutura de
evento.

282 Guia do Usuário do PI System Explorer

 Análises de ativo

Nota:
Nós recomendamos que você forneça nomes significativos aos seus start triggers de
análise ao salvá-los para um atributo da estrutura de evento.

a. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),

selecione Save start trigger name to event frame attribute (Salvar nome do gatilho
inicial em atributo de event frame) e, em seguida, selecione um atributo (template) ou
crie um novo template de atributo no template de event frame no qual o nome do gatilho
inicial deve ser salvo.
b. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Save start trigger expression to event frame attribute (Salvar expressão do
gatilho inicial em atributo de event frame) e, em seguida, selecione um atributo
(template) ou crie um novo template de atributo no template de event frame no qual a
expressão do gatilho inicial deve ser salva.

O nome e a expressão do start trigger podem, agora, ser vistos nas estruturas de evento
geradas, nos atributos selecionados.
11. Especifique o agendamento da análise. Consulte Agendamento de análise.
12. Opcional. Para verificar a análise, revise os resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
13. Para aplicar as alterações e salvar seu trabalho localmente, clique em na barra de
ferramentas. Isso não executa a análise.
14. Clique em Fazer check-in na barra de ferramentas.
O PI System Explorer salva e faz o check-in da sua análise e começa a executá-la.

Condição de gatilho inicial

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 deter os efeitos dos picos de dados, você pode configurar a condição de gatilho inicial para
que permaneça verdadeira por um intervalo de tempo especificado, antes de iniciar um event
frame. Insira um valor no campo True para para especificar o intervalo de tempo.
As Analyses do Gerador de Event Frames não criam um novo event frame até que a expressão
no gatilho inicial tenha sido verdadeira pela duração especificada no campo Verdadeiro por A
hora de início para o event frame é a hora em que a condição do gatilho inicial foi avaliada pela
primeira vez como verdadeira.
Se a condição do gatilho inicial for avaliada como falsa antes de atingir o intervalo de tempo
especificado no campo Verdadeiro por, nenhum event frame será criado.
O valor True para não tem efeito na hora de término da estrutura de evento.

Guia do Usuário do PI System Explorer 283

Análises de ativo

Geração de estrutura de evento filho com start triggers múltiplos

Start trigger efetivo em uma configuração de start trigger múltiplo
A análise de estrutura de evento oferece suporte para start triggers múltiplos. Quando start
triggers múltiplos são especificados, apenas um deles é efetivo durante a avaliação única,
mesmo se todos os start triggers forem avaliados como true. O start trigger efetivo é
determinado por:
• Severidade. Se start triggers múltiplos tiverem níveis de severidade diferentes, o que tiver
nível mais alto é o start trigger efetivo. Por exemplo, se houver dois start triggers
StartTrigger1 com severidade "Significativa" e StartTrigger2 com severidade
"Crítica", bem como ambos forem avaliados como verdadeiro no mesmo ponto de tempo,
então StartTrigger2 é considerado o trigger efetivo, uma vez que tem a maior severidade.
Nota:
Os níveis de severidade, em ordem crescente de magnitude, são: Nenhum (padrão),
Informação, Aviso, Irrelevante, Significativo, e Crítico.
• Ordem. Se todos os start triggers tiverem a mesma severidade, o start trigger definido
primeiro é o start trigger efetivo.

Geração de estrutura de evento filho devido à mudança no trigger efetivo

Uma configuração com start triggers múltiplos pode levar à criação de estruturas de evento
filho. Quando um start trigger é avaliado como true e não há nenhuma estrutura de evento
aberto, a análise cria uma estrutura de evento. Em uma avaliação subsequente, enquanto a
estrutura de evento estiver aberta, se o start trigger efetivo não mudar e ainda for avaliado
como true, então aquela estrutura de evento individual permanecerá aberta; esse
comportamento é o mesmo com um start trigger individual. Entretanto, se o start trigger
efetivo mudar durante a avaliação subsequente e enquanto a estrutura de evento estiver
aberta, então:
• Da primeira vez que a análise detectar um start trigger efetivo, ela inicia uma estrutura de
evento.
• Quando o start trigger efetivo muda pela primeira vez em uma avaliação subsequente, a
análise cria uma nova estrutura de evento pai para a estrutura de evento que já está aberta,
com a mesma hora de início da estrutura de evento original. A estrutura de evento original
aberta é fechada e uma nova estrutura de evento filho é iniciada.
• Se o start trigger efetivo mudar novamente em uma avaliação subsequente, a estrutura de
evento filho aberta é fechada, uma nova estrutura de evento filho é iniciada.
Quando não há nenhum start trigger efetivo, ou seja, nenhum start trigger é verdadeiro ou se o
end trigger configurado for avaliado como verdadeiro, a estrutura de evento filho e a estrutura
de evento pai são fechadas.

Análises SQC
Usando o PI System Explorer, é possível criar análises SQC que usam testes padrão de controle
de qualidade estatística (SQC) para determinar se o valor de um atributo do PI AF está dentro
das margens de erro especificadas pelo usuário. Além disso, é possível especificar atributos ou
estruturas de evento como saídas da análise SQC.
Os seguintes testes de padrão SQC podem ser selecionados:

• Controle externo:
Conta o número de amostras fora do limite de controle em um lado da linha central.

284 Guia do Usuário do PI System Explorer

 Análises de ativo

• Dois sigma externo:

Avalia a amostra em relação a um limite de 2/3 do caminho entre a linha central e o limite
de controle.

• Um sigma externo:
Avalia a amostra em relação a um limite de 1/3 do caminho entre a linha central e o limite
de controle.

• Um lado da linha central:

Conta o número de amostras em um lado da linha central.

• Estratificação:
Conta o número de amostras que falham nos limites um sigma superior e inferior em ambos
os lados da linha central.

• Mistura:
Conta o número de amostras que ultrapassam os limites um sigma superior e inferior em
ambos os lados da linha central.

• Tendência:
Conta o número de amostras que estão aumentando ou diminuindo em uma sequência
monotônica.

Criar um template de análise SQC

No PI System Explorer, você pode criar um template de análise SQC para um template de
elemento.

Procedimento
1. No navegador, clique em Biblioteca.
2. No navegador de Biblioteca, selecione o template de elemento em que deseja criar o
template de análise.
3. No visualizador, clique na guia Templates de análise.
A guia lista todos os templates de análise já definidos para o template de elemento.
4. Crie um template de análise para o template de elemento:
◦ Se nenhum template de análise existir, clique em Criar um template de análise para criar
o primeiro.
◦ Caso contrário, clique em Novo template de análise para criar um.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

Guia do Usuário do PI System Explorer 285

Análises de ativo
◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em SQC.
6. Opcional. Desmarque a caixa de seleção Enable analyses when created from template
(Ativar análises quando criadas do template) para que a análise seja criada no status
Disabled.
Por padrão, uma nova análise será criada com o status Enabled. Desmarque a opção se não
deseja iniciar a análise quando ela for criada.
7. Opcional. Selecione um elemento de exemplo.
8. Forneça as entradas para o teste de padrão SQC. Todas essas entradas devem ser templates
de atributo anteriormente definidos no PI System.
a. No campo Fonte, selecione o template de atributo do PI AF que fornece os dados para o
teste de padrão.
b. Nos campos Upper Control Limit (Limite superior de controle) e Lower Control Limit
(Limite inferior de controle), selecione o template de atributo do PI AF que fornece os
dados para os limites mais alto e mais baixo na dimensão dos dados que estão sendo
testados.
c. No campo Center Line (Linha central), selecione o template de atributo do PI AF que
fornece o valor normal ou ideal dos dados.
9. Escolha a saída de sua análise como Estrutura de evento ou Atributo do AF. Se você escolher
Event Frame, selecione um template de event frame. Se escolher Atributo do AF, você
poderá escolher em uma lista ou criar um novo template de atributo. A regra de análise SQC
cria automaticamente um enumeration set chamado SQC Enumeration. Esse enumeration
set tem os mesmos valores usados no PI Data Archive SQC DigitalState configurado, para
que a continuidade com o PI Data Archive existente seja preservada. O SQC Enumeration é
criado quando: 1) você mapeia a saída para um novo atributo do AF, 2) este ou outro
enumeration set com o nome e os valores exigidos ainda não existe e 3) você tem o direito
de criar enumeration sets. A saída do atributo do AF usará como padrão um atributo de
string se as condições acima mencionadas não forem cumpridas.
10. Opcional. Gere uma estrutura de evento de causa raiz para cada estrutura de evento que
gerar a análise. Uma estrutura de evento de causa raiz captura os dados do ativo, o que pode
ajudar na análise das condições um pouco antes de iniciar a estrutura de evento.
a. No menu Configurações avançadas da estrutura de evento, selecione Gerar estrutura de
evento de causa raiz filho antes da estrutura de evento pai ser iniciada.
b. No campo Duração, insira o comprimento da estrutura de evento de causa raiz.
A estrutura de evento de causa raiz começa muito antes do evento pai gerado.
Nota:
A estrutura de evento de causa raiz é criada apenas para a primeira instância, não
para cada vez que o gatilho for True.
11. Opcional. Mapeie o nome e a expressão de um start trigger para um atributo da estrutura de
evento.
a. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Save start trigger name to event frame attribute (Salvar nome do gatilho

286 Guia do Usuário do PI System Explorer

 Análises de ativo

inicial em atributo do event frame) e selecione um template de atributo no template do

event frame no qual o nome do gatilho inicial deve ser salvo.
b. Na janela Advanced Event Frame Settings (Configurações avançadas de event frame),
selecione Save start trigger expression to event frame attribute (Salvar expressão do
gatilho inicial em atributo do event frame) e selecione um template de atributo no event
frame no qual a expressão do gatilho inicial deve ser salva.

O nome e a expressão do start trigger podem, agora, ser vistos nas estruturas de evento
geradas, nos atributos selecionados.
12. Insira informações do teste de padrão SQC.
a. Marque a caixa de seleção para cada teste de padrão SQC que você deseja aplicar aos seus
dados.
b. Na coluna X de Y, selecione valores numéricos apropriados para X e Y para cada teste de
padrão selecionado que exija esta entrada. Especifique o número de valores X menos um
número de valores de Y de amostra que podem estar acima ou abaixo dos limites do teste
de padrão correspondentes.
Os padrões (valores X e Y) sugeridos pela Western Electric são mostrados por padrão.
Nota:
X não pode ser maior que Y.
c. Selecione o Limite como Acima, Abaixo ou Ambos para cada teste de padrão selecionado.
Por padrão, os testes são aplicados em ambos os lados da linha central.
13. Opcional. Marque a caixa de seleção Limpar alteração de limite de controle.
Com Clear on Control Limit Change (Limpar quando o limite de controle for alterado)
selecionado, se algum dos limites de controle for alterado, o Asset Analytics redefinirá o
estado de um cálculo SQC que está rodando, e o cálculo SQC será reiniciado com os valores
alterados. Além disso, as estruturas de evento abertas associadas serão fechadas antes de o
cálculo ser retomado.
Com Limpar alteração de limite de controle não selecionado, o cálculo simplesmente
continua usando os valores alterados para os limites de controle.
14. Opcional. Clique em Avaliar para verificar os valores de saída nas horas do Valor no gatilho
final e do Valor na avaliação. Se todos os testes SQC selecionados forem aprovados, o campo
Valor de saída exibirá "Normal". Se alguns testes falharem, o campo Valor de saída mostrará
o teste de prioridade mais alta que falhou. Alterar qualquer uma das entradas SQC limpará o
campo Valor de saída.
15. Especifique o agendamento da análise. Consulte Agendamento de análise.
16. Clique em Check-in na barra de ferramentas para salvar o template de análise para o PI AF
Server e criar a análise para qualquer elemento com base no template de elemento.

Criar uma análise SQC

Antes de Iniciar
Identifique os testes de padrão SQC (Statistical Quality Control) que você deseja usar. Para
obter mais detalhes sobre os testes, consulte Análises SQC

Procedimento
1. No navegador, clique em Elementos.
2. No navegador de Elementos, selecione o elemento em que deseja criar a análise.
3. No visualizador, clique na guia Análises.

Guia do Usuário do PI System Explorer 287

Análises de ativo

A guia lista todas as análises já definidas para o elemento.

4. Crie uma análise para o elemento:
◦ Se não houver nenhuma análise, clique em Criar análise para criar a primeira.
◦ Caso contrário, clique em Nova análise para criar uma.
5. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise.

◦ Descrição
Texto opcional que descreve a análise.

◦ Categorias
Categoria opcional que você pode atribuir à análise. Clique na lista, marque a caixa de
seleção ao lado das categorias que você deseja atribuir e clique em Novo para criar uma
categoria.

◦ Tipo de análise
Clique em SQC.
6. Forneça as entradas para o teste de padrão SQC. Todas essas entradas devem ser atributos
ou templates de atributos anteriormente definidos no PI System.
a. No campo Origem, selecione o atributo PI AF ou o template de atributo que fornece os
dados para o teste de padrão.
b. Nos campos Upper Control Limit (Limite superior de controle) e Lower Control Limit
(Limite inferior de controle), selecione o atributo ou template de atributo do PI AF que
fornece os limites mais alto e mais baixo na dimensão dos dados que estão sendo
testados.
c. No campo Center Line (Linha central), selecione o atributo ou template de atributo do PI
AF que fornece o valor normal ou ideal dos dados.
7. Escolha a saída de sua análise como Estrutura de evento ou Atributo do AF. Se você escolher
Event Frame, selecione um template de event frame. Se escolher Atributo do AF, você
poderá escolher em uma lista ou criar um novo atributo. A regra de análise SQC cria
automaticamente um enumeration set chamado SQC Enumeration. Esse enumeration set
tem os mesmos valores usados no PI Data Archive SQC DigitalState configurado, para que a
continuidade com o PI Data Archive existente seja preservada. O SQC Enumeration é criado
quando: 1) você mapeia a saída para um novo atributo do AF, 2) este ou outro enumeration
set com o nome e os valores exigidos ainda não existe e 3) você tem o direito de criar
enumeration sets. A saída do atributo do AF usará como padrão um atributo de string se as
condições acima mencionadas não forem cumpridas.
8. Opcional. Gere uma estrutura de evento de causa raiz para cada estrutura de evento que
gerar a análise. Uma estrutura de evento de causa raiz captura os dados do ativo, o que pode
ajudar na análise das condições um pouco antes de iniciar a estrutura de evento.
a. No menu Configurações avançadas da estrutura de evento, selecione Gerar estrutura de
evento de causa raiz filho antes da estrutura de evento pai ser iniciada.
b. No campo Duração, insira o comprimento da estrutura de evento de causa raiz.
A estrutura de evento de causa raiz começa muito antes do evento pai gerado.
Nota:
A estrutura de evento de causa raiz é criada apenas para a primeira instância, não
para cada vez que o gatilho for True.

288 Guia do Usuário do PI System Explorer

 Análises de ativo

9. Opcional. Mapeie o nome e a expressão de um start trigger para um atributo da estrutura de

evento.
a. Na janela Configurações avançadas da estrutura de evento, selecione Salvar nome de start
trigger para o atributo da estrutura de evento e selecione um atributo ou template de
atributo no template da estrutura de evento para o qual o nome do start trigger é salvo.
b. Na janela Configurações avançadas da estrutura de evento, selecione Salvar expressão de
start trigger para o atributo da estrutura de evento e selecione um atributo ou template
de atributo no template da estrutura de evento para o qual a expressão do start trigger é
salva.

O nome e a expressão do start trigger podem, agora, ser vistos nas estruturas de evento
geradas, nos atributos selecionados.
10. Insira informações do teste de padrão SQC.
a. Marque a caixa de seleção para cada teste de padrão SQC que você deseja aplicar aos seus
dados.
b. Na coluna X de Y, selecione valores numéricos apropriados para X e Y para cada teste de
padrão selecionado que exija esta entrada. Especifique o número de valores X menos um
número de valores de Y de amostra que podem estar acima ou abaixo dos limites do teste
de padrão correspondentes.
Os padrões (valores X e Y) sugeridos pela Western Electric são mostrados por padrão.
Nota:
X não pode ser maior que Y
c. Selecione o Limite como Acima, Abaixo ou Ambos para cada teste de padrão selecionado.
Por padrão, os testes são aplicados em ambos os lados da linha central.
11. Opcional. Marque a caixa de seleção ClearOnControlLimitChange. Com
ClearOnControlLimitChange selecionado, se algum dos limites de controle for alterado, o
Asset Analytics redefinirá o estado de um cálculo SQC que está rodando, e o cálculo SQC será
reiniciado com os valores alterados. Além disso, as estruturas de evento abertas associadas
serão fechadas antes de o cálculo ser retomado.
Com ClearOnControlLimitChange não selecionado, o cálculo simplesmente continua usando
os valores alterados para os limites de controle.
12. Opcional. Clique em Avaliar para verificar os valores de saída nas horas do Valor no gatilho
final e do Valor na avaliação. Se todos os testes SQC selecionados forem aprovados, o campo
Valor de saída exibirá "Normal". Se alguns testes falharem, o campo Valor de saída mostrará
o teste de prioridade mais alta que falhou. Alterar qualquer uma das entradas SQC limpará o
campo Valor de saída.
13. Clique em Fazer check-in na barra de ferramentas.
O PI System Explorer salva e faz o check-in da sua análise e começa a executá-la.

Reconciliação de estruturas de evento durante a recarga de

dados históricos automática
Quando o PI Analysis Service é reiniciado após curtos períodos de inatividade, ele inicia a
recarga de dados históricos automática simultaneamente com a análise em tempo real.

Guia do Usuário do PI System Explorer 289

Análises de ativo

Nota:
Com o PI Server 2015 e o PI Server 2015 R2, o PI Analysis Service não inicia o processo
de recarga de dados históricos automática se o período de inatividade for maior do que
72 horas. Com o PI Server 2016, é possível configurar o parâmetro de configurado
MaximumAllowedAutoBackfillingSpanInHours no PI Analysis Service para
especificar o tempo desejado.
Com o PI Server 2015 R2, quando o PI Analysis Service reinicia, ele fecha as estruturas de
evento que estavam abertas, indicando essa razão no campo de descrição da estrutura de
evento. Além disso, quando a recarga de dados históricos automática para análises é concluída,
o Asset Analytics determina se existem estruturas de evento a serem reconciliadas e, conforme
for, inicia a fase de reconciliação. A reconciliação de estrutura de evento pode ser necessária
para qualquer estrutura de evento em andamento que não possa ser fechada dentro do
intervalo de recarga de dados históricos automática, pois nenhum evento de fechamento pode
ser encontrado. Essas estruturas de evento podem ser geradas de duas formas:
• A estrutura de evento pode já estar presente quando o serviço e análise for pausado
• A estrutura de evento pode ser recém-criada durante a recarga de dados históricos
automática
Essas estruturas de evento em andamento podem precisar ser reconciliadas com aquelas
geradas durante a avaliação em tempo real.
Quando uma análise é selecionada usando a guia Análise ou o plug-in Gerenciamento de
Análise, um ícone laranja ( ) na janela de análise indica que a finalização da reconciliação de
estrutura de evento está pendente. Passe o mouse sobre o ícone para visualizar detalhes, como
o número de eventos sendo processados, horas de início e fim e a hora da última avaliação.
Quando a reconciliação for concluída, o ícone muda de laranja para verde.

Gerenciamento de análises em um elemento

Uma análise recém-criada é listada na tabela na guia Análises. É possível ver o status atual, se
ela está ou não associada a um template, o tipo da análise, o nome e o status de recarga de
dados históricos. Passe o mouse sobre os itens ou ícones na lista para verificar as dicas de
ferramentas descritivas.
Para verificar a expressão e o agendamento para uma análise, selecione-a no visualizador de
Análises.
Você pode executar as seguintes operações no visualizador de Análises:

• Criar uma nova análise

É possível clicar em (Nova análise) na parte superior do visualizador ou clicar com o
botão direito em qualquer lugar no visualizador e clicar em Novo.

• Ativar ou desativar uma análise selecionada

É possível selecionar uma análise e clicar em (Ativar análise) ou (Desativar análise) na
parte superior do visualizador.

• Escolher colunas para exibir

É possível clicar com o botão direito no cabeçalho de qualquer coluna e selecionar os
cabeçalhos a serem exibidos.

• Visualizar resultados
É possível visualizar os resultados de uma análise para ver como ela funciona em um
intervalo de tempo específico, clicando com o botão direito uma análise e selecionando

290 Guia do Usuário do PI System Explorer

 Análises de ativo

Visualizar resultados. É possível exportar a tabela de resultados para uma planilha ou copiar
as linhas selecionadas da tabela de resultados em outro aplicativo.
Para obter informações sobre como visualizar gráficos de tendência para tempos de saída
especificados relativos aos tempos do gatilho, consulte Gráficos de tendência em resultados
prévios.

• Realizar recarga de dados históricos ou recalcular dados para uma análise

É possível executar uma análise ao longo de um período anterior para realizar a recarga de
dados históricos ou recalcular dados, conforme descrito em Realizar recarga de dados
históricos ou recalcular dados para uma análise.
Uma análise de expressão, somatório ou SQC pode ser recarregada com dados históricos ou
recalculada se as saídas da análise forem mapeadas para os atributos da tag do PI. Você
pode fazer a recarga de dados históricos ausentes em um intervalo de tempo e reter os
dados existentes ou pode recalcular, o que exclui e recalcula os dados no intervalo de tempo.
Uma Analyses do Gerador de Event Frames também pode recalcular event frames ao longo
de um período especificado. O processo de recálculo, no entanto, exclui automaticamente
todas as estruturas de evento existentes para esse período, bem como as anotações nas
estruturas de evento afetadas.
Para realizar a recarga de dados históricos/recalcular, você precisa da permissão Executar
durante a análise. A permissão adequada pode ser obtida mapeando sua conta para a
identidade do Asset Analytics Recalculation. Observe que o recálculo está disponível
somente para o PI Analysis Service 2016 R2 ou versão posterior. Além disso, o PI Data
Archive que armazena as tags do PI deve estar rodando a versão 2016 R2 ou posterior.

• Ir para template
Uma análise listada ao lado de baseia-se em um template de análise. É possível abrir o
template diretamente da análise clicando com o botão direito na análise e em Ir para
template.

• Redefinir para template

Somente o agendamento de uma análise baseada em um template de análise pode ser
alterado. Para reverter o agendamento da análise para o agendamento do template, clique
com o botão direito e selecione Redefinir para Template.

• Converter em template
Se o elemento para uma análise for originado de um template de elemento, será possível
converter a análise em um template de análise nesse template de elemento, clicando com o
botão direito na análise e selecionando Converter em template. 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 gravada em um ponto PI específico, o
usuário será instruído a escolher como especificar o ponto PI no template de análise
para garantir que as saídas das análises resultantes sejam gravadas em pontos PI
exclusivos.

Vídeo
Para obter informações sobre como realizar a recarga de dados históricos ou recalcular dados
para uma análise, assista a este vídeo:
https://www.youtube.com/watch?v=m7F0FwEykpw

Guia do Usuário do PI System Explorer 291

Análises de ativo

Realizar recarga de dados históricos ou recalcular dados para uma análise

Você pode realizar a recarga de dados históricos ou recalcular os dados durante um período
para a análise de expressão, de somatório ou SQC. Uma Analyses do Gerador de Event Frames
pode recalcular os event frames ao longo de um período especificado, mas isso excluirá
automaticamente todos os event frames existentes no período, bem como as annotations nos
event frames afetados. Para realizar a recarga de dados históricos/recalcular, você precisa da
permissão Executar durante a análise. A permissão adequada pode ser obtida mapeando sua
conta para a identidade do Asset Analytics Recalculation. Para obter mais informações
sobre o mapeamento de identidade, consulte Identidades e mappings do PI AF.
Nota:
Para as análises que gravam as saídas para atributos configurados como tag do PI, a
recarga de dados históricos ou o recálculo resultaria na gravação de eventos fora de
ordem. Esses eventos são gravados no PI Data Archive sem compressão.

Antes de Iniciar
Observe que o recálculo está disponível somente para o PI Analysis Service 2016 R2 ou versão
posterior. Além disso, o PI Data Archive que armazena as tags do PI de saída deve estar
rodando a versão 2016 R2 ou posterior.

Procedimento
1. No navegador Elementos, selecione um elemento e clique na guia Análises para visualizar as
análises definidas para o elemento.
2. Na lista de análises, clique com o botão direito na análise que está rodando e que você
deseja usar para realizar a recarga de dados históricos ou recalcular os dados e clique em
Backfill/Recalculate (Realizar a recarga de dados históricos/recalcular).
3. Na janela Backfilling or recalculation for (Recarga de dados históricos ou recálculo
para) analysis name, realize as ações a seguir.
a. Nos campos Hora de início e Hora de término, especifique o período para o qual deseja
recarregar os dados históricos ausentes enquanto mantém os dados existentes ou excluir
e recalcular os dados. É possível usar expressões de tempo PI padrão ou clicar em
para selecionar o período de uma data específica.
b. Decida como os dados existentes devem ser tratados. Para obter uma análise de
expressão, somatório ou SQC com saída para um atributo:
▪ Para garantir que os dados existentes sejam retidos e que somente os dados ausentes
sejam recarregados com dados históricos, selecione Leave existing data and fill in
gaps (Reter os dados existentes e preencher as lacunas).
▪ Se os dados de entrada ou algoritmos de análise mudaram e você deseja excluir os
dados de saída existentes, selecione Excluir permanentemente os dados existentes e
recalcular.
Nota:
Em uma analyses do gerador de event frames, os dados são automaticamente
excluídos e recalculados (o único modo permitido). Saiba que as anotações nessas
estruturas de evento serão perdidas.
4. Clique em Iniciar para iniciar a recarga de dados históricos ou o recálculo.
5. Para obter detalhes sobre o status da recarga de dados históricos ou do recálculo, ou para
cancelar, clique com o botão direito na análise e clique em Backfill/Recalculate Status
(Status da recarga de dados históricos/recálculo).

292 Guia do Usuário do PI System Explorer

 Análises de ativo

Gerenciamento de análises em um banco de dados PI AF

O recurso de gerenciamento (que inclui análises e regras de notificação) estará disponível se a
instalação do PI System Explorer incluir o plug-in de gerenciamento.
Nota:
Para obter informações sobre o gerenciamento de notificações, consulte Gerenciamento
das regras de notificação.
É possível visualizar e gerenciar as análises no atual banco de dados do PI AF. No navegador,
selecione Management (Gerenciamento) no final da lista. Em seguida, selecione o botão de
opção Análises no painel Management (Gerenciamento).

Pesquisas de análise
Use as pesquisas padrão ou crie a sua própria. Observe que a pesquisa de análises é limitada ao
conteúdo do banco de dados atual.
As três pesquisas padrão são somente de visualização, conforme indicado pelo ícone (View
selected search) (Visualizar pesquisa selecionada):
• Todos: todas as análises
• Ativado: todas as análises ativadas
• Desativado: todas as análises desativadas
Nota:
A pesquisa personalizada é visível somente para o usuário que a criou e no computador
em que ela foi criada. A criação da sua própria pesquisa é um recurso novo no PI AF 2017.
Consulte as versões anteriores do Guia do Usuário do PI System Explorer se você estiver
usando uma versão anterior do PI AF.
Para criar uma pesquisa de análise personalizada, clique no botão (Add new search)
(Adicionar nova pesquisa). Para excluir uma pesquisa de análise, selecione uma pesquisa e
clique no botão (Delete selected search) (Excluir pesquisa selecionada). O ícone (View/
edit selected search) (Visualizar/editar pesquisa selecionada) indica que a sua pesquisa pode
ser editada. Ao clicar em , uma nova janela é aberta. É possível editar o nome da sua
pesquisa. Vários critérios de uma lista suspensa podem ser combinados para restringir sua
pesquisa. Há compatibilidade com pesquisas com caracteres coringa (*). As opções são:

• Nome: nome da análise

• Descrição: descrição da análise
• Nome do elemento
• Template
• Categoria
• Ativado/Desativado: análise ativada ou desativada
• Service Status (Status do serviço): status da análise no PI Analysis Service
◦ Rodando
◦ Stopped (Parado)
◦ Aviso
◦ Error

Guia do Usuário do PI System Explorer 293

Análises de ativo

Nota:
O Service Status (Status do serviço) é baseado na conexão do PI Analysis Service e seu
status de execução. Ele não pode ser combinado com outros critérios de pesquisa.

Painel Análises
O painel Análises exibe as informações sobre as análises selecionadas nestas colunas:
• Status
• (Tipo de análise)
• Elemento
• Nome (da análise)
• Template
• Recarga de dados históricos (status)
Nota:
No painel Análises, é possível verificar o número de análises representadas com o
caractere "~" ou com a palavra "aproximadamente"; por exemplo: "~1000" ou "1-500 de
aproximadamente 1000". Em alguns casos, o número exato de análises não é conhecido
até que todas sejam carregadas.

• Seleção da análise
Com o PI Server 2015 R2 e versões posteriores, os resultados das análises são exibidos em
páginas de 500 resultados cada. Você pode selecionar:
◦ Análises específicas clicando em cada caixa de seleção da análise individual.
◦ Todos os 500 resultados em uma página clicando na caixa de seleção no canto esquerdo
superior.
◦ (Quando houver mais de 500 análises.) Todas as análises em todas as páginas clicando
em Selecionar todas as análises em todas as páginas.
Nota:
Desmarcar análises específicas automaticamente faz com que sua operação
subsequente seja baseada em uma página. Por exemplo, se você primeiro selecionar
todas as 1000 análises e, em seguida, desmarcar duas, a operação será executada
em 498 (500 menos 2) e não em 998 (1000-2) análises.

• Operações
Você pode ativar, desativar ou fazer a recarga de dados históricos/recalcular as análises
selecionadas. Para obter os critérios de seleção específicos, consulte a seção Seleção de
análises acima.
Para realizar a recarga de dados históricos/recalcular, você precisa da permissão Executar
durante a análise. A permissão adequada pode ser obtida mapeando sua conta para a
identidade do Asset Analytics Recalculation. Observe que o recálculo está disponível
somente para o PI Analysis Service 2016 R2 ou versão posterior. Além disso, o PI Data
Archive que armazena as tags do PI deve estar rodando a versão 2016 R2 ou posterior. Para
obter mais informações, consulte Realizar recarga de dados históricos ou recalcular dados
para múltiplas análises.
As análises de expressão, somatório ou SQC podem ser recarregadas com dados históricos
ou recalculadas se as saídas da análise forem mapeadas para os atributos da tag do PI. Se as
tags do PI já tiverem dados para o período de recarga de dados históricos, você pode reter
os dados existentes e preencher os ausentes, ou então excluir os dados e recalcular.

294 Guia do Usuário do PI System Explorer

 Análises de ativo

As Analyses do Gerador de Event Frames também podem recalcular event frames ao longo
de um período especificado. O processo de recálculo, independentemente da opção
selecionada, exclui automaticamente todas as estruturas de evento existentes para esse
período, bem como as anotações nas estruturas de evento afetadas.

• Operações pendentes
Consulte o status das seguintes operações em massa: ativar, desativar, fazer a recarga de
dados históricos ou recalcular um grupo de análises.

• Detalhes da análise
Selecione uma análise para visualizar informações detalhadas.
◦ Para verificar um resumo da configuração e do status da análise, clique na guia Overview
(Visão geral).
◦ Para verificar 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.

Realizar recarga de dados históricos ou recalcular dados para múltiplas

análises
Uma análise de expressão, somatório ou SQC pode ser recarregada com dados históricos ou
recalculada em um período anterior se as saídas da análise forem mapeadas para os atributos
da tag do PI. Você pode fazer a recarga de dados históricos ausentes em um intervalo de tempo
e reter os dados existentes ou pode recalcular, o que exclui e recalcula os dados no intervalo de
tempo. As Analyses do Gerador de Event Frames podem recalcular os event frames ao longo de
um período especificado, mas excluem automaticamente todos os event frames existentes
nesse período, bem como as anotações nos event frames afetados. Para realizar a recarga de
dados históricos/recalcular, você precisa da permissão Executar durante a análise. A
permissão adequada pode ser obtida mapeando sua conta para a identidade do Asset
Analytics Recalculation. Para obter mais informações sobre o mapeamento de
identidade, consulte Identidades e mappings do PI AF.
Nota:
Para as análises que gravam as saídas para atributos configurados como tag do PI, a
recarga de dados históricos ou o recálculo resultaria na gravação de eventos fora de
ordem. Esses eventos são gravados no PI Data Archive sem compressão.

Antes de Iniciar
O recálculo está disponível para o PI Analysis Service 2016 R2 ou versão posterior. O PI Data
Archive que armazena as tags do PI deve estar rodando a versão 2016 R2 ou posterior.

Procedimento
1. No navegador, selecione Management (Gerenciamento) no final da lista.
2. Selecione o botão de opção Análises no painel Management (Gerenciamento).
3. Opcional. Em Pesquisas de análise, selecione uma consulta de pesquisa e selecione o
resultado em que deseja operar. Por exemplo, selecione Desativado. Somente as análises
que cumprem o critério ( ) são exibidas.
4. No painel Análises, selecione as análises nas quais deseja realizar a recarga de dados
históricos ou recalcular.
5. No painel Operations (Operações), clique em Backfill/Recalculate # selected
analyses (Realizar recarga de dados históricos/recalcular análises selecionadas)..

Guia do Usuário do PI System Explorer 295

Análises de ativo

Critérios de seleção adicionais são exibidos.

6. Nos campos Hora de início e Hora de término, especifique o período para o qual deseja
recarregar os dados históricos ausentes enquanto mantém os dados existentes ou excluir e
recalcular os dados. É possível usar expressões de tempo PI padrão ou clicar em para
selecionar o período de uma data específica.
7. Escolha uma das seguintes ações:
Para realizar a recarga de dados históricos ou
recalcular...
Apenas análises de expressão, somatório ou SQC
Uma mistura de análises que inclui as Analyses
do Gerador de Event Frames
ou
Mais de uma página de seleções de análises
Faça o seguinte...
Decida como os dados existentes devem ser
tratados:
◦ Para garantir que os dados existentes sejam
retidos e que somente os dados ausentes
sejam recarregados com dados históricos,
selecione Leave existing data and fill in gaps
(Reter os dados existentes e preencher as
lacunas).
◦ Se os dados de entrada ou algoritmos de
análise mudaram e você deseja excluir os
dados de saída existentes, selecione Excluir
permanentemente os dados existentes e
recalcular.
Realize uma das seguintes ações:
◦ Deixe selecionado Leave existing data and fill
in gaps (Reter os dados existentes e
preencher as lacunas) e reconheça que os
event frames no intervalo de tempo serão
excluídos permanentemente, junto com todas
as anotações nos event frames.
◦ Selecione Excluir permanentemente os dados
existentes e recalcular. Todas as anotações
nas estruturas de evento serão perdidas.

8. Clique em Fila para iniciar múltiplas recargas de dados históricos ou recálculos.

9. Analise o painel Operações pendentes para ver os detalhes do status de recarga de dados
históricos ou recálculo.

Análises de amostra
As análises de amostra desta seção realizam os seguintes cálculos no mesmo banco de dados PI
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, Ethylene.
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 Refinery.
3. Cria estruturas de eventos para capturar dados sempre que a eficiência de média de
execução de 15 minutos do elemento, Ethylene, ficar abaixo de 90%.

Criar uma análise de expressão para estudar o desvio da eficiência

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.

296 Guia do Usuário do PI System Explorer

 Análises de ativo

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 novo ponto do PI para armazenar os dados de saída (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.

Antes de Iniciar
Crie um elemento nomeado Ethylene que tenha um atributo nomeado Efficiency que
contenha uma referência de dados do ponto do PI.

Procedimento
1. Em Elementos, selecione o elemento para o qual deseja criar a análise, como Etileno.

2. Clique na guia Análises.

3. Crie uma análise para o elemento:
◦ Se não houver nenhuma análise, clique em Criar análise para criar a primeira.
◦ Caso contrário, clique em Nova análise para criar uma.
4. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise. Por exemplo, EfficiencyCalc.

◦ Tipo de análise
Clique em Expressão. A análise da expressão é o tipo mais simples; ela contém apenas
uma ou mais expressões e as informações da agenda. Para obter mais informações,
consulte Análises de expressão.
5. Na tabela de expressões, crie uma variável para manter o valor constante da eficiência de
destino:
a. Na coluna Nome, digite Target.

Guia do Usuário do PI System Explorer 297

Análises de ativo

b. Na coluna Expressão, digite 90.

Isso define esta variável como o valor constante de 90.
6. Crie uma segunda variável para calcular a eficiência média por hora:
a. Clique em Adicionar uma nova expressão.
b. Nomeie a variável como HourlyEfficiency.
c. Na coluna Expressão, insira a seguinte sintaxe de equação do desempenho:
TagAvg('Efficiency', '*-1h', '*')

Essa expressão calcula o valor médio do atributo chamado Efficiency na última hora.
7. Crie uma terceira variável para calcular o desvio da eficiência por hora da meta de 90:
a. Clique em Adicionar uma nova expressão.
b. Nomeie a variável como Deviation.
c. Na coluna Expressão, insira a seguinte expressão:
HourlyEfficiency - Target
8. Salve a saída da variável Deviation em um ponto do PI:
a. Na coluna Atributo de saída, clique em Mapear.
b. Clique em Novo atributo para criar um novo atributo PI AF.
c. Para definir o atributo como uma referência de dados do ponto do PI, clique em Sim para
salvar o histórico de saída.
d. No campo Nome, insira o nome do atributo, como EfficiencyDifference.
e. Clique em OK para criar o atributo.
9. Especifique a agenda para a análise:
a. Configure a opção Agenda como Periódico.
b. Clique em Configurar e especifique um período de 30 segundos.
O cálculo será executado a cada 30 segundos.
10. Verifique se os resultados parecem razoáveis:
a. Na tabela de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira o intervalo de tempo da pré-visualização. O intervalo de tempo padrão começa na
meia-noite anterior e termina no momento atual, mas você pode inserir horas de início e
término diferentes, se preferir.
c. Clique em Gerar resultados.
11. Quando estiver satisfeito com a nova análise, clique em Check-in na barra de ferramentas
para fazer o check-in do seu trabalho.
O PI System Explorer salva e faz o check-in da sua análise e começa a executá-la.
Um círculo verde na coluna Status da tabela de análises indica que o PI Analysis Service está
executando a análise.
12. Opcional. Realize a recarga de dados históricos do ponto PI com os resultados do cálculo
utilizando dados do passado.

298 Guia do Usuário do PI System Explorer

 Análises de ativo

O PI Analysis Service pode fazer o backfill dos resultados dos cálculos que têm atributos de
saída mapeados para referências de dados do ponto do PI. No entanto, o ponto do PI não
pode conter dados nos tempos especificados. Se desejar, é possível excluir os dados
preexistentes e fazer o backfill nesse intervalo de tempo.

a. Clique com o botão direito na tabela de análises e clique em Realizar recarga de dados
históricos/recálculo.
b. Especifique uma hora de início e um tempo final para fazer o backfill.
c. Selecione Excluir permanentemente os dados existentes e recalcular.
d. Clique em Iniciar.

Criar um template para análises de sintetização potentes

Este exemplo demonstra como criar um template que pode ser usado 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.

Antes de Iniciar
Crie os objetos necessários em seu banco de dados PI AF:
• Template de elemento nomeado Refinery
• Elemento nomeado Rotterdam Refinery, derivado do template Refinery
• Elemento filho nomeado Catalytic Cracking sob o elemento Rotterdam Refinery
• Atributo nomeado Power Draw sob o elemento filho Catalytic Cracking

Procedimento
1. No navegador de Biblioteca, selecione o template de elemento para o qual você deseja criar
o template de análise.
Neste exemplo, o template de elemento é chamado Refinery. Esse template é usado para
criar elementos da refinaria.
2. Clique na guia Templates de análises.
3. Crie um template de análise para o template de elemento:
◦ Se nenhum template de análise existir, clique em Criar um template de análise para criar
o primeiro.
◦ Caso contrário, clique em Novo template de análise para criar um.
4. Especifique informações para identificar a análise:

◦ Nome
O nome que identifica exclusivamente esta análise. Por exemplo, PowerRollup.

◦ Tipo de análise
Clique em 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 somatório.
5. Selecione um elemento de exemplo para fornecer atributos candidatos:
a. Clique no link Selecionar um elemento de exemplo para abrir uma janela que mostra os
elementos derivadas do template do elemento selecionado.
b. Selecione um elemento e clique em OK.

Guia do Usuário do PI System Explorer 299

Análises de ativo

Por exemplo, na lista de elementos derivados do template Refinery, clique em

Rotterdam Refinery.
6. Para a opção Atributos de sintetização, clique em Elementos filhos de Rotterdam Refinery
para indicar que a análise sintetiza os atributos de elementos filhos do elemento refinaria.
7. Selecione os atributos a serem incluídos no somatório:
a. Na lista Elemento filho da amostra, selecione o elemento cujos atributos você deseja
exibir.
Por exemplo, selecione Craqueamento catalítico para ver os atributos do elemento
Catalytic Cracking na tabela de atributos.
A tabela mostra apenas os atributos do elemento selecionado. A sintetização inclui os
atributos de todos os elementos filhos que correspondem aos critérios que você
especificar.
b. À esquerda da tabela de atributos, especifique os critérios que selecionam os atributos
para sintetizar.
Por exemplo, no campo Nome do atributo, digite Power* para especificar todos os
atributos que começam com Power. A tabela de atributos mostra uma marca de seleção
ao lado de quaisquer atributos no elemento filho selecionado que correspondam a esse
critério. No entanto, a sintetização inclui atributos de qualquer elemento filho que
corresponda aos critérios, não apenas os que estão na tabela.
8. Na tabela de funções, especifique os cálculos de somatório e saída:
a. Marque as caixas de seleção ao lado de qualquer função estatística que deseja que o
somatório calcule.
Por exemplo, clique na caixa de seleção Soma referente aos valores totais.
b. Na coluna Saída(s), clique em Mapear para armazenar os resultados do cálculo para um
atributo de saída.
c. Clique em Novo template de atributo para criar um novo template de atributo com uma
referência de dados do ponto do PI.
d. Especifique os valores que definem o atributo criado e o ponto e clique em OK.
Por exemplo, é possível usar os valores padrão, cujo nome o ponto e o atributo
PowerRollup_Sum e gravar o ponto para o padrão PI Data Archive, indicado pelo
parâmetro de substituição.
9. Clique em Avaliar e verifique se o resultado retornado na coluna Valor é razoável.
10. Configure a opção Agenda como Acionado pelo evento.
11. Para verificar a análise, examinar os resultados produzidos com dados históricos:
a. Na lista de análises, clique com o botão direito na análise e clique em Visualizar
resultados.
b. Insira uma hora de início e de término anteriores à hora atual e clique em Gerar
resultados para verificar a lista de resultados.
12. Clique em Check-in na barra de ferramentas para salvar o template de análise para o PI AF
Server e criar a análise para qualquer elemento com base no template de elemento.

300 Guia do Usuário do PI System Explorer

 Análises de ativo

Criar estruturas de evento automaticamente para acompanhar a

ineficiência
No exemplo, Criar uma análise de expressão para estudar o desvio da eficiência, 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%.

Antes de Iniciar
Criar uma análise de expressão para estudar o desvio da eficiência.

Procedimento
1. No navegador de Biblioteca, expanda Templates.
2. Clique com o botão direito em Templates da estrutura de evento e clique em Novo template
para criar um novo template da estrutura de evento.
3. No campo Nome, insira EfficiencyAnomaly.
4. No campo Padrão de nomenclatura, especifique o nome das estruturas de evento
produzidas do template.
Você pode usar os parâmetros de substituição para especificar um nome de variável. O PI AF
resolve os parâmetros ao criar as estruturas de evento. Em seguida, cada estrutura de
evento terá um nome exclusivo e identificável.

a. Clique na seta ao lado do campo para verificar parâmetros de substituição válidos que
podem ser adicionados ao nome.
b. Selecione %ELEMENT%.
c. Selecione %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.
O parâmetro de substituição STARTTIME inclui a formatação padrão de data-hora para
usar.

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. No campo Nome, insira Efficiency.
c. Clique em Configurações e insira a seguinte string de configuração no campo Nome da
tag:

Guia do Usuário do PI System Explorer 301

Análises de ativo

.\Elements[.]|Efficiency; uom=%
d. Na lista UDM padrão, selecione percentual.

7. No painel Elementos, clique em Etileno, o elemento para o qual você construiu uma análise
no Criar uma análise de expressão para estudar o desvio da eficiência.
8. Clique na guia Análises.
9. Clique em Nova análise .
10. Especifique informações para identificar a análise:

◦ Nome
Insira EfficiencyAnomalyEvent.

◦ Tipo de análise
Clique em Geração da estrutura de evento.
11. Na lista Template de estrutura de evento, selecione EfficiencyAnomaly.
Esse é o nome do template da estrutura de evento que você criou nas etapas anteriores.
12. Insira as expressões que especifiquem o início e o fim da estrutura de evento:

◦ StartTrigger1
TagAvg('Efficiency', '*-15m', '*') <90
Cria uma estrutura de evento sempre que a eficiência média de 15 minutos cair para
abaixo de 90%.

◦ EndTrigger
TagAvg('Efficiency', '*-15m', '*') >92
Termina a estrutura de evento sempre que a eficiência média de 15 minutos tiver se
recuperado e exceder a 92%.
13. Clique em Avaliar para verificar os valores atuais das expressões.
A coluna Valor é preenchida com True ou False para cada condição.
14. Especifique o agendamento da análise.
a. Para a opção Agenda, clique em Periódico.
b. Clique em Configurar e configure a análise para executar a cada minuto.
15. Faça check-in do trabalho.

302 Guia do Usuário do PI System Explorer

 Análises de ativo

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 PI Analysis Service).
O PI Analysis Service executa todas as análises no servidor PI AF atual. Duas características
ajudam a gerenciar o serviço:
• 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. Veja Exibir estatísticas do serviço de análise.
• A janela Configuração permite que você exiba ou modifique configurações de propriedades
do serviço de análise para ajustar o desempenho. Veja Exibir ou modificar o serviço de
análise.

Exibir estatísticas do serviço de análise

Procedimento
1. No navegador, clique em Gerenciamento e, em seguida, selecione Análise para visualizar a
área de gerenciamento da análise.
2. Clique com o botão direito em qualquer lugar do painel de Operações e clique em Exibir
estatísticas do serviço de análise. 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 em Atualizar para atualizar as estatísticas com dados atuais.
4. Opcional. Clique em Salvar para salvar as 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. No navegador, clique em Gerenciamento e, em seguida, selecione Análise para visualizar a
área de gerenciamento da análise.
2. Clique com o botão direito em qualquer lugar do painel Operações e clique em Editar
configuração do Analysis Service.
A janela Configuração lista as configurações das propriedade do serviço de análise. Consulte
Configuração do serviço de análise para obter informações sobre essas configurações.
3. Para modificar uma propriedade, edite sua configuração na coluna Configuração.
4. Clique em Ok para aplicar todas as alterações e fechar a janela.

Guia do Usuário do PI System Explorer 303

Análises de ativo

Configuração do serviço de análise

Você pode modificar essas configurações na janela Configuração.
Nota:
As alterações nas configurações AutoBackfillingEnabled,
MaximumAllowedAutoBackfillingSpanInHours ou NumberParallelDataPipes
exigem a reinicialização do PI Analysis Service para surtir efeito.

• AutoBackfillingEnabled
Essa propriedade preenche automaticamente as lacunas nos dados que resultam de
períodos quando o PI Analysis Service 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). Insira False para desativar essa propriedade. Se você atualizar essa
configuração, deve reiniciar o PI Analysis Service.
Quando uma análise é retomada após um curto período de inatividade, os cálculos em
tempo real são iniciados e, simultaneamente, a recarga de dados históricos automática é
posta em fila, se habilitada. Entretanto, eventos com timestamps antes da hora de início do
serviço são processados de maneira diferente dependendo de a recarga de dados históricos
automática estar habilitada usando a definição de configuração
AutoBackfillingEnabled:
◦ Se a recarga de dados históricos automática estiver habilitada, os eventos acionados com
timestamps antes da hora de início automática são processados pela recarga de dados
históricos automática e não pelo processamento em tempo real.
◦ Se a recarga de dados históricos automática estiver desabilitada, o processamento em
tempo real processará todos os eventos acionados que são recuperados após o serviço de
análise ser iniciado, incluindo eventos que tenham timestamps antes da hora de início da
análise.

• CacheTimeSpanInMinutes
O PI Analysis Service determina dinamicamente o span de tempo do cache de dados para os
atributos do AF usados como entradas nos cálculos. Por exemplo, para as análises que
calculam o resumo por hora, o PI Analysis Service armazenaria automaticamente em cache
uma hora de dados para os atributos de entrada necessários. Isso garante que os dados
necessários para os cálculos estejam disponíveis no cache de dados, enquanto os dados
desnecessários podem ser eliminados. Configure o CacheTimeSpanInMinutes
manualmente somente se não for possível determinar o span de tempo pela configuração do
cálculo. Uma configuração de tempo mais longa significa que qualquer dado de entrada
necessário para os cálculos estará disponível no cache de dados, porém, essa configuração
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.
O span de tempo máximo que seria armazenado em cache é de 7 dias; os dados no span de
tempo além de 7 dias seriam eliminados. Note que MaxCacheEventsPerAttribute tem
precedência sobre esta configuração, então ambas as configurações podem ter que ser
ajustadas simultaneamente.

• CalculationWaitTimeInSeconds
Um período de espera antes de avaliar as análises agendadas. 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

304 Guia do Usuário do PI System Explorer

 Análises de ativo

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.

• CreateFuturePIPointsForAmbiguousOutputTimes
Um flag que determina o tipo de ponto PI para criar para os atributos de saída recém-
mapeados que salvam o histórico de saída quando o timestamp da saída é incerto. O PI
Analysis Service tenta criar o tipo de ponto PI que coincide com o timestamp da saída,
futuros pontos PI para a saída com futuros timestamps ou pontos PI históricos para saída
com timestamps presentes ou passados. Se configurado como False, o PI Analysis Service
cria pontos PI históricos nos casos em que o timestamp da saída é ambíguo. Se configurado
como True, o PI Analysis Service cria futuros pontos PI nos casos em que o timestamp da
saída é ambíguo.

• Padrão para criação automática de pontos PI para o template

Quando essa caixa de seleção é marcada, o PI Analysis Service cria automaticamente pontos
PI para os atributos de saída nas análises derivadas de templates de análise.

• 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 configuração EvaluationPartitionSize; os
subgrupos podem, então, ser avaliados em paralelo. O valor padrão para essa 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 demorar 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 PI Analysis Service 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, insira
False nessa configuração.

• IsTelemetryAllowed
Insira False para parar de enviar dados de uso do PI Analysis Service para o Programa de
Melhoria da Experiência do Cliente. (Isso não afeta a configuração correspondente para
participação no programa que você pode configurar no PI System Explorer).

• MaxCacheEventsPerAttribute
Uma vez que esse limite seja atingido os eventos mais antigos são eliminados do cache de
dados. Note que essa configuração tem precedência sobre CacheTimeSpanInMinutes.

• MaxConcurrentRecalculationRequests
O número máximo de operações de recarga de dados históricos ou recálculo que o PI
Analysis Service pode executar simultaneamente. O PI Analysis Service escala
dinamicamente o número de segmentos usado para a recarga de dados históricos ou o
recálculo entre 1 e o número especificado. Esse número pode ser configurado pelo usuário e
depende dos recursos disponíveis (CPU e memória) da máquina que está rodando o PI

Guia do Usuário do PI System Explorer 305

Análises de ativo

Analysis Service. Você pode configurar esse parâmetro para qualquer valor inteiro entre 1 e
4*P, em que P representa o número de processadores na máquina que o PI Analysis Service
está rodando. O valor padrão para esse parâmetro é (1/2)*P.

• MaximumAllowedAutoBackfillingSpanInHours
Especifique o tempo máximo de inatividade (em horas) para que o PI Analysis Service inicie
a recarga de dados históricos automática. Configurar o parâmetro para "0" ou um número
negativo restaurará a configuração registrada anteriormente para esta opção. Se você
atualizar essa configuração, deve reiniciar o PI Analysis Service.
Nota:
Para desativar a recarga de dados históricos automática, é necessário desativar o
parâmetro AutoBackfillingEnabled.

• MinCacheEventsPerAttribute
A configuração padrão de 1 garante que pelo menos um evento por atributo permaneça no
cache de dados.

• NumberDataWriterThreads
O número de segmentos que o PI Analysis Service utiliza para gravar as saídas da análise.
Mais segmentos são úteis para os cálculos de alta frequência que gravam valores em taxas
altas e para gravar no PI Data Archive em um computador com alta latência de rede (outros
segmentos podem gravar valores enquanto esperam por uma resposta do PI Data Archive).
Pense em aumentar o número de segmentos quando as análises pularem muitas avaliações
ou tiverem um alto atraso na avaliação. Mais segmentos podem ajudar se as gravações de
dados causarem um gargalo. Você pode configurar o número de segmentos para o número
de processadores no computador em que o PI Analysis Service é executado.

• NumberEvaluationThreads
O número de segmentos que o PI Analysis Service utiliza para avaliar as análises
simultaneamente. Você pode configurar esse parâmetro para qualquer valor inteiro entre 1
e 4*P, em que P representa o número de processadores na máquina que o PI Analysis
Service está rodando. O valor padrão para esse parâmetro é P. Considere aumentar o
número de segmentos de avaliação quando o PI Analysis Service não estiver usando
totalmente os recursos de CPU disponíveis; por exemplo, quando as análises ignoram uma
série de avaliações ou apresentam um atraso grande na avaliação. Isso pode acontecer
quando você tem muitas análises com cálculos de resumo que são acionadas com
frequência. Ter um número maior de segmentos de avaliação é útil para as análises que
exigem acesso frequente a uma grande quantidade de dados de atributos de entrada
externos ao cache de dados.

• NumberParallelDataPipes
Os atributos recebem atualizações das fontes de dados, incluindo 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. Se você atualizar essa configuração, deve reiniciar o PI Analysis Service.

• RuntimeStorageFolderPath
Especifique o local do diretório que contém informações do tempo de execução do PI
Analysis Service, como recarga de dados históricos do usuário e grupos de cálculo. Por
padrão, o PI Analysis Service armazena informações do tempo de execução em \
\ProgramData\OSIsoft\PIAnalysisNotifications.

306 Guia do Usuário do PI System Explorer

 Análises de ativo

• Nome sugerido do ponto PI

Você pode modificar o padrão de nomeação aqui com um parâmetro de substituição. Para
obter uma lista completa, consulte 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 nas Expressões do Analyses são relacionadas em ordem
alfabética.

Abs
Retorna o valor absoluto de um número inteiro ou real.

Sintaxe
Abs(x)

Argumentos
• x
Um número inteiro ou real

Retornos
O valor absoluto de x

Exceções
Retorne um valor de erro se x não for um número inteiro ou real

Notas
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• Abs(-2.2) [Returns 2.2]
• Abs('att1') [Returns the absolute value of 'att1' at time of evaluation]

Acos
Retorna a inversa de cosseno (arccos) de um número inteiro ou real. A inversa de cosseno de x
é o ângulo em radianos cujo cosseno é igual a x.

Sintaxe
Acos(x)

Argumentos
• x
Deve ser um número real entre -1,0 (inclusive) e 1,0 (inclusive).

Retornos
A inversa de cosseno de x, em radianos.

Guia do Usuário do PI System Explorer 307

Análises de ativo

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
• Acos(-0.5) [Returns 2.0944]
• Acos(0.75) [Returns 0.72273]

AND
A conjunção lógica de duas expressões que retorna True (verdadeiro) se ambas as expressões
forem verdadeiras e False (falso) em caso contrário.

Sintaxe
expression1 AND expression2

Argumentos
• expression1, expression2
Qualquer expressão avaliada como verdadeira ou falsa

Retornos
True se ambas as expressões forem verdadeiras (diferentes de zero) e False (zero) em caso
contrário

Exceções
Nenhum

Exemplo
• ('att1' > 50) AND ('att2' = "good")

Ascii
Retorna o código de caractere ASCII do primeiro caractere de uma string.

Sintaxe
Ascii(s1)

Argumentos
• s1
Qualquer expressão sendo 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

308 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• Ascii("D") [Returns 68]
• Ascii("Program") [Returns 80, the ASCII character code for the first letter of
the string]

Asin
Retorna a inversa de seno (arcsin) de um número. A inversa de seno de x é o ângulo em
radianos cujo seno é igual a x.

Sintaxe
Asin(x)

Argumentos
• x
Deve ser um número real entre -1,0 (inclusive) e 1,0 (inclusive).

Retornos
A inversa de seno de x, em radianos.

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(-0.5) [Returns -0.5236]
• Asin(TagVal('att1','y'))
• Asin('att1')

Atn
Retorna a inversa de tangente (arctan) de um número inteiro ou real. A inversa de tangente de
x é o ângulo em radianos cuja tangente é igual a x.

Sintaxe
Atn(x)

Argumentos
• x
Deve ser um número inteiro ou real

Retornos
A inversa de tangente de x, em radianos.

Exceções
Retornará um erro se x não for um número inteiro ou real.

Guia do Usuário do PI System Explorer 309

Análises de ativo

Exemplo
• Atn(1) [Returns 0.7854]
• Atn(-2.2) [Returns -1.1442]
• Atn('att1')
• Atn('att1' - 'att2')

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(x, y)

Argumentos
• x
Um número inteiro ou real

• y
Um número inteiro ou real diferente de zero

Retornos
A inversa de tangente em radianos do valor x/y de tangente.

Exceções
Retornará um erro se x ou y não forem números inteiros ou reais.

Exemplo
• Atn2(1,2) [Returns 0.46365]
• Atn2('att1', 'att2')
• Atn2(TagVal('att1','y'), TagVal('att2', 'y'))

Avg
Retorne a média de um conjunto de um ou mais valores.

Sintaxe
Avg (x1 [, ... xn])

Argumentos
• x1, ... xn
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Retornos
A média de um ou mais valores. O resulto é do mesmo tipo de dado dos argumentos.

310 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Argumentos cujos valores de tempo de execução são strings de caracteres ou estados digitais
não são inclusos na média. Se todos os valores forem strings de caracteres ou estados digitais,
Avg retornará um valor de erro.

Notas
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes. Avg retorna uma
média baseada em evento, não em tempo.

Exemplo
• Avg(14, 'att1', 14.5, TagVal('att2', '14-Dec-16'))
[Encontre a média desses valores: 14, o valor atual de 'att1', 14,5 e o valor de 'att2' no início
do dia (0h) em 14 de dezembro de 2016]
• Avg('*', 'y+8h', 'Saturday')
[Encontre a média desses timestamps: agora, 8h de ontem e início do dia (0h) no sábado
passado]
• Avg('*'-'*-1h', 't+4h'-'y+8h', 'y+2h'-'20')
[Encontre a média desses períodos: a partir de 1 hora atrás até agora, das 8h de ontem até
as 4h de hoje e das 2h de ontem até o início do dia (0h) no dia 20 deste mês]

BadVal
Testa um valor para ver se ele é ruim. Para um atributo associado a uma tag do PI, o valor do
estado digital do sistema é considerado inválido [No Data (Nenhum dado) ou Calc Failed
(Falha no cálculo), por exemplo].

Sintaxe
Badval(x)

Argumentos
• x
Qualquer expressão sendo avaliada como um valor

Retornos
True se o valor for inválido
False se o valor não for inválido

Exceções
Retorna True para tags do PI do tipo blob. Retorna False para tags do PI do tipo string.

Exemplo
• BadVal(1/0) [Returns True]
• BadVal(10) [Returns False]
• BadVal('att1') [Returns True if the value of 'att1' is bad]
• BadVal(FindEq('att1', 't', '*', 10))

Guia do Usuário do PI System Explorer 311

Análises de ativo

[Retorna True (Verdadeiro) se a função incorporada (FindEq neste exemplo) não retornar
resultados ou se ocorrer erros por qualquer motivo]

Bod
Retorne um timestamp para o início do dia a partir de uma expressão de tempo.

Sintaxe
Bod(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples

Retornos
Timestamp para o início do dia

Exceções
Nenhum

Notas
Esta função é útil para estabelecer o tempo em um relógio exclusivo, independentemente da
duração de determinados dias.

Exemplo
• Bod('*')
[Retorne um timestamp para o início do dia de hoje.]
• Bod('y')
[Retorne um timestamp para o início do dia de ontem.]
• Bod(FindEq('att1', '-3d', '*', 50))
[Retorne um timestamp para o início do dia quando o valor de 'att1' foi igual a 50 pela
primeira vez nas últimas 72 horas.]

Bom
Retorne um timestamp para a meia-noite do primeiro dia do mês a partir de uma determinada
expressão de tempo.

Sintaxe
Bom(t1)

Argumentos
• t1
Uma expressão de tempo

Retornos
Timestamp para o início do mês.

312 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Nenhum

Notas
Esta função é útil para estabelecer o tempo em um relógio exclusivo, independentemente da
duração de determinados dias.

Exemplo
• Bom('*')
[Retorne um timestamp para a meia-noite do primeiro dia do mês.]
• Bom(PrevEvent('att1', '*'))
[Retorne um timestamp para a meia-noite do primeiro dia do mês quando 'att1' tinha um
valor anterior ao valor atual.]
• Bom(FindEq('att1', '-60d', '*', 50))
[Retorne um timestamp para a meia-noite no primeiro dia do mês quando o valor de 'att1'
foi igual a 50 pela primeira vez nos últimos 60 dias.]

Bonm
Retorne um timestamp para a meia-noite do primeiro dia de um mês seguinte a partir de uma
determinada expressão de tempo.

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
Nenhum

Notas
Esta função é útil para estabelecer o tempo em um relógio exclusivo, independentemente da
duração de determinados dias.

Exemplo
• Bonm('*')
[Retorne um timestamp para a meia-noite do primeiro dia do próximo mês.]
• Bonm('y')
[Retorne um timestamp para a meia-noite do primeiro dia do mês seguinte a partir de data
de ontem.]
• Bonm(FindEq('att1', '-60d', '*', 50))

Guia do Usuário do PI System Explorer 313

Análises de ativo

[Retorne um timestamp para a meia-noite do primeiro dia do mês seguinte quando o valor
de 'att1' foi igual a 50 pela primeira vez nos últimos 60 dias.]

Ceiling
Retorne o número inteiro mais próximo que seja maior que ou igual a x.

Sintaxe
Ceiling(x)

Argumentos
• x
Número inteiro ou real, um atributo cujo valor é avaliado como um número na hora da
avaliação

Retornos
O número inteiro mais próximo maior que ou igual a x.

Exceções
Retornará um erro se x for um estado digital, uma expressão de tempo, um intervalo de tempo
ou uma string

Notas
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• Ceiling(2.3) [Returns 3]
• Ceiling(-2.3) [Returns -2]
• Ceiling(TagVal('att1', '12/30/16'))
[Retorne o número inteiro mais próximo ao valor de 'att1' no início do dia (0h) em 30 de
dezembro de 2016]

Char
Cria uma string com base nos códigos de caracteres ASCII.

Sintaxe
Char(x1, ... xn)

Argumentos
• x1, ... xn
Números inteiros

Retornos
Uma string criada com base nos códigos de 80 caracteres

Exceções
Retorna um erro se um argumento não for um número

314 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• Char(80, 73)
[Retorna "PI"]
• Char(65)
[Retorna "A"]
• Char(5 * 10)
[Retorna "2"]

Compare
Compare duas strings usando caracteres curinga ("*" e "?") ou compare dois operandos usando
operadores lógicos e valor de banda morta.

Sintaxe
Compare {[(s1, s2 [, caseSensitive])]|[x1, x2, op, deadband]}

Argumentos
• s1, s2
strings (s2 pode conter caracteres curinga)

• caseSensitive
Flag opcional indicando se a comparação é sensível a maiúsculas e minúsculas. Se for False
(padrão), a comparação não será sensível a maiúsculas e minúsculas. Se for True, a
comparação será sensível a maiúsculas e minúsculas.

• x1, x2
Valor numérico (número inteiro ou real) ou expressão de tempo

• op
Um operador usado para comparação. Deve ser um dos seguintes operadores, ou uma
variável definida como um desses operadores: <, >, <=, >=

• deadband
Valor numérico (número inteiro ou real) ou de período de tempo. Deadband especifica um
buffer (tolerância) de aproximadamente x2, evitando alertas repetidos quando o valor oscila
no intervalo de deadband.

Retornos

• True se s1 = s2
• True se x1 <op> x2 é verdadeiro, e usa o valor de deadband para avaliações subsequentes
False em caso contrário

Exceções
Caracteres coringas em s1 são tratados literalmente e não como coringas.
O valor de banda morta é aplicado a x2, não a x1.

Guia do Usuário do PI System Explorer 315

Análises de ativo

Exemplo
• Compare('att1', 100, "<=", 5)
[Retornará True se 'att1' for menor que ou igual a 100 e usará o valor de banda morta de 5
para avaliações subsequentes]
• Compare("What", "what", True)
[Retorna False]
• Compare("b", "a")
[Retorna False]
• Compare("What", "wha?")
[Retorna True]
• Compare("What", "wh")
[Retorna False]

Concat
Concatena duas ou mais strings.

Sintaxe
Concat(s1, s2 [, ... sn])

Argumentos
• s1 ... 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 em uma string que tenha um espaço simples entre aspas duplas.

Exemplo
• Concat("shut", "down")
[Retorna "shutdown"]
• Concat("shut ", "down")
[Retorna "shut down"]

Contains
Determine se a primeira string contém a segunda string e retorne verdadeiro ou falso.

Sintaxe
Contains(s1, s2 [,caseSensitive])

Argumentos
• s1
String primária.

316 Guia do Usuário do PI System Explorer

 Análises de ativo

• s2
Substring pesquisada na string primária.

• caseSensitive
Opcional: booliano que indica se a pesquisa é sensível a maiúsculas e minúsculas. Se for
False (ou omitido), a pesquisa não será sensível a maiúsculas e minúsculas. Se for True, a
pesquisa será sensível a maiúsculas e minúsculas.

Retornos
True se a string primária (S1) contiver a substring (S2), e False em caso contrário.

Exceções
Se um dos primeiros dois argumentos (S1 ou S2) não for uma string, a função retornará um
valor de erro.
Se o terceiro argumento opcional (caseSensitive) não for um booleano, a função retornará
um valor de erro.

Exemplo
• Contains("What","Hat",True) [Returns False]
• Contains("What","Hat") [Returns True]
• Contains("What","at") [Returns True]
• Contains("hat","what") [Returns False]

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 como 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 UOM resultante entre aspas duplas

Retornos
O valor numérico convertido para a UOM especificada

Exceções
Retorna um erro se toUnit e a UOM inicial para x não estiverem na mesma classe de UOM

Exemplo
• Convert('MetricWeight', "lb")
• Convert('Ambient Temperature', "degC")

Guia do Usuário do PI System Explorer 317

Análises de ativo

Nota:
O PI AF substitui deg por °, caso ele não seja encontrado na pesquisa.

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 radianos.

Retornos
O cosseno de x.

Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.

Exemplo
• Cos(1.1) [Returns 0.4536]
• Cos(1) [Returns 0.5403]
• Cos('att1') [Return the trigonometric cosine of the value of 'att1' at current
time]

Cosh
Retorne o cosseno hiperbólico de um número.

Sintaxe
Cosh(x)

Argumentos
• x
Deve ser um número inteiro ou real

Retornos
O cosseno hiperbólico de x

Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.

Exemplo
• Cosh(1) [Returns 1.5431]
• Cosh(-1) [Returns 1.5431]
• Cosh('att1') [Return the hyperbolic cosine of the value of 'att1' at current
time]

318 Guia do Usuário do PI System Explorer

 Análises de ativo

Cot
Retorna a cotangente trigonométrica de um número.

Sintaxe
Cot(x)

Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radianos.

Retornos
A cotangente de x

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Cot(1) [Returns 0.64209]
• Cot(1.1) [Returns 0.50897]
• Cot('att1') [Return the trigonometric cotangent of the value of 'att1' at
current time]

Coth
Retorna a cotangente hiperbólica de um número.

Sintaxe
Coth(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Retornos
A cotangente hiperbólica de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Coth(1) [Returns 1.313]
• Coth(1.1) [Returns 1.2492]
• Coth('att1') [Return the hyperbolic cotangent of the value of 'att1' at
current time]

Csc
Retorna a cossecante trigonométrica de um número.

Guia do Usuário do PI System Explorer 319

Análises de ativo

Sintaxe
Csc(x)

Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radianos.

Retornos
A cossecante de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Csc(1) [Returns 1.1884]
• Csc(1.1) [Returns 0.7487]
• Csc('att1') [Return the trigonometric cosecant of the value of 'att1' at
current time]

Csch
Retorna a cossecante hiperbólica de um número.

Sintaxe
Csch(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Retornos
A cossecante hiperbólica de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Csch(1) [Returns 0.85092]
• Csch(1.1) [Returns 0.748]
• Csch('att1') [Return the hyperbolic cosecant of the value of 'att1' at current
time]

Curve
Retorne o valor de y de uma curva, de acordo com o valor de x.

Sintaxe
Curve( x, (x1,y1) (x2,y2) … (xn,yn) )

320 Guia do Usuário do PI System Explorer

 Análises de ativo

Argumentos
• x
Expressão sendo avaliada como um número.

• x1, y1
A primeira tag na curva. Os xis yis são constantes numéricas avaliadas no tempo de
compilação. O conjunto de valores para xis 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 ele for
maior que xn, yn será retornado. Presume-se que as tags são ordenadas na direção x, da menor
para a maior.

Exceções
Se o valor de x não for um número inteiro ou real, um valor de erro será retornado.

Exemplo
• Curve(3, (0,100) (100,0) ) [Returns 97]
• Curve('att1', (25,25) (75,75) )

Day
Extrai o dia do mês de uma expressão de tempo.

Sintaxe
Day(t1)

Argumentos
• t1
expressão de tempo entre aspas simples

Retornos
O dia do mês de uma expressão de tempo no intervalo de 1 até 31.

Exceções
Nenhum

Exemplo
• Day('*')
[Retorne qual é o dia do mês hoje.]
• Day('y')
[Retorne qual dia do mês foi ontem.]
• Day(FindEq('att1', '-28d', '*', 50))
[Retorne qual dia do mês era quando o valor de 'att1' foi igual a 50 pela primeira vez nos
últimos 28 dias.]

Guia do Usuário do PI System Explorer 321

Análises de ativo

DaySec
Retorne a hora total em segundos entre o início do dia (meia-noite) e a hora indicada no
argumento.

Sintaxe
DaySec(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples.

Retornos
Total de segundos desde o início do dia (meia-noite) até t1, no intervalo 0-86399.

Exceções
Nenhuma.

Exemplo
• DaySec('*')
[Retorne o número de segundos desde o início do dia (meia-noite) até o momento.]

DeltaValue
Retorne a diferença entre o valor atual e o valor imediatamente anterior de um atributo com
um tipo de valor numérico ou DateTime; também é possível retornar a diferença entre as
avaliações atuais e imediatamente anteriores para qualquer expressão com um tipo de valor
numérico ou DateTime.

Sintaxe
DeltaValue(x [, prevEval])

Argumentos
• x
Um atributo ou expressão com tipo de valor numérico ou DateTime

• prevEval
(Booleano) Se for False ou não especificado, x deverá ser um atributo, e DeltaValue
retornará a diferença entre seu valor atual e valor imediatamente anterior.
Se for True, DeltaValue retornará a diferença entre a avaliação atual e a imediatamente
anterior de x, que podem ser qualquer expressão com um tipo de valor numérico ou
DateTime.

Retornos
Retorna a diferença entre o valor atual e o valor imediatamente anterior de um atributo com
um tipo de valor numérico ou DateTime ou a diferença entre a avaliação atual e a
imediatamente anterior para qualquer expressão com um tipo de valor numérico ou DateTime.

322 Guia do Usuário do PI System Explorer

 Análises de ativo

Notas
Quando x for do tipo de dados DateTime, DeltaValue retornará o intervalo de tempo (em
segundos) entre dois valores DateTime. Se o valor de intervalo de tempo resultar em um
atributo, certifique-se de que o tipo de dados do atributo esteja configurado como duplo.
Essa função pode usar valores de entrada de tags do PI. Se a compressão estiver ativada em
uma tag do PI, todos os seus valores podem não ser preservados no PI Data Archive. Antes de
tentar validar os resultados dessa função usando uma ferramenta cliente como o PI DataLink,
certifique-se de que a compressão esteja OFF (DESATIVADA) para as tags do PI associadas para
incluir todos os valores para validação. Quando a validação for concluída, ative a compressão
novamente como uma boa prática.
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• DeltaValue('att1' [, FALSE])
[Retorne a diferença entre o valor atual e o valor imediatamente anterior de 'att1']
• DeltaValue('att1', TRUE)
[Retorne a diferença entre o valor avaliado atual e o último de 'att1']

DigState
Converta uma string em um objeto de estado digital do PI Data Archive correspondente com
base na enumeração do estado digital do atributo ou nos valores do conjunto de enumeração
do sistema (por exemplo, Calc Failed). Use DigState incorporado em outras funções
quando o objeto de estado digital do PI Data Archive é necessário para a entrada (como com
StateNo) ou em conjunção com outras funções para comparação com atributos do estado
digital.

Sintaxe
DigState(s1 [, x])

Argumentos
• s1
Uma string que representa um estado digital, entre aspas duplas

• x
Opcional: Um atributo com referência do estado digital da tag do PI ou do conjunto de
enumeração do tipo de valor. Se omitido, somente o conjunto digital do sistema será
pesquisado na string fornecida.

Retornos
Um valor de enumeração

Exceções
Se a string não representar um estado digital do atributo especificado, a função retornará Calc
Failed. Se o atributo for omitido e a string não representar um estado digital do sistema, Calc
Failed será retornado.

Exemplo
• 'att1' > DigState("Program", 'att1')

Guia do Usuário do PI System Explorer 323

Análises de ativo

[Retornará True se o estado digital atual de 'att1' for maior que o estado digital
representado pelo valor "Program"]
• DigState("No Result")
[Construa um valor com o estado digital do sistema No Result]

DigText
Obtém o texto correspondente ao estado digital.

Sintaxe
DigText(digstate)

Argumentos
• digstate
Um argumento avaliado como um estado digital

Retornos
O texto para o estado digital

Exceções
Retorna um erro se o argumento não for um estado digital

Exemplo
• DigText(TagVal('enum_att1', 'y')) [Returns the digital state value in string]
• DigText('enum_att1')
[Retorna o valor do estado digital em string. Retornará uma mensagem de erro se
'enum_att1' não for um atributo da tag do PI com valor do estado digital]

E
Retorne o valor para e (a base do logaritmo natural).

Sintaxe
E()

Argumentos
Nenhum

Retornos
O valor para e (a base do logaritmo natural).

Exceções
Nenhum

Exemplo
• E()

324 Guia do Usuário do PI System Explorer

 Análises de ativo

ELSE
Retorne o segundo de dois valores especificados na instrução IF-THEN-ELSE se a expressão
condicional for 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 de saída

Retornos
x quando a expressão condicional é verdadeira e y quando a expressão é falsa

Exceções
Nenhum

Exemplo
• IF ('att1' > 50) THEN ('att2') ELSE ('att3')

EventCount
Encontre o número de eventos válidos para um atributo durante um intervalo de tempo
especificado.

Sintaxe
EventCount(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Percentual mínimo de valores válidos para eventos dentro do intervalo de tempo
especificado.

Guia do Usuário do PI System Explorer 325

Análises de ativo

Retornos
Número de eventos válidos para o atributo durante um intervalo de tempo especificado.

Exceções
Se não houver valores válidos ou se o mínimo de pctgood não for atingido para o intervalo de
tempo especificado, será retornado um erro.

Notas
Valores inválidos são excluídos do cálculo EventCount.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• EventCount('att1', 't', '+1h')
[Retorne a contagem de eventos entre 0h e 1h de hoje.]
• EventCount('att1', 't', '+1h', 80)
[Retorne a contagem de eventos entre 0h e 1h de hoje quando pelo menos 80% dos valores
eram válidos.]

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
Deve ser um número inteiro ou real.

Retornos
O exponencial de x.

Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.

Exemplo
• Exp(11) [Returns 59874]
• Exp('att1') [Return the exponential of the value of 'att1' at time of
evaluation]
• Exp(TagVal('att1','t')) [Return the exponential of the value of 'att1' at the
start of day today]

326 Guia do Usuário do PI System Explorer

 Análises de ativo

FindEq
Encontre o primeiro momento em um intervalo de tempo no qual um atributo é igual a um
valor especificado.

Sintaxe
FindEq(attname, starttime, endtime, x)

Argumentos
• attname
nome de um atributo, entre aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
O valor a ser pesquisado; deve ser um número inteiro ou real ou um estado digital (string de
caracteres)

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo
foi igual ao valor especificado

Exceções
Se o atributo nunca tiver sido igual ao valor especificado, um valor com erro será retornado

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo foi igual ao valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para
frente.

Exemplo
• FindEq('att1', '-1h', '*', 40)
[Retorne o timestamp da primeira vez, desde uma hora atrás, em que 'att1' foi igual a 40]
• FindEq('enum_att1', '30-March-17', '*', "On")
[Retorne o timestamp da primeira vez, desde o início do dia (0h) em 30 de março de 2017,
em que 'enum_att1' do valor de enumeração foi igual a "On"]

FindGE
Encontre o primeiro momento em um intervalo de tempo no qual um atributo foi maior que ou
igual a um valor especificado.

Guia do Usuário do PI System Explorer 327

Análises de ativo

Sintaxe
FindGE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
O valor a ser pesquisado; deve ser um número inteiro ou real ou um estado digital (string de
caracteres).

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo
foi maior que ou igual ao valor especificado.

Exceções
Se o atributo sempre foi menor que o valor especificado, um valor com erro será retornado.

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo foi maior ou igual ao valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para
frente.

Exemplo
• FindGE('att1', 'y', '+2h', 40)
[Retorne o timestamp entre meia-noite e 2h de ontem quando 'att1' foi maior que ou igual a
40 pela primeira vez.]

FindGT
Encontre o primeiro momento em um intervalo de tempo no qual um atributo foi maior que
um valor especificado.

Sintaxe
FindGT(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo, entre aspas simples.

328 Guia do Usuário do PI System Explorer

 Análises de ativo

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
O valor a ser pesquisado; deve ser um número inteiro ou real ou um estado digital (string de
caracteres).

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo
foi maior que o valor especificado.

Exceções
Se o atributo nunca foi maior que o valor especificado, um valor com erro será retornado.

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo foi maior que o valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para
frente.

Exemplo
• FindGT('att1', 't', '*', 40)
[Retorne o timestamp da primeira vez, após a meia-noite de hoje, em que 'att1' foi maior
que 40]
• FindGT('att1', '-1h', '*', TagVal('att1', 'y+18h'))
[Retorne o timestamp da primeira vez, desde uma hora atrás, em que o valor de 'att1' foi
maior que o seu valor às 18h de ontem]

FindLE
Encontre o primeiro momento em um intervalo de tempo no qual um atributo foi menor que
ou igual a um valor especificado.

Sintaxe
FindLE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

Guia do Usuário do PI System Explorer 329

Análises de ativo

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
O valor a ser pesquisado; deve ser um número inteiro ou real ou um estado digital (string de
caracteres).

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo foi
menor ou igual ao valor especificado.

Exceções
Se o atributo sempre foi maior que o valor especificado, um valor com erro será retornado.

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo foi igual ao valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para frente.

Exemplo
• FindLE('att1', 't', '*', 40)
[Retorne o timestamp da primeira vez após a meia-noite de hoje em que att1 foi menor que
ou igual a 40.]

FindLT
Encontre o primeiro momento em um intervalo de tempo no qual um atributo foi menor que
um valor especificado.

Sintaxe
FindLT(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
Deve ser um número inteiro ou real ou um estado digital (string de caracteres); o valor a ser
pesquisado

330 Guia do Usuário do PI System Explorer

 Análises de ativo

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo
foi menor que o valor especificado.

Exceções
Se o atributo era menor que o valor especificado, um valor com erro será retornado.

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo foi menor que o valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para
frente.

Exemplo
• FindLT('att1', 'y', 't', 40)
[Retorne o timestamp da primeira vez após a meia-noite de ontem e a meia-noite de hoje
em que 'att1' foi menor que 40.]
• FindLT('att1', '-1h', '*', TagVal('att1', 'y+18h'))
[Retorne o timestamp da primeira vez, desde uma hora atrás, em que o valor de 'att1' foi
menor que o seu valor às 18h de ontem]

FindNE
Encontre o primeiro momento em um intervalo de tempo no qual um atributo não é igual a um
valor especificado. Eventos "No Data" serão ignorados.

Sintaxe
FindNE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "-3h") em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como "+1h") em referência a um starttime absoluto

• x
O valor a ser pesquisado; deve ser um número inteiro ou real ou um estado digital (string de
caracteres).

Retornos
O timestamp mais próximo a starttime, dentro do intervalo especificado, no qual o atributo
não foi igual ao valor especificado. Eventos "No Data" serão ignorados.

Guia do Usuário do PI System Explorer 331

Análises de ativo

Exceções
Se o atributo sempre foi igual ao valor especificado, um valor com erro será retornado.

Notas
• Se necessário, a interpolação será feita entre valores de atributo para determinar quando o
atributo não foi igual ao valor especificado.
• Se endtime for anterior a starttime, o intervalo de tempo será pesquisado de trás para
frente.

Exemplo
• FindNE('att1', '-1h', '*', 40)
[Retorne o timestamp da primeira vez, desde uma hora atrás, em que 'att1' não foi igual a
40]
• FindNE('enum_att1', '30-March-17', '*', "On")
[Retorne o timestamp da primeira vez, desde o início do dia (0h) em 30 de março de 2017,
em que 'enum_att1' do valor de enumeração não foi igual a "On"]

Float
Converte uma string em um número.

Sintaxe
Float(x)

Argumentos
• x
Uma string, um número ou um atributo cujo valor é avaliado como um número na hora da
avaliação

Retornos
Um número para uma string numérica. Se x já é um número, x é retornado.

Exceções
Se x não é um número ou uma string numérica, Calc Failed é retornado.

Notas
A unidade de medida do argumento, se existir, é transferida para o resultado. Float também
considera timespan e boolean como argumentos. No entanto, observe que Float apenas
converte o formato timespan no número de segundos a partir de 0h de 1º de janeiro de 1970.

Exemplo
• Float("12.3") = 12.3 [Converts string to a number and returns 12.3]
• Float(12.3) = 12.3 [Returns 12.3]
• Float('*') [Returns total number of seconds passed since Jan 1, 1970]

Floor
Retorne o número inteiro mais próximo menor que ou igual a x.

332 Guia do Usuário do PI System Explorer

 Análises de ativo

Sintaxe
Floor(x)

Argumentos
• x
Número inteiro ou real ou um atributo cujo valor é avaliado como um número na hora da
avaliação

Retornos
O número inteiro mais próximo menor que ou igual a x.

Exceções
Retornará um erro se x for um estado digital, uma expressão de tempo, um intervalo de tempo
ou uma string

Notas
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• Floor(3.14) [Returns 3]
• Floor(-3.14) [Returns -4]
• Floor(TagVal('att1', '*'))

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!)

Guia do Usuário do PI System Explorer 333

Análises de ativo

Frac
Retorna a parte fracionada de um número real. Retorna 0 para inteiros.

Sintaxe
Frac(x)

Argumentos
• x
Deve ser um número inteiro ou real

Retornos
A parte fracionada de x.

Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.

Notas
Por definição: Int(x) + Frac(x) = x
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• Frac(1) [Returns 0]
• Frac(1.3) [Returns 0.3]
• Frac(TagVal('att1', '*'))
[Retorne a parte fracionada do valor de 'att1' na hora atual.]

HasChanged
Retorna True se um atributo tem um evento no período de tempo especificado. Caso contrário,
retorna False.

Sintaxe
HasChanged(attname, t1)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• t1
O início de um período de tempo que termina no tempo de execução; pode ser qualquer
expressão de tempo relativa entre aspas simples (como 't - 4h').

Retornos
True se attname tiver um evento no período de tempo especificado. Caso contrário, retorna
False.

334 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• HasChanged('att1', 't-4h')
[Retorne True se 'att1' recebeu quaisquer atualizações desde as 20h da noite passada,
independentemente de a atualização ter alterado ou não o valor real do atributo]

HasValueChanged
Determine se o valor de um atributo ou expressão mudou desde a última avaliação durante
uma análise.

Sintaxe
HasValueChanged(x)

Argumentos
• x
atributo ou expressão

Retornos
True se o valor de x foi alterado desde a última avaliação durante a análise. Caso contrário,
retorna False.
Se x for uma expressão que essa função ainda não avaliou durante a análise, então a função
retornará False.
Se x for um atributo que essa função ainda não avaliou durante a análise, então a função
procurará o valor anteriormente registrado e comparará o valor atual ao valor anterior. Se não
houver valor anterior, a função retornará False.

Notas
Se o PI Analysis Service for reiniciado durante uma análise, as alterações anteriores serão
perdidas.

Exemplo
• HasValueChanged('att1')
[Retorne True se o valor de att1 foi alterado desde a última avaliação durante a análise]
• HasValueChanged('att1'+'att2')
[Retorne True se o valor da soma de att1 e att2 foi alterado desde a última avaliação
durante a análise]

Hour
Extrai a hora de uma expressão de tempo.

Sintaxe
Hour(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples.

Guia do Usuário do PI System Explorer 335

Análises de ativo

Retornos
A hora, no intervalo 0-23.

Exceções
Nenhum

Exemplo
• Hour('*')
[Retorne a porção de hora da hora atual.]
• Hour('Saturday')
[Retorna 0.]
• Hour(FindEq('att1', '-1d', '*', 50))
[Retorne a hora em que o valor de 'att1' foi igual a 50 pela primeira vez nas últimas 24
horas.]

IF
Introduza a condição na instrução IF-THEN-ELSE. Retorne o primeiro de dois valores
especificados se a expressão for verdadeira. Caso contrário, retorne o segundo valor.

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 de saída

Retornos
x quando a expressão condicional é verdadeira (diferente de zero) e y quando a expressão é
falsa (zero)

Exceções
Nenhum

Exemplo
• IF ('att1' > 50) THEN ('att2') ELSE ('att3')

InStr
Retorne o local em uma string em que uma correspondência de substring é encontrada pela
primeira vez.

Sintaxe
InStr([start,] s1, s2 [,caseSensitive])

336 Guia do Usuário do PI System Explorer

 Análises de ativo

Argumentos
• start
Opcional: Um número inteiro que especifica o caractere em s1 para iniciar a comparação.
Deve ser maior que ou igual a 1.

• s1, s2
Duas strings a serem comparadas.

• caseSensitive
Opcional: Uma flag que indica se a comparação é sensível a maiúsculas e 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 a partir da posição de início; caso contrário, o
local do caractere em que s2 corresponde primeiro aos caracteres em s1 a partir da posição de
início.

Exceções
Caracteres coringas não são tratados como caracteres coringas.

Exemplo
• InStr("What", "At")
[Retorna 3]
• InStr("What What What", "What")
[Retorna 1]
• InStr("what", "At", 1)
[Retorna 0]
• InStr(4, "what", "At")
[Retorna 0]
• InStr('att1', "Error")
[Retorna 1 se o valor de att1 for "Error"]

IN
Retorne True se um valor estiver incluso em um conjunto ou intervalo de valores inclusivos.
Caso contrário, retorne False.

Sintaxe
x In (y1, y2)
x In (y1...yn)

Argumentos
• x
valor numérico ou string

Guia do Usuário do PI System Explorer 337

Análises de ativo

• y1
valor numérico que indica o início de um intervalo

• y2
valor numérico que indica o fim de um intervalo

• y1...yn
conjunto de valores numéricos

Retornos
True quando x estiver incluso em um conjunto ou intervalo de valores

Exceções
Nenhum

Exemplo
• 1 In (9, 10) [Returns False since 1 is not included in the range of 9 to 10.]
• 2 In (1...10) [Returns True since 2 is included in the range of 1 to 10.]

Int
Retorna a parte inteira de um número inteiro ou real.

Sintaxe
Int(x)

Argumentos
• x
Número, booleano, string numérica, período de tempo ou um atributo cujo valor é avaliado
como um número na hora da avaliação

Retornos
Se x for um número, será retornada a parte inteira de x. Se x for uma string, ele será primeiro
convertido em número. Se x for um timespan, será retornado o número de segundos a partir de
0h de 1 de janeiro de 1970.

Exceções
Retorna erro se a variável não estiver atribuída

Notas
Int('*') retorna hora UTC em segundos a partir de 0h de 1 de janeiro de 1970.

Exemplo
• Int('att1')
[Retorne a parte inteira do valor de 'att1' na hora atual.]
• Int('*'-'t')
[Retorne quantos segundos se passaram desde o início do dia de hoje.]
• Int(2.1)

338 Guia do Usuário do PI System Explorer

 Análises de ativo

[Retorna 2.]
• Int("2.1")
[Primeiro converte a string em número e retorna 2.]
• Int(true)
[Retorna 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, número real, estado digital ou string de
caracteres.

• selecione
Uma string, mas somente o primeiro caractere é considerado. "a" para anotado; "s" para
substituído e "q" para questionável. Não diferencia maiúsculas de minúsculas.

Retorna
1 se for verdadeiro e 0 se não for verdadeiro.

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(s1)

Argumentos
• s1
string

Guia do Usuário do PI System Explorer 339

Análises de ativo

Retornos
Uma string convertida em caixa baixa

Exceções
Se o argumento não for uma string, será retornado um valor de erro.

Exemplo
• LCase("String")
[Retorna "string"]

Left
Retorne um número especificado de caracteres de uma string começando à esquerda.

Sintaxe
Left(s1, len)

Argumentos
• s1
String

• len
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, será retornado um erro.

Exemplo
• Left("String_att", 3)
[Retorna "Str"]

Len
Retorne o comprimento de uma string.

Sintaxe
Len(s1)

Argumentos
• s1
string

Retornos
O comprimento de uma string

340 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Se o argumento não for uma string, será retornado um valor de erro.

Exemplo
• Len("String")
[Retorna 6]
• Len('sinusoid')
[Retorna Calc Failed]

Log
Retorne 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, será retornado um valor de erro.

Exemplo
• Log(14)[Returns 2.6391]
• Log(TagVal('att1', '14-Dec-16'))
[Retorne o log natural do valor de 'att1' à 0h em 14 de dezembro de 2016]

Log10
Retorna o logaritmo de base 10 de um número inteiro ou real.

Sintaxe
Log10(x)

Argumentos
• x
Deve ser um número inteiro ou real maior que zero.

Retornos
O logaritmo de base 10 de x.

Exceções/erros
Se x for zero ou um número negativo ou não for um número, será retornado um valor de erro.

Guia do Usuário do PI System Explorer 341

Análises de ativo

Exemplo
• Log10(100) [Returns 2]
• Log10(TagVal('att1', '14-Dec-16'))
[Retorne o logaritmo de base 10 do valor de 'att1' à 0h em 14 de dezembro de 2016]

Logbase
Retorne o logaritmo de valor numérico positivo x para uma base especificada y.

Sintaxe
Logbase(x,y)

Argumentos
• x
Um número inteiro ou real maior que zero

• y
Um positivo inteiro que indica a base do logaritmo

Retornos
O logaritmo de x para a base y.

Exceções
Se x for zero ou um número negativo ou não for um número, será retornado um valor de erro.

Exemplo
• Logbase(256, 2) [Returns 8]
• Logbase(1000, 10) [Returns 3]
• Logbase(TagVal('att1', '14-Dec-16'), 16)
[Retorne o logaritmo do valor de 'att1' à 0h em 14 de dezembro de 2016 para a base 16]

LTrim
Remove os espaços à esquerda de uma string.

Sintaxe
LTrim(s1)

Argumentos
• s1
string

Retornos
Uma string com espaços à esquerda removidos

Exceções
Se s1 não for uma string, será retornado um valor de erro.

342 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• LTrim(" String")
[Retorna "String"]
• LTrim("String ")
[Retorna "String"]

Max
Retorne o número máximo a partir de um conjunto de valores.

Sintaxe
Max(x1, ... xn)

Argumentos
• x1, ... xn
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Retornos
O número máximo a partir de um conjunto de argumentos. O resultado tem o mesmo tipo de
dados dos argumentos.

Exceções
Argumentos com valores de tempo de execução que são estados digitais são ignorados. Se
todos os valores forem estados digitais, Max retornará um valor de erro.

Notas
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplo
• Max('*', 'y', 'Saturday')
• Max(14, 'att1', 14.5, TagVal('att2','14-Dec-97'))
• Max('*'-'*-1h', 't'-'y', 't'-'20')

Median
Retorne o valor mediano de um ou mais valores.

Sintaxe

Median(x1 [, ... xn])

Argumentos
• x1, [, ... xn]
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Guia do Usuário do PI System Explorer 343

Análises de ativo

Retornos
O valor mediano do(s) argumento(s) de entrada. Se o número de argumentos for par, a média
dos dois valores medianos será retornada.

Exceções
Argumentos com valores de tempo de execução que são estados digitais são ignorados. A
função deve ter um ou mais argumentos avaliados como estados não digitais; caso contrário,
Median retornará um valor de erro.

Notas
Os argumentos devem ser do mesmo tipo de valor. O tipo de dado do primeiro argumento
define o ritmo para os restantes.
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplos
• Median(14, 'att1', 14.5, TagVal('att2', '14-Dec-16'))
[Encontre o valor mediano destes valores: 14, o valor atual de att1, 14,5 e o valor para att2 à
meia-noite de 14 de dezembro de 2016]
• Median('*', 'y', 'Saturday')
[Encontre o valor mediano destes timestamps: agora, 0h de ontem e 0h do sábado passado]
• Median('*'-'*-1h', 't+4h'-'y+8h', 'y+2h'-'20')
[Encontre o valor mediano destes períodos: a partir de 1 hora atrás até este momento, das
8h de ontem até as 4h de hoje e das 2h de ontem até o início do dia (0h) do dia 20 deste
mês]

Mid
Retorna uma substring em uma string.

Sintaxe
Mid(s1, start [,len])

Argumentos
• s1
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
Caracteres len da string à direita do (e inclusive o) primeiro caractere cuja posição é
especificada pelo início.

344 Guia do Usuário do PI System Explorer

 Análises de ativo

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("String", 3)
[Retorna "ring"]
• Mid("String", 3, 2)
[Retorna "ri"]

Min
Retorne o número mínimo a partir de um conjunto de valores.

Sintaxe
Min(x1, ... xn)

Argumentos
• x1, ... xn
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Retornos
O número mínimo a partir de um conjunto de argumentos. O resulto é do mesmo tipo de dado
dos argumentos.

Exceções
Argumentos com valores de tempo de execução que são estados digitais são ignorados. Se
todos os valores forem estados digitais, Min retornará um valor de erro.

Notas
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplo
• Min(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Encontre o valor mínimo destes valores: 14, o valor atual de 'att1', 14,5 e o valor de 'att2'
no início do dia (0h) em 14 de dezembro de 2016]
• Min('*', 'y', 'Saturday')
[Encontre o timestamp mais antigo de um conjunto]
• Min('*'-'*-1h', 't+8h'-'y+4h', 'y'-'20', '*'-'t')
[Encontre o intervalo mais curto destes períodos: de 1 hora atrás até o momento, das 4h de
ontem até hoje às 8h, de 0h de ontem até 0h do dia 20 deste mês e do começo do dia de hoje
(0h) até o momento]

Guia do Usuário do PI System Explorer 345

Análises de ativo

Minute
Extrai o minuto de uma expressão de tempo.

Sintaxe
Minute(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples.

Retornos
O minuto, no intervalo de 0-59.

Exceções
Nenhuma.

Exemplo
• Minute('*')
[Extraia o minuto da hora atual.]
• Minute(FindGT('att1', '-1h', '*', 5)
[Extraia o minuto de um timestamp no qual o valor de 'att1' foi maior que 5 pela primeira
vez na última hora. Retorne erro se ele nunca foi maior que 5.]

Mod
O operador módulo (mod) retorna o lembrete da quantidade de dois valores numéricos. Para x
Mod y, este é o lembrete de x/y.

Sintaxe
x1 Mod x2

Argumentos
• x1
Qualquer expressão avaliada como um valor numérico

• x2
Qualquer valor numérico

Retornos
Lembrete de x/y

Exceções
Nenhum

Notas
A UOM de x, caso exista, é transferida para o resultado.

346 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• 10 Mod 7 [Returns 3]

Month
Extraia o mês de uma determinada expressão de tempo.

Sintaxe
Month(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples

Retornos
O mês, no intervalo 1-12.

Exceções
Nenhum

Exemplo
• Month('*')
[Retorne o mês atual.]
• Month(FindEq('att1', '-10d', '*', 5')
[Retorne o mês a partir de um timestamp no qual o valor de 'att1' foi igual a 5 pela primeira
vez nos últimos 10 dias.]

NextEvent
Encontre o timestamp do próximo valor registrado depois de uma hora especificada.

Sintaxe
NextEvent(attname, t1)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• t1
Uma expressão de tempo

Retornos
O timestamp do próximo valor registrado depois da hora especificada para o atributo
especificado

Exceções
Se não houver valor registrado depois da hora especificada, a função retornará No Data.

Guia do Usuário do PI System Explorer 347

Análises de ativo

Exemplo
• NextEvent('att1', 't')
[Encontre e retorne o timestamp do próximo valor registrado de 'att1' desde o início do dia
(0h) de hoje]

NextVal
Encontre o próximo valor registrado depois de uma hora especificada.

Sintaxe
NextVal(attname, t1)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• t1
Uma expressão de tempo

Retornos
O próximo valor registrado depois da hora especificada para o atributo especificado

Exceções
Se não houver valor registrado depois da hora especificada, a função retornará um erro.

Exemplo
• NextVal('att1', 't')
[Encontre e retorne o próximo valor registrado de 'att1' desde o início do dia (0h) de hoje]

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 simples

Retornos
Um timestamp que corresponde ao meio-dia do dia do tempo de entrada

Exceções
Nenhum

Notas
Esta função é útil para estabelecer o tempo em um relógio exclusivo, independentemente da
duração de determinados dias.

348 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• Noon('*')
[Retorne um timestamp para o meio-dia do dia no qual o valor de 'att1' foi igual a 50 pela
primeira vez nos últimos 3 dias. ]
• Noon(FindEq('att1', '-3d', '*', 50))
[Retorne um timestamp para o meio-dia do dia no qual o valor de 'att1' foi igual a 50 pela
primeira vez nos últimos 3 dias. ]

NoOutput
Não grave o resultado atual do cálculo.

Sintaxe
NoOutput()

Argumentos
Nenhum

Notas
É importante incluir parênteses após esta função (use NoOutput() em vez de NoOutput, pois
NoOutput é uma sintaxe inválida). Essa função é aplicada apenas no cálculo atual.

Exemplo
• If 'att1' < 100 or 'att1' > 200 then 'att1' else NoOutput()

Normalrnd
Retorne um número aleatório que mapeie a curva de distribuição normal usando um valor
mediano e um desvio padrão especificados.

Sintaxe
Normalrnd(x, y)

Argumentos
• x
Um número real que especifica o valor mediano 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 valor mediano e
um desvio padrão especificados

Exceções
Nenhum

Exemplo
• Normalrnd(300, 2.5)

Guia do Usuário do PI System Explorer 349

Análises de ativo

NOT
Retorne a negação de uma expressão. Retorne True se o valor da verdade de uma expressão
for falso, e False se o valor da verdade de uma expressão for verdadeiro.

Sintaxe
NOT expression

Argumentos
• expression
Qualquer expressão avaliada como verdadeira ou falsa

Retornos
True quando a expressão é falsa e False quando a expressão é verdadeira

Exceções
Nenhum

Exemplo
• NOT (1 In (1...10)) [Returns False since (1 In (1...10)) is true.]

NumOfChanges
Retorne o número de alterações de valor para um atributo em um intervalo de tempo
especificado.

Sintaxe
NumOfChanges(attname, starttime, endtime)

Argumentos
• attname
O nome de um atributo.

• starttime
A expressão de tempo que especifica o início de um intervalo de tempo, ou um período de
tempo (como '-3h') que especifica a hora de início relativa a endtime; as entradas devem
estar entre aspas simples.

• endtime
A expressão de tempo que especifica o final de um intervalo de tempo, ou um período de
tempo (como '+3h') que especifica a hora de término relativa a startime; as entradas devem
estar entre aspas simples.

Retornos
A contagem de alterações no valor para attname no intervalo de tempo especificado.

Exemplo
• NumOfChanges('att1', 't', '*') [Return the number of times the value of 'att1'
changed since midnight until now]

350 Guia do Usuário do PI System Explorer

 Análises de ativo

OR
Disjunção lógica de duas expressões que retornará True se as expressões forem verdadeiras, e
False se ambas forem falsas.

Sintaxe
expression1 OR expression2

Argumentos
• expression1
Qualquer expressão avaliada como verdadeira ou falsa

• expression2
Qualquer expressão avaliada como verdadeira ou falsa

Retornos
True se uma das expressões for verdadeira e False se ambas forem falsas

Exceções
Nenhum

Exemplo
• ('att1' > 50) OR ('att2' = "good")

ParseTime
Traduz uma expressão de tempo PI para um timestamp. Use uma expressão de tempo regular,
entre aspas simples, para melhor desempenho.

Sintaxe
ParseTime(s1)

Argumentos
• s1
Uma string de caracteres no formato de tempo do PI, entre aspas duplas

Retornos
O timestamp correspondente a s1.

Exceções
Se s1 não for uma string de caracteres ou se não houver um erro de sintaxe, um valor de erro
será retornado.

Notas
Não há diferenças entre ParseTime("14-Nov-92") e a expressão de tempo '14-Nov-92',
exceto que a chamada ParseTime leva mais tempo. 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 você gravar ParseTime('14-Nov-92') (entre aspas simples, não duplas), o analisador
detectará um erro, pois a expressão entre aspas simples já estará traduzida para um timestamp
no tempo de compilação.

Guia do Usuário do PI System Explorer 351

Análises de ativo

A expressão ParseTime(":12:00:00") não é a mesma que a 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(Concat("12", "-31", "-16"))
[Retorna 12/31/2016 12:00:00 AM, que é o mesmo que '12/31/16'.]
• ParseTime("14-Dec-16")
[Processa o mesmo resultado como '14-Dec-16'. Use apenas quando operações de string
forem necessárias.]
• ParseTime("*")
[Processa o mesmo resultado como '*'. Use apenas quando operações de string forem
necessárias.]

PctGood
Encontre o percentual de tempo, em um intervalo de tempo especificado, no qual o atributo
teve valores válidos.

Sintaxe
PctGood(attname, starttime, endtime)

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

Retornos
Um número inteiro ou real de 0 a 100: o percentual do tempo especificado no qual o atributo
teve valores válidos

Exemplo
• PctGood('att1', 't', '+1h')
[Retorne o percentual de tempo entre 0h e 1h de hoje no qual 'att1' teve valores válidos]
• PctGood('att1', '-1h', '*')
[Retorne o percentual de tempo entre agora e uma hora atrás de hoje no qual 'att1' teve
valores válidos]

352 Guia do Usuário do PI System Explorer

 Análises de ativo

Pi
Retona o valor do pi.

Sintaxe
Pi()

Argumentos
•

Retornos
O valor do pi

Exceções
Nenhuma.

Exemplo
• Pi()

Poisson
Retorna um número aleatório que mapeia uma distribuição Poisson com um valor mediano
específico.

Sintaxe
Poisson(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Retornos
Um número aleatório que mapeia uma distribuição Poisson com um valor mediano
especificado.

Exceções
Nenhuma.

Exemplo
• Poisson(15)

Poly
Avalie a equação polinomial c0 + c1x + c2x2 + … +cnxn.

Sintaxe
Poly(x, c0 [, ... cn])

Argumentos

Guia do Usuário do PI System Explorer 353

Análises de ativo

• x
Variável. Um número inteiro ou real

• c0 [, ... cn]
Coeficientes. Deve ter pelo menos um coeficiente. Todos devem ser números.

Retornos
O valor da equação polinomial

Exceções
Se x ou qualquer coeficiente não for um número inteiro ou real, Poly retornará um valor de
erro.

Exemplo
• Poly(3, 4, 5) [Returns 19]
• Poly('att1', 2, 3)

Pow
Retorne x elevado à potência de y.

Sintaxe
Pow(x, y)

Argumentos
• x
valor numérico

• y
valor numérico

Retornos
O valor de x elevado à potência de y.

Exceções
Nenhum

Notas
• A função Pow funciona apenas no PI Asset Framework (PI AF) Asset Analytics. Use o
operador de caractere (^) para mesmo efeito no PI Data Archive Performance Equations.
• Ambos Pow(2, 3) e 2^3 são aceitos nas análises do PI AF.

Exemplo
• Pow(2, 3) [Returns 8]
• Pow(2.5, 3) [Returns 15.625]
• Pow(TagVal('att1', '*'), 8)

354 Guia do Usuário do PI System Explorer

 Análises de ativo

PrevEvent
Encontre o timestamp do último valor registrado depois de uma hora especificada.

Sintaxe
PrevEvent(attname, t1)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• t1
Uma expressão de tempo

Retornos
O timestamp do último valor registrado antes da hora especificada para o atributo especificado

Exceções
Se não houver valor registrado antes da hora especificada, a função retornará um erro.

Exemplo
• PrevEvent('att1', '*')
[Encontre o timestamp do último valor registrado de 'att1' antes da hora atual]

PrevVal
Encontre o último valor registrado antes de uma hora especificada.

Sintaxe
PrevVal(attname, t1)

Argumentos
• attname
O nome de um atributo, entre aspas simples

• t1
Uma expressão de tempo

Retornos
O último valor registrado antes da hora especificada para um atributo especificado

Exceções
Se não houver valor registrado antes da hora especificada, a função retornará um erro.

Exemplo
• PrevVal('att1', '*')
[Encontre e retorne o último valor registrado de 'att1' antes da hora atual]
• PrevVal('att1', '15-Mar-17')

Guia do Usuário do PI System Explorer 355

Análises de ativo

[Encontre e retorne o último valor registrado de 'att1' antes do início do dia (0h) em 15 de
março de 2017]

PStDev
Retorne o desvio padrão da população para uma população de um ou mais valores.

Sintaxe
PStDev(x1 [, ... xn])

Argumentos
• x1, ... xn
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Retornos
O desvio padrão da população para os argumentos. Retornará um valor numérico se os
argumentos forem números. Para argumentos que são expressões de tempo (hora ou período
de tempo), um número que indica um período de tempo expresso em segundos é retornado.
O desvio padrão da população de uma população x1, ..., xn é

em que é a média dos argumentos, ou seja,

Exceções
Argumentos com valores de tempo de execução que são estados digitais são ignorados. Se
todos os valores forem estados digitais, um valor de erro será retornado.

Notas
PStDev usa cada valor em uma população para calcular o desvio padrão da população. No
entanto, é comum, especialmente para uma população grande, estimar o desvio padrão de uma
amostra da população. SStDev usa um conjunto de valores de amostra para calcular o desvio
padrão da amostra, que se aproxima do desvio padrão da população.
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplo
• PStDev(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Retorne o "desvio padrão da população" destes valores: 14, o valor atual de 'att1', 14,5 e o
valor para 'att2' no início do dia (0h) em 14 de dezembro de 2016]
• PStDev('*', 'y', 'Saturday')

356 Guia do Usuário do PI System Explorer

 Análises de ativo

[Retorne o "desvio padrão da população" desses timestamps.]

• PStDev('*'-'*-1h', 't+8h'-'y+4h', 'y'-'20', '*'-'t')
[Retorne o "desvio padrão da população" destes períodos: de 1 hora atrás até o momento,
das 4h de ontem até hoje às 8h, de 0h de ontem até 0h do dia 20 deste mês e do começo do
dia de hoje (0h) até o momento]

Rand
Retorne um número aleatório entre 0 e 1. Para valores x e y especificados, retorne um número
aleatório entre x - y/2 e x + y/2.

Sintaxe
Rand(x, y)

Argumentos
• x
Um número real que especifica o ponto central do intervalo

• y
Um número real que especifica o tamanho do intervalo.
Se nenhum argumento for especificado, o intervalo padrão será de 0 a 1.

Retornos
Um número aleatório entre 0 e 1. Para valores x e y especificados, retorna um número aleatório
entre x - y/2 e x + y/2.

Exceções
Nenhum

Exemplo
• Rand()
• Rand(500, 250)

Range
Encontre a diferença entre os valores máximo e mínimo para um atributo durante um período
de tempo especificado.

Sintaxe
Range(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

Guia do Usuário do PI System Explorer 357

Análises de ativo

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: O percentual de tempo mínimo em um determinado intervalo de tempo indicando
que os valores de atributo devem ser válidos.

Retornos
A diferença entre os valores máximo e mínimo do atributo durante o tempo especificado.

Exceções
Se o atributo não tiver valores válidos ou o mínimo de pctgood não for atingido para o intervalo
de tempo especificado, será retornado um erro.

Notas
Valores inválidos são excluídos do cálculo Range.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• Range('att1', 't', '+1h')
[Retorne a diferença entre os valores máximo e mínimo para 'att1' entre 0h e 1h de hoje.]
• Range('att1', 't', '+1h', 80)
[Retorne a diferença entre os valores máximo e mínimo para 'att1' entre 0h e 1h de hoje
quando pelo menos 80% dos valores eram válidos.]

Rate
Retorne a diferença ao longo do tempo entre o valor atual e um valor avaliado anteriormente
de um atributo ou expressão (de tempo).

Sintaxe
Rate(x)

Argumentos
• x
Um atributo ou expressão (de tempo) resolvido como um valor numérico

358 Guia do Usuário do PI System Explorer

 Análises de ativo

Retornos

• A diferença calculada, usando o valor do atributo, numérico ou de timestamp do parâmetro

da expressão, de acordo com essa fórmula (valor atual – valor avaliado anteriormente)/
(timestamp atual – timestamp avaliado anteriormente).

Exemplo
• Rate(‘att1’)
• Rate('sinusoid')
• Rate(DaySec(‘*’) + 1)

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
Qualquer valor numérico diferente de zero

• y
Qualquer valor numérico

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
Nenhum

Notas
A unidade de medida de x, caso exista, é transferida para o resultado.

Exemplo
• Remainder(11, 3)
[Retorna -1]
• Remainder(10, 3)
[Retorna 1]

Guia do Usuário do PI System Explorer 359

Análises de ativo

Right
Retorne um número especificado de caracteres de uma string, começando pela direita.

Sintaxe
Right(s1, len)

Argumentos
• s1
string

• len
Número inteiro

Retornos
Caracteres len da string a partir da direita

Exceções
Se os argumentos não forem dos tipos solicitados, um valor de erro será retornado.

Exemplo
• Right("String", 3)
[Retorna "ing"]
• Right("String", 20)
[Retorna "String"]

Round
Arredonda um número ou tempo para a unidade mais próxima.

Sintaxe
Round(x [, unit])

Argumentos
• x
Números inteiros e reais, expressões de tempo ou intervalos 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 de tempo, a unidade
deverá ser uma expressão de tempo. Se a unidade for omitida, Round arredondará para o
número inteiro par mais próximo (para números) ou para o segundo mais próximo (para
expressões de tempo).

Retornos
O valor mais próximo de x que seja um número inteiro múltiplo da unidade. Retorna o mesmo
tipo de dados que x. Para obter mais detalhes, consulte os exemplos a seguir.

360 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Se x for uma string, ou se unidade for de um tipo de dado incorreto, um valor de erro será
retornado.

Notas
O sistema usa um arredondamento bancário, que arredonda um número para o inteiro par
mais próximo.
Se x for um tempo, e a unidade for omitida, esta prática não terá efeito: tempos só são precisos
ao nível do segundo.
A unidade de medida do argumento, caso exista, é transferida para o resultado.

Exemplo
• Round(12.499)
[Retorna 12 (arredondado para o inteiro mais próximo)]
• Round(12.5)
[Retorna 12 (arredondado para o inteiro par mais próximo)]
• Round (13.5)
[Retorna 14 (arredondado para o inteiro mais próximo)]
• Round(123.8, 10)
[Retorna 120 (arredondado para a dezena mais próxima)]
• Round('14-Dec-97 11:47:16')
[Retorna 14-Dec-97 11:47:16 (arredondado para o segundo mais próximo)]
• Round('14-Dec-97 11:47', '+1h')
[Retorna 14-Dec-97 12:00:00 (arredondado para a unidade especificada mais próxima, isto
é, hora)]
• Round('18:47:15'-'15:00:09')
[Retorna 03:47:06 (arredondado para o segundo mais próximo)]
• Round('18:47'-'15:00', '+1m')
[Retorna 03:47:00 (arredondado para a unidade especificada mais próxima, isto é, minuto)]
Nota:
A função Round para o dia mais próximo resulta em um timestamp do dia mais próximo
em tempo UTC, não no tempo 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.

Guia do Usuário do PI System Explorer 361

Análises de ativo

• y
O número inteiro que especifica o número de casas decimais a serem usadas para
arredondar x.

Retornos
O valor de x arredondado em y casas decimais. Retorna o mesmo tipo de dados que 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 dado incorreto, um valor de erro será
retornado.

Notas
A unidade de medida do argumento, caso exista, é transferida para o resultado.
Se x for um tempo, e a unidade for omitida, esta prática não terá efeito: tempos só são precisos
ao nível do segundo.

Exemplo
• Roundfrac (Pi(), 4)
[Retorna 3,1416]
• Roundfrac (TagVal('att1'), 2)
[Retorna o valor de 'att1' arredondado em 2 casas decimais]

RTrim
Corta os espaços à esquerda de uma string.

Sintaxe
RTrim(s1)

Argumentos
• s1
string

Retornos
A string de origem com os espaços brancos à direita removidos.

Exceções
Se s1 não for uma string, será retornado um valor de erro.

Exemplo
• RTrim("String ")
[Retorna "String"]
• RTrim(" String")
[Retorna "String"]

362 Guia do Usuário do PI System Explorer

 Análises de ativo

Sec
Retorna a secante trigonométrica de um número.

Sintaxe
Sec(x)

Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radianos.

Retornos
A secante de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Sec(1) [Returns 1.8508]
• Sec(1.1) [Returns 2.2046]
• Sec('att1') [Return the trigonometric secant of the value of 'att1' at time of
evaluation]

Sech
Retorna a secante hiperbólica de um número.

Sintaxe
Sech(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Retornos
A secante hiperbólica de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Sech(1) [Returns 0.64805]
• Sech(1.1) [Returns 0.59933]
• Sech('att1') [Return the hyperbolic secant of the value of 'att1' at time of
evaluation]

Second
Extrai o segundo de uma expressão de tempo.

Guia do Usuário do PI System Explorer 363

Análises de ativo

Sintaxe
Second(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples.

Retornos
O segundo, no intervalo 0-59.

Exceções
Nenhuma.

Exemplo
• Second('*')
[Retorne o segundo da hora atual.]
• Second(FindEq('att1', '-1m', '*', 2)
[Retorne o segundo a partir de um timestamp quando o valor de 'att1' foi igual a 2 pela
primeira vez no último minuto.]

SecSinceChange
Retorne o tempo em segundos desde que um valor de atributo foi atualizado.

Sintaxe
SecSinceChange(attname)

Argumentos
• attname
O nome de um atributo, entre aspas simples.

Retornos
O número de segundos desde a última atualização do valor para um atributo.

Exemplo
• SecSinceChange('att1')
[Retorne o número de segundos desde a atualização do valor de 'att1']

Sgn
Retorna um indicador do sinal numérico de um número.

Sintaxe
Sgn(x)

Argumentos
• x
Deve ser um número inteiro ou real.

364 Guia do Usuário do PI System Explorer

 Análises de ativo

Retornos
-1 se x < 0; 0 se x = 0; 1 se x > 0

Exceções
Se x não for um número inteiro ou real, um valor de erro será retornado.

Exemplo
• Sgn(1.1) [Returns 1]
• Sgn(0) [Returns 0]
• Sgn(-0.1) [Returns -1]
• Sgn('att1') [Returns 1 if the value of 'att1' is positive, 0 if it equals 0,
and -1 if it is negative]

Sin
Retorna o seno trigonométrico de um número.

Sintaxe
Sin(x)

Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radianos.

Retornos
O seno de x

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Sin(1) [Returns 0.84147]
• Sin(1.1) [Returns 0.89121]
• Sin('att1') [Return the trigonometric sine of the value of 'att1' at time of
evaluation]

Sinh
Retorna o seno hiperbólico de um número.

Sintaxe
Sinh(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Guia do Usuário do PI System Explorer 365

Análises de ativo

Retornos
O seno hiperbólico de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Sinh(1) [Returns 1.1752]
• Sinh(1.1) [Returns 1.3356]
• Sinh('att1') [Return the hyperbolic sine of the value of 'att1' at time of
evaluation]

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(2) [Returns 1.4142]
• Sqr(2.1) [Returns 1.4491]
• Sqr('att1')[Return square root of the value of 'att1' at time of evaluation]

StateNo
Converta um estado digital em seu valor de enumeração correspondente.

Sintaxe
StateNo(digstate)

Argumentos
• digstate
Um valor de enumeração

Retornos
O deslocamento no conjunto de estados digitais que corresponde a digstate

366 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Se uma tag for passada como digstate que seja diferente de uma tag digital, um valor de erro
será retornado.

Notas
Um estado digital pode aparecer mais de uma vez na tabela de estados digitais. Nesse caso, o
valor que StateNo retorna pode variar. Se digstate for o valor de uma tag digital, StateNo
retornará um número de código apropriado para tal tag.

Exemplo
• StateNo(DigState("No Data")) [Returns 248]
• StateNo(TagVal('enum_att1', '*-1h'))
[Retorne o número do estado digital correspondente ao valor de 'enum_att1' uma hora
atrás]

SStDev
Retorne o desvio padrão da amostra de dois ou mais argumentos que sejam uma amostra de
uma população maior.

Sintaxe
SStDev(x1, x2 [, ... xn])

Argumentos
• x1, ... xn
Argumentos do mesmo tipo de valor (números inteiros e reais, expressões de tempo ou
intervalos de tempo)

Retornos
O desvio padrão da amostra para os argumentos. Retornará um valor numérico se os
argumentos forem números. Para argumentos que são expressões de tempo (hora ou período
de tempo), um número que indica um período de tempo expresso em segundos é retornado.
O desvio padrão de uma amostra x1, ...xn é igual a

Em que é a média da amostra, ou seja,

Exceções
Argumentos com valores de tempo de execução que são estados digitais são ignorados. Se não
houver pelo menos dois valores numéricos, SStDev retorna um zero.

Guia do Usuário do PI System Explorer 367

Análises de ativo

Notas
No caso raro em que você tem a população inteira, e não apenas a amostra, você deve usar a
função PstDev em vez de SStDev.
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplo
• SStDev(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Retorne o "desvio padrão da amostra" destes valores: 14, o valor atual de 'att1', 14,5 e o
valor para 'att2' no início do dia (0h) em 14 de dezembro de 2016]
• SStDev('*', 'y', 'Saturday')
[Retorne o "desvio padrão da amostra" desses timestamps.]
• SStDev('*'-'*-1h', 't+8h'-'y+4h', 'y'-'20', '*'-'t')
[Retorne o "desvio padrão da amostra" destes períodos: de 1 hora atrás até o momento, das
4h de ontem até hoje às 8h, de 0h de ontem até 0h do dia 20 deste mês e do começo do dia
de hoje (0h) até o momento]

StDev
Encontre o desvio padrão ponderado no tempo dos valores para um atributo em um intervalo
de tempo especificado.

Sintaxe
StDev(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Percentual mínimo de tempo durante o intervalo especificado em que os valores
de atributo devem ser válidos.

Retornos
O desvio padrão ponderado no tempo dos valores para um atributo em um intervalo de tempo
especificado.

368 Guia do Usuário do PI System Explorer

 Análises de ativo

Exceções
Se o atributo não tiver valores válidos, ou se o mínimo de pctgood não for atingido para o
intervalo de tempo específico, será retornado um erro.

Notas
Valores inválidos são excluídos do cálculo StDev.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• StDev('att1', 't', '+1h')
[Retorne o desvio padrão ponderado no tempo de valores para 'att1' entre 0h e 1h de hoje.]
• StDev('att1', 't', '+1h', 80)
[Retorne o desvio padrão ponderado no tempo de valores para 'att1' entre 0h e 1h de hoje
no momento em que pelo menos 80% dos valores eram válidos.]

String
Converte qualquer valor em uma string.

Sintaxe
String(x)

Argumentos
• x
Qualquer expressão que seja do tipo de valor do PI normal

Retornos
A string que representa o argumento do valor

Exceções
Nenhum

Exemplo
• String("Hello, PI user!")
[Retorna "Hello, PI user!"]
• String(12.23)
[Retorna "12,23"]
• String('sinusoid')
[Retorna valor atual de 'sinusoid' na string]
• String('*')
[Retorna tempo atual na string]

Guia do Usuário do PI System Explorer 369

Análises de ativo

TagAvg
Encontre a média ponderada no tempo dos valores para um atributo em um intervalo de
tempo especificado.

Sintaxe
TagAvg(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Percentual mínimo de tempo durante o intervalo em que os valores de atributo
devem ser válidos.

Retornos
A média ponderada no tempo dos valores para um atributo em um intervalo de tempo
especificado.

Exceções
Se a tag não tiver valores válidos, ou se o mínimo de pctgood não for atingido para o intervalo
de tempo específico, será retornado um valor com erro.

Notas
Valores inválidos são excluídos do cálculo TagAvg.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• TagAvg('att1', 't', '+1h')
[Retorne a média ponderada no tempo de valores para 'att1' entre 0h e 1h de hoje.]
• TagAvg('att1', 't', '+1h', 80)
[Retorne a média ponderada no tempo de valores para 'att1' entre 0h e 1h de hoje quando
pelo menos 80% dos valores eram válidos.]

370 Guia do Usuário do PI System Explorer

 Análises de ativo

TagBad
Para um atributo associado a uma tag do PI, teste a tag para verificar se houve estado anormal
em um tempo especificado. Se a tag for um número inteiro ou real, qualquer estado digital será
considerado anormal. Para tags digitais, os estados definidos para ela serão normais; todos os
outros serão anormais.

Sintaxe
TagBad(attname [, t1])

Argumentos
• attname
Um atributo associado a uma tag do PI

• time
Opcional: Uma expressão de tempo. Se omitido, o horário atual('*') será usado.

Retornos
False se o estado da tag no horário for normal, True se for anormal.

Exceções
Nenhum

Notas
BadVal pode testar qualquer valor ou expressão; TagBad somente pode testar uma tag do PI.

Exemplo
• TagBad('att1')
[Retorna Verdadeiro se a tag do PI para 'att1' não existir ou seu valor corresponde ao estado
digital do sistema (Nenhum Dado, por exemplo)]
• TagBad('enum_att1', '14-Dec-16')
[Retorna Verdadeiro se a tag do PI para 'enum_att1' não existir ou seu valor corresponde ao
estado digital do sistema (Nenhum Dado, por exemplo) às 0h em 14 de dezembro de 2016]

TagDesc
Para um atributo associado a uma tag do PI, recupere o descritor da tag do PI com base no
banco de dados da tag.

Sintaxe
TagDesc(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

Retornos
O descritor da tag.

Guia do Usuário do PI System Explorer 371

Análises de ativo

Exceções
Se a tag do PI não existir, um valor com erro será retornado.

Exemplo
• TagDesc('sinusoid') [Returns 12 hour sine wave]
• TagDesc('cdt158') [Atmospheric tower OH vapor]

TagEU
Para um atributo associado a uma tag do PI, recupere a string de unidade de engenharia da tag
com base no banco de dados da tag.

Sintaxe
TagEU(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

Retornos
As unidades de engenharia da tag do PI

Exceções
Se a tag do PI não existir, um valor com erro será retornado.

Notas
Retorna em branco quando a tag do PI não tem uma unidade de engenharia.

Exemplo
• TagEU('cdt158') [Returns dec.C]

TagExDesc
Para um atributo associado a uma tag do PI, recupere o extended descriptor do ponto com base
no banco de dados da tag.

Sintaxe
TagExDesc(attname)

Argumentos
• attname
Um atributo com uma referência de dados de tag do PI, entre aspas simples.

Retornos
O extended descriptor da tag do PI

Exceções
Se a tag do PI não existir, um valor com erro será retornado.

372 Guia do Usuário do PI System Explorer

 Análises de ativo

Notas
Retorna em branco quando a tag do PI não tem um extended descriptor

Exemplo
• TagExDesc('cdt158') [Returns blank since the point lacks extended descriptor]

TagMax
Encontre o valor máximo de um atributo em um intervalo de tempo especificado.

Sintaxe
TagMax(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Porcentagem de tempo mínimo em um intervalo de tempo indicando que os
valores de atributo devem ser válidos.

Retornos
O valor máximo do atributo durante o intervalo de tempo especificado.

Exceções
Se o atributo não tiver valores válidos ou o mínimo de pctgood não for atingido para o intervalo
de tempo específico, será retornado um valor com erro.

Notas
Valores inválidos são excluídos do cálculo TagMax.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

• TagMax('att1', 't', '+1h')

[Retorne o valor máximo de 'att1' entre 0h e 1h de hoje.]
• TagMax('att1', 't', '+1h', 80)

Guia do Usuário do PI System Explorer 373

Análises de ativo

[Retorne o valor máximo de 'att1' entre 0h e 1h de hoje quando pelo menos 80% dos
valores eram válidos.]
• TagMax('att1', '14-Dec-16', '15-Dec-16')
[Retorne o valor máximo de 'att1' entre 0h 14/12/2016 e 0h 15/12/2016.]

TagMean
Encontre a média dos valores para um atributo em um intervalo de tempo especificado.

Sintaxe
TagMean(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Porcentagem de tempo mínimo em um intervalo de tempo especificado indicando
que os valores de atributo devem ser válidos.

Retornos
O valor médio do atributo dentro do tempo especificado. A média não é ponderada pelo tempo.

Exceções
Se o atributo não tiver valores válidos ou o mínimo de pctgood não for atingido para o
intervalo de tempo especificado, será retornado um valor com erro. Diferentemente de outras
funções de resumo, TagMean não interpola qualquer valor no limite. Além disso, se não houver
valor no intervalo específico, um valor de erro será retornado.

Notas
Valores inválidos são excluídos do cálculo TagMean.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• TagMean('att1', 't', '+1h')

374 Guia do Usuário do PI System Explorer

 Análises de ativo

[Retorne o valor médio (médio) de 'att1' entre 0h e 1h de hoje.]

• TagMean('att1', 't', '+1h', 80)
[Retorne o valor médio (médio) de 'att1' entre 0h e 1h de hoje quando pelo menos 80% dos
valores eram válidos.]
• TagMean('att1', '14-Dec-16', '15-Dec-16')
[Retorne o valor médio (médio) de 'att1' entre 0h 14/12/2016 e 0h 15/12/2016.]

TagMin
Encontre o valor mínimo de um atributo em um intervalo de tempo especificado.

Sintaxe
TagMin(attname, starttime, endtime [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• pctgood
Opcional: Porcentagem de tempo mínimo em um intervalo de tempo especificado indicando
que os valores de atributo devem ser válidos.

Retornos
O valor mínimo para o atributo durante o intervalo de tempo específico.

Exceções
Se os valores do atributo não existirem ou se o mínimo de pctgood não for atingido para o
intervalo de tempo especificado, será retornado um valor com erro.

Notas
Valores inválidos são excluídos do cálculo TagMin.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar o percentual
de valores válidos.

Exemplo
• TagMin('att1', 't', '+1h')

Guia do Usuário do PI System Explorer 375

Análises de ativo

[Retorne o valor mínimo de 'att1' entre 0h e 1h de hoje.]

• TagMin('att1', 't', '+1h', 80)
[Retorne o valor mínimo de 'att1' entre 0h e 1h de hoje quando pelo menos 80% dos valores
eram válidos. Retorne erro quando o mínimo de pctgood não for alcançado.]
• TagMin('att1', '14-Dec-16', '15-Dec-16')
[Retorne o valor mínimo de 'att1' entre 0h 14/12/2016 e 0h 15/12/2016.]

TagName
Para um atributo associado a uma tag do PI, obtenha o nome de uma tag com base no banco de
dados da tag.

Sintaxe
TagName(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

Retornos
O nome da tag do PI associada a attname.

Exceções
Se a tag do PI não existir, um valor com erro será retornado.

Exemplo
• TagName('sinusoid') [Returns SINUSOID]
• TagName('cdt158') [Returns CDT158]

TagNum
Para um atributo associado a uma tag do PI, obtenha o número de uma tag com base no banco
de dados da tag.

Sintaxe
TagNum(s1)

Argumentos
• string
O nome de um atributo com uma referência de dados da tag do PI, entre aspas duplas.

Retornos
O número da tag

Exceções
Se a tag não existir, retorna um valor com erro.

376 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• TagNum("sinusoid") [Returns 1]
• TagNum("cdt158") [Returns 3]

TagSource
Para um atributo associado a uma tag do PI, obtenha a string do point source de uma tag com
base no banco de dados da tag.

Sintaxe
TagSource(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples

Retornos
A string do point source da tag.

Exceções
Se a tag não existir, um valor com erro será retornado.

Exemplo
• TagSource('sinusoid') [Returns R]
• TagSource('cdt158') [Returns R]

TagSpan
Para um atributo associado a uma tag do PI, obtenha o span de uma tag com base no banco de
dados da tag.

Sintaxe
TagSpan(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples

Retornos
A extensão da tag. Se o tipo de tag for digital, esse espaço será um número inteiro cujo valor
é o número do estado digital definido para a tag.

Exemplo
• TagSpan('sinusoid') [Returns 100]
• TagSpan('cdt158') [Returns 200]

Guia do Usuário do PI System Explorer 377

Análises de ativo

TagTot
Encontre o valor total (integral de tempo) de valores de atributo em um intervalo de tempo
específico, opcionalmente convertendo o valor total de sua unidade de medida (UOM) atual
para uma UOM especificada na mesma classe.

Sintaxe
TagTot(attname, starttime, endtime [, toUnit] [, pctgood])

Argumentos
• attname
atributo com dados de séries cronológicas (como referência de dados da tag do PI), entre
aspas simples

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• toUnit
Opcional: A UOM para a qual o valor total é convertido. A UOM especificada deve ser
compatível com a UOM do atributo de entrada.

• pctgood
Opcional: Porcentagem de tempo mínimo em um intervalo de tempo especificado indicando
que os valores do atributo devem ser válidos.

Retornos
O valor total (integral de tempo) de valores de atributo em um intervalo de tempo específico.

Exceções

• Se o atributo não tiver valores válidos ou o mínimo de pctgood não for atingido para o
intervalo de tempo específico, será retornado um valor com erro.
• Se a UOM especificada para conversão não for compatível com a UOM do atributo de
entrada, um valor será retornado. Por exemplo, se a UOM do atributo de entrada for galões/
minuto, e a UOM para conversão for "m" (metros), então, um erro será retornado.

Notas
• Caso toUnit não seja especificado, o sistema seleciona um fator de escala, de forma que o
número inteiro é correto apena se o fluxo é expresso 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 você somar os valores medidos em galões por minuto, multiplique o
resultado de TagTot por 1440 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 atributo.

378 Guia do Usuário do PI System Explorer

 Análises de ativo

Algumas instalações do PI System podem ter um período total padrão configurado para ser
algo diferente do que por dia, como por hora. O seu fator de conversão seria diferente neste
caso. Recomenda-se que os usuários verifiquem o padrão da instalação usado em seu local.
• Valores inválidos são excluídos do cálculo TagTot.
• Quando a porcentagem de dados válidos é inferior a 100%, TagTot determina o total
baseado nos dados válidos e divide a fração de dados válidos no intervalo. O período em que
os dados são inválidos é ignorado ao calcular o total.
CUIDADO:
Se o atributo tiver poucos valores válidos durante um intervalo de tempo, o resultado
dessa função poderá não ser confiável. Use a função PctGood para encontrar qual
percentual de valores é válido.

Exemplo
• TagTot('att1', 't', '+1h')
[Retorne o valor total de 'att1' entre 0h e 1h de hoje.]
• TagTot('att1', 't', '+1h', "m")
[Retorne o valor total de 'att1' calculado com base na sua unidade entre 0h e 1h de hoje e
converta para metros.]
• TagTot('att1', 't', '+1h', 80)
[Retorne o valor total de 'att1' entre 0h e 1h de hoje quando pelo menos 80% dos valores
eram válidos. Retorne erro quando o mínimo de pctgood não for alcançado.]
• TagTot('att1', 't', '+1h', "m", 80)
[Retorne o valor total de 'att1' calculado com base na sua unidade entre 0h e 1h de hoje e
converta para metros quando pelo menos 80% dos valores eram válidos. Retorne erro
quando o mínimo de pctgood não for alcançado.]

TagType
Para um atributo associado a uma tag do PI, obtenha o point type de uma tag com base no
banco de dados da tag.

Sintaxe
TagType(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples

Retornos
Point type

Exceções
Se o ponto não existir, um valor com erro será retornado.

Exemplo
• TagType('sinusoid') [Returns Float32]
• TagType('cdt158') [Returns Float32]

Guia do Usuário do PI System Explorer 379

Análises de ativo

TagTypVal
Para um atributo associado a uma tag do PI, obtenha o valor comum de uma tag com base no
banco de dados da tag.

Sintaxe
TagTypVal(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

Retornos
O valor comum da tag. Se a tag for um número inteiro ou real, ele será um número; se o tipo do
valor da tag for digital, ele será um estado digital.

Exceções
Se o tag não existir, um valor com erro será retornado.

Exemplo
• TagTypVal('sinusoid') [Returns 50]
• TagTypVal('cdt158') [Returns 140]

TagVal
Retorne o valor de um atributo em um tempo especificado.

Sintaxe
TagVal(attname [, t1])

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples

• t1
Opcional: Uma expressão de tempo. Se esse argumento for omitido, '*' será usado.

Retornos
O valor de um atributo em um tempo especificado. Esse valor é interpolado, exceto se a tag do
PI associada tiver a propriedade "Step" definida para True ou o tipo de valor do atributo não
puder ser interpolado (por exemplo, se ele for uma string)

Exceções
Se a tag associada não existir ou não tiver valor no horário especificado, um erro será
retornado.

Exemplo
• TagVal('att1')

380 Guia do Usuário do PI System Explorer

 Análises de ativo

[Retorne o valor de 'att1' no horário atual]

• TagVal('att1', 't+8h')
[Retorne o valor de 'att1' às 8h de hoje]
• TagVal('enum_att1')
[Retorne o valor de 'enum_att1', um atributo com base em um conjunto de enumeração
definido no horário atual]

TagZero
Para um atributo com referência de dados da tag do PI, obtenha o valor "zero" da tag do PI com
base no banco de dados da tag.

Sintaxe
TagZero(attname)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

Retornos
O valor zero da tag. Se a tipo de Ponto for um número inteiro ou real, ele será um número; se o
tipo da tag for digital, ele será um estado digital (string de caracteres).

Exceções
Se o ponto não existir, um valor com erro será retornado.

Exemplo
• TagZero('sinusoid') [Returns 0]
• TagZero('cdt158') [Returns 50]

Tan
Retorna a tangente trigonométrica de um número.

Sintaxe
Tan(x)

Argumentos
• x
Deve ser um número inteiro ou real que represente um ângulo em radianos.

Retornos
A tangente de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Guia do Usuário do PI System Explorer 381

Análises de ativo

Exemplo
• Tan(1) [Returns 1.5574]
• Tan(1.1) [Returns 1.9648]
• Tan('att1') [Return the trigonometric tangent of the value of 'att1' at time
of evaluation]

Tanh
Retorna a tangente hiperbólica de um número.

Sintaxe
Tanh(x)

Argumentos
• x
Deve ser um número inteiro ou real.

Retornos
A tangente hiperbólica de x.

Exceções
Se x não for um número, um valor de erro será retornado.

Exemplo
• Tanh(1) [Returns 0.76159]
• Tanh(1.1) [Returns 0.8005]
• Tanh('att1') [Return the hyperbolic tangent of the value of 'att1' at time of
evaluation]

Text
Concatena strings que representem valores de argumento.

Sintaxe
Text(x1 [, x2, … xn])

Argumentos
• x1 … xn
Qualquer expressão do tipo de valor do PI normal

Retornos
Uma string que é a concatenação de strings representando valores de argumento.

Exemplo
• Text(Round('sinusoid', 1), " is the current value of 'sinusoid' at ", '*')
[Retorna o valor atual arredondado de 'sinusoid' no horário atual]

382 Guia do Usuário do PI System Explorer

 Análises de ativo

THEN
Retorne o primeiro de dois valores especificados em IF-THEN-ELSE se a expressão condicional
for verdadeira.

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 de saída

Retornos
x quando a expressão condicional é verdadeira e y quando a expressão é falsa

Exceções
Nenhum

Exemplo
• IF ('att1' > 50) THEN ('att2') ELSE ('att3')

TimeEq
Encontre o tempo total, em um intervalo, quando um valor de atributo for igual a um valor
especificado. Hora retornada em segundos.

Sintaxe
TimeEq(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Guia do Usuário do PI System Explorer 383

Análises de ativo

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo for igual a
determinado valor.

Notas
Valores inválidos são excluídos do cálculo TimeEq.

Exemplo
• TimeEq('att1', 't', '+1h', 80)
[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' era igual a 80.]
• TimeEq('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Encontre o tempo total na última hora quando o valor de 'att1' era igual ao valor às 8h de
hoje. Retorne o resultado em segundos.]
• TimeEq('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

TimeGE
Encontre o tempo total, em um intervalo, quando um valor de atributo for maior ou igual a um
valor especificado. Hora retornada em segundos.

Sintaxe
TimeGE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo for maior ou igual
a um determinado valor.

Exceções
Nenhum

Notas
TimeGE interpola entre eventos, se necessário, para localizar os horários em que o valor de
atributo ultrapassou o valor fornecido.

384 Guia do Usuário do PI System Explorer

 Análises de ativo

Valores inválidos são excluídos do cálculo TimeGE.

Exemplo
• TimeGE('att1', 't', '+1h', 80)
[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' era maior que ou igual a 80.]
• TimeGE('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Encontre o tempo total na última hora quando o valor de 'att1' era maior que ou igual ao
valor às 8h de hoje. O resultado está em segundos.]
• TimeGE('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

TimeGT
Encontre o tempo total, em um intervalo, quando um valor de atributo for maior que um valor
especificado. Hora retornada em segundos.

Sintaxe
TimeGT(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo for maior que um
determinado valor.

Exceções
Nenhum

Notas
TimeGT interpola entre eventos, se necessário, para localizar os horários em que o valor de
atributo ultrapassou o valor especificado.
Valores inválidos são excluídos do cálculo TimeGT.

Exemplo
• TimeGT('att1', 't', '+1h', 80)

Guia do Usuário do PI System Explorer 385

Análises de ativo

[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' era maior que 80.]
• TimeGT('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Encontre o tempo total na última hora quando o valor de 'att1' era maior que o valor às 8h
de hoje. O resultado está em segundos.]
• TimeGT('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

TimeLE
Encontre o tempo total, em um intervalo, quando um valor de atributo for menor ou igual a
determinado valor. Hora retornada em segundos.

Sintaxe
TimeLE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo for menor ou igual
a um determinado valor.

Exceções/erros
Nenhum

Notas
TimeLE interpola entre eventos do archive, se necessário, para localizar os horários em que a
tag ultrapassou o valor fornecido.
Valores inválidos são excluídos do cálculo TimeLE.

Exemplos
• TimeLE('att1', 't', '+1h', 80)
[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' era menor que ou igual a 80.]
• TimeLE('att1', '-1h', '*', TagVal('att1', 't+8h'))

386 Guia do Usuário do PI System Explorer

 Análises de ativo

[Encontre o tempo total na última hora quando o valor de 'att1' era menor que ou igual ao
seu valor às 8h de hoje. O resultado está em segundos.]
• TimeLE('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

TimeLT
Encontre o tempo total, em um intervalo, quando um valor de atributo for menor que um valor
especificado. Hora retornada em segundos.

Sintaxe
TimeLT(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo for menor que um
determinado valor.

Exceções
Nenhum

Notas
TimeLT interpola entre eventos do archive, se necessário, para localizar os horários em que o
valor de atributo ultrapassou o valor especificado.
Valores inválidos são excluídos do cálculo TimeLT.

Exemplo
• TimeLT('att1', 't', '+1h', 80)
[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' era menor que 80.]
• TimeLT('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Encontre o tempo total na última hora quando o valor de 'att1' era menor que o seu valor
às 8h de hoje. O resultado está em segundos.]
• TimeLT('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

Guia do Usuário do PI System Explorer 387

Análises de ativo

TimeNE
Encontre o tempo total, em um intervalo, quando um valor de atributo não for igual a um valor
especificado. Hora retornada em segundos.

Sintaxe
TimeNE(attname, starttime, endtime, x)

Argumentos
• attname
O nome de um atributo com uma referência de dados da tag do PI, entre aspas simples.

• starttime
expressão de tempo que representa o início de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '-3h') em referência a um endtime absoluto

• endtime
expressão de tempo que representa o fim de um intervalo de tempo, entre aspas simples;
pode ser um tempo relativo (como '+1h') em referência a um starttime absoluto

• x
O valor de referência da pesquisa; deve ser um conjunto de enumeração (string), número
inteiro ou real

Retornos
O tempo total (em segundos), em um intervalo, quando um valor de atributo não for igual a
valor especificado.

Exceções
Nenhum

Notas
Valores inválidos são excluídos do cálculo TimeNE.

Exemplo
• TimeNE('att1', 't', '+1h', 80)
[Encontre o tempo total entre 0h e 1h de hoje quando 'att1' não era igual a 80.]
• TimeNE('att1', '-1h', '*', TagVal('att1', 't+8h'))
[Encontre o tempo total na última hora quando o valor de 'att1' não era igual ao valor às 8h
de hoje. O resultado está em segundos.]
• TimeNE('enum_att1', '*-1d', '*', DigState("Normal", 'enum_att1'))

TimeStamp
Retorne o timestamp de um valor em timestamp exclusivo.

Sintaxe
TimeStamp(x)

388 Guia do Usuário do PI System Explorer

 Análises de ativo

Argumentos
• x
Valor em timestamp exclusivo

Retornos
O timestamp do valor em timestamp especificado

Exceções
Se o valor de x for No Data, Calc Failed será retornado.

Exemplo
• TimeStamp(PrevVal('sinusoid', '*'))
[Retorne o timestamp do último valor registrado antes do atual para sinusoid]

Total
Retorna a soma de dois ou mais valores.

Sintaxe
Total(x1, x2 [, ... xn])

Argumentos
• x1, ... xn
Números ou intervalos de tempo

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.

Notas
A unidade de medida (UOM) do argumento é transferida para o resultado quando pelo menos
um argumento possui uma UOM definida enquanto os outros não. O valor retornado não será
acompanhado de uma UOM se os argumentos tiverem UOMs diferentes.

Exemplo
• Total('att1', 'att2', TagVal('att1', 'y+2h'), 40)
[Retorne a soma dos seguintes valores: valores de 'att1' e 'att2' na hora atual, o valor de
'att1' às 2h de ontem e 40]
• Total('t'-'y', '+1h')
[Retorna 1.01:00:00]

Trim
Corta espaços vazios nos dois lados de uma string.

Guia do Usuário do PI System Explorer 389

Análises de ativo

Sintaxe
Trim(s1)

Argumentos
• s1
string

Retornos
Uma string de origem com espaços à esquerda e à direita removidos.

Exceções
Se s1 não for uma string, será retornado um valor de erro.

Exemplo
• Trim(" String ")
[Retorna "String"]
• Trim(" String is a string attribute. ")
[Retorna "String is a string attribute."]

Trunc
Trunca um número ou tempo com a próxima unidade mais baixa.

Sintaxe
Trunc(x [, unit])

Argumentos
• x
Um número inteiro ou real, expressão de tempo ou período.

• unit
Opcional. O tamanho da unidade a ser truncada; x será truncado para um múltiplo de unit.
Se x for um membro, unit deverá ser um número. Se x for uma expressão de tempo ou
período, unit deverá ser um período. Se unit estiver omitida, Trunc truncará com o próximo
número inteiro mais baixo (para um número) ou segundo (para um período).

Retornos
O maior múltiplo da unidade que é menor que x. Para um x negativo, ele retorna o menor
múltiplo da unit maior que x. Os dados do retorno são do mesmo tipo de dado 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.

390 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• Trunc(12.999)
[Retorna 12, truncado para o próximo inteiro mais baixo]
• Trunc(28.75, 10)
[Retorna 20, truncado para o próximo múltiplo mais baixo de 10]
• Trunc('14-Dec-16 11:47', '+1h')
[Retorna 14/12/2016 11:00:00 AM, truncado para a próxima hora mais baixa]
• Trunc('18:47'-'15:00','+1h')
[Retorna 03:00:00, período truncado para a próxima hora mais baixa]
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(s1)

Argumentos
• s1
String em aspas duplas

Retornos
s1 em caixa alta

Exceções
Se o argumento não for uma string, será retornado um valor de erro.

Exemplo
• UCase("String")
[Retorna "STRING"]

Weekday
Extraia o dia da semana de determinada expressão de tempo.

Sintaxe
Weekday(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples

Guia do Usuário do PI System Explorer 391

Análises de ativo

Retornos
O dia da semana, no intervalo de 1-7, em que 1 representa o domingo.

Exceções
Nenhum

Exemplo
• Weekday('*')
[Retorne qual é o dia da semana. ]
• Weekday(FindEq('att1', '-7d', '*', 50))
[Retorne qual dia da semana era quando o valor de 'att1' foi 50 pela primeira vez nos
últimos 7 dias. ]

Year
Extrai o ano de uma expressão de tempo.

Sintaxe
Year(t1)

Argumentos
• t1
Uma expressão de tempo entre aspas simples.

Retornos
O ano, no intervalo 1970-atual.

Exceções
Nenhuma.

Exemplo
• Year('*')
[Retorne qual ano é agora.]
• Year(FindGT('att1', '1/1/1970', '*', 50))
[Retorne qual ano era quando o valor de 'att1' foi maior que 50 desde 1/1/1970.]

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
Uma expressão de tempo entre aspas simples

392 Guia do Usuário do PI System Explorer

 Análises de ativo

Retorna
O dia do ano, no intervalo de 1 a 366, em que 1 representa 1º de janeiro

Exceções
Nenhum

Exemplo
• Yearday('*')
[Retorna que dia do ano é hoje, em que 1 representa 1º de janeiro]
• Yearday('y')
[Retorna que dia do ano foi ontem, em que 1 representa 1º de janeiro]

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 na combinação das equações de avanço e retrocesso oficialmente
publicadas para todas as regiões aplicáveis.
Nota:
Evite confundir essas funções de vapor com um conjunto similar de funções de vapor
usado para o PI Performance Equations em análises baseadas em tags. Para obter mais
informações sobre as funções de vapor em análise de ativos e baseadas em tag, consulte
Funções de vapor nas análises de ativos e baseadas em tags.
A tabela a seguir lista as funções suportadas e suas descrições. Os intervalos e as unidades de
medida para as propriedades de função de vapor são detalhados em Intervalos para entradas
da função de vapor. Os estados de referência que se aplicam ao vapor são listados em Estados
de referência das propriedade do vapor.
Descrições da função de vapor
Função Descrição
Steam_TsatP Temperatura de saturação como uma função da pressão.
Steam_HsatP Entalpia específica do vapor de saturação como uma função da pressão.
Steam_SsatP Entropia específica do vapor de saturação como uma função da pressão.
Steam_VsatP Volume específico do 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 específica do vapor de saturação como uma função da temperatura.
Steam_SsatT Entropia específica do vapor 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.
Steam_VPTL Volume específico do líquido como uma função da pressão e da temperatura.
(Para água.)
Steam_VPH Volume específico do vapor como uma função da pressão e da entalpia.
Steam_VPS Volume específico do vapor como uma função da pressão e da entropia.
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.

Guia do Usuário do PI System Explorer 393

Análises de ativo

Função Descrição
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.
Steam_TPH Temperatura como uma função da entalpia e da pressão.
Steam_TPS Temperatura como uma função da entropia e da pressão.
Steam_XPH Qualidade do vapor (fração do vapor) como uma função da pressão e da entalpia.
(Para vapor úmido.)
Steam_XPS Qualidade do vapor (fração do vapor) como uma função da entropia e da
pressão. (Para vapor úmido.)
Steam_VPX Volume específico do vapor como uma função da pressão e da qualidade do
vapor. (Para vapor úmido.)
Steam_HPX Entalpia específica 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.)

Funções de vapor nas análises de ativos e baseadas em tags

As ferramentas de análise de ativos e baseadas em tags incluem funções de vapor que calculam
as propriedades termodinâmicas do vapor e da água. Ambos os conjuntos de ferramentas
fornecem um conjunto completo de funções de vapor, mas são baseados em padrões diferentes
e têm implementações diferentes.

• Funções de vapor no Asset Analytics

As funções de vapor no Asset Analytics são baseadas na Formulação Industrial de 1997 da
IAPWS. A implementação se baseia na combinação das equações de avanço e retrocesso
oficialmente publicadas para todas as regiões aplicáveis.
Nota:
Os nomes de função de vapor no Asset Analytics começam com "Steam_".

• Funções de vapor nas análises baseadas em tags

As funções de vapor em análises baseadas em tags referem-se ao PI PE Steam Functions
Module (PI Steam), que é uma extensão do PI Performance Equations Scheduler. Essas
funções são baseadas na sexta edição do ASME Steam Tables e também estão disponíveis
em uma biblioteca COM, PISteamTableFunctions.dll, que é distribuída por outros
produtos OSIsoft, como o PI ACE.
Nota:
As funções de vapor baseadas em tags suportam tanto unidades no padrão inglês
quanto do SI. Os nomes das funções começam com "StmSI_" para unidades do SI e com
"StmEng_" para unidades no padrão inglês.

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 as
funções de vapor com outras unidades de medida, consulte Conversão de unidades de medida
para funções de vapor.

394 Guia do Usuário do PI System Explorer

 Análises de ativo

Pressão afeta o estado do vapor. São descritos vários fatores de atenção em relações às funções
com pressão como entrada em Considerações para funções de vapor que têm a pressão como
uma entrada.
Intervalo de entradas para propriedades de função de vapor
Função Temp. (°C) Pressão (kPa) Entalpia (J/g) Entropia (J/(g Qualidad
K)) e
Steam_TsatP 0,611212678 a
22.064
Steam_HsatP 0,611212678 a
22.064
Steam_SsatP 0,611212678 a
22.064
Steam_VsatP 0,611212678 a
22.064
Steam_PsatT 0,0 a 373,946
Steam_HsatT 0,0 a 373,946
Steam_SsatT 0,0 a 373,946
Steam_VsatT 0,0 a 373,946
Steam_VPT 0,0 a 800 0,611212678 a
100.000
Steam_VPT (alta 800 a 2.000 0,611212678 a
temperatura e 50.000
pressão)
Steam_VPTL 0,0 a 800 0,611212678 a
100.000
Steam_VPH 0,611212678 a -0,04159 a
100000 4.160,7
Steam_VPS 0,611212678 a -0,000155 a
100.000 11,921
Steam_HPT 0,0 a 800 0,611212678 a
100.000
Steam_HPT (alta 800 a 2.000 0,611212678 a
temperatura e 50.000
pressão)
Steam_HPTL 0,0 a 800 0,611212678 a
100.000
Steam_HPS 0,611212678 a -0,000155 a
100.000 11,921
Steam_SPT 0,0 a 800 0,611212678 a
100.000
Steam_SPT (alta 800 a 2.000 0,611212678 a
temperatura e 50.000
pressão)
Steam_SPTL 0,0 a 800 0,611212678 a
100.000
Steam_SPH 0,611212678 a -0,04159 a
100000 4.160,7
Steam_TPH 0,611212678 a -0,04159 a
100.000 4.160,7
Steam_TPS 0,611212678 a -0,000155 a
100.000 11,921

Guia do Usuário do PI System Explorer 395

Análises de ativo

Função Temp. (°C) Pressão (kPa) Entalpia (J/g) Entropia (J/(g Qualidad
K)) e
Steam_XPH 0,611212678 a -0,04159 a
22.064 4.160,7
Steam_XPS 0,611212678 a -0,000155 a
22.064 11,921
Steam_VPX 0,611212678 a 0,0 a 1,0
22.064
Steam_HPX 0,611212678 a 0,0 a 1,0
22.064
Steam_SPX 0,611212678 a 0,0 a 1,0
22.064

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 usados para água comprimida, vapor
superaquecido ou vapor seco e saturado. Para entrada de temperatura e pressão na curva
saturada, a entropia, entalpia ou volume calculado é uma propriedade do vapor saturado. 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.
Steam_HPTL, Steam_SPTL e Steam_VPTL são usados somente para água comprimida.

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 usados
para água comprimida, vapor superaquecido ou vapor ú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).
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.

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.

396 Guia do Usuário do PI System Explorer

 Análises de ativo

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.
Nome Expressão Valor Atributo de saída
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.
Nome Expressão Valor Atributo de saída
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.

Guia do Usuário do PI System Explorer 397

Análises de ativo

• 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

As funções de vapor disponíveis para uso nas expressões do Analyses são listadas em ordem
alfabética.

Steam_HPS
Calcule a entalpia específica do vapor como uma função da pressão (P em kPa) e entropia (S em
J/(g K)). Use tanto para vapor úmido e superaquecido quanto para água comprimida. 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 100000 kPa.

• S
Entropia específica do vapor. S pode variar de -0,000155 a 11,921J/(g K).

Retornos
Entalpia específica do vapor calculada em J/g.

Exemplo
• Steam_HPS(2500, 7.5956)
[Retorna 3684,9 J/g]

Steam_HPT
Calcule a entalpia específica do vapor em função da pressão (P em kPa) e temperatura (T em
°C). Use para cálculo de água comprimida até de vapor 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_HPT(P, T)

398 Guia do Usuário do PI System Explorer

 Análises de ativo

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Entalpia específica do vapor calculada em J/g.

Exemplo
• Steam_HPT(40000, 600)
[Retorna 3350,4 J/g]

Steam_HPTL
Calcule a entalpia específica do líquido como uma 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 erro fora do intervalo. A função aceita
qualquer T no intervalo de temperatura contanto que P seja 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
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Entalpia específica do líquido calculada em J/g.

Exemplo
• Steam_HPTL(40000, 100)
[Retorna 449,27 J/g]

Steam_HPX
Calcule a entalpia específica como uma 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)

Guia do Usuário do PI System Explorer 399

Análises de ativo

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

• X
Qualidade do vapor (fração do vapor). X pode variar de 0,0 a 1,0.

Retornos
Entalpia específica calculada em J/g.

Exemplo
• Steam_HPX(10000, 0.9)
[Retorna 2593,7 J/g]

Steam_HsatP
Calcule a entalpia específica do vapor saturado em função da pressão (P em kPa). 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_HsatP(P)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

Retornos
Entalpia específica calculada para vapor saturado em J/g.

Exemplo
• Steam_HsatP(10000)
[Retorna 2725,5 J/g]

Steam_HsatT
Calcule 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.

400 Guia do Usuário do PI System Explorer

 Análises de ativo

Retornos
Entalpia específica do vapor saturado calculada em J/g.

Exemplo
• Steam_HsatT(250)
[Retorna 2801 J/g]

Steam_PsatT
Calcule a pressão de saturação como uma 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
Temperatura do vapor. T pode variar de 0,0 a 373,946 °C.

Retornos
Pressão de saturação calculada do vapor em kPa.

Exemplo
• Steam_PsatT(250)
[Retorna 3975,9 kPa]

Steam_SPH
Calcule a entropia específica do vapor como uma função da pressão (P em kPa) e entalpia (H em
J/g). Use tanto para vapor úmido e superaquecido quanto para água comprimida. 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_SPH(P, H)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• H
Entalpia do vapor. H pode variar de -0,04159 a 4160,7 J/g.

Retornos
Entropia específica do vapor calculada em J/(g K).

Exemplo
• Steam_SPH(10000, 3500)

Guia do Usuário do PI System Explorer 401

Análises de ativo

[Retorna 6,756 J/(g K)]

Steam_SPT
Calcule a entropia específica do vapor como uma função da pressão (P em kPa) e temperatura
(T em °C). Use para cálculo de água comprimida até de vapor 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_SPT(P, T)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Entropia específica do vapor calculada em J/(g K).

Exemplo
• Steam_SPT(40000, 600)
[Retorna 6,017 J/(g K)]

Steam_SPTL
Calcule a entropia específica do líquido como uma 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 contanto que P seja 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_SPTL(P, T)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Entropia específica do líquido calculada em J/(g K).

Exemplo
• Steam_SPTL(30000, 500)

402 Guia do Usuário do PI System Explorer

 Análises de ativo

[Retorna 5,7956 J/(g K)]

Steam_SPX
Calcule 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
retornados estão em unidades do SI. Você pode mudar as unidades de medida, por exemplo,
usando a função Convert.

Sintaxe
Steam_SPX(P, X)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

• X
Qualidade do vapor (fração do vapor). X pode variar de 0,0 a 1,0.

Retornos
Entropia específica do vapor calculada em J/(g K)

Exemplo
• Steam_SPX(15000, 0.7)
[Retorna 4,8229 J/(g K)]

Steam_SsatP
Calcule a entropia específica do vapor saturado em função da pressão (P em kPa). 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_SsatP(P)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

Retornos
Entropia específica do vapor saturado calculada em J/(g K).

Exemplo
• Steam_SsatP(10000)
[Retorna 5,6159 J/(g K)]

Guia do Usuário do PI System Explorer 403

Análises de ativo

Steam_SsatT
Calcule a entropia 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_SsatT(T)

Argumentos
• T
Temperatura do vapor. T pode variar de 0,0 a 373,946 °C.

Retornos
Entropia específica do vapor saturado calculada em J/(g K)

Exemplo
• Steam_SsatT(250)
[Retorna 6,0722 J/(g K)]

Steam_TPH
Calcule a temperatura do vapor em função da pressão (P em kPa) e entalpia (H em J/g). Use
tanto para vapor úmido e superaquecido quanto para água comprimida. 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_TPH(P, H)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• H
Entalpia do vapor. H pode variar de -0,04159 a 4160,7 J/g.

Retornos
Temperatura de vapor calculada em °C.

Exemplo
• Steam_TPH(40000, 3500)
[Retorna 643,48 °C]

Steam_TPS
Calcule a temperatura do vapor em função da pressão (P em kPa) e entropia (S em J/(g K)). Use
tanto para vapor úmido e superaquecido quanto para água comprimida. Por padrão, os

404 Guia do Usuário do PI System Explorer

 Análises de ativo

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_TPS(P, S)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• S
Entropia específica do vapor. S pode variar de -0,000155 a 11,921J/(g K).

Retornos
Temperatura de vapor calculada em °C.

Exemplo
• Steam_TPS(40000, 6)
[Retorna 595,93 °C]

Steam_TsatP
Calcule a temperatura de saturação em função da pressão (P em kPa). 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_TsatP(P)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

Retornos
Temperatura de saturação calculada em °C.

Exemplo
• Steam_TsatP(10000)
[Retorna 311 °C]

Steam_VPH
Calcule o volume específico do vapor como uma função da pressão (P em kPa) e entalpia (S em
J/g). Use tanto para vapor úmido e superaquecido quanto para água comprimida. 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_VPH(P, H)

Guia do Usuário do PI System Explorer 405

Análises de ativo

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• H
Entalpia do vapor. H pode variar de -0,04159 a 4160,7 J/g.

Retornos
Volume específico do vapor calculado em cm3/g.

Exemplo
• Steam_VPH(25000, 3500)

[Retorna 14,197 cm3/g]

Steam_VPS
Calcule o volume específico do vapor como uma função da pressão (P em kPa) e entropia (S em
J/(g K)). Use tanto para vapor úmido e superaquecido quanto para água comprimida. 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_VPS(P, S)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• S
Entropia específica do vapor. S pode variar de -0,000155 a 11,921J/(g K).

Retornos
Volume específico do vapor calculado em cm3/g

Exemplo
• Steam_VPS(40000, 6)

[Retorna 8,0055 cm3/g]

Steam_VPT
Calcule o volume específico do vapor como uma função da pressão (P em kPa) e temperatura (T
em °C). Use para cálculo de água comprimida até de vapor superaquecido. Você pode mudar as
unidades de medida, por exemplo, usando a função Convert.

Sintaxe
Steam_VPT(P, T)

Argumentos

406 Guia do Usuário do PI System Explorer

 Análises de ativo

• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Volume específico do vapor calculado em cm3/g.

Exemplo
• Steam_VPT(50000, 500)

[Retorna 3,8894 cm3/g]

Steam_VPTL
Calcule o volume específico líquido como uma 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
contanto que P seja 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_VPTL(P, T)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 100000 kPa.

• T
Temperatura do vapor. T pode variar de 0,0 a 800 ℃.

Retornos
Volume específico líquido calculado em cm3/g

Exemplo
• Steam_VPTL(75000, 500)

[Retorna 2,308 cm3/g]

Steam_VPX
Calcule o volume específico 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
retornados estão em unidades do SI. Você pode mudar as unidades de medida, por exemplo,
usando a função Convert.

Sintaxe
Steam_VPX(P, X)

Argumentos

Guia do Usuário do PI System Explorer 407

Análises de ativo

• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

• X
Qualidade do vapor (fração do vapor). X pode variar de 0,0 a 1,0.

Retornos
Volume específico do vapor calculado em cm3/g

Exemplo
• Steam_VPX(15000, 0.7)

[Retorna 7,7352cm3/g]

Steam_VsatP
Calcule o volume específico do vapor saturado em função da pressão (P em kPa). 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_VsatP(P)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

Retornos
Volume específico do vapor calculado em cm3/g

Exemplo
• Steam_VsatP(10000)

[Retorna 18,034 cm3/g]

Steam_VsatT
Calcule o volume específico 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_VsatT(T)

Argumentos
• T
Temperatura do vapor. T pode variar de 0,0 a 373,946 °C.

Retornos
Volume específico do vapor saturado calculado em cm3/g.

408 Guia do Usuário do PI System Explorer

 Análises de ativo

Exemplo
• Steam_VsatT(250)

[Retorna 50,087 cm3/g]

Steam_XPH
Calcule a qualidade do vapor (fração do vapor) em função da pressão (P em kPa) e entalpia (H
em J/g). 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_XPH(P, H)

Argumentos
• P
Pressão do vapor. P pode variar de 0,611212678 a 22064 kPa.

• H
Entalpia do vapor. H pode variar de -0,04159 a 4160,7 J/g.

Retornos
Qualidade do vapor calculada (fração do vapor)

Exemplo
• Steam_XPH(10000, 2500)
[Retorna 0,82888]

Steam_XPS
Calcule a qualidade do vapor (fração do vapor) em função da pressão (P em kPa) e entropia (S
em J/(g K)). 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_XPS(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).

Retornos
Qualidade do vapor calculada (fração do vapor)

Guia do Usuário do PI System Explorer 409

Análises de ativo

Exemplo
• Steam_XPS(10000, 5)
[Retorna 0,72695]

410 Guia do Usuário do PI System Explorer

Notificações
Notificações é um recurso do PI Asset Framework (PI AF) usado para criar e gerenciar regras
de notificação. Regras de notificação são o mecanismo pelo qual usuários são alertados para
resposta em tempo real, para condições que sinalizam eventos de interesse. Mensagens de
notificação podem ser personalizadas para incluir informações que são especialmente
relevantes para o evento e podem ser enviadas por e-mail para indivíduos, grupos ou serviço
da web. Além disso, os escalonamentos também são configuráveis no sistema de notificação.
Dentro do PI System Explorer, você pode configurar e gerenciar as regras de notificação na
guia Regras de notificação (visível depois que você selecionar um elemento) e no plug-in
Gerenciamento.

Introdução às notificações
Regras de notificação: definição e escopo
Notificações será incluída como um recurso de PI Server, iniciando com a versão 2016 R2, e
não será instalada como um produto separado. O recurso de notificações permite configurar
"regras de notificação" para enviar mensagens de e-mail ou se conectar a um serviço da web;
você também pode configurar o conteúdo da mensagem e os escalonamentos.
Nota:
As notificações criadas usando o PI Notifications 2012 ou versão anterior serão referidas
deste ponto em diante como "notificações de legado".
Notificações são alertas que são gerados quando um evento de interesse é detectado em PI
Server; tais eventos são detectados ao examinar e comparar dados em tempo real e estáticos
com condições definidas pelo usuário, configuradas no PI Server. Informações especificadas
pelo usuário podem ser configuradas nas notificações que são enviadas para usuários ou
grupos em tempo real para alertar os usuários sobre as condições às quais eles podem
precisam responder. Notificações integram-se com, e aproveitam, serviços do PI AF e outros
serviços PI System, e podem ser compartilhadas, gerenciadas e mantidas para toda a empresa.
Todas as ações de notificação, como a horário de envio da notificação, reconhecimentos,
inserção de comentários e escalonamentos, são armazenadas para posterior recuperação e
exame.
As regras de notificação são baseadas em estruturas de evento e as mensagens de notificação
podem incluir informações dos templates de estruturas de eventos. Para obter mais
informações, consulte Notificações e estruturas de evento.

PI Notifications Service
O serviço do PI Notifications é um serviço do Windows que avalia regras de notificação,
processa estruturas de evento de entrada em tempo real e envia notificações. O serviço do PI
Notifications não precisa ser executado na mesma máquina que os servidores PI Data Archive,
PI AF ou outros aplicativos cliente.
Para informações sobre estruturas de evento, consulte Event frames no PI AF.

Vídeo de tutorial
Para obter mais informações sobre como usar notificações no PI Asset Framework, assista aos
vídeos na playlist do canal OSIsoft Learning:
https://www.youtube.com/playlist?list=PLMcG1Hs2Jbcs43wQ2qO2dxW72PqGhZjKW

Guia do Usuário do PI System Explorer 411

Notificações

Notificações e estruturas de evento

Você pode criar regras de notificação com base em quaisquer estruturas de evento geradas
(independentemente do método usado para criá-las). As regras de notificação serão acionadas
quando a condição ou evento configurado for detectado no sistema ou processo e uma
mensagem de notificação personalizada será enviada para um usuário, um grupo ou um
serviço da web.
Os gatilhos de notificação são baseados em estruturas de evento; as estruturas de evento
podem vir de diferentes fontes, como análises, a interface do Event Frame Generator (EFGen)
ou aplicativos AF SDK personalizados. As informações relevantes para os eventos são
armazenadas em estruturas de evento e as ferramentas compatíveis podem recuperar essas
informações. As informações contidas nos elementos, templates de estruturas de eventos e
outros locais também podem ser adicionadas ao conteúdo da notificação. Além disso, as
anotações do event frame contêm informações do histórico da notificação e podem incluir
anexos. Todas as anotações podem ser visualizadas no PI Vision ou em outras ferramentas
cliente que suportem a visualização de anotações.

1. Estruturas de evento geradas por análise. Para obter mais informações, consulte Análises
para criar análises da guia Análises e Critérios de gatilho nas regras de notificação para criar
análises da guia Regras de notificação do PI System Explorer.
2. Estruturas de evento geradas pela interface do Event Frame Generator (EFGen) Consulte a
documentação do Event Frame Generator em Live Library (https://livelibrary.osisoft.com).
3. Estruturas de evento geradas por aplicativos AF SDK personalizados. Consulte a
documentação do AF SDK no site do suporte técnico da OSIsoft (https://
techsupport.osisoft.com/Documentation/PI-AF-SDK/html/1a02af4c-1bec-4804-
a9ef-3c7300f5e2fc.htm).
4. Estruturas de evento criadas manualmente.
Relação entre estruturas de evento e regras de notificação

Histórico de notificações
As informações associadas aos períodos anteriores em que uma notificação foi gerada são
armazenadas como anotações em cada event frame que acionou a notificação. As anotações

412 Guia do Usuário do PI System Explorer

 Notificações

podem ser acessadas selecionando o event frame de interesse específico do plug-in Event
Frames no PI System Explorer. Cada anotação de event frame inclui informações como a regra
de notificação correspondente ao evento de envio, os assinantes que foram notificados, quando
eles foram notificados e se a tentativa de notificação foi bem-sucedida.
Se você migrou do PI Notifications 2012 e optou por migrar a configuração e o histórico, o
histórico de notificações de legado será totalmente migrado; as informações do histórico serão
migradas como anotações nos event frames criados durante a migração. O relatório de
migração inclui informações sobre as instâncias de histórico legado que foram processadas
durante a migração.
Nota:
Para obter informações sobre as permissões necessárias durante a migração, consulte
Migração do PI Notifications 2012.
As anotações de event frames também podem ser visualizadas usando o PI Vision ou outras
ferramentas cliente que suportem a visualização de anotações.

Reconhecer uma notificação

Em PI AF 2016, é possível requerer que uma estrutura de evento seja reconhecida. O recurso
de reconhecimento é usado pelas notificações e pelos aplicativos cliente do PI AF, como o
PI Vision. O recurso de reconhecimento de event frames substitui a funcionalidade de
notificação de reconhecimento na versão de legado do PI Notifications 2012 e anteriores.
Para obter mais informações sobre como reconhecer event frames no PI AF, consulte
Reconhecimento de estruturas de evento e Reconhecer estruturas de evento.
Para obter mais informações sobre como visualizar e reconhecer event frames usando o
PI Vision, consulte o tópico do PI Vision "View event details and annotate events" in Live
Library (https://livelibrary.osisoft.com) (Visualizar detalhes do evento e anotar eventos).

Requisitos para notificações

Antes de começar, certifique-se de que você instalou o PI AF Server 2017.
Para usar o recurso de notificações, você deve instalar nesta ordem:
1. Ferramenta cliente do PI AF 2017
2. PI Notifications Service 2017.
3. Opcional. PI Vision. Exigido se você deseja usar o link de reconhecimento no recurso de
notificações, que é um link para a página de detalhes do evento no PI Vision.
4. Plug-in de gerenciamento da ferramenta cliente do PI AF 2017, que permite gerenciar
análises e regras de notificação em massa.

Suporte ao cliente para notificações

O PI Vision, o PI Coresight 2016 e versões posteriores e o PI DataLink 2016 e versões
posteriores suportam as notificações com a capacidade de exibir event frames e dados
associados. As mensagens de notificação podem incluir links de displays do PI Vision ou PI
Coresight pré-configurados e, assim, fornecer uma representação visual do evento que acionou
a notificação. Consulte a documentação do produto do PI Vision, PI Coresight ou PI DataLink
para obter detalhes sobre suporte ao recurso de notificações.

Guia do Usuário do PI System Explorer 413

Notificações

Segurança das notificações

O recurso de notificações usa a segurança do Windows para a comunicação interna e com o PI
AF Server.
Nota:
Consulte o PI AF Services Installation and Upgrade Guide para obter informações sobre
permissões de conta do serviço PI Notifications.
Você pode proteger o acesso a regras de notificação, templates de regra de notificação, contatos
e templates de contato. As permissões de objeto são concedidas de acordo com o modelo de
segurança do PI AF.
Nota:
É necessário ter acesso de gravação no nível do banco de dados para modificar qualquer
objeto no banco de dados.
Se o acesso ao Active Directory (AD) estiver configurado, as informações do AD serão
acessadas para criar contatos individuais. Você não pode excluir um contato AD do PI System
Explorer nem modificar as configurações de segurança para o contato. Para configurar o acesso
ao AD, consulte o tópico do PI Server "Configure Active Directory objects for delegation" in Live
Library (https://livelibrary.osisoft.com) (Configurar objetos do Active Directory para
delegação).

Segurança para contatos

A segurança do Microsoft Windows é usada para controlar o acesso aos grupos, equipes de
escalonamento e contatos personalizados que não estão no Active Directory. As configurações
de segurança para contatos do Active Directory não podem ser alteradas usando o PI System
Explorer.
Os objetos de contato recém-criados herdarão as permissões padrão das coleções pais; um
contato personalizado recém-criado terá sua segurança definida pela coleção de contatos do
servidor.

Resumo de permissões para contatos

A segurança do Windows deve ser configurada adequadamente para os contatos visualizarem,
modificarem, excluírem ou atribuírem privilégios para outros contatos.
Permissão Descrição
Read Pode visualizar informações sobre contatos.
Write Pode modificar contatos.
Delete Pode excluir contatos.
Admin Pode atribuir privilégios aos contatos.

Editar segurança para contatos existentes

Editar configurações de segurança por meio do plug-in Contatos permite acesso desejado aos
contatos. O acesso de administrador é necessário para editar a segurança do contato. Consulte
Resumo de permissões para contatos.

414 Guia do Usuário do PI System Explorer

 Notificações

Nota:
Também é possível editar configurações de segurança para contatos navegando até
Banco de dados > Editar segurança e selecionando os Templates de contato de
notificação apropriados para o servidor PI AF (por meio da coluna Item). Por exemplo, se
o PI AF Server for nomeado MyServer, selecione MyServer-Templates de contato da
notificação.

Procedimento
1. No PI System Explorer, clique em Contatos no painel do navegador.
2. Pesquise pelo grupo, pela equipe de escalonamento ou pelo endpoint de entrega cujas
permissões você deseja alterar. Talvez seja necessário clicar duas vezes no contato para ver
seus endpoints de entrega.
3. Clique com o botão direito no endpoint de entrega do contato e selecione Segurança.
A janela Configuração de segurança para o endpoint de entrega é exibida.
4. Altere as configurações de segurança para o endpoint de entrega. As permissões podem ser
alteradas para todas as identidades que foram configuradas. Também é possível mapear
novas identidades e configurar suas permissões.

Segurança para regras de notificação e templates

As notificações utilizam a segurança do Microsoft Windows para controlar o acesso às regras
de notificação e templates. Para editar uma regra de notificação ou template, você precisa de
acesso de gravação para a regra de notificação e o banco de dados do PI AF em que ela está
armazenada.

Resumo das permissões para regras de notificação e templates

A segurança do Windows deve ser configurada adequadamente para realizar tarefas
específicas com as notificações.
Permissão Descrição
Read Pode visualizar uma regra de notificação.
Write Pode modificar as configurações nos painéis
Trigger Criteria (Critérios de gatilho), Subscriptions
(Assinaturas) e Formats (Formatos).
Subscribe Pode inscrever-se em uma notificação e
personalizar a assinatura.
SubscribeOthers Pode inscrever outros em uma notificação e
personalizar as assinaturas deles.
Delete Pode excluir uma regra de notificação.
Execute Pode iniciar, interromper ou redefinir uma regra
de notificação.
Admin Pode atribuir privilégios às regras de notificação.

A permissão de gravação no nível do PI AF Server é necessária para os formatos globais.

Consulte Configurar segurança para um PI AF Server para obter mais informações.

Guia do Usuário do PI System Explorer 415

Notificações

Editar segurança para uma regra de notificação ou um template

Editar configurações de segurança para permitir acesso às regras de notificação e aos
templates.
Nota:
O acesso de administrador é exigido para editar a segurança da regra de notificação e do
template. Consulte Resumo de permissões para regras de notificação e templates.

Procedimento
1. No PI System Explorer, navegue até Banco de dados > Editar segurança.
Você verá a janela Configuração de segurança.
2. Da coluna Item, selecione a regra de notificação ou o template de regra de notificação
apropriado para o servidor PI AF. Por exemplo, em um servidor PI AF chamado "MyServer",
você deve selecionar:
◦ MyServer–Banco de dados–Regra de notificação para modificar as permissões da regra
de notificação
◦ MyServer–Banco de dados–Template de regra de notificação para modificar as
permissões do template de regra de notificação.
3. Alterar configurações de segurança para regras de notificação ou templates. As permissões
podem ser alteradas para todas as identidades que foram configuradas. Também é possível
mapear novas identidades e configurar suas permissões.

Criar uma regra de notificação

Configurar uma regra de notificação inclui especificação de critérios de gatilho, adição de
assinantes à regra de notificação e formatação da mensagem para atender às necessidades da
organização.
Para um exemplo detalhado, consulte Configuração de regras de notificação para análises ou
estruturas de evento.

Procedimento
1. No PI System Explorer, selecione o elemento no qual deseja criar regras de notificação.
2. Da guia Regras de notificação ou de uma análise de estrutura de evento existente, selecione
Criar nova regra de notificação.
3. Digite um nome para uma nova regra de notificação e (opcionalmente) selecione uma
categoria.
4. No painel Trigger Criteria (Critérios de gatilho), especifique o conjunto de condições que
fazem uma notificação ser enviada. Para obter mais informações, consulte Critérios de
gatilho nas regras de notificação.
5. No painel Subscriptions (Assinaturas), selecione Manage Formats (Gerenciar formatos) e
especifique o formato para notificações. Para obter mais informações, consulte Formatos de
entrega em regras de notificação.
6. No painel Subscriptions (Assinaturas), selecione View/edit subscriptions (Visualizar/editar
assinaturas) e especifique os contatos para os quais notificações serão enviadas. Para obter
mais informações, consulte Assinaturas em regras de notificação.
7. Teste se a notificação foi disparada quando ocorrer um evento que satisfaça todos os
critérios de gatilho especificados.

416 Guia do Usuário do PI System Explorer

 Notificações

Criar um template de regra de notificação

Você pode criar um novo template de regra de notificação para um template de elemento
existente no PI System Explorer. Também é possível converter uma regra de notificação
existente em um template de regra de notificação clicando com o botão direito do mouse na
regra de notificação e selecionando Converter em Template.

Procedimento
1. No painel do navegador do PI System Explorer, clique em Biblioteca.
2. Selecione Templates > Templates de elemento.
3. Selecione o template de elemento específico onde deseja criar o template de regra de
notificação.
4. Clique na guia Templates de regra de notificação. A guia lista os templates de regra de
notificação já definidos para o template de elemento selecionado.
5. Crie um novo template de regra de notificação para o template de elemento selecionado. Se
não houver templates de notificação, clique em Criar um novo template de regra de
notificação para criar o primeiro. Caso contrário, clique no ícone Novo template de regra de
notificação para criar um novo template de regra de notificação.

6. Insira as informações para identificar o template de regra de notificação.

◦ Nome
O nome que identifica exclusivamente este template de regra de notificação.

◦ Descrição
Texto opcional que descreve o template de regra de notificação.

◦ Categorias
Categoria opcional que você pode atribuir ao template de regra de notificação. Clique na
lista, marque a caixa de seleção ao lado da categoria que deseja atribuir, ou clique em
Novo para criar uma nova categoria.
7. Configure critérios de gatilho para o template de regra de notificação. Para obter instruções
específicas, consulte Critérios de gatilho nas regras de notificação.
8. Clique em Gerenciar formatos para personalizar a mensagem que será enviada com a
notificação. Para obter instruções específicas, consulte Formatos de entrega em regras de
notificação.
9. Clique em Visualizar/editar assinaturas para configurar as assinaturas. Para obter
instruções específicas, consulte Assinaturas em regras de notificação.
10. Clique em Fazer check-in para salvar as alterações.

Critérios de gatilho nas regras de notificação

É possível configurar critérios de gatilho para um evento, a fim de determinar quando uma
notificação será enviada ao canal de entrega apropriado, por exemplo, um endereço de e-mail
ou serviço da web. As condições de gatilho são configuráveis no painel Critérios de gatilho e
outras opções podem ser configuradas no painel Opções.

Guia do Usuário do PI System Explorer 417

Notificações

Para ver os painéis Critérios de gatilho e Opções no PI System Explorer, navegue até a guia
Regras de notificação para um elemento selecionado e clique em Visualizar/editar gatilho no
painel Gatilho.

Painel Critérios de gatilho

O painel Critérios de gatilho permite configurar qualquer um destes modos de critérios de
gatilho: Análise ou Pesquisa da Estrutura de Eventos.
Use o modo de análise para disparar uma regra de notificação em estruturas de evento geradas
por uma análise particular. No modo Análise, é possível selecionar uma análise existente ou
configurar uma nova análise do tipo Geração de estrutura de evento ou SQC e opcionalmente
configurar condições de gatilho adicionais com base em valores de atributo de estrutura do
evento. Se escolher criar uma nova análise com o nome padrão ou personalizado, você verá a
mesma janela de criação de análise que a da guia Análises.
Nota:
Para que as notificações entrem em vigor, é necessário verificar a análise e a regra de
notificação.
Para obter informações sobre como configurar uma análise SQC, consulte Criar uma análise
SQC. Para obter informações sobre como criar Analyses do Gerador de Event Frames, consulte
Crie uma análise de geração da estrutura de eventos.
Nota:
Ao criar uma análise SQC no painel Trigger Criteria (Critérios de gatilho), você só pode
escolher Event Frame como uma saída da análise.
Use o modo Pesquisa de estrutura de evento para disparar uma regra de notificação com base
no nome, template e categoria da estrutura de evento. No modo de Pesquisa de estrutura de
evento, é possível selecionar um template da estrutura de evento configurado pela lista
suspensa e configurar o nome e a categoria das estruturas de evento que dispararão suas
notificações. O nome pode conter caracteres coringas que dão suporte a pesquisa de estrutura
de evento. Como alternativa, é possível configurar condições de gatilhos adicionais com base
em valores do atributo da estrutura de evento.
Para os modos Análise ou Pesquisar event frame, é possível acrescentar critérios de gatilho
adicionais usando valores do atributo do event frame. Critérios podem ser especificados para
qualquer atributo do template da estrutura de evento, que é especificado no critério de gatilho
da regra de notificação. Os valores do atributo que você selecionou nas condições devem ser
especificamente aqueles dos quais deseje ser notificado sobre estruturas de evento (que
correspondem ao template da estrutura de evento de análise). Por exemplo, se o template da
estrutura de evento define um evento como "tempo de inatividade" mas você deseja um e-mail
sobre tempo de inatividade "não programado", é possível configurar uma condição de valor do
atributo, em que um atributo de "código de motivo" no template da estrutura de evento de
"tempo de inatividade" tenha um valor indicando o tempo de inatividade "não programado".
Nota:
Condições múltiplas são agrupadas usando o operador AND.

Painel Opções
O painel Opções permite configurar as seguintes opções de gatilho:

• Intervalo de reenvio
O intervalo após o qual o serviço PI Notifications enviará alertas adicionais até que a
estrutura de evento com a regra de notificação seja reconhecida ou fechada.

418 Guia do Usuário do PI System Explorer

 Notificações

• Intervalo sem repetição

O intervalo durante o qual o serviço PI Notifications não enviará alertas semelhantes
associados à mesma regra de notificação.

• Estrutura de evento pode ser reconhecida

Opção para acionar a estrutura de evento a ser reconhecida; o template da estrutura de
evento também é modificado adequadamente. Essa opção é selecionada automaticamente
se o template da estrutura de evento foi configurado para reconhecimento.

• Severidade
Essa opção aplica-se apenas às análises de geração de estrutura de evento. Se você
configurou vários acionadores de início para a análise, pode escolher ser notificado das
seguintes maneiras:
◦ Quando a severidade do gatilho atual for mais alta do que a severidade de qualquer
gatilho encontrada até agora.
◦ Quando a severidade do gatilho atual for mais alta que a do gatilho anterior.
◦ Sempre que uma condição de gatilho for verdadeira, independentemente de sua
severidade em relação a outros gatilhos anteriores.

Intervalo sem repetição nas regras de notificação

É possível configurar o Intervalo sem repetição para evitar que notificações enviem alertas
similares, que estão associados à mesma condição, em um período de tempo especificado.
Alertas serão enviados para eventos de gatilho com uma maior severidade, mesmo que um
alerta anterior tenha sido enviado para um evento de gatilho de menor severidade, e na
estrutura de hora do intervalo de não repetição.
O sistema determina quando reenviar a notificação com base no horário em que a última
notificação foi enviada, não com base na hora de início do evento de gatilho. Por exemplo, se a
estrutura de evento iniciou na hora t , e o serviço, após o processamento, enviar a notificação
na hora t1, o sistema usará t1 como base para calcular o tempo entre alertas.
Nota:
Se você especificar um intervalo de reenvio e de não repetição, o intervalo de reenvio
deverá ser mais longo.

Intervalo de reenvio nas regras de notificação

É possível configurar o Intervalo de Reenvio a fim de que alertas adicionais sejam enviados
quando a estrutura de evento não tiver sido reconhecida ou fechada; ele é um lembrete de que
o evento de interesse que leva à notificação ainda está para ser resolvido. O intervalo de
reenvio especifica a hora entre alertas sucessivos enviados.
O sistema determina quando reenviar a notificação com base no horário em que a última
notificação foi enviada, não com base na hora de início do evento de gatilho. Por exemplo, se a
estrutura de evento iniciou na hora t , e o serviço, após o processamento, enviar a notificação
na hora t1, o sistema usará t1 como base para calcular o tempo entre alertas.
Nota:
Se você especificar um intervalo de reenvio e de não repetição, o intervalo de reenvio
deverá ser mais longo.

Guia do Usuário do PI System Explorer 419

Notificações

Formatos de entrega em regras de notificação

Painéis Mensagem e Conteúdo no PI System Explorer
Nos painéis Mensagem e Conteúdo, você pode configurar o formato da mensagem entregue
quando uma regra de notificação for acionada.
Para ver os painéis Mensagem e Conteúdo no PI System Explorer, navegue até a guia Regras de
notificação para um elemento selecionado e clique em Gerenciar formatos no painel
Assinaturas.

Formatos globais padrão

O sistema fornece um formato global que é usado como o formato padrão quando um assinante
é adicionado a uma regra de notificação. Você pode editar ou alterar o nome do formato global,
mas não pode excluí-lo.
Você também pode criar formatos globais adicionais. Esses formatos globais podem ser
visualizados nas regras de notificação ou templates de regra de notificação. Para criar, editar
ou excluir formatos globais, navegue até Ferramentas > Formatos globais no PI System
Explorer.

Formatos de entrega personalizados

Para criar um formato de e-mail de entrega personalizado, copie o formato padrão E-mail
padrão global clicando no ícone copiar no painel Mensagem. Ou então, você pode criar um
novo formato de entrega, clicando no ícone novo formato de entrega . O formato padrão
inclui informações básicas de notificação, como o nome da regra de notificação, hora do gatilho
e hora de início da estrutura de evento, bem como informações do sistema, como nomes do
sistema e do banco de dados.
Para personalizar o seu formato de entrega, você pode arrastar e soltar os seguintes tipos de
informações do painel Conteúdo para o painel Mensagem:
• Propriedades do PI AF Server
• Propriedades do banco de dados
• Propriedades da regra de notificação
• Propriedades e atributos da estrutura de evento. Se um template da estrutura de evento
estiver selecionado, você pode adicionar os atributos do template de estrutura de evento ao
conteúdo do seu e-mail de notificação.
• Propriedades e atributos do elemento referido
Essas propriedades e atributos podem fornecer várias entradas para analisar o evento de
interesse; por exemplo, a inclusão da propriedade de hora de início da estrutura de evento
pode dizer quando o evento de interesse iniciou. A inclusão de estrutura de evento específico e
de atributos do elemento referido pode fornecer informações de suporte sobre os parâmetros-
chave.
Você pode criar um URI da web ou do PI Vision ou um link de arquivo para navegar até uma
página da web que mostre informações relevantes sobre seus atributos, event frames e assim
por diante. Para adicionar um link, clique no painel Mensagem e, em seguida, clique no ícone do
link; será solicitado que você insira seus parâmetros de endereço básico e string de consulta. Se
você estiver configurando um Web URI, pode especificar um fragmento, que é uma string
anexada ao final do URI. Para obter mais informações sobre parâmetros de string de consulta,
veja o tópico do PI Vision "URL parameters reference" in Live Library (https://
livelibrary.osisoft.com) (Referência de parâmetros de URL).

420 Guia do Usuário do PI System Explorer

 Notificações

Você pode adicionar um anexo de arquivo ao formato de entrega clicando no símbolo + no

campo Anexos. O anexo selecionado será carregado como um atributo no elemento referido.
Dica:
Se o painel Conteúdo tiver uma mensagem indicando que o formato selecionado é
"somente leitura", primeiro você deve adicionar um novo formato antes de personalizá-
lo.

Vídeo de tutorial
Para obter mais informações sobre formatos de mensagem, assista ao vídeo do canal OSIsoft
Learning:
https://www.youtube.com/watch?v=2q3YBcaNlEM (Como personalizar o conteúdo e o
formato da mensagem de notificações)

Assinaturas em regras de notificação

Painéis Contatos e Assinaturas no PI System Explorer
No painel de Assinaturas, é possível configurar para que os assinantes sejam alertados quando
uma regra de notificação for disparada. Um assinante é uma entidade individual ou um grupo
de entidades que pode receber mensagens de notificação assinando as regras de notificação.
Para ver os painéis Contatos e Assinaturas no PI System Explorer, navegue até a guia Regras de
notificação para um elemento selecionado e clique em Visualizar/editar assinaturas no painel
Assinaturas.
Para adicionar um assinante na guia Regras de notificações do PI System Explorer, basta
arrastar e soltar um contato do painel Contatos para o painel Assinaturas.
Nota:
Para cancelar a assinatura de um contato, clique com o botão direito no contato e
selecione Unsubscribe (Cancelar assinatura).
Ao instalar o PI AF, as informações do Active Directory (AD) são importadas, e os contatos
individuais são criados automaticamente em Contatos. Se um usuário não tiver uma conta do
AD, você pode criar um contato personalizado.

Painel Assinatura
Quando um contato é adicionado ao painel Assinaturas, os seguintes detalhes são incluídos para
o contato:

• Nome
O nome do contato.

• Configuração
O formato de entrega padrão, herdado ou personalizado para este assinante.

• Opção notificar
A opção notificar pode ser um dos seguintes:
◦ Início e fim do evento. Você pode receber uma notificação quando uma estrutura de
eventos correspondente à regra de notificação for criada ou fechada.
◦ Início do evento.

Guia do Usuário do PI System Explorer 421

Notificações

Painel Contatos
Os assinantes podem ser configurados de acordo com esses tipos de contatos no painel
Contatos:
• Contato individual
• Equipes de escalonamento
• Grupos
• Endpoints de entrega
Use Contacts Search (Pesquisa por contatos) para encontrar contatos individuais para incluir
em uma equipe de escalonamento ou grupo ou para inscrever em uma regra de notificação.
Você pode usar caracteres coringas para expandir suas pesquisas por nomes, isso permitirá a
pesquisa por nomes e sobrenomes. Por exemplo, uma pesquisa com "A*" listará tanto "Adam
Smith" quanto "John Adams".
Nota:
Os resultados da pesquisa mostram o nome a ser exibido, conforme configurado no
Active Directory.
Para obter mais informações sobre a configuração de contatos usando o plug-in Contatos,
consulte Contatos.

Vídeo de tutorial
Para obter informações sobre como configurar assinantes, assista a este vídeo:
https://www.youtube.com/watch?v=lN2r5u5_U2w

Personalização do conteúdo de assinatura e entrega

O formato de entrega padrão, especificado na guia Mensagem, é automaticamente aplicado a
todas as assinaturas na notificação. Para enviar uma mensagem diferente, é possível
personalizar os formatos de assinatura aplicando um formato de entrega diferente.
Nota:
Caso personalize assinaturas e mais tarde queira alterar os formatos de entrega, talvez
seja necessário alterar manualmente os formatos de entrega das assinaturas que você
personalizou anteriormente. Por exemplo, caso altere o formato de entrega padrão ou
especifique um formato de entrega diferente como padrão, apenas assinaturas que
herdam tal formato serão alteradas; assinaturas personalizadas não serão afetadas.

Para obter mais informações sobre formatos de entrega, consulte Formatos de entrega em
regras de notificação.

Configuração de delivery endpoints de notificações

Um delivery endpoint é uma entidade única para a qual uma notificação é entregue, como um
endereço de e-mail individual ou uma chamada de serviço da web. Cada endpoint de entrega
está associado a um canal de entrega, o conduto pelo qual mensagens de notificação são
enviadas. As notificações fornecem canais de entrega para e-mail e para serviços web SOAP e
REST.
Para configurar delivery endpoints de e-mail, consulte Configurar um delivery endpoint de e-
mail.

422 Guia do Usuário do PI System Explorer

 Notificações

Para configurar delivery endpoints de serviços web, consulte Configurar um delivery endpoint
do serviço da web SOAP ou REST.

Configurar um delivery endpoint de e-mail

Para configurar um delivery endpoint de e-mail e adicionar um assinante de e-mail à sua regra
de notificação, siga o procedimento a seguir.

Antes de Iniciar
Se você ainda não configurou o servidor SMTP para o canal de entrega de e-mail, siga as
instruções em: Atualizar configurações de SMTP para o canal de entrega de e-mail.

Procedimento
1. Adicione um delivery endpoint de e-mail usando o plug-in Contatos do PI System Explorer.
Para obter informações específicas, consulte Gerenciar contatos e Opções para as
notificações do canal de entrega de e-mail.
2. Navegue até Elementos > your_element > Regras de notificação e adicione o delivery
endpoint de e-mail configurado à sua regra de notificação como um assinante.
a. Clique em View/Edit subscriptions (Visualizar/editar assinaturas) no painel Subscriptions
(Assinaturas) da regra de notificação
b. Arraste e solte um contato configurado do painel Contatos para o painel Subscriptions
(Assinaturas).

Atualizar configurações de SMTP para o canal de entrega de e-mail

É necessário configurar o canal de entrega de e-mail para todos os bancos de dados do AF no PI
AF Server.

Procedimento
1. Para iniciar o PI System Explorer, clique em Iniciar > Programas > PI System > PI System
Explorer.
2. Clique em na barra de ferramentas do PI System Explorer ou clique em Arquivo >
Propriedades do servidor.
3. Clique na guia Plug-ins.
4. Role para baixo até a seção Plug-Ins do Canal de Entrega, clique com o botão direito em E-
mail e selecione Configurações.
5. Na janela Email Delivery Channel Configuration (Configuração do canal de entrega de e-mail),
altere os seguintes parâmetros conforme necessário:
◦ SMTP Server (Servidor SMTP): o nome do domínio totalmente qualificado da máquina
que está rodando o servidor SMTP.
◦ Porta: a porta ouvinte do servidor SMTP.
◦ Backup SMTP Server (Servidor SMTP de backup): o nome do domínio totalmente
qualificado da máquina que está rodando o servidor SMTP de backup.
◦ Porta: a porta ouvinte do servidor SMTP de backup.
◦ Sender Email (E-mail do remetente): o endereço de email do qual as mensagens de
notificação serão enviadas.

Guia do Usuário do PI System Explorer 423

Notificações

◦ Allow contacts to set sender email (Permitir que os contatos configurem o e-mail do
remetente): especifica se os contatos individuais podem alterar o endereço de e-mail do
qual os e-mails de notificação são enviados.
◦ Send Timeout (Tempo limite do envio): tempo permitido para que os e-mails enviados
sejam recebidos pelo servidor SMTP primário antes que ocorra o failover no servidor
SMTP de backup.
◦ Backup Fail Back Time (Tempo de failback do backup): durante o failover, especifica por
quanto tempo o servidor SMTP de backup envia o e-mail antes de tentar um failback para
o servidor primário.

Configurar um delivery endpoint do serviço da web SOAP ou REST

Para configurar um delivery endpoint de um serviço da web e adicionar um assinante de
serviço web à sua regra de notificação, siga este procedimento.

Procedimento
1. Adicione um delivery endpoint do serviço da web usando o plug-in Contatos do PI System
Explorer. Para obter informações específicas, consulte Gerenciar contatos e Opções para o
canal de entrega de serviço da web de notificações.
2. Adicione o delivery endpoint do serviço da web configurado à sua regra de notificação como
um assinante.
a. Clique em View/Edit subscriptions (Visualizar/editar assinaturas) no painel Subscriptions
(Assinaturas) da regra de notificação
b. Arraste e solte um contato configurado do painel Contatos para o painel Subscriptions
(Assinaturas).
c. Configure o serviço da web REST ou SOAP.

▪ Serviço da web REST

Clique no ícone da chave inglesa para configurar o objeto JSON para o método
REST API. Atualmente, somente as cargas JSON são suportadas; os parâmetros de
string de consulta não são suportados.
Se você passar o mouse sobre o ícone de ajuda , verá parâmetros JSON de amostra
(caminho e valor) necessários para configurar esse método:

424 Guia do Usuário do PI System Explorer

 Notificações

Insira o caminho e o valor em cada linha. Você pode validar o método usando o botão
Test Send (Testar envio).

▪ Serviço da web SOAP

Clique no ícone da chave inglesa para configurar o método SOAP API. O ícone de
informações fornece informações sobre os parâmetros (caminho e valor) que
devem ser configurados para esse método e sua complexidade. Insira o caminho e o
valor em cada linha; clique em uma linha para exibir uma lista suspensa com os
valores esperados para esse caminho. A interface também valida automaticamente os
parâmetros que você insere em cada linha. Você pode validar o método usando o
botão Test Send (Testar envio).
Você tem a opção de cancelar ou repetir uma conexão que está demorando muito para
ser concluída; isso pode acontecer se você tiver uma conexão de latência alta
(comumente chamada "atrasada") na qual as informações do WSDL não são
recuperadas rapidamente.
Nota:
O método pode exigir dados complexos. Para inserir as informações corretas,
consulte a documentação do WSDL (Web Service Definition Language) para o
método API.

Contatos
No PI System Explorer, o plug-in Contatos oferece opções de contato para usuários individuais
e grupos.

Versões do plug-in Contatos

O PI System Explorer funciona com diferentes versões do plug-in Contatos.
• Para trabalhar com a versão compatível com a nova versão das notificações lançada no 2016
R2, execute a versão de 64 bits do PI System Explorer.
• Para trabalhar com a versão legada compatível com as notificações legadas, execute a
versão de 32 bits do PI System Explorer. Observe que se as notificações legadas não

Guia do Usuário do PI System Explorer 425

Notificações

estiverem instaladas, a nova versão do plug-in Contatos será carregada. Para obter mais
informações sobre as versões do PI System Explorer, consulte PI System Explorer.

Configuração do assinante
Você pode configurar os assinantes destes tipos de contatos:

• Endpoints de entrega
Um endpoint de entrega é uma entidade para a qual notificações podem ser enviadas e é
tipicamente um usuário ou aplicativo individual.

• Grupos
Um grupo de contatos é uma coleção desordenada de endpoints de entrega, outros grupos
ou equipes de escalonamento. As mensagens de notificação são enviadas a todos os
membros do grupo simultaneamente.
Nota:
Os grupos de contatos que você cria no PI System Explorer não são os mesmos que os
grupos do Active Directory (AD).

• Equipes de escalonamento
Uma equipe de escalonamento é uma coleção ordenada de endpoints de entrega ou grupos.
As mensagens de notificação são enviadas imediatamente para o primeiro contato na lista.
Se a estrutura de evento correspondente à regra de notificação não for reconhecida ou
estiver fechada dentro de período específico, as mensagens de notificação serão enviadas
sequencialmente para os demais membros da equipe de escalonamento até que a estrutura
de evento seja reconhecida ou fechada.
O período de escalonamento define a quantidade de tempo que deve decorrer antes que
uma notificação seja enviada para o próximo contato na lista.
Nota:
Use Pesquisa de contatos para encontrar endpoint de entrega para incluir em uma
equipe de escalonamento ou um grupo, ou para inscrever-se em uma regra de notificação.

Gerenciar contatos
Use o Plug-in Contatos para gerenciar informações de contato individuais, bem como gerenciar
grupos, equipes de escalonamento e endpoints de entrega para usar com as notificações.

Antes de Iniciar
Não é possível aninhar equipes de escalonamento.

Procedimento
1. No navegador, clique em Contatos.
2. No navegador de Contatos, escolha uma das ações a seguir.

426 Guia do Usuário do PI System Explorer


Para...
Edite o contato existente
Criar um contato personalizado que ainda não
está no Active Directory
Notificações
Faça o seguinte...
a. Escolha uma das seguintes ações:
▪ Insira os critérios de pesquisa em
Pesquisar por contatos e pressione Enter.
Observe que * retorna todos os contatos.
▪ Clique em ao lado de Pesquisar por
contatos, insira os critérios de pesquisa
na janela Pesquisar contatos e clique em
OK.
▪ Expanda a pasta Contatos, clique em
Nova pesquisa..., insira os critérios de
pesquisa na janela Pesquisar contatos e
clique em OK.
Os resultados da pesquisa são exibidos no
navegador de Contatos.
b. Clique em ao lado do contato que deseja
atualizar e clique no endpoint de entrega de
e-mail.
c. No visualizador, você pode fazer as seguintes
alterações:
▪ No campo Descrição, adicione
informações de contato adicionais.
▪ Insira opções de contato de notificação
nos campos Intervalo de nova tentativa e
Máximo de novas tentativas.
a. Clique com o botão direito na pasta Contatos
e selecione Novo contato.
b. No visualizador, insira um nome e um
endereço de e-mail. Todas as outras
informações são opcionais.
O contato é exibido no navegador de
Contatos.
c. Clique em ao lado do contato recém-criado.
Nota:
O ícone indica contatos que não são do
AD (contrário de ).
d. Clique no endpoint de entrega de e-mail e, no
visualizador, insira as opções de contato de
notificação nos campos Intervalo de nova
tentativa e Máximo de novas tentativas.
Guia do Usuário do PI System Explorer 427
Notificações

Criar um grupo a. Clique com o botão direito na pasta Grupos e

selecione Novo grupo.
b. No campo Nome, insira um nome exclusivo
para o grupo.
c. Escolha uma das seguintes ações:
▪ Clique em e, na janela Selecionar um
contato, localize um contato com uma
nova pesquisa ou selecione outro grupo,
uma equipe de escalonamento ou um
endpoint de entrega e clique em OK.
Repita conforme necessário.
▪ Na paleta de Contatos, localize um contato
com uma nova pesquisa ou selecione
outro grupo, uma equipe de
escalonamento ou um endpoint de
entrega e arraste-o para o visualizador.
Repita conforme necessário.
d. Configure as opções de contato de notificação
para o grupo.
▪ Clique no endpoint de entrega de cada
assinante, clique em Opções e insira as
opções de contato de notificação nos
campos Intervalo de nova tentativa e
Máximo de novas tentativas.
▪ Se as equipes de escalonamento estiverem
incluídas em um grupo, clique com o
botão direito em cada equipe de
escalonamento, clique em Opções, insira
as opções de contato de notificação em
Período de escalonamento e selecione
uma opção Se não reconhecido.

428 Guia do Usuário do PI System Explorer


Criar uma equipe de escalonamento
Notificações
a. Clique com o botão direito na pasta Equipes
de escalonamento e selecione Nova equipe
de escalonamento.
b. No campo Nome, insira um nome exclusivo
para a equipe de escalonamento.
c. Em Período de escalonamento, especifique
quanto tempo deseja que o escalonamento
dure.
d. Em Se não reconhecido, especifique a ação a
ser tomada se a notificação não for
reconhecida depois de ser enviada para todos
os contatos em uma equipe:
▪ Para interromper o processo de
escalonamento, selecione Finalizar
escalonamento.
▪ Para repetir o processo de escalonamento
por um determinado número de vezes até
que a notificação seja fechada ou
reconhecida, selecione Repetir N vezes.
▪ Para repetir o processo de escalonamento
indefinidamente até que a notificação seja
fechada ou reconhecida, selecione Repetir
enquanto ativo.
e. Escolha uma das seguintes ações:
▪ Clique em e, na janela Selecionar um
contato, localize um contato com uma
nova pesquisa ou selecione outro grupo
ou um endpoint de entrega e clique em
OK.
▪ Na paleta de Contatos, localize um contato
com uma nova pesquisa ou selecione
outro grupo ou um endpoint de entrega e
arraste-o para o visualizador.
f. Configure a sequência para a cadeia de
escalonamento.
▪ Clique em um assinante e clique em e
para posicionar conforme o necessário.
▪ Para remover um assinante, clique no
assinante a ser removido e clique em .
Guia do Usuário do PI System Explorer 429
Notificações

Crie um endpoint de entrega, como um e-mail ou
um serviço da web autônomo
a. Clique com o botão direito na pasta
Endpoints de entrega e selecione Novo
endpoint de entrega.
b. No campo Nome, insira um nome exclusivo
para o endpoint de entrega.
c. Insira as opções de contato de notificação
para endpoint de entrega nos campos
Intervalo de nova tentativa e Máximo de
novas tentativas.
d. Para Canal de entrega, selecione uma opção
de entrega.
▪ Para E-mail, insira as informações de
configuração de endereço conforme
descrito em Opções para as notificações
do canal de entrega de e-mail.
▪ Para WebService, insira as informações de
configuração de endereço do serviço da
Web conforme descrito em Opções para o
canal de entrega de serviço da web de
notificações.

3. Para salvar as alterações feitas nos contatos, pressione Ctrl+S ou clique em Fazer check-in.

Opções para as notificações do canal de entrega de e-mail

Um endpoint de entrega de e-mail pode ser configurado de forma específica ao canal de
entrega de e-mail, como o endereço para o qual a notificação é enviada. A seguinte tabela exibe
opções que estão disponíveis para todos os endpoints de entrega de e-mail:
Opção Descrição
To Email Endereço de e-mail para o qual a notificação é
enviada.
Esta opção não pode ser alterada no endpoint de
entrega de e-mail padrão que foi derivado do
contato do Active Directory (AD).

From Email Endereço de e-mail do qual a notificação é enviada.

Esta opção está disponível apenas se o System
Manager PI tiver configurado o canal de entrega de
e-mail com a configuração Allow contacts to
set sender email.

Use HTML formatting Especifica se um endpoint de entrega recebe

mensagens em formato HTML. A formatação em
HTML torna a leitura de mensagens mais simples e
permite que elas contenham hiperlinks.

Opções para o canal de entrega de serviço da web de notificações

Criar um delivery endpoint de serviço da web
Usando o plug-in Contatos do PI System Explorer (PSE), você pode configurar um delivery
endpoint para os serviços da web SOAP ou REST.

430 Guia do Usuário do PI System Explorer

 Notificações

Configurar o serviço da web SOAP

A tabela a seguir lista as opções que devem ser configuradas para um delivery endpoint de
serviço da web SOAP.
Opções do serviço da web SOAP
Opção Descrição
Web Service Address A URL de seu serviço da web. É possível validar a
conexão usando o botão Obter serviços da web.
Web Service O nome do serviço da web a ser usado para a
notificação.
Default Web Method Método da web padrão a ser usado para a
notificação. Este menu exibe todos os parâmetros
definidos no serviço da web.

A interface do usuário do PI System Explorer recupera automaticamente os métodos WSDL

(Web Service Definition Language) associados, fornece informações úteis sobre os parâmetros
e orienta o usuário ao longo da configuração do serviço da web.

Configurar o serviço da web REST

A tabela a seguir lista as opções que devem ser configuradas para um delivery endpoint de
serviço da web REST.
Opções do serviço da web REST
Opção Descrição
URL A URL de seu serviço da web.
HTTP Method Método da web padrão a ser usado para a
notificação. Os métodos suportados são POST, PUT
e PATCH.

Configuração de regras de notificação para análises ou

estruturas de evento
Os recursos do Asset Analytics e as notificações do PI AF Server oferecem, juntos, meios
eficazes para realizar a manutenção preditiva ou baseada em condições. As regras de
notificação aproveitam o recurso de event frame do PI AF para notificá-lo sobre eventos
importantes que afetam o sistema.
Esta seção o orienta na criação de regras de notificação para as suas análises ou estruturas de
evento.

Configurar regras de notificação por meio de análises

Se você já configurou análises para detectar anomalias nos dados de ativo do seu PI AF, ou
deseja configurar tais análises, siga este procedimento para configurar regras de notificação
em análises configuradas.

Antes de Iniciar
Para informações sobre requisitos do software e do sistema, consulte Requisitos para
notificações.

Guia do Usuário do PI System Explorer 431

Notificações

Nota:
Se desejar configurar regras de notificação para serem acionadas em estruturas de
evento por meio de fontes, como interfaces de estrutura de evento ou aplicativos
personalizados, consulte Configurar regras de notificação para estruturas de evento
definidas pelo usuário.
Para obter informações sobre como criar Analyses do Gerador de Event Frames, consulte
Análises de geração da estrutura de eventos.

Procedimento
1. Selecione a análise de geração de estrutura de evento existente para o qual deseja criar uma
regra de notificação.

2. Clique em Criar nova regra de notificação para a análise selecionada. Você verá a guia
Regras de notificação destacada, assim como as opções para configurar uma regra de
notificação com o nome padrão "Regra de notificação".

3. Editar uma regra de notificação criada.

Forneça um ou mais critérios específicos; alguns podem ser pré-selecionados por meio de
análise. A regra de notificação é disparada quando todos os critérios são satisfeitos. É
possível alterar o nome da regra de notificação a partir do padrão, adicione uma descrição
adequada e selecione uma categoria adequada.
A seleção de uma categoria ajuda na organização e pesquisa de suas regras de notificação.
4. Clique em Visualizar/editar gatilho
O painel Critérios de gatilho permite configurar qualquer um destes modos de critérios de
gatilho: Análise ou Pesquisa da Estrutura de Eventos. Certifique-se de que o modo de
critérios Análise esteja selecionado.
5. Configure as opções no painel Critérios de gatilho.

432 Guia do Usuário do PI System Explorer

 Notificações

◦ São exibidos os detalhes da análise selecionada, como o nome do template da estrutura

de evento, os gatilhos de início e fim e assim por diante.
◦ É possível configurar uma nova análise do tipo Geração de Estrutura de evento ou SQC.
Quando escolher criar uma nova análise com o nome padrão ou personalizado, você verá
a mesma janela de criação de análises que a da guia Análises do PI System Explorer.

6. Configure as opções no painel Opções.

◦ Opcional. Intervalo de reenvio. Selecione o intervalo durante o qual o serviço PI
Notifications enviará alertas adicionais se a estrutura de evento com a regra de
notificação não for reconhecida ou estiver fechada.
◦ Opcional. Intervalo sem repetição. Selecione o intervalo durante o qual o serviço PI
Notifications não enviará alertas semelhantes associados à mesma regra de notificação.
◦ A estrutura de evento pode ser reconhecida. Essa opção é selecionada automaticamente
se o template da estrutura de evento foi configurado para reconhecimento.
◦ Opcional. Opções com base em múltiplos acionadores de início. Se você configurou
múltiplos acionadores de início para análise, escolha entre as opções de notificação (a)
quando a severidade do gatilho atual for maior que qualquer severidade do gatilho
encontrada até o momento, (b) quando a severidade do gatilho atual for maior que a
severidade do gatilho anterior, ou (c) toda vez que uma condição de gatilho for
verdadeira, independentemente de sua severidade relativa em relação a gatilhos
anteriores.
7. Opcional. Para configurar o formato do e-mail, clique em Gerenciar formatos no painel de
Assinaturas. Você verá os painéis Mensagem e Conteúdo. Por padrão, o recurso de
notificações utiliza o formato e-mail padrão global para cada assinante.
Nota:
Se o painel Conteúdo tiver uma mensagem indicando que o formato selecionado é
"somente leitura", primeiro você deve adicionar um novo formato antes de
personalizá-lo.

Guia do Usuário do PI System Explorer 433

Notificações

8. Opcional. Para criar um formato de e-mail de entrega personalizado, copie o formato padrão
E-mail padrão global clicando no ícone copiar no painel Mensagem. Ou então, você pode
criar um novo formato de entrega, clicando no ícone novo formato de entrega .

O formato padrão inclui informações básicas de notificação, como o nome da regra de

notificação, hora do gatilho e hora de início da estrutura de evento, bem como informações
do sistema, como nomes do sistema e do banco de dados. Para adicionar mais informações
ao seu formato personalizado, arraste e solte as informações do painel Conteúdo para o
painel Mensagem.
Dica:
Um hiperlink indica que um template da estrutura de evento está selecionado; você
pode adicionar os atributos definidos abaixo do template da estrutura de evento ao
conteúdo do seu e-mail de notificação, arrastando e soltando os atributos do painel
Conteúdo para o painel Mensagem.
Você pode designar o formato personalizado como o padrão clicando na caixa É padrão no
painel Mensagem.
9. Clique em View/edit subscriptions (Visualizar/editar assinaturas) no painel Subscriptions
(Assinaturas).
Você pode pesquisar por contatos usando Pesquisa de contatos no painel Contatos. Para
adicionar um assinante, arraste e solte um contato específico do painel Contatos para o
painel Assinaturas. Certifique-se de selecionar o formato de e-mail personalizado, caso tenha
criado um, ou escolha um formato de e-mail padrão global.

10. Opcional. Configure equipes de escalonamento.

434 Guia do Usuário do PI System Explorer

 Notificações

Você pode configurar os membros das equipes de escalonamento do plug-in Contatos no PI

System Explorer, conforme descrito em Gerenciar contatos. Os contatos da equipe de
escalonamento ou grupos serão notificados um por um no final dos segmentos de tempo
especificados no Período de escalonamento. Você também pode controlar a frequência da
notificação de escalonamento.
Nota:
Os escalonamentos são acionados em templates de estruturas de eventos que podem
ser reconhecidos. Abra o plug-in Biblioteca no PI System Explorer, selecione o
template da estrutura de evento e verifique se a caixa de seleção Estrutura de evento
pode ser reconhecida está selecionada.
11. Faça o check-in da regra de notificação.
Quando o evento de interesse ocorrer, um e-mail será enviado para a caixa de entrada dos
assinantes. O e-mail mostra a estrutura de evento que disparou a regra de notificação com
detalhes personalizados que você configurou.

O que Fazer Depois

Para gerenciar as regras de notificação, use o plug-in Gerenciamento do PI System Explorer.
Consulte Gerenciamento das regras de notificação.

Configurar regras de notificação para estruturas de evento definidas pelo

usuário
Use esse procedimento se deseja configurar regras de notificação para acionar em estruturas
de evento de fontes como as interfaces da estrutura de evento ou aplicativos personalizados.

Antes de Iniciar
Para obter informações sobre requisitos de software e de sistema, consulte Requisitos para
notificações.
Nota:
Se você já configurou uma análise no seu ativo PI AF ou deseja criar novas análises para
gerar as estruturas de evento, use o procedimento Configurar regras de notificação por
meio de análises.

Procedimento
1. No navegador do PI System Explorer, clique em Elementos e selecione o elemento para o
qual deseja definir a regra de notificação.
2. Selecione a guia Regras de notificação.
3. Clique em Criar nova regra de notificação.
Altere o nome da regra de notificação em relação ao padrão, adicione uma descrição
adequada e selecione uma categoria adequada. A seleção de uma categoria ajuda na
organização e pesquisa de suas regras de notificação.
4. No painel Gatilho, clique no hiperlink Configure os critérios de gatilho para essa regra de
notificação.
O painel Critérios de gatilho permite configurar qualquer um destes modos de critérios de
gatilho: Análise ou Pesquisa da Estrutura de Eventos.
5. Selecione o modo de critérios de gatilho em Pesquisa da Estrutura de Eventos.
6. Configure as opções no painel Critérios de gatilho.

Guia do Usuário do PI System Explorer 435

Notificações

Você pode selecionar o template da estrutura de evento na lista suspensa e adicionar

condições usando qualquer um dos templates de atributos para o template da estrutura de
evento.

7. Configure as opções no painel Opções.

◦ Opcional. Intervalo de reenvio. Selecione o intervalo durante o qual o serviço PI
Notifications enviará alertas adicionais se a estrutura de evento com a regra de
notificação não for reconhecida ou estiver fechada.
◦ Opcional. Intervalo sem repetição. Selecione o intervalo durante o qual o serviço PI
Notifications não enviará alertas semelhantes associados à mesma regra de notificação.
Nota:
Verifique se o template da estrutura de evento está com a caixa de seleção Estrutura
de evento pode ser reconhecida marcada.
8. Opcional. Para configurar o formato de e-mail, clique em Gerenciar formato no painel
Assinaturas.
Você verá os painéis Mensagem e Conteúdo. Por padrão, as notificações usam o formato de
e-mail padrão global para cada assinante.
Nota:
Se o painel Conteúdo tiver uma mensagem indicando que o formato selecionado para
um assinante é "somente leitura", primeiro você deve adicionar um novo formato
antes de personalizá-lo.

436 Guia do Usuário do PI System Explorer

 Notificações

9. Opcional. Para criar um formato de e-mail de entrega personalizado, copie o formato padrão
E-mail padrão global clicando no ícone copiar no painel Mensagem. Ou então, você pode
criar um novo formato de entrega, clicando no ícone novo formato de entrega .

O formato padrão inclui informações básicas de notificação, como o nome da regra de

notificação, hora do gatilho e hora de início da estrutura de evento, bem como informações
do sistema, como nomes do sistema e do banco de dados. Para adicionar mais informações
ao seu formato personalizado, arraste e solte as informações do painel Conteúdo para o
painel Mensagem.
Dica:
Um hiperlink indica que um template da estrutura de evento está selecionado; você
pode adicionar os atributos definidos abaixo do template da estrutura de evento ao
conteúdo do seu e-mail de notificação, arrastando e soltando os atributos do painel
Conteúdo para o painel Mensagem.
Você pode designar o formato personalizado como o padrão clicando na caixa Is Default (É
padrão) no painel Mensagem.
10. Clique em Visualizar/editar assinatura no painel Assinaturas.
Você pode pesquisar por contatos usando Pesquisa de contatos no painel Contatos. Para
adicionar um assinante, arraste e solte um contato específico do painel Contatos para o
painel Assinaturas. Lembre-se de selecionar o formato de e-mail personalizado, se tiver
criado um, ou escolha o formato de e-mail padrão global.

11. Opcional. Configure equipes de escalonamento.

Guia do Usuário do PI System Explorer 437

Notificações

Você pode configurar os membros das equipes de escalonamento do plug-in Contatos no PI

System Explorer, conforme descrito em Gerenciar contatos. Os contatos da equipe de
escalonamento ou grupos serão notificados um por um no final dos segmentos de tempo
especificados no Período de escalonamento. Você também pode controlar a frequência da
notificação de escalonamento.
12. Faça o check-in da regra de notificação.
Quando o evento de interesse é gerado, um e-mail é enviado para a caixa postal do
assinante. O e-mail mostra a estrutura de evento que acionou a regra de notificação com os
detalhes personalizados que você configurou.

O que Fazer Depois

Para gerenciar as regras de notificação, use o plug-in Gerenciamento do PI System Explorer.
Consulte Gerenciamento das regras de notificação.

Configurar escalonamentos para regras de notificação

Uma equipe de escalonamento é uma coleção ordenada de endpoints de entrega ou grupos. As
mensagens de notificação são enviadas sequencialmente para os membros das equipes de
escalonamento até que a estrutura de evento correspondente à regra de notificação seja
reconhecida ou fechada. Você pode criar uma estrutura de escalonamento para garantir que as
pessoas certas sejam notificadas com as informações certas na ordem correta.
Inscreva uma equipe de escalonamento para enviar mensagens de notificação sequencialmente
a um grupo de contatos.

Gerenciamento das regras de notificação

Para gerenciar regras de notificação, use o Plug-in de Gerenciamento, acessível no canto
inferior esquerdo da tela principal do PI System Explorer. Ao ser acessado, o plug-in oferece a
opção de dois botões de seleção para gerenciar análises ou regras de notificação. Selecione o
botão Regras de notificação para exibir e gerenciar suas regras de notificação.

Pesquisa da regra de notificação

No painel Management (Gerenciamento), você pode usar as pesquisas fornecidas: todos,
ativado ou desativado ou inserir seus próprios critérios para pesquisar as regras de notificação
correspondentes.
Nota:
A pesquisa personalizada é visível somente para o usuário que a criou e no computador
em que ela foi criada.
Para criar uma pesquisa personalizada, clique no botão , insira um novo nome de pesquisa e
selecione os critérios da pesquisa na lista suspensa, que inclui Nome, Descrição, Template,
Service Status (Status do serviço), etc. A pesquisa pode ser feita com caracteres coringa (*).
Nota:
Uma vez que o Status é baseado na conexão do PI Analysis Service e seu status de
execução, ele não pode ser combinado com outros critérios de pesquisa.
Para excluir uma pesquisa, selecione-a e clique no botão . O ícone indica que a pesquisa
pode ser editada.
Os resultados da pesquisa (regras de notificação) são exibidos em uma grade no painel Regras
de notificação.

438 Guia do Usuário do PI System Explorer

 Notificações

Painel Regras de notificação

O painel Regras de notificação exibe as informações sobre as regras de notificação selecionadas
nestas colunas:
• Status: ativado ou desativado
• Elemento
• Nome da regra de notificação
• Template (template de regra de notificação)
• Categorias
Você pode marcar ou desmarcar as regras de notificação da lista de regras de notificação
configuradas e monitorar o status individual no painel Notification Rule Details (Detalhes da
regra de notificação). Também pode ativar ou desativar as regras de notificação selecionadas
no painel Operations (Operações).

Painéis Operations (Operações), Pending Operations (Operações pendentes) e

Notification Rule Details (Detalhes da regra de notificação)
As outras telas no console Management (Gerenciamento) incluem:
• O painel Operations (Operações), no qual você pode ativar ou desativar as regras de
notificação.
• Um painel de Operações pendentes que fornece informações sobre o andamento de uma
operação, se ela está na fila ou se foi concluída.
• Um painel de Detalhes da regra de notificação que é exibido ao selecionar a regra de
notificação e que tem informações sobre detalhes, erros e status da regra de notificação.
Clique em Configuração da Regra de notificação para voltar à guia do elemento Regras de
notificação.

Alterações do PI Notifications 2012

O recurso de notificações é baseado em estruturas de evento e não tem um mecanismo de
análise como o PI Notifications 2012 e versões anteriores (referidas daqui em diante como
versões “legado”). As regras de notificação usam o PI Analysis Service, bem como outros
aplicativos que geram estruturas de evento, para identificar eventos importantes no PI Server,
a fim de usar estruturas de evento como container de informações relevantes para o evento e
usar anotações na estrutura de evento para armazenar o histórico de notificações.
O recurso de notificações é orientado pelas estruturas de evento, portanto alguns recursos de
notificação legada são diferentes ou foram tornados obsoletos. Uma ferramenta de migração
está incluída para permitir a migração das notificações do seu PI Notifications 2012 versão
legada para as regras de notificação, preservando assim seu investimento no sistema legado.
Nota:
Se você optar por migrar, a ferramenta de migração converterá as notificações de legado
em regras de notificação e análises.
Para obter mais detalhes sobre a ferramenta de migração, consulte Migração do PI
Notifications 2012

Alterações na interface do usuário do PI Notifications 2012

As notificações no PI Server 2016 R2 (e versões posteriores) são fundamentalmente diferentes
das notificações no PI 2012 legado e você não pode compartilhar configurações entre os dois
sistemas.

Guia do Usuário do PI System Explorer 439

Notificações

Para configurar notificações baseadas em eventos, você deve usar a guia Regras de notificação
na visualização Elementos no PI System Explorer de 32 bits ou de 64 bits. Para gerenciar as
notificações de legado, você deve usar o plug-in Notificações no PI System Explorer de 32 bits.

Migração do PI Notifications 2012

O PI Server 2016 R2 e versões posteriores incluem uma ferramenta de migração para habilitar
a migração das notificações 2012 para as regras de notificação com base em estruturas de
evento. A ferramenta de migração é executada no final da instalação do serviço do PI
Notifications e você pode optar por migrar suas notificações de legado nesse momento.
Você também pode executar a migração novamente do PI System Explorer após a instalação
terminar. Para executar a ferramenta de migração do PI System Explorer, certifique-se de que
todas estas condições sejam verdadeiras:
• O serviço do PI Notifications está instalado em sua máquina
• O arquivo executável da ferramenta de migração PINotificationsMigrationTool.exe
está instalado em sua máquina, normalmente na pasta PIPC\Notification
A ferramenta de migração causa estas migrações de objetos:
• Os gatilhos de notificação legada são migrados como análises de geração de estrutura de
evento e são executados no PI Analysis Service.
• As notificações de legado criadas em versões anteriores são migradas para regras de
notificação e executam no serviço do PI Notifications.
• O histórico das notificações de legado é totalmente migrado e criado como estruturas de
evento. O histórico nos pontos PI é migrado como anotações em estruturas de evento.
• O nome, a descrição e as propriedades do template de notificação de legado são mapeados
para as propriedades da notificação e o elemento monitorado, e uma mensagem também é
registrada no relatório de migração.

Vídeo de tutorial
Para obter mais informações sobre a migração, assista ao vídeo do canal OSIsoft Learning:
https://www.youtube.com/watch?v=bGdN6VrBVUw (Como migrar do PI Notifications 2012
para as regras de notificação com o Servidor AF 2016 R2)

Executar a ferramenta de migração

Antes de iniciar a migração, você deve verificar se tem permissões read no PI Data Archive
onde o histórico das notificações de legado é armazenado e permissões read/write no banco
de dados do PI AF onde as notificações de legado são configuradas.

440 Guia do Usuário do PI System Explorer

 Notificações

Pode ser necessário fazer backup do PIFD (banco de dados do SQL) se desejar executar a
migração novamente e evitar a criação duplicada de objetos de regra de notificação e análise.
Se você executar novamente a migração e receber um aviso de que duplicatas podem ser
criadas durante a nova migração, é possível primeiro restaurar o banco de dados do PIFD do
backup e evitar a criação de duplicatas. Para obter instruções sobre como realizar um backup
do banco de dados do PIFD, consulte o tópico do PI Server "OSIsoft Backup job" in Live Library
(https://livelibrary.osisoft.com) (Trabalho de backup da OSIsoft).
Você pode executar novamente a ferramenta de migração clicando em Ferramentas > Migração
de notificações do PI System Explorer. A ferramenta de migração primeiro determina e exibe
informações sobre o seu estado, que é um dos seguintes:

• Migração não realizada

As notificações de legado podem ser criadas e gerenciadas usando o plug-in Notificações no
canto inferior esquerdo da janela do PI System Explorer. Você deve usar a versão de 32 bits
do PI System Explorer para gerenciar as notificações de legado.
Você pode optar pelo estado "Migração não realizada" escolhendo a opção adequada
durante a execução da ferramenta de migração. Nesse estado, você não pode criar novas
regras de notificação.

• Em migração
As notificações de legado são somente leitura; apenas novas regras de notificação podem
ser criadas. Você pode interromper e iniciar as notificações de legado enquanto estiver
nesse estado.
No estado Em migração, você pode executar e testar as notificações de legado e as novas
regras de notificação lado a lado, a fim de garantir que a migração seja bem-sucedida e que
as novas regras de notificação e análises funcionem como esperado. Você pode verificar o
relatório de migração, corrigir os erros indicados nas notificações de legado e depois
executar novamente a migração apenas para as notificações de legado que identificaram
erros na execução anterior de migração.
É possível mover-se para o estado Migração realizada com êxito depois de testar com
sucesso que as regras de notificação migradas correspondem às notificações de legado. Faça
a transição para o estado Migração realizada com êxito apenas quando o seguinte for
verdadeiro:
◦ Você pretende continuar a trabalhar apenas com as novas regras de notificação
◦ Você nunca precisará reverter para as notificações de legado
◦ Você migrou com sucesso todas as notificações de legado que desejava migrar

• Migração realizada com êxito

Ao mover-se para esse estado, você pode criar apenas novas regras de notificação no
sistema. Suas notificações de legado são excluídas e você não pode reverter para as
notificações de legado ou criar notificações de legado.
Do estado migração realizada com êxito, você pode executar novamente a ferramenta de
migração para reverter para o estado "Migração não realizada"; no entanto, as notificações
de legado não podem ser recuperadas.

Amostra do relatório de migração

A ferramenta de migração gera um relatório quando conclui o processo de migração. O
relatório informa se as notificações de legado foram migradas com êxito. As seções "Erros" e
"Sem suporte" indicam as notificações cuja migração não foi realizada. A seção "Advertências"
indica notificações com funcionalidade alterada e o relatório fornece mais informações. Este é
um resumo da amostra do relatório de migração:

Guia do Usuário do PI System Explorer 441

Notificações

Além do resumo, o relatório também contém informações sobre templates e regras de

notificação de legado e migrados e informações específicas, como nomes das regras de
notificação e análises, número de estruturas de evento migradas e número de eventos de
histórico processados.

Recursos adicionais
Vídeo de tutorial
Para obter mais informações sobre como usar notificações no PI Asset Framework, assista aos
vídeos na playlist do canal OSIsoft Learning:
https://www.youtube.com/playlist?list=PLMcG1Hs2Jbcs43wQ2qO2dxW72PqGhZjKW

442 Guia do Usuário do PI System Explorer

Processar modelos no PI AF
Um modelo PI AF é composto por elementos conectados que representam um modelo lógico do
processo. O próprio modelo é um elemento, mas com duas propriedades de elemento
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 PI AF 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.

Nesta seção
• O escopo de um modelo do PI AF
• Diretrizes para modelos PI AF
• Submodelos
• Tipos de elemento em modelos
• Criar modelos do PI AF
• Editar modelos PI AF
• Portas e conexões
• Camadas

O escopo de um modelo do PI AF
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
◦ Esse nível de modelagem normalmente inclui as informações mais detalhadas possíveis
em uma unidade ou área de processamento. 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.

Guia do Usuário do PI System Explorer 443

Processar modelos no PI AF

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 a unidade, as informações na unidade são
tipicamente resumidas pelas conexões para a unidade e a partir dela. O material
adicionado 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 de limite (instalação e unidade de negócios)
◦ É útil criar uma análise para os materiais que entram e saem da "linha de demarcação" da
instalação, resumindo ainda mais as informações de unidade a unidade para somente as
transações ao processo e a partir dele dos pontos de transferência de material (deques de
remessa, escalas de peso, alimentações de tanque, pipelines). Esse nível também é útil
para analisar transações entre unidades de negócio em uma fábrica.

Diretrizes para modelos PI AF

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.

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.

Tipos de elemento em modelos

Seis tipos de elemento principal são usados para aplicar regras de conectividade entre
elementos de um modelo.

444 Guia do Usuário do PI System Explorer

 Processar modelos no PI AF

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

Criar modelos do PI AF
Crie um modelo PI AF no navegador de Elementos.

Procedimento
1. No navegador, clique em Elementos.
2. Clique com o botão direito na coleção de elementos e clique em Novo modelo.
3. Na janela Escolher template do modelo, selecione um modelo no qual basear o modelo ou
selecione Nenhum.
4. Clique em OK. As guias configuração do modelo aparecem no visualizador.
5. No campo Nome da guia Geral, insira um nome para o modelo.
6. Opcional. No campo Descrição, insira uma descrição para o modelo.
7. Os campos Template e Tipo de somente leitura listam 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 elementos são descritos em Tipos de elemento em modelos.

8. Opcional. Podem-se organizar objetos agrupando-os em categorias. Para navegar nas

categorias disponíveis, clique em .
9. Para atribuir um atributo padrão, selecione o atributo na lista suspensa Atributo padrão.
Observe que é necessário adicionar atributos na guia Atributos antes de eles aparecerem na
lista. Esse campo será somente leitura se o modelo estiver baseado em um template; a caixa
exibirá o atributo especificado no template.
10. Opcional. Para configurar permissões de acesso para o novo modelo que são diferentes
daquelas herdadas da coleção Elementos, clique no link Segurança. Para obter mais
informações, consulte Configurar segurança para objetos.
11. Clique em OK e faça o check-in do seu trabalho.

Editar modelos PI AF
Visualize ou edite os modelos PI AF na janela <Model Name>Conexões.

Guia do Usuário do PI System Explorer 445

Processar modelos no PI AF

Procedimento
1. Clique com o botão direito em um modelo no navegador de Elementos e clique em
Conexões de modelo.
A janela <Model Name> Conexões mostra uma representação visual dos elementos no
modelo e como eles estão conectados.
2. Para editar o modelo:
◦ Clique com o botão direito 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 ou 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 e colar as propriedades da
conexão.

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

Antes de Iniciar
Para especificar a porta como padrão, abra a janela Propriedades.

Procedimento
1. No navegador de Elementos, selecione um elemento e, em seguida, clique na guia Portas no
visualizador.

446 Guia do Usuário do PI System Explorer

 Processar modelos no PI AF

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 ou editar suas propriedades.
3. Configure a porta.
◦ Tipo de porta: selecione o tipo de porta: Entrada, Saída ou Não direcionada (para metros,
por exemplo).
◦ Categorias permitidas: selecione as categorias nas quais é permitido que a porta seja um
membro.
◦ 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.
◦ Tipo de conexão: selecione o tipo de elemento no qual 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.

Criar conexões
Use a guia Conexões para exibir as conexões de um modelo.

Procedimento
1. Para criar um novo modelo no navegador de Elementos, clique com o botão direito na
coleção de elementos conforme descrito em Criar modelos do PI AF 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.
b. Na janela Fazer conexão, clique com o botão direito em uma conexão existente para
visualizar ou editar suas propriedades.
c. No campo Origem, selecione a origem da conexão. Selecione a porta apropriada da
origem no campo Portas correspondente.
d. No campo Destinos, selecione o destino da conexão. Selecione a porta apropriada de
destino no campo Portas correspondente.
Para incluir elementos filho, 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 PI ProcessBook, para
fornecer uma funcionalidade de sobreposição visual.

Criar camadas
Criar uma camada para incluir ou excluir partes de um modelo.

Guia do Usuário do PI System Explorer 447

Processar modelos no PI AF

Procedimento
1. No navegador de Elementos, selecione o modelo ao qual deseja adicionar uma camada.
2. Clique na guia Camadas no visualizador.
3. Clique com o botão direito e clique em Nova camada.
4. No campo Nome da janela Propriedades da camada, insira um nome exclusivo para a
camada.
5. Opcional. No campo Descrição, descreva o efeito da camada.
6. Na lista de elementos, selecione um ou mais elementos que compõem a camada.
7. Clique em OK.

448 Guia do Usuário do PI System Explorer

Utilitários e plug-ins do PI AF
Após a instalação do PI AF, vários utilitários estão disponíveis para auxiliá-lo na administração
do PI AF e no gerenciamento de plug-ins.

Nesta seção
• Iniciar o PSE com opções de linha de comando
• Utilitário PI AF Diagnostics
• Utilitário AF Update Plug-in Configurations
• Configurar o utilitário PI AF Server
• Capturar a saída de rastreio de eventos do AF SDK
• Rastrear as alterações no PI AF com trilha de auditoria
• Visualizar plug-ins instalados
• Registro de plug-in da linha de comando
• Criar um arquivo de registro XML
• Criar um script de registro SQL
• Registrar plug-ins com os scripts SQL gerados
• Gerenciamento de fornecedor de plug-in

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 é denominado AFExplorer.exe e
está localizado na pasta \PIPC\AF.

Procedimento
1. Abra uma janela de comando do Windows e mude para a pasta \PIPC\AF.
2. Tipo:
afexplorer parameter=paramValue

onde parameter é dos três parâmetros a seguir:

◦ /system
◦ /database
◦ /navigator
Para exibir uma lista de parâmetros disponíveis, digite:
afexplorer /?

Parâmetros do AFExplorer
A seguinte tabela lista os parâmetros disponíveis para o utilitário AFExplorer .

Guia do Usuário do PI System Explorer 449

Utilitários e plug-ins do PI AF

Parâmetro Descrição Exemplo

/system Configura o parâmetro do afexplorer /system=MyAFServer
sistema para o nome do host do
servidor PI AF ao qual o PSE deve
se conectar por padrão.
/database Configura o parâmetro do banco afexplorer /database=MyAFDatabase
de dados para o nome do banco
de dados PI AF que o PSE deve
abrir inicialmente.
/navigator Configura o parâmetro do afexplorer /navigator=Elements
navegador para o plug-in do
navegador que deve ser
selecionado inicialmente no PSE.

Valores do parâmetro do navegador

A seguinte tabela lista os valores disponíveis para o parâmetro navigator.
Valor do parâmetro Exemplo
Elements afexplorer /Navigator=Elements
EventFrames afexplorer /Navigator=EventFrames
Library afexplorer /Navigator=Library
UnitOfMeasure afexplorer /Navigator=UnitOfMeasure
Analyses afexplorer /Navigator=Analyses
MyPI afexplorer /Navigator=MyPI
Nota:
Use somente se as notificações de legado estiverem presentes em um
computador cliente PI AF.

Notifications afexplorer /Navigator=Notifications

Nota:
Use somente se as notificações de legado estiverem presentes em um
computador cliente PI AF.

AFContactNavigator afexplorer /Navigator=AFContactNavigator

Management afexplorer /Navigator=Management

Utilitário PI AF Diagnostics
O utilitário PI AF Diagnósticos (AFDiag) é um utilitário de linha de comando que pode ser
usado para ativar ou desativar recursos do servidor PI AF e executar outras funções
administrativas. O utilitário faz uma conexão direta com o banco de dados do SQL Server
associado e exige a função sysadmin ou db_afadmin do SQL Server.
AFDiag está localizado na pasta \PIPC\AF.

Nesta seção
• Conceder permissões para o utilitário Diagnósticos PI AF
• Executar o utilitário AFDiag
• Parâmetros do utilitário AFDiag
• Implementação da trilha de auditoria

450 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Conceder permissões para o utilitário Diagnósticos PI AF

Para usar o utilitário Diagnósticos de PI AF, é 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 a pasta Segurança e depois a pasta Logins.
3. Clique com o botão direito do mouse no login que corresponda ao usuário apropriado do
Windows e selecione Propriedades.
4. Selecione a página Mapeamento do usuário.
5. Selecione a linha do banco de dados PIFD.
6. Marque a caixa de seleção Mapear do banco de dados PIFD.
7. Com o banco de dados ainda selecionado, marque a caixa de seleção da função do banco de
dados db_AFadmin, conforme mostrado na figura a seguir.

8. Clique em OK para salvar suas alterações e fechar o Microsoft SQL Server Management
Studio.

Guia do Usuário do PI System Explorer 451

Utilitários e plug-ins do PI AF

Executar o utilitário AFDiag

Execute o utilitário AFDiag em uma janela do command prompt do Windows elevada.

Procedimento
1. Como administrador, abra um command prompt do Windows e altere o diretório para
\PIPC\AF.
2. Escolha uma das seguintes ações.
Para... Faça o seguinte...
Exibir as definições de configuração atuais Digite afdiag sem nenhum parâmetro
especificado.
Uma lista de configurações atuais é exibida para
o servidor PI AF, banco de dados, Active
Directory e outros itens de configuração, como
trilha de auditoria, extensões de arquivos e o
tamanho máximo de arquivos anexados a objetos
do PI AF.

Exibir uma lista de parâmetros disponíveis Digite afdiag /?

Executar uma tarefa de configuração específica Digite afdiag parameter
onde parameter é dos parâmetros listados em
Parâmetros do utilitário AFDiag.

Parâmetros do utilitário AFDiag

Os parâmetros para o utilitário AFDiag estão listados em ordem alfabética abaixo.

/ActiveDirectory:string
Forma curta Descrição
/AD Testa o acesso ao Active Directory usando as configurações atualmente efetuadas no
servidor PI AF. Uma conta opcional do usuário pode ser especificada para testar outra
conta. Se uma conta for especificada ou definida nas configurações do servidor PI AF,
será necessário também especificar o parâmetro Password.

/CertificateAdd
Forma curta Descrição
/CA Adiciona o certificado de cliente especificado para o banco de dados SQL ServerPI AF.
Use o parâmetro Password para especificar uma senha para o certificado, se
necessário.

/CertificateList
Forma curta Descrição
/CL Lista os certificados de cliente armazenados no banco de dados PI AF SQL Server.

/CertificateRemove
Forma curta Descrição
/CR Remove um certificado de cliente do banco de dados PI AF SQL Server, especificando o
nome do certificado.

452 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

/CertificateSet:string
Forma curta Descrição
/CS Configura o certificado do servidor no arquivo de configuração do servidor PI AF para
o arquivo especificado. Use o parâmetro Password para especificar uma senha para o
certificado, se necessário.

/ChangeID:string
Forma curta Descrição
/CID Altera a ID para o servidor PI AF do GUID especificado.
• 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 servidor PI AF.
• Um valor de retorno negativo indica um erro.

/ClearChangeTables
Forma curta Descrição
/CCT Limpa as tabelas findChanges e afdiag que registram informações sobre as
alterações ao sistema.

/DeleteCases
Forma curta Descrição
/DelC Exclui casos do banco de dados do PI AF SQL Server cuja hora de início seja anterior à
data especificada no formato mês/dia/ano (por exemplo, /DelC:"11/24/2016").

/DeleteEventFrames
Forma curta Descrição
/DelEF Exclui event frames do banco de dados do PI AF SQL Server cuja hora de término seja
anterior à data especificada no formato mês/dia/ano (por exemplo, /
DelEF:"11/24/2016").

/DeleteTransfers
Forma curta Descrição
/DelTR Exclui transferências do banco de dados do PI AF SQL Server cuja hora de término seja
anterior à data especificada no formato mês/dia/ano (por exemplo, /
DelTR:"11/24/2016").

/DeleteAuditTrail
Forma curta Descrição
/ATD Desabilita o recurso de trilha de auditoria e exclui registros de trilha de auditoria no
banco de dados SQL Server PI AF. Essa operação exclui permanentemente os registros
da trilha de auditoria e exige privilégios sysadmin. Os registros de trilha de auditoria
não podem ser recuperados se uma exclusão for executada.

/EnableAuditTrail
Forma curta Descrição
/AT Ativa o recurso de trilha de auditoria para o banco de dados PI AF SQL Server.

Guia do Usuário do PI System Explorer 453

Utilitários e plug-ins do PI AF

/EnableExternalDataTables[-]
Forma curta Descrição
/DT Ativa o suporte a tabelas PI AF externas.

/EnablePropagationOfTargetDeletion[-]
Forma curta Descrição
/PTD Ativa o suporte para propagar a exclusão de destinos (elementos) nas análises e
notificações de referência.

/ExeFile:string
Forma curta Descrição
/F O caminho para o arquivo executável do servidor PI AF. O valor padrão é
AFService.exe.

/ExternalDataTablesAllowNonImpersonatedUsers[-]
Forma curta Descrição
/DTImp Ativa o suporte a tabelas PI AF externas para usuários não representados.

@<file>
Forma curta Descrição
Lê o arquivo de resposta para verificar mais opções. O arquivo de resposta deve
conter um parâmetro por linha. As linhas de comentários começam com o caractere
"#".

/FileExtensions:string
Forma curta Descrição
/FE Define os tipos de objetos de arquivos que podem ser anexados a um objeto de
arquivo PI AF, como uma anotação. Os seguintes tipos de arquivos são suportados:
• MS Office: csv, docx, pdf, xlsx
• Texto: rtf, txt
• Imagem: gif, jpeg, jpg, png, svg, tiff
• ProcessBook: pdi
Insira as extensões como uma lista separada por dois-pontos, por exemplo:
/FE:docx:xlsx:csv:pdfd:pdi:jpg:png

/FileExtensionsAdd:string
Forma curta Descrição
/FEA Adiciona uma extensão de arquivo adicional à lista de tipos de objetos de arquivos PI
AF permitidos. Consulte a lista de tipos de arquivos compatíveis acima.
Este parâmetro pode ser especificado mais de uma vez.

454 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

/FileExtensionsRemove:string
Forma curta Descrição
/FER Remove uma extensão de arquivo da lista de tipos de objetos de arquivos PI AF
permitidos. Consulte a lista de tipos de arquivos compatíveis acima.
Este parâmetro pode ser especificado mais de uma vez.

/FileMaxLength:integer
Forma curta Descrição
/FML Define o tamanho máximo em megabytes de um objeto de arquivo PI AF, como uma
anotação. Um valor de zero desabilita o suporte para todos os arquivos. O tamanho
máximo padrão de arquivos permitido é 10 MB.

/NewID
Forma curta Descrição
/NID Gera uma nova ID para o servidor PI AF.
• 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 servidor PI AF.
• Um valor de retorno negativo indica um erro.

/Password
Forma curta /PWD
/PWD Especifica uma senha do certificado para as opções CertificateSet,
CertificateAdd ou ActiveDirectory.

/PlugInVerifyLevel=level
Forma curta Descrição
/VL Configura o nível de verificação necessário para os plug-ins serem executados. Os
níveis válidos são:
• 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.

Guia do Usuário do PI System Explorer 455

Utilitários e plug-ins do PI AF

/Port:integer
Forma curta Descrição
/P Testa a porta específica ao servidor PI AF. Pode ser usado para realizar testes básicos
de porta e descobrir se a porta especificada no computador usado pelo servidor PI AF
pode ser aberta, e se algo está escutando para realizar a conexão na porta. As portas
padrão usadas pelo servidor PI AF 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, você testaria as portas 5457 e 5459.

/RebuildPathCache
Forma curta Descrição
/RPC Reconstrói o cache do caminho para cada elemento no banco de dados SQL Server PI
AF. O cache do caminho pode ficar desatualizado após inserções, edições e/ou
exclusões de dados significativas. A reconstrução do cache do caminho pode melhorar
o desempenho do servidor PI AF.
Nota:
O procedimento armazenado usado para reconstruir o cache do caminho não é
suportado em um servidor PI AF secundário (um assinante) em um PI AF
Collective.

/Reindex
Forma curta Descrição
/RI Recria completamente cada índice no banco de dados SQL Server PI AF. Isso melhora
substancialmente o desempenho do servidor PI AF após uma inserção de dados
massiva.

/ResetAdministrator:string
Forma curta Descrição
/SRA Redefine as permissões na identidade Administrators para permitir privilégios
totais no PI System local. Este parâmetro exige privilégios sysadmin ou db_owner.
O padrão /sra permite privilégios para a conta BUILTIN\Administrators.
/sra:domainName\username permite privilégios para uma determinada conta de
usuário.

/Silent[-]
Forma curta Descrição
/S Executa o modo silencioso e impede a exibição da mensagem.

/TrustedProviderAdd:providername
Forma curta Descrição
/PA Adiciona o provedor especificado à lista de provedores de plug-ins confiáveis. Para
adicionar provedores, é necessário ter a função do servidor SQL Server sysadmin ou a
função do banco de dados db_AFadmin.

456 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

/TrustedProviderList
Forma curta Descrição
/PL Exibe uma lista de provedores de plug-ins confiáveis. Para listar provedores, é
necessário ter a função do servidor SQL Server sysadmin ou a função do banco de
dados db_AFadmin.

/TrustedProviderRemove:providername
Forma curta Descrição
/PR Remove o provedor especificado da lista de provedores de plug-ins confiáveis. Para
excluir provedores, é necessário ter a função do servidor SQL Server sysadmin ou a
função do banco de dados db_AFadmin.

/UomCaseSensitive[-]
Forma curta Descrição
/UCS Altera a configuração de abreviações de UDM de não sensível a maiúsculas e
minúsculas para sensível a maiúsculas e minúsculas no banco de dados SQL Server PI
AF. Quando habilitado, apenas um PI AF Client 2015 R2 (v 2.7.5) ou posterior pode se
conectar.
Para obter mais informações, consulte Configuração de abreviações de UDM sensíveis
a maiúsculas e minúsculas.

/UpgradeAuditTrail
Forma curta Descrição
/ATU Atualiza os registros de trilha de auditoria no banco de dados PI AF SQL Server.
Suporta atualizações a partir do PI AF 2.6 ou posterior.

/Version
Forma curta Descrição
/V Exibe informações sobre a versão.

Implementação da trilha de auditoria

Use o utilitário AFDiag e o parâmetro EnableAuditTrail (/AT) para ativar o recurso trilha
de auditoria para o banco de dados SQL PI AF. Uma vez ativados, os registros da trilha de
auditoria são criados usando os trabalhos do SQL Server Agent. É possível verificar a trilha de
auditoria com o Process Explorer.
Use o parâmetro DeleteAuditTrail (/ATD) para desativar o recurso trilha de auditoria e
excluir todos os registros de trilha de auditoria permanente. Depois que você usar este
parâmetro, a trilha de auditoria não poderá mais ser recuperada. Você deve ter privilégios
sysadmin no SQL Server para usar este parâmetro.

Requisitos
O recurso trilha de auditoria usa o SQL Server Change Data Capture (CDC) para gerar uma
trilha de auditoria. O CDC é suportado nas versões a seguir do SQL Server:
Versão Enterprise Desenvolvedor ¹ Avaliação ¹
SQL Server 2008

Guia do Usuário do PI System Explorer 457

Utilitários e plug-ins do PI AF

Versão Enterprise Desenvolvedor ¹ Avaliação ¹

SQL Server 2008 R2
SQL Server 2012
SQL Server 2014

SQL Server 2016 ²

¹
Sistema de desenvolvimento somente.

²
Suportado apenas no PI AF 2016 e mais tarde. Para obter mais detalhes sobre o suporte CDC, consulte o artigo do Suporte
Técnico OSIsoft KB01410 – erro do PI AF: Não foi possível encontrar o procedimento armazenado
sys.sp_cdc_parse_captured_column_list (https://techsupport.osisoft.com/Troubleshooting/KB/KB01410).

O recurso trilha de auditoria tem os seguintes requisitos adicionais:

• O SQL Server Agent deve estar em execução antes que você ative o recurso trilha de
auditoria.
• Você deve ser um membro da função sysadmin no SQL Server que contém o banco de dados
SQL PI AF.

Versões anteriores
O recurso trilha de auditoria lançado no PI AF 2.6.0 ou posterior é compatível com esta
instalação e é atualizado quando os scripts SQL PI AF são executados. Nesse momento, os
registros de trilha de auditoria são atualizados para o formato atual. Se, por algum motivo,
ocorrer uma falha durante a atualização, você poderá usar o parâmetro AFDiag
UpgradeAuditTrail (/ATU) para corrigir os registros e as tabelas da trilha de auditoria.
As versões do recurso trilha de auditoria anteriores ao PI AF 2.6.0 têm um formato diferente e
não são mais atualizadas com novos registros de alteração depois de uma atualização do banco
de dados SQL PI AF. Tabelas e dados existentes permanecem intactos, mas novos registros não
podem ser adicionados.

Suporte à trilha de auditoria em coletivos PI AF

O recurso trilha de auditoria não é suportado em membros secundários de coletivos PI AF. Se o
recurso trilha de auditoria estiver atualmente habilitado em um servidor que você deseja
adicionar como servidor secundário a um coletivo PI AF, será necessário executar o utilitário
AFDiag e desativar o recurso. 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 nenhum 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 coletivo PI AF ficar
indisponível, os dados da trilha de auditoria também estarão indisponíveis. Se o membro
principal de um coletivo PI AF não puder ser recuperado de um backup, os dados da
trilha de auditoria também não poderão ser recuperados.

Reativar a trilha de auditoria

Se você adicionar um servidor existente do PI AF com a trilha de auditoria habilitada para um
coletivo como um membro secundário mas, mais tarde, remover esse servidor do coletivo, você
precisa reativar o recurso trilha de auditoria neste servidor em particular. Caso contrário, a
auditoria permanecerá desativada.

458 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Utilitário AF Update Plug-in Configurations

O utilitário AFUpdatePlugInConfigurations fornece um recurso Repair, CreateConfig e
ReplacePIServer que permite que você execute atualizações em massa de strings de
configuração de atributos com um único comando. Depois de executar o utilitário, clique em
no PI System Explorer para verificar as alterações.

A seguinte tabela lista os parâmetros disponíveis para o utilitário

AFUpdatePlugInConfigurations . Apenas um recurso de cada vez pode ser especificado em
combinação com os parâmetros -root e -list.
Parâmetro Descrição
-Repair Parâmetro padrão se nenhum parâmetro for especificado. Para atributos no servidor
ou banco de dados PI AF especificado no parâmetro -root, corrija os atributos da
referência dos dados do ponto PI para os quais a string de configuração armazenada
tornou-se fora de sincronização com o PI Data Archive. Isso pode ocorrer pelos
seguintes motivos:

• Pontos PI excluídos: quando os pontos PI são excluídos e recriados com o mesmo

nome, o ID do novo ponto não corresponde ao ID na string de configuração
armazenada.
• Pontos PI renomeados: quando os pontos PI são renomeados, a string de
configuração armazenada ainda usa o antigo nome do ponto PI.
• Atributos não resolvidos: se ainda não tiver sido criado o ponto PI para o qual
uma referência de dados aponta, a string de configuração armazenada não
conterá o point ID.

-CreateConfig Para atributos no servidor ou banco de dados PI AF especificado no parâmetro -

root, crie o ponto PI, se ele ainda não existir, ou atualize-o com todas as alterações.
Esta é a mesma operação que quando você clica com o botão direito em um
elemento ou atributo no PI System Explorer e escolhe Criar ou atualizar o ponto PI.

-ReplacePIServer Para atributos de referência de dados do ponto PI no servidor ou banco de dados PI

AF especificado no parâmetro -root, redirecione os atributos para um PI Data
Archive diferente.
Use dois-pontos (:) para preceder o nome do PI Data Archive existente. Separe o
nome do PI Data Archive existente do nome do novo PI Data Archive com um ponto
e vírgula (;).

-list Use juntamente com qualquer um dos três recursos acima. Para o servidor ou banco
de dados PI AF especificado no parâmetro -root, liste todos os atributos a serem
operados.
-root Use juntamente com qualquer um dos três recursos acima. Especifica o servidor ou
banco de dados PI AF no qual operar. Coloque a string do parâmetro inteira entre
aspas (" ").

Exemplo de sintaxe -Repair

Para reparar strings de configuração armazenadas no banco de dados PI AF especificado para
que sejam corretamente mapeadas para os pontos PI no PI Data Archive, use a seguinte
sintaxe:
afupdatepluginconfigurations "-root:\\MyAFServer\MyAFDatabase" -Repair

Exemplo de sintaxe -CreateConfig

Para executar uma operação CreateConfig em massa em todos os atributos em um banco de
dados PI AF, use a seguinte sintaxe:
afupdatepluginconfigurations "-root:\\MyAFServer\MyAFDatabase" -CreateConfig

Guia do Usuário do PI System Explorer 459

Utilitários e plug-ins do PI AF

Para executar a operação CreateConfig em todos os atributos em um servidor PI AF específico,

use a seguinte sintaxe:
afupdatepluginconfigurations "-root:\\MyAFServer" -CreateConfig

Exemplo de sintaxe -ReplacePIServer

Para redirecionar todos os atributos de referência de dados do ponto PI em um banco de dados
PI AF especificado para um novo PI Data Archive, use a seguinte sintaxe:
afupdatepluginconfigurations "-root:\\MyAFServer\MyAFDatabase"
-ReplacePIServer:OldPIDataArchive;NewPIDataArchive

Configurar o utilitário PI AF Server

O utilitário SetPISystem (setpisystem) permite configurar os servidores PI AF conhecidos.
setpisystem está localizado no diretório PIPC\AF.

Parâmetros do utilitário SetPISystem

A tabela a seguir lista os parâmetros disponíveis para o utilitário SetPISystem.
Parâmetro Forma curta Descrição
/Name:string /N Especifica o nome do servidor PI AF para modificar
ou criar. Se não especificado, o servidor padrão PI
AF será usado.
/Host:string /H Especifica o nome de host para o servidor PI AF.
/Protocol:Tcp|NamedPipe /C Especifica o protocolo para o servidor PI AF.
/Port:integer /P Especifica a porta para o servidor PI AF.
/Timeout:integer /T Especifica o tempo limite para o servidor PI AF em
segundos.
/AccountName:string /A Especifica o nome de conta para o servidor PI AF.
/DefaultPISystem /D Configura o servidor especificado PI AF como o
servidor padrão PI AF.
/Remove /R Remove o servidor especificado PI AF da lista de
servidores conhecidos PI AF.
/Silent[-] /S Estabelece o modo silencioso que impede a
exibição da mensagem.
/List /L Lista os servidores atuais conhecidos PI AF.
/AddAlias:string /AA Adiciona o alias específico para o servidor PI AF.
/RemoveAlias:string /RA Remove o alias específico do servidor PI AF.

Capturar a saída de rastreio de eventos do AF SDK

Use o utilitário AFGetTrace (afgettrace.exe) para capturar a saída de rastreio de eventos
do AF SDK. O rastreamento de eventos pode ajudar na depuração de um aplicativo e executar a
análise de capacidade e desempenho.

Procedimento
1. Abra uma janela de comando e altere o diretório para PIPC\AF.
2. Escolha uma das seguintes ações:

460 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Para... Faça o seguinte...

Exibir sintaxe e parâmetros No command prompt, digite:
afgettrace /?

Execute AFGetTrace com configurações padrão No command prompt, digite:

afgettrace
A saída padrão vai para saída padrão.

Execute AFGetTrace com parâmetros No command prompt, digite:

específicos
afgettrace /parameter
Consulte Parâmetros do utilitário AFGetTrace
para obter detalhes sobre os parâmetros que
podem ser usados.

Encerrar o rastreio de eventos Na janela de comando, digite:

X
Nota:
Se você fechar a janela de comando sem
encerrar afgettrace, os eventos de
rastreio continuarão a ser gerados, o que
pode fazer com que seus aplicativos AF SDK
fiquem lentos.

Parâmetros do utilitário AFGetTrace

A tabela a seguir lista os parâmetros disponíveis para o utilitário AFGetTrace .
Parâmetro Forma curta Descrição
/Provider:string /P Especifica o nome da sessão de rastreamento de evento.
É necessário apenas especificar o uso de um provedor
para rastrear um evento existente. O valor padrão é
AFGetTrace.
/Level:{Critical|Error| /L Especifica o nível de detalhe a ser incluído nos eventos
Warning|Warning|Information| escritos pelo AF SDK. Um detalhe na ou acima da
Verbose|Detail} severidade do nível escolhido é gerado. O valor padrão
é Verbose.
/Keywords:{None|Server| /K Especifica as palavras-chave usadas para determinar a
Connection|Cache|Events|Trace| categoria de eventos que se deseja que o AF SDK grave.
Data|All} O AF SDK grava o evento se qualquer uma das palavras-
chave do evento corresponder às palavras-chave
especificadas nessa configuração. O valor padrão é All.
/EnableAF[-] /AF Habilita mensagens do provedor de mensagem do AF
SDK. O valor padrão é True.
/EnablePI[-] /PI Habilita mensagens relacionadas à comunicação com o
PI Data Archive do provedor de mensagem do MDA. O
valor padrão é True.
/LogFile:string /Log Especifica o nome do arquivo de log para rastrear
mensagens de saída. As mensagens ainda são exibidas
na saída padrão, a menos que o parâmetro Silent seja
especificado.
/Mask:string /M Impede que qualquer mensagem contendo a máscara
especificada seja exibida. Colocar a máscara entre aspas
caso contenha espaços. Esse parâmetro pode ser
especificado mais de uma vez, mas os valores devem
ser exclusivos.

Guia do Usuário do PI System Explorer 461

Utilitários e plug-ins do PI AF

Parâmetro Forma curta Descrição

/MaskPID:UInt32 /MPID Impede que qualquer mensagem contendo a ID do
processo especificada seja exibida. Esse parâmetro
pode ser especificado mais de uma vez.
Nota:
Esse parâmetro é ignorado se o parâmetro
ProcessID for especificado.

/MaskTID:UInt32 /MTID Impede que qualquer mensagem contendo a ID do

segmento especificada seja exibida. Esse parâmetro
pode ser especificado mais de uma vez.
Nota:
Esse parâmetro é ignorado se o parâmetro
ThreadID for especificado.

/NoHeader[-] /NH Desabilita as informações de cabeçalho em casa

mensagem. As informações de cabeçalho inclui o
timestamp, o identificador de processo e o identificador
de segmento.
/ProcessID:UInt32 /PID Exibe qualquer mensagem associada à ID do processo
especificada. Esse parâmetro pode ser especificado
mais de uma vez.
/ThreadID:UInt32 /TID Exibe qualquer mensagem associada à ID do segmento
especificada. Esse parâmetro pode ser especificado
mais de uma vez.
/WordWrap /W O word faz a quebra automática de linha das
mensagens de saída de acordo com a largura do
console.
/Silent[-] /S Estabelece o modo silencioso que impede a exibição da
mensagem.

Rastrear as alterações no PI AF com trilha de auditoria

Se a trilha de auditoria tiver sido ativada no sistema, você poderá abrir a janela Trilha de
auditoria do AF para visualizar as alterações feitas nos objetos do PI AF de todos os seus bancos
de dados do PI AF. Consulte Implementação da trilha de auditoria para obter informações
sobre a ativação desse recurso.
A janela Trilha de auditoria do AF contém uma tabela; cada linha da tabela contém dados que
identificam uma alteração específica em um objeto do PI 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 auditoria

Abra a janela Trilha de auditoria do AF para rastrear alterações nos objetos do PI AF.

Antes de Iniciar
Você deve ser um administrador do PI System para abrir a janela Trilha de auditoria do AF.

462 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Procedimento
1. No PI System Explorer, clique em Ferramentas > Trilha de auditoria. A tabela da janela listas
as alterações em objetos do PI AF. Cada linha inclui:

◦ Data
A data e hora da alteração

◦ Ação
O tipo de alteração (inserção, atualização ou exclusão)

◦ Tipo
O tipo de objeto que foi alterado

◦ Banco de Dados
O banco de dados do PI AF que contém o objeto alterado

◦ Caminho
O caminho hierárquico para o objeto alterado (quando o objeto é 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 alterações do próximo
período; clique em Atrasar hora (botão de seta para a esquerda) para listar as alterações do
período 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 Hora final para ajustar o período. 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.
4. Opcional. Altere Contagem máxima para definir um limite para o número de linhas de
alteração que podem ser retornadas para o período atual. Clique no botão Atualizar (ou
pressione Enter) para exibir a tabela atualizada. Talvez você queira ajustar Contagem
máxima para controlar o tempo de resposta. Além disso, se o número de alterações no
período atual exceder a Contagem máxima, você poderá aumentar o valor para exibir essas
alterações. Você também pode afetar o número de alterações exibidas ajustando o período.
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 de filtro no campo Filtro e clique no botão Pesquisar.

Guia do Usuário do PI System Explorer 463

Utilitários e plug-ins do PI AF

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 auditoria do AF. Os seguintes dados são exibidos para os
itens listados:
◦ Ação
Tipo de alteração (inserção, atualização ou exclusão) e o subobjeto do objeto do PI AF
(como um atributo ou valor de atributo).

◦ Nome
O subobjeto do PI 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 antes da alteração.

◦ Novo valor
O valor após a alteração.

Visualizar plug-ins instalados

Você pode verificar os plug-ins instalados na janela Propriedades do PI AF Server.

Procedimento
1. Selecione Arquivo > Propriedades do servidor.
2. Na janela Propriedades do PI AF Server, clique na guia Plug-ins.
◦ 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 em um plug-in e selecione Propriedades para
visualizar informações, como montagem, versão, versão carregada, montagens de
suporte e assim por diante.
Nota:
A versão do plug-in carregada normalmente 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

Você pode registrar diferentes implementações de plug-in e conjuntos de suporte na linha de
comando, usando os utilitários RegPlugIn e RegPlugIn64 . Para obter uma lista de
parâmetros, consulte Parâmetros RegPlugIn.
Os utilitários de registro de plug-in estão localizados nas pastas \PIPC\AF de seus diretórios
do Program Files correspondentes:
\Program Files\PIPC\AF\RegPlugIn64.exe
\Program Files (x86)\PIPC\AF\RegPlugIn.exe

464 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Exemplos
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 do .NET 3.5 direcionado a qualquer CPU

A mais simples de registrar, essa implementação funciona em qualquer arquitetura de
sistema operacional e em ambas as versões do .NET Framework. Ela não pode usar novos
recursos específicos da versão .NET 4 do AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll
• Plug-in apenas do .NET 4 direcionado a qualquer CPU
Essa 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 AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\4.0\MyPlugIn.dll
• Plug-in do .NET 3.5 e .NET 4 direcionado a qualquer CPU
Esse plug-in tem duas implementações. Uma é direcionada ao .NET 3.5 Framework e
funciona com a versão .NET 3.5 do AF SDK, e a outra é direcionada ao .NET 4 Framework e
funciona com a versão .NET 4 do 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 do .NET 3.5 direcionado a plataformas de 32 e 64 bits
Esse 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 da versão .NET 4 do AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll
RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll
• Plug-in do .NET 3.5 e .NET 4 direcionado a plataformas de 32 e 64 bits
Esse 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 referem-se ao .NET 4, uma para a plataforma de 32 bits e uma para a de 64
bits. Com todas as 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 do .NET 3.5 e conjunto de suporte direcionados a qualquer CPU
Essa implementação, com seu conjunto de suporte, funciona em qualquer arquitetura de
sistema operacional e em ambas as versões do .NET Framework. Ela não pode usar os novos
recursos específicos da versão .NET 4 do AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll
• Plug-in do .NET 3.5 e .NET 4 e conjunto de suporte direcionados a qualquer CPU
Esse plug-in tem duas implementações, com duas implementações de seu conjunto de
suporte. Uma é direcionada ao .NET 3.5 Framework e funciona com a versão .NET 3.5 do AF
SDK. A outra é direcionada ao .NET 4 Framework e funciona com a versão .NET 4 do AF SDK.

Guia do Usuário do PI System Explorer 465

Utilitários e plug-ins do PI AF

Ambas as implementações e seus conjuntos de suporte são registrados com o comando a

seguir.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll PlugIns
\4.0\MyPlugIn.dll PlugIns\4.0\Support.dll

Parâmetros RegPlugIn
A tabela a seguir lista os parâmetros disponíveis para o utilitário RegPlugin .
Parâmetro Forma curta Descrição
/PISystem:string /P Especifica o servidor PI AF a processar. Se não
especificado, o servidor padrão PI AF será usado.
/OutputFile:string /O Especifica um arquivo de saída. Se especificado,
um script SQL é gerado para criar plug-ins. Use o
parâmetro AppendFile para anexar a um arquivo
existente.
/AppendFile[-] /A Usado com o parâmetro OutputFile, especifica se
deve ser anexado a um arquivo de saída existente.
/List /L Lista as montagens registradas no servidor PI AF
especificado.
/Recursive[-] /R Processa automaticamente montagens de suporte
em subdiretórios com base nas montagens e nos
nomes de diretórios. Use o parâmetro
RootDirectory para especificar um diretório raiz
que seja diferente do diretório de trabalho atual.
/Force[-] /F Força o registro de montagens mais antigas que as
montagens atualmente registradas ou força o
cancelamento do registro de montagens que
parecem não estar registradas.
/Silent[-] /S Modo silencioso. Impede que mensagens sejam
exibidas.
/Unregister /U Remove a montagem e os plug-ins do servidor PI
AF especificado.
/RegFile:string /RF Cria um arquivo XML de registro para a montagem
especificada que pode ser usada para registrar
uma montagem de plug-in e todas as montagens de
suporte relacionadas. Qualquer arquivo adicional
especificado será tratado como montagem de
suporte.
/Version /V Exibe informações sobre a versão. Todos os outros
parâmetros são ignorados.
/User:string /user Especifica uma conta de usuário do Windows
diferente para se conectar ao servidor PI AF.
/Password:string /PW Usado junto com o parâmetro User, especifica a
senha de uma conta do usuário do Windows
diferente para se conectar ao servidor PI AF.
/Owner:string /Own Fornece o nome do arquivo do proprietário de
todas as montagens de suporte especificadas.
Normalmente usado com o parâmetro Directory
ao registrar montagens de suporte. Por padrão, o
nome do diretório será determinado em relação ao
parâmetro RootDirectory ou ao diretório de
trabalho atual, se o diretório raiz não estiver
especificado.

466 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Parâmetro Forma curta Descrição

/Directory:string /Dir Fornece o nome do diretório para todas as
montagens de suporte especificadas. Normalmente
usado com o parâmetro Owner ao registrar
montagens de suporte. Por padrão, o nome do
diretório é determinado em relação ao parâmetro
RootDirectory ou ao diretório de trabalho atual
se o diretório raiz não estiver especificado.
/RootDirectory:string /RootDir Registra todas as montagens relativas ao nome do
diretório raiz especificado. Normalmente usado
com o parâmetro Recursive ao registrar
montagens em vez de usar o parâmetro
Directory. Por padrão, este parâmetro é
configurado para o diretório de trabalho atual.
/Exclude:string /E Especifica diretórios ou arquivos de entrada para
exclusão ao pesquisar em um diretório para
verificar se há arquivos. Este parâmetro pode ser
especificado mais de uma vez, mas os valores
devem ser exclusivos.
files Especifica os arquivos de montagem de entrada,
arquivos de registro ou diretórios a serem
processados. É possível usar os seguintes
especificadores de caracteres coringa para filtrar
arquivos processados em diretórios:
• '*' corresponde a zero ou mais caracteres
• '?' corresponde exatamente a um caractere
Você também pode usar o parâmetro Exclude
para filtrar os arquivos processados.
@file Fornece parâmetros adicionais de entrada para o
arquivo especificado. 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ções.

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:

Guia do Usuário do PI System Explorer 467

Utilitários e plug-ins do PI AF

<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

Registrar plug-ins com os scripts SQL gerados

É possível registrar um plug-in do Microsoft SQL Server Management Studio ou da linha de
comando.

Procedimento
1. Inicie o Microsoft SQL Server Management Studio.
2. Escolha Arquivo > Abrir > Arquivo
3. Encontre e carregue o script.
4. Execute o script.
5. Para executar o script a partir da linha de comando, chame o utilitário utilitário de
comando , 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 se conectar ao servidor de banco de
dados.

468 Guia do Usuário do PI System Explorer

 Utilitários e plug-ins do PI AF

Gerenciamento de fornecedor de plug-in

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
tenham permissão para ser carregados e executados no aplicativo cliente (PI AF Server 2.5 e
posteriores). 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 o nível de verificação.

Nível de verificação
É possível exibir o nível de verificação usado quando os plug-ins são carregados emitindo o
comando afdiag sem nenhum parâmetro. O nível de verificação é listado na seção Definições
de configuração da saída resultante como PluginVerifyLevel.

Parâmetro /PlugInVerifyLevel
Configure o nível de verificação com o comando afdiag e especifique o parâmetro /
PlugInVerifyLevel. Os níveis válidos são:

• None: Desativar a validação, executar todos os plug-ins.

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

Outro AFDiag para gerenciar provedores de plug-ins

Os seguintes parâmetros afdiag estão disponíveis para gerenciar provedores de plug-ins:

• Exibir uma lista de provedores confiáveis: /TrustedProviderList

• Adicionar um provedor confiável: /TrustedProviderAdd:providername
• Remover um provedor confiável: /TrustedProviderRemove:providername
Para obter mais informações sobre esses parâmetros, consulte Parâmetros do utilitário AFDiag.
É possível localizar o nome do provedor visualizando a assinatura digital para a DLL de plug-in,
conforme descrito em Localizar os nomes de provedores confiáveis.

Localizar os nomes de provedores confiáveis

Determinar o nome de um provedor confiável de um plug-in DLL pela visualização de detalhes
da sua assinatura digital. A string para o nome do provedor confiável deve estar contida no
assunto do certificado.

Procedimento
1. Clique com o botão direito no plug-in DLL e clique em Propriedades.
2. Na janela Propriedades, clique na guia Assinaturas digitais (A a guia não será exibida se o
plug-in não estiver assinado)
3. Selecione um Nome do signatário na Lista de assinatura e clique em Detalhes.
4. Na janela Detalhes da assinatura digital clique em Visualizar certificado.
5. Na janela Certificado clique na guia Detalhes e role até o campo Assunto.

Guia do Usuário do PI System Explorer 469

Utilitários e plug-ins do PI AF

O valor exibido para esse campo é o nome do provedor confiável. É possível usar qualquer
subconjunto ou o nome inteiro de qualquer um dos nomes que são parte do assunto como a
variável <providername> para os parâmetros /TrustedProviderAdd e /
TrustedProviderRemove.

470 Guia do Usuário do PI System Explorer

Suporte técnico e outros recursos
Para obter assistência técnica, fale com o Suporte Técnico da OSIsoft no telefone +1
510-297-5828 ou na página Suporte Técnico da OSIsoft - Entre em Contato (https://
techsupport.osisoft.com/Contact-Us/). O site oferece opções de contato adicionais para os
clientes fora dos Estados Unidos.
Ao contatar o Suporte Técnico da OSIsoft, tenha estas informações em mãos:
• Nome do produto, versão e números de compilação
• Detalhes sobre a plataforma do computador (tipo da CPU, sistema operacional e número da
versão)
• Horário em que o problema começou
• Arquivos de log nesse horário
• Detalhes de todas as alterações no ambiente anteriores ao início do problema
• Resumo do problema, inclusive os arquivos de log relevantes durante o horário em que o
problema ocorreu
Para fazer perguntas a outros usuários do software OSIsoft, entre na comunidade de usuários
do OSIsoft, PI Square (https://pisquare.osisoft.com). Os membros da comunidade podem
solicitar conselhos e compartilhar ideias sobre o PI System. O espaço PI Developers Clube
dentro do PI Square oferece recursos para ajudá-lo na programação e integração dos produtos
OSIsoft.

Guia do Usuário do PI System Explorer 471

Suporte técnico e outros recursos

472 Guia do Usuário do PI System Explorer