PI System Explorer
Guía del usuario
Para PI Asset Framework: parte del Parche 1 de PI Server 2018 SP3
OSIsoft, LLC
1600 Alvarado Street
San Leandro, CA 94577 EE. UU.
Tel.: (1) 510 297 5800
Fax: (1) 510 357 8136
Web: http://www.osisoft.com
Guía del usuario PI System Explorer
© 2009-2020, OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o
transmitida, de ninguna forma ni por ningun medio, mecanicó, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft
Connected Services, OSIsoft EDS, 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 Developers Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC Driver, PI
Manual Logger, PI Nótificatións, PI ODBC Driver, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC DA
Server, 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 y RtReports son marcas
comerciales de OSIsoft, LLC. Todas las demas marcas y nombres comerciales aquí utilizados son
propiedad de sus respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE. UU.
Su uso, replica o difusión por parte del Gobierno de EE.UU. esta sujeto a las restricciones estipuladas en el
contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202,
DFARS 252.227-7013, FAR 12-212, FAR 52.227-19, o sus sucesorias, segun proceda. OSIsoft, LLC.
Versión: 2.10.8
Publicación: 6 de febrero de 2020
Contenido
Introducción a PI Asset Framework.........................................................................1
Cómo se representan los activos en PI AF..................................................................................................1
PI System Explorer....................................................................................................................................2
Componentes de la interfaz de usuario de PI System Explorer...............................................................3
Sugerencias de funciones......................................................................................................................4
Navegador de PI System Explorer......................................................................................................... 5
Personalizar el navegador..................................................................................................................... 6
Opciones de personalización de PI System Explorer.............................................................................. 6
Configuración de la pantalla de columnas..............................................................................................7
Seleccionar varios objetos en el visor.................................................................................................... 9
Duplicación de objetos........................................................................................................................ 10
Iconos que indican estados de objetos................................................................................................. 11
Ingresar cambios en bases de datos..................................................................................................... 11
Eliminar objetos de PI AF..................................................................................................................... 13
Accesos directos de teclado.................................................................................................................14
Cambiar el idioma............................................................................................................................... 15
Caracteres válidos en nombres de objetos de PI AF............................................................................. 16
Tiempo PI............................................................................................................................................16
Conexiones de servidor y base de datos.................................................................21
Conexiones del servidor de PI AF.............................................................................................................21
Conectarse a un servidor de PI AF........................................................................................................22
Añadir un servidor de PI AF a la lista de conexiones............................................................................. 23
Propiedades del servidor de PI AF....................................................................................................... 24
Ver las propiedades generales del servidor de PI AF conectado........................................................... 24
Administrar identidades en PI AF.........................................................................................................25
Administrar asignaciones en PI AF....................................................................................................... 27
Ver recuentos de objetos del servidor de PI AF.................................................................................... 29
Ver métricas de RPC............................................................................................................................29
Ver conexiones de servidor de PI AF.................................................................................................... 30
Conexiones de PI Data Archive................................................................................................................ 31
Conectarse a un PI Data Archive.......................................................................................................... 32
Revisar conjuntos de estados digitales en un PI Data Archive.............................................................. 34
Añadir los servidores de PI Data Archive a las listas de servidores conectados..................................... 36
Ver estados de almacenamiento en búfer para servidores de PI Data Archive conectados....................37
Conexiones de bases de datos de PI AF....................................................................................................37
Crear bases de datos de PI AF.............................................................................................................. 38
Ver o editar las propiedades de las bases de datos de PI AF................................................................. 39
Conectarse a una base de datos en un servidor de PI AF diferente....................................................... 40
Configurar la base de datos predeterminada....................................................................................... 41
La estructura del modelo de activos de PI AF.......................................................................................41
Renombrar bases de datos.................................................................................................................. 42
Buscar bases de datos de PI AF............................................................................................................43
Actualizar la lista de bases de datos.....................................................................................................43
Eliminar bases de datos....................................................................................................................... 43
Conexiones de colectivos de PI AF y PI Data Archive............................................................................... 43
Gestionar preferencias de conexión para PI System Explorer.............................................................. 44
Cambiar miembros colectivos............................................................................................................. 46
Cambiar a un miembro colectivo concreto.......................................................................................... 46
Importación y exportación de bases de datos........................................................ 47
Exportar una base de datos a XML...........................................................................................................47
Guía del usuario PI System Explorer
iii
Contenido
Opciones de exportación a XML.......................................................................................................... 48
Todos los objetos referenciados.......................................................................................................... 48
Formato de archivo de exportación y restauración...............................................................................51
Restaurar bases de datos desde archivos XML exportados...................................................................... 52
Exportar objetos de biblioteca a otra base de datos.................................................................................53
Bibliotecas guardadas de PI AF............................................................................................................ 53
Guardar bases de datos como bibliotecas............................................................................................54
Cargar bibliotecas de bases de datos................................................................................................... 54
Consultar propiedades de bibliotecas cargadas................................................................................... 54
Utilidad AFExport....................................................................................................................................55
Pautas para exportar colecciones........................................................................................................ 55
Parámetros de la utilidad AFExport..................................................................................................... 56
Rutas de exportación de muestra.........................................................................................................57
Utilidad AFImport................................................................................................................................... 58
Parámetros de la utilidad AFImport.....................................................................................................59
Recuperación de información de activos................................................................63
Exploración de activos.............................................................................................................................63
Exploración de elementos................................................................................................................... 64
Configurar el tamaño de la página del navegador................................................................................64
Abrir ventanas adicionales del navegador............................................................................................65
Activos y búsquedas de datos de activos................................................................................................. 65
Búsqueda rápida................................................................................................................................. 66
Paginación de resultados de búsqueda................................................................................................66
Tamaños máximos de consulta........................................................................................................... 66
Búsqueda en una fecha concreta......................................................................................................... 67
Búsqueda de PI points......................................................................................................................... 67
Administrar resultados de búsqueda....................................................................................................73
Buscar elementos................................................................................................................................ 74
Caracteres especiales en búsquedas de nombres.................................................................................79
Búsqueda de atributos en elementos.................................................................................................. 80
Buscar event frames............................................................................................................................ 81
Buscar atributos en event frames........................................................................................................ 85
Búsqueda de transferencias................................................................................................................. 87
Búsqueda de atributos en transferencias............................................................................................. 88
Tendencias en PI System Explorer...........................................................................................................90
Crear tendencias................................................................................................................................. 90
Gestión de versiones para equipos y procesos......................................................................................... 91
Crear versiones para elementos o modelos......................................................................................... 92
Crear versiones de tabla...................................................................................................................... 92
Comparar dos versiones...................................................................................................................... 93
Visualización de diferentes versiones de objeto y objetos obsoletos........................................................93
Fecha de consulta y tiempo en PI System Explorer.............................................................................. 94
Mostrar fechas y horas específicas.......................................................................................................95
Contexto temporal para los valores de atributo................................................................................... 95
Ver datos de series temporales............................................................................................................... 96
Tipo de límite...................................................................................................................................... 97
Expresión de filtro............................................................................................................................... 97
Estadísticas......................................................................................................................................... 98
Ponderación........................................................................................................................................99
Modo de horizonte de eventos............................................................................................................ 99
Restricciones de visualización de los datos de serie temporal.............................................................100
Organización de modelos de activos en PI AF....................................................... 103
La estructura del modelo de activos de PI AF......................................................................................... 103
El diseño de las jerarquías de activos de PI AF........................................................................................104
Referencias de elementos en la jerarquía de activos.............................................................................. 105
iv
Guía del usuario PI System Explorer
Contenido
Tipos de referencia............................................................................................................................ 105
Crear una sola referencia de elemento...............................................................................................108
Crear varias referencias de elemento................................................................................................. 108
Localizar otras referencias al mismo elemento.................................................................................. 108
Cambiar tipos de referencia...............................................................................................................109
Creación de tipos de referencia personalizados................................................................................. 109
Categorización de objetos..................................................................................................................... 110
Crear nuevas categorías..................................................................................................................... 111
Asignar objetos a categorías.............................................................................................................. 111
Representación de activos en PI AF..................................................................... 113
Representación de activos con plantillas................................................................................................ 113
Estrategia de plantillas.......................................................................................................................... 114
Plantillas de elementos..........................................................................................................................114
Atributo predeterminado...................................................................................................................115
Plantillas base y derivadas................................................................................................................. 115
Extensiones........................................................................................................................................117
Patrones de asignación de nombres...................................................................................................118
Crear plantillas de elementos.............................................................................................................120
Encontrar referencias de plantillas..................................................................................................... 122
Definir plantillas para otros objetos................................................................................................... 124
Plantillas secundarias............................................................................................................................ 125
Crear referencias de plantilla secundaria............................................................................................125
Representación de activos con elementos............................................................................................. 126
Crear elementos a partir de una plantilla........................................................................................... 126
Crear elementos sin basarse en una plantilla...................................................................................... 127
Localizar dónde se utiliza un elemento.............................................................................................. 128
Eliminación de elementos..................................................................................................................128
Restablecer valor del atributo a sus propiedades originales............................................................... 129
Convertir elementos existentes en plantillas de elementos................................................................129
Cambiar plantillas de elementos........................................................................................................129
Almacenamiento de información específica para cada aplicación.......................................................... 130
Crear propiedades extendidas............................................................................................................130
Asociación de datos con activos de PI AF............................................................. 133
Plantillas de atributos............................................................................................................................ 133
Propiedades de atributos................................................................................................................... 134
Características de atributos............................................................................................................... 136
Controlar la visualización de los valores de atributos y plantillas de atributos.....................................147
Crear plantillas de atributos............................................................................................................... 147
Tipos de datos de PI AF......................................................................................................................150
Definir valores constantes para las plantillas de atributos...................................................................151
Añadir extensiones de atributos a elementos basados en plantillas....................................................153
Conjuntos de enumeración en PI AF...................................................................................................... 155
Administrar conjuntos de enumeración............................................................................................. 156
Volver a numerar los valores de enumeración.................................................................................... 159
Configuración de referencias de datos................................................................. 161
Cadenas de configuración de atributos en PI System Explorer............................................................... 162
Cadenas de configuración para referencias de datos de PI points.......................................................162
Sintaxis de ruta para las referencias a otros atributos.........................................................................165
Parámetros de substitución en referencias de datos...............................................................................171
Símbolos utilizados en los parámetros de substitución.......................................................................172
Sustituciones de nombre....................................................................................................................173
Referencias a valores de atributos...................................................................................................... 173
Lista de parámetros de sustitución de PI AF....................................................................................... 174
Cadenas de formato para parámetros de sustitución de hora.............................................................178
Guía del usuario PI System Explorer
v
Contenido
Encontrar el servidor predeterminado de PI Data Archive.................................................................. 179
Referencias de datos de PI points.......................................................................................................... 180
Referencias de PI point directas......................................................................................................... 181
Referencias de PI Point indirectas...................................................................................................... 181
Crear referencias directas de datos de PI Point desde los resultados de la búsqueda de tags.............. 183
Configurar referencias de datos de PI Point directas o indirectas........................................................183
Referencias a valores de atributos......................................................................................................185
Consideraciones relativas a las unidades de medida.......................................................................... 185
Configuración de métodos de recuperación de los valores de un atributo.......................................... 185
El valor de PI point se actualiza a partir de la referencia de datos....................................................... 193
Actualizaciones del valor de atributo a partir de referencias de datos de PI Point...............................194
Configurar la creación de PI Points.....................................................................................................196
Editar propiedades de PI Point........................................................................................................... 197
Vista previa de los parámetros de substitución en las referencias de datos de PI Point....................... 197
Referencias de datos de matriz de PI point............................................................................................ 198
Crear referencias de datos de matriz de PI Point................................................................................ 198
Referencias de datos Fórmula............................................................................................................... 199
Operadores de referencias de datos de fórmulas............................................................................... 200
Funciones de fórmula de referencia de datos..................................................................................... 201
Unidades de medida en referencias de datos de fórmula................................................................... 202
Configurar referencias de datos de fórmula....................................................................................... 203
Referencia de datos String Builder........................................................................................................ 205
Referencias de atributo en String Builder.......................................................................................... 206
Implementación de funciones en el generador de cadenas................................................................ 207
Crear referencias de datos del generador de cadenas.........................................................................211
Referencias de datos Table Lookup....................................................................................................... 214
Crear tablas de PI AF......................................................................................................................... 214
Crear definiciones de columna de la tabla.......................................................................................... 217
Completar tablas de forma manual....................................................................................................218
Referencias de datos desde fuera del PI System................................................................................ 219
Configurar las referencias de datos de búsqueda de tabla.................................................................. 231
Referencias de datos de Uri Builder....................................................................................................... 241
Crear referencias de datos de Uri Builder........................................................................................... 241
Unidades de medida de PI AF............................................................................. 245
Distinción de mayúsculas en abreviaturas de unidades de medida........................................................ 246
Configuración de abreviaturas de unidades de medida con distinción de mayúsculas y minúsculas....247
Clases base y clases derivadas............................................................................................................... 248
Clases base de unidades de medida...................................................................................................248
Clases derivadas de unidades de medida comunes............................................................................ 249
Crear clases de UOM.............................................................................................................................249
Crear unidades de medida..................................................................................................................... 250
Cálculo de conversión de unidades de medida con una fórmula......................................................... 252
Calcular valores de conversión para una unidad de medida....................................................................253
Grupos de UOM.................................................................................................................................... 254
Administrar grupos de UOM.............................................................................................................. 255
Origen de las UOM................................................................................................................................ 256
Seguridad de objetos en PI AF.............................................................................257
Identidades y asignaciones de PI AF...................................................................................................... 257
Identidades de PI AF incorporadas........................................................................................................ 259
Jerarquía de seguridad.......................................................................................................................... 260
Herencia de seguridad de los objetos de PI AF.......................................................................................261
Herencia de permisos para objetos de elementos..............................................................................262
Derechos de acceso de PI AF................................................................................................................. 266
Opción para rechazar permisos............................................................................................................. 268
Ventana de configuración de seguridad.................................................................................................268
vi
Guía del usuario PI System Explorer
Contenido
Pestaña Permisos.............................................................................................................................. 268
Pestaña Acceso eficaz........................................................................................................................270
Ver el acceso eficaz por usuario..........................................................................................................272
Seguridad del servidor de PI AF............................................................................................................. 273
Configurar la seguridad de un servidor de PI AF................................................................................. 273
Seguridad de bases de datos de PI AF....................................................................................................274
Configurar la seguridad para nuevas bases de datos de PI AF............................................................. 275
Configurar la seguridad para una única base de datos de PI AF.......................................................... 276
Seguridad de colecciones en PI AF......................................................................................................... 277
Configurar la seguridad para colecciones........................................................................................... 277
Seguridad de objetos de PI AF............................................................................................................... 279
Configurar la seguridad para objetos................................................................................................. 279
Configurar la seguridad de análisis y plantillas de análisis.................................................................. 280
Configurar la seguridad para la base de datos de unidades de medida...................................................282
Diferencias del modelo de seguridad de PI Data Archive....................................................................... 282
Event Frames en PI AF....................................................................................... 283
Estructura de marcos de evento............................................................................................................ 284
Ventajas de los marcos de evento......................................................................................................... 284
Ejemplos de marcos de evento..............................................................................................................285
¿Event frames o batch?......................................................................................................................... 286
Métodos de creación de marcos de evento............................................................................................286
Visualización de marcos de evento........................................................................................................ 287
Plantillas de event frames......................................................................................................................287
Elementos referenciados primarios................................................................................................... 289
Referencias de datos a atributos en el elemento de referencia primario............................................ 289
Referencias de datos a atributos en otros elementos.........................................................................289
Crea plantillas de event frames..........................................................................................................292
Cambiar plantillas de event frames....................................................................................................294
Crea event frames................................................................................................................................. 295
Crear atributos en event frames.........................................................................................................297
Captura de valores para event frames y transferencias..........................................................................298
Capturar valores................................................................................................................................298
Bloquear marcos de evento o transferencias......................................................................................... 300
Reconocimiento de event frames.......................................................................................................... 300
Realizar el acuso de recibo de event frames....................................................................................... 301
Transferencias....................................................................................................................................... 302
Crear plantillas de transferencia........................................................................................................ 302
Crear transferencias.......................................................................................................................... 305
Crear puertos de transferencias......................................................................................................... 306
Anotaciones en PI AF......................................................................................... 309
Anotaciones de elementos.................................................................................................................... 309
Añadir anotaciones a elementos........................................................................................................ 310
Anotaciones de event frames.................................................................................................................311
Añadir anotaciones a event frames.................................................................................................... 311
Anotaciones de transferencias...............................................................................................................312
Añadir anotaciones a transferencias.................................................................................................. 312
Análisis basados en activos................................................................................. 315
Introducción a los análisis...................................................................................................................... 315
Configurar y administrar análisis en un elemento...............................................................................316
Plantillas de análisis........................................................................................................................... 318
Actualización de análisis y plantillas de análisis.................................................................................. 319
Atributos excluidos en análisis........................................................................................................... 319
Programación de análisis................................................................................................................... 320
Expresiones para análisis................................................................................................................... 322
Guía del usuario PI System Explorer
vii
Contenido
Análisis y datos futuros...................................................................................................................... 325
Análisis de expresiones......................................................................................................................... 326
Crear una plantilla de análisis de expresiones.................................................................................... 326
Crear un análisis de expresiones........................................................................................................ 329
Análisis de resumen............................................................................................................................... 331
Funciones del análisis de resumen..................................................................................................... 332
Crear una plantilla de análisis de resumen..........................................................................................332
Crear un análisis de resumen..............................................................................................................335
Análisis de generación de marcos de evento..........................................................................................338
Modos implícitos de generación de Event Frame en Asset Analytics..................................................340
Crear una plantilla de análisis de generación de marcos de evento.....................................................341
Crear un análisis de generación de marcos de evento........................................................................ 344
Condiciones del activador de inicio y finalización............................................................................... 347
Generación de marcos de evento con varios start triggers................................................................. 348
Análisis de SQC..................................................................................................................................... 349
Crear una plantilla de análisis de SQC................................................................................................ 350
Crear un análisis de SQC.................................................................................................................... 352
Análisis de ejemplo................................................................................................................................354
Crear un análisis de expresión para estudiar la desviación de la eficiencia.......................................... 355
Crear una plantilla para los análisis de resumen de potencia...............................................................357
Crear de forma automática event frames para realizar un seguimiento de la ineficiencia................... 359
Rellenado y recálculo de análisis............................................................................................................ 361
Reponer o recalcular datos de un análisis...........................................................................................362
Rellenar o recalcular datos de varios análisis...................................................................................... 363
Conciliación de event frames durante el rellenado.............................................................................364
Configurar el recálculo automático de análisis y plantillas de análisis................................................. 365
Habilitar o deshabilitar el recálculo automático para múltiples análisis.............................................. 366
Abrir la carpeta de registro de recálculo.............................................................................................366
Gestión de análisis en la base de datos de PI AF.....................................................................................366
Referencia de funciones de expresión.................................................................................................... 367
Abs.................................................................................................................................................... 375
Acos...................................................................................................................................................375
AND.................................................................................................................................................. 376
ArrayLength...................................................................................................................................... 376
Ascii................................................................................................................................................... 377
Asin....................................................................................................................................................377
Atn.................................................................................................................................................... 378
Atn2.................................................................................................................................................. 378
Avg.................................................................................................................................................... 379
BadVal...............................................................................................................................................380
Bod....................................................................................................................................................381
Bom.................................................................................................................................................. 382
Bonm................................................................................................................................................ 382
Ceiling............................................................................................................................................... 383
Char ..................................................................................................................................................384
Compare........................................................................................................................................... 384
Concat...............................................................................................................................................385
Contains............................................................................................................................................ 386
Convert..............................................................................................................................................387
Cos.................................................................................................................................................... 387
Cosh.................................................................................................................................................. 388
Cot.................................................................................................................................................... 388
Coth.................................................................................................................................................. 389
Cov....................................................................................................................................................389
Csc.....................................................................................................................................................391
Csch.................................................................................................................................................. 391
Curve.................................................................................................................................................392
viii
Guía del usuario PI System Explorer
Contenido
Day....................................................................................................................................................393
DaySec.............................................................................................................................................. 393
DeltaValue........................................................................................................................................ 394
DigState............................................................................................................................................394
DigText..............................................................................................................................................395
E........................................................................................................................................................396
ELSE................................................................................................................................................. 396
EventCount....................................................................................................................................... 397
EventFrame....................................................................................................................................... 397
Exit....................................................................................................................................................398
Exp.................................................................................................................................................... 399
FilterData.......................................................................................................................................... 399
FindEq...............................................................................................................................................400
FindGE.............................................................................................................................................. 401
FindGT.............................................................................................................................................. 402
FindLE............................................................................................................................................... 403
FindLT............................................................................................................................................... 404
FindNE.............................................................................................................................................. 405
FirstValue..........................................................................................................................................406
Float.................................................................................................................................................. 407
Floor................................................................................................................................................. 408
Format.............................................................................................................................................. 408
Frac...................................................................................................................................................409
HasChanged......................................................................................................................................409
HasValueChanged............................................................................................................................. 410
Hour.................................................................................................................................................. 411
IF....................................................................................................................................................... 411
IN...................................................................................................................................................... 412
InStr.................................................................................................................................................. 412
Int...................................................................................................................................................... 413
InterpolatedValues............................................................................................................................ 414
IsSet.................................................................................................................................................. 415
LastValue.......................................................................................................................................... 416
LCase................................................................................................................................................. 417
Left....................................................................................................................................................417
Len.................................................................................................................................................... 417
LinRegr..............................................................................................................................................418
Log....................................................................................................................................................420
Log10................................................................................................................................................ 420
Logbase............................................................................................................................................ 421
LTrim................................................................................................................................................. 421
MapData........................................................................................................................................... 422
Max................................................................................................................................................... 422
Median..............................................................................................................................................424
Mid....................................................................................................................................................425
Min................................................................................................................................................... 426
Minute...............................................................................................................................................427
Mod.................................................................................................................................................. 428
Month............................................................................................................................................... 429
NextEvent......................................................................................................................................... 429
NextVal............................................................................................................................................. 430
Noon................................................................................................................................................. 430
NoOutput.......................................................................................................................................... 431
Normalrnd......................................................................................................................................... 431
NOT.................................................................................................................................................. 432
NumOfChanges.................................................................................................................................432
O....................................................................................................................................................... 433
Guía del usuario PI System Explorer
ix
Contenido
ParseTime......................................................................................................................................... 433
PctGood............................................................................................................................................ 434
Pi....................................................................................................................................................... 435
Poisson.............................................................................................................................................. 435
Poly................................................................................................................................................... 436
Pow................................................................................................................................................... 436
PrevEvent.......................................................................................................................................... 437
PrevVal..............................................................................................................................................438
PStDev.............................................................................................................................................. 438
Rand................................................................................................................................................. 440
Range................................................................................................................................................441
Rate.................................................................................................................................................. 442
RecordedValues................................................................................................................................ 442
RecordedValuesByCount...................................................................................................................444
Remainder.........................................................................................................................................445
Right................................................................................................................................................. 446
Round............................................................................................................................................... 446
Roundfrac......................................................................................................................................... 448
RTrim................................................................................................................................................ 449
Sec.................................................................................................................................................... 449
Sech.................................................................................................................................................. 450
Second.............................................................................................................................................. 450
SecSinceChange................................................................................................................................451
Sgn....................................................................................................................................................451
Sin.....................................................................................................................................................452
Sinh...................................................................................................................................................452
Split...................................................................................................................................................453
Sqr.....................................................................................................................................................453
StateNo............................................................................................................................................ 454
SStDev.............................................................................................................................................. 454
StDev................................................................................................................................................ 456
String................................................................................................................................................ 457
TagAvg.............................................................................................................................................. 458
TagBad..............................................................................................................................................459
TagDesc............................................................................................................................................ 460
TagEU............................................................................................................................................... 460
TagExDesc.........................................................................................................................................461
TagMax............................................................................................................................................. 462
TagMean........................................................................................................................................... 463
TagMin..............................................................................................................................................464
TagName.......................................................................................................................................... 465
TagNum............................................................................................................................................ 466
TagSource......................................................................................................................................... 466
TagSpan............................................................................................................................................ 467
TagTot............................................................................................................................................... 467
TagType............................................................................................................................................ 469
TagTypVal......................................................................................................................................... 470
TagVal............................................................................................................................................... 470
TagZero............................................................................................................................................. 471
Tan.................................................................................................................................................... 472
Tanh.................................................................................................................................................. 472
Text................................................................................................................................................... 473
THEN.................................................................................................................................................473
TimeEq.............................................................................................................................................. 474
TimeGE............................................................................................................................................. 475
TimeGT............................................................................................................................................. 476
TimeLE.............................................................................................................................................. 477
x
Guía del usuario PI System Explorer
Contenido
TimeLT.............................................................................................................................................. 478
TimeNE............................................................................................................................................. 479
TimeStamp....................................................................................................................................... 480
Total..................................................................................................................................................480
Trim.................................................................................................................................................. 482
Trunc................................................................................................................................................. 482
UCase................................................................................................................................................483
Weekday........................................................................................................................................... 483
Year...................................................................................................................................................484
Yearday............................................................................................................................................. 484
Funciones del vapor para expresiones de análisis.................................................................................. 485
Funciones de vapor en análisis basados en tags y activos.................................................................. 486
Rangos de las entradas de la función de vapor................................................................................... 487
Conversión de unidades de medida para funciones de vapor............................................................. 489
Estados de referencia de la propiedad del vapor................................................................................490
Referencia de funciones Steam (Asset Analytics).............................................................................. 490
Administración de PI Analysis Service................................................................................................... 504
Ver estadísticas del servicio de análisis.............................................................................................. 504
Ver o modificar el servicio de análisis................................................................................................. 505
Configuración del servicio de análisis................................................................................................. 505
Buffering de salidas de PI point para PI Analysis Service.................................................................... 509
Notificaciones................................................................................................... 511
Introducción a las notificaciones............................................................................................................ 512
Notificaciones y event frames................................................................................................................512
Historial de notificaciones......................................................................................................................513
Requisitos para notificaciones............................................................................................................... 514
Soporte del cliente para notificaciones ................................................................................................. 514
Seguridad de notificaciones...................................................................................................................514
Seguridad para contactos.................................................................................................................. 515
Seguridad para las reglas y plantillas de notificación..........................................................................516
Configurar autenticación para la conexión con un servidor SMTP.......................................................517
Configuración de la autenticación para una conexión de servicio web................................................ 518
Creación de una regla de notificación.................................................................................................... 519
Crear plantilla de regla de notificación...................................................................................................520
Criterios de activación en reglas de notificación.....................................................................................521
Intervalo de no repetición en reglas de notificación........................................................................... 522
Intervalo de reenvío en reglas de notificación.................................................................................... 522
Formatos de entrega en reglas de notificación.......................................................................................523
Agregar un dominio a la lista blanca.................................................................................................. 525
Agregar una captura de pantalla en el formato de entrega de correo electrónico de notificación....... 527
Suscripciones en las reglas de notificación............................................................................................. 527
Personalización de la entrega y del contenido de la suscripción......................................................... 528
Configuración de puntos finales de entrega de notificaciones............................................................... 529
Configurar un punto final de entrega de correo electrónico............................................................... 529
Configurar un punto final de entrega de correo electrónico dinámico.................................................531
Configurar un punto final de entrega de servicios web REST.............................................................. 531
Configurar un punto final de entrega de servicios web SOAP............................................................. 533
Complemento Contactos.......................................................................................................................535
Configuración de acceso a Active Directory para los contactos.......................................................... 536
Administración de contactos............................................................................................................. 538
Opciones para el canal de entrega de notificaciones de correo electrónico........................................ 541
Opciones para el canal de entrega de servicio web de notificaciones................................................. 542
Configuración de reglas de notificación para análisis o event frames..................................................... 542
Configuración de reglas de notificación a partir de análisis.................................................................543
Configurar reglas de notificación para event frames definidos por el usuario..................................... 546
Configurar escalaciones para las reglas de notificación...................................................................... 549
Guía del usuario PI System Explorer
xi
Contenido
Administración de reglas de notificación............................................................................................... 549
Cambios de PI Notifications 2012.......................................................................................................... 549
Migración de PI Notifications 2012........................................................................................................ 550
Recursos adicionales..............................................................................................................................553
Administración de análisis y reglas de notificación................................................555
Buscar análisis o reglas de notificación.................................................................................................. 555
Administración de análisis..................................................................................................................... 556
Administración de reglas de notificación............................................................................................... 558
Modelos de proceso en PI AF.............................................................................. 559
El alcance de un modelo de PI AF.......................................................................................................... 559
Pautas para los modelos de PI AF.......................................................................................................... 560
Submodelos.......................................................................................................................................... 560
Tipos de elementos de los modelos....................................................................................................... 561
Crear modelos de PI AF......................................................................................................................... 561
Editar modelos de PI AF........................................................................................................................ 562
Puertos y conexiones............................................................................................................................ 562
Crear puertos.................................................................................................................................... 562
Crear conexiones............................................................................................................................... 563
Capas.................................................................................................................................................... 563
Crear capas....................................................................................................................................... 564
Utilidades y plug-ins de PI AF..............................................................................565
Iniciar PSE con opciones de línea de comandos..................................................................................... 565
Parámetros de AFExplorer.................................................................................................................565
Utilidad de diagnóstico de PI AF............................................................................................................566
Otorgar permisos a la utilidad de diagnóstico de Pi AF.......................................................................567
Ejecutar la utilidad AFDiag................................................................................................................ 568
Parámetros de la utilidad AFDiag...................................................................................................... 569
Implementación de pista de auditoría................................................................................................ 574
Utilidad de configuraciones de complementos de actualización de AF...................................................576
Configurar la utilidad del servidor de PI AF.............................................................................................578
Parámetros de la utilidad SetPISystem.............................................................................................. 578
Capturar salidas de trazos de eventos en AF SDK.................................................................................. 578
Parámetros de la utilidad AFGetTrace................................................................................................579
Seguimiento de los cambios en PI AF con pista de auditoría..................................................................580
Revisar cambios con la utilidad Pista de Auditoría..............................................................................581
Ver módulos instalados......................................................................................................................... 583
Registro de módulos mediante la línea de comandos............................................................................ 583
Parámetros RegPlugIn.......................................................................................................................585
Crear un archivo de registro XML.......................................................................................................... 586
Crear un script de registro SQL.............................................................................................................. 587
Registrar plug-ins generados con scripts SQL........................................................................................588
Gestión de proveedores de plug-ins...................................................................................................... 588
Buscar nombres de proveedores de confianza................................................................................... 589
Soporte técnico y otros recursos......................................................................... 591
xii
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
PI Asset Framework permite representar activos y procesos como objetos de PI AF y
estructurarlos para que ofrezcan valor a su empresa.
PI System Explorer y PI Builder son las principales herramientas utilizadas en la creación y
gestión de objetos de PI AF. Ambas herramientas incluyen soporte para las siguientes
funciones:
• Event frames
Con los event frames, puede captar eventos de proceso importantes y recopilar datos
relevantes sobre ellos para analizar por que se produjeron. Consulte Event Frames en PI AF
si desea mas infórmación.
• Análisis basados en activos
Integrados en PI System Explorer, puede utilizar los analisis basados en activos para crear
calculós y cónfigurar declaraciones condicionales relacionadas con valores de activo.
Consulte Analisis basados en activos si desea mas infórmación.
• Notificaciones
Integrado en PI System Explorer en PI AF 2016 R2, puede utilizar nótificaciónes para crear
reglas mediante las cuales se puede alertar a los usuarios en tiempo real sobre condiciones
anómalas del sistema. Consulte Intróducción a las nótificaciónes si desea mas infórmación.
En esta sección
• Cómó se representan los activos en PI AF
• PI System Explorer
Cómo se representan los activos en PI AF
PI Asset Framework (PI AF) permite crear una representación del equipo y los procesos,
própórciónandóle de este modo una excelente visión general de los datos. En PI AF, el equipo y
los procesos objeto de supervisión se denominan activos. La representación de PI AF de todos
los activos y procesos juntos se denomina modelo de activos. El modelo de activos organiza al
equipo en una estructura tal que simplifica la busqueda de infórmación.
En el modelo de activos de PI AF, cada equipo se encuentra representado por un elemento. Los
datos asociados de un elemento se almacenan como atributos de ese elemento. Los atributos
pueden incluir valores simples, que representan infórmación fija, como el diametró de un
tanque. Un atributo puede hacer referencia tambien a un PI point, una fórmula, un valor de una
base de datos relacional, un archivo, una fótógrafía, etc. Todos los datos pertinentes sobre un
activo se vinculan al elemento que representa ese activo.
Por ejemplo, supongamos que tiene una bomba con tres datos asociados: la presión (leída de
un PI point), la temperatura de entrada y la temperatura de salida. Para establecer un modelo
de estos datos en PI AF, puede crear un elemento PI AF que represente la bomba y crear los tres
atributos que representen los datos asociados.
En la siguiente ilustración, se muestra la forma en que aparecen los datos en PI AF. Aunque
todos los valores son PI points, el usuario no necesita conocer en ningun momento los nombres
de los PI points. Todos los datos estan disponibles directamente en el elemento.
Guía del usuario PI System Explorer
1
Introducción a PI Asset Framework
Video
Para obtener infórmación sobre los activos y los atributos, mire este video:
https://www.youtube.com/watch?v=18RgS8Y3JtQ&rel=0
PI System Explorer
PI System Explorer proporciona una interfaz grafica de usuario para crear, editar y administrar
objetos de PI AF. Utilice PI System Explorer para crear y administrar su estructura de activos, lo
que incluye bases de datos de PI AF, elementos y plantillas.
Eliminación de interfaces Aleatorio y Ramp Soak
A partir de PI Server 2018 SP3, las interfaces Aleatorio y Ramp Soak ya no se instalan de
manera predeterminada con una nueva instalación de PI Data Archive. De manera opcional,
puede instalarlas usando kits de instalación individuales: PI Interface para datos del simulador
de Ramp Soak y PI Interface para datos de simulador aleatorio. Luego de instalar estas
interfaces, siga las instrucciones que se proporcionan en los kits de instalación de la interfaz
para crear PI points predeterminados y, luego, recibir datos simulados de dichas interfaces. En
lo que respecta a las actualizaciones, las versiones anteriores de Aleatorio y Ramp Soak
cóntinuaran vigentes y los PI points predeterminados cóntinuaran recuperando datos
simulados.
Con anterioridad a PI Server 2018 SP3, los siguientes PI points predeterminados se crean de
manera autómatica con el kit de instalación de PI Data Archive:
• BA:ACTIVE.1
• BA:CONC.1
• BA:LEVEL.1BA:PHASE.1
• BA:PHASE.1
• BA:TEMP.1
• CDEP158
• CDM158
• CDT158
• SINUSOID
• SINUSOIDU
Versiones de PI System Explorer
En las computadoras que tienen un sistema operativo de 64 bits, tanto la versión de 32 bits
como la versión de 64 bits de PI System Explorer estaran disponibles despues de una
instalación del cliente de PI AF. A partir de PI AF 2017, la versión de 32 bits se etiqueta como PI
System Explorer heredado de 32 bits, mientras que la versión de 64 bits se etiqueta
simplemente como PI System Explorer.
2
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
La versión heredada de 32 bits esta disponible en caso de que necesite seguir utilizando la
versión heredada de Nótificaciónes (anterior a la versión 2016 R2) y su editor de contactos.
Esta versión del editor de contactos es necesaria para trabajar con los canales de entrega
heredados. Para obtener mas infórmación sobre las nótificaciónes, consulte Nótificaciónes.
Compatibilidad con FIPS
A partir de PI AF 2017 R2, PI AF admite entornos de Windows que hace cumplir el uso de
algoritmos criptógraficós de los Estandares de Procesamiento de Infórmación Federales (FIPS)
de EE. UU. Una vez que se habilitó la pólítica Criptografía del sistema: usar algoritmos de
cumplimiento FIPS para cifrado, dispersión y firma; no se requiere otra cónfiguración.
Para cumplir con los FIPS, los usuarios que necesitan usar cóntrasenas para vincularse a tablas
externas solo pueden usar PI AF 2017 R2 o clientes y servidores de versiones posteriores.
Ademas, los usuarios no pueden exportar datos de una base de datos de PI AF que contenga
cóntrasenas de tabla creadas con PI AF 2017 R2 o un cliente de una versión posterior e
importar esas cóntrasenas a los clientes PI AF en versiones anteriores. Para obtener mas
infórmación sobre cómó vincularse a referencias de datos de tabla externas, consulte
Referencias de datos desde fuera del PI System.
En esta sección
• Componentes de la interfaz de usuario de PI System Explorer
• Sugerencias de funciones
• Navegador de PI System Explorer
• Personalizar el navegador
• Opciones de persónalización de PI System Explorer
• Cónfiguración de la pantalla de columnas
• Seleccionar varios objetos en el visor
• Duplicación de objetos
• Iconos que indican estados de objetos
• Ingresar cambios en bases de datos
• Eliminar objetos de PI AF
• Accesos directos de teclado
• Cambiar el idioma
• Caracteres validós en nombres de objetos de PI AF
• Tiempo PI
Componentes de la interfaz de usuario de PI System Explorer
En la siguiente ilustración se muestran los principales componentes de PI System Explorer.
Guía del usuario PI System Explorer
3
Introducción a PI Asset Framework
1. Barra de menús
2. Barra de herramientas
3. Navegador
4. Navegador
5. Barra de estado
6. Paleta
7. Visor
Videos
Para obtener infórmación sobre el navegador de PI System Explorer, mire este video:
https://www.youtube.com/watch?v=Dtf7xC2N7ak&rel=0
Para obtener infórmación sobre la paleta y el visor de PI System Explorer, mire este video:
https://www.youtube.com/watch?v=IXXR88qBv2I&rel=0
Sugerencias de funciones
A partir de PI AF 2017, puede realizar sugerencias sobre las funciones que le gustaría ver
agregadas en PI System. Tambien, puede revisar las sugerencias que otros usuarios ya han
presentado y votar por las que apruebe. Puede seleccionar una de las siguientes categórías
para su sugerencia:
• Analisis y calculós
• Asset Framework
• Data Archive
• Marcos de evento
• General
• Ayuda/Dócumentación/Videós
• Instalación
• Nótificaciónes
• PI Builder
4
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
• Seguridad
• Administración del sistema
Para proporcionar comentarios, seleccione Ayuda > Give Us Feedback (Proporcione sus
comentarios) y haga clic en Sign in (Iniciar sesión). Puede escribir sus comentarios en el campo
Enter your idea (Introduzca su idea), seleccionar una categóría adecuada y proporcionar
detalles adicionales, segun sea necesario.
Programa de mejora de la experiencia del cliente de PI System
La Opción de comentarios de experiencia del cliente en el menu Ayuda le permite participar en
el programa de telemetría que OSIsoft utiliza para recopilar datos de uso anónimó a fin de
mejorar el PI System y priorizar las nuevas funciones. Los datos recopilados no incluyen lógica
ni datos empresariales, pero pueden incluir infórmación como direcciones IP, nombres de host
y nombres de objetos de PI System.
Para participar en el programa de telemetría, seleccione Sí, me gustaría participar
(Recomendado) y haga clic en Aceptar.
Navegador de PI System Explorer
El contenido del navegador de PI System Explorer depende del bótón que se seleccione en el
panel del navegador. Los objetos predeterminados disponibles en el navegador son elementos,
Event Frames, objetos de biblioteca, unidades de medida y contactos. El objeto de
administración tambien aparece si esta instalado el complemento de administración (que
abarca analisis y reglas de nótificación).
Nota:
Si las nótificaciónes heredadas se instalan en un equipo cliente PI AF, es posible que MyPI
y Nótificaciónes tambien se muestren en el navegador.
Puede moverse muy rapidó entre los objetos del navegador de PI System Explorer con los
siguientes accesos directos de teclado. Tenga en cuenta que tambien se muestran diferentes
colores en la parte superior del navegador y el visor para distinguir entre los objetos
seleccionados del navegador:
Accesos directos Navegador
CTRL + 1
CTRL + 2
CTRL + 3
CTRL + 4
CTRL + 7
Guía del usuario PI System Explorer
5
Introducción a PI Asset Framework
Accesos directos Navegador
CTRL + 0
Personalizar el navegador
Para aumentar el espacio disponible en su pantalla para los objetos del navegador, cambie los
botones del navegador a iconos.
Procedimiento
1. Haga clic con el bótón secundario en el navegador y luego haga clic en Opciones del panel de
navegación.
2. En la ventana Opciones del panel de navegación, borre la casilla de verificación junto a cada
componente de la lista Mostrar botón entero.
3. Haga clic en Aceptar. Las filas de las etiquetas de los botones se sustituyen por una unica fila
de iconos.
4. Mueva el cursor sobre un icono para ver su etiqueta.
Opciones de personalización de PI System Explorer
Puede personalizar muchos aspectos de PI System Explorer para que se adapte a sus
necesidades con Herramientas > Opciones.
Pestaña General
Utilice la pestana General para controlar las opciones de visualización de varias funciones.
Puede controlar:
• Tecla para abrir las ventanas de Entrada y Deshacer-Salida. Para obtener mas infórmación,
consulte Ingresar cambios en bases de datos.
• Apariencia de la barra de títuló.
• Tamanó de pagina para objetos del navegador. Para obtener mas infórmación, consulte
Cónfigurar el tamanó de la pagina del navegador.
• Numeró de consultas que devuelven las busquedas de objetos. Para obtener mas
infórmación, consulte Paginación de resultados de busqueda.
• Apariencia de las unidades de medida para atributos. Para obtener mas infórmación,
consulte Mostrar valores de atributo en unidad de medida de origen.
• Muestra los valores de atributo para las unidades de medición que estan asignadas a un
grupo de UOM seleccionado. Cuando no se selecciona un grupo de UOM, los valores de
atributo se basan en la UOM predeterminada que esta definida en las plantillas de atributo o
en su unidad de medición de origen (si esta seleccionada la ópción Usar unidad de medición
de origen para mostrar atributo). Para obtener mas infórmación, consulte Grupos de UOM.
• Visualización de atributos excluidos. Para obtener mas infórmación, consulte Propiedad de
atributo apagado.
• Cantidad de dígitós que se muestra para los valores de atributo. Para obtener mas
infórmación, consulte Controlar la visualización de los valores de atributos y plantillas de
atributos.
6
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Pestaña de Contexto de tiempo
Utilice la pestana Contexto de tiempo para definir una hora o un intervalo de tiempo que PI
System Explorer utiliza para mostrar valores de atributo. Para obtener mas infórmación,
consulte Establecer el contexto temporal de los valores de atributo mostrados.
Pestaña Opciones de servidor
Use la pestana Opciones de servidor para definir de que manera PI System Explorer debe
conectarse a un colectivo de PI AF o a un colectivo de PI Data Archive. Para obtener mas
infórmación, consulte Gestionar preferencias de cónexión para PI System Explorer.
En esta sección
• Mostrar valores de atributo en unidad de medida de origen
• Cambiar la unidad de medida de los valores de atributo mostrados
Mostrar valores de atributo en unidad de medida de origen
En el caso de los atributos que estan definidós por las referencias de datos, puede mostrar sus
valores en las unidades de medición que estan definidas por la referencia de datos, en lugar de
las unidades de medición predeterminadas que estan establecidas en las plantillas de atributos.
Procedimiento
1. Seleccione Herramientas > Opciones.
2. En la pestana General, seleccione Utilizar unidad de medida origen para visualizar atributo.
3. Haga clic en Apply.
4. Haga clic en Aceptar para cerrar la ventana.
Cambiar la unidad de medida de los valores de atributo mostrados
Durante la sesión actual en PI System Explorer, puede cambiar la unidad de medición (UOM)
que se muestra para un valor de atributo desde su valor predeterminado o asignado.
Procedimiento
1. En la pestana Atributos del visor de Elementos o Event Frames, haga clic con el bótón
secundario sobre el valor de un atributo y luego haga clic en Cambiar despliegue de UOM.
2. En la ventana Seleccionar visualización de UOM, seleccione una UOM nueva para el valor de
la lista Visualización de UOM.
Nota:
La lista contiene todos los valores de las UOM de una clase. <Default> se muestra al
lado de la UOM predeterminada. Si selecciónó un grupo de UOM en Herramientas >
Opciones, y el grupo de UOM seleccionado tiene una asignación para la UOM
predeterminada del atributo, se muestra <Mapped> al lado de la UOM asignada.
3. Haga clic en Aceptar.
Configuración de la pantalla de columnas
Columnas de propiedades
Siempre que se muestran columnas en el visor o en una ventana resultados de busqueda, es
posible personalizar que columnas de propiedades se desea ver. En la parte mas a la derecha de
Guía del usuario PI System Explorer
7
Introducción a PI Asset Framework
la ventana, puede hacer clic en
y efectuar selecciones de columnas adicionales o borrar las
selecciones de columnas predeterminadas.
Columnas de atributos
En las ventanas Visor o Resultados de busqueda de elementos y event frames, tambien puede
seleccionar columnas de atributos y mostrarlas como columnas junto con las columnas de
propiedades predeterminadas. Cada columna de atributos se identifica mediante el caracter |.
Seleccionar atributos para mostrar como columnas del visor
Para las colecciones de Elementos, Búsquedas de elementos, Búsquedas de marcos de evento
y Búsquedas de transferencias, puede seleccionar atributos para mostrar como columnas en el
visor, ademas de las propiedades predeterminadas.
Procedimiento
1. En el panel del navegador, elija una de las siguientes acciones:
◦ Para seleccionar atributos para las colecciones Elementos y Búsquedas de elementos,
haga clic en Elementos.
◦ Para seleccionar atributos para las colecciones Búsquedas de event frames y Búsquedas
de transferencias, haga clic en Event Frames.
2. En el navegador, haga clic en la cólección para la que desea seleccionar atributos.
3. En el extremo derecho del visor, haga clic en
.
4. Haga clic en Seleccionar atributos.
5. En la ventana Seleccionar atributos, elegir entre las siguientes opciones para seleccionar los
atributos que desea mostrar en el visor:
Para…
Haga lo siguiente…
Anadir atributos desde la plantilla
a. Seleccione la ópción Añadir atributos desde
la plantilla.
b. Seleccione una plantilla de la lista.
Anadir atributos de un elemento o event frame
Nota:
No es posible anadir atributos desde una
cólección Búsquedas de transferencias.
a. Seleccione la ópción Añadir atributos desde
el elemento/event frame.
b. Elija una de las siguientes acciones:
▪ Para buscar un elemento o event frame,
haga clic en
e introduzca criterios
para localizar atributos en la ventana
Búsqueda de elementos o Búsqueda de
event frames.
▪ Para seleccionar un elemento o event
frame desde el arból del navegador, haga
clic en
y seleccione entre la ventana
Navegador de elementos o Explorador de
EventFrame.
c. Haga clic en Aceptar.
Anadir otros atributos
a. En el campo Otros, introduzca nombres de
atributos separados por punto y coma o haga
clic en
e introduzca criterios para
localizar atributos en la ventana Búsqueda de
atributos.
b. Haga clic en Agregar.
8
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Los atributos seleccionados se muestran por orden alfabeticó en las listas de la izquierda
Atributos o Plantillas de atributos. Para mayor comodidad, puede agruparlos por categóría
o plantilla seleccionando una de las casillas de Agrupar por. Tambien puede filtrarlós si es
necesario con criterios de busqueda adicionales.
6. En las listas Atributos o Plantillas de atributos, seleccione los atributos que desee mostrar
en el visor.
a. Utilice combinaciones de teclas estandares de Windows (como MAYUS+<click> y CTRL
+<click>) para seleccionar atributos contiguos y no contiguos en la lista, tal como se
describe en Seleccionar varios objetos en el visor.
para mover los elementos seleccionados o en
b. Haga clic en
elementos a la lista Atributos de la derecha.
para mover todos los
7. Opcional. Ajuste el orden en el que se móstraran los atributos en las columnas del visor:
Para…
Haga lo siguiente…
Mover un atributo hacia arriba en la lista
Seleccione un atributo debajo de la fila superior y
haga clic en
.
Mover un atributo hacia abajo en la lista
Seleccione un atributo arriba de la fila inferior y
haga clic en
.
Eliminar un atributo de la lista
Seleccione un atributo y haga clic en
Eliminar todos los atributos seleccionados
Haga clic en
.
.
8. Opcional. Puede anadir atributos adicionales segun se requiera; por ejemplo, puede
anadirlós desde otra plantilla. Repita los pasos del 5 al 7.
9. Haga clic en Aceptar para finalizar la selección de atributos.
Los atributos seleccionados apareceran como columnas en el visor.
10. Opcional. Es posible controlar que columnas de atributos seleccionadas se móstraran en el
visor:
Para…
Haga lo siguiente…
Eliminar una columna de atributo
a. Haga clic en
.
b. Haga clic en Columnas de atributo.
c. No marque el atributo que desee eliminar.
Eliminar todas las columnas de atributo
a. Haga clic en
.
b. No marque Mostrar atributos en columnas.
Seleccionar varios objetos en el visor
Para seleccionar en el visor varios objetos para operaciones como copiar, eliminar, exportar,
ingresar o extraer, cambiar de plantilla, etc., utilice el ratón y las combinaciones de teclas
estandares de Windows.
Guía del usuario PI System Explorer
9
Introducción a PI Asset Framework
Procedimiento
• Para seleccionar un grupo de objetos consecutivos en el visor, haga clic en un objeto, mueva
el cursor al final del grupo, pulse la tecla MAYÚS. y haga clic en el ultimó objeto del grupo.
• Para seleccionar objetos no consecutivos, pulse la tecla CTRL y haga clic al mismo tiempo en
cada objeto del visor.
• Para seleccionar todos los objetos del visor, pulse CTRL + A. Si desea anular la selección de
algun objeto individual dentro del grupo seleccionado, pulse la tecla CTRL y haga clic en
cada objeto.
Resultados
Tras seleccionar los objetos, haga clic con el bótón secundario y haga clic en la óperación que
desee realizar en el menu contextual.
Duplicación de objetos
Puede copiar objetos individuales o varias filas de objetos y pegar la infórmación de esos
objetos en una hoja de calculó en un formato separado por tabulaciones.
La ópción Copiar esta disponible en el menu contextual de PI AF. Las opciones Copiar ruta y
Copiar celda estan disponibles donde corresponde.
Nota:
Cuando arrastra y suelta, el portapapeles siempre contiene la infórmación de la ruta, que
devuelve los datos compatibles con otras aplicaciones cliente, como PI ProcessBook.
Copiar
En cualquier navegador de PI AF, utilice Copiar en un menu contextual para colocar la ruta
completa del objeto seleccionado del portapapeles:
\\Kaboom\Chocolate Milk Tutorial\ChocolateMilkModel\MixFlow
En cualquier lista o cuadrícula del visor, use Copiar para colocar el contenido de cada columna
mostrada en la fila seleccionada del portapapeles. Si selecciona multiples filas de PI AF, Copiar
coloca multiples filas de datos separadas por una nueva línea. En la lista de atributos, los datos
copiados incluyen cadenas que corresponden a los iconos de la columna Cónfiguración ( ),
Calidad ( ), Plantilla ( ) y Oculto ( ), ademas de las otras columnas mostradas:
Nombre
Valor
Ruta
10
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Copiar ruta
La ópción Copiar ruta coloca la ruta completa para cada objeto seleccionado del portapapeles.
Si se seleccionan diversos objetos de PI AF, Copiar ruta coloca diversas rutas separadas por una
nueva línea:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Motor
Amps
Copiar celda
En cualquier lista o cuadrícula del visor que contiene multiples columnas, como atributos,
elementos referenciados, event frames secundarios, etc., la ópción Copiar celda coloca los
contenidos de la celda seleccionada en el portapapeles.
Iconos que indican estados de objetos
PI System Explorer usa los siguientes (mini) iconos superpuestos en los iconos de objetos,
como atributos ( ), elementos ( ), Event Frames ( ) y servidores ( ), para indicar el
estado actual de dichos objetos. Dichos iconos tambien se pueden combinar para indicar varios
estados: por ejemplo,
usa los iconos de referencia y predeterminado para indicar el
elemento de referencia principal en un Event Frame, mientras que
usa los iconos de
cónexión y predeterminado para indicar el servidor de PI AF conectado de manera
predeterminada.
Icono
Estado de objeto
Se módificó, pero tódavía no se aplicó.
Lo registró usted.
Lo registró un usuario diferente.
Esta disponible en varias versiones.
Es una referencia a otro objeto.
Es el valor predeterminado.
Esta desconectado (p. ej., un miembro colectivo).
Esta conectado (p. ej., un servidor de PI AF).
Es una busqueda.
Es una plantilla.
Esta ordenado por categóría.
No esta guardado (p. ej., una busqueda).
No es compatible (p. ej., una versión del servidor).
Ingresar cambios en bases de datos
Cada vez que realice un cambio en un objeto, como siempre que cree un nuevo objeto, PI
System Explorer extraera ese objeto de la base de datos. Debe guardar estos cambios en la base
Guía del usuario PI System Explorer
11
Introducción a PI Asset Framework
de datos, aunque puede aplicar cambios a un objeto seleccionado al hacer clic en
de herramientas y luego registrar sus cambios.
en la barra
• Los cambios que no se han guardado se indican con un icono de marca de verificación de
color rojo .
• Los cambios que se han aplicado, pero no se han guardado en la base de datos, se indican
con un icono de marca de verificación de color rojo oscuro .
Dispone de las siguientes opciones para guardar los cambios mientras trabaja:
• Haga clic en Archivo > Ingresar.
• En la barra de herramientas, haga clic en Ingresar.
• En el navegador, haga clic con el bótón secundario sobre un objeto y luego haga clic en
Ingresar para guardar los cambios en la base de datos para ese objeto unicamente.
Las dos primeras opciones le permiten guardar los cambios de todos los objetos que haya
módificadó. Se móstrara la ventana Ingresar con los objetos que se han módificadó. Puede
seleccionar todos o seleccionar solo algunos y dejar el resto fuera. Haga clic en Sesión para
seleccionar los objetos módificadós solo en la sesión actual. Seguira teniendo la posibilidad
de ingresar los objetos módificadós en otras sesiones.
Deshacer extracción
Si opta por no guardar los cambios, puede utilizar la ópción Archivo > Deshacer extracción. En
la ventana Deshacer extracción, borre los elementos de la lista que desea ingresar y haga clic en
Deshacer extracción.
Deshacer extracción para todos los usuarios
Ocasionalmente, es posible que no pueda módificar un objeto de PI AF porque el elemento se
ha extraídó ha otro usuario. Vera los siguientes tipos de mensajes que le infórmaran de que el
objeto lo ha bloqueado otro usuario.
• En las nótificaciónes, cuando intente detener una nótificación, cambiarle el nombre,
eliminarla o módificarla de cualquier otra forma, aparecera el mensaje de error
Notification 'Notification_name' with Unique ID 'ID' is locked by user
Windows_account.
• En PI AF, cuando intente trabajar con un objeto, aparecera el mensaje de error AF Object
Name 'Object_name' with UniqueID 'ID' is locked by user Windows_account.
Para deshacer el bloqueo, un usuario con permisos de administrador sobre el objeto
cónfiguradó en Permitir, puede seleccionar Mostrar todos los usuarios en la ventana Deshacer
extracción, seleccione Todo y haga clic en Deshacer extracción. Para obtener mas infórmación,
consulte Derechos de acceso de PI AF.
12
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Videos
Para obtener infórmación sobre el mecanismo de ingresó/extracción de un objeto PI AF, mire
este video:
https://www.youtube.com/watch?v=Pb8ZKxOaTsE&rel=0
Para obtener infórmación sobre cómó ingresar módificaciónes a los objetos PI AF, mire este
video:
https://www.youtube.com/watch?v=Ky1ICZwwBqY&rel=0
Para obtener infórmación sobre cómó deshacer la extracción de los objetos PI AF, mire este
video:
https://www.youtube.com/watch?v=OPSy_HbvAyY&rel=0
Eliminar objetos de PI AF
Los objetos de base de datos de PI AF se eliminan del navegador PI System Explorer. Puede
eliminar cualquier objeto ingresado o extraídó, así como eliminar referencias entre elementos,
event frames y elementos, y event frames. Para obtener mas infórmación sobre las referencias,
consulte Referencias de elementos en la jerarquía de activos.
Procedimiento
1. Para eliminar un objeto de base de datos de PI AF, haga clic en el bótón Elemento, Event
Frame o Biblioteca en el navegador.
2. En el navegador, desplacese hasta el objeto que desea eliminar.
3. Haga clic con el bótón secundario sobre el objeto y luego haga clic en Eliminar.
4. En la ventana Eliminar, puede eliminar objetos que hacen referencia a otros objetos, así
como los que no hacen referencia a ningun objeto.
◦ Si el objeto hace referencia a otros objetos...
Para...
Haga esto...
Eliminar un objeto y todas sus referencias sin
ingresar inmediatamente los cambios.
Haga clic en Eliminar este objeto y todas las
referencias a él. Se requiere el registro para
completar esta acción.
Eliminar solo las referencias seleccionadas
actualmente sin ingresar inmediatamente los
cambios.
Haga clic en Solo eliminar esta referencia al
objeto. Se requiere el registro para completar
esta acción.
Eliminar el objeto permanentemente de su
modelo de activos de PI.
Haga clic en Eliminar permanentemente; esta
acción no puede revertirse.
PRECAUCIÓN:
El resultado de esta ópción es la
eliminación inmediata del objeto y sus
referencias de la base de datos.
◦ Si el objeto no hace referencia a otros objetos...
Para...
Haga esto...
Eliminar un objeto sin ingresar inmediatamente
los cambios.
Haga clic en Eliminar este objeto. Se requiere el
registro para completar esta acción.
Guía del usuario PI System Explorer
13
Introducción a PI Asset Framework
Eliminar el objeto permanentemente de su
modelo de activos de PI.
Haga clic en Eliminar permanentemente; esta
acción no puede revertirse.
PRECAUCIÓN:
El resultado de esta ópción es la
eliminación inmediata del objeto de la base
de datos.
Consejo:
De forma predeterminada, PI AF elimina autómaticamente los analisis y las
nótificaciónes que hacen referencia a un elemento eliminado. Para cambiar este
comportamiento, deshabilite el parametró /EnablePropogationOfTargetDeletion
en la utilidad de diagnósticó de PI AF. Para obtener mas infórmación, consulte
Eliminación de elementos.
5. Haga clic en Aceptar.
Nota:
Si no eliminó permanentemente el objeto, recuerde hacer clic en el bótón Ingresar para
aplicar y guardar los cambios en la base de datos.
Accesos directos de teclado
PI System Explorer proporciona metódós abreviados de teclado para navegar y realizar otras
tareas que necesitan un ratón u otro dispositivo senaladór.
14
Accesos directos
Acción
CTRL+A
Selecciona todos los objetos en el visor
CTRL+C
Copia el objeto seleccionado en el portapapeles.
CTRL+ALT+C
Copia la ruta del objeto seleccionado en el
portapapeles.
CTRL+V
Pega el objeto en el portapapeles del visor.
CTRL+X
Corta (elimina) el objeto seleccionado y lo copia en
el portapapeles.
ELIMINAR
Elimina el objeto seleccionado.
SHIFT+SUPR
Igual que CTRL+X
INSERT
Agrega un objeto nuevo al visor o navegador.
INICIO
Selecciona la primera fila del visor; por ejemplo, la
primera fila de una tabla de atributos.
FIN
Selecciona la ultima fila del visor.
CTRL+INICIO
Selecciona la primera celda de la pagina actual del
visor.
CTRL+FIN
Selecciona la ultima celda de la pagina actual del
visor.
ALT+INICIO
Selecciona la primera pagina de objetos del visor.
ALT+FIN
Selecciona la ultima pagina de objetos del visor.
CTRL+RePag
Selecciona la pagina anterior de objetos del visor.
CTRL+AvPag
Selecciona la pagina siguiente de objetos del visor.
CTRL+INTRO
Si el visor contiene varias paginas de objetos,
muestra la ventana Seleccionar número de página.
ALT+INTRO
En el navegador, muestra las propiedades del
objeto seleccionado.
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Accesos directos
Acción
ESPACIO
Presiona el bótón seleccionado actualmente.
o
INTRO
Flechas a la izquierda, a la derecha, hacia arriba y
hacia abajo
Desplace objetos en el visor o navegador.
F2
Edita el objeto seleccionado en el visor. En el caso
de objetos complejos, muestra la ventana de
edición para el objeto.
F4
Muestra las opciones en el cuadro de lista
seleccionado. En el caso de las listas con capas,
muestra la jerarquía completa de las opciones.
o
ALT+flecha hacia arriba
o
ALT+flecha hacia abajo
CTRL + 1
Navega hasta el navegador Elementos.
CTRL + 2
Navega hasta el navegador Marcos de evento.
CTRL + 3
Navega hasta el navegador Biblioteca.
CTRL + 4
Navega hasta el navegador Unidad de medida.
CTRL + 5
Navega hasta el navegador MyPI.
CTRL + 6
Navega hasta el navegador Notificaciones.
CTRL + 7
Navega hasta el navegador Contactos.
CTRL + 0
Navega hasta el navegador Análisis.
Cambiar el idioma
Pódra cambiar el idioma de PI System Explorer en su equipo si dispone de un paquete de
idioma y tiene instalados los recursos del idioma deseado. La cónfiguración de idioma se
corresponde con la cónfiguración regional del usuario. Por lo tanto, si otros usuarios desean
usar PI System Explorer en el mismo equipo iniciando sesión con otra cuenta, pódran utilizar
otros recursos de idioma, si estan disponibles.
Procedimiento
1. Ejecute el paquete de idioma y seleccione los recursos de idioma que desee instalar, si no
estan aun disponibles.
2. Haga clic en Ver > Configuración de idioma.
3. En la ventana Herramienta de configuración de idioma, seleccione el idioma que desee y haga
clic en Aceptar.
4. Salga de PI System Explorer y reinícieló.
PI System Explorer aparece en el idioma especificadó.
Nota:
La cónfiguración de idioma es específica de la cuenta, por lo que los usuarios que
inician sesión en una cuenta diferente ven el idioma especificadó para esa cuenta.
Guía del usuario PI System Explorer
15
Introducción a PI Asset Framework
Caracteres válidos en nombres de objetos de PI AF
PI AF tiene las siguientes limitaciones con respecto a los nombres de objetos:
• Se eliminan los espacios iniciales y finales de los nombres.
• La longitud maxima para los nombres es 259 caracteres.
• No se permiten los nombres en blanco.
Puede utilizar caracteres estandar del teclado con las siguientes excepciones:
Tipo de objeto
Caracteres no válidos
Otros que no sean contactos
Caracteres de control mas: * ? ; { } [ ] | \ ` ' "
Contactos
Caracteres de control mas: * ? ; [ ] | \ "
Tiempo PI
Puede utilizar una sintaxis especial, denominada PI time, para especificar entradas de marcas
de tiempo e intervalos de tiempo. PI time utiliza abreviaturas específicas, que puede combinar
para crear expresiones temporales.
En esta sección
• Abreviaturas de tiempo PI
• Expresiones de tiempo PI
• Especificación de intervalos de tiempo
• Especificación de intervalos de tiempo
Abreviaturas de tiempo PI
Al especificar un tiempo PI, puede utilizar abreviaturas concretas que representen unidades de
tiempo y referencias temporales.
Abreviaturas de unidades temporales
Abreviatura
Versión completa
Versión plural
Unidad de tiempo correspondiente
s
second
seconds
Segundo
m
minute
minutes
Minuto
h
hour
hours
Hora
d
day
days
Día
mo
month
months
Mes
y
year
years
Anó
w
week
weeks
Semana
Para especificar unidades de tiempo, puede indicar la abreviatura, el nombre completo o la
versión plural de la unidad de tiempo; por ejemplo, s, second o seconds. Debe incluir un valor
validó con cualquier unidad de tiempo. Al especificar segundos, minutos y horas, puede utilizar
16
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
un valor fraccionario; por ejemplo, 1.25h. No se pueden utilizar valores fraccionarios con otras
unidades de tiempo.
Abreviaturas de referencia temporal
Abreviatura
Versión completa
Referencia temporal correspondiente
Hora actual
*
today
00:00:00 (medianoche) del día en curso
y
yesterday
00:00:00 (medianoche) del día anterior
sun1
sunday
00:00:00 (medianoche) del domingo mas reciente
jun2
june
00:00:00 (medianoche) del día en curso del mes de junio del
anó actual
dec DD
december DD
00:00:00 (medianoche) del día DD de diciembre del anó
actual
t
YYYY
00:00:00 (medianoche) del día y el mes actual del anó YYYY
M-D o M/D
00:00:00 (medianoche) del día D del mes de M del anó actual
DD
00:00:00 (medianoche) del día DD del mes actual
1: Utilice las tres primeras letras como abreviatura de cualquier día de la semana: sun, mon, tue, wed,
thu, fri o sat.
2: Utilice las tres primeras letras como abreviatura de cualquier mes del anó: jan, feb, mar, apr, may,
jun, jul, aug, sep, oct, nov o dec.
Expresiones de tiempo PI
Las expresiones de tiempo PI pueden incluir horas fijas, abreviaturas de hora de referencia o
compensaciones de tiempo. Una cómpensación de tiempo indica la dirección de
desplazamiento (+ o -) y la cantidad de desplazamiento (una abreviatura de unidad de tiempo
con un valor).
Por ejemplo, las expresiones de tiempo PI pueden tener la estructura siguiente:
Estructura
Ejemplo
Solo hora fija
24-aug-2012 09:50:00
Solo abreviatura de hora de referencia
t
Solo cómpensación de tiempo
+3h
Abreviatura de hora de referencia con
cómpensación de tiempo
t+3h
Incluya como maximó una cómpensación de tiempo en una expresión. Incluir varias
compensaciones de tiempo puede llevar a resultados imprevisibles.
Especificación de intervalos de tiempo
Para especificar las entradas de las marcas de tiempo, puede introducir expresiones de tiempo
que contengan:
• Tiempos fijós
Una hora fija representa siempre la misma hora, independientemente de la hora actual.
Entrada
Significado
23-aug-12 15:00:00
3:00 p. m. del 23 de agosto de 2012
Guía del usuario PI System Explorer
17
Introducción a PI Asset Framework
Entrada
Significado
25-sep-12
00:00:00 (medianoche) del 25 de septiembre de 2012
• Abreviaturas de referencia temporal
Una abreviatura de referencia temporal representa una hora relativa a la hora actual.
Entrada
Significado
*
Hora actual (ahora)
3-1 o 3/1
00:00:00 (medianoche) del 1 de marzo del anó actual
2011
00:00:00 (medianoche) del mes y día en curso de 2011
25
00:00:00 (medianoche) del día 25 del mes actual
t
00:00:00 (medianoche) del día en curso (hoy)
y
00:00:00 (medianoche) de la fecha anterior al día en curso (ayer)
tue
00:00:00 (medianoche) del martes mas reciente
• Abreviaturas de referencia temporal con cómpensación horaria
Cuando se incluye con una abreviatura de referencia temporal, se anade una cómpensación
horaria a la hora especificada o se resta de ella.
Entrada
Significado
*-1h
Hace una hora
t+8h
08:00:00 (8:00 a. m.) de hoy
y-8h
16:00:00 (4:00 p. m.) de antes de ayer
mon+14.5h
14:30:00 (2:30 p.m.) del ultimó lunes
sat-1m
23:59:00 (11:59 p. m.) del ultimó viernes
• Desplazamientos temporales
Cuando se introducen solos, estos desplazamientos temporales especifican una hora relativa
a una hora de referencia implícita. La hora de referencia implícita puede ser la hora de reloj
actual u otra, en función de dónde introduzca la expresión.
Entrada
Significado
-1d
Un día antes de la hora actual
+6h
Seis horas despues de la hora actual
Especificación de intervalos de tiempo
Las entradas de intervalos temporales definen intervalos para recopilar o calcular valores
durante un períódó de tiempo. Por ejemplo, puede especificar un intervalo de 60 minutos para
calcular el promedio por hora para un períódó de 12 horas. Para especificar entradas de
intervalo de tiempo, introduzca un valor y una unidad de tiempo validós:
• Los valores positivos definen intervalos que comienzan en un momento anterior dentro del
períódó y finalizan en o antes de un momento posterior dentro del períódó.
18
Hora de inicio
2:00:00
Hora de finalización
3:15:00
Intervalo de tiempo
30m
Guía del usuario PI System Explorer
Introducción a PI Asset Framework
Intervalos devueltos
2:00:00 a 2:30:00
2:30:00 a 3:00:00
• Los valores negativos definen intervalos que finalizan en un momento posterior dentro del
períódó y comienzan en o despues de un momento anterior dentro del períódó.
Hora de inicio
2:00:00
Hora de finalización
3:15:00
Intervalo de tiempo
-30m
Intervalos devueltos
02:15:00 a 02:45:00
02:45:00 a 03:15:00
Guía del usuario PI System Explorer
19
Introducción a PI Asset Framework
20
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Luego de la instalación de Cliente de PI AF, un administrador debe cónfigurar el servidor de PI
AF para uso general. La cónfiguración incluye las siguientes tareas:
• Conectarse a un servidor de PI AF y ajustar uno como predeterminado.
• Establecer identidades de PI AF.
• Asignar cuentas de usuario de Windows a una o mas identidades de PI AF.
• Seleccionar un PI Data Archive predeterminado, si no selecciónó uno durante la instalación
de Cliente de PI AF.
• Crear (o importar) bases de datos de PI AF.
• Especificar las preferencias de cónexión de PI System Explorer, si los colectivos de PI AF
estan definidós.
• Cónfigurar permisos de acceso para identidades al servidor y las bases de datos de Cliente
de PI AF. Para obtener mas infórmación, consulte Seguridad de objetos en PI AF.
Video
Para obtener infórmación sobre cómó conectarse a un PI System y buscar uno, mire este video:
https://www.youtube.com/watch?v=_n3yLpjMhew&rel=0
En esta sección
• Conexiones del servidor de PI AF
• Conexiones de PI Data Archive
• Conexiones de bases de datos de PI AF
• Conexiones de colectivos de PI AF y PI Data Archive
Conexiones del servidor de PI AF
Un administrador debe establecer el valor predeterminado y seleccionar a que servidores de PI
AF se debe conectar. Asimismo, un administrador debe cónfigurar las identidades y
asignaciones de PI AF de los servidores de PI AF.
En esta sección
• Conectarse a un servidor de PI AF
• Anadir un servidor de PI AF a la lista de conexiones
• Propiedades del servidor de PI AF
• Ver las propiedades generales del servidor de PI AF conectado
• Administrar identidades en PI AF
• Administrar asignaciones en PI AF
• Ver recuentos de objetos del servidor de PI AF
• Ver metricas de RPC
• Ver conexiones de servidor de PI AF
Guía del usuario PI System Explorer
21
Conexiones de servidor y base de datos
Conectarse a un servidor de PI AF
Utilice la ventana Servidores para revisar las conexiones del servidor de PI AF y para conectarse
a diferentes servidores, segun resulte necesario.
Procedimiento
1. En la barra del menu de PI System Explorer, seleccione Archivo > Conexiones.
En la ventana Servidores, vera una lista de servidores conocidos, identificadós por los
siguientes iconos.
Un servidor de PI AF desconectado en la Tabla de servidores conocidos
Un servidor de PI AF conectado
El servidor de PI AF conectado predeterminado
Un PI Data Archive en la Tabla de servidores conocidos.
El PI Data Archive conectado predeterminado local
Un colectivo de PI Data Archive desconectado
Un colectivo de PI Data Archive conectado
Nota:
El icono y una advertencia indican que el cliente de PI AF esta conectado a una
versión no admitida de PI Data Archive, como las versiones 3.4.375 o 3.4.370. El
cliente de PI AF no puede conectarse a un servidor de PI Data Archive que este
ejecutando un software anterior a la versión 3.4.370.
2. Para conectarse a un servidor de PI AF, elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Conectarse a un servidor de PI AF diferente
Seleccione un servidor de la lista y haga clic en
Conectar.
Conectarse a un servidor como un usuario
diferente (por ejemplo, desde un equipo
compartido)
a. Haga clic con el bótón secundario sobre un
servidor de la lista y haga clic en Conectarse
como.
b. En la ventana Conectarse al servidor PI AF
server, introduzca un nombre de cuenta de
usuario de Windows y la cóntrasena.
c. Haga clic en Aceptar.
Conectarse a un servidor que no se muestra en la Haga clic en Añadir servidor de activos. Para
tabla de servidores conocidos
obtener mas infórmación, consulte Anadir un
servidor de PI AF a la lista de conexiones.
Establecer un servidor de PI AF predeterminado
Haga clic con el bótón secundario en un servidor
de PI AF conectado de la lista y seleccione
Establecer como servidor de activos
predeterminado local.
Aparecera un icono junto al servidor
predeterminado.
22
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Conectarse a un colectivo
a. Haga clic con el bótón secundario en un
colectivo de la lista.
b. Seleccione una de las siguientes acciones:
▪ Para conectarse al servidor primario del
colectivo, haga clic en Connect to Primary
(Conectarse al servidor primario).
▪ Para conectarse a un miembro colectivo
específicó, haga clic en Connect to
Collective Member (Conectarse a un
miembro colectivo), como se describe en
Cambiar a un miembro colectivo concreto.
3. Haga clic en Cerrar.
Añadir un servidor de PI AF a la lista de conexiones
Si el servidor de PI AF que desea conectar no se muestra actualmente en la tabla de servidores
conocidos, puede anadirló en la ventana Propiedades del servidor de PI AF.
Procedimiento
1. En PI System Explorer, haga clic en Archivo > Conexiones.
2. Haga clic en Añadir servidor de activos.
3. En la ventana Propiedades del servidor de PI AF, introduzca las propiedades del servidor de
PI AF.
4. No es necesario que el campo Nombre coincida con el nombre de host. Una vez que conecta
un servidor de PI AF, puede cambiar el nombre del servidor haciendo clic en Renombrar e
introduciendo un nuevo nombre.
PRECAUCIÓN:
El cambio de nombre del servidor de PI AF afectara a todos los clientes.
5. Habitualmente, el campo Cuenta no es necesario en las instalaciones normales y se debe
dejar en blanco.
De manera predeterminada, los clientes de PI AF, como PI System Explorer, intentan utilizar
un nombre principal de servicio (SPN) registrado por el servidor de PI AF para establecer
una cónexión segura con el servidor. Si un SPN no puede ser creado por el servidor de PI AF,
se puede establecer una cónexión segura a traves de Microsoft NTLM si el servidor se
ejecuta bajo una cuenta de sistema, como Network Service. En cada caso, el campo Cuenta
no es necesario y se debe dejar en blanco.
No obstante, si el servidor de PI AF se ejecuta bajo una cuenta de dominio, y un SPN no es
creado correctamente por el servidor de PI AF o un administrador, la cuenta de dominio del
servidor se debe especificar para que el cliente de PI AF pueda identificar al servidor de
manera segura.
6. El valor de Tiempo de espera predeterminado de 300 segundos es aceptable en la mayóría
de los casos. Si se producen errores de tiempo de espera mientras trabaja en PI System
Explorer, aumente el tiempo en el cuadro Tiempo de espera.
7. Opcional. Los Alias son nombres alternativos del servidor de PI AF que los usuarios pueden
utilizar para buscar el servidor. Al cónfigurarse, los alias del servidor de PI AF se almacenan
de forma local para el cliente unicamente.
8. Opcional. El vínculó Configurar Active Directory se utiliza para cónfigurar la lista de
contactos de nótificaciónes. Esta es una función del administrador del sistema de PI AF.
9. Haga clic en Conectar.
Guía del usuario PI System Explorer
23
Conexiones de servidor y base de datos
Nota:
Si se muestra un mensaje de error que indica que no se puede conectar al servidor de
PI AF, debe introducir la cuenta de dominio del servidor en el campo Cuenta.
10. Despues de conectar un servidor, puede hacer clic en Seguridad y cónfigurar la seguridad
para el servidor. Para obtener mas infórmación, consulte Jerarquía de seguridad.
11. Haga clic en OK.
Propiedades del servidor de PI AF
Usted administra la cónfiguración del servidor de PI AF conectado actualmente desde la
ventana Propiedades del servidor de PI AF. Las siguientes pestanas estan disponibles:
• General. Para obtener mas infórmación, consulte Ver las propiedades generales del servidor
de PI AF conectado.
• Plug-ins. Para obtener mas infórmación, consulte Ver módulós instalados.
• Bibliotecas. Para obtener mas infórmación, consulte Consultar propiedades de bibliotecas
cargadas.
• Identidades. Para obtener mas infórmación, consulte Administrar identidades en PI AF.
• Asignaciones. Para obtener mas infórmación, consulte Administrar asignaciones en PI AF.
• Recuentos. Para obtener mas infórmación, consulte Ver recuentos de objetos del servidor de
PI AF.
• Métricas de RPC Para obtener mas infórmación, consulte Ver metricas de RPC.
• Conexiones Para obtener mas infórmación, consulte Ver conexiones de servidor de PI AF.
Ver las propiedades generales del servidor de PI AF conectado
En la pestana General de la ventana Propiedades del servidor de PI AF controle y módifique la
cónfiguración del servidor de PI AF conectado actualmente, por ejemplo:
• Nombre del servidor, nombre del host y el ID
• Servidor de datos predeterminado
• Cuenta del servidor
• Numeró de versión del servidor
• Puerto del servidor, tiempo de espera y alias
Procedimiento
en la barra de herramientas de PI System Explorer o haga clic en Archivo >
1. Haga clic en
Propiedades de servidor.
2. En la pestana General de la ventana Propiedades del servidor de PI AF, controle la
infórmación del servidor y módifíquela segun sea necesario.
3. Tambien puede seleccionar una de las siguientes acciones.
24
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Para…
Haga esto…
Cambiar el nombre del servidor de PI AF
a. Haga clic en Renombrar.
b. En el campo Nuevo nombre en la ventana
Nuevo nombre del servidor de PI AF reemplace
el nombre actual por el nombre nuevo.
c. Haga clic en Aceptar.
PRECAUCIÓN:
El cambio de nombre del servidor de PI AF
afecta a todos los clientes de PI AF.
Cambiar el servidor de datos predeterminado
a. Haga clic en la flecha junto al campo Servidor
de datos predeterminado.
b. Seleccione el servidor de datos que se
invócara cuando utilice el parametró de
sustitución de %Server% para los atributos
de plantilla que estan unidos al PI Point o las
referencias de datos de matriz de PI Point.
c. Haga clic en Aceptar.
Nota:
Para utilizar el servidor de datos
predeterminado local del cliente, seleccione
<Inherit local default Data Server>.
Introducir un alias
a. Haga clic en
.
b. En el campo Nuevo nombre de la ventana
Alias nuevo introduzca el nombre alternativo
que los usuarios pueden utilizar para el
servidor de PI AF. Los alias se almacenan
localmente en el cliente.
Cónfiguración de acceso a Active Directory para
los contactos
Ver o módificar los permisos de seguridad de las
identidades de usuario asignadas
Consulte Cónfiguración de acceso a Active
Directory para los contactos.
a. Haga clic en Seguridad.
b. En la Configuración de seguridad controle los
permisos de las identidades enumeradas que
han sido cónfiguradas para cada componente
del servidor. Puede anadir o eliminar
identidades (tambien puede crear
identidades y asignaciones nuevas) segun sea
necesario. Para obtener mas infórmación,
consulte Cónfigurar la seguridad de un
servidor de PI AF.
4. Haga clic en Aceptar.
Administrar identidades en PI AF
Utilice la pestana Identidades para repasar las identidades que estan asignadas actualmente al
servidor de PI AF. Tambien puede agregar, eliminar y editar identidades.
Guía del usuario PI System Explorer
25
Conexiones de servidor y base de datos
Nota:
Mediante los permisos, puede restringir las identidades y asignaciones visibles en la
pestana Identidades, excepto tres identidades integradas: Administradores, Propietario y
Mundial. Esas identidades estan siempre visibles. Tambien puede utilizar permisos para
que las identidades sean editables o de solo lectura. Para obtener mas infórmación sobre
el otorgamiento de permisos a las identidades de PI AF, consulte Seguridad de objetos en
PI AF.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Identidades.
3. Repase la lista de identidades ordenada alfabeticamente. Haga clic en el encabezado de una
columna para cambiar el orden. Las identidades activadas se indican como Verdaderas,
mientras que las identidades desactivadas aparecen en gris y estan indicadas como Falsas.
Las identidades incorporadas Administrador y Mundial son de solo lectura.
4. Puede realizar una de las siguientes acciones:
Para…
Haga lo siguiente…
Desactivar una identidad
a. Haga doble clic en una identidad activada de
la lista.
b. En la ventana Propiedades de identidad, no
seleccione la casilla La identidad está
activada.
c. Haga clic en Aceptar.
Activar una identidad
a. Haga doble clic en una identidad desactivada
de la lista.
b. En la ventana Propiedades de identidad,
seleccione la casilla La identidad está
activada.
c. Haga clic en Aceptar.
Crear una nueva identidad
a. Haga clic con el bótón secundario y seleccione
Nueva identidad.
b. En la ventana Propiedades de identidad,
introduzca un nombre y una descripción para
la identidad.
c. Opcional. Haga clic en la pestana
Asignaciones y haga clic en Añadir. Para
obtener mas infórmación, consulte Anadir
una asignación a una identidad.
Administrar ajustes de seguridad para las
identidades
a. Haga clic con el bótón secundario sobre el
títuló de una columna o debajo de la lista y
haga clic en Seguridad.
b. En la ventana Configuración de seguridad,
puede repasar o módificar permisos para una
identidad enumerada, como tambien puede
agregar o eliminar identidades segun sea
necesario. Para obtener mas infórmación,
consulte Cónfigurar la seguridad de un
servidor de PI AF.
Eliminar una identidad
a. Haga clic con el bótón secundario sobre una
identidad de la lista y haga clic en Eliminar.
b. En la ventana de cónfirmación Eliminar, haga
clic en Sí.
26
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Asignar un nuevo nombre a una identidad
a. Haga clic con el bótón secundario en la lista y
haga clic en Renombrar.
b. Introduzca un nuevo nombre para la
identidad.
c. Haga clic con el bótón secundario y haga clic
en Ingresar para aplicar el cambio.
Administrar asignaciones en PI AF
Utilice la pestana Asignaciones para repasar las asignaciones que estan cónfiguradas
actualmente en el servidor de PI AF. Tambien puede agregar, eliminar y editar asignaciones.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Asignaciones.
3. Repase la lista de asignaciones ordenada alfabeticamente. Si es necesario, desplacese hacia
la derecha para ver las identidades asignadas y las cuentas de Windows.
4. Puede realizar una de las siguientes acciones:
Para…
Módificar las propiedades de una asignación
Haga lo siguiente…
a. Haga doble clic en una asignación de la lista.
b. En la ventana Propiedades de asignación,
puede editar el nombre y la descripción
segun sea necesario, como tambien
seleccionar una identidad diferente desde la
lista desplegable Identidad.
c. Haga clic en Aceptar.
Crear una nueva asignación
Consulte Anadir una asignación a una identidad.
Eliminar una asignación para una identidad
a. Haga clic con el bótón secundario en una
asignación de la lista y haga clic en Eliminar.
b. En la ventana de cónfirmación Eliminar, haga
clic en Sí.
Nota:
Si la cuenta del usuario esta asociada con la
asignación que esta eliminando, se
móstrara una advertencia que indica que
puede estar bloqueado.
Cambiar el nombre a una asignación
a. Haga clic con el bótón secundario en una
asignación de la lista y haga clic en
Renombrar.
b. Introduzca un nuevo nombre para la
asignación.
c. Haga clic con el bótón secundario y haga clic
en Ingresar para aplicar el cambio.
Guía del usuario PI System Explorer
27
Conexiones de servidor y base de datos
Administrar ajustes de seguridad para las
asignaciones
a. Haga clic con el bótón secundario sobre el
títuló de una columna o debajo de la lista y
haga clic en Seguridad.
b. En la ventana Configuración de seguridad,
puede repasar o módificar permisos para una
identidad enumerada, como tambien puede
agregar o eliminar identidades segun sea
necesario. Para obtener mas infórmación,
consulte Cónfigurar la seguridad de un
servidor de PI AF.
Añadir una asignación a una identidad
Cuando agrega una asignación para una identidad, debe especificar la cuenta de Windows que
debe ser asignada y el nombre de la asignación.
Antes de empezar
El identificadór de seguridad (SID) de la cuenta se genera autómaticamente y no se puede
cambiar mientras se crea la asignación.
Procedimiento
1. En el campo Cuenta de la ventana Propiedades de asignación, introduzca uno de los
siguientes tipos de objeto:
◦ Usuario
◦ Grupo
◦ Entidad de seguridad integrada
◦ Cuenta de servicios
◦ Nombre del equipo
Tambien puede hacer clic en e introducir criterios de busqueda en la ventana Seleccionar
usuario, Equipo, Cuenta de servicio, o Grupo para seleccionar el tipo de objeto, la ubicación y
el nombre. Las ubicaciones de busqueda disponibles son el equipo local que aloja el servidor
de PI AF conectado y los nodos de Active Directory a los que el usuario puede acceder.
Nota:
Tambien puede introducir un SID directamente en el campo Cuenta. Cuando se valida
la entrada, si la cuenta es una cuenta de dominio, se antepone un identificadór de
dominio. Si la cuenta es una cuenta local en el equipo host de PI System, se antepone el
nombre de dominio completo.
2. Para validar su entrada en el campo Cuenta, presione Tabulador o haga clic en otro campo.
El campo SID de la cuenta muestra el SID de la cuenta, y el campo Nombre muestra de
manera predeterminada el nombre de la cuenta.
3. En el campo Nombre, módifique el nombre de cuenta predeterminado, segun resulte
necesario.
4. El texto que introduce en el campo Descripción se muestra en la ventana Propiedades del
servidor de PI AF, por lo que puede utilizar este campo para establecer diferencias entre las
asignaciones para una determinada identidad (ya que en PI AF un solo usuario se puede
asignar a varias identidades).
5. Si la identidad aun no se selecciónó, seleccione la identidad que desea asociar con la
asignación de la lista desplegable Identidad.
6. Haga clic en Aceptar.
28
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Ver recuentos de objetos del servidor de PI AF
Puede consultar los recuentos de objetos del servidor de PI AF a los que esta conectado, como
el numeró de bases de datos, elementos, plantillas de elementos, Event Frames, etc.
Procedimiento
1. En PI System Explorer, haga clic en Archivo > Propiedades de servidor.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Recuentos.
Ver métricas de RPC
Puede ver metricas de llamada a procedimiento remoto (RPC) para la cónexión de servidor
actual. La pagina Métricas de RPC muestra datos de desempenó sobre llamadas RPC por
nombre, incluido el numeró de llamadas y la duración de la llamada.
Nota:
Solo los usuarios con privilegios de administrador pueden ver la pagina Métricas de RPC.
A partir de PI AF 2018 SP2, solo ciertos encabezados de columnas en la pagina Metricas
de RPC son visibles.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Métricas de RPC.
3. Puede ver, ordenar y copiar datos en la pagina Metricas de RPC:
◦ Para ordenar los datos por un encabezado de columna, como Llamadas o Duración total,
haga clic en el encabezado de columna.
◦ Para copiar una fila de datos de cónexión de datos, haga clic derecho en la fila y luego
haga clic en Copiar.
◦ Para copiar todos los datos de cónexión, haga clic derecho en la fila, luego haga clic en
Seleccionar todo y a cóntinuación haga clic en Copiar.
4. Revise la infórmación sobre cada llamada segun corresponda. Puede expandir el ancho de
las columnas segun sea necesario.
5. La pagina Metricas de RPC muestra la siguiente infórmación:
Título de la columna
Explicación
Nombre de RPC
El nombre del proceso de cliente ejecutado por el
servidor
Llamadas
El numeró de llamadas totales para cada RPC
desde que se inició el servidor por ultima vez
Duración total
La longitud total de todas las llamadas al servidor
provenientes de un cliente particular
Por llamada
La longitud promedio de cada llamada
Llamadas (Delta)
Un recuento del numeró de llamadas desde que
la lista se móstró o actualizó por ultima vez
Duración (Delta)
La longitud total de las llamadas para cada RPC
desde que la lista se móstró o actualizó por
ultima vez
Guía del usuario PI System Explorer
29
Conexiones de servidor y base de datos
Por llamada (Delta)
La longitud promedio de las llamadas para cada
RPC que ócurrió desde que la lista se móstró o
actualizó por ultima vez
Llamadas (Cliente)
El numeró de llamadas para cada RPC que realizó
el cliente al recuperar las metricas de RPC
Duración (Cliente)
La longitud de la llamada RPC que realizó el
cliente al recuperar las metricas de RPC
Por llamada (cliente)
La longitud promedio de las llamadas para cada
RPC que realizó el cliente al recuperar las
metricas de RPC
Reintentos
El numeró de veces que se intentó el proceso de
cliente
Nota:
Utilice el bótón Actualizar para actualizar la pagina Métricas de RPC con la infórmación
de llamada RPC mas actual.
Ver conexiones de servidor de PI AF
Puede ver, ordenar y copiar detalles sobre conexiones de Servidor de PI AF en la pagina
Conexiones.
Nota:
Solo los usuarios con privilegios de administrador pueden ver infórmación en la pagina
Conexiones.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Conexiones. Se abre
la pagina Conexiones.
3. Puede ver, ordenar y copiar datos en la pagina Conexiones:
◦ Para ordenar los datos por un encabezado de columna en particular, como la hora de
inicio o de finalización, haga clic en el encabezado de columna.
◦ Para copiar una fila de datos de cónexión de datos, haga clic derecho en la fila y luego
haga clic en Copiar.
◦ Para copiar todos los datos de cónexión, haga clic derecho en la fila, luego haga clic en
Seleccionar todo y a cóntinuación haga clic en Copiar.
4. La pagina Conexiones muestra la siguiente infórmación:
30
Título de la columna
Explicación
Nombre de usuario
El nombre del usuario o el servicio conectados al
servidor
Host de cliente
La dirección IPv6 del host
Puerto de cliente
El puerto desde el que se realiza la cónexión
Autenticación
Tipo de protocolo de autenticación utilizada para
establecer la cónexión
Hora de inicio
Hora de inicio de la cónexión
Hora de finalización
Hora de finalización de la cónexión
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Nota:
Utilice el bótón Actualizar para actualizar la pagina Conexiones con la infórmación mas
actual.
5. Para moverse rapidamente a traves de un numeró definidó de registros, haga clic en el bótón
Anterior o Siguiente. Para cambiar la cónfiguración de paginado, consulte Paginar los
resultados de busqueda.
Conexiones de PI Data Archive
Puede definir el PI Data Archive predeterminado, tambien denominado el servidor de datos
predeterminado, en el nivel de la base de datos de Servidor de PI AF y PI AF. La definición del
servidor de datos predeterminado senala PI System Explorer en la ubicación de las referencias
de datos de PI Point. De manera predeterminada, cualquier base de datos sin un conjunto de
servidor de datos predeterminado hereda el servidor de datos predeterminado de Servidor de
PI AF.
El parametró de sustitución %Server% se resuelve segun el servidor de datos predeterminado.
Para obtener mas infórmación, consulte Encontrar el servidor predeterminado de PI Data
Archive. El diagrama siguiente muestra la orden resuelta por el servidor de datos
predeterminado mediante el parametró de sustitución %Server%:
1. Base de datos actual de AF
2. Servidor de PI AF
3. Máquina local del cliente
1. PI AF comprueba si el PI Data Archive predeterminado de la base de datos actual de PI AF
esta especificadó. Si esta especificadó, PI AF busca allí los atributos de plantilla almacenados
que estan vinculados a PI Point o a la referencia de datos de matriz de PI Point. Para obtener
mas infórmación, consulte Ver o editar las propiedades de las bases de datos de PI AF.
2. Si no hay uno especificadó para la base de datos actual, se resuelve segun el ajuste
predeterminado de PI Data Archive de Servidor de PI AF. Para obtener mas infórmación,
consulte Ver las propiedades generales del servidor de PI AF conectado.
3. Si no hay ninguno especificadó en el nivel de PI System, se resuelve segun el PI Data Archive
predeterminado local.
Puede ver el servidor de datos predeterminado para la base de datos y el Servidor de PI AF
usando los metódós siguientes:
• Utilice la ventana Propiedades de la base de datos para ver y ajustar el Servidor de PI AF
predeterminado para la base de datos.
• Utilice la ventana Propiedades del servidor de PI AF para ver y ajustar el servidor
predeterminado de PI Data Archive para el sistema.
Guía del usuario PI System Explorer
31
Conexiones de servidor y base de datos
Nota:
Si el PI Data Archive predeterminado no se especificó en la base de datos de Servidor de
PI AF o PI AF, se puede resolver para un PI Data Archive para maquinas del cliente en
función de su cónfiguración.
En esta sección
• Conectarse a un PI Data Archive
• Revisar conjuntos de estados digitales en un PI Data Archive
• Anadir los servidores de PI Data Archive a las listas de servidores conectados
• Ver estados de almacenamiento en bufer para servidores de PI Data Archive conectados
Conectarse a un PI Data Archive
Utilice la ventana Servidores para revisar las conexiones del servidor conocido de PI Data
Archive y para conectarse a diferentes servidores, segun resulte necesario.
Procedimiento
1. Haga clic en Archivo > Conexiones.
En la ventana Servidores, se muestra una lista de servidores conocidos en la Tabla de
servidores conocidos (KST). Cada uno de los iconos siguientes indica el tipo de servidor y su
cónexión actual:
Un servidor de PI AF desconectado en la Tabla de servidores conocidos
Un servidor de PI AF conectado
El servidor de PI AF conectado predeterminado
Un PI Data Archive en la Tabla de servidores conocidos
El PI Data Archive conectado predeterminado
Un colectivo de PI Data Archive desconectado
Un colectivo de PI Data Archive conectado
Nota:
Un icono de advertencia ( ) junto a un servidor indica que PI Data Archive esta
ejecutando una versión no admitida, como las versiones 3.4.375 o 3.4.370. El cliente
de PI AF no puede conectarse a un servidor de PI Data Archive que este ejecutando un
software anterior a la versión 3.4.370.
2. Para conectarse a PI Data Archive, elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Conectarse a un PI Data Archive diferente
Seleccione un servidor de la lista y haga clic en
Conectar.
Conectarse a un servidor como un usuario
diferente (por ejemplo, desde un equipo
compartido)
a. Haga clic con el bótón secundario sobre un
servidor de la lista y haga clic en Conectarse
como.
b. En la ventana Conectarse al archivo de datos
de PI server, introduzca un nombre de cuenta
de usuario de Windows y la cóntrasena.
c. Haga clic en Aceptar.
32
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Conectarse a un servidor que no se muestra en la Haga clic en Añadir servidor de PI. Para obtener
tabla de servidores conocidos
mas infórmación, consulte Anadir los servidores
de PI Data Archive a las listas de servidores
conectados.
Defina un PI Data Archive local predeterminado
Haga clic con el bótón secundario en un servidor
de la lista y seleccione Establecer como servidor
de datos predeterminado local. Aparecera un
icono junto al servidor de datos
predeterminado local.
3. Haga clic en Close.
En esta sección
• Problemas de cónexión de PI Data Archive
• Cónfiguración de clientes para permitir solicitudes de inicio de sesión explícitas
Problemas de conexión de PI Data Archive
La autenticación de Windows solo utiliza mapeos de identidad y no emplea los trusts de
autenticación definidós con credenciales de Windows ni ningun otro tipo de trust que se
cónfigure. Al conectarse a PI Data Archive, es posible que aparezcan mensajes de error si no se
ha cónfiguradó ninguna asignación de PI y existe alguna de estas condiciones:
• Utiliza un nombre de usuario y cóntrasena de PI para iniciar sesión en PI Data Archive.
• Utiliza el usuario predeterminado con una cóntrasena en blanco para iniciar sesión en PI
Data Archive.
Estos errores se producen porque en PI AF 2012 y versiones posteriores, los ajustes de
seguridad son mas estrictos que en versiones anteriores de PI AF. Los clientes que se conectan
a PI Data Archive a traves de PI AF 2012 y versiones posteriores deben respetar estos
comportamientos:
• El comportamiento predeterminado de las conexiones es no solicitar al usuario un inicio de
sesión explícitó excepto si se ha cónfiguradó la ópción de Permitir petición de inicio de
sesión. Este ajuste controla lo que sucede cuando falla la autenticación en PI Data Archive. Si
se ha activado la ópción Permitir petición de inicio de sesión, se abrira una ventana donde se
sólicitara al usuario que proporcione un nombre de usuario y una cóntrasena. Si no se ha
marcado esta ópción, se móstrara un mensaje de error. Este ajuste es específicó de cada
equipo cliente. Para obtener mas infórmación, consulte Cónfiguración de clientes para
permitir solicitudes de inicio de sesión explícitas.
• Las conexiones de usuario predeterminadas ya no son compatibles.
Para resolver las condiciones que producen errores, cónfigure las asignaciones de PI para los
usuarios que vayan a conectarse a PI Data Archive. Para obtener mas infórmación, consulte el
tema "Identidades, usuarios y grupos" in Live Library (https://livelibrary.osisoft.com) de PI
System Management Tools.
Mensajes de error de conexión con PI Data Archive
Mensajes de error
Condiciones del error de conexión
No tiene privilegios suficientes para acceder a PI
Data Archive.
Las conexiones de usuario predeterminadas estan
activadas en PI SDK.
Sin acceso: objeto seguro
Las conexiones de usuario predeterminadas a PI
Data Archive estan activadas actualmente para este
cliente, pero no son admitidas por PI AF.
Guía del usuario PI System Explorer
33
Conexiones de servidor y base de datos
Mensajes de error
Condiciones del error de conexión
No tiene privilegios suficientes para acceder a PI
Data Archive. No hay metódós de autenticación
compatibles activados.
Las conexiones de usuario predeterminadas son el
unicó metódó de autenticación activado en PI SDK.
Sin acceso: objeto seguro
Las conexiones de usuario predeterminadas a PI
Data Archive estan activadas actualmente para este
cliente, pero no son admitidas por PI AF.
No tiene privilegios suficientes para acceder a PI
Data Archive.
No se cónfiguró la ópción de inicio de sesión
explícitó en el registro.
Sin acceso: objeto seguro
La solicitud explícita de inicio de sesión no esta
cónfigurada en este ordenador y por lo tanto no
esta permitida.
Configuración de clientes para permitir solicitudes de inicio de sesión
explícitas
Si fallan todos los protocolos cónfiguradós, utilice PI SDK Utility para permitir la petición de
inicio de sesión.
Procedimiento
1. Abra PISDKUtility desde el menu Inicio de Windows.
2. Haga clic en Conexiones > Opciones.
3. En la ventana Opciones de conexión, seleccione la casilla Permitir petición de inicio de sesión
(si fallan todos los protocolos configurados).
4. Haga clic en Aceptar.
5. Haga clic en Archivo > Salir de PISDKUtility.
Revisar conjuntos de estados digitales en un PI Data Archive
Utilice la pestana Conjuntos de estados en la ventana Propiedades de PI Data Archive para
revisar los conjuntos de estados digitales en un PI Data Archive específicó y compararlos con
conjuntos de enumeración existentes en la base de datos actual de PI AF. Tambien puede
exportar conjuntos de estados digitales del PI Data Archive para crear conjuntos de
enumeración.
Procedimiento
1. Haga clic en Archivo > Conexiones.
2. En la ventana Servidores, seleccione un PI Data Archive conectado.
3. Seleccione una de las siguientes acciones.
◦ Haga clic con el bótón secundario y luego seleccione Propiedades.
◦ En la barra de tareas, haga clic en Propiedades.
4. En la ventana Propiedades de PI Data Archive, haga clic en la pestana Conjuntos de estados.
34
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Ademas de los conjuntos de estados digitales disponibles en el PI Data Archive seleccionado,
la ventana muestra conjuntos de enumeración coincidentes en la base de datos actual de PI
AF y cuantas diferencias existen entre ellos.
5. Elija una de las siguientes acciones.
Para...
Haga esto...
Revisar las diferencias entre un conjunto de
estados digitales y su conjunto de enumeración
equivalente en la base de datos actual
Consulte Revisar diferencias entre conjuntos de
estados digitales y conjuntos de enumeración.
Exportar conjuntos de estados digitales en un PI
Data Archive a la base de datos actual
Consulte Crear conjuntos de enumeración a
partir de conjuntos de estados digitales.
Actualizar la lista de conjuntos de estados
digitales
Haga clic con el bótón secundario en la
cuadrícula y seleccione Actualizar.
6. Para cerrar la ventana Propiedades de PI Data Archive, haga clic en Aceptar.
Revisar diferencias entre conjuntos de estados digitales y conjuntos de
enumeración
En la pestana Conjuntos de estados de la ventana Propiedades de PI Data Archive, revise las
diferencias entre un conjunto de estados digitales en un PI Data Archive seleccionado y su
conjunto de enumeración equivalente en la base de datos de PI AF actual.
Procedimiento
1. En la ventana Propiedades de PI Data Archive, seleccione un conjunto de estados digitales
donde la columna Cónflictós indique que un numeró de estados son diferentes.
Se abre una cuadrícula con una lista de cónflictós.
◦ Si un Nombre de estado digital y un Nombre de valor de enumeración son diferentes,
ambos se muestran en negrita.
◦ Si un nombre de estado digital no existe en un conjunto de enumeración, el Nombre de
valor de enumeración se muestra en negrita y el Nombre de estado digital aparece en
blanco.
◦ Si un nombre de valor de enumeración no existe en un conjunto de estados digitales, el
Nombre de estado digital se muestra en negrita y el Nombre de valor de enumeración
aparece en blanco.
◦ Si un valor de estado digital no existe en un conjunto de estados digitales, pero existe en
el conjunto de enumeración, el Valor y el Nombre de valor de enumeración se muestran
en negrita y el Nombre de estado digital aparece en blanco.
2. Revise otros cónflictós de conjuntos de estados digitales segun las necesidades.
3. Haga clic en Aceptar.
Crear conjuntos de enumeración a partir de conjuntos de estados
digitales
Utilice la pestana Conjuntos de estados en la ventana Propiedades de PI Data Archive para
exportar conjuntos de estados digitales desde un PI Data Archive y crear conjuntos de
enumeración en la base de datos de PI AF actual.
Procedimiento
1. En la ventana Propiedades de PI Data Archive, elija una de las siguientes acciones.
Guía del usuario PI System Explorer
35
Conexiones de servidor y base de datos
Para...
Haga esto...
Crear uno o mas conjuntos de enumeración a
partir de conjuntos de estados digitales en el PI
Data Archive seleccionado
a. Utilice pulsaciones de teclas de selección
estandares de Windows (como MAYÚS
+<click> y CTRL+<click>) para seleccionar
conjuntos de estados digitales contiguos y no
contiguos en la lista, donde la celda Conjunto
de enumeración esta vacía y la columna
Cónflictós muestra EnumerationSet
'EnumName' not found.
b. Haga clic con el bótón secundario y seleccione
Crear conjunto de enumeración a partir del
conjunto de estados.
c. En la ventana Crear conjuntos de enumeración,
haga clic en Sí.
Crear conjuntos de enumeración a partir de
todos los conjuntos de estados digitales en el PI
Data Archive seleccionado
a. Haga clic con el bótón secundario y seleccione
Seleccionar todos.
b. Haga clic con el bótón secundario y seleccione
Crear conjunto de enumeración a partir del
conjunto de estados.
c. En la ventana Crear conjuntos de enumeración,
haga clic en Sí.
Los conjuntos de enumeración que ya existen
se ignoran, pero se crean los que no existen.
2. Haga clic en Aceptar.
3. Para salir de la ventana Servidores, haga clic en Cerrar.
4. Registre los cambios.
Añadir los servidores de PI Data Archive a las listas de servidores
conectados
Si el servidor de PI Data Archive al que desea conectarse no se muestra actualmente en la Tabla
de servidores conocidos, anadaló en la ventana Propiedades de PI Data Archive.
Procedimiento
1. Haga clic en Archivo > Conexiones.
2. En la ventana Servidores, haga clic en Añadir servidor de datos.
3. En la ventana Propiedades de PI Data Archive, introduzca las propiedades, segun resulte
necesario.
4. Opcional. Puede cambiar el nombre predeterminado en el campo Nombre:
a. Haga clic en Renombrar.
b. En el campo Nuevo nombre de la ventana Nuevo nombre de PI Data Archive, introduzca
un nombre para el nuevo PI Data Archive. No es necesario que el nombre coincida con el
nombre de host.
c. Haga clic en Aceptar.
5. Introduzca el nombre de host en el campo Host. Puede introducir:
◦ Un nombre de dominio completo.
◦ Un nombre de servidor.
◦ Una dirección IP. Una dirección IPv6 debe estar entre corchetes [ ].
36
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
6. Salvo que su aplicación concreta necesite otro puerto, acepte los valores predeterminados
en el campo Port.
Nota:
Para módificar el nombre de host y el puerto, debe estar desconectado del servidor.
7. Los valores predeterminados de los campos Tiempo de espera de conexión y Tiempo de
espera de datos son aceptables en la mayóría de los casos. Si experimenta tiempos de espera
de cónexión al conectarse a PI Data Archive desde PI System Explorer, aumente el tiempo en
el campo Tiempo de espera de conexión. Si experimenta errores de tiempo de espera al
acceder a los datos de PI Data Archive, incremente el tiempo en el campo Tiempo de espera
de datos.
8. Opcional. Introduzca un nombre de alias en el campo Alias.
Los alias son nombres alternativos que pueden utilizarse para PI Data Archive. Los alias de
PI Data Archive se almacenan de forma local en el cliente unicamente.
9. Haga clic en Conectar para conectarse a PI Data Archive.
Nota:
Los campos ID, Zona horaria y Versión no son editables. ID es el ID de PI Data Archive,
Zona horaria es la zona horaria local de PI Data Archive y Versión es la versión de PI
Data Archive.
10. Haga clic en Aceptar.
Ver estados de almacenamiento en búfer para servidores de PI Data Archive
conectados
Si esta instalado y en ejecución PI Buffer Subsystem 4.3 o posterior, pódra ver el estado de
bufer de un servidor de PI Data Archive conectado.
Procedimiento
1. Haga clic en Archivo > Conexiones.
En la ventana Servidores, cada servidor de PI Data Archive con una cónexión cónfigurada
muestra un estado de almacenamiento en bufer en la columna Estado del búfer.
Nota:
La versión 3.4.380 y las anteriores de PI Buffer Subsystem muestran el estado
Desconocido.
2. Para ver mas detalles y administrar el almacenamiento en bufer de un PI Data Archive
específicó, haga clic en Buffering Manager para abrir la herramienta Buffering Manager.
Nota:
Tambien puede abrir Buffering Manager desde el menu Herramientas de PI System
Explorer.
Conexiones de bases de datos de PI AF
PI AF almacena objetos de Asset Framework (elementos, plantillas, etc.) en bases de datos de PI
AF. Aunque puede tener varias bases de datos en PI AF, solo pódra conectarse a una de ellas al
mismo tiempo. Por lo general, trabaja con bases de datos de PI AF en PI System Explorer o en PI
Builder. Al iniciar PI System Explorer por primera vez, se conecta a la base de datos
predeterminada de PI AF. Si no se ha definidó ninguna base de datos, PI System Explorer le
sólicitara que cree una.
Guía del usuario PI System Explorer
37
Conexiones de servidor y base de datos
Nota:
La base de datos Configuración se utiliza por clientes de PI AF, como PI Web API, a
medida que interactuan con PI AF. No utilice esta base de datos con sus propios datos de
aplicación.
Videos
Para obtener infórmación sobre cómó crear PI AF bases de datos, mire este video:
https://www.youtube.com/watch?v=P7Zopif-j-c&rel=0
Para obtener infórmación sobre cómó trabaja con varias PI AF bases de datos, mire este video:
https://www.youtube.com/watch?v=CN0R7cW3BUc&rel=0
Para obtener infórmación sobre la base de datos de cónfiguración, mire este video:
https://www.youtube.com/watch?v=bfTnAeSinmo&rel=0
En esta sección
• Crear bases de datos de PI AF
• Ver o editar las propiedades de las bases de datos de PI AF
• Conectarse a una base de datos en un servidor de PI AF diferente
• Cónfigurar la base de datos predeterminada
• La estructura del modelo de activos de PI AF
• Renombrar bases de datos
• Buscar bases de datos de PI AF
• Actualizar la lista de bases de datos
• Eliminar bases de datos
Crear bases de datos de PI AF
Puede crear una base de datos de PI AF vacía sin contenido precónfiguradó o cargar una
biblioteca que se haya guardado en un servidor de PI AF conectado.
Procedimiento
1. Seleccione una de las siguientes acciones:
◦ Presione Ctrl + O.
◦ En la barra de herramientas de PI System Explorer, haga clic en
.
◦ Haga clic en Archivo > Base de datos.
2. En la lista desplegable Servidor de activos de la ventana Seleccionar base de datos,
seleccione un servidor conectado en el que tenga derechos de acceso de administrador para
y seleccionar un servidor de la
crear una base de datos. Tambien puede hacer clic en
ventana Servidores de PI AF.
3. Haga clic en Nueva base de datos.
4. En la ventana Propiedades de base de datos, introduzca un nombre exclusivo en el campo
Nombre.
5. Opcional. Introduzca una descripción en el campo Descripción.
6. Elija una de las siguientes acciones:
38
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Para…
Haga lo siguiente…
Crear una nueva base de datos sin contenido
cónfiguradó
Establezca el campo Cargar biblioteca (si se
muestra) en <None>.
Crear una base de datos con objetos cónfiguradós Seleccione una biblioteca de la lista desplegable
de una biblioteca guardada
Cargar biblioteca. Para obtener mas infórmación,
consulte Bibliotecas guardadas de PI AF.
Crear propiedades extendidas
Consulte Almacenamiento de infórmación
específica para cada aplicación.
Cónfigurar permisos de acceso para la nueva
base de datos
Consulte Cónfigurar la seguridad para una unica
base de datos de PI AF.
7. Haga clic en OK. La nueva base de datos se anade a la lista Base de datos en la ventana
Seleccionar base de datos.
Ver o editar las propiedades de las bases de datos de PI AF
Utilice la ventana Propiedades de base de datos para verificar cuantós objetos existen en cada
tipo de cólección de una base de datos de PI AF, establecer el servidor de datos predeterminado
y revisar o agregar propiedades extendidas y permisos de acceso.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Seleccionar base de datos, haga clic con el bótón secundario en una base de
datos y haga clic en Propiedades.
3. En la ventana Propiedades de base de datos, elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Consulte el numeró de objetos de la base de datos Haga clic en la pestana Recuentos.
Consultar o módificar el nombre y la descripción
de la base de datos
En la pestana General, realice cambios como sea
necesario en los campos Nombre y Descripción.
Consultar o módificar las propiedad ampliadas
a. En la pestana General, haga clic en
Propiedades ampliadas.
b. En la ventana Propiedades ampliadas, realice
cambios como sea necesario en los campos
Nombre y Valor. Para crear una nueva
propiedad, haga clic en Nueva propiedad
ampliada. Para obtener mas infórmación,
consulte Crear propiedades extendidas.
Consultar o módificar la seguridad de la base de
datos
a. En la pestana General, haga clic en Seguridad.
b. En la ventana Configuración de seguridad,
realice los cambios pertinentes. Para obtener
mas infórmación, consulte Cónfigurar la
seguridad para una unica base de datos de PI
AF.
Consultar las propiedades del servidor conectado a. En la pestana General, haga clic en
.
b. En la ventana Propiedades del servidor de PI
AF, consulte la pestana General, tal y como se
describe en Ver las propiedades generales del
servidor de PI AF conectado.
Guía del usuario PI System Explorer
39
Conexiones de servidor y base de datos
Cambiar el servidor de datos predeterminado
a. Haga clic en la flecha junto al campo Servidor
de datos predeterminado.
b. Seleccione el servidor de datos que se
invócara cuando utilice el parametró de
sustitución de %Server% para los atributos
de plantilla que estan unidos al PI Point o las
referencias de datos de matriz de PI Point.
c. Haga clic en Aceptar.
Nota:
Para utilizar el servidor de datos
predeterminado del Servidor de PI AF,
seleccione <Inherit from PI AF Server>.
Cargar una biblioteca guardada
a. En la pestana General, seleccione una
biblioteca guardada de la lista Cargar
biblioteca. Para obtener mas infórmación
sobre bibliotecas guardadas, consulte
Bibliotecas guardadas de PI AF.
b. Haga clic en Aplicar.
4. Haga clic en Aceptar.
Conectarse a una base de datos en un servidor de PI AF diferente
Utilice la ventana Servidores de PI AF para localizar y conectarse al servidor de PI AF que
contiene la base de datos con la que desea trabajar.
Procedimiento
1. En la ventana Seleccionar base de datos, haga clic en
.
2. En la ventana Servidores de PI AF, revise la lista de servidores. Tenga en cuenta que tambien
se muestra la base de datos predeterminada en todos los servidores conectados.
3. Elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Seleccionar el servidor donde se encuentra la
base de datos
Haga doble clic en un servidor conectado (
).
La ventana Servidores de PI AF se cierra y el
servidor seleccionado se muestra en el campo
Servidor de activos.
Comprobar las propiedades de un servidor
Seleccione un servidor y haga clic en
Propiedades.
Conectarse a un servidor
Haga clic con el bótón secundario sobre un
servidor que no este conectado ( ) y haga clic
en Conectar.
Conectarse a un servidor como un usuario
diferente (por ejemplo, desde un equipo
compartido)
a. Haga clic con el bótón secundario sobre un
servidor que no este conectado y haga clic en
Conectarse como.
b. En la ventana Conectarse al servidor PI AF
server, introduzca un nombre de cuenta de
usuario de Windows y la cóntrasena.
c. Haga clic en Aceptar.
40
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Revisar los permisos de acceso para un servidor
conectado
a. Haga clic con el bótón secundario sobre un
servidor conectado y haga clic en Seguridad.
b. En la ventana Configuración de seguridad,
compruebe la cónfiguración de las
identidades de la lista, segun resulte
necesario.
Nota:
Si tiene privilegios de administrador en el
servidor, tambien puede módificar la
cónfiguración de seguridad. Consulte
Cónfigurar la seguridad para nuevas bases
de datos de PI AF.
Configurar la base de datos predeterminada
La base de datos predeterminada se muestra al abrir PI System Explorer por primera vez. Tras
la primera vez que ejecuta PI System Explorer, se móstrara la base de datos que estaba abierta
la ultima vez que cerró PI System Explorer.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Seleccionar base de datos haga clic con el bótón secundario sobre una base de
datos y haga clic en Establecer como base de datos predeterminada. Aparecera un icono de
marca de verificación ( ) sobre el icono de la base de datos que sea actualmente la
predeterminada.
3. Haga clic en Aceptar.
La estructura del modelo de activos de PI AF
Los objetos de PI AF se organizan en una estructura de arból, similar a la estructura de archivos
de un equipo con Windows. En Windows, en lugar de tener miles de archivos en el escritorio,
los archivos se agrupan en carpetas. El mismo concepto se aplica a los elementos de PI AF. La
órganización de elementos en jerarquías hace mas facil navegar por ellos y ofrece infórmación
sobre cómó se relacionan los elementos entre sí.
Al crear un modelo de activos, debe decidir que estructura hara mas facil la busqueda de los
diferentes activos para los usuarios. Tenga en cuenta quienes son sus usuarios y que buscan.
Por ejemplo, es posible que los ingenieros de mantenimiento deseen utilizar PI System
Explorer para buscar y registrar infórmación de mantenimiento. Para esta audiencia, es posible
que desee agrupar activos por tipo de equipo.
Por ejemplo, si tuviera tres elementos de bomba, tal vez desee crear un elemento denominado
Bombas y luego colocar todos los elementos de bomba en el. Si tuviera dos elementos que
representan tanques, pódría colocarlos en el elemento Tanques.
Guía del usuario PI System Explorer
41
Conexiones de servidor y base de datos
Modelo de activos organizados por tipo de equipo
Por otro lado, si tiene varias plantas en diferentes ubicaciones, es posible que el mismo
ingeniero de mantenimiento prefiera ver todos los equipos ubicados en su propia planta. La
siguiente ilustración muestra los mismos elementos organizados por planta.
Modelo de activos organizados por ubicación
No esta limitado a una sola estrategia de órganización. Puede utilizar referencias de elemento
para incluir el mismo activo en diferentes ubicaciones del arból. Por ejemplo, puede optar por
organizar los elementos por tipo de equipo y planta tambien. En la siguiente ilustración, la
jerarquía incluye el arból geógraficó junto al arból de equipos.
Modelo de activos mixto
Tambien, puede anidar la órganización por equipos en la órganización por zonas geógraficas.
Nota:
OSIsoft le recomienda que limite la profundidad de sus jerarquías de activos en hasta 10
niveles para mantener el desempenó y la interpretabilidad de sus datos de activos.
Renombrar bases de datos
Puede cambiar el nombre de una base de datos de PI AF conforme a lo necesario.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Seleccionar base de datos, haga clic con el bótón secundario en una base de
datos y haga clic en Renombrar.
42
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
3. Introduzca un nombre validó para la base de datos. Para obtener reglas sobre nombres de
objetos, consulte Caracteres validós en nombres de objetos de PI AF.
4. Haga clic en Aceptar.
Buscar bases de datos de PI AF
Para buscar una base de datos PI AF específica de un servidor PI AF determinado, utilice la
función Buscar.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Seleccionar base de datos, comience a escribir el nombre de la base de datos
en el campo Bases de datos.
cambiara a Buscando
El icono Buscar
letras que escriba.
. Los resultados se filtraran segun el numeró de
3. Seleccione una base de datos en la lista y haga clic en Aceptar. La ventana se cerrara y pódra
comenzar a trabajar en la base de datos seleccionada.
4. Para volver a la lista completa de bases de datos disponibles, pulse ESC. La ventana se
cerrara.
Actualizar la lista de bases de datos
Es posible que cuando otros usuarios anadan bases de datos al servidor de PI AF, estas no se
muestren hasta que no se actualice.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
2. En la ventana Seleccionar base de datos, haga clic con el bótón secundario en la lista de bases
de datos y haga clic en Actualizar.
Eliminar bases de datos
Cuando elimina una base de datos, se elimina toda la infórmación contenida en esa base de
datos. Por lo tanto, antes de eliminar una base de datos, asegurese de haber seleccionado la
base de datos que desea eliminar.
PRECAUCIÓN:
La óperación de eliminación no se puede deshacer. No obstante, pódra recuperar los
datos si restaura la ultima copia de seguridad de SQL Server.
Conexiones de colectivos de PI AF y PI Data Archive
Un administrador necesita cónfigurar preferencias de cónexión si esta cónfigurandó un
colectivo de PI AF o colectivo de PI Data Archive.
En esta sección
• Gestionar preferencias de cónexión para PI System Explorer
• Cambiar miembros colectivos
• Cambiar a un miembro colectivo concreto
Guía del usuario PI System Explorer
43
Conexiones de servidor y base de datos
Gestionar preferencias de conexión para PI System Explorer
Utilice la ventana Opciones de servidor para definir cómó se debe conectar PI System Explorer
a un colectivo de PI AF o un colectivo de PI Data Archive, si se permitiran solicitudes de inicio
de sesión y si desea que los servidores se anadan de forma autómatica a la tabla de servidores
conocidos.
Procedimiento
1. En PI System Explorer, seleccione Herramientas > Opciones > Opciones de servidor.
2. En la sección Ajustes de conexión del servidor de PI AF en PI System Explorer, defina cómó
PI System Explorer debe conectarse al servidor de PI AF:
Ajuste
Descripción
Preferencia de conexión
Utilice esta preferencia para influir en la selección de un miembro
colectivo cuando se realice una cónexión a un colectivo de PI AF.
◦ Preferir primario
PI System Explorer intentara conectarse con el servidor
primario del colectivo y, si no esta disponible, utilizara los
ajustes de prioridad del miembro colectivo para influir en la
selección de la cónexión del servidor. Este es el valor
predeterminado.
◦ Requerir primario
Es obligatorio conectar PI System Explorer con el servidor
primario del colectivo. Si el servidor primario no esta
disponible, la cónexión falla.
◦ Cualquiera
PI System Explorer se puede conectar con cualquier
miembro disponible del colectivo y utilizara los ajustes de
prioridad individuales del miembro colectivo para influir en
la selección de la cónexión del servidor.
Comportamiento de resolución
de nombre de servidor
Utilice esta preferencia para informarle a PI System Explorer las
acciones que debe realizar cuando intenta comunicarse con uno o
mas servidores de PI AF que no estan en la tabla de servidores
conocidos.
◦ Añadir automáticamente
Agrega un servidor a la tabla de servidores conocidos de
manera autómatica si el nombre del equipo es validó y PI
System Explorer puede encontrar el nombre de equipo del
servidor en la red.
◦ Añadir automáticamente si se puede resolver
Agrega un servidor a la tabla de servidores conocidos
unicamente cuando el nombre del servidor se resuelve
correctamente por un servidor DNS.
◦ No añadir automáticamente
No intenta encontrar un servidor si no se puede encontrar
en el colectivo existente.
Permitir petición de inicio de
sesión
Seleccione esta ópción si desea que aparezca una petición de inicio
de sesión cuando falla una cónexión al servidor debido a una
excepción de seguridad.
3. En la sección Ajustes de conexión de PI Data Archive en PI System Explorer, defina cómó PI
System Explorer debe conectarse a PI Data Archive:
44
Guía del usuario PI System Explorer
Conexiones de servidor y base de datos
Ajuste
Descripción
Preferencia de conexión
Utilice esta preferencia para influir en la selección de un miembro
colectivo cuando se realice una cónexión a un colectivo de PI Data
Archive.
◦ Preferir primario
PI System Explorer intentara conectarse con el servidor
primario del colectivo y, si no esta disponible, utilizara los
ajustes de prioridad del miembro colectivo para influir en la
selección de la cónexión del servidor. Este es el valor
predeterminado.
◦ Requerir primario
Es obligatorio conectar PI System Explorer con el servidor
primario del colectivo. Si el servidor primario no esta
disponible, la cónexión falla.
◦ Cualquiera
PI System Explorer se puede conectar con cualquier
miembro disponible del colectivo y utilizara los ajustes de
prioridad individuales del miembro colectivo para influir en
la selección de la cónexión del servidor.
Comportamiento de resolución
de nombre de servidor
Utilice esta preferencia para informarle a PI System Explorer las
acciones que debe realizar cuando intenta comunicarse con uno o
mas servidores de PI Data Archive que no estan en la tabla de
servidores conocidos.
◦ Añadir automáticamente
Agrega un servidor a la tabla de servidores conocidos de
manera autómatica si el nombre del equipo es validó y PI
System Explorer puede encontrar el nombre de equipo del
servidor en la red.
◦ Añadir automáticamente si se puede resolver
Agrega un servidor a la tabla de servidores conocidos
unicamente cuando el nombre del servidor se resuelve
correctamente por un servidor DNS.
◦ No añadir automáticamente
No intenta encontrar un servidor si no se puede encontrar
en el colectivo existente.
4. En Protocolos en la sección Ajustes de conexión de PI Data Archive, cónfigure los protocolos
de autenticación y el orden en que se utilizan cuando se intentan conexiones a servidores
conocidos.
PI System Explorer intenta conectarse mediante el primer protocolo que aparece en la lista.
Si falla el primer intento, cóntinua intentando conectarse a traves de otro protocolo de la
lista (si corresponde). Si los intentos de uso de todos los protocolos fallan y si se selecciona
Permitir petición de inicio de sesión, se móstrara la ventana Inicio de sesión de PI Data
Archive.
a. Para establecer el orden utilizado cuando se conecta a un servidor, utilice el bótón de las
flechas para mover los protocolos.
b. Seleccione la ópción Permitir petición de inicio de sesión si desea que se muestre una
petición de inicio de sesión cuando falla una cónexión al servidor debido a una excepción
de seguridad.
5. Haga clic en Aceptar.
Guía del usuario PI System Explorer
45
Conexiones de servidor y base de datos
Cambiar miembros colectivos
Cuando se conecta a un colectivo de PI AF, PI AF lo conecta de forma autómatica al miembro
colectivo con la prioridad mas alta (numeró mas bajo). Es posible cambiar la cónexión al
siguiente miembro de la lista de colectivos. El siguiente miembro de la lista esta determinado
por la priorirdad asignada a los miembros.
Procedimiento
1. En PI System Explorer, haga clic en Archivo > Conexiones.
2. Haga clic con el bótón secundario sobre el colectivo y haga clic en Cambiar miembro
colectivo.
Cambiar a un miembro colectivo concreto
Al conectarse a un colectivo de PI AF, lo hara tambien de forma autómatica al miembro
colectivo con la prioridad mas alta (numeró mas bajo). Puede cambiar a un miembro concreto
del colectivo.
Procedimiento
1. En PI System Explorer, seleccione Archivo > Conexiones.
2. Haga clic con el bótón secundario sobre el colectivo y haga clic en Conectar con miembro
colectivo.
3. En la ventana Seleccionar miembro del colectivo, seleccione el miembro colectivo de la lista
Miembro colectivo con el que desea conectar.
4. Haga clic en Aceptar. Ahora estara conectado con el miembro colectivo seleccionado.
46
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Puede exportar una base de datos desde PI System Explorer en XML y luego restablecerla
desde ese archivo XML al importarlo nuevamente a PI AF.
Para exportar la base de datos sin tener que administrar archivos XML, exporte la base de datos
como una biblioteca, como se describe en Guardar bases de datos como bibliotecas.
Videos
Para obtener infórmación sobre cómó importar y exportar bases de datos con PI System
Explorer, mire este video:
https://www.youtube.com/watch?v=ClGTy_lkoTg&rel=0
Para obtener infórmación sobre cómó importar y exportar bases de datos con utilidades de
impórtación y expórtación, mire este video:
https://www.youtube.com/watch?v=zc5pcH1XvMo&rel=0
En esta sección
• Exportar una base de datos a XML
• Restaurar bases de datos desde archivos XML exportados
• Exportar objetos de biblioteca a otra base de datos
• Utilidad AFExport
• Utilidad AFImport
Exportar una base de datos a XML
Este procedimiento archiva bases de datos de PI AF en un archivo XML que se puede restaurar
posteriormente.
Nota:
Tambien puede exportar objetos de PI AF desde una utilidad de línea de comandos.
Consulte Utilidad AFExport.
Procedimiento
1. Haga clic en Archivo > Exportar a archivo.
2. En la ventana Exportar a archivo, seleccione las opciones de expórtación que desee (Opciones
de expórtación a XML).
3. Haga clic en Aceptar.
PI System Explorer expórtara la base de datos actual a un archivo XML.
En esta sección
• Opciones de expórtación a XML
• Todos los objetos referenciados
• Formato de archivo de expórtación y restauración
Guía del usuario PI System Explorer
47
Importación y exportación de bases de datos
Opciones de exportación a XML
La ventana Exportar a archivo contiene las siguientes opciones de expórtación.
Opción de exportación
Resultado
Incluir todos los objetos
referenciados
Hace que se exporten las referencias dependientes, tal como se
detalla en la tabla Todos los objetos referenciados. Utilice esta
ópción para facilitar el movimiento de objetos entre distintas bases
de datos de PI AF.
Incluir ajustes de seguridad
Origina la expórtación de los ajustes de seguridad de objetos
individuales. Aumenta el tiempo necesario para realizar la
expórtación y las subsiguientes operaciones de impórtación. Debe
tener privilegios de administrador para importar objetos que tengan
especificada la ópción de ajustes de seguridad.
XML sin formato
Exporta objetos jerarquicós sin formato. La expórtación sin formato
puede hacer que resulte mas sencillo editar los objetos con algunas
herramientas. Los objetos jerarquicós que se expórtaran sin formato
son: atributos, plantillas de atributos, elementos y marcos de evento.
Simplificar cadenas de
cónfiguración
Elimina el PI Data Archive y los identificadóres de tag de las cadenas
de cónfiguración para las referencias de datos de PI point. Asimismo,
se resólveran los parametrós de sustitución.
Nota:
Esta ópción ralentiza el proceso de expórtación porque
requiere la evaluación de las cadenas de cónfiguración
guardadas.
Incluir valores predeterminados
Incluye los valores predeterminados asignados a los objetos. Sin esta
ópción, en la salida no se incluiran las propiedades cuyo valor
predeterminado no se haya módificadó. Esto ahorra una gran
cantidad de espacio y tiempo cuando se exportan grandes
cantidades de datos.
Incluir ID unicós
Incluye el ID exclusivo de cada objeto en la expórtación. Si incluye
esta ópción, pódra renombrar los elementos existentes durante una
impórtación a la misma base de datos. A menos que sea necesario
renombrar los elementos, resulta mas eficaz dejar esta ópción sin
activar.
Solo objetos de la biblioteca
Desactiva las opciones de Event Frames, transferencias y casos.
Incluir Event Frames,
transferencias y casos
Exporta Event Frames, transferencias y casos.
Todos los objetos referenciados
La siguiente tabla muestra los objetos que se exportan al seleccionar Incluir todos los objetos
de referencia.
Tipo de objeto XML
Referencia incluida
AFAnalysis
AFAnalysisCategories referenciado
AFAnalysisTemplate en Template
AFElementTemplate en CaseTemplate
AFElement en Target
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
48
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Tipo de objeto XML
AFAnalysisTemplate
Referencia incluida
AFAnalysisCategories referenciado
AFElementTemplate en CaseTemplate
AFElement en Target
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFAttribute
Referenciado AFEnumerationSets en ValueTypeQualifier cuando no
proviene de una plantilla
AFAttributeTemplate
Referenciado AFEnumerationSets en ValueTypeQualifier
AFCase
AFElementCategories referenciado
AFEnumerationSets referenciado en atributos sin plantillas
Todos los AFElements secundarios
Todos los AFConnections (no solo aquellos anadidós o eliminados)
AFContact
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFDatabase
UOMDatabase
AFContacts referenciado
AFNotificationContactTemplates referenciado
AFSecurityIdentities (si tambien se selecciona Incluir ajustes de
seguridad)
AFElement y AFModel
AFElementTemplate en Template
AFElementCategories referenciado
AFEnumerationSets referenciado en atributos sin plantillas
AFReferenceTypes a elementos secundarios referenciados
Igual que para todos los elementos secundarios
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFElementTemplate
Base AFElementTemplates
AFElementTemplates referenciado en
AFPort.AllowedElementTemplate
AFReferenceTypes que hace referencia específicamente a esta plantilla
AFElementCategories referenciado
AFEnumerationSets referenciado en plantillas de atributos
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFEnumerationSet
AllReferences anade AFSecurityIdentities de
SecurityAccessControl (si tambien se selecciona Incluir ajustes de
seguridad)
AFEventFrame
AFElementTemplate en Template
AFElementCategories referenciado
AFEnumerationSets referenciado en atributos sin plantillas
AFReferenceType de elementos primarios
AFElements referenciado
Igual que para todos los Event Frames secundarios
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
Guía del usuario PI System Explorer
49
Importación y exportación de bases de datos
Tipo de objeto XML
AFModelAnalysis
Referencia incluida
AFAnalysisCategories referenciado
AFElementTemplate en Template
AFElementTemplate en CaseTemplate
AFElement en Target
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFNotificationTemplate
AFNotificationContacts
AFAnalysisTemplate
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFNotification
AFNotificationTemplate en Template
AFNotificationContacts
AFAnalysis
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFNotificationContact
AFNotificationContactTemplate
AFNoticationContacts secundario
AFContact referenciado
AFNotificationContactTemplate AFNotificationContactTemplates secundario
AFContacts referenciado
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFDeliveryFormat
DeliveryChannel
AFNotificationRule
AFNotificationRuleTemplate
AFNotificationContactTemplate (mediante suscriptores)
AFNoticationContacts secundario
AFContact
AFDeliveryFormat
AFNotificationRuleSubscriber
AFNotificationContactTemplate
AFNoticationContacts secundario
AFContact
AFNotificationRuleTemplate
AFNotificationContactTemplate (mediante suscriptores)
AFNoticationContacts secundario
AFContact
AFDeliveryFormat
AFReferenceType
AFReferenceTypeCategories referenciado
AFElementTemplates de AllowedParentElementTemplate y
AllowedChildElementTemplate
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFSecurityIndentity
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFSecurityMapping
AFSecurityIdentity asignado a
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
50
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Tipo de objeto XML
Referencia incluida
AFTable
AFTableConnection
AFTableCategories referenciado
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFTableConnection
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
AFTransfer
AFElementTemplate en Template
AFElementCategories referenciado
AFEnumerationSets referenciado en atributos sin plantillas
AFElements referenciado en Source y Destination
UOMClass
UOMClass para la clase exportada y las clases referenciadas por las UOM
en UOMClass. Por ejemplo, cuando se exporta la clase Area, esta incluida
la clase Longitud porque las UOM de longitud estan referenciadas por
muchas UOM de area.
Nota:
La expórtación de UOMClass no incluye valores de seguridad, que
solo se exportan con UOMDatabase.
UOMGroup (si alguna de las UOM de las clases exportadas o referenciadas
tiene un UOMGroup asignado).
UOM para todas las UOM que pertenecen a la UOMClass exportada.
UOMDatabase
AFSecurityIdentities de SecurityAccessControl (si tambien se
selecciona Incluir ajustes de seguridad)
UOMGroup. Las asignaciones de grupo estan definidas segun cada UOM.
UOMClass
UOM
Formato de archivo de exportación y restauración
El formato XML de impórtación/expórtación se describe en un archivo de esquema ubicado en
el PIPC\AF directorio de instalación, OSIsoft.AF.xsd.
Gran parte de los objetos de AF admiten un atributo de óperación en XML que permite la
eliminación. Del mismo modo, puede ejecutar la ópción de Auto Point Config de forma selectiva
en los elementos utilizando la misma tecnica.
Ejemplo
...
<AFElement operation="delete"> <Name>ElementToDelete</Name> </AFElement>
...
Los elementos y atributos se pueden importar utilizando una lista plana, en la cual la ruta
relativa del elemento o atributo esta incluida en el nombre de campo. Ejemplo:
...
<AFElement> <Name>RootElement</Name> ... </AFElement>
<AFElement> <Name>RootElement\ChildElement1<\Name> ... </AFElement>
<AFElement> <Name>RootElement\ChildElement2<\Name> ... </AFElement>
...
Guía del usuario PI System Explorer
51
Importación y exportación de bases de datos
Restaurar bases de datos desde archivos XML exportados
Puede restaurar una base de datos que se haya exportado a XML importando objetos desde el
archivo XML.
Tambien puede importar objetos de PI AF con una utilidad de línea de comandos. Consulte
Utilidad AFImport.
Antes de empezar
OSIsoft recomienda que no utilice la ópción Permitir actualizar cuando importe objetos con
nombres duplicados, como Event Frames, en una base de datos de PI AF vacía. De lo contrario,
pódrían ocurrir problemas. Sin embargo, es posible que reciba un mensaje que indique que los
objetos, como las unidades de medida, ya existen en el servidor de PI AF. La impórtación no
intenta realizar ningun cambio en los objetos existentes, lo que significa que, si hay diferencias
entre las propiedades de los objetos en el archivo XML y el sistema de destino, estas no se
resuelven.
Procedimiento
1. Haga clic en Archivo > Importar desde archivo.
2. En la ventana Importar desde archivo, seleccione el archivo XML que contenga los datos y
elija las opciones correspondientes.
Opción de importación
Description
Permitir crear
Permite crear objetos nuevos. Si desea actualizar
elementos existentes, no marque esta ópción
para impedir que se creen nuevos objetos
accidentalmente.
Permitir actualizar
Permite actualizar objetos existentes. Si solo
desea anadir nuevos elementos, no marque esta
ópción para impedir que se sobrescriban objetos
existentes accidentalmente.
Ingreso automático
Permite que la óperación de impórtación ingrese
objetos de forma autómatica a medida que esta
se realiza. De esta forma, se reducen los
requisitos de maximó de memoria de la
óperación. Utilice esta ópción cuando vaya a
importar una gran cantidad de objetos.
Crear o actualizar PI point
Actualiza los atributos con una cónfiguración de
PI point especificada en el archivo XML, si ya
existen, o los crea si no existen. Esta ópción
invoca la ópción CreateConfig de referencia de
datos correcta, que crea o actualiza PI points,
ademas de resolver los parametrós de
substitución y cónfigurar el servidor y los ID de
punto. Cuando se selecciona esta ópción, el
rendimiento de la óperación de impórtación se ve
afectado negativamente.
Nota:
Los PI points no se crean si no se selecciona
la casilla Creación de tag en la ventana
Referencia de datos de PI Point.
52
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Preservar identificaciones únicas
Conserva identificaciónes unicas que existen en
el archivo XML de origen. Esta ópción es valida
solamente cuando tambien estan seleccionadas
las opciones Permitir crear e Ingreso automático.
Cuando se selecciona esta ópción, el rendimiento
de la óperación de impórtación se ve afectado
negativamente. No hay ninguna garantía de que
PI AF preservara las identificaciónes unicas de
los atributos derivados de plantillas, ya que
dichas ID se generan segun la identificación unica
de la plantilla.
Nota:
Dado que los servidores de PI AF
mantienen una cache de rowids a ids,
importar con la ópción Preservar
identificaciones únicas repercute de
manera diferente en los servidores de PI AF
con equilibrio de carga que en los
servidores de PI AF sin equilibrio de carga.
En situaciones sin equilibrio de carga, los
elementos eliminados próvócaran la
actualización de la cache de rowids a ids.
Sin embargo, en situaciones con equilibrio
de carga, se debera reiniciar el servidor no
conectado para que la cache se actualice
despues de eliminar los elementos, y antes
de usar la impórtación con la ópción
Preservar identificaciones únicas para
restaurar los elementos al mismo sistema.
Deshabilitar nuevos análisis y notificaciones
Cuando esta activado (valor predeterminado),
cualquier nuevo analisis o nótificación que se
cree mediante la impórtación es deshabilitado
por la impórtación, independientemente del
valor de la propiedad Activado en el analisis o la
nótificación. El ajuste Estado en el XML para los
analisis y nótificaciónes existentes se ignora y no
se módifica cuando la ópción esta seleccionada.
Exportar objetos de biblioteca a otra base de datos
Puede exportar objetos de biblioteca (plantillas, fórmulas, unidades de medida, etc.) de una
base de datos a otra.
En esta sección
• Bibliotecas guardadas de PI AF
• Guardar bases de datos como bibliotecas
• Cargar bibliotecas de bases de datos
• Consultar propiedades de bibliotecas cargadas
Bibliotecas guardadas de PI AF
Una biblioteca guardada de PI AF ofrece una cólección de objetos de aplicación o de dominio
específicó que puede importar a una base de datos de PI AF. Las bibliotecas guardadas
incluyen, por lo general, categórías, plantillas de elementos, conjuntos de enumeración, tipos de
referencia y tablas, así como la base de datos de unidades de medida, que siempre esta incluida.
Tambien puede tener la ópción de incluir otros objetos, como elementos y nótificaciónes.
Guía del usuario PI System Explorer
53
Importación y exportación de bases de datos
Nota:
Las bibliotecas se almacenan como archivos XML en la base de datos de PI AF de SQL
Server (PIFD), donde resultan facilmente accesibles para otros usuarios. En cambio, la
ópción Exportar a archivo le permite exportar una base de datos completa de objetos
como archivo XML a su equipo o red. El archivo exportado puede importarse en su
totalidad a otro servidor.
Guardar bases de datos como bibliotecas
Los objetos de base de datos se guardan como bibliotecas cuando se desea que esten
disponibles para su impórtación a diferentes bases de datos del servidor de PI AF.
Procedimiento
1. Haga clic en Archivo > Guardar como biblioteca.
2. En la ventana Guardar base de datos como biblioteca, introduzca un nombre en el campo
Nombre de biblioteca. El nombre de la biblioteca no tiene por que ser exclusivo si se preve
sobrescribir una biblioteca existente.
3. Opcional. Introduzca una descripción del contenido de la biblioteca en el campo Descripción.
4. Para sustituir una biblioteca existente, seleccione la casilla Remplazar la biblioteca existente
sin preguntar.
5. Para incluir objetos como elementos y nótificaciónes en la biblioteca, seleccione la casilla
Incluir objetos ajenos a la biblioteca.
6. Haga clic en Aceptar.
Cargar bibliotecas de bases de datos
Puede cargar una biblioteca de base de datos desde un conjunto de bibliotecas que se haya
guardado anteriormente como base de datos de PI AF.
Procedimiento
1. Haga clic en
.
2. En la ventana Seleccionar base de datos, seleccione la base de datos en la que desee cargar
una biblioteca y haga clic en Aceptar.
3. Haga clic en Archivo > Cargar biblioteca.
4. En la ventana Cargar biblioteca en base de datos, seleccione una biblioteca de la lista y haga
clic en Aceptar.
Resultados
Los objetos de la biblioteca cargada completan la base de datos actual. Para cónfirmar cuantós
objetos se cargan, consulte la pestana Recuento en la ventana Propiedades de base de datos, tal
como se describe en Ver o editar las propiedades de las bases de datos de PI AF.
Consultar propiedades de bibliotecas cargadas
Para ver las propiedades de las bibliotecas que se han cargado en el servidor de PI AF, vaya a la
ventana Propiedades del servidor de PI AF. Es posible cambiar el nombre y la descripción de una
biblioteca.
54
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Procedimiento
1. Haga clic en Archivo > Propiedades del servidor.
2. En la ventana Propiedades del servidor de PI AF, haga clic en la pestana Bibliotecas.
Se enumeraran las bibliotecas instaladas actualmente.
3. Haga clic con el bótón secundario en la biblioteca que desee consultar y haga clic en
Propiedades.
4. Opcional. En la ventana Propiedades de biblioteca, puede cambiar el nombre y la descripción
de la biblioteca conforme a lo necesario.
5. Haga clic en Aceptar.
Utilidad AFExport
La utilidad AFExport es una aplicación de línea de comandos que sirve para archivar bases de
datos de PI AF en un formato XML que se puede restaurar posteriormente. Utilice esta utilidad
para archivar elementos, plantillas, Event Frames, transferencias y otros objetos de una base de
datos de PI AF. Tambien puede exportar colecciones de objetos de PI AF desde PI System
Explorer. Consulte Exportar una base de datos a XML.
La utilidad AFExport.exe se encuentra en la carpeta \PIPC\AF.
Para ejecutar la utilidad de expórtación de PI AF, abra una ventana de comandos y vaya a la
carpeta PIPC\AF. Utilice la siguiente sintaxis: AFExport.exe y seleccione uno de los
parametrós incluidos en Parametrós de la utilidad AFExport. Para mostrar todos los
parametrós, escriba:
AFExport /?
En esta sección
• Pautas para exportar colecciones
• Parametrós de la utilidad AFExport
• Rutas de expórtación de muestra
Pautas para exportar colecciones
Debe seguir estas pautas mientras se prepara para exportar una cólección:
• Especifique colecciones por el nombre de propiedad de PI AF SDK, seguido de "[ ]".
• Identifique miembros individuales de una cólección escribiendo su nombre entre corchetes.
• Si no se especifica ningun nombre de cólección, se asume la cólección secundaria
predeterminada para la ubicación de la ruta.
• La cólección secundaria predeterminada de un servidor de PI AF es Databases.
• La cólección secundaria predeterminada de una base de datos es Elements.
• La cólección secundaria predeterminada de un elemento es Elements.
• La cólección secundaria predeterminada de una base de datos de unidades de medida es
UOM.
• Una barra vertical (|) indica una cólección de atributos o de plantillas de atributos.
Guía del usuario PI System Explorer
55
Importación y exportación de bases de datos
Parámetros de la utilidad AFExport
La utilidad AFExport es compatible con los siguientes parametrós.
Parámetro
Forma abreviada
Path
Ruta a un objeto que se desea exportar.
El formato habitual es: \\afserver
\database. Utilice '.' para exportar la
base de datos predeterminada. Consulte
Rutas de expórtación de muestra.
A esta tabla le siguen algunos detalles
adicionales y ejemplos.
56
Descripción
/File:string
/F
Especifica un archivo de salida. Si no se
especifica ninguno, la salida se
transmite a la consola.
/StartTime:string
/T
Especifique una hora de inicio para
hacer que se exporten los Event Frames
que se encuentran entre las horas de
inicio y finalización especificadas.
/EndTime:string
/E
Especifique una hora de finalización al
exportar Event Frames, transferencias y
casos.
/AllReferences[-]
/A
Exporte cualquier objeto referenciado
desde el objeto de PI AF especificadó.
Este parametró no puede utilizarse con
el parametró No References.
/NoReferences[-]
/N
No exporte objetos referenciados,
incluidos los objetos secundarios. Este
parametró no puede utilizarse con el
parametró All References.
/DefaultValues[-]
/D
Si no se especifica este parametró, las
propiedades que estan cónfiguradas con
los valores predeterminados no se
expórtaran y el resultado sera un
archivo de expórtación
considerablemente mas pequenó. La
impórtación de un archivo sin valores
predeterminados sobre objetos
existentes puede producir como
resultado valores que no se restablecen
a sus valores predeterminados.
/Library[-]
/L
Exporte solo los objetos de biblioteca
desde una base de datos. Los objetos de
biblioteca incluyen todas categórías,
plantillas, conjuntos de enumeración,
tipos de referencia y tablas.
/Security[-]
/Y
Exporte infórmación de seguridad. La
expórtación de infórmación de
seguridad aumenta el tiempo de
expórtación y los tiempos de
impórtación posteriores.
/SimplifiedConfigStrings[-]
/Sc
Exporte cadenas de cónfiguración para
plantillas de atributos o atributos
derivados de dichas plantillas de
atributos sin parametrós de substitución
y no exporte UniqueID ni identificadóres
de punto en las cadenas de
cónfiguración.
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Parámetro
Forma abreviada
Descripción
/UniqueIDs[-]
/U
Exporte ID unicós de todos los objetos.
Esto permite cambiar el nombre a los
objetos cuando se vuelven a importar a
la misma base de datos. Este parametró
aumenta el tamanó del archivo de salida
y puede incrementar el tiempo
necesario para la impórtación.
/Silent[-]
/S
Modo silencioso. Impide que se
muestren los mensajes informativos. Si
no se especifica ningun archivo de
salida, se selecciona de forma
autómatica este parametró.
/Summary[-]
/M
Modo resumido. Muestra solo la
infórmación mínima en curso. Este
parametró no es validó con el modo
Silent o si no se especifica ningun
archivo de salida.
/User:string
/user
Utilice esta ópción para especificar una
cuenta de usuario de Windows diferente
para conectarse al servidor de PI AF.
/Password:string
/pw
Si se especifica un nombre de usuario,
especifique la cóntrasena de las
credenciales de red.
/Version
/V
Utilice esta ópción para mostrar
infórmación de la versión. Los demas
parametrós se omiten.
/Flat[-]
/flat
Exporte un objeto jerarquicó en un
formato plano. La expórtación sin
formato puede hacer que resulte mas
sencillo editar los objetos con algunas
herramientas. Los objetos jerarquicós
que se expórtaran sin formato son:
atributos, plantillas de atributos,
elementos y marcos de evento.
/Paste[-]
/Pa
La óperación de pegado se comporta
como un comando copiar/pegar típicó.
/?, /help
Imprime el contenido de esta tabla.
@file
Utilice el archivo especificadó para
proporcionar argumentos de entrada
adicionales. El archivo debe contener un
unicó argumento por línea. Las líneas de
comentarios comienzan con el caracter
#.
Rutas de exportación de muestra
La tabla a cóntinuación contiene sintaxis de muestra para exportar distintos componentes de la
base de datos de PI AF.
Para exportar...
Utilice esta sintaxis...
La base de datos predeterminada
.
La base de datos MyDatabase del servidor de PI
AF predeterminado
\\.\MyDatabase
Guía del usuario PI System Explorer
57
Importación y exportación de bases de datos
Para exportar...
Utilice esta sintaxis...
El elemento MyElement de la base de datos
MyDatabase del servidor de PI AF denominado
MyAFServer
\\MyAFServer\MyDatabase\MyElement
Todas las plantillas de elemento de la base de datos \\.\MyDatabase\ElementTemplates[]
MyDatabase
Plantilla de elemento de T1 de la base de datos
MyDatabase
\\.\MyDatabase\ElementTemplates[T1]
Todos los conjuntos de enumeración de la base de
datos predeterminada de MyAFServer
\\MyAFServer\.\EnumerationSets[]
Todos los atributos de MyChildElement de la base \\MyAFServer\MyElement\MyChildElement
\Attributes[]
de datos MyAFServer predeterminada
La base de datos de unidades de medida
(UOMDatabase distingue entre mayusculas y
minusculas)
\\.\UOMDatabase
Todas las tablas de la base de datos
predeterminada MyAFServer
\\MyAFServer\.\Tables[]
Utilidad AFImport
La utilidad AFImport es una aplicación de línea de comandos que sirve para recuperar objetos
de PI AF en una base de datos. Tambien puede utilizar Importar desde archivo en PI System
Explorer para recuperar objetos de la base de datos. Consulte Restaurar bases de datos desde
archivos XML exportados.
La utilidad AFImport.exe se encuentra en la carpeta \PIPC\AF.
Para ejecutar la utilidad AFImport, abra una ventana de comandos y vaya a la carpeta PIPC
\AF. Utilice la siguiente sintaxis: AFImport.exe y seleccione uno de los parametrós incluidos
en Parametrós de la utilidad AFImport. Para mostrar todos los parametrós, escriba:
AFImport /?
Ejemplo de sintaxis 1
Para importar objetos de base de datos de un archivo XML en una base de datos de PI AF y
crear o actualizar la cónfiguración de PI Point para los elementos recientemente creados,
escriba:
AFImport "\\AFServer\database" /File:"C:\Filename.xml" /P
Nota:
El uso del parametró /P (/CreateUpdatePIPoints) puede tener un impacto
significativó en el rendimiento de la impórtación.
Ejemplo de sintaxis 2
Para importar objetos de base de datos de un archivo XML en una base de datos de PI AF y
deshabilitar la validación de los valores de cadena de cónfiguración para las referencias de
datos y los canales de entrega, escriba:
AFImport "\\AFServer\database" /File:"C:\Filename.xml" /D
58
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Nota:
Use el parametró /D (/DisableConfigStringValidation) para agilizar una óperación
de impórtación. Tenga en cuenta que el uso de este parametró omite la busqueda de PI
Points, lo que corrige o agrega ID de servidor e ID de puntos a las cadenas de
cónfiguración.
Ejemplo de sintaxis 3
Para importar objetos de base de datos de un archivo XML a un subelemento de una base de
datos de PI AF, escriba:
AFImport "\\AFServer\database\element" /File:"C:\Filename.xml"
Parámetros de la utilidad AFImport
La utilidad AFImport es compatible con los siguientes parametrós.
Parámetro
Forma
abreviada
Path
Description
Ruta al objeto al que se desea
importar. El formato habitual es: \
\afserver\database. Utilice '.' para
importar la base de datos
predeterminada.
/File:string
/F
Especifica un archivo de entrada. Si no
se especifica ninguno, la óperación de
impórtación realiza la lectura desde la
entrada estandar.
/AutoCheckIn[-]
/A
Ingrese de forma autómatica los
cambios durante una óperación de
impórtación. Valor predeterminado:
True
/Create[-]
/C
Permita una óperación de impórtación
para crear nuevos objetos. Valor
predeterminado: True
/Update[-]
/U
Permita una óperación de impórtación
para actualizar objetos existentes.
Valor predeterminado: True
/CreateCategories[-]
/CC
Cree categórías que no existen, pero a
las que hagan referencia objetos en la
entrada. Valor predeterminado: True
/CreateUpdatePIPoints[-]
/P
Crea o actualiza la cónfiguración de PI
point de elementos recientemente
creados. Esta ópción puede repercutir
de manera significativa en el
rendimiento de la impórtación.
Guía del usuario PI System Explorer
59
Importación y exportación de bases de datos
Parámetro
Forma
abreviada
Description
/PreserveUniqueIDs[-]
/Pid
Conserve ID unicas que existen en el
archivo XML de origen. Esta ópción
solamente es valida cuando tambien
se especifican /Create y /
AutoCheckIn. Esta ópción puede
repercutir de manera significativa en
el rendimiento de la impórtación.
No hay ninguna garantía de que PI AF
preservara las identificaciónes unicas
de los atributos derivados de
plantillas, ya que dichas ID se generan
segun la identificación unica de la
plantilla.
Nota:
Dado que los servidores de PI AF
mantienen una cache de rowids
a ids, importar con la ópción
Preservar identificaciones únicas
repercute de manera diferente
en los servidores de PI AF con
equilibrio de carga que en los
servidores de PI AF sin
equilibrio de carga. En
situaciones sin equilibrio de
carga, los elementos eliminados
próvócaran la actualización de la
cache de rowids a ids. Sin
embargo, en situaciones con
equilibrio de carga, se debera
reiniciar el servidor no
conectado para que la cache se
actualice despues de eliminar
los elementos, y antes de usar la
impórtación con la ópción
Preservar identificaciones únicas
para restaurar los elementos al
mismo sistema.
60
/DisableNewAnalysesNotifications[-]
/DN
Los nuevos analisis y nótificaciónes se
crean con estado deshabilitado. Los
analisis y las nótificaciónes existentes
en la base de datos de destino no se
ven afectados.
/DisableConfigStringValidation [-]
/D
Desactiva la validación de los valores
de cadena de cónfiguración para las
referencias de datos y los canales de
entrega, lo que puede agilizar la
óperación de impórtación. Sin
embargo, se ómitira la busqueda de PI
points, lo que corrige o anade ID de
servidor e ID de puntos a las cadenas
de cónfiguración.
/GenerateUniqueNames[-]
/G
Genera nombres exclusivos para los
objetos cuando ya existe un objeto con
el mismo nombre.
Guía del usuario PI System Explorer
Importación y exportación de bases de datos
Parámetro
Forma
abreviada
Description
/Paste[-]
/Pa
La óperación de pegar se comporta
como un proceso de copiar/pegar. En
función de dónde se importen los
datos, determina si se generara un
nombre nuevo o no.
/ContinueOnError
/CE
Especifica el comportamiento del
proceso de impórtación cuando se
produce un error recuperable. Las tres
opciones disponibles son Yes, No y
Prompt. El valor predeterminado es
Prompt, salvo en caso de una
ejecución silenciosa, en cuyo caso se
cancelara de forma predeterminada el
proceso de impórtación.
/Silent[-]
/S
Modo silencioso. Impide que se
muestren los mensajes informativos.
/Summary[-]
/M
Modo resumido. Muestra solo la
infórmación mínima en curso.
/User:string
/user
Utilice esta ópción para especificar
una cuenta de usuario de Windows
diferente para conectarse al servidor
de PI AF.
/Password:string
/pw
Si se especifica un nombre de usuario,
especifique la cóntrasena de las
credenciales de red.
/Version
/V
Muestra infórmación de la versión.
Los demas parametrós se omiten.
@file
Lea el archivo de respuestas para
conocer mas opciones. El archivo de
respuesta contiene un unicó
parametró por línea. Las líneas de
comentarios comienzan con el
caracter #.
Guía del usuario PI System Explorer
61
Importación y exportación de bases de datos
62
Guía del usuario PI System Explorer
Recuperación de información de activos
PI System Explorer proporciona una variedad de metódós que usted puede utilizar para ubicar
y revisar los activos de su base de datos de PI AF, que incluye navegadores, ventanas de
busqueda, tendencias para verificar fórmulas y calculós, y administración de versiones.
Tambien puede revisar datos de series temporales para atributos que contengan o hagan
referencia a estos datos.
En esta sección
• Explóración de activos
• Activos y busquedas de datos de activos
• Tendencias en PI System Explorer
• Gestión de versiones para equipos y procesos
• Visualización de diferentes versiones de objeto y objetos obsoletos
• Ver datos de series temporales
Exploración de activos
Use el navegador de PI System Explorer para mostrar los objetos de activos en la base de datos
de PI AF. El navegador muestra los siguientes activos, segun el tipo de activo que haya
seleccionado en el panel del navegador:
• Elementos
Muestra los activos y las busquedas de elementos en formato arból. Puede controlar cuantós
elementos se muestran por pagina.
• Event Frames
Muestra el event frame y las colecciones de busqueda de transferencia. Dado que los
modelos de activos pueden tener miles de event frames o transferencias, estos objetos no se
muestran en una jerarquía del navegador. En su lugar, cada uno de ellos tiene una cólección
de busquedas. Las busquedas recientes tambien se incluyen en la cólección de busquedas.
• Biblioteca
Muestra las colecciones de objetos de Plantillas (para elementos, event frames, modelos y
transferencias), Conjuntos de enumeración, Tipos de referencia, Tablas, Conexiones de
tablas y Categorías (para analisis, atributos, elementos, reglas de nótificación, tipos de
referencia y tablas). Para ver todos los objetos de un determinado tipo, expanda la cólección
de ese tipo.
• Unidades de medida
Muestra todas las clases de UOM en la base de datos de unidades de medida. Cuando
selecciona una clase, las UOM que pertenecen a esa clase se enumeran en el visor y en la
calculadora de cónversión.
• Contactos
Muestra una lista de busqueda de contactos, equipos de escalación, grupos y puntos finales
de entrega independientes para usar con las nótificaciónes.
En esta sección
• Explóración de elementos
Guía del usuario PI System Explorer
63
Recuperación de información de activos
• Cónfigurar el tamanó de la pagina del navegador
• Abrir ventanas adicionales del navegador
Exploración de elementos
Los elementos se muestran en el navegador en forma de arból. La estructura del arból de
elementos varía segun cada órganización. El disenadór de modelos de activos elige la
estructura mas pertinente para los usuarios de la órganización. En la imagen que figura a
cóntinuación, los elementos estan organizados por ubicación de planta. Si es el responsable de
todos los equipos de una determinada planta, este modelo puede resultarle util. Un modelo
diferente puede ser mas util para alguien con un rol diferente.
El arból de elementos puede incluir diferentes subarbóles que proporcionan contextos
diferentes para los mismos activos. Esto permite a los usuarios localizar elementos en el
contexto que les resulte mas util para la tarea que tienen entre manos. Por ejemplo, ademas de
la órganización por ubicación de planta que se muestra mas arriba, puede tener tambien una
órganización por fabricante de equipos, como se muestra en la siguiente imagen.
Los elementos que representan las bombas aparecen en las jerarquías Manufacturers y Plant
Location. En la jerarquía Manufacturer, los elementos de bomba no son elementos nuevos
independientes, sino que son referencias a los elementos que ya existían en el arból de Plant
Location. Para indicar que son referencias de elementos, se representan mediante el icono del
elemento referenciado .
Configurar el tamaño de la página del navegador
El navegador de PI System Explorer esta paginado. Esto significa que muestra varios objetos al
mismo tiempo. Si existen mas objetos, PI System Explorer los muestra en otra pagina. Cuando
y
en el navegador.
esto ocurre, puede ver
El numeró maximó de objetos que pueden mostrarse en el navegador es, de forma
predeterminada, 1000. Puede módificar ese numeró.
64
Guía del usuario PI System Explorer
Recuperación de información de activos
Procedimiento
1. En PI System Explorer, seleccione Herramientas > Opciones.
2. En la pestana General, introduzca el numeró maximó de objetos que se pueden mostrar en
el navegador, en el campo Tamaño máximo de página de rama de árbol.
3. Haga clic en Aceptar.
Abrir ventanas adicionales del navegador
En algunas circunstancias, puede resultar practicó abrir mas ventanas de navegador. Por
ejemplo, puede hacer que se muestre la base de datos de unidades de medida en una instancia
del navegador mientras crea una nueva plantilla en el navegador Biblioteca.
Procedimiento
1. En el panel Navegador, haga clic con el bótón secundario en el elemento que desee abrir en
otra ventana.
2. Seleccione Abrir en nueva ventana.
3. Para moverse entre ventanas, haga clic en el icono de PI System Explorer de la barra de
tareas de Windows y seleccione la vista en miniatura de la ventana que desee.
Activos y búsquedas de datos de activos
PI System Explorer ofrece una variedad de opciones para la busqueda de activos, datos de
activos, y PI points.
• Encuentre los datos de un equipo específicó. Por ejemplo, datos de PI point, resultados de
calculós, infórmación de mantenimiento, etc. Por ejemplo, puede utilizar PI System Explorer
para encontrar infórmación sobre un tanque en particular en una planta en particular.
• Encuentre todos los equipos con valores de atributos o rangos de valores específicós. Por
ejemplo, obtener una lista de todos los tanques con una temperatura superior a los 200 °F.
En esta sección
• Busqueda rapida
• Paginación de resultados de busqueda
• Tamanós maximós de consulta
• Busqueda en una fecha concreta
• Busqueda de PI points
• Administrar resultados de busqueda
• Buscar elementos
• Caracteres especiales en busquedas de nombres
• Busqueda de atributos en elementos
• Buscar event frames
• Buscar atributos en event frames
• Busqueda de transferencias
• Busqueda de atributos en transferencias
Guía del usuario PI System Explorer
65
Recuperación de información de activos
Búsqueda rápida
Puede utilizar el cuadro de busqueda rapida en el extremo derecho de la barra de herramientas
de PI System Explorer para buscar elementos, event frames, plantillas de elementos o tipos de
unidades de medida.
Procedimiento
1. Realice una selección en el panel del navegador para establecer el contexto de la busqueda
rapida. Por ejemplo, seleccione Marcos de evento para definir la busqueda rapida para los
marcos de evento.
2. En el cuadro de busqueda rapida, seleccione un límite de busqueda en Acciones ,
introduzca criterios de busqueda y pulse la tecla Intro. Los resultados de busqueda se
móstraran en el visor y en el navegador.
Nota:
Los resultados de busqueda que se muestren en el navegador permaneceran allí para
que pueda acceder facilmente a ellos en caso de que los necesite. Puede hacer clic con
el bótón secundario y eliminarlos del navegador; tambien se eliminaran al salir de PI
System Explorer. Puede hacer clic con el bótón secundario y guardelós para
conservarlos hasta que los elimine.
Paginación de resultados de búsqueda
Cuando busque un numeró considerable de elementos o Event Frames, puede utilizar la ópción
Ajustar tamaño máximo de consulta para devolver resultados de busquedas rapidas en
fragmentos mas manejables. Esto se conoce como paginación. Cambie el valor de Ajustar
tamaño máximo de consulta al numeró de objetos que desea ver a la vez en los resultados de la
busqueda. Si la busqueda devuelve un numeró de objetos mayor que el especificadó por el valor
de Ajustar tamaño máximo de consulta, los resultados se paginaran.
Por ejemplo, si el valor Ajustar tamaño máximo de consulta es 100 000, el servidor de PI AF
intenta encontrar 100 000 objetos coincidentes antes de devolver los resultados. Es probable
que no desee esperar a que el servidor encuentre tantas coincidencias y que desee verlas en
una unica pagina de resultados de busqueda. Si cambia el valor de Ajustar tamaño máximo de
consulta a 100, el servidor de PI AF enviara los resultados despues de encontrar 100
coincidencias y pódra ver los 100 objetos a la vez en los resultados de busqueda.
Reglas de los resultados de búsqueda
• Solo se paginaran los resultados de busqueda para elementos, transferencias y Event
Frames.
• El parametró Ajustar tamaño máximo de consulta se aplica solamente a busquedas rapidas
de elementos, transferencias o Event Frames. Si busca otros objetos, la busqueda ignórara el
valor Ajustar tamaño máximo de consulta.
• En las ventanas de busqueda, el valor Resultados por página sustituye al valor Ajustar
tamaño máximo de consulta.
Tamaños máximos de consulta
Un ajuste predeterminado del sistema controla el numeró de objetos que puede devolver una
consulta de busqueda. Los usuarios pueden anular el ajuste predeterminado del sistema
especificandó otro valor en las ventanas Busqueda de elementos, Busqueda de atributos,
Busqueda de marcos de evento y Busqueda de transferencia.
66
Guía del usuario PI System Explorer
Recuperación de información de activos
Ajuste predeterminado del sistema
La ópción Tamaño máximo de consulta se cónfigura en Herramientas > Opciones. Al hacerlo, se
cónfigura el valor predeterminado de PI System Explorer.
Tamaños personalizados
Puede anular el ajuste predeterminado del sistema de una busqueda específica cónfigurandó
un valor para Resultados máximos. Para marcos de evento, es posible especificar un valor
personalizado en el campo Resultados por página.
Búsqueda en una fecha concreta
Para realizar una busqueda en PI System Explorer en una fecha y hora concretas, intróduzcalas
en el campo Fecha de consulta. PI System Explorer móstrara tambien las versiones del objeto
para esa fecha. Consulte Fecha de consulta y tiempo en PI System Explorer para obtener mas
infórmación sobre los objetos a los que afecta la Fecha de consulta.
Ademas, pódra establecer una hora o un intervalo de tiempo que se apliquen solo a los valores
de atributo mostrados y dejen el valor de Fecha de consulta como esta. Para ello, ingrese el
contexto temporal en la ventana Establecer contexto temporal como se describe en Establecer el
contexto temporal de los valores de atributo mostrados.
Búsqueda de PI points
Utilice la ventana Búsqueda de tags para recuperar los PI points que coincidan con sus criterios
de consulta de busqueda. En PI AF y PI Builder 2017 o versiones posteriores, puede crear una
consulta de busqueda en función tanto de los atributos de PI point como de los valores de PI
point.
Consejo:
Para crear referencias de datos de PI point directamente desde los PI points recuperados
de una busqueda de PI point, seleccione Ver > Paleta > Búsqueda de tags. Para obtener
mas infórmación, consulte Crear referencias directas de datos de PI Point desde los
resultados de la busqueda de tags.
Procedimiento
1. En el panel del navegador, haga clic en Elementos.
2. Seleccione Buscar > Búsqueda de tags.
3. En la ventana Búsqueda de tags, seleccione los equipos de PI Data Archive en los que desea
buscar.
Para agregar o cambiar computadoras de PI Data Archive, elija una de las siguientes
acciones:
◦ Haga clic en
junto al campo Servidores y haga clic en un PI Data Archive de la lista.
y luego haga clic con el bótón secundario en el PI Data Archive que desea
◦ Haga clic en
agregar de la lista en la ventana Archivos de datos de PI.
◦ Para eliminar un PI Data Archive seleccionado, seleccione el nombre del servidor en el
campo Servidores, haga clic con el bótón secundario y luego haga clic en Eliminar.
Los servidores se agregan en orden alfabeticó, en la selección existente. Puede agregar
varias selecciones de cualquiera de las listas.
4. Cree una consulta de busqueda de PI point en el cuadro de texto ubicado junto al bótón
Buscar. Una consulta de busqueda consta de un nombre de filtró, que puede ser una cadena
Guía del usuario PI System Explorer
67
Recuperación de información de activos
de texto; un atributo de PI point (la ópción predeterminada es tag) o un valor de PI point
(por ejemplo, Value); un operador (la ópción predeterminada es :=) y un filtró de consulta
(la ópción predeterminada es * o todos los PI points). Para obtener una descripción
completa de la sintaxis de una consulta de PI point, consulte Sintaxis para las busquedas de
PI point.
Entre los ejemplos de consultas de atributo se incluyen los siguientes:
◦ sin*
◦ tag:=sin*
◦ tag:<>sin* datatype:float
◦ step:0 AND pointsource:L
◦ tag:<>sin* AND PointType:Float64
Entre los ejemplos de consultas de valor (que se pueden combinar con consultas de
atributo) se incluyen los siguientes:
◦ 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:<*
De manera predeterminada, PI AF busca nombres de puntos que comiencen con la cadena
de la consulta (es decir, que ya este seleccionado el filtró Empieza por).
Nota:
Las consultas que contienen un nombre de filtró de consulta (como name:*sine*)
buscan solo los atributos de tag. En las versiones anteriores de PI AF, las consultas que
cóntenían un nombre de filtró de consulta buscaban el atributo descriptor, así como el
filtró de consulta especificadó, a menos que el atributo descriptor en realidad se haya
especificadó como parte del filtró de consulta.
Para crear una consulta de busqueda, realice una de las siguientes acciones.
Para…
Haga lo siguiente…
Borrar los criterios seleccionados anteriormente
Haga clic en Reiniciar.
Se borran todas las consultas, así como el filtró
Incluir descripción en la búsqueda.
Incluir descripciones de puntos en una consulta
a. Haga clic en
.
b. Haga clic en Add Criteria (Agregar criterios) o
presione ALT + C.
c. Seleccione Incluir descripción en la búsqueda
y ajuste el valor en Verdadero.
Escribir una consulta directamente en el cuadro
de texto de busqueda
a. Escriba el primer caracter de la consulta.
b. Seleccione una ópción de la lista de valores y
atributos del punto coincidentes, o siga
escribiendo manualmente un valor o atributo
del punto.
c. Introduzca los criterios que deben coincidir.
68
Guía del usuario PI System Explorer
Recuperación de información de activos
Incluir atributos de PI point comunes en una
consulta
a. Haga clic en
.
b. Introduzca los criterios en cualquiera de los
siguientes campos:
▪ Nombre (alias para el atributo tag)
▪ Origen de punto
▪ Tipo de datos (alias para el atributo
pointtype)
▪ Clase de punto (alias para el atributo
ptclassname)
c. A fin de introducir los criterios para las
unidades de ingeniería y la descripción, haga
clic en Add Criteria (Agregar criterios) o
presione ALT + C. A cóntinuación, haga clic en
Unidades de ingeniería o Descripción.
Los criterios se anaden a la cadena del cuadro de
texto de busqueda, separados por un espacio.
Nota:
La consulta de busqueda devuelve solo los
PI points que coinciden con todos los
criterios.
Incluir valores de PI point en una consulta
a. Haga clic en
.
b. Haga clic en Add Criteria (Agregar criterios) o
presione ALT + C.
c. Haga clic en cualquiera de los siguientes
criterios:
▪ Valor
▪ Marca de tiempo
▪ IsGood
▪ Anotado
▪ Sustituido
▪ Cuestionable
d. Introduzca los criterios en los campos que ha
seleccionado, segun sea necesario. Tenga en
cuenta que puede seleccionar un operador de
cómparación para los criterios Valor y Marca
de tiempo.
Los criterios se anaden a la cadena del cuadro de
texto de la consulta busqueda, separados por un
espacio.
Nota:
La consulta de busqueda devuelve solo los
PI points que coinciden con todos los
criterios.
Borrar una consulta existente o eliminar un
criterio del area de busqueda expandida
Haga clic en .
Utilizar una consulta anterior
a. Haga clic en
.
b. Haga clic en Búsquedas recientes.
c. Seleccione la consulta existente de la lista.
Guía del usuario PI System Explorer
69
Recuperación de información de activos
Filtrar nombres de punto por contenido,
coincidencia exacta o final
a. Haga clic en
.
b. Haga clic en el filtró adecuado:
▪ Contiene
▪ Coincidencia exacta
▪ Termina en
5. Haga clic en Buscar para recuperar los puntos coincidentes en la tabla de resultados.
6. Elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Revisar datos de serie temporal
Haga clic con el bótón secundario en un PI point y
luego haga clic en Datos de serie temporal. Para
obtener mas infórmación, consulte Ver datos de
series temporales.
Crear una tendencia
Haga clic con el bótón secundario en un PI point y
luego haga clic en Tendencia. Para obtener mas
infórmación, consulte Crear tendencias.
Agregar un PI point a una tendencia existente
Haga clic con el bótón secundario en un PI point y
luego haga clic en Add to Trend (Agregar a
tendencia).
Revisar los atributos, las marcas de tiempo y los
valores de PI point actuales
Haga clic con el bótón secundario en un PI point y
luego haga clic en Propiedades.
Crear una referencia de datos de PI point
Solo para los resultados de busqueda que se
muestran en la paleta.
Arrastre un PI point hasta la cuadrícula
Atributos. Para obtener mas infórmación,
consulte Crear referencias directas de datos de PI
Point desde los resultados de la busqueda de
tags.
Cambiar las columnas en la tabla de resultados
Haga clic en
y borre las columnas que desea
eliminar.
Agregar columnas de atributos a la tabla de
resultados
a. Haga clic con el bótón secundario en un
encabezado de columna y luego haga clic en
Add Column (Agregar columna).
b. En la ventana Seleccionar atributos de punto,
seleccione los atributos del punto que se van
a agregar.
c. Haga clic en Aceptar.
Restaurar las columnas originales en la tabla de
resultados
Haga clic con el bótón secundario en un
encabezado de columna y luego haga clic en
Restore Original Columns (Restaurar columnas
originales).
7. Haga clic en Aceptar.
Los resultados se muestran en el visor. Cada busqueda se enumera temporalmente en el
navegador con la etiqueta Resultados de búsqueda de tags. Para diferenciar entre las
busquedas, puede cambiar una etiqueta; para ello, haga clic con el bótón secundario y luego
haga clic en Renombrar.
Sintaxis para las búsquedas de PI point
Consulte las siguientes secciones para obtener detalles sobre la sintaxis para crear consultas de
PI point en PI AF y PI Builder. Para obtener detalles completos sobre la sintaxis de las consultas
70
Guía del usuario PI System Explorer
Recuperación de información de activos
de PI point, consulte “PIPoint Query Syntax Overview” (Descripción general de la sintaxis de las
consultas de PI point) en PI System Explorer Ayuda > Referencia AF SDK > Descripción general,
o vaya a la pagina de soporte tecnicó PIPoint Query Syntax Overview (https://
techsuppórt.ósisóft.cóm/Dócumentatión/PI-AF-SDK/html/b8fbb6da-7a4b-4570a09d-7f2b85ed204d.htm) (Descripción general de la sintaxis de las consultas de PI point).
Filtros de condición
Para crear una consulta de PI point, introduzca uno o mas filtrós de cóndición AND, que tambien
puede combinar con una cóndición OR, segun sea necesario. Cada cóndición AND contiene una o
mas consultas, separadas por un espacio o AND. Una consulta consta de un nombre de filtró de
consulta, un operador y el filtró de consulta. Esto le permite especificar varias condiciones con
una sola consulta, como se muestra en el siguiente ejemplo:
(tag:<>sin* AND PointType:Float64) OR (tag:="*Tank*" AND DataType:=Int32)
Nota:
Solo puede utilizar parentesis entre las condiciones OR.
Solo puede hacer referencia a un nombre de filtró una vez por cóndición AND de la cadena de
consulta. Por ejemplo, PointId:>5 AND PointId:<10 genera un error, mientras que
PointType:=Int32 OR PointType:=Float32 es validó.
Para obtener la maxima eficiencia, cree su consulta de modo que elimine la mayor parte de los
elementos de los resultados obtenidos con los filtrós de la primera cóndición.
Nombres de filtro de consulta
Al crear consultas en función de los atributos de PI point, el nombre de filtró de consulta es un
nombre o alias de atributo de PI point. Los alias comunes son los siguientes:
Nombre de alias
Nombre de atributo
Nombre
Tag
DataType
PointType
Descripción
Descriptor
PointClass
PtClassName
A partir de PI AF de 2017, puede crear una consulta en función de los valores, ademas de crear
consultas de PI points en función de un atributo. Sin embargo, no puede utilizar la cóndición OR
para crear una consulta de un valor de PI point. Por ejemplo, si introdujera las siguientes
consultas, se generaría un error:
• IsGood:false OR Annotated:true
• PointType:Float AND Value:>10 porque PointType:Float se traduce implícitamente
a 'PointType:=Float16 OR PointType:=Float32 OR PointType:=Float64'
• PointType:Int AND Value:>10 porque PointType:Int se traduce implícitamente a
'PointType:=Int16 OR PointType:=Int32'
• sin* AND Value:>10 porque sin* se traduce implíctamente a 'tag:=sin* OR
Descriptor:=sin*' si el ajuste del filtró predeterminado para Incluir descripción en la
búsqueda esta seleccionado. Para que tanga validez, tiene que borrar el filtró Incluir
descripción en la búsqueda.
Caracteres comodín
Puede utilizar los siguientes caracteres especiales en una consulta de PI point.
Guía del usuario PI System Explorer
71
Recuperación de información de activos
Carácter
especial
Descripción
Ejemplo
*
Substituir cualquier numeró de
caracteres sin especificar
sin*
?
: o :=
Devuelve todos los PI points con nombres que
empiezan por "sin"; por ejemplo, sinusoid y
sinusoidu.
Sustituir un solo caracter sin
especificar
CD?158
Cuando se realizan busquedas de
todos los PI points con un valor
de atributo concreto (distinto a
nombre) separara el atributo y el
valor que este buscando.
pointsource:R
Devuelve todos los PI points con nombres que
empiezan por "CD", seguido de cualquier caracter
unicó, seguido de "158" (por ejemplo, CD1158,
CDA158 y así sucesivamente).
Devuelve todos los PI points con el valor
pointsource R.
"ba:temp.1"
Consejo:
ba\:temp.1
Al buscar el nombre de un
Cualquiera de los ejemplos anteriores devuelve el
PI point que incluya dos
PI point denominado ba:temp.1.
puntos, incluya el nombre
entre comillas dobles o
coloque una barra diagonal
inversa delante de los dos
puntos.
'*Owner Change*'
Delimitadores para cadenas de
busqueda que contienen espacios
o
o caracteres especiales
"*Owner Change*"
''
o
""
Devuelve todos los PI points con nombres que
contienen Owner Change.
"ba:temp.?"
Devuelve todos los PI points con nombres que
empiezan con ba:temp. y terminan con cualquier
caracter unicó.
Nota:
En los resultados de los ejemplos anteriores se asume que se utiliza la ópción de
busqueda predeterminada, que busca nombres de PI points que empiezan por la cadena
de busqueda.
Operarios
La siguiente tabla enumera los operadores que puede utilizar en una cóndición AND.
72
Operador
Descripción
Ejemplo
=
El operador EQUALS.
Tag:Tank* o Tag:=Tank*
<>
El operador NOT EQUALS.
PointType:<>Int32
<
El operador LESS THAN.
Descriptor:<M
<=
El operador LESS THAN OR EQUAL.
Tag:<=Tank
>
El operador GREATER THAN .
Tag:>Tank
>=
El operador GREATER THAN OR EQUAL.
Tag:>=Tank
Guía del usuario PI System Explorer
Recuperación de información de activos
En las consultas de valor de PI point con un tipo de datos de cadena, no puede utilizar los
siguientes operadores: <, <=, > o >=. Ademas, cuando se esperan valores booleanos (como las
consultas de valor del punto Substituted, Questionable, Annotated y IsGood), solo puede
utilizar los operadores = y <>.
Restricciones de sintaxis
• No puede crear consultas de atributos de PI point de datos futuros, como
creationdate:>y-1d AND future:true, en los servidores de PI Data Archive anteriores
a 3.4.395.
• No puede crear consultas de atributos de PI point de datos de seguridad, como PtSecurity
y DataSecurity, en los servidores de PI Data Archive anteriores a 3.4.380.
Administrar resultados de búsqueda
PI System Explorer muestra todos los resultados de busqueda en el navegador donde puede
guardarlos en la cólección Busquedas para volver a utilizarlos, cambiarles el nombre o editar
los criterios. Todos los resultados de busqueda que no estan guardados se indican con un
asterisco.
Nota:
Todos los resultados de busqueda que no estan guardados se eliminan cuando sale de PI
System Explorer.
Procedimiento
1. Opcional. Para trabajar desde una lista de resultados de busqueda en el visor en lugar del
navegador, realice una de las siguientes acciones:
Para…
Administrar una busqueda de elementos o
atributos
Administrar una busqueda de event frames
Haga lo siguiente…
a. En el navegador, haga clic en Elementos.
b. En el navegador, haga clic en la cólección
Búsquedas de elementos.
a. En el navegador, haga clic en Marcos de
evento.
b. En el navegador, haga clic en la cólección
Búsquedas de event frames.
Administrar una busqueda de transferencias
a. En el navegador, haga clic en Marcos de
evento.
b. En el navegador, haga clic en la cólección
Búsquedas de transferencias.
2. Seleccione una busqueda y realice una de las siguientes acciones:
Para…
Haga lo siguiente…
Guardar un resultado de busqueda
Haga clic con el bótón secundario en el nombre
de un resultado de busqueda no guardado y
luego haga clic en Guardar.
Cambiar el nombre a un resultado de busqueda
a. Haga clic con el bótón secundario en el
nombre de un resultado de busqueda y luego
haga clic en Renombrar.
b. Escriba un nuevo nombre para el resultado de
busqueda.
Guía del usuario PI System Explorer
73
Recuperación de información de activos
Copiar un resultado de busqueda
Haga clic con el bótón secundario en el nombre
de un resultado de busqueda y luego haga clic en
Copiar.
Editar criterios para un resultado de busqueda
a. Haga clic con el bótón secundario en el
nombre de un resultado de busqueda y luego
haga clic en Propiedades. (En el visor
tambien puede hacer doble clic en el nombre
de un resultado de busqueda).
b. Módifique los criterios de busqueda segun
sea necesario y haga clic en Aceptar.
Eliminar un resultado de busqueda
a. Haga clic con el bótón secundario en el
nombre de un resultado de busqueda y luego
haga clic en Eliminar.
b. Haga clic en Sí en la ventana de cónfirmación
Eliminar.
Reorganizar resultados de busqueda de
transferencias o event frames
Solo en el navegador:
a. Haga clic con el bótón secundario en el
nombre de un resultado de busqueda de
transferencias o event frames y luego haga
clic en Ordenar por.
b. Seleccione una de las opciones siguientes:
▪ Ordenar por nombre
▪ Ordenar por hora de finalización
▪ Ordenar por hora de inicio
▪ Ordenar por categoría
▪ Ordenar por plantilla
Mostrar la ruta completa a los elementos o los
marcos de evento
Solo en el visor:
a. Haga clic con el bótón secundario en el
encabezado de columna (o debajo de la
cuadrícula de resultados de busqueda).
b. Haga clic en Mostrar rutas completas.
Buscar elementos
Utilice la ventana Búsqueda de elementos para recuperar datos de elementos que coincidan con
sus criterios de busqueda.
Procedimiento
1. En el panel del navegador, haga clic en Elementos.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de elementos.
◦ En el navegador, haga clic con el bótón secundario en el nodo raíz Búsquedas de
elementos y seleccione Nueva búsqueda.
3. Cónfigure la ventana Búsqueda de elementos para encontrar el elemento o elementos en la
base de datos de PI AF.
Nota:
Si introduce valores para varios criterios, la busqueda devólvera solamente aquellos
elementos que coincidan con todos los criterios especificadós.
74
Guía del usuario PI System Explorer
Recuperación de información de activos
4. De la lista Acciones , seleccione el tipo de filtró o aplique: Contiene, Coincidencia exacta,
Comienza con o Finaliza con.
5. Elija una de las siguientes acciones:
Para…
Escribir una o mas condiciones
de filtradó directamente en el
campo Introducir criterios de
elemento
Haga lo siguiente…
◦ Use el operador : o := para seleccionar elementos que
coincidan con un nombre, una descripción, una plantilla y una
categóría.
◦ Use caracteres especiales si es necesario. Para obtener mas
infórmación, consulte Caracteres especiales en busquedas de
nombres.
◦ Coloque entre " las cadenas con espacios o caracteres
especiales.
◦ Separe las condiciones de filtradó con un espacio finó, por
ejemplo:
Category:"Processing Plants" Name:Cracking
Al comenzar con PI AF 2018 SP2, puede utilizar condiciones OR
cuando escribe directamente. Por ejemplo:
◦ “Name:’ElementName’ (|Attribute1:>5 OR |
Attribute2:<2)”
◦ “Description:’TestDescription’ OR
Name:’TestName’”
Filtrar elementos en Criterios
Introduzca valores en los siguientes campos si es necesario. Haga
clic en Agregar criterios para introducir criterios de campos
adicionales.
◦ Nombre
Ingrese el nombre del elemento que desea recuperar segun el tipo de filtró. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un nombre.
Consulte Caracteres especiales en busquedas de nombres.
◦ Raíz de búsqueda de elementos
Ingrese el elemento que desea usar como nivel de base o raíz para la busqueda de
elementos. Escriba el nombre exacto o haga clic en
para abrir la ventana Navegador
de elementos, donde pódra consultar la jerarquía de elementos y seleccionar un
elemento. No puede incluir caracteres cómódín en el nombre que introduzca. Si no
especifica un elemento, establezca el nivel principal de la jerarquía de elementos como la
raíz.
En función de la PI AFjerarquía, la especificación de un elemento en el campo Raíz de
búsqueda de elementos puede mejorar el rendimiento de las busquedas.
◦ Todos descendientes
Seleccione Verdadero para recuperar cualquier subelemento de la jerarquía que coincida
con los criterios especificadós. Seleccione Falso para recuperar solo los elementos de
nivel de raíz que coincidan con los criterios especificadós.
◦ Plantilla
Seleccione la plantilla en la que deben basarse los elementos recuperados. Despues de
seleccionar una plantilla, puede anadir criterios para buscar elementos por valor de
atributo.
Guía del usuario PI System Explorer
75
Recuperación de información de activos
◦ Category
Seleccione la categóría con la que deben coincidir los elementos recuperados.
◦ Valor del atributo
Puede especificar hasta tres condiciones para un valor de atributo. Para cada cóndición,
especifique un nombre de atributo, un operador y un valor de atributo, por ejemplo
Temperature >= 98.
▪ En versiones anteriores a PI AF 2018, esta función solo esta disponible cuando
especifica una plantilla. Para obtener mas detalles, consulte Cónfigurar condiciones de
busqueda para valores de atributo cuando se especifica una plantilla.
▪ En PI AF 2018 y versiones posteriores, puede especificar valores de atributo sin la
necesidad de especificar una plantilla. Para obtener mas detalles, consulte Cónfigurar
condiciones de busqueda para valores de atributo cuando no se especifica una
plantilla.
◦ Description
Ingrese una cadena (de un maximó de 440 caracteres) con la que deben coincidir los
elementos recuperados.
◦ Tipo de elemento
Seleccione el tipo con el que deben coincidir los elementos recuperados.
◦ Tiene anotaciones
(PI AF 2017 o versiones posteriores). Establezca este parametró en True para recuperar
solo los elementos que tienen anotaciones. Establezca este parametró en False para
recuperar solo los elementos que no tienen anotaciones.
◦ Fecha de creación
(PI AF 2017 o versiones posteriores). Seleccione un operador e introduzca una fecha o
una abreviación de PI Time ( >= *-30d es la ópción predeterminada) para recuperar los
elementos que se crearon en el períódó especificadó. Tambien puede hacer clic en
para seleccionar una fecha en la ventana Selector de fecha y hora. Puede seleccionar
Fecha de creación una segunda vez y filtrar la busqueda para mostrar resultados entre
dos valores (< *+1d es la ópción predeterminada).
◦ Modificar fecha
(PI AF 2017 o versiones posteriores). Seleccione un operador e introduzca una fecha o
una abreviación de PI Time ( >= *-30d es la ópción predeterminada) para recuperar los
elementos que se módificarón en el períódó especificadó. Tambien puede hacer clic en
para seleccionar una fecha en la ventana Selector de fecha y hora. Puede seleccionar
Modificar fecha una segunda vez y filtrar la busqueda para mostrar resultados entre dos
valores (< *+1d es la ópción predeterminada).
Nota:
La fecha de módificación de un elemento se actualiza cada vez que se agrega una
anótación o un elemento secundario, así como cuando se comprueba un cambio en su
cónfiguración en la base de datos.
La mayóría de los cambios de plantilla o cualquier módificación de un valor de
atributo que no sea un elemento de cónfiguración no afectaran la fecha de
módificación de un elemento.
76
Guía del usuario PI System Explorer
Recuperación de información de activos
◦ Resultados por página
Ingrese la cantidad maxima de elementos que se pueden mostrar en una sola pagina de
resultados de busqueda.
6. Opcional. Especifique cómó desea que se muestren los resultados en la tabla Resultados.
Para…
Haga lo siguiente…
Agrupar por plantilla
Seleccione la casilla de verificación Plantilla.
Agrupar por categóría
Seleccione la casilla de verificación Categoría.
Cambiar las selecciones de
columna
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Visibilidad de la columna.
c. Seleccione columnas o borre las selecciones de columnas
segun sea necesario.
Mostrar atributos como
columnas
y, luego, haga clic en Seleccionar atributos.
a. Haga clic en
b. En la ventana Seleccionar atributos, use pulsaciones de teclas
estandares de Windows para destacar atributos seguidos
(SHIFT+<click>) o no seguidos (CTRL+<click>).
c. Haga clic en
.
d. Haga clic en Aceptar.
Mostrar las rutas completas de
los elementos
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Mostrar rutas completas.
Ocultar las rutas completas de
los elementos
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Ocultar rutas completas.
7. Seleccione los resultados que desee utilizar y haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
En esta sección
• Cónfigurar condiciones de busqueda para valores de atributo cuando se especifica una
plantilla
• Cónfigurar condiciones de busqueda para valores de atributo cuando no se especifica una
plantilla
Configurar condiciones de búsqueda para valores de atributo cuando se
especifica una plantilla
Puede restringir la busqueda en función del valor de un atributo. Una vez especificada una
plantilla (esto es necesario en versiones anteriores a PI AF 2018), utilice el campo Valor de
atributo para cónfigurar hasta tres condiciones con las que debe coincidir la busqueda en
relación con un valor de atributo.
Guía del usuario PI System Explorer
77
Recuperación de información de activos
Antes de empezar
• Los atributos no indexados pueden demorar mucho tiempo en evaluarse, en especial si
estan cónfiguradós con una referencia de datos.
• No es posible buscar atributos con los tipos de valor Object o Array.
Procedimiento
1. Haga clic en
(Muestra la selección de atributos) y seleccione un atributo de la lista de
posibles categórías de atributo:
Opción
Description
Atributos indexados, incluidos los atributos de cónfiguración.
Atributos de cónfiguración que no estan indexados.
Atributos de no cónfiguración que no estan indexados.
2. Haga clic en
y seleccione un operador matematicó de la lista.
◦ Para tipos de valor de atributo Single y Double, las consultas no admiten el operador
In.
◦ Para tipos de valor de atributo String, Boolean y Int64, las consultas no admiten los
siguientes operadores:
▪ < (menor que)
▪ > (mayor que)
▪ <= (menor que o igual a)
▪ >= (mayor que o igual a)
3. Introduzca un valor en las unidades especificadas por la UOM predeterminada en la plantilla
de atributo.
Nota:
Para atributos indexados que almacenan tipos de valor String, la busqueda solo usa
los primeros 40 caracteres del valor ingresado.
Configurar condiciones de búsqueda para valores de atributo cuando no
se especifica una plantilla
Si usa un cliente de PI AF 2018 o una versión posterior conectado a un servidor de PI AF 2018
o una versión posterior, puede restringir la busqueda en función del valor de un atributo sin
tener que especificar una plantilla primero. Use el campo Valor de atributo para cónfigurar
hasta tres condiciones con las que debe coincidir la busqueda en relación con un valor de
atributo.
Antes de empezar
• Si no se selecciona una plantilla, se realiza la busqueda en todos los atributos, incluso
aquellos usados en plantillas.
• Si no se selecciona una plantilla, los caracteres cómódín no deben usarse en el campo Valor
de atributo.
78
Guía del usuario PI System Explorer
Recuperación de información de activos
• Los atributos no indexados pueden demorar mucho tiempo en evaluarse, en especial si
estan cónfiguradós con una referencia de datos.
• No es posible buscar atributos con los tipos de valor Object o Array.
Procedimiento
1. En la lista Añadir criterios, seleccione Valor de atributo.
2. En Valor de atributo, introduzca el nombre del atributo para recuperar.
3. Haga clic en
y seleccione un operador matematicó de la lista.
4. Introduzca un valor. Si el tipo de valor es Enumeration Set o Guid, tambien debe anexar
as Enumeration_Set o as Guid a la consulta de busqueda que aparece en el campo
Introducir criterios de elemento. Por ejemplo, para buscar activos con un valor de atributo
de cóndición de estado de error, debe introducir lo siguiente como criterios de Valor de
atributo:
Para completar la consulta de la busqueda, debe anexar el nombre del conjunto de
enumeración de la cóndición de estado a la cadena que ya figura en el campo Introducir
criterios de elemento:
as 'Health Status'
La consulta de busqueda completa en el campo Introducir criterios de elemento se ve de la
siguiente manera:
Nota:
Tenga en cuenta las siguientes pautas al anexar consultas de busquedas:
◦ Anexe As String o As Numeric siempre que el tipo de valor de un atributo no
coincida con lo que parece ser el valor de busqueda de la consulta.
◦ Por ejemplo, si el tipo de valor de un atributo es String y el valor de busqueda es
55 (que parece ser numericó), debe anexar As String a la consulta.
◦ Use combinaciones de mayusculas y minusculas al anexar datos a las consultas de
busqueda: As String, as string y as STRING son equivalentes.
◦ Use ' o " para colocar dentro conjuntos de enumeración y cadenas que contengan
caracteres de espacio.
Caracteres especiales en búsquedas de nombres
Al buscar objetos por nombre, como nombres de elementos, nombres de Event Frames o
nombres de atributos (si estan asociados a una plantilla), puede utilizar caracteres especiales:
Carácter especial
Finalidad
*
Sustituir cualquier numeró de caracteres sin especificar.
?
Sustituir un solo caracter sin especificar.
[xyz]
Especificar un conjunto de caracteres (x, y o z) para lograr una
coincidencia.
[!xyz]
Especificar un conjunto de caracteres (x, y o z) para excluir una
coincidencia.
\
Ignorar el caracter especial siguiente e interpretarlo como su
caracter real.
Guía del usuario PI System Explorer
79
Recuperación de información de activos
Carácter especial
Finalidad
[first-last]
Especificar un intervalo de caracteres (de first a last) para lograr una
coincidencia. Por ejemplo, a[a-c] coincide con aa, ab o ac, pero no
con ad ni abc.
Búsqueda de atributos en elementos
Puede buscar un atributo o un grupo de atributos. Tal vez desee localizar un determinado
atributo, por ejemplo, para cónfigurar una referencia de datos de fórmula o asignarlo como
valor a otro atributo. (Para buscar un valor de atributo determinado, seleccione un valor de
atributo como criterios de busqueda de elementos).
Procedimiento
1. En el panel del navegador, haga clic en Elementos.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de atributos.
◦ En el navegador, haga clic con el bótón secundario en la cólección Búsquedas de
elementos y seleccione Nueva búsqueda de atributos.
3. Cónfigure la ventana Búsqueda de atributos para localizar los atributos que desee en la PI AF
base de datos:
a. En Donde, defina los campos para limitar los atributos recuperados:
▪ Nombre de atributo
Ingrese el nombre del atributo para recuperar. Puede introducir caracteres especiales
para buscar coincidencias de una parte de un nombre. Consulte Caracteres especiales
en busquedas de nombres.
▪ Descripción del atributo
Ingrese una cadena (de un maximó de 440 caracteres) con la que deben coincidir los
atributos recuperados.
▪ Categoría de atributo
Seleccione la categóría con la que deben coincidir los atributos recuperados.
▪ Tipo de valor de atributo
Seleccione el tipo de valor que deben almacenar los atributos recuperados.
▪ Resultados máximos
Ingrese la cantidad maxima de atributos coincidentes para recuperar.
b. En el area Criterios de elemento, cónfigure los campos para restringir los elementos
buscados para los atributos coincidentes:
▪ Raíz de búsqueda
Ingrese el elemento que desea usar como nivel de base o raíz para la busqueda de
para abrir la ventana
atributo. Escriba el nombre exacto o haga clic en Explorar
Navegador de elementos, donde pódra consultar la jerarquía de elementos y
seleccionar un elemento. No puede incluir caracteres cómódín en el nombre que
introduzca. Si no especifica un elemento, establezca el nivel principal de la jerarquía
de elementos como la raíz. En función de la PI AFjerarquía, la especificación de un
80
Guía del usuario PI System Explorer
Recuperación de información de activos
elemento en el campo Raíz de búsqueda puede mejorar el rendimiento de las
busquedas.
Seleccione la casilla de verificación Buscar subelementos para buscar la raíz
introducida y los subelementos. Quite la selección de esta casilla de verificación para
buscar solo la raíz ingresada.
▪ Nombre
Ingrese el nombre de los elementos en los que desea buscar los atributos. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un nombre.
Consulte Caracteres especiales en busquedas de nombres.
▪ Descripción
Ingrese una cadena (de un maximó de 440 caracteres) para recuperar solo aquellos
elementos que coincidan.
▪ Categoría
Seleccione la categóría de los elementos en que desea buscar los atributos.
▪ Plantilla
Seleccione la plantilla de los elementos en que desea buscar los atributos.
▪ Tipo
Seleccione el tipo de los elementos en que desea buscar los atributos.
Si especifica valores para varios ajustes, la busqueda devólvera sóló aquellos atributos que
coincidan con todos los ajustes especificadós.
4. Haga clic en Buscar para recuperar todos los atributos coincidentes en la tabla Resultados
de búsqueda.
Tambien, puede utilizar el arból de elementos debajo de Resultados de búsqueda para
buscar los atributos bajo determinados elementos y, a cóntinuación, seleccionar los
atributos para anadirlós a la tabla Resultados de búsqueda.
Recuerde que los atributos disponibles mediante la busqueda y los atributos disponibles
mediante la explóración de la jerarquía de elementos dependen de las propiedades de
cónfiguración de los atributos.
5. Seleccione elementos en la lista de resultados de busqueda y haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
Buscar event frames
Utilice la ventana Búsqueda de Event Frames para recuperar datos de Event Frames que
coincidan con sus criterios de busqueda.
Procedimiento
1. En el panel del navegador, haga clic en Marcos de evento.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de marcos de evento.
◦ En el navegador, haga clic con el bótón secundario en la cólección Búsquedas de marcos
de evento y seleccione Nueva búsqueda.
Guía del usuario PI System Explorer
81
Recuperación de información de activos
3. Cónfigure la ventana Búsqueda de Event Frame para localizar los event frames deseados en
la base de datos PI AF.
Nota:
Si especifica valores para varios criterios, la busqueda devólvera solo aquellos Event
Frames que coincidan con todos los criterios especificadós.
4. De la lista Acciones , seleccione el tipo de filtró o aplique: Contiene, Coincidencia exacta,
Comienza con o Finaliza con.
5. Elija una de las siguientes acciones:
Para…
Escribir una o mas condiciones
de filtradó directamente en el
campo Introducir criterios de
Event Frame
Haga lo siguiente…
◦ Use el operador : o := para seleccionar elementos que
coincidan con un nombre, una descripción, una plantilla, un
nombre de elemento primario o una categóría.
◦ Use caracteres especiales si es necesario. Para obtener mas
infórmación, consulte Caracteres especiales en busquedas de
nombres.
◦ Coloque entre " las cadenas con espacios o caracteres
especiales.
◦ Separe las condiciones de filtradó con un espacio finó, por
ejemplo:
Category:"Processing Plants" Name:Cracking
Al comenzar con PI AF 2018 SP2, puede utilizar condiciones OR
cuando escribe directamente. Por ejemplo:
◦ “Name:’EventFrameName’ (|Attribute1:>5 OR |
Attribute2:<2)”
◦ “Description:’TestDescription’ OR
Name:’TestName’”
Filtrar Event Frames en
Criterios
Introduzca valores en los siguientes campos si es necesario. Haga
clic en Agregar criterios para introducir criterios de campos
adicionales.
◦ Buscar
Seleccione el metódó que desea usar para especificar cuandó se produjeron los marcos
de eventos deseados. La ventana muestra los campos correspondientes al metódó
seleccionado.
Por ejemplo, seleccione Activo entre para especificar una hora de inicio y finalización, y
busque los marcos de eventos activos en cualquier momento durante ese períódó.
Seleccione Comienza después de para especificar solo una hora de inicio y busque
marcos de eventos que comiencen despues de esa hora.
◦ En curso
Si estuviera disponible, seleccione esta casilla de verificación para restringir aun mas los
marcos de eventos coincidentes a aquellos que tódavía no finalizarón.
◦ Inicio de la búsqueda
Una expresión de tiempo de PI que especifica el inicio de un períódó usado para buscar
marcos de eventos.
◦ Fin de la búsqueda
Una expresión de tiempo de PI que especifica el fin de un períódó usado para buscar
marcos de eventos.
82
Guía del usuario PI System Explorer
Recuperación de información de activos
Opcional. En la lista situada al lado de este campo, seleccione una hora definida para
rellenar de forma autómatica los campos Search start (Inicio de busqueda) y Search end
(Fin de busqueda).
◦ Todos descendientes
Seleccione esta casilla de verificación para buscar todos los niveles de la jerarquía de
marcos de eventos que esta debajo de la raíz especificada para los marcos de eventos
coincidentes.
◦ Nombre
Ingrese el nombre del marco de evento que desea recuperar segun el tipo de filtró. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un nombre.
Consulte Caracteres especiales en busquedas de nombres.
◦ Nombre de elemento
Ingrese un elemento PI AF que sea el principal de cualquier marco de evento recuperado.
Puede introducir caracteres especiales para buscar coincidencias de una parte de un
nombre. Consulte Caracteres especiales en busquedas de nombres.
◦ Categoría
Seleccione la categóría con la que deben coincidir los marcos de eventos recuperados.
◦ Resultados por página
Ingrese la cantidad maxima de marcos de eventos que se pueden mostrar en una sola
pagina de resultados de busqueda.
◦ Plantilla
Seleccione la plantilla en la que deben basarse los marcos de eventos recuperados.
Despues de seleccionar una plantilla, puede anadir criterios para buscar elementos por
valor de atributo.
◦ Nombre de análisis
Ingrese el nombre del analisis desde donde se generaron los marcos de evento
recuperados. Puede utilizar caracteres comodines segun sean necesarios.
◦ Valor del atributo
Puede especificar hasta tres condiciones para un valor de atributo. Para cada cóndición,
especifique un nombre de atributo, un operador y un valor de atributo, por ejemplo
Temperature >= 98.
▪ En versiones anteriores a PI AF 2018, esta función solo esta disponible cuando
especifica una plantilla. Para obtener mas detalles, consulte Cónfigurar condiciones de
busqueda para valores de atributo cuando se especifica una plantilla.
▪ En PI AF 2018 y versiones posteriores, puede especificar valores de atributo sin la
necesidad de especificar una plantilla. Para obtener mas detalles, consulte Cónfigurar
condiciones de busqueda para valores de atributo cuando no se especifica una
plantilla.
◦ Duración
Seleccione un operador e ingrese un valor, que puede incluir una abreviatura de tiempo
de PI. Por ejemplo, seleccione >= e ingrese 1d para recuperar eventos que duran por lo
menos un día. Puede seleccionar Duration (Duración) una segunda vez y filtrar la
busqueda para mostrar resultados entre dos valores. Por ejemplo, seleccione <= y escriba
2d para recuperar eventos que duraran al menos entre uno y dos días.
Guía del usuario PI System Explorer
83
Recuperación de información de activos
◦ Raíz de búsqueda de marcos de eventos
Ingrese el marco de evento que desea usar como nivel de base o raíz para la busqueda del
marco de evento. Escriba el nombre exacto o haga clic en Explorar
para abrir la
ventana Explorador de marco de evento, donde pódra consultar la jerarquía de marcos de
evento y seleccionar uno. No puede incluir caracteres cómódín en el nombre que
introduzca. Si no especifica un marco de evento, establezca el nivel principal de la
jerarquía del marco de evento como la raíz. En función de la complejidad de su jerarquía
de PI AF, la especificación de un marco de evento en el campo Event Frame Search Root
(Raíz de busqueda de marco de evento) puede mejorar el rendimiento de las busquedas.
◦ Can Be Acknowledged (Posibilidad de confirmación)
(PI AF 2016 o versiones posteriores). Cónfigure este parametró en True para recuperar
los marcos de eventos que pueden cónfirmarse. La capacidad de cónfirmar los marcos de
eventos se determina en la plantilla en la que estos se basan.
◦ Is Acknowledged (Confirmado)
(PI AF 2016 o versiones posteriores). Cónfigure este parametró en True para recuperar
los marcos de eventos que se han cónfirmadó. Cónfigure este parametró en False para
recuperar unicamente los marcos de eventos que no se han cónfirmadó.
◦ Tiene anotaciones
(PI AF 2016 o versiones posteriores). Cónfigure este parametró en True para recuperar
unicamente los marcos de eventos que tienen anotaciones. Cónfigure este parametró en
False para recuperar unicamente los marcos de eventos que no tienen anotaciones.
◦ Gravedad
(PI AF 2016 o versiones posteriores). Seleccione un operador y una ópción de gravedad
de la lista. Por ejemplo, seleccione >= Minor (Leve) para recuperar los marcos de eventos
que tengan una cónfiguración de gravedad de al menos Minor (Leve). Puede seleccionar
Severity (Gravedad) una segunda vez y filtrar la busqueda para mostrar resultados entre
dos opciones de gravedad. Por ejemplo, seleccione <= Critical (Críticó) para recuperar
marcos de eventos que tengan una cónfiguración de gravedad de Minor (Leve), Major
(Grave) y Critical (Críticó).
◦ Fecha de creación
(PI AF 2017 o versiones posteriores). Seleccione un operador e introduzca una fecha o
una abreviación de PI Time ( >= *-30d es la ópción predeterminada) para recuperar los
marcos de evento que se crearon en el períódó especificadó. Tambien puede hacer clic en
para seleccionar una fecha en la ventana Selector de fecha y hora. Puede seleccionar
Fecha de creación una segunda vez y filtrar la busqueda para mostrar resultados entre
dos valores (< *+1d es la ópción predeterminada).
◦ Modificar fecha
(PI AF 2017 o versiones posteriores). Seleccione un operador e introduzca una fecha o
una abreviación de PI Time ( >= *-30d es la ópción predeterminada) para recuperar los
marcos de evento que se módificarón en el períódó especificadó. Tambien puede hacer
clic en para seleccionar una fecha en la ventana Selector de fecha y hora. Puede
seleccionar Modificar fecha una segunda vez y filtrar la busqueda para mostrar
resultados entre dos valores (< *+1d es la ópción predeterminada).
84
Guía del usuario PI System Explorer
Recuperación de información de activos
Nota:
La fecha de módificación de un marco de evento se actualiza cada vez que se agrega un
valor de captura, una anótación o un marco de evento secundario, así como cuando se
comprueba un cambio en su cónfiguración en la base de datos.
La mayóría de los cambios de plantilla o cualquier módificación de un valor de
atributo que no sea un elemento de cónfiguración no afectaran la fecha de
módificación de un marco de evento.
6. Opcional. Especifique cómó desea que se muestren los resultados en la tabla Resultados.
Para…
Haga lo siguiente…
Agrupar por plantilla
Seleccione la casilla de verificación Plantilla.
Agrupar por categóría
Seleccione la casilla de verificación Categoría.
Cambiar las selecciones de
columna
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Visibilidad de la columna.
c. Seleccione columnas o borre las selecciones de columnas
segun sea necesario.
Mostrar atributos como
columnas
y, luego, haga clic en Seleccionar atributos.
a. Haga clic en
b. En la ventana Seleccionar atributos, use pulsaciones de teclas
estandares de Windows para destacar atributos seguidos
(SHIFT+<click>) o no seguidos (CTRL+<click>).
c. Haga clic en
.
d. Haga clic en Aceptar.
Mostrar las rutas completas de
los marcos de evento
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Mostrar rutas completas.
Ocultar las rutas completas de
los marcos de evento
a. Haga clic con el bótón derecho sobre el encabezado de
columna de la tabla Resultados o en el espacio en blanco a
cóntinuación.
b. Haga clic en Hide Full Paths (Ocultar rutas completas).
7. Haga clic en Buscar para recuperar los marcos de evento coincidentes en la tabla Resultados.
8. Haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
Buscar atributos en event frames
Utilice la ventana Búsqueda de atributos de Event Frame para recuperar datos de atributos de
Event Frame que coincidan con sus criterios de busqueda.
Guía del usuario PI System Explorer
85
Recuperación de información de activos
Procedimiento
1. En el panel del navegador, haga clic en Marcos de evento.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de atributos de marcos
de evento.
◦ En el navegador, haga clic con el bótón secundario en la cólección Búsquedas de marcos
de evento y seleccione Nueva búsqueda de atributos.
3. Cónfigure la ventana Búsqueda de atributos de Event Frame para localizar los atributos que
desee en la base de datos de PI AF:
a. En Donde, defina los campos para limitar los atributos recuperados:
▪ Nombre de atributo
Ingrese el nombre del atributo para recuperar. Puede introducir caracteres especiales
para buscar coincidencias de una parte de un nombre. Consulte Caracteres especiales
en busquedas de nombres.
▪ Descripción del atributo
Ingrese una cadena (de un maximó de 440 caracteres) con la que deben coincidir los
atributos recuperados.
▪ Categoría de atributo
Seleccione la categóría con la que deben coincidir los atributos recuperados.
▪ Tipo de valor de atributo
Seleccione el tipo de valor que deben almacenar los atributos recuperados.
▪ Resultados máximos
Ingrese la cantidad maxima de atributos coincidentes para recuperar.
b. En el area Criterios de Event Frame, cónfigure los campos para limitar la busqueda a los
atributos que coincidan:
▪ Buscar
Seleccione los criterios para encontrar transferencias que esten dentro del períódó de
tiempo especificadó por Inicio de búsqueda y Final de búsqueda.
▪ Inicio de búsqueda/Final de búsqueda
Seleccione o introduzca las horas de inicio y finalización del períódó de busqueda.
▪ Raíz de búsqueda
Introduzca el Event Frame para utilizar como raíz o nivel basicó de la busqueda de
para abrir la ventana
atributos. Escriba el nombre exacto o haga clic en Explorar
Explorador de Event Frames, donde pódra ver la jerarquía de Event Frames y
seleccionar uno. No puede incluir caracteres cómódín en el nombre que introduzca. Si
no especifica un event frame, la raíz se establecera en el nivel principal de la jerarquía.
En función de la complejidad de su jerarquía de PI AF, la especificación de una raíz de
busqueda puede mejorar el rendimiento de la busqueda.
Seleccione la casilla de verificación Buscar Sub-Event Frames para buscar la raíz
introducida y sus elementos secundarios. Desmarque esta casilla para buscar solo la
raíz introducida.
86
Guía del usuario PI System Explorer
Recuperación de información de activos
▪ Nombre
Introduzca el nombre de los Event Frames cuyos atributos desee buscar. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un nombre.
Consulte Caracteres especiales en busquedas de nombres.
▪ Descripción
Introduzca una cadena de descripción de hasta 440 caracteres para recuperar solo
elementos que coincidan.
▪ Duración
Introduzca valores de duración maximós y mínimós para limitar la busqueda de
atributos a Event Frames cuya duración se encuentre dentro de esos límites.
▪ Categoría
Seleccione la categóría de los Event Frames cuyos atributos desee buscar.
▪ Plantilla
Seleccione la plantilla de los Event Frames cuyos atributos desee buscar.
Si especifica valores para varios ajustes, la busqueda devólvera sóló aquellos atributos que
coincidan con todos los ajustes especificadós.
4. Haga clic en Buscar para recuperar todos los atributos que coincidan en la tabla Resultados
de búsqueda. Puede limitar los resultados aun mas para mostrar solo los atributos que
coincidan con el texto introducido en el campo Resultados de búsqueda.
5. Seleccione elementos en la lista de resultados de busqueda y haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
Búsqueda de transferencias
Utilice la ventana Criterios de búsqueda de transferencias para recuperar datos de transferencias
que coincidan con sus criterios de busqueda.
Procedimiento
1. En el panel del navegador, haga clic en Marcos de evento.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de transferencias.
◦ En el navegador, haga clic con el bótón secundario en la cólección Búsquedas de
transferencias y seleccione Nueva búsqueda.
3. Cónfigure la ventana Criterios de búsqueda de transferencias para localizar las transferencias
que desee en la base de datos de PI AF:
◦ Buscar
Seleccione los criterios para encontrar transferencias que esten dentro del períódó de
tiempo especificadó por Inicio de búsqueda y Final de búsqueda.
◦ Inicio de búsqueda/Final de búsqueda
Seleccione o introduzca las horas de inicio y finalización del períódó de busqueda.
Guía del usuario PI System Explorer
87
Recuperación de información de activos
◦ Nombre
Introduzca el nombre de las transferencias que desee buscar. Puede introducir caracteres
especiales para buscar coincidencias de una parte de un nombre. Consulte Caracteres
especiales en busquedas de nombres.
◦ Descripción
Introduzca una cadena de descripción de hasta 440 caracteres para recuperar solo
transferencias que coincidan.
◦ Origen
Haga clic en
para abrir la ventana Navegador de elementos, donde pódra consultar la
jerarquía de elementos y seleccionar el elemento de origen para las transferencias que
desee incluir en la busqueda. Haga clic en el bótón Cualquiera para reestablecer el <Any>
predeterminado.
◦ Destino
Haga clic en
para abrir la ventana Navegador de elementos, donde pódra consultar la
jerarquía de elementos y seleccionar el elemento de destino para las transferencias que
desee incluir en la busqueda. Haga clic en el bótón Cualquiera para reestablecer el <Any>
predeterminado.
◦ Plantilla
Seleccione la plantilla de las transferencias que desee buscar.
◦ Resultados máximos
Ingrese un numeró para limitar la cantidad de transferencias a recuperar.
Si especifica valores para varios ajustes, la busqueda devólvera solo aquellas transferencias
que coincidan con todos los ajustes especificadós.
4. Haga clic en Buscar para recuperar las transferencias que coincidan en la tabla de
Resultados de búsqueda.
Puede limitar los resultados aun mas para mostrar solo las transferencias que coincidan con
el texto introducido en el campo Resultados de búsqueda.
5. Haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
Búsqueda de atributos en transferencias
Utilice la ventana Búsqueda de atributo de transferencias para recuperar datos de event frames
que coincidan con sus criterios de busqueda.
Procedimiento
1. En el panel del navegador, haga clic en Elementos.
2. Elija una de las siguientes acciones:
◦ En el menu de PI System Explorer, seleccione Buscar > Búsqueda de elementos.
◦ En el navegador, haga clic con el bótón secundario en el nodo raíz Búsquedas de
elementos y seleccione Nueva búsqueda.
88
Guía del usuario PI System Explorer
Recuperación de información de activos
3. Cónfigure la ventana Búsqueda de atributo de transferencia para localizar los atributos que
desee en la base de datos de PI AF:
a. En Donde, defina los campos para limitar los atributos recuperados:
▪ Nombre de atributo
Ingrese el nombre del atributo para recuperar. Puede introducir caracteres especiales
para buscar coincidencias de una parte de un nombre. Consulte Caracteres especiales
en busquedas de nombres.
▪ Descripción del atributo
Ingrese una cadena (de un maximó de 440 caracteres) con la que deben coincidir los
atributos recuperados.
▪ Categoría de atributo
Seleccione la categóría con la que deben coincidir los atributos recuperados.
▪ Tipo de valor de atributo
Seleccione el tipo de valor que deben almacenar los atributos recuperados.
▪ Resultados máximos
Ingrese la cantidad maxima de atributos coincidentes para recuperar.
b. En el area Criterio de transferencia, cónfigure los campos para limitar la busqueda de
atributos a las transferencias que cumplan los criterios especificadós:
▪ Buscar
Seleccione los criterios para encontrar transferencias que esten dentro del períódó de
tiempo especificadó por Inicio de búsqueda y Final de búsqueda.
▪ Inicio de búsqueda/Final de búsqueda
Seleccione o introduzca las horas de inicio y finalización del períódó de busqueda.
▪ Nombre
Introduzca el nombre de las transferencias cuyos atributos desee buscar. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un nombre.
Consulte Caracteres especiales en busquedas de nombres.
▪ Descripción
Introduzca una cadena de descripción de hasta 440 caracteres para recuperar solo
atributos que coincidan.
▪ Origen
Introduzca o examine y seleccione el elemento de origen de las transferencias cuyos
atributos desee incluir en la busqueda.
▪ Destino
Introduzca o examine y seleccione el elemento de destino de las transferencias cuyos
atributos desee incluir en la busqueda.
▪ Plantilla
Seleccione la plantilla de las transferencias cuyos atributos desee buscar.
Guía del usuario PI System Explorer
89
Recuperación de información de activos
▪ Category
Seleccione la categóría de las transferencias cuyos atributos desee buscar.
Si especifica valores para varios ajustes, la busqueda devólvera sóló aquellos atributos que
coincidan con todos los ajustes especificadós.
4. Haga clic en Buscar para recuperar todos los atributos que coincidan en la tabla Resultados
de búsqueda.
Puede limitar los resultados aun mas para mostrar solo los atributos que coincidan con el
texto introducido en el campo Resultados de búsqueda.
5. Haga clic en Aceptar.
Los resultados se muestran en el visor y en el arból del navegador. Para obtener mas
infórmación sobre cómó trabajar con los resultados de busqueda, consulte Administrar
resultados de busqueda.
Tendencias en PI System Explorer
Mientras explora elementos en PI System Explorer, puede crear de forma facil tendencias
sencillas para poder verificar las fórmulas, los calculós y otras mediciones que cree en PI AF.
Por ejemplo, mientras disena una fórmula de PI AF, es posible que desee comprobar cuales
seran los resultados de las ultimas horas. O, si va a crear atributos de PI point que incluyan
resumenes, pódría ser util ver cómó seran para las horas recientes.
Puede anadir los atributos de PI AF o los PI points que le interesen a una tendencia. Una forma
de hacerlo es arrastrandólós y sóltandólós en ella. Luego puede ver los datos ajustando la
duración y la hora de inicio y finalización de la tendencia.
Despues de haber creado la tendencia, sigue estando disponible en la ventana Tendencia aun
cuando usted esta usando otras características dentro de PI System Explorer. Pódra anadir o
eliminar trazos de la tendencia siempre que lo desee. Tambien puede hacer clic con el bótón
secundario en el cursor de tendencia y seleccionar comandos de un menu contextual.
Ademas, puede ver una tendencia de un atributo al ver sus datos de serie temporal (haciendo
clic con el bótón secundario sobre un atributo y haciendo clic en Datos de serie temporal). La
tendencia se muestra autómaticamente en la parte inferior de la ventana Datos de series de
tiempo.
Crear tendencias
Para verificar fórmulas, calculós y otras mediciones en PI AF, cree una tendencia.
Antes de empezar
OSIsoft recomienda utilizar herramientas de visualización, como PI Vision, PI ProcessBook y PI
WebParts, para crear y guardar tendencias que pueda utilizar mas de una vez.
Procedimiento
1. En el menu de PI System Explorer, seleccione Ver > Mostrar tendencia.
2. En la ventana Tendencia, elija una de las siguientes acciones.
90
Guía del usuario PI System Explorer
Recuperación de información de activos
Para…
Haga lo siguiente…
Anadir un atributo a la tendencia
a. Haga clic en Añadir atributos.
b. En la ventana Búsqueda de atributos,
especifique los parametrós en Nombre de
atributo, Categoría de atributo y otros
campos para poder encontrar el atributo de
su interes.
c. Expanda la jerarquía de elementos en el area
Resultados de búsqueda y seleccione el
atributo.
d. Haga clic en Aceptar.
La ventana Tendencia muestra una tendencia
que indica cómó ha variado el atributo a lo
largo de la ultima hora (1 hora es la duración
predeterminada).
Ajustar la duración
Anadir un PI Point a la tendencia
Especifique las horas en los campos Hora de
inicio y Hora de finalización.
a. Haga clic en Añadir PI Points.
b. En la ventana Búsqueda de tags , busque el PI
Point que desea consultar y seleccióneló en
los resultados.
c. Haga clic en Aceptar.
El PI Point se anadira a la tendencia.
Ajuste que trazos seran visibles en la tendencia
Haga clic en Trazos y borre la casilla de
verificación de atributos o puntos que no desea
ver.
3. Anada cualquier otro atributo de PI AF o PI Point cuyos datos desee consultar.
Los trazos en la ventana Tendencia se mantendran hasta que la cierre.
Puede arrastrar atributos y PI Points de otros resultados de busqueda y soltarlos en la
tendencia para anadirlós. Tambien puede hacer clic con el bótón secundario sobre un
atributo o punto y hacer clic en Añadir a la tendencia.
Gestión de versiones para equipos y procesos
Cuando necesite cambiar un equipo, por ejemplo, sustituir una bomba averiada por otra de
similares características, puede seguir utilizando el elemento existente para representar la
bomba nueva. Sin embargo, para indicar que se ha producido un cambio, es buena idea crear
una nueva versión del elemento. Así, dispóndra de un registro del cambio en el equipo que
representa ese elemento.
Similarmente, es posible que deba crear versiones de una tabla. Por ejemplo, las tablas de
calibración de los tanques se actualizan de forma periódica para ajustarse a las cambiantes
características físicas del tanque. Si versiona la tabla, pódra utilizarla con la misma
cónfiguración que tenía en el momento de la recópilación de datos.
PI System Explorer permite crear varias versiones de elementos, modelos y tablas.
Tambien puede indicar un elemento, modelo o tabla que no este en servicio pasada una fecha
concreta seleccionando esa fecha como su fecha obsoleta.
Videos
Para obtener una descripción general de la administración de versiones, mire este video:
https://www.youtube.com/watch?v=8cHFHW1SID0&rel=0
Guía del usuario PI System Explorer
91
Recuperación de información de activos
Para obtener infórmación sobre cómó crear versiones de elementos y tablas, mire este video:
https://www.youtube.com/watch?v=j2ilXV2XmV0&rel=0
En esta sección
• Crear versiones para elementos o modelos
• Crear versiones de tabla
• Comparar dos versiones
Crear versiones para elementos o modelos
Cree una nueva versión cuando necesite llevar un registro de los cambios de un activo.
Antes de empezar
Cada vez que se cree una versión nueva, se próducira un ingreso en el elemento o modelo.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, elija una de las siguientes acciones.
◦ Haga clic con el bótón secundario en el elemento o modelo que desea una versión y haga
clic en Crear versión.
◦ Haga clic en el elemento o modelo del que desea la versión. En el visor, seleccione la
pestana Versión y haga clic en Nueva versión.
3. En la ventana Crear versión, ingrese una Fecha efectiva para la versión o haga clic en
para seleccionar una fecha. PI System Explorer crea una versión nueva.
4. Opcional. En el campo Comentario, ingrese infórmación sobre la versión nueva.
5. Haga clic en Aceptar.
Para indicar que existe mas de una versión, el icono en el navegador cambia a
elemento o a
para un modelo.
para un
Crear versiones de tabla
Cree una nueva versión cuando necesite llevar un registro de los cambios de una tabla.
Antes de empezar
Cada vez que se cree una versión nueva, se próducira un ingreso en la tabla.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, elija una de las siguientes acciones.
◦ Haga clic con el bótón secundario en la tabla en que desea una versión y haga clic en
Crear versión.
◦ Haga clic en la tabla en que desea la versión. En el visor, seleccione la pestana Versión y
haga clic en Nueva versión.
3. En la ventana Crear versión, ingrese una Fecha efectiva para la versión o haga clic en
para seleccionar una fecha. PI System Explorer crea una versión nueva.
92
Guía del usuario PI System Explorer
Recuperación de información de activos
4. Opcional. En el campo Comentario, ingrese infórmación sobre la versión nueva.
5. Haga clic en Aceptar.
.
Para indicar que existe mas de una versión de la tabla, el icono en el navegador cambia a
Comparar dos versiones
Puede comparar dos versiones de un elemento, modelo o tabla que tenga mas de una versión.
Procedimiento
1. Elija una de las siguientes acciones.
Para...
Haga esto...
Comparar versiones de tabla
a. En el navegador, haga clic en Biblioteca.
b. En el navegador Biblioteca, seleccione una
tabla que muestre el icono .
Comparar versiones de elemento o modelo
a. En el navegador, haga clic en Elementos.
b. En el navegador Elementos, seleccione un
o un
elemento que muestre el icono
modelo que muestre el icono .
2. En el visor, seleccione la pestana Versión y haga clic en Mostrar historial.
3. En la ventana Mostrar historial, seleccione dos versiones en el panel izquierdo de la lista de
todas las versiones existentes.
El panel derecho utiliza barras de cambio de color para indicar las diferencias entre las
versiones:
◦ Rojo significa que el elemento estaba presente en la versión anterior y no esta en la
versión mas reciente.
◦ Verde significa que el elemento esta en la versión mas reciente, pero no estuvo en la
versión anterior.
◦ Amarillo significa que el elemento cambió entre la versión anterior y la versión mas
reciente.
4. Para salir, haga clic en Cerrar.
Visualización de diferentes versiones de objeto y objetos
obsoletos
De forma predeterminada, PI System Explorer muestra las versiones mas recientes de los
elementos, los modelos y las tablas (aunque esas versiones sean futuras). Asimismo, excluye las
versiones anteriores de todos los objetos que tienen especificada una fecha Obsoleta (aunque
sea una fecha futura). Como resultado, al especificar una fecha Obsoleta para un objeto e
integrarlo, desaparece inmediatamente de PI System Explorer.
Sin embargo, puede buscar y ver un objeto obsoleto o una versión concreta de un objeto
cónfigurandó Fecha de consulta en un tiempo fijó en que el objeto o la versión sean actuales.
Para mostrar un elemento que, por ejemplo, entró en vigor el 1 de enero de 2010 y quedó
obsoleto el 1 de enero de 2011, introduzca en el campo Fecha de consulta cualquier fecha entre
las dos.
Guía del usuario PI System Explorer
93
Recuperación de información de activos
Video
Para obtener infórmación sobre cómó mostrar las diferentes versiones, mire este video:
https://www.youtube.com/watch?v=MwFrhzjPrns&rel=0
En esta sección
• Fecha de consulta y tiempo en PI System Explorer
• Mostrar fechas y horas específicas
• Contexto temporal para los valores de atributo
Fecha de consulta y tiempo en PI System Explorer
La Fecha de consulta determina los valores de tiempo que usar PI System Explorer para:
• Encontrar y mostrar valores de atributo.
• Identificar versiones actuales de objetos para mostrar e incluir en los resultados de
busqueda.
En el valor predeterminado de la Fecha de consulta, Configurar la más reciente, PI System
Explorer encuentra y muestra los datos mas actuales para los valores de atributo. Puede anular
el ajuste Fecha de consulta para ver los valores de un momento distinto mediante Establecer
contexto temporal. Consulte Establecer el contexto temporal de los valores de atributo
mostrados.
La ópción Configurar la más reciente tambien provoca que PI System Explorer utilice las
versiones mas recientes de objetos, aunque estas versiones sean futuras, y excluye cualquier
objeto con una fecha Obsoleta, aunque sea una fecha futura.
Puede cambiar la Fecha de consulta para especificar una fecha y hora fijas:
• El selector de fecha y hora le permite elegir un valor de fecha y hora específicó.
• Las selecciones Configurar para ahora y Configurar para hoy utilizan la hora actual para
establecer una fecha y hora fijas. Por ejemplo, si elige Configurar para ahora el lunes, la
Fecha de consulta del miercóles seguira cónfigurada para lunes.
De qué manera la fecha de consulta afecta a PI System Explorer
Qué aspecto se ve afectado
La Fecha de consulta es Configurar
la más reciente
Todos los objetos de PI System
Explorer
PI System Explorer utiliza las
PI System Explorer utiliza las
versiones mas recientes, aunque
versiones de objetos que estan
esas versiones sean futuras y
vigentes en ese momento.
excluye cualquier objeto con una
fecha obsoleta, aunque esa fecha sea
futura.
Elemento, modelo y versiones de
tabla en la busqueda
PI System Explorer devuelve las
versiones mas recientes, aunque
sean futuras.
PI System Explorer devuelve las
versiones que estan vigentes en ese
momento.
Tiempos relativos en las busquedas
PI System Explorer define el tiempo
actual (*) como el momento de la
busqueda.
PI System Explorer define el tiempo
actual (*) como el tiempo
especificadó en Fecha de consulta.
Datos PI
Se devuelve el valor de snapshot
mas reciente de los datos PI.
Los datos PI devueltos representan
el valor de la marca de tiempo
especificada en Fecha de consulta.
94
Guía del usuario PI System Explorer
La Fecha de consulta es una fecha y
hora fijas
Recuperación de información de activos
Mostrar fechas y horas específicas
Cuando defina la fecha de consulta en un día y hora concretos, ese día y hora se mantendran
constantes hasta que la módifique.
Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el bótón Fecha de consulta.
2. En la ventana Selector de fecha y hora, elija la fecha y hora que desee. Si desea definir la
fecha de consulta como el día y la hora actuales, pulse el bótón Ajustar a ahora.
Nota:
Al seleccionar Ajustar a ahora como fecha de consulta, la fecha de consulta se define
como un día y hora concretos; esto es, como un valor constante. No es lo mismo que
definir la fecha de consulta como siempre en la hora actual. En ese caso, seleccione la
ópción Ajustar a más reciente.
3. Haga clic en Aceptar.
Video
Para obtener infórmación sobre cómó establecer una fecha de consulta específica, mire este
video:
https://www.youtube.com/watch?v=_381ZTzkFo4&rel=0
Contexto temporal para los valores de atributo
La hora o el intervalo de tiempo que PI System Explorer utiliza para mostrar valores de atributo
estan determinados por el valor que cónfigura en la ventana Establecer contexto temporal.
PI System Explorer muestra los valores mas recientes de los atributos en función de la hora
actual. El valor de Fecha de consulta refleja la cónfiguración temporal de PI System Explorer
(consulte Fecha de consulta y tiempo en PI System Explorer). Sin embargo, puede ver valores
de atributo para una hora distinta si especifica la nueva hora en la ventana Establecer contexto
temporal.
La cónfiguración de la hora y del intervalo de tiempo en la ventana Establecer contexto
temporal solo se aplica a los valores de atributo mostrados. El valor de Fecha de consulta
seguira aplicandóse a todos los demas objetos de PI System Explorer.
Establecer el contexto temporal de los valores de atributo mostrados
Utilice Establecer contexto temporal para especificar un tiempo o intervalo de tiempo diferente
para los valores de atributos mostrados.
Procedimiento
1. En la barra de herramientas de PI System Explorer, haga clic en
.
De manera alternativa, haga clic en Herramientas > Opciones y seleccione la pestana
Contexto temporal.
2. En la ventana Configurar contexto temporal, seleccione una de las siguientes opciones.
Directamente, ingrese los valores de tiempo para una ópción o haga clic en para
seleccionar una fecha y hora. Ademas, puede hacer clic en
para construir una expresión
temporal, como *-1d.
Guía del usuario PI System Explorer
95
Recuperación de información de activos
Opción
Description
Fecha y hora de la consulta
Muestra el valor actual para Fecha de consulta
(predeterminado en Latest Available). Puede
especificar un ajuste de cónfiguración de fecha y
hora para Fecha de consulta a fin de permitirle a
PI System Explorer que versiones de objetos
recuperar de la base de datos de PI AF.
Hora alternativa
Permite ver el contexto temporal para la
recuperación de datos despues de aplicar el
ajuste de Fecha de consulta actual. La hora actual
es el valor predeterminado (*), pero puede
introducir un contexto temporal nuevo para usar
en los valores de atributos mostrados.
Intervalo de tiempo
Introduzca las horas de inicio y de finalización
para especificar un nuevo intervalo de tiempo
para usar en los valores de atributo mostrados
que requieren un intervalo de tiempo.
3. Opcional. Haga clic en Configurar como predeterminado para registrar los valores actuales
como el contexto temporal predeterminado, o haga clic en Restablecer predeterminado para
restablecer el contexto temporal de la Fecha y hora de la consulta en Latest Available.
4. Haga clic en Aplicar para ver los cambios y en Aceptar para guardarlos. Los ajustes de
contexto temporal revisados figuran en la barra de títuló de PI System Explorer.
Ver datos de series temporales
PI System Explorer puede mostrar datos de series temporales para atributos que contengan o
hagan referencia a estos datos. De esta manera, pódra obtener una vista previa de cómó
funciónaran las cónfiguraciónes de referencias de datos con los datos recopilados en otras
herramientas cliente de PI, como PI ProcessBook, PI Vision, PI DataLink y PI WebParts.
Nota:
Algunas cónfiguraciónes de atributos no admiten este tipo de datos. Consulte
Restricciones de visualización de los datos de serie temporal.
Procedimiento
1. Haga clic con el bótón secundario en el atributo del visor y luego haga clic en Datos de serie
temporal.
2. En la ventana Datos de serie temporal seleccione la pestana que represente el tipo de datos
que desea consultar:
◦ Archivado
Para PI points. Muestra los valores archivados en la hora especificada. Los ajustes
incluyen Tipo de límite y Expresión de filtró.
◦ Muestreado
Devuelve valores interpolados y repartidos de manera uniforme a lo largo de un intervalo
regular. Puede incluir una Expresión de filtró.
◦ Plot
Recupera valores a lo largo del intervalo de tiempo especificadó que sirven para trazar el
numeró de intervalos especificadós. Por lo general, los intervalos representan píxeles y
esta función puede utilizarse para representar el ancho de la pantalla disponible para el
plot.
◦ Resumen
96
Guía del usuario PI System Explorer
Recuperación de información de activos
Muestra Estadísticas de resumen de valores de atributo que admiten esta función. Puede
especificar Pónderación.
◦ Canal de datos
Le permite supervisar y mirar los cambios en los datos de atributos. En los atributos que
admiten datos futuros, puede especificar cómó el canal de datos devuelve datos con Modo
de horizonte de eventos y propiedades de desplazamiento. Para los tags históricós, el
modo de Horizonte de eventos no tiene efecto alguno.
En esta sección
• Tipo de límite
• Expresión de filtró
• Estadísticas
• Pónderación
• Modo de horizonte de eventos
• Restricciones de visualización de los datos de serie temporal
Tipo de límite
Especifique un tipo de límite para determinar el modo en que es gestionada la busqueda de
valores de datos cerca de las horas de inicio y de finalización del intervalo de valores:
• Dentro (predeterminado)
Devuelve los valores a las horas de inicio y de finalización, si existen, o los valores mas
cercanos producidos dentro del intervalo.
• Fuera
Devuelve los valores mas cercanos que tienen lugar inmediatamente fuera del intervalo.
• Interpolado
Devuelve los valores interpolados a las horas de inicio y de finalización.
Expresión de filtro
Agregue una expresión de filtró para filtrar valores de evento mediante una expresión
matematica y eliminar los datos para los que la expresión de como resultado falso. Por ejemplo,
la simple expresión de filtró:
‘.’ < 70
eliminaría del calculó todos los valores por encima de 70. Tambien puede utilizar cualquier
ecuación de rendimiento PI en la expresión de filtró para crear expresiones mas complejas para
eliminar picos atípicós en valores de datos, por ejemplo.
Las variables de expresión estan limitadas a los atributos o PI Points originados desde un unicó
PI Data Archive. Los atributos que se resólverían en un valor estaticó (sin ninguna referencia de
datos cónfigurada) son tambien validós. Consulte Referencias de PI Point indirectas para
obtener una descripción completa de una posible sintaxis de referencia.
Ejemplos de variables de atributo
Expresión de filtro
Qué hace
‘.’
Hace referencia al atributo que se esta consultando.
‘Level’
Hace referencia al atributo Level en el mismo nivel de
jerarquía de atributos del elemento o event frame.
Guía del usuario PI System Explorer
97
Recuperación de información de activos
Expresión de filtro
Qué hace
‘..’
Hace referencia al atributo principal del atributo que se
esta consultando. Solo es validó para los atributos
secundarios anidados.
‘.|HighLimit’
Hace referencia al atributo secundario HighLimit del
atributo que se esta consultando.
‘|Temperature’
Hace referencia al atributo Temperature en el nivel de
jerarquía superior del elemento o event frame actuales.
‘\\MyPIServer\sinusoid’
Ruta absoluta a un PI Point. Debe estar en el mismo PI
Data Archive que el atributo actual consultado.
‘\\myAFServer\myDatabase\myElement|
myAttribute’
Ruta absoluta a un atributo de PI AF.
‘\myRootElement|myAttribute’
Ruta relativa de base de datos a un atributo de PI AF.
Ejemplos de variable de PI Point
Expresión de filtro
Qué hace
‘.’
Hace referencia al PI Point que se esta consultando.
‘sinusoid’
Hace referencia al PI Point sinusoid en el mismo PI
Data Archive.
Estadísticas
La pestana Resumen proporciona las siguientes estadísticas para los atributos que admiten
esas estadísticas:
• Porcentaje correcto
Muestra el porcentaje de tiempo en el que se devuelven valores correctos durante el
intervalo de tiempo total. Los valores correctos son valores de evento determinados como
validós y no en un estado de error.
• Promedio
Calcula la media de los valores durante el intervalo.
• Mínimo
Devuelve el valor mínimó durante el intervalo.
• Máximo
Devuelve el valor maximó durante el intervalo.
• Intervalo
Calcula el valor maximó menos el valor mínimó durante el intervalo.
• Desviación estándar
Calcula la desviación estandar de los valores durante el intervalo.
• Desviación estándar de población
Calcula la desviación estandar de póblación de los valores durante el intervalo.
• Recuento
Devuelve el numeró de valores almacenados durante el intervalo.
98
Guía del usuario PI System Explorer
Recuperación de información de activos
Ponderación
La pestana Resumen le permite seleccionar la pónderación para los calculós estadísticós:
• Ponderado en el tiempo
Predeterminado. Pondera el valor de cada evento por el periodo en el que se aplica.
• Ponderado en el tiempo continuo
Pondera los valores en el tiempo, pero realiza todas las interpolaciones entre valores como
si representaran datos continuos (interpólación estandar), independientemente de si el
atributo es escalonado.
• Ponderado en el tiempo discreto
Pondera los valores en el tiempo, pero realiza todas las interpolaciones entre valores como
si representaran valores discretos, no relacionados (plot escalonado), independientemente
de si el atributo es escalonado.
• Ponderado en eventos
Pondera cada evento por igual. Este metódó requiere como mínimó un evento en un
intervalo de tiempo (dos eventos para los calculós de desviación estandar). De forma
predeterminada, los eventos que se encuentran en el límite del calculó se gestionan del
siguiente modo:
◦ utilizan los eventos de ambos límites cuando existe solo un intervalo de calculó.
◦ incluyen eventos en la hora de inicio en varios intervalos y los intervalos se encuentran
en orden de tiempo ascendente.
◦ incluyen eventos en la hora de finalización en varios intervalos y los intervalos se
encuentran en orden de tiempo descendente.
• Ponderado en eventos: excluir evento más antiguo
Ponderado en eventos, excepto que el evento de la hora de inicio (hora mas temprana) de un
intervalo no se utiliza en ese intervalo.
• Ponderado en eventos: excluir evento más reciente:
Ponderado en eventos, excepto que el evento de la hora de finalización (hora mas reciente)
de un intervalo no se utiliza en ese intervalo.
• Ponderado en eventos: incluir ambos extremos:
Los eventos de los dos extremos de los límites del intervalo se incluyen en el calculó
ponderado a evento.
Modo de horizonte de eventos
El modo de horizonte de eventos controla cuando se devuelven eventos para atributos que
admiten datos del futuro en el canalizador de datos de PI AF. En la siguiente tabla se describen
los posibles valores.
Valor
Description
Fin de la secuencia
Los eventos se devuelven a medida que se crean,
sin importar la hora actual.
Guía del usuario PI System Explorer
99
Recuperación de información de activos
Valor
Description
Compensación horaria
Los eventos solo se devuelven despues de que
cruzan la cómpensación horaria relativa al futuro
desde el presente.
Por ejemplo, con una cómpensación horaria de
cero, no se devuelven cambios de datos de tag
futuros hasta que su marca de tiempo sea menor o
igual a la hora actual.
Compensación horaria con evento externo
Los eventos solo son devueltos si ocurren antes de
la cómpensación horaria relativa al futuro, o si son
el próximó evento que cruzaría este horizonte de
tiempo.
Por ejemplo, con una cómpensación horaria de una
hora, no se devuelven cambios de datos de tag
futuros hasta que su marca de tiempo sea menor o
igual a la hora actual mas una hora, o si son el
próximó evento conocido despues del horizonte de
tiempo de una hora. Este modo es util para marcar
datos como tendencias en el futuro.
Restricciones de visualización de los datos de serie temporal
Tipos de configuración de referencias de datos de PI points
Si bien muchas cónfiguraciónes son posibles con las referencias de datos de PI point, la
compatibilidad difiere para cada función de datos. Las referencias de datos de PI points pueden
agruparse en los siguientes tipos para las cónfiguraciónes de metódó de tiempo:
• PI Point de configuración sencilla
Se admiten todas las funciones de datos y no se requiere otra cónfiguración. El metódó de
tiempo es autómaticó, interpolado o AtOrBefore.
• Recuperación de archivos de un PI point especificado
Solo se admiten las funciones del grupo de valores interpolados (que se enumeran en la
siguiente tabla). El metódó de tiempo es antes, exacto, AtOrAfter o despues.
• PI point de tiempo relativo
PI Point de cónfiguración sencilla con tiempo relativo cónfiguradó. El metódó de tiempo es
autómaticó, interpolado o AtOrBefore.
• Solo rango de tiempo
No se admite el metódó de tiempo.
• Intervalo de tiempo con tiempo relativo
El metódó de tiempo es TimeRange o TimeRangeOverride.
La siguiente tabla detalla que funciones de datos admiten las cónfiguraciónes de referencia de
datos de PI point que se enumeran anteriormente. Estas restricciones tambien rigen para otras
herramientas de cliente, como PI DataLink, PI Vision (anteriormente conocida como PI
Coresight), PI ProcessBook y PI WebParts.
100
Guía del usuario PI System Explorer
Recuperación de información de activos
Función de datos
Simplement Recuperació Tiempo
e
n de
relativo
configurado archivos
Solo rango
de tiempo
Intervalo de
tiempo con
tiempo
relativo
InterpolatedValue
InterpolatedValues
InterpolatedValuesAtTimes
RecordedValue
RecordedValues
RecordedValuesAtTimes
RecordedValuesByCount
Async
PlotValues
Summary
Summaries
FilteredSummaries
UpdateValue
UpdateValues
Annotations
Filters
AFDataPipe
Tipos de configuración de referencias de datos no de PI points
Las referencias de datos no de PI points pueden agruparse en los siguientes tipos para las
cónfiguraciónes de metódó de tiempo:
• Sin referencia de datos
La referencia de datos se establece en Ninguna.
• Referencia de datos basada en cálculos con entradas de serie temporal
Las referencias de datos basadas en calculós con entradas de serie temporal, como analisis,
fórmula, generador de cadena, busqueda de tabla y generador de URI admiten las funciones
de datos base. Sin embargo, no se admiten las funciones de anotaciones. Las referencias de
datos basadas en calculós usan valores registrados de sus entradas para generar marcas de
tiempo para sus propios valores registrados. Si los datos de referencia basados en calculós
no contienen entradas de serie temporal, se comportan como el tipo de cónfiguración sin
datos de referencia, a excepción de que no pueden escribirse.
Nota:
Las referencias de datos de busqueda de tabla se cónfiguran con una columna de
tiempo, como se describe en Datos de serie temporal proporcionados por tablas,
admiten las mismas funciones de datos que el tipo de cónfiguración: referencia de
datos personalizados que generan sus propios datos de serie temporal.
• Referencia de datos basados en cálculos personalizados
Las referencias de datos personalizadas basadas en calculós deben "elegir" para obtener
acceso a las funciones de datos base.
Guía del usuario PI System Explorer
101
Recuperación de información de activos
• Referencia de datos personalizada que genera sus propios datos de serie temporal
Las referencias de datos personalizada que genera sus propios datos de serie temporal
requiere la implementación de un códigó para cada llamada de función de datos.
La siguiente tabla detalla que funciones de datos admiten las cónfiguraciónes de referencia de
datos no de PI point que se enumeran anteriormente. Estas restricciones tambien rigen para
otras herramientas de cliente, como PI DataLink, PI Vision, PI ProcessBook y PI WebParts.
Función de datos
Sin
referenci
a de
datos
Referencia de
datos basada en
cálculos con
entradas de serie
temporal
Referencia de
datos basados en
cálculos
personalizados
Referencia de
datos
personalizada con
sus propios datos
de serie temporal
InterpolatedValue
Opcional1
Códigó2
InterpolatedValues
Opcional1
Códigó2
InterpolatedValuesAtTimes
Opcional1
Códigó2
RecordedValue
Opcional1
Códigó2
RecordedValues
Opcional1
Códigó2
RecordedValuesAtTimes
Opcional1
Códigó2
RecordedValuesByCount
Opcional1
Códigó2
Async
Opcional1
Códigó2
PlotValues
Opcional1
Códigó2
Summary
Opcional1
Códigó2
Summaries
Opcional1
Códigó2
FilteredSummaries
Códigó2
UpdateValue
Códigó2
UpdateValues
Códigó2
Annotations
Códigó2
Filters
Códigó2
AFDataPipe
Opcional1
Códigó2
1
Indica que una referencia de datos personalizada se puede escribir con un metódó para declarar que atributos utiliza como
entradas, y otro metódó que transforma entradas en salidas. Con el soporte de entrada, el AF SDK utiliza estos metódós para
emular a los demas, utilizando una serie temporal generada a partir de los datos de entrada.
2
Indica que el códigó es necesario para cada metódó, si la serie temporal proviene del sistema de registros al que se esta
conectando.
102
Guía del usuario PI System Explorer
Organización de modelos de activos en PI AF
El objetivo de la órganización de los modelos de activos es hacer que a los usuarios les resulte
facil encontrar los activos. El metódó de órganización principal es el arból de elementos. Los
elementos de PI AF se organizan en una estructura de arból. Los elementos individuales se
pueden organizar y reagrupar dentro del arból, sin limitaciones. Si acaba de empezar a utilizar
PI AF, comience por crear la jerarquía de elementos.
Puede realizar la órganización tambien por categórías para agilizar y simplificar la explóración
y la busqueda de infórmación. Considere las categórías como etiquetas que se pueden aplicar a
objetos de PI AF. Cada objeto puede tener varias categórías.
Nota:
Tambien puede organizar activos dentro de un proceso. Consulte Modelos de proceso en
PI AF.
En esta sección
• La estructura del modelo de activos de PI AF
• El disenó de las jerarquías de activos de PI AF
• Referencias de elementos en la jerarquía de activos
• Categórización de objetos
La estructura del modelo de activos de PI AF
Los objetos de PI AF se organizan en una estructura de arból, similar a la estructura de archivos
de un equipo con Windows. En Windows, en lugar de tener miles de archivos en el escritorio,
los archivos se agrupan en carpetas. El mismo concepto se aplica a los elementos de PI AF. La
órganización de elementos en jerarquías hace mas facil navegar por ellos y ofrece infórmación
sobre cómó se relacionan los elementos entre sí.
Al crear un modelo de activos, debe decidir que estructura hara mas facil la busqueda de los
diferentes activos para los usuarios. Tenga en cuenta quienes son sus usuarios y que buscan.
Por ejemplo, es posible que los ingenieros de mantenimiento deseen utilizar PI System
Explorer para buscar y registrar infórmación de mantenimiento. Para esta audiencia, es posible
que desee agrupar activos por tipo de equipo.
Por ejemplo, si tuviera tres elementos de bomba, tal vez desee crear un elemento denominado
Bombas y luego colocar todos los elementos de bomba en el. Si tuviera dos elementos que
representan tanques, pódría colocarlos en el elemento Tanques.
Modelo de activos organizados por tipo de equipo
Por otro lado, si tiene varias plantas en diferentes ubicaciones, es posible que el mismo
ingeniero de mantenimiento prefiera ver todos los equipos ubicados en su propia planta. La
siguiente ilustración muestra los mismos elementos organizados por planta.
Guía del usuario PI System Explorer
103
Organización de modelos de activos en PI AF
Modelo de activos organizados por ubicación
No esta limitado a una sola estrategia de órganización. Puede utilizar referencias de elemento
para incluir el mismo activo en diferentes ubicaciones del arból. Por ejemplo, puede optar por
organizar los elementos por tipo de equipo y planta tambien. En la siguiente ilustración, la
jerarquía incluye el arból geógraficó junto al arból de equipos.
Modelo de activos mixto
Tambien, puede anidar la órganización por equipos en la órganización por zonas geógraficas.
Nota:
OSIsoft le recomienda que limite la profundidad de sus jerarquías de activos en hasta 10
niveles para mantener el desempenó y la interpretabilidad de sus datos de activos.
El diseño de las jerarquías de activos de PI AF
El objetivo es crear una jerarquía de activos (elementos) que tenga sentido para las personas
que necesitan utilizarla. Si tiene distintos tipos de usuario, es posible que necesite varias
estructuras de arból.
Si esta empezando, no intente hacer todo a la vez. Cree una jerarquía para un subconjunto de
sus activos. Por ejemplo, puede comenzar por crear un modelo para los tanques o bien para el
equipo en una sola planta o el equipo de un solo fabricante. Otro planteamiento sería crear una
jerarquía para un tipo de usuario en particular.
Recopile infórmación:
• ¿Que activos se incluiran en el arból? En otras palabras, ¿que tipo de equipo desea incluir en
el modelo?
• ¿Quien necesitara encontrar activos en este arból? ¿Los ingenieros de mantenimiento? ¿Los
ingenieros de control de proceso? ¿Los operadores? ¿Que tareas necesitara realizar cada
tipo de usuario?
• ¿Que activos son importantes para cada usuario y que tipo de infórmación necesitan?
Planteese preguntar a un numeró reducido de usuarios representativos de cada tipo a que
datos necesitan acceder y cómó. Esto debería brindar infórmación sobre la estrategia
organizativa.
Una vez mas, empiece a pequena escala. Puede comenzar por un unicó tipo de usuario. Por
ejemplo, supongamos que los ingenieros de mantenimiento necesitan utilizar el modelo. Si
tiene varias plantas, cada una de ellas con un grupo de ingenieros de mantenimiento
104
Guía del usuario PI System Explorer
Organización de modelos de activos en PI AF
responsable del equipo en esa planta, probablemente debería incluir un arból que organice el
equipo por planta.
A partir de ese punto, puede preguntarles a algunos ingenieros de mantenimiento cómó desean
acceder a la infórmación del equipo. Probablemente, con frecuencia buscaran activos por tipo
de equipo, pero en algunas ocasiones necesitaran buscarlos por fabricante. Puede crear dos
arbóles paralelos: uno organizado por tipo de equipo y el otro por fabricante. Cada activo
aparecera entonces en cada uno de los arbóles. Tambien puede crear el arból por tipo de
equipo y utilizar categórías para etiquetar cada activo por fabricante.
Una vez creada la jerarquía para un tipo de usuario, puede pedirles a algunos de ellos que la
prueben durante cierto tiempo y que luego proporcionen comentarios para mejorar la
jerarquía. Siempre puede módificar las jerarquías.
Nota:
Cuando piense en los usuarios, recuerde que la jerarquía de elementos puede quedar
expuesta en determinadas aplicaciones cliente de PI. Tenga en cuenta tambien a los
usuarios de esas aplicaciones. Por ejemplo, PI Vision muestra el arból a los usuarios que
buscan activos relacionados. En PI Vision, los activos relacionados son elementos creados
a partir de la misma plantilla.
Videos
Para obtener infórmación sobre cómó crear elementos, mire este video:
https://www.youtube.com/watch?v=d-kPQGabJuY&rel=0
Para obtener infórmación sobre cómó crear jerarquías de elementos, mire este video:
https://www.youtube.com/watch?v=hpiQSzubDu8&rel=0
Referencias de elementos en la jerarquía de activos
Puede utilizar referencias de elementos para anadir el mismo elemento varias veces a la
jerarquía de elementos, como se describe en La estructura del modelo de activos de PI AF.
Cuando se crea una referencia a un elemento existente, se crea fundamentalmente un marcador
en la jerarquía que vuelve a senalar al elemento referenciado. Esto permite a los usuarios
encontrar el elemento en los contextos correspondientes, pero no crea una copia del elemento.
El comportamiento exacto dependera del tipo de referencia.
En esta sección
• Tipos de referencia
• Crear una sola referencia de elemento
• Crear varias referencias de elemento
• Localizar otras referencias al mismo elemento
• Cambiar tipos de referencia
• Creación de tipos de referencia personalizados
Tipos de referencia
Al anadir una referencia de elemento a una jerarquía de elementos, la relación exacta entre el
elemento referenciado y el elemento al que se anade depende del tipo de referencia. PI AF
proporciona tres tipos de referencia definidós por el sistema:
Guía del usuario PI System Explorer
105
Organización de modelos de activos en PI AF
• Parent-Child
• Composition
• Weak Reference
Tambien puede crear tipos de referencia personalizados, como se describe en Creación de tipos
de referencia personalizados y Plantillas secundarias.
Videos
Para obtener infórmación sobre cómó utilizar tipos de referencia, mire este video:
https://www.youtube.com/watch?v=OL43oUyuFEI&rel=0
Para obtener infórmación sobre cómó crear tipos de referencia personalizados, mire este video:
https://www.youtube.com/watch?v=VcXsWfUEYQ8&rel=0
Para obtener la cónclusión del ejemplo del tipo de referencia, mire este video:
https://www.youtube.com/watch?v=Vwta8GG4Jgk&rel=0
En esta sección
• Tipo de referencia principal-secundario
• Tipo de referencia de cómpósición
• Tipo de referencia debil
Tipo de referencia principal-secundario
Principal-secundario es el tipo de referencia predeterminado. El tipo de referencia es fuerte ya
que permite que el elemento secundario tenga muchos principales y existe siempre y cuando
tenga uno o mas objetos principales con referencias fuertes. Si se elimina el ultimó elemento
principal del secundario, el propio elemento secundario se eliminara. Utilice el tipo de
referencia principal-secundario cuando desee que el secundario exista siempre y cuando tenga
una referencia fuerte con un principal como mínimó, pero no desee que los elementos
secundarios sean considerados como una unidad simple con el elemento principal.
Efecto de eliminar una referencia principal-secundario cuando este tipo de referencia existe en otro
lugar
Ejemplo
Un medidor que pertenece a una empresa se vincula a un edifició. Tendría que utilizar una
referencia principal-secundario entre el elemento de Company y el elemento secundario de
Meter, y otra referencia principal-secundario entre el elemento de Building y el elemento
secundario de Meter. Si la referencia entre Meter y el elemento de Building se elimina, el
elemento de Meter cóntinua existiendo porque tiene una referencia principal-secundario con
el elemento de Company. Sin embargo, si tambien se elimina el elemento secundario de Meter
del elemento de Company, dejara de existir porque todas las referencias principal-secundario
se habran eliminado.
106
Guía del usuario PI System Explorer
Organización de modelos de activos en PI AF
Tipo de referencia de composición
Un tipo de referencia con la fuerza de cómpósición significa que el elemento secundario forma
parte del principal y no puede existir sin el. Si elimina un elemento principal que tenga una
referencia de cómpósición con un elemento secundario, eliminara tambien este ultimó.
Repercusión de un elemento principal eliminado en elementos con un tipo de referencia de
composición
Ejemplo
Utilice una referencia de cómpósición cuando los dos objetos en la relación se consideren un
elemento. Por ejemplo, un medidor puede estar compuesto de dos sensores; por lo tanto,
tendría que utilizar una referencia de cómpósición entre el elemento de Meter y cada uno de
sus dos elementos de Sensor secundarios. Cuando elimina el elemento de Meter, los
elementos de Sensor secundarios tambien se eliminan autómaticamente.
Tipo de referencia débil
Utilice una referencia debil entre dos elementos cuando desee crear una relación entre dos
elementos, pero no desee que esa relación determine la duración del elemento secundario. Por
ejemplo, si desea organizar los medidores por grupos, pero se han eliminado todas las
referencias fuertes al medidor, es probable que desee que se elimine autómaticamente de la
agrupación. En este caso, tendría que utilizar una referencia debil entre el elemento principal
del grupo y el elemento secundario del medidor.
Repercusión de un elemento fuerte eliminado en un elemento con un tipo de referencia débil
Ejemplo
Un elemento secundario con una referencia debil se eliminara tan pronto como no haya mas
referencias fuertes. Esto puede resultarle util si desea que una de las vistas de sus activos sea
una vista principal. Por ejemplo, en la ilustración anterior, la vista principal pódría ser la vista
Site ABC y contener elementos con tipos de referencia principal-secundario fuerte. Otras
vistas, como Pumps, hacen referencia a elementos con un tipo de referencia debil. Si el elemento
Pump01 fuerte en la vista principal Site ABC se elimina, el elemento Pump01 que tiene la
referencia debil en la vista Pumps se elimina autómaticamente.
Guía del usuario PI System Explorer
107
Organización de modelos de activos en PI AF
Crear una sola referencia de elemento
Puede crear una sola referencia de elemento para establecer una relación jerarquica entre dos
elementos.
Procedimiento
1. En el navegador Elementos, haga clic en el elemento al que desea hacer referencia y
arrastreló al elemento principal que corresponda.
2. En la ventana Seleccionar tipo de referencia, seleccione el tipo de referencia.
Si no esta seguro de que tipo de referencia prefiere, mantenga el tipo predeterminado:
principal-secundario. Consulte Tipos de referencia si desea mas infórmación.
3. Haga clic en Aceptar.
Los elementos referenciados se móstraran en el navegador. El icono de elemento
referenciado indica que son referencias.
Video
Para obtener infórmación adicional sobre cómó crear un tipo de referencia de elemento, mire
este video:
https://www.youtube.com/watch?v=Q1kK71JrhLo&rel=0
Crear varias referencias de elemento
Cree varias referencias de elemento para establecer una relación entre un elemento y otros
elementos de la jerarquía.
Procedimiento
1. En el navegador Elementos haga clic con el bótón secundario sobre un elemento y luego
haga clic en Nuevo > Agregar referencia de elemento.
Observe que tambien puede seleccionar un elemento y arrastrarlo al principal.
2. En la ventana Agregar elemento(s), haga clic en el bótón Buscar múltiples elementos.
3. En la ventana Búsqueda de elementos, seleccione los criterios de busqueda para ubicar los
elementos deseados y luego haga clic en el bótón Búsqueda.
El campo de resultados de la busqueda móstrara los resultados de su busqueda.
4. Seleccione los elementos a los que desee hacer referencia y haga clic en Aceptar.
5. En la ventana Agregar elementos, seleccione el tipo de referencia. Si no esta seguro de que
tipo de referencia prefiere, mantenga el tipo predeterminado: principal-secundario.
Consulte Tipos de referencia si desea mas infórmación.
6. Haga clic en Aceptar.
Los elementos referenciados se móstraran en el navegador. El icono de elemento
referenciado indica que son referencias.
Localizar otras referencias al mismo elemento
Un unicó elemento puede estar referenciado en diferentes lugares dentro de la jerarquía. Pódra
localizar todos los elementos dentro de la jerarquía que contienen el elemento o una referencia
al elemento.
108
Guía del usuario PI System Explorer
Organización de modelos de activos en PI AF
Procedimiento
1. Seleccione el elemento en el navegador Elemento.
2. En la pestana General, haga clic en el vínculó Valores principales.
Los valores principales del elemento se muestran en la ventana Primarios deElement.
3. Haga clic en Close.
Cambiar tipos de referencia
Puede cambiar el tipo de referencia de un elemento secundario y el event frame que tiene al
menos un elemento principal en la jerarquía y no esta en el nivel raíz de la jerarquía (donde el
tipo de referencia debe ser principal-secundario).
Procedimiento
1. Elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Cambiar el tipo de referencia de un elemento
secundario
a. En el navegador, seleccione Elementos.
b. En el navegador, expanda el arból Elementos
y localice el elemento secundario con mas de
un elemento principal.
c. Haga clic con el bótón derecho en el elemento
secundario y luego haga clic en Convertir >
Cambiar tipo de referencia.
Cambiar un tipo de referencia de event frame
secundario
a. En el navegador, seleccione Event Frames.
b. En el navegador, expanda el arból event
frames y localice el event frame secundario
con mas de un elemento principal.
c. Haga clic con el bótón derecho en el event
frame secundario y luego haga clic en
Convertir > Cambiar tipo de referencia.
2. En la ventana Cambiar tipo de referencia, seleccione un elemento principal de la lista
Principal.
3. Seleccione un nuevo tipo de referencia de la lista Nuevo tipo de referencia. Solo estan
disponibles los tipos de referencia validós para el elemento principal seleccionado.
4. Para establecer el elemento principal seleccionado como elemento principal (cuando el tipo
de referencia seleccionado es validó), seleccione la casilla de verificación Elemento principal
primario.
Nota:
Para que sea validó, el tipo de referencia seleccionado debe ser fuerte y no se pueden
definir referencias de cómpósición para el elemento o el event frame.
5. Haga clic en Aceptar.
Creación de tipos de referencia personalizados
Los tipos de referencia personalizados son faciles de crear. Cada tipo de referencia se debe
basar en uno de los tres tipos de referencia predefinidós. Mediante el uso de tipos de referencia
personalizados, puede crear reglas que permitan a PI AF ayudar a los usuarios cuando creen
elementos nuevos. Consulte Plantillas secundarias para obtener infórmación sobre la creación
de referencias de plantilla.
Guía del usuario PI System Explorer
109
Organización de modelos de activos en PI AF
Crear tipos de referencia personalizados
Los tipos de referencia personalizados se crean en plantillas secundarias. Tambien puede
crearlos para definir su propia jerarquía de elementos utilizando una relación mas específica.
Los tipos de referencia personalizada deben estar basados en uno de los tipos de referencia
predefinidós.
Nota:
Puede crear tipos de referencia con mas rapidez en la cólección Plantillas de elementos si
utiliza plantillas referenciadas, como se describe en Crear referencias de plantilla
secundaria.
Procedimiento
1. En el navegador Biblioteca, haga clic con el bótón secundario en la cólección Tipos de
referencia y seleccione Nuevo tipo de referencia.
2. En el campo Nombre, introduzca un nombre para el tipo de referencia.
3. En los campos Nombre secundario y Nombre principal, introduzca el nombre principal y el
nombre secundario.
4. Opcional. En el campo Categorías, haga clic en
y seleccione una o mas categórías a las
que pertenece el tipo de referencia de la ventana Categorizar. Tambien puede introducir una
o mas categórías de tipos de referencia directamente, separadas por punto y coma.
5. En el campo Fortaleza de referencia, seleccione Fuerte, Débil o Composición de la lista.
Consulte Tipos de referencia para ver las definiciónes de las potencias de tipos de referencia.
6. En los campos Plantilla de elementos principales permitidos y Plantilla de elementos
secundarios permitidos, seleccione en la lista una plantilla a la que pertenecen los nombres
principales y secundarios de tipos de referencia.
Categorización de objetos
PI System Explorer permite organizar objetos en categórías. Las categórías son basicamente
grupos de objetos definidós por los usuarios. Su finalidad es ayudar a encontrar objetos con
mas facilidad. Cuando busque un objeto, puede utilizar la categóría como filtró para reducir la
lista de resultados. Defina tantas categórías como desee. Los objetos pueden pertenecer a
varias categórías.
Por ejemplo, supongamos que tiene un conjunto de elementos que representa tanques. La
mitad de los tanques estan fabricados por la empresa ACME y la otra, por la empresa EMCA.
Para ubicar los tanques por fabricante, cree dos categórías: ACME y EMCA.
Cada tipo de objeto tiene sus propias categórías. No pódra aplicar las categórías de un tipo de
objeto a un objeto de otro tipo. Por ejemplo, no puede aplicar una categóría de elemento a una
tabla. PI AF es compatible con los siguientes tipos de categóría:
• Analisis
• Atributo
• Elemento
• Regla de nótificación
• Tipo de referencia
• Tabla
110
Guía del usuario PI System Explorer
Organización de modelos de activos en PI AF
Videos
Para obtener infórmación sobre cómó crear categórías, mire este video:
https://www.youtube.com/watch?v=ux3qiQVSePU&rel=0
Para obtener infórmación sobre cómó asignar categórías, mire este video:
https://www.youtube.com/watch?v=5wkvG-1jOgM&rel=0
Para obtener infórmación sobre cómó agrupar por categóría, mire este video:
https://www.youtube.com/watch?v=A0OlJZ19qWA&rel=0
En esta sección
• Crear nuevas categórías
• Asignar objetos a categórías
Crear nuevas categorías
Cree categórías para tipos de objeto específicós. Tambien puede utilizar PI Builder de manera
alternativa para crear distintas categórías en una hoja de calculó de Excel.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, en Categorías, haga clic con el bótón secundario sobre el tipo de
objeto de categóría y seleccione Nueva categoría.
3. En la ventana Object_Type Category Properties (Propiedades de categóría), introduzca un
nombre para la categóría en el campo Nombre.
4. Opcional. Introduzca una descripción de la categóría en el campo Descripción.
5. Haga clic en Aceptar.
6. Opcional. Haga clic en el vínculó Seguridad si desea cónfigurar permisos de acceso
personalizados para la categóría ademas de los que ya se establecieron en el ambitó del
servidor, de la base de datos o de la cólección. Para obtener mas infórmación, consulte
Cónfigurar la seguridad para objetos.
Asignar objetos a categorías
Asigne objetos a las categórías que ha creado para cada tipo de categóría.
Procedimiento
1. En el visor, utilice las teclas estandar de Windows para resaltar objetos contiguos (SHIFT
+<click>) o no contiguos (CTRL+<click>) que desee categorizar.
2. Haga clic con el bótón secundario y seleccione Categorizar.
3. En la ventana Categorizar, seleccione la categóría o categórías que desee asignar a los
objetos seleccionados.
a. Si la categóría que necesita no esta en la lista, haga clic en el bótón Nueva categoría.
b. En la ventana Propiedades de categoría de atributo, cree la nueva categóría y haga clic en
Aceptar.
4. Haga clic en Aceptar. Las categórías se aplican y se muestran en el campo Categorías, en el
panel de cónfiguración para cada objeto.
Guía del usuario PI System Explorer
111
Organización de modelos de activos en PI AF
a. Si alguno de los objetos seleccionados se crea a partir de plantillas, puede módificar la
plantilla o no anadir la categóría a ese objeto en particular.
Elija una de las opciones siguientes:
▪ Haga clic en Modificar la plantilla y añadir la categoría para módificar todos los
atributos derivados de la plantilla con la categóría.
▪ Haga clic en No añadir la categoría para evitar que la categóría sea asignada al objeto.
b. Para aplicar la ópción a otros atributos seleccionados que derivan de plantillas,
seleccione la casilla de verificación Aplicar la elección a las plantillas restantes.
c. Haga clic en Aceptar.
112
Guía del usuario PI System Explorer
Representación de activos en PI AF
Todos los objetos físicós que incluya en el modelo estaran representados por un elemento de PI
AF. Los objetos físicós son, por lo general, equipos como bombas o tanques. Para asociar datos
con un elemento, cree atributos en el elemento. Los atributos pueden incluir valores simples,
que representan infórmación fija, como el diametró de un tanque, por ejemplo. Un atributo
puede hacer referencia tambien a un PI point, una fórmula, un valor de una base de datos
relacional externa, etc.
Plantillas
Puede crear los elementos uno por uno, pero OSIsoft recomienda basar los elementos
individuales en una plantilla de activos que represente el tipo de equipo. Las plantillas de
elementos le permiten hacer lo siguiente:
• Cónfigurar la plantilla una sola vez; no es necesario cónfigurar los elementos basados en la
plantilla individualmente.
• Actualizar la estructura de todos los elementos que pertenecen a la plantilla.
• Mantener la coherencia del modelo de activos.
• Activar potentes funciones en las aplicaciones cliente de PI AF.
En esta sección
• Representación de activos con plantillas
• Estrategia de plantillas
• Plantillas de elementos
• Plantillas secundarias
• Representación de activos con elementos
• Almacenamiento de infórmación específica para cada aplicación
Representación de activos con plantillas
PI AF le permite basar objetos similares en una unica plantilla. Las plantillas definen
principalmente un conjunto de atributos base para todos los objetos que utilicen esa plantilla.
Cree la plantilla una vez y, despues, pódra crear tantos elementos como necesite basandóse en
la plantilla. Si realiza un cambio en una plantilla, el cambio se refleja autómaticamente en todos
los elementos que utilizan esa plantilla.
Por ejemplo, suponga que tiene 100 bombas con los mismos tres atributos. Puede crear una
plantilla para una bomba y despues basar todas las demas bombas en esa plantilla. Los
atributos de la plantilla se crean autómaticamente en las bombas que estan basadas en esa
plantilla.
Ahora, suponga que debe realizar un cambio en los objetos de la bomba. Simplemente realiza el
cambio en la plantilla y PI AF própagara de forma autómatica el cambio a todos los objetos de la
bomba que esten basados en esa plantilla. Las plantillas son una herramienta poderosa, no solo
para crear nuevos objetos, sino para mantener los objetos existentes coherentes y actualizados.
Guía del usuario PI System Explorer
113
Representación de activos en PI AF
Una ventaja adicional es que las herramientas de visualización pueden proporcionar
características especiales para los objetos basados en plantillas. Por ejemplo, supongamos que
crea una tendencia para una bomba basada en una plantilla. Una herramienta de visualización
pódría permitirle intercambiar o anadir cualquier otra bomba que se base en la misma
plantilla. Los activos basados en la misma plantilla se denominan en algunas ocasiones activos
relacionados.
Nota:
Tambien puede crear plantillas para event frames, transferencias, modelos y
nótificaciónes.
Estrategia de plantillas
Practicamente en todos los casos, es mejor basar los elementos en plantillas. No solo ahórrara
tiempo, sino que tambien se asegura de que dispóndra de definiciónes coherentes de todos los
elementos en función de esa plantilla. Todos los cambios que realice en una plantilla de
elementos se própagaran a todos los elementos basados en esa plantilla. Una unica
módificación de la plantilla puede alterar cientos de elementos. Esto le permite realizar
cambios en su modelo desde un unicó lugar; no tendra que actualizar todos los elementos.
No tendra que planificar y crear todas las plantillas a la vez. Un planteamiento recomendable es
empezar por crear un modelo con un solo tipo de activo. Cree una plantilla para el tipo de
activo. Decida que datos, calculós y otras propiedades necesitara almacenar para ese tipo de
activo. Cada uno de estos elementos requiere una plantilla de atributos.
Plantillas base
El uso de la plantilla puede ser muy amplio o muy específicó. Una plantilla puede definir un tipo
específicó de dispositivo de medición, como un instrumento de una marca concreta, o puede
ser una plantilla de uso amplio que especifica una determinada función, como medidor de masa
líquida. En función de la amplitud con la que defina la plantilla, puede encontrarse con que la
lista de atributos es un poco diferente para distintos subconjuntos de activos. En esta situación,
considere utilizar una plantilla base (para mas infórmación, consulte Plantillas base y
derivadas). La alternativa es utilizar una plantilla diferente para cada subconjunto de activos.
Extensiones
Tambien puede cónfigurar plantillas de elementos para que incluyan atributos (y puertos) que
no esten definidós ni mantenidos por la plantilla (para obtener mas infórmación, consulte
Extensiones). Puede agregar atributos simples y específicós para cada activo sin necesidad de
anadirlós en todas las instancias de la plantilla.
Nota:
Las categórías, los analisis y las nótificaciónes no se veran afectados si se habilita la casilla
de verificación Permitir extensiones.
Plantillas de elementos
Una plantilla de elementos es un modelo de un tipo de activo que le permite ahorrar tiempo y
favorece la uniformidad. Las plantillas de elementos hacen que crear pantallas, nótificaciónes,
calculós y analisis resulte mucho mas facil, porque los equipos con el mismo tipo pueden
compartir la misma implementación. Por lo general, se crea una plantilla base que representa
un tipo de equipo, como un tanque o una bomba, y se asignan atributos comunes al activo.
Luego se crean una o mas plantillas derivadas basadas en la plantilla base y se asignan
atributos adicionales a cada subconjunto de activos.
114
Guía del usuario PI System Explorer
Representación de activos en PI AF
Pódra crear de forma sencilla elementos a partir de una plantilla derivada porque la mayor
parte de la cónfiguración del elemento estara definida en la plantilla.
Al realizar cambios en una plantilla de elementos, los cambios se propagan a todos los
elementos derivados de esta.
La eliminación de una plantilla de elementos elimina las plantillas de analisis o nótificación que
la dirigen.
Tenga en cuenta lo siguiente:
• Un elemento derivado de una plantilla obtiene su definición inicial de las categórías de la
plantilla. Los atributos y puertos del elemento se obtienen de la plantilla.
• Si la plantilla permite extensiones, entonces el elemento derivado puede contener puertos y
atributos adicionales que no esten definidós en la plantilla.
• Las plantillas de elementos pueden especificar las referencias primarias y secundarias
permitidas (tipos de referencias primarias y tipos de referencias secundarias) para un
elemento creado a partir de la plantilla. Esto limita las relaciones permitidas entre
elementos de la jerarquía.
• Un elemento no se puede derivar directamente de una Plantilla base únicamente.
Video
Para obtener infórmación sobre cómó crear plantillas de elementos, mire este video:
https://www.youtube.com/watch?v=VYWXctstVg0&rel=0
En esta sección
• Atributo predeterminado
• Plantillas base y derivadas
• Extensiones
• Patrones de asignación de nombres
• Crear plantillas de elementos
• Encontrar referencias de plantillas
• Definir plantillas para otros objetos
Atributo predeterminado
El atributo por defecto es el atributo que mas representativo resulta del elemento. Por ejemplo,
si un usuario quisiera hacer referencia a un tanque, el mejor atributo individual para utilizar
sería Level. Para un contador electricó, el mejor atributo sería Voltage. El atributo debe estar
en el nivel superior de la jerarquía de atributos del elemento.
Las nótificaciónes y los analisis de activos pueden beneficiarse del atributo predeterminado
para simplificar algunas tareas. Por ejemplo, si tuviera que crear una cómparación entre dos
contadores electricós y no hubiera especificadó atributos con los que comparar, la cómparación
se realizaría con el atributo Voltage de los contadores por haber establecido Voltage como
atributo por defecto.
Plantillas base y derivadas
Una plantilla base se utiliza mejor a la hora de modelar elementos que comparten la mayóría de
los atributos, pero tienen algunos atributos diferentes. Una plantilla base transfiere todos sus
Guía del usuario PI System Explorer
115
Representación de activos en PI AF
atributos (así como los puertos y analisis) a cualquier plantilla derivada creada a partir de ella.
Al crear posteriormente un elemento a partir de dichas plantillas, ese elemento no solo
contiene todos los atributos (así como los puertos y analisis) derivados de la plantilla base, sino
tambien los de la plantilla derivada.
Plantilla base únicamente (BTO)
Para asegurarse de que ciertas plantillas no se utilicen directamente para crear objetos, puede
asignar la propiedad Plantilla base únicamente (BTO) a una plantilla nueva. Al igual que otras
plantillas base, una plantilla BTO puede ser tan amplia o específica como sea necesario y luego
se puede utilizar para crear una plantilla derivada. Cuando se crea una instancia de un objeto,
se basa en la plantilla derivada, no en la plantilla BTO. Cualquier módificación en la plantilla
BTO tambien altera sus plantillas derivadas. La propiedad BTO se puede asignar a plantillas de
elemento, modelo, transferencia y event frame.
Nota:
Una marca de verificación junto a la casilla Plantilla base únicamente en la pagina
General de la ventana Propiedades de la plantilla indica que la plantilla es una plantilla
BTO.
Ejemplo de plantilla base
Pongamos que tiene un conjunto de tanques, algunos con dos valvulas y otros con una sola,
puede crear una plantilla de elemento para los modelos con una sola valvula y usarla como
plantilla base para la plantilla derivada que cree para los modelos con dos valvulas. Cuando
cree objetos que se basen en el modelo de dos valvulas, heredaran todos los atributos del
modelo de una sola valvula, ademas de cualquier atributo adicional que se haya definidó para el
modelo de dos valvulas.
Plantillas derivadas
Las plantillas derivadas se definen a partir de una plantilla base. Puede designar una plantilla
derivada despues de crear una plantilla base con el metódó siguiente:
• Haga clic con el bótón secundario en una plantilla base del navegador Biblioteca, luego haga
clic en Nuevo > Nueva plantilla derivada.
La nueva plantilla se agregara inmediatamente al navegador Biblioteca con el nuevo nombre,
BaseTemplate_Derived1.
Pódra módificar la definición, incluido el nombre, tal como se describe en Crear plantillas de
elementos.
Reemplazo de los valores de atributo de la plantilla base
Es probable que se presenten situaciones en que necesite usar valores de plantilla de atributo
en una plantilla derivada que anule o reemplace los valores de plantilla de atributo heredados
de su plantilla base. Considere las siguientes situaciones:
• Se necesitan patrones de substitución diferentes para los PI points del mismo tipo de activo
(por ejemplo, los camiones tienen un conjunto de mediciones en cómun, pero el fabricante
de camiones A utiliza un patrón de asignación de nombres de PI diferente con respecto al
fabricante B).
• Algunos activos utilizan la medición directa para un PI point de atributo, mientras que otros
es probable que necesiten que se calcule un valor de atributo. Del mismo modo, un valor de
atributo puede calcularse para ambos tipos de activos, pero el calculó es sensiblemente
diferente entre los dos.
116
Guía del usuario PI System Explorer
Representación de activos en PI AF
• Segun la plantilla, se necesitan diferentes UOM o categórías predeterminadas para el mismo
atributo.
• No es posible utilizar todas las plantillas de atributo en una plantilla derivada (por ejemplo,
es probable que algunos medidores solo necesiten tres de los cinco atributos de una
plantilla base Meter generica).
Los valores de atributo de una plantilla base se reemplazan mediante la creación de una
plantilla de atributo que tenga exactamente el mismo nombre en la plantilla derivada. Luego,
puede módificar las propiedades segun sea necesario.
Ademas, puede impedir que una plantilla de atributo que se ha heredado de una plantilla base
resulte visible para los usuarios o una aplicación cliente, como por ejemplo PI Vision, mediante
la creación de una plantilla de atributo con el mismo nombre en la plantilla derivada y selección
de la ópción Excluido como ajuste Propiedades. Para obtener mas infórmación, consulte
Propiedad de atributo apagado.
Herencia de plantilla
De forma predeterminada, las plantillas de elemento se ordenan por nombre en el navegador
Biblioteca. Para determinar la relación existente entre plantillas, puede resultar preferible
ordenarlas por herencia de plantilla en su lugar. Puede hacer clic con el bótón secundario en la
cólección Plantillas de elementos y luego hacer clic en Ordenar por > Ordenar por herencia de
plantilla. Para expandir las plantillas y ver sus plantillas derivadas, utilice , junto a ellas.
Extensiones
Puede permitir que algunos atributos esten definidós en el propio elemento,
independientemente de la plantilla. Para ello, cónfigure la plantilla para admitir extensiones.
Los atributos que se crean como ampliaciones no cambian cuando se módifica la plantilla.
Nota:
Si tiene una plantilla que permite extensiones y luego la cambia para deshabilitar las
extensiones, no se pódran agregar atributos de elemento extendidos nuevos a los
elementos con base en esa plantilla. Sin embargo, todos los atributos de elemento
extendidos se mantendran.
Las extensiones permiten flexibilidad en los casos en que los activos son similares en muchas
areas, pero existe una serie de variaciones pequenas. Por ejemplo, supongamos que crea una
plantilla para un modelo de coche concreto. Todos los coches de este modelo tienen el mismo
conjunto basicó de características: cuatro ruedas, un volante, etc. Sin embargo, puede que un
coche tenga un alerón donde otro no lo tiene. Uno puede tener aire acondicionado y otro, no.
Las extensiones estan pensadas para manejar este tipo de variación.
Cuando las extensiones se habilitan, puede basar todos los elementos en una plantilla mientras
agrega infórmación adicional a cada elemento, segun sea necesario. Sin embargo, si tiene
multiples elementos que son muy similares a la definición de plantilla, pero requieren los
mismos atributos adicionales, una plantilla base puede ser un mejor enfoque que permitir
extensiones.
Nota:
Las categórías, los analisis y las nótificaciónes no se veran afectados si se habilita la casilla
de verificación Permitir extensiones.
Guía del usuario PI System Explorer
117
Representación de activos en PI AF
Patrones de asignación de nombres
Cuando define los patrones de asignación de nombres para plantillas de elemento, event frame,
transferencia y modelo, puede usar los parametrós de substitución descritos en la siguiente
tabla. Estos accesos directos de patrón de asignación de nombres estan disponibles ademas de
los parametrós de substitución en el campo Patrón de asignación de nombres cuando hace clic
en .
Parámetros de substitución de patrón de asignación de nombres
Nombre de parámetro
Sustitución
Parámetros de descripción
%DESCRIPTION:path%
Es la descripción del objeto representada por la ruta hacia el objeto.
Si no se especifica la ruta, se usa la descripción del objeto actual.
%\ELEMENTDESCRIPTION%
La descripción del elemento raíz del objeto o la descripción del
elemento de referencia primario del event frame raíz del objeto.
%..\ELEMENTDESCRIPTION%
La descripción del elemento principal del objeto o la descripción del
elemento de referencia primario del event frame principal del objeto.
Utilice la anótación ..\, por ejemplo, %..\..
\ELEMENTDESCRIPTION% para recuperar otros ascendientes.
%\EVENTFRAMEDESCRIPTION%
La descripción del event frame raíz del objeto.
%..\EVENTFRAMEDESCRIPTION% La descripción del event frame primario del objeto. Utilice la
anótación ..\, por ejemplo %..\..\EVENTFRAMEDESCRIPTION%,
para recuperar otros ascendientes.
Parámetros de ID
%ANALYSISID%
La ID del analisis del objeto.
%ATTRIBUTEID%
La ID del atributo o de la plantilla de atributos del objeto.
%|ATTRIBUTEID%
La ID del atributo raíz o de la plantilla de atributos del objeto.
%..|ATTRIBUTEID%
La ID del atributo principal o de la plantilla de atributos del objeto.
Utilice la anótación ..|, por ejemplo %..|..|ATTRIBUTE%, para
recuperar otros ascendientes.
%DATABASEID%
La ID de la base de datos PI AF del objeto.
%ELEMENTID%
La ID del elemento del objeto o la ID del elemento de referencia
primario del event frame del objeto.
%\ELEMENTID%
La ID del elemento raíz del objeto o la ID del elemento de referencia
primario del event frame raíz del objeto. Utilice la anótación ..\, por
ejemplo %..\..\ELEMENTID%, para recuperar otros ascendientes.
%..\ELEMENTID%
La ID del elemento principal del objeto o la ID del elemento de
referencia primario del event frame primario del objeto.
%EVENTFRAMEID%
La ID del event frame del objeto.
%\EVENTFRAMEID%
La ID del event frame raíz del objeto.
%..\EVENTFRAMEID%
La ID del event frame primario del objeto. Utilice la anótación ..\,
por ejemplo %..\..\EVENTFRAMEID%, para recuperar otros
ascendientes.
%ID:path%
La ID del objeto representada por la ruta hacia el objeto. Si no se
especifica la ruta, se usa la ID del objeto actual.
%MODELID%
La ID del modelo PI AF del objeto.
%SYSTEMID%
La ID del servidor PI AF del objeto.
%TRANSFERID%
La ID de la transferencia PI AF del objeto.
Parámetros de nombre
%ANALYSIS%
118
Guía del usuario PI System Explorer
El nombre del analisis del objeto.
Representación de activos en PI AF
Nombre de parámetro
Sustitución
%DATABASE%
El nombre de la base de datos PI AF del objeto.
%\ELEMENT%
El nombre del elemento raíz del objeto o el nombre del elemento de
referencia primario del event frame raíz del objeto.
%..\ELEMENT%
El nombre del elemento principal del objeto o el nombre del
elemento de referencia primario del event frame principal del objeto.
Utilice la anótación ..\, por ejemplo %..\..\ELEMENT%, para
recuperar otros ascendientes.
%\EVENTFRAME%
El nombre del event frame raíz del objeto.
%..\EVENTFRAME%
El nombre del event frame principal del objeto. Utilice la
anótación ..\, por ejemplo %..\..\EVENTFRAME%, para recuperar
otros ascendientes.
%NAME:path%
El nombre del objeto representado por la ruta hacia el objeto. Si no
se especifica la ruta, aparece un valor nulo ya que hace referencia al
nombre del objeto actual.
%SYSTEM%
El nombre del servidor PI AF del objeto.
%\TEMPLATE%
El nombre de la plantilla raíz del elemento o el event frame del
objeto.
%..\TEMPLATE%
El nombre de la plantilla principal del elemento o el event frame del
objeto. Utilice la anótación ..\, por ejemplo %..\..\TEMPLATE%,
para recuperar otros ascendientes.
Parámetros de ruta
%ELEMENTPATH%
La ruta del elemento base, el elemento de un atributo o el elemento
de referencia primario de un event frame.
%..\ELEMENTPATH%
La ruta del elemento principal del objeto o la ruta del elemento de
referencia primario del event frame principal del objeto. Utilice la
anótación ..\, por ejemplo %..\..\ELEMENTPATH%, para recuperar
otros ascendientes.
%EVENTFRAMEPATH%
La ruta del event frame o el elemento de un atributo de un event
frame.
%..\EVENTFRAMEPATH%
La ruta del event frame principal del objeto. Utilice la anótación ..\,
por ejemplo %..\..\EVENTFRAMEPATH%, para recuperar otros
ascendientes.
Parámetros de tiempo
Nota:
Puede especificar una cadena de formato con todas las substituciones de tiempo. La cadena de
formato esta separada del nombre de substitución por un punto y coma. Por ejemplo, %TIME:d%
utiliza el patrón de fecha corto, mientras que %UTCTIME:yyyy/MM/dd HH:mm:ss.fff% especifica
el formato completo.
%ENDTIME:yyyy-MM-dd
HH:mm:ss.fff%
La hora de finalización local actual del objeto que usa el formato
especificadó. Si no se especifica un formato, se usa el
predeterminado. El formato utiliza cadenas de formato estandar
admitidas por el metódó DateTime.ToString, como se describe en
Cadenas de formato para parametrós de sustitución de hora.
%UTCENDTIME:yyyy-MM-dd
HH:mm:ss.fff%
La hora de finalización del Tiempo Universal Coordinado (UTC)
actual del objeto que usa el formato especificadó. Si no se especifica
un formato, se usa el predeterminado. El formato utiliza cadenas de
formato estandar admitidas por el metódó DateTime.ToString,
como se describe en Cadenas de formato para parametrós de
sustitución de hora.
Guía del usuario PI System Explorer
119
Representación de activos en PI AF
Crear plantillas de elementos
Cree y cónfigure plantillas de elementos para garantizar definiciónes uniformes de los
elementos de su estructura de activos.
Procedimiento
1. En el navegador Biblioteca, haga clic con el bótón secundario en la cólección Plantillas de
elementos y luego haga clic en Nueva plantilla.
2. Ajuste y asigne valores en las pestanas para cónfigurar la plantilla de elementos. PI System
Explorer proporciona valores predeterminados para los valores obligatorios, pero puede
cónfigurar usted mismo esos valores. Los valores son:
120
Opción
Description
Plantilla base
Puede basar la plantilla en una plantilla existente. Seleccione la plantilla
base de la lista. Para obtener mas infórmación sobre plantillas base,
consulte Plantillas base y derivadas.
Escriba
Puede basar la plantilla en un tipo de elemento. Seleccione el tipo de
elemento de la lista. Para obtener mas infórmación sobre los tipos de
elementos, consulte Tipos de elementos de los modelos.
Categorías
Opcional. Puede organizar los objetos agrupandólós en categórías. Para ver
las distintas categórías disponibles o crear una nueva categóría, haga clic
en
. Consulte Categórización de objetos.
Atributo
predeterminado
Opcional. Seleccione un atributo predeterminado de la lista desplegable.
Consulte Atributo predeterminado.
Guía del usuario PI System Explorer
Representación de activos en PI AF
Opción
Description
Patrón de asignación
de nombres
Opcional. Puede introducir una cadena de texto o hacer clic en
para
elegir los parametrós de substitución de los siguientes con el fin de definir
un patrón de asignación de nombres.
◦ %TIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora local actual del objeto que usa el formato especificadó. Si
no se especifica un formato, se usa el predeterminado. El formato
utiliza cadenas de formato estandar admitidas por el metódó
DateTime.ToString, como se describe en Cadenas de formato para
parametrós de sustitución de hora.
◦ %UTCTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora del Tiempo Universal Coordinado (UTC) actual del objeto
que usa el formato especificadó. Si no se especifica un formato, se usa
el predeterminado.
◦ %TEMPLATE%
Es el nombre de la plantilla del objeto.
◦ %@Attribute%
Es el valor del atributo del objeto representado por la ruta.
Tambien puede usar otros parametrós de sustitución de patrón de
asignación de nombre. Por ejemplo, si desea que la ruta de un elemento se
incluya en el patrón de asignación de nombre, ingrese %ELEMENTPATH%
como parametró de substitución. Para obtener una lista completa de los
parametrós de sustitución de patrón de asignación de nombre, consulte
Patrones de asignación de nombres.
Cada elemento derivado de la plantilla tendra un nombre de identificación
unicó. Para asegurarse de que los nuevos elementos creados a partir de la
plantilla tengan un numeró incremental, introduzca * al final de cualquier
patrón que introduzca aquí.
Si se deja en blanco, PI System Explorer utiliza el campo Nombre de la
plantilla de elementos y anade un asterisco para anadir un numeró
incremental, segun resulte necesario.
Algunos parametrós de substitución no se pueden aplicar cuando se crea
un elemento derivado. Para asegurarse de que el nombre de un elemento
derivado refleje completamente el patrón de asignación de nombres, haga
clic con el bótón secundario en el elemento y luego haga clic en Reevaluar
patrones de asignación de nombres.
Nota:
El nombre generado por el patrón de nombres debe contener una
cantidad de caracteres menor que la cantidad maxima de 260
caracteres.
Permitir extensiones
Seleccione esta casilla a fin de habilitar atributos adicionales (así como
puertos) que puedan definirse para un elemento, ademas de los definidós
en su plantilla. Consulte Extensiones.
Nota:
Las categórías, los analisis y las nótificaciónes no se veran afectados
si se habilita la casilla de verificación Permitir extensiones.
Plantilla base
únicamente
Seleccione esta casilla de verificación para asignar la propiedad Plantilla
base únicamente (BTO) a una plantilla de elemento. No se pueden derivar
elementos directamente desde las plantillas BTO. Para obtener mas
infórmación, consulte Plantillas base y derivadas.
Propiedades
extendidas
Este enlace es una característica avanzada. Para obtener mas infórmación,
consulte Almacenamiento de infórmación específica para cada aplicación.
Guía del usuario PI System Explorer
121
Representación de activos en PI AF
Opción
Description
Ubicación
Haga clic en este vínculó si desea cónfigurar las características del atributo
de ubicación para el elemento. Sin embargo, tambien puede cónfigurarlós
en un atributo si lo prefiere. Tenga en cuenta que solo puede asignar un
conjunto de atributos de ubicación por elemento. Para obtener mas
infórmación, consulte Características de atributos.
Seguridad
Haga clic en este enlace si desea cónfigurar los permisos de acceso
personalizado para la plantilla de elementos mas alla de los que ya se
establecieron a nivel del servidor y de la base de datos. Para obtener mas
infórmación, consulte Cónfigurar la seguridad para objetos.
3. Utilice la pestana Plantillas de atributos para crear una plantilla de atributos para cada
propiedad o elemento de datos de la plantilla. Consulte Crear plantillas de atributos.
4. Si esta creando un modelo, utilice la pestana Puertos para especificar puertos, que definen
los puntos finales de las conexiones entre elementos dentro de un modelo. Consulte
Modelos de proceso en PI AF.
5. Opcional. Utilice la pestana Plantillas de análisis para crear una plantilla de analisis para la
plantilla de elementos. Para obtener mas infórmación, elija una de las siguientes opciones:
◦ Para crear una plantilla de analisis de expresiones, consulte Crear una plantilla de analisis
de expresiones.
◦ Para crear una plantilla de analisis de resumen, consulte Crear una plantilla de analisis de
resumen.
◦ Para crear una plantilla de analisis de generación de event frames, consulte Crear una
plantilla de analisis de generación de marcos de evento.
◦ Para crear una plantilla de analisis de SQC, consulte Crear una plantilla de analisis de SQC.
6. Opcional. Utilice la pestana Plantillas de reglas de notificación para seleccionar o crear una
plantilla de regla de nótificación para la plantilla de elemento. Para obtener mas
infórmación, consulte Crear plantilla de regla de nótificación.
7. Para guardar su trabajo, presione CTRL+G o haga clic en Ingresar.
Encontrar referencias de plantillas
Encuentre dónde se utiliza una plantilla en PI System Explorer.
Procedimiento
1. En el navegador Biblioteca, elija una de las siguientes acciones:
◦ Para encontrar una plantilla de elementos, expanda Plantillas > Plantillas de elementos y
seleccione una plantilla.
◦ Para encontrar una plantilla de event frame, expanda Plantillas > Plantillas de event
frame y seleccione una plantilla.
2. Elija una de las opciones siguientes:
Para encontrar...
Haga lo siguiente…
Plantillas derivadas
Haga clic en Plantillas derivadas.
La ventana Buscar plantillas derivadas para
Element_Template muestra todas las plantillas de
elementos que tienen la plantilla de elementos
seleccionada como su plantilla base. La lista
tambien incluye plantillas de elementos que
estan derivadas indirectamente de la plantilla
seleccionada, a traves de multiples plantillas.
122
Guía del usuario PI System Explorer
Representación de activos en PI AF
Elementos creados desde la plantilla
Haga clic en Elementos.
La ventana Find Elements for Element_Template
(Buscar elementos para) muestra todos los
elementos, los modelos, las transferencias y los
marcos de evento que han sido creados
directamente desde la plantilla de elementos
seleccionada.
Nota:
Para mostrar la ruta completa a los
elementos, haga clic con el bótón
secundario en el encabezado de columna (o
debajo de la cuadrícula de resultados de
busqueda) y luego haga clic en Mostrar
rutas completas.
Elementos derivados de la plantilla
Haga clic en Elementos derivados.
La ventana Find Derived Elements for
Element_Template (Buscar elementos derivados
para) muestra todos los elementos, los modelos,
las transferencias y los marcos de evento que han
sido creados desde la plantilla de elementos
seleccionada, así como desde cualquier plantilla
derivada de ella.
Nota:
Para mostrar la ruta completa a los
elementos derivados, haga clic con el bótón
secundario en el encabezado de columna (o
debajo de la cuadrícula de resultados de
busqueda) y luego haga clic en Mostrar
rutas completas.
Plantillas principales referenciadas
Haga clic en Plantillas principales referenciadas.
La ventana Buscar plantillas primarias
referenciadas para Element_Template muestra las
plantillas de elementos que se han vinculado
específicamente a esta plantilla de elementos
principal a traves de un tipo de referencia. La
lista de plantillas incluye aquellas que se han
vinculado indirectamente a traves de una
plantilla heredada.
Plantillas secundarias referenciadas
Haga clic en Plantillas secundarias referenciadas.
La ventana Buscar plantillas hijas referenciadas
para Element_Template muestra las plantillas de
elementos que se han vinculado específicamente
a esta plantilla de elementos secundaria
mediante un tipo de referencia. La lista de
plantillas incluye aquellas que se han vinculado
indirectamente a traves de una plantilla
heredada.
Guía del usuario PI System Explorer
123
Representación de activos en PI AF
Event Frames creados desde la plantilla
Haga clic en Event Frames.
La ventana Buscar marcos de evento para
Event_Frame_Template muestra todos los marcos
de evento que se han creado directamente desde
la plantilla de marcos de evento seleccionada.
Nota:
Para mostrar la ruta completa a los marcos
de evento, haga clic con el bótón secundario
en el encabezado de columna (o debajo de
la cuadrícula de resultados de busqueda) y
luego haga clic en Mostrar rutas completas.
Event frames derivados de la plantilla
Haga clic en Event Frames derivados.
La ventana Find Derived Event Frames for
Event_Frame_Template (Buscar marcos de evento
derivados para) muestra todos los marcos de
evento que se han creado desde la plantilla
seleccionada, así como cualquier plantilla
derivada.
Nota:
Para mostrar la ruta completa a los marcos
de evento derivados, haga clic con el bótón
secundario en el encabezado de columna (o
debajo de la cuadrícula de resultados de
busqueda) y luego haga clic en Mostrar
rutas completas.
Definir plantillas para otros objetos
Ademas de las plantillas de elementos, puede crear plantillas base para event frames, modelos
y transferencias. Una vez que una plantilla base ha sido disenada, puede crear plantillas
derivadas a partir de esta y luego asignar atributos adicionales segun las necesidades. A
cóntinuación, puede crear instancias del objeto basandólas en la plantilla derivada. Para
obtener mas infórmación, consulte Plantillas base y derivadas.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, abra Plantillas para mostrar las siguientes colecciones de
objetos:
◦ Plantillas de elementos
◦ Plantillas de Event Frames
◦ Plantillas de modelos
◦ Plantillas de transferencia
3. Haga clic con el bótón secundario sobre la cólección de objetos y seleccione Nueva plantilla.
La nueva plantilla muestra las siguientes pestanas:
◦ General
◦ Plantillas de atributos
◦ Puertos (no esta disponible para plantillas de event frames)
124
Guía del usuario PI System Explorer
Representación de activos en PI AF
Nota:
Para asegurarse de que ciertas plantillas no se utilicen directamente para crear
objetos, puede asignar la propiedad Plantilla base únicamente (BTO) a una plantilla
nueva. Las plantillas BTO se pueden utilizar para crear plantillas derivadas. Cuando se
crea una instancia de un objeto, se basa en la plantilla derivada, no en la plantilla BTO.
4. Complete estas pestanas como lo haría con una plantilla de elementos. Consulte Crear
plantillas de elementos.
5. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Plantillas secundarias
En algunos ocasiones, es posible que desee crear una plantilla que tenga una o varias plantillas
secundarias. Por ejemplo, supongamos que tiene una plantilla que representa un motor y desea
una plantilla independiente para el ciguenal. Desea que la plantilla del ciguenal sea una
plantilla secundaria de la del motor. No pódra crear directamente una plantilla secundaria de la
misma forma que un elemento secundario. En su lugar, debe crear una nueva plantilla
referenciada debajo de la plantilla Motor.
Esto tambien crea un nuevo tipo de referencia en la cólección Tipos de referencia.
Ahora, suponga que crea un elemento basado en la plantilla Motor. PI System Explorer no crea
de forma autómatica el elemento secundario, Shaft. Sin embargo, cuando cree de forma
manual un elemento secundario en el elemento motor, el tipo de referencia Motor-Shaft
aparecera en la lista de tipos de referencia y la plantilla Shaft aparecera en la lista Plantilla de
elementos.
Crear referencias de plantilla secundaria
Cree una referencia de plantilla secundaria cuando necesite establecer relaciones principalsecundaria entre dos plantillas.
Procedimiento
1. En el navegador Biblioteca, haga clic con el bótón secundario sobre la plantilla a la que desee
anadir la referencia de plantilla secundaria y luego haga clic en Nuevo > Nueva plantilla de
referencia.
2. En la ventana Definir nombre de plantilla de elemento de referencia, escriba un nombre
para la plantilla secundaria y haga clic en Aceptar. Se creara una plantilla secundaria en la
cólección Plantillas y un nuevo tipo de referencia en la cólección Tipos de referencia.
3. Opcional. Para definir un tipo de referencia distinto de principal-secundaria, seleccione la
casilla de verificación Editar tipo de referencia.
Guía del usuario PI System Explorer
125
Representación de activos en PI AF
a. En la ventana Propiedades de tipo de referencia, seleccione la fortaleza deseada de la
referencia en la lista Fortaleza de la referencia.
b. Haga clic en Ingresar.
c. Haga clic en Aceptar para cerrar la ventana.
4. Complete la definición de la plantilla de elemento, tal como se describe en Crear plantillas
de elementos.
Representación de activos con elementos
En el modelo de activos, los elementos representan objetos físicós, como las bombas o los
tanques. Cada elemento tiene asociados atributos que almacenan propiedades y datos de ese
elemento. Por lo general, base los elementos en plantillas. Por ejemplo, base cada elemento de
bomba en una plantilla de bomba.
En esta sección
• Crear elementos a partir de una plantilla
• Crear elementos sin basarse en una plantilla
• Localizar dónde se utiliza un elemento
• Eliminación de elementos
• Restablecer valor del atributo a sus propiedades originales
• Convertir elementos existentes en plantillas de elementos
• Cambiar plantillas de elementos
Crear elementos a partir de una plantilla
Utilice plantillas de elementos que haya definidó para crear elementos en su jerarquía de
activos.
Procedimiento
1. En el navegador Elementos, haga clic con el bótón secundario en la cólección de elementos o
en un solo elemento y luego haga clic en Nuevo elemento.
2. En la ventana Elegir plantilla de elementos, seleccione una plantilla de elementos en el
campo Plantilla de elementos.
3. En el campo Añadir elemento hijo utilizando el tipo de referencia, seleccione un tipo de
referencia de la lista de tipos disponibles.
Los tipos de referencia disponibles dependen de la plantilla de elementos seleccionada y de
los tipos de referencia definidós en la base de datos. Si no esta seguro de que tipo de
referencia utilizar, seleccione el tipo predeterminado: principal-secundario.
4. Haga clic en Aceptar.
Las pestanas de propiedades del nuevo elemento se móstraran en el visor. Como el elemento
se basa en una plantilla, la mayóría de los campos de la pestana General seran de solo
lectura (atenuados o con almohadillas).
5. En los campos Nombre y Descripción, introduzca un nombre y una descripción para el
elemento.
6. Opcional. Realice las siguientes acciones segun proceda.
126
Guía del usuario PI System Explorer
Representación de activos en PI AF
◦ Haga clic en el vínculó Propiedades ampliadas para crear propiedades para aplicaciones
cliente como PI ProcessBook y PI WebParts. Para obtener mas infórmación, consulte
Almacenamiento de infórmación específica para cada aplicación.
◦ Haga clic en el vínculó Ubicación para cónfigurar las características del atributo de
ubicación para el elemento. Para obtener mas infórmación, consulte Cónfigurar
características del atributo de ubicación.
◦ Haga clic en el vínculó Anotaciones para introducir una nota para el elemento. Para
obtener mas infórmación, consulte Anotaciones de elementos.
◦ Haga clic en el vínculó Seguridad para cónfigurar permisos de acceso personalizados
para el elemento. Para obtener mas infórmación, consulte Seguridad de objetos de PI AF.
7. Opcional. Haga clic en la pestana Atributos para consultar los atributos definidós por la
plantilla. No pódra anadir atributos nuevos salvo que la plantilla admita ampliaciones.
8. Opcional. Haga clic en la pestana Reglas de notificación para revisar las reglas de
nótificación definidas por la plantilla. No pódra anadir reglas de nótificación nuevas a menos
que la plantilla admita ampliaciones.
9. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Crear elementos sin basarse en una plantilla
Pese a que es posible crear elementos no basados en una plantilla, OSIsoft recomienda en
ultima instancia basarlos en plantillas para poder disfrutar de las potentes funciones basadas
en plantillas disponibles en las aplicaciones cliente. Puede utilizar la función Convertir a
plantilla, como se describe en Convertir elementos existentes en plantillas de elementos.
Procedimiento
1. En el navegador Elementos, haga clic con el bótón secundario en la cólección de elementos o
en un solo elemento y luego haga clic en Nuevo elemento.
2. En la ventana Seleccionar plantilla de elemento, seleccione un tipo de referencia en el
campo Añadir elemento hijo utilizando el tipo de referencia.
Los tipos de referencia disponibles dependen de la plantilla de elementos y de los tipos de
referencia definidós en la base de datos. Si no esta seguro de que tipo de referencia utilizar,
seguramente lo mas conveniente sea el tipo predeterminado: principal-secundario.
3. En el campo Plantilla de elemento, haga clic en <None>.
4. Haga clic en OK.
Las pestanas de propiedades del nuevo elemento se móstraran en el visor.
◦ Utilice la pestana General para realizar la cónfiguración de elementos basica.
◦ La pestana Elementos secundarios se utiliza principalmente para ver elementos
secundarios existentes en un elemento disponible. Tambien puede crear elementos
secundarios directamente desde esta pestana.
◦ Utilice la pestana Atributos para crear un atributo para cada propiedad o elemento de
datos.
◦ Utilice la pestana Puertos solo si esta modelando un proceso.
◦ Utilice la pestana Análisis para seleccionar un analisis para el elemento.
◦ Utilice la pestana Reglas de notificación para seleccionar una regla de nótificación para el
elemento.
◦ Utilice la pestana Versión para anadir la infórmación de versión de un elemento.
Guía del usuario PI System Explorer
127
Representación de activos en PI AF
5. Opcional. Realice las siguientes acciones segun proceda.
◦ Haga clic en el vínculó Propiedades ampliadas para crear propiedades para aplicaciones
cliente como PI ProcessBook y PI WebParts. Para obtener mas infórmación, consulte
Almacenamiento de infórmación específica para cada aplicación.
◦ Haga clic en el vínculó Anotaciones para introducir una nota para el elemento. Para
obtener mas infórmación, consulte Anotaciones de elementos.
◦ Haga clic en el vínculó Seguridad para cónfigurar permisos de acceso personalizados
para el elemento. Para obtener mas infórmación, consulte Seguridad de objetos de PI AF.
6. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Localizar dónde se utiliza un elemento
Utilice los vínculós Encontrar de la pestana General de un elemento seleccionado para localizar
dónde y cómó se utiliza en el modelo de activos.
Procedimiento
1. Seleccione un elemento en el navegador Elementos.
2. Elija una de las opciones siguientes:
Para encontrar...
Haga lo siguiente…
Elementos primarios
Haga clic en el vínculó Primarios. Se abrira la
ventana Primarios de Element.
Elementos hijo
a. Haga clic en el vínculó Secundarios.
b. En la ventana Búsqueda de elementos,
introduzca el texto del nombre del elemento
en el campo de busqueda. Para refinar su
busqueda, puede introducir criterios
adicionales en la sección Criterios.
c. Haga clic en Buscar.
Se muestran los elementos coincidentes en la
sección Resultados.
Event frames conectados al elemento
Haga clic en el vínculó Event Frames.
◦ Si se encuentra una coincidencia, Buscar
marcos de evento para Element muestra una
lista de todos los marcos de evento que hacen
referencia al elemento.
◦ Si no se encuentra ninguna coincidencia, se
móstrara el mensaje No Event Frames
Found.
Eliminación de elementos
Al eliminar un elemento, PI AF elimina de forma autómatica las nótificaciónes y los analisis que
tienen como destino ese elemento. Si desea reasignar una nótificación vinculada a un elemento
que tiene previsto eliminar, hagaló antes de eliminar el elemento.
Tambien puede cambiar el comportamiento predeterminado para que PI AF no elimine de
forma autómatica nótificaciónes y analisis cuando elimina el elemento de destino.
Utilice la utilidad de línea de comandos afdiag con el parametró /
EnablePropagationOfTargetDeletion, tal como se describe en Parametrós de la utilidad
AFDiag:
afdiag /EnablePropagationOfTargetDeletion-
128
Guía del usuario PI System Explorer
Representación de activos en PI AF
Tenga en cuenta que la desactivación del ajuste puede originar algunos problemas, como:
• Las nótificaciónes quedan abiertas (permanecen activas)
• No se crean nótificaciónes nuevas
• No se envían los correos electrónicós previstos
Restablecer valor del atributo a sus propiedades originales
Si creó elementos en función de plantillas en un entorno de prueba y luego desea transferir su
trabajo a un entorno de próducción, puede restablecer todos los atributos de un elemento a sus
propiedades originales, como se define en una plantilla. Puede hacer clic con el bótón
secundario sobre el atributo de un elemento y luego hacer clic en Restablecer a plantilla.
Por ejemplo, supongamos que cónfigura un atributo de PI AF para utilizar el nombre de PI Data
Archive como parte de la cónfiguración del atributo en un entorno de prueba. Puede que desee
que esto se refleje en el nuevo nombre de PI Data Archive cuando transfiera su trabajo a un
entorno de próducción.
Convertir elementos existentes en plantillas de elementos
OSIsoft recomienda basar los elementos en plantillas. Si ha creado elementos y atributos y no
los basó originalmente en una plantilla, pódra convertirlos mas adelante a una plantilla.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, busque el elemento que desee convertir a una plantilla.
3. Haga clic con el bótón secundario en el elemento y haga clic en Convertir > Convertir a
plantilla.
Se creara una plantilla llamada ElementNamePlantilla y se móstrara en el campo Plantilla de
la pestana General.
4. Opcional. Para cambiar el nombre de una plantilla, haga clic en Biblioteca en el navegador.
a. En el navegador Biblioteca, busque la nueva plantilla en la rama Plantillas de elementos.
b. Haga clic con el bótón secundario en la plantilla y haga clic en Renombrar.
c. Módifique el nombre predeterminado como corresponda. El nuevo nombre debe ser
unicó en todas las plantillas.
Cambiar plantillas de elementos
Puede cambiar la plantilla en la que un elemento existente esta basado o anadir una plantilla a
un elemento que no este basado actualmente en una plantilla.
Antes de empezar
Tenga cuidado al cambiar una plantilla de elemento, ya que puede haber consecuencias no
deseadas. Por ejemplo, es posible que se eliminen atributos si se definierón con la plantilla
antigua y no se encuentran presentes en la nueva. Asegurese de que los atributos con el mismo
nombre de las plantillas antigua y nueva tengan el mismo tipo de datos.
Guía del usuario PI System Explorer
129
Representación de activos en PI AF
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, haga clic con el bótón secundario sobre el elemento que desee
módificar y luego haga clic en Convertir > Cambiar plantilla.
3. En la ventana Elegir plantilla de elementos, seleccione una plantilla de la lista Plantilla de
elementos.
a. Opcional. Para mostrar solo las plantillas en una categóría específica, seleccione una
categóría de la lista Plantillas de categoría.
4. Haga clic en Aceptar.
Almacenamiento de información específica para cada
aplicación
Las propiedades extendidas son propiedades que otras aplicaciones definen en objetos de PI
AF. Por ejemplo, PI WebParts almacena Icono y URL en las propiedades extendidas de un
elemento de PI AF. Las aplicaciones acceden, por lo general, a la infórmación almacenada en la
ventana Propiedades extendidas mediante prógramación con AF SDK.
Hay un enlace a Propiedades extendidas en la pestana General de muchos tipos de objeto en PI
System Explorer. Este enlace puede utilizarse para cónfigurar una propiedad adicional o mas
para un objeto.
Nota:
Los usuarios no necesitan utilizar esta característica avanzada de PI AF.
Crear propiedades extendidas
En general, las aplicaciones cliente, como PI WebParts y PI ProcessBook, utilizan la
característica Propiedades extendidas para escribir propiedades, y los usuarios no necesitan
utilizar esta característica avanzada.
Procedimiento
1. Haga clic en el vínculó Propiedades extendidas.
2. En la ventana Propiedades extendidas, elija una de las siguientes acciones:
◦ Para crear la primera propiedad extendida, haga clic en el vínculó Nueva propiedad
extendida.
◦ Para crear una propiedad extendida adicional, haga clic con el bótón secundario en la
columna Nombre y seleccione Nueva propiedad extendida.
3. En el campo Nombre, elimine el texto predeterminado y escriba el nombre de la propiedad
extendida.
4. Haga clic en el campo Valor y elija una de las siguientes acciones:
◦ Introduzca una cadena. Para visualizar el texto que esta escribiendo, presione F2 y
escriba en la ventana Visualizador de texto.
◦ Haga clic en
130
y seleccione de la lista de Tipos básicos, Tipos de matriz y Objetos.
Guía del usuario PI System Explorer
Representación de activos en PI AF
▪ Si elige un objeto, como Atributo o Elemento, haga clic en
deseado.
▪ Si elige Archivo, haga clic en
y encuentre el objeto
y seleccione Cargar para encontrar el archivo deseado.
5. Haga clic en Cerrar.
Guía del usuario PI System Explorer
131
Representación de activos en PI AF
132
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Para asociar datos con un activo, se crean atributos en el elemento que representa ese activo.
Los atributos pueden incluir valores simples, que representan infórmación fija, como el
diametró de un tanque. Tambien pueden contener valores de PI point, derivarse de fórmulas, o
contener datos desde fuera de PI System mediante el uso de tablas de PI AF.
Conjuntos de enumeración
Si necesita un atributo para mantener solo los valores predefinidós, puede utilizar un conjunto
de enumeraciones. Un conjunto de enumeración correlaciona un conjunto ordenado de valores
de constante definidós por el usuario con un conjunto de cadenas. Puede utilizar las cadenas
para proporcionar un texto breve y descriptivo para usar con su modelo de PI AF.
Videos
Para obtener infórmación sobre cómó crear atributos de elemento, mire este video:
https://www.youtube.com/watch?v=pLmIPOOIcEw&rel=0
Para obtener infórmación sobre cómó crear atributos secundarios, mire este video:
https://www.youtube.com/watch?v=BiXA13ptVTM&rel=0
En esta sección
• Plantillas de atributos
• Conjuntos de enumeración en PI AF
Plantillas de atributos
Las plantillas de atributos estan asociadas con plantillas de elementos. Al igual que una
plantilla de elementos representa un tipo de activo, una plantilla de atributos representa un
tipo de cónfiguración de datos. Cuando se crea una instancia de la plantilla de elementos, ese
elemento contiene un atributo para cada plantilla de atributos. Estos atributos heredan todas
las propiedades cónfiguradas en la plantilla de atributos.
En lugar de crear atributos en cada elemento, OSIsoft recomienda crear plantillas de atributos
en una plantilla de elementos. Cuando cree elementos basados en esa plantilla, PI AF creara
autómaticamente los atributos por usted. Aun así, debe dar un valor a cada atributo.
Modificación de descripciones de atributos creadas a partir de plantillas de atributos
A partir de la versión 2017 R2, es posible módificar las descripciones de atributos creadas a
partir de una plantilla. Esto puede resultar util al diferenciar atributos que usan la misma
plantilla de atributo. Por ejemplo, en una serie de bombas, cada bomba tiene un atributo
Flowrate con una referencia de datos de PI Point. La descripción de la plantilla para Flowrate
es, sencillamente, Pump flowrate. Para que esa descripción sea unica en cada instancia de la
bomba, puede usar PI Builder para cargar el atributo descriptor para cada PI point de caudal
de la bomba e incorporar el valor en cada descripción de Flowrate y, de ese modo,
personalizar cada instancia.
Para módificar descripciones creadas a partir de una plantilla de atributo, debe usar un cliente
y un servidor de PI AF que ejecuten la versión 2017 R2 de PI AF o una versión posterior. Los
clientes anteriores que se conecten a un servidor de PI AF que ejecute la versión 2017 R2 o una
versión posterior cóntinuaran viendo solamente la descripción de la plantilla de atributo.
Guía del usuario PI System Explorer
133
Asociación de datos con activos de PI AF
Nota:
Dado que se utiliza memoria adicional para almacenar descripciones de atributos que se
anularon, cargarlas en aplicaciones cliente puede demorar un poco mas.
Video
Para obtener infórmación sobre cómó crear plantillas de atributos, mire este video:
https://www.youtube.com/watch?v=dCx5_Aw5x24&rel=0
Propiedades de atributos
Debe cónfigurar las propiedades para cada atributo del elemento. Despues de asignar las
propiedades en una plantilla de atributos, los usuarios solo pueden módificar la propiedad
Excluido de los atributos individuales.
En esta sección
• Propiedad de atributo de elemento de cónfiguración
• Propiedad de atributo apagado
• Propiedad de atributo oculto
• Propiedad de atributos indexados
• Propiedad de atributos de entrada de datos manual
Propiedad de atributo de elemento de configuración
Usted puede asignar la propiedad Elemento de configuración a un atributo que representa
propiedades inherentes de un activo. Cualquier atributo con un valor constante puede ser un
elemento de cónfiguración. Dado que el valor de atributo de un elemento de cónfiguración se
presupone constante, PI System Explorer extrae de forma autómatica el atributo cuando se
módifica el valor de atributo. Para cónfirmar el cambio, tendra que insertarlo. En PI System
Explorer, los atributos de cónfiguración estan marcados con un icono de lapiz ( ).
Los atributos con valores que cambian, como las referencias de datos de PI point, o las
referencias de datos de fórmula, no deben ser atributos de cónfiguración. Cuando se módifica el
valor de un atributo que no es de cónfiguración, PI System Explorer no extrae el atributo. Por
ejemplo, supongamos que tiene un elemento que representa un tanque. El elemento tiene los
siguientes atributos:
•
fabricante
•
foto (archivo)
•
numeró de serie
•
valor de temperatura maximó
•
volumen maximó
• temperatura (referencia de datos de PI point)
• volumen (referencia de datos de PI point)
Habitualmente, los cinco primeros atributos serían elementos de cónfiguración, ya que estos
valores no cambiaran a menos que cambie el equipo. Los dos ultimós atributos no serían
elementos de cónfiguración, porque los valores cambian con el tiempo.
134
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Propiedad de atributo apagado
Se excluye un atributo en situaciones en las que no todos los atributos en una plantilla de
elementos aplican. Por ejemplo, suponga que tiene cinco plantillas de atributos definidas en
una plantilla de elementos denominada Meter, la cual utiliza para crear elementos que
representan diversos tipos diferentes de medidores que se usan en sus instalaciones. En
algunos tipos de medidores (meterA), solo se pueden aplicar tres atributos de la plantilla
Meter, mientras que en la restante (meterB) se aplican los cinco atributos. En medidores de
tipo A, debe seleccionar la propiedad Excluido para los dos atributos que no se pueden aplicar.
Para todos los própósitós practicós, esos dos atributos "parecen" inexistentes para la mayóría
de las aplicaciones cliente de PI AF ya que las busquedas recuperan el valor No Result del
estado digital.
Nota:
Un atributo excluido no se puede utilizar para devolver elementos y event frames que
estan referenciados por el valor de un atributo excluido.
Cuando la propiedad Excluido se asigna en una plantilla de atributos, la propiedad es indicada
junto al nombre del atributo si se habilita la ópción Mostrar atributos excluidos. Los
por
atributos que derivan de esa plantilla aparecen en la pestana Atributos de un elemento con
en la columna Plantilla y Excluido en la columna Valor. Puede alternar la visualización de dichos
atributos con el comando Ocultar atributos excluidos y Mostrar atributos excluidos en el menu
contextual de la pestana Atributos. Tenga en cuenta que cuando se habilita la ópción Mostrar
atributos excluidos, los usuarios pueden cambiar la cónfiguración de la propiedad Excluido de
un atributo desde la cónfiguración que se le asignó en una plantilla de atributos.
Como alternativa, puede borrar la ópción Mostrar atributos excluidos en Herramientas >
Opciones para ocultar los atributos excluidos por todas partes en PI System Explorer. Cuando
los atributos estan ocultos, el mensaje Excluded attributes are hidden se muestra en la
pestana Atributos.
Propiedad de atributo oculto
Un atributo oculto es uno que no puede ser recuperado en busquedas desde aplicaciones
cliente de PI AF como PI Vision. Esta propiedad es util si se utiliza un atributo para albergar un
resultado intermedio, como un resultado de busqueda de tabla (Table lookup) que se puede
recuperar mediante una referencia de datos de PI point, o si se utiliza solamente para rellenar
un nombre de PI point en un parametró de sustitución.
Tambien puede ser util para cónfigurar la propiedad de un atributo a Oculto en una plantilla
cuando no se ha completado completamente la cónfiguración en el propio elemento. Por
ejemplo, los elementos se crean a partir de una plantilla con una referencia de datos de PI
point, pero debido a que algunos instrumentos no se encuentran, los PI point aun no existen
para todos los elementos. Al cónfigurar los atributos para la instrumentación faltante como
Oculto, se evita que una aplicación cliente de PI AF obtenga un resultado de error de una
busqueda.
Cuando se asigna la propiedad Oculto a un atributo en una plantilla de atributos, la propiedad
es indicada por en la columna Oculto junto al nombre del atributo. Cuando la plantilla se
asigna a un elemento, el mismo icono se muestra junto al nombre del atributo en la pestana
Atributos.
Propiedad de atributos indexados
Un atributo se indexa para optimizarlo y obtener resultados rapidós y recuperar valores
rapidamente. Los índices solo mejoran el rendimiento de los atributos cuyos valores esten
Guía del usuario PI System Explorer
135
Asociación de datos con activos de PI AF
almacenados en una base de datos de PI AF. Esto significa que no obtiene ningun benefició por
indexar atributos que obtienen sus valores de las referencias de datos, como es el caso de los PI
Points y las tablas vinculadas. Sin embargo, en el caso de los event frames, cuando se captan los
valores de atributo, estos se escriben en el servidor PI AF y, como resultado, se pueden
beneficiar de la indexación.
Nota:
En las busquedas, solo se utilizan los primeros 40 caracteres de atributos indexados con
un tipo de valor de Cadena.
Cuando se indexa un atributo, tanto el atributo como el valor de atributo se devuelven con mas
rapidez en las busquedas. Sin embargo, los atributos indexados aumentan el tamanó de la tabla
de la base de datos de PI AF y originan algo de carga de la CPU en el servidor SQL. Los atributos
indexados se marcan con el icono .
Habitualmente, se indexa un atributo que se cree que los usuarios tienden a buscar con
frecuencia. Por ejemplo, si desea localizar activos buscando por su numeró de serie, debería
indexar el atributo de numeró de serie.
Propiedad de atributos de entrada de datos manual
Se asigna un indicador a un atributo de entrada de datos manual para que las aplicaciones
cliente (como PI Vision y PI Manual Logger) puedan guiar a los usuarios para introducir datos
para ese atributo. Por ejemplo, en una futura versión de PI Manual Logger, esta propiedad
identificara tags en una ronda que los operadores deberan recopilar manualmente, a diferencia
de los tags que se recopilan autómaticamente a traves de una interfaz o de un conector.
Para determinar que atributos tienen esta propiedad, agregue la columna Entrada manual de
datos a una cuadrícula de atributo en el visor Elementos, donde los atributos con esta
propiedad se muestran como True.
Características de atributos
Las características de atributos identifican rasgos comunes de un atributo principal o
comportamientos relacionados. PI AF es compatible con características de atributos para
condiciones limitadas, valores previstos, infórmación de geólócalización, códigós de motivo,
estado del activo y activadores de inicio de analisis. Entonces, los usuarios y las aplicaciones
cliente, como PI Vision pueden encontrar, mostrar y analizar estos atributos relacionados mas
eficazmente.
Para establecer características de atributos y acceder a ellas, el cliente PI AF y el servidor deben
ejecutar PI AF 2016 o posterior.
Características de atributos límite
Se utilizan características de atributos límite para identificar el intervalo esperado de una
variable de proceso o de un atributo de medida. Las características de atributos límite suelen
definirse en otro lugar (por ejemplo, en un sistema de control) o representar propiedades
inherentes del atributo principal, como la temperatura. Un uso típicó sería cónfigurar
condiciones para una alarma. PI Vision, por ejemplo, utiliza la mayóría de los atributos límite
como entrada a la hora de cónfigurar comportamientos de varios estados para una alarma
visual.
Las característica de atributo límite son atributos secundarios de la medición que describen y
presentan el mismo tipo de valor y unidades de medida que el principal. La unica excepción se
da cuando el valor de una característica de atributo límite se obtiene a partir de una referencia
de datos, caso en el cual las unidades de medida de origen de una referencia de datos definida
136
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
pueden ser diferentes. Ademas, solo se pueden definir características de atributo límite para
atributos principales que sean numericós. Solo es posible asignar una característica de atributo
límite una vez a un atributo principal.
Se definen las siguientes características de atributo límite:
Característica de
atributo límite
Description
Mínimó
Indica el valor de medición o la salida de proceso mas bajos posibles.
LoLo
Indica un valor de medición o una salida de proceso muy bajos, normalmente de
caracter anómaló e iniciadores de una alarma.
Lo
Indica un valor de medición o una salida de proceso bajos, normalmente
iniciadores de una alarma.
Destino
Indica el valor de medición o la salida de proceso objetivo.
Hi
Indica un valor de medición o una salida de proceso altos, normalmente
iniciadores de una advertencia.
HiHi
Indica un valor de medición o una salida de proceso muy altos, normalmente de
caracter anómaló e iniciadores de una alarma.
Maximó
Indica el valor de medición o la salida de proceso mas altos posibles.
Video
Para obtener infórmación sobre cómó establecer características límite del atributo, mire este
video:
https://www.youtube.com/watch?v=jO2dVYsBvds&rel=0
Características de atributos de pronóstico
En general, las características de atributo de prónósticó se utilizan como valores previstos para
comparar con el valor real del atributo principal. Normalmente, dichas características de
atributo representan futuros PI points, si bien esto no es un requisito. Las aplicaciones cliente
pueden relacionar muy facilmente estos atributos y tendencias entre sí.
Las características de atributo de prónósticó son atributos secundarios del atributo que
describen y presentan el mismo tipo de valor y unidades de medida que el principal. La unica
excepción se da cuando el valor de una característica de atributo de prónósticó se obtiene a
partir de una referencia de datos, caso en el cual las unidades de medida de origen de una
referencia de datos definida pueden ser diferentes. Ademas, se pueden crear características de
atributo de prónósticó para atributos principales de cualquier tipo de valor. Es posible tener
varias características de atributo de prónósticó definidas para un atributo principal.
Características de los atributos de ubicación
Puede utilizar los atributos de ubicación para definir la infórmación sobre longitud, latitud y
altitud de un activo. Puede usar esta infórmación para identificar la ubicación del activo en un
mapa.
Puede crear características de los atributos de ubicación en un elemento, un Event Frame, un
modelo o en sus atributos secundarios. Sin embargo, puede crear solo una de cada
característica de atributo por elemento, Event Frame o modelo. La UOM para las características
del atributo de longitud y latitud debe ser grados (la unidad predeterminada) o al menos un
anguló en el que la característica del atributo de altitud puede ser metro (la unidad
predeterminada) u otra UOM de la clase de longitud. El tipo de valor para todas las
características de los atributos de ubicación debe ser numericó (doble).
Guía del usuario PI System Explorer
137
Asociación de datos con activos de PI AF
Características de los atributos de razón
Las características de los atributos de motivo se usan en los Event Frames y las transferencias
para permitirles a los usuarios elegir un códigó de motivo en el caso de excursiones, tiempo de
inactividad y otros eventos. Es posible establecer una sola característica del atributo de motivo
en una plantilla de Event Frame o de transferencia, o en una instancia de Event Frame o
transferencia. La característica del atributo de razón debe ser un conjunto de enumeración
definidó con anterioridad o un conjunto de enumeración del sistema entregado con PI AF.
Características de los atributos de estado
Es posible usar características de atributos de estado en elementos y modelos para permitirles
a los usuarios establecer un puntaje de estado numericó y un estado (por ejemplo, en buen
estado, fuera de servicio, en mantenimiento, con advertencia o con error). La característica del
atributo HealthStatus usa valores del conjunto de enumeración Estado que se suministra con PI
AF. Los administradores pueden módificar el conjunto de enumeración Estado segun lo
necesiten.
Características de atributo activador de inicio de análisis
Cuando los usuarios cónfiguran analisis para generar event frames, pueden decidir
opcionalmente almacenar el nombre del start trigger en el valor de un atributo (cadena) y
marcarlo con la característica de atributo start trigger de analisis. Gracias a ello, clientes como
PI Vision pueden indicar el activador de inicio que creó ese marco de evento concreto. Para
obtener mas infórmación, consulte Analisis de generación de marcos de evento.
En esta sección
• Establecer características de atributo límite
• Establecer características de atributo de prónósticó
• Cónfigurar características del atributo de ubicación
• Cónfigurar características del atributo de razón
• Ajustar características del atributo de estado
Establecer características de atributo límite
Puede cónfigurar hasta siete características límite para una plantilla de atributo o un atributo
de elemento con el fin de permitir a los usuarios definir el intervalo esperado de una variable o
medida de proceso.
Procedimiento
1. Elija una de las siguientes acciones:
Para establecer una característica límite para...
Haga lo siguiente…
Plantillas de atributos
a. En el navegador Biblioteca, seleccione una
plantilla de elementos.
b. En el visor, haga clic en la pestana Plantillas
de atributos.
Atributos de elementos
a. En el navegador Elementos, seleccione un
elemento.
b. En el visor, haga clic en la pestana Atributos.
2. Seleccione el atributo para el que desea establecer una o varias características límite.
3. Seleccione una de las siguientes acciones:
138
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
◦ Haga clic con el bótón secundario y haga clic en Límites.
◦ En la parte inferior del area de cónfiguración, haga clic en el vínculó Límites.
4. En la ventana Límites, seleccione la casilla junto a la característica límite que desee
establecer.
5. En Atributo, seleccione una de las siguientes acciones:
◦ Deje tal cual el atributo predeterminado.
◦ Cambie el nombre del atributo predeterminado por otro nombre de su elección.
◦ Si ya hay un atributo secundario que desea asignar a la característica límite, seleccióneló
en la lista desplegable.
Nota:
Las características de atributo límite ya definidas se muestran en negrita.
6. Elija una de las siguientes acciones:
Para configurar...
Haga lo siguiente…
El valor de la característica límite
En Valor, introduzca un valor límite.
El valor de la característica límite de una
referencia de datos
a. En Referencia de datos, seleccione un tipo de
referencia de datos.
b. En Ajustes, haga clic en
para cónfigurar la
referencia de datos.
Nota:
Las unidades de medida de origen de una
referencia de datos pueden ser distintas de
las del atributo principal.
c. Haga clic en Aceptar para cerrar la ventana
de referencia de datos.
Se móstrara el resultado de la referencia de datos
evaluada.
7. Repita los pasos del 4 al 6 para establecer valores para otras características límite.
8. Haga clic en Aceptar cuando su lista de características límite para el atributo principal
seleccionado este completa.
Establecer características de atributo de pronóstico
Cónfigure una o varias características de atributo de prónósticó para una plantilla de atributo o
un atributo de elemento para que los usuarios y las aplicaciones cliente puedan comparar los
valores pronosticados con valores actuales y trazar una tendencia.
Procedimiento
1. Elija una de las siguientes acciones:
Para establecer una característica de pronóstico
para...
Haga lo siguiente…
Plantillas de atributos
a. En el navegador Biblioteca, seleccione una
plantilla de elementos.
b. En el visor, haga clic en la pestana Plantillas
de atributos.
Guía del usuario PI System Explorer
139
Asociación de datos con activos de PI AF
Atributos de elementos
a. En el navegador Elementos, seleccione un
elemento.
b. En el visor, haga clic en la pestana Atributos.
2. Seleccione el atributo para el que desea establecer una o varias características de
prónósticó.
3. Seleccione una de las siguientes acciones:
◦ Haga clic con el bótón secundario y haga clic en Pronósticos.
◦ En la parte inferior del area de cónfiguración, haga clic en el vínculó Pronósticos.
4. En la ventana Pronósticos, haga clic en el bótón o vínculó Nuevo pronóstico.
5. En Atributo, seleccione una de las siguientes acciones:
◦ Deje tal cual el atributo predeterminado.
◦ Cambie el nombre del atributo predeterminado por otro nombre de su elección.
◦ Si ya hay un atributo secundario que desea asignar a la característica de prónósticó,
seleccióneló en la lista desplegable.
Nota:
Las características de atributo de prónósticó ya definidas se muestran en negrita.
6. Elija una de las siguientes acciones:
Para configurar...
Haga lo siguiente…
El valor de la característica de prónósticó
En Valor, introduzca un valor de prónósticó.
El valor de una referencia de datos
a. En Referencia de datos, seleccione un tipo de
referencia de datos.
b. En Ajustes, haga clic en
para cónfigurar la
referencia de datos.
Nota:
Las unidades de medida de origen de una
referencia de datos pueden ser distintas de
las del atributo principal.
c. Haga clic en Aceptar para cerrar la ventana
de referencia de datos.
Se móstrara el resultado de la referencia de datos
evaluada.
7. Puede cónfigurar tantos valores pronosticados como sea necesario. Repita los pasos del 4 al
6.
8. Haga clic en Aceptar cuando su lista de atributos de prónósticó para el atributo principal
seleccionado este completa.
Configurar características del atributo de ubicación
Ajuste una o mas características de ubicación en un elemento o una plantilla de Event Frame, o
en un elemento de Event Frame, para permitirles a los usuarios identificar la ubicación de un
activo en un mapa. Tambien puede ajustar una ubicación para un modelo.
Antes de empezar
Puede ajustar solamente un conjunto de características del atributo de ubicación por cada
elemento, modelo o Event Frame.
140
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Procedimiento
1. Elija una de las siguientes acciones:
Para configurar una característica de ubicación
en...
Haga lo siguiente…
Elementos o plantillas de modelos
a. En el navegador Biblioteca, seleccione un
elemento o un modelo de plantilla.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y luego
haga clic en Ubicación.
▪ En la pestana General, haga clic en el
vínculó Ubicación.
Plantilla de event frame
a. En el navegador Biblioteca, seleccione una
plantilla de event frame.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y luego
haga clic en Ubicación.
▪ En la pestana General, haga clic en el
vínculó Ubicación.
Elementos o modelos
a. En el navegador Elementos, seleccione un
elemento o modelo.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y luego
haga clic en Ubicación.
▪ En la pestana General, haga clic en el
vínculó Ubicación.
Event frame
a. En el navegador Event Frames, seleccione un
event frame.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y luego
haga clic en Ubicación.
▪ En la pestana General, haga clic en el
vínculó Ubicación.
Nota:
Tambien puede cónfigurar características de ubicación como una plantilla de atributos
secundaria de una plantilla de atributos existente, o como un atributo secundario de
un atributo existente:
◦ En una plantilla, haga clic con el bótón secundario en una plantilla de atributo y
seleccione Ubicación de la plantilla de Element/Event Frame/Model.
◦ En un elemento, Event Frame o modelo, haga clic con el bótón secundario en un
atributo y seleccione Ubicación de Element/Event Frame/Model.
2. En la ventana Ubicación, seleccione la casilla junto a la característica que desea aplicar o
seleccione la casilla en el encabezado de la columna para seleccionar todas las
características.
3. En Atributo, seleccione una de las siguientes acciones:
Guía del usuario PI System Explorer
141
Asociación de datos con activos de PI AF
◦ Deje tal cual el atributo predeterminado. El nombre del atributo predeterminado muestra
la ruta relativa al elemento.
◦ Cambie el nombre del atributo predeterminado por otro nombre de su elección.
Asegurese de conservar la ruta completa del elemento.
◦ Si ya hay un atributo secundario que desea asignar a la característica ubicación,
seleccióneló de la lista.
Nota:
Las características del atributo de ubicación ya definidas se muestran en negrita.
4. Elija una de las siguientes acciones:
Para configurar...
Haga lo siguiente…
El valor de la característica de ubicación
En Valor, introduzca un valor de ubicación.
El valor de una referencia de datos
a. En Referencia de datos, seleccione un tipo de
referencia de datos.
b. En Ajustes, haga clic en
para cónfigurar la
referencia de datos.
c. Haga clic en Aceptar para cerrar la ventana
de referencia de datos.
Se móstrara el resultado de la referencia de datos
evaluada.
5. Haga clic en Aceptar cuando su lista de atributos de ubicación para el elemento seleccionado
este completa.
Configurar características del atributo de razón
Use las características de los atributos de motivo en los Event Frames y las transferencias para
permitirles a los usuarios elegir un códigó de motivo en el caso de excursiones, tiempo de
inactividad y otros eventos.
Antes de empezar
Solo puede ajustar una característica del atributo de motivo por Event Frame o transferencia.
Procedimiento
1. Para designar un atributo como una característica del atributo de motivo para un Event
Frame o una transferencia, elija una de las siguientes acciones:
Para ajustar una característica del atributo de
motivo para…
Haga lo siguiente…
Plantilla de event frame
a. En el navegador Biblioteca, seleccione una
plantilla de event frame.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en
Razón.
▪ En la pestana General, haga clic en el
vínculó Razón.
142
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Plantilla de transferencia
a. En el navegador Biblioteca, seleccione una
plantilla de transferencia.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en
Razón.
▪ En la pestana General, haga clic en el
vínculó Razón.
Event frame
a. En el navegador Event Frames, seleccione un
event frame.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundarios en
Razón.
▪ En la pestana General, haga clic en el
vínculó Razón.
Transferencia
a. En el navegador Event Frames, seleccione una
transferencia.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundarios en
Razón.
▪ En la pestana General, haga clic en el
vínculó Razón.
Plantilla de atributo para una plantilla de event
frame
a. En el navegador Biblioteca, seleccione una
plantilla de event frame.
b. Haga clic en la pestana Plantillas de atributos.
c. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en una
plantilla de atributos existente y haga clic
en Razón para una plantilla de event
frame.
▪ Haga clic en Nueva plantilla de atributos,
luego haga clic con el bótón secundario y,
a cóntinuación, haga clic en Razón para
una plantilla de event frame.
Plantilla de atributo para una plantilla de
transferencia
a. En el navegador Biblioteca, seleccione una
plantilla de transferencia.
b. Haga clic en la pestana Plantillas de atributos.
c. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en una
plantilla de atributos existente y haga clic
en Motivo para una plantilla de
transferencia.
▪ Haga clic en Nueva plantilla de atributos,
haga clic con el bótón secundario y, a
cóntinuación, haga clic en Motivo para
una plantilla de transferencia.
Guía del usuario PI System Explorer
143
Asociación de datos con activos de PI AF
Atributo de Event Frame o transferencia
Si se selecciónó la casilla Permitir extensiones
para un Event Frame o una plantilla de
transferencia, y no se designó anteriormente
ninguna plantilla de atributo como característica
del atributo de motivo, puede crear un atributo
nuevo y establecerlo como la característica del
atributo de motivo, o puede elegir un atributo
existente.
a. En el navegador Event Frames o Transferencia,
seleccione un Event Frame o una
transferencia.
b. Haga clic en la pestana Atributos.
c. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en un
atributo existente y haga clic en Motivo
para Event Frame o Motivo de la
transferencia.
▪ Haga clic con el bótón secundario debajo
de la tabla de atributos y haga clic en
Motivo para Event Frame o Motivo de la
transferencia.
2. En la ventana Motivo, seleccione la casilla que esta junto a la característica motivo que desea
aplicar.
3. En Atributo, seleccione una de las siguientes acciones:
◦ Deje el nombre del atributo predeterminado como Razón.
◦ Si ya hay un atributo que desea asignar a la característica de motivo, seleccióneló de la
lista.
Nota:
Las características de motivo ya definidas se muestran en negrita.
4. Elija una de las siguientes acciones:
Para configurar...
Haga lo siguiente…
Valor predeterminado para la característica de
razón
a. En Tipo de valor, seleccione Valor de
enumeración > Conjuntos de enumeración y
seleccione un conjunto de enumeración para
usar en la característica de razón. El
predeterminado es el conjunto de
enumeración Sistema incorporado.
b. En Valor predeterminado, seleccione el valor
de la característica de razón predeterminado
del conjunto de enumeración seleccionado.
Valor predeterminado de una referencia de datos
Nota:
La referencia de datos debe ser con
respecto a una etiqueta de estados
digitales.
a. En Referencia de datos, seleccione un tipo de
referencia de datos.
b. En Ajustes, haga clic en
para cónfigurar la
referencia de datos.
c. Haga clic en Aceptar para cerrar la ventana
de referencia de datos.
Se móstrara el resultado de la referencia de datos
evaluada.
5. Haga clic en Aceptar cuando haya completado la asignación de una característica de motivo
predeterminada para el Event Frame o la transferencia seleccionados.
144
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Ajustar características del atributo de estado
Ajuste las características del atributo de estado para una plantilla de elementos o un elemento
a fin de permitirles a los usuarios determinar el estado de un activo. Tambien puede ajustar las
características del atributo de estado para un modelo de plantilla o un modelo.
Antes de empezar
Puede ajustar solamente un conjunto de característica del atributo de estado por cada
elemento o modelo.
Procedimiento
1. Elija una de las siguientes acciones:
A fin de ajustar una característica de estado
para...
Haga lo siguiente…
Elementos o plantillas de modelos
a. En el navegador Biblioteca, seleccione un
elemento o un modelo de plantilla.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y
seleccione Estado.
▪ En la pestana General, haga clic en el
enlace Estado.
Elementos o modelos
a. En el navegador Elementos, seleccione un
elemento o modelo.
b. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario y
seleccione Estado.
▪ En la pestana General, haga clic en el
enlace Estado.
Plantillas de atributos
a. En el navegador Biblioteca, seleccione un
elemento o un modelo de plantilla.
b. En el visor, haga clic en la pestana Plantillas
de atributos.
c. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario debajo
de la cuadrícula y haga clic en Estado de
plantilla de elementos.
▪ Haga clic en Nueva plantilla de atributos y,
en la lista Propiedades, seleccione Estado
> HealthScore o Estado > HealthStatus.
Luego, asigne los valores deseados, como
se describe en el paso 4.
Guía del usuario PI System Explorer
145
Asociación de datos con activos de PI AF
Atributo
a. En el navegador Elementos, seleccione un
elemento o modelo.
b. En el visor, haga clic en la pestana Atributos.
c. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario debajo
de la cuadrícula y haga clic en Estado del
elemento.
▪ Haga clic en Nuevo atributo y, en la lista
Propiedades, seleccione Estado >
HealthScore o Estado > HealthStatus.
Luego, asigne los valores deseados, como
se describe en el paso 4.
Nota:
Tambien puede cónfigurar características de estado como una plantilla de atributos
secundaria de una plantilla de atributos existente, o como un atributo secundario de
un atributo existente, haciendo clic con el bótón secundario y seleccionando
Propiedades. En la lista Propiedades, seleccione Estado > HealthScore o Estado >
HealthStatus. Luego, asigne los valores deseados, como se describe en el paso 4.
2. En la ventana Estado, seleccione la casilla junto a la característica que desea aplicar o
seleccione la casilla en el encabezado de la columna para seleccionar todas las
características.
3. En la columna Atributo de la ventana Estado, elija una de las siguientes acciones:
◦ Deje tal cual el atributo predeterminado. El nombre del atributo predeterminado muestra
la ruta relativa al elemento.
◦ Cambie el nombre del atributo predeterminado por otro nombre de su elección.
Asegurese de conservar la ruta completa del elemento.
◦ Si ya hay un atributo secundario que desea asignar a la característica de estado,
seleccióneló de la lista.
Nota:
Las características del atributo de estado ya definidas se muestran en negrita.
4. Elija una de las siguientes acciones:
Para configurar...
Haga lo siguiente…
El valor de la característica HealthScore
En Valor predeterminado (para una plantilla) o
Valor (para un elemento), introduzca un valor
numericó.
El valor de la característica HealthStatus
En Valor predeterminado, seleccione un valor de
enumeración para la cóndición de estado:
◦ En buen estado
◦ Fuera de servicio
◦ En mantenimiento
◦ Con advertencia
◦ Con error
◦ Otros valores de conjunto de enumeración de
cóndición de estado anadidós por un
administrador
146
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
El valor de una referencia de datos
a. En Referencia de datos, seleccione un tipo de
referencia de datos.
b. En Ajustes, haga clic en
para cónfigurar la
referencia de datos.
c. Haga clic en Aceptar para cerrar la ventana
de referencia de datos.
Se móstrara el resultado de la referencia de datos
evaluada.
5. Haga clic en Aceptar cuando su lista de atributos de estado para el elemento seleccionado (o
modelo) este completa.
Controlar la visualización de los valores de atributos y plantillas de atributos
Antes de PI AF 2018, PI System Explorer permitía visualizar los tipo de datos numericós con un
nivel alto de precisión. Por ejemplo, los tipos de datos Simple y Doble tienen una precisión de
siete y quince, respectivamente. Estos elevados niveles de precisión no son siempre utiles en
situaciones de tiempo real o para los productos del cliente de PI AF: por ejemplo, un indicador
de temperatura suele mostrar una precisión de solamente tres dígitós, por lo que es probable
que los ingenieros de proceso no necesiten un mayor nivel de precisión para los calculós
matematicós.
A partir de PI AF 2018, la ópción de sistema Usar DisplayDigits para valores de atributos y
plantillas de atributos esta habilitada y garantiza que la cónfiguración predeterminada de la
propiedad DisplayDigits se use para visualizar valores de atributo de -5, o un total general de
cinco dígitós. Este es el mismo atributo predeterminado que se usa para PI points en PI Data
Archive.
Al crear plantillas de atributos, ahora puede controlar la cantidad de dígitós que sea ver para
cada atributo en el campo Mostrar dígitos:
• Puede introducir un numeró negativo hasta -20 para indicar la cantidad total de dígitós que
se visualizara.
• Puede introducir un numeró positivo hasta 10 para indicar la cantidad de dígitós que se
visualizara despues del punto decimal, incluidos los ceros finales.
Cuando edita un valor de atributo, se visualiza el numeró real en lugar del numeró truncado
que establece el campo Mostrar dígitos.
Para los atributos que no tienen como base una plantilla, la precisión de las referencia de datos
de PI point se obtiene a partir del mismo PI point.
Nota:
En las actualizaciones, los atributos existentes cónfiguradós con una referencia de datos
de PI point no se actualizan para obtener su valor DisplayDigits del PI point, sino que se
cónfiguran en -5.
Crear plantillas de atributos
Utilice las plantillas de atributos para crear un conjunto estandar de atributos que esten
asociados con plantillas de elemento, event frame, modelo y transferencia.
Procedimiento
1. En el navegador Biblioteca, seleccione una plantilla.
2. Para crear una nueva plantilla de atributos, seleccione una de las siguientes acciones:
Guía del usuario PI System Explorer
147
Asociación de datos con activos de PI AF
◦ En la barra de herramientas, haga clic en Plantilla de nuevos atributos.
◦ Haga clic con el bótón secundario sobre la plantilla en el navegador y haga clic en Nuevo
> Nueva plantilla de atributo.
3. En los campos Nombre y Descripción, introduzca un nombre unicó y una descripción para la
plantilla de atributos.
Nota:
Cuando necesite buscar un atributo, puede buscarlo con una descripción que tenga un
maximó de 440 caracteres.
4. Especifique valores en los campos de cónfiguración, segun resulte necesario.
Campo
Description
Propiedades
Seleccione una o mas de las siguientes propiedades, segun resulte
necesario.
◦ Elemento de configuración
◦ Excluido
◦ Oculto
◦ Indexado
◦ Entrada manual de datos
Para obtener mas infórmación sobre estas propiedades, consulte
Propiedades de atributos.
Puede cónfigurar la plantilla de atributo actual para que sea una
característica del atributo de ubicación para un objeto principal. Seleccione
uno de:
◦ Ubicación > Longitud
◦ Ubicación > Latitud
◦ Ubicación > Altitud
Cuando el objeto principal es una Event Frame o una transferencia, puede
cónfigurar la plantilla de atributo actual para que sea una característica del
atributo de motivo. Para obtener mas infórmación, consulte Cónfigurar
características del atributo de razón.
Cuando el objeto principal es un elemento o modelo, puede cónfigurar la
plantilla de atributo actual para que sea una característica del atributo de
estado del activo. Para obtener mas infórmación, consulte Ajustar
características del atributo de estado.
Nota:
Cuando cónfigure una plantilla de atributo secundaria, pódra
seleccionar tambien características de atributo y límites, en función
del tipo de valor de la plantilla de atributo principal. Para obtener
mas infórmación, consulte Características de atributos.
Categorías
Haga clic en
y seleccione una o mas categórías definidas previamente
desde la ventana Categorías. Tambien puede crear una nueva categóría.
Para obtener mas infórmación, consulte Categórización de objetos.
Unidad de medida
predeterminada
Seleccione una unidad de medida de la lista. Para obtener mas infórmación
sobre unidades de medida, consulte Unidades de medida de PI AF.
Nota:
Aunque un usuario puede cambiar la unidad de medida que se
muestra para un atributo en PI System Explorer, la unidad de medida
que se define en la plantilla no cambia.
5. Cónfigure el tipo de valor que el atributo cóntendra.
148
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
◦ En el caso de atributos con valores constantes, cónfigure el atributo Tipo de valor. Los
valores de atributos de constante pueden ser numerós, cadenas, archivos, fechas-horas,
booleanos, URLs, matrices, etc. Para obtener mas infórmación, consulte Definir valores
constantes para las plantillas de atributos.
Nota:
En caso de que se realicen busquedas por aplicaciones cliente, como PI Vision, en el
valor o si fuera necesario realizar una cónversión de una UOM, no establezca una
UOM predeterminada para tipos de valor de entero. Por ejemplo, un tipo de valor
entero con una UOM predeterminada no es compatible con la función de grupos de
UOM que se presenta en PI AF 2017 R2. En su lugar, use el tipo de valor Individual o
Doble.
Nota:
Aunque es un valor validó, no se recomienda utilizar el tipo de valor Cualquiera.
Cuando el tipo de valor no se especifica, muchas aplicaciones de cliente pueden
tener dificultades para trabajar con ese atributo. Por ejemplo, PI OLEDB Enterprise,
PI ProcessBook y PI Vision habrían reducido la capacidad con tales atributos, como
la incapacidad de agregar un valor numericó a la tendencia. Ademas, las
características estandares de PI AF, como la cónversión de unidades de medida, las
fórmulas y el analisis, no pueden funcionar con atributos que no tengan ningun tipo
de valor.
◦ En el caso valores de PI point, matrices de PI point, fórmulas y datos de tabla (incluidos
los datos de las bases de datos relacionales), haga clic en Ajustes para cónfigurar una
referencia de datos. Para obtener mas infórmación, consulte Cónfiguración de referencias
de datos.
6. Opcional. Introduzca un valor predeterminado para el atributo en el campo Valor
predeterminado.
7. Opcional. Cuando la ópción de sistema Usar DisplayDigits para valores de atributos y
plantillas de atributos esta seleccionada, es posible anular el valor de propiedad
predeterminado de DisplayDigits de -5 y especificar en el campo Mostrar dígitos la cantidad
de dígitós que se visualizara. Esto solamente repercute en los valores numericós del campo
Valor.
◦ Introduzca un numeró negativo hasta -20 para indicar la cantidad total de dígitós que se
visualizara.
◦ Introduzca un numeró positivo hasta 10 para indicar la cantidad de dígitós que se
visualizara despues del punto decimal, incluidos los ceros finales.
Para obtener mas infórmación, consulte Controlar la visualización de los valores de
atributos y plantillas de atributos y Opciones de persónalización de PI System Explorer.
8. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Qué hacer a continuación
Si crea un atributo tomando como base una plantilla, tendra que cónfigurar el valor:
• En el caso de los valores de constantes, anada el valor al atributo directamente.
• En el caso de las referencias de datos, debe crear la instancia de la referencia de datos. Para
ello, haga clic con el bótón secundario sobre el elemento en el navegador y seleccione Crear
o actualizar referencia de datos. Para obtener mas infórmación, consulte Actualizaciones del
valor de atributo a partir de referencias de datos de PI Point.
Nota:
La cónfiguración del atributo puede, en algunos casos, limitar cómó se veran los datos en
las aplicaciones cliente, como PI ProcessBook o PI Vision. Consulte Restricciones de
visualización de los datos de serie temporal si desea mas infórmación.
Guía del usuario PI System Explorer
149
Asociación de datos con activos de PI AF
Tipos de datos de PI AF
La siguiente tabla contiene definiciónes de los tipos de datos que se utilizan en PI AF.
Tipo de datos
Equivalente
de PI Data
Archive
Descripción
Boolean
Ninguna
Un tipo de datos que realiza un True o False
seguimiento de condiciones
Un atributo Boolean se puede almacenar en un
verdaderas o falsas
PI point de tipo String y en cualquiera de los
tags Integer, pero Digital es la
representación preferida.
Byte
Ninguna
Un tipo de datos sin firmar de
8 bits
DateTime
Timestamp
Fecha y hora almacenadas
internamente en 64 bits
Intervalo
0 a 255
Estos valores se pueden representar en un tipo
de datos de PI mas grande, como Int16. Sin
embargo, si PI Data Archive contiene datos
fuera del intervalo de bytes, se devuelve un
error cuando se recupera a traves de PI AF.
• Si se almacena en PI Data Archive: 1 de
enero de 1970 a 19 de enero de 2038, con
una precisión de 15 microsegundos
• Si no se almacena en PI Data Archive: 1 de
enero de 0001 a 31 de diciembre de 9999,
con una precisión de 100 nanosegundos
Double
Float64
Un numeró de punto flótante
de 64 bits
±5.0e−324 a ±1.7e308, 15 dígitós de precisión
GUID
Ninguna
Un tipo de datos unicó de 128 00000000-0000-0000-0000-000000000000 a
bits utilizado para la
ffffffff-ffff-ffff-ffff-ffffffffffff
identificación global de objetos
Los valores anteriores se pueden representar
como un tipo de datos String de PI.
Int16
Int16
Un valor entero firmadó de 16
bits
-32,768 a 32,767
Int32
Int32
Un valor entero firmadó de 32
bits
-2,147,483,648 a 2,147,483,647
Int64
Ninguna
Un valor entero firmadó de 64
bits
-9,223,372,036,854,775,808 a
9,223,372,036,854,775,807
No existe equivalente de un Int64 en PI Data
Archive. Para representaciones no numericas
(como un numeró de ID), puede usar una
cadena. Para representaciones numericas,
Float64 proporciona algunas equivalencias
pero estaran sujetas a problemas de redondeo
con numerós muy largos (positivos o
negativos).
Single
Float32
Un numeró de punto flótante
de 32 bits
±1.5e−45 a ±3.4e38, 7 dígitós de precisión
String
String
Una secuencia de varios
caracteres
Las cadenas de PI Data Archive tienen un límite
de 976 caracteres y no son unicode
150
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Definir valores constantes para las plantillas de atributos
Puede asignar valores constantes directamente en una plantilla de atributos. Si bien no puede
establecer valores de atributos reales en las plantillas de atributos, puede definir valores
predeterminados.
Procedimiento
1. En el visor, utilice el campo Tipo de valor para seleccionar el tipo de datos del atributo.
Existen cuatro grupos de tipos de valor:
◦ Tipos básicos
Un tipo de datos compatible con PI AF, como se describe en Tipos de datos de PI AF.
◦ Tipos de matriz
Una matriz contiene cualquiera de los tipos basicós como elementos.
◦ Conjuntos de enumeración
Un conjunto de enumeración es una lista de valores de constante definida por los
usuarios. Los conjuntos de enumeración se utilizan normalmente para definir una lista de
valores predefinidós para una plantilla de atributos. Cuando cónfigure atributos basados
en esa plantilla, puede seleccionar un valor de la lista. Utilice la ópción Conjuntos de
enumeración para seleccionar cualquier conjunto de enumeración que ya se haya creado
en su base de datos de PI AF.
◦ Objetos
Un objeto puede ser otro atributo o elemento de PI AF, o un archivo del sistema
operativo.
2. Haga clic en el campo Valor predeterminado.
El formato del campo Valor predeterminado cambia segun el Tipo de valor.
3. Cónfigure el valor del atributo, como se describe en el procedimiento correspondiente al
tipo de datos de atributo.
En esta sección
• Cónfigurar valores para los tipos de datos basicós
• Cónfigurar valores para los tipos de datos de matriz
• Cónfigurar los valores del conjunto de enumeración
• Cónfigurar valores para los tipos de datos de objeto
Configurar valores para los tipos de datos básicos
Una vez que haya cónfiguradó el Tipo de valor en uno de los tipos de datos basicós, pódra
definir el valor del atributo.
Procedimiento
1. Haga clic en el campo Valor predeterminado. El formato del campo cambia segun el tipo de
valor. Consulte Tipos de datos de PI AF.
2. Introduzca el valor del atributo en el campo Valor predeterminado. PI System Explorer
resuelve los datos que ha introducido al guardar los cambios y envía el valor resultante a PI
AF. Por ejemplo, para FechaHora, envía la fecha y hora resultantes.
Guía del usuario PI System Explorer
151
Asociación de datos con activos de PI AF
Ejemplos
Si el tipo de valor es FechaHora, puede escribir la hora en cualquier formato de cadena
admitido por PI AF (incluidos los formatos de tiempo de PI) o el objeto .NET DateTime. Estos
son algunos ejemplos de entradas validas:
*-5d
May 12, 2009
07 06 2010 10:00:00 AM
09 14 2008 14:00:00
Para crear un atributo con un vínculó como valor, seleccione la Cadena del tipo de valor e
introduzca la dirección URL como valor de atributo. Las cadenas reconocidas como direcciones
URL absolutas se móstraran como un enlace. Por ejemplo, las cadenas que comienzan con
http://, ftp://, file:// y www. se reconocen como enlaces, mientras que las cadenas que
comienzan con C:\ y abc.com, no. En PI System Explorer, los vínculós se muestran subrayados
y con una infórmación sobre herramientas asociada.
Configurar valores para los tipos de datos de matriz
Una vez que haya cónfiguradó el Tipo de valor en uno de los tipos de datos de matriz, pódra
definir el valor del atributo.
Procedimiento
1. Haga clic en el campo Valor predeterminado.
2. Haga clic en
al lado del campo Valor predeterminado.
3. En la ventana Matriz, defina la matriz. El campo Valor predeterminado se cónfigurara con el
formato correspondiente al tipo de datos que selecciónó para los elementos de matriz.
Consulte Tipos de datos de PI AF.
4. Haga clic en OK. PI System Explorer resuelve los datos que ha introducido al guardar los
cambios y envía los valores de matriz resultantes a PI AF.
Configurar los valores del conjunto de enumeración
Al seleccionar un conjunto de enumeración para el Tipo de valor, puede escoger el valor para
un atributo en la lista predefinida de valores constantes de ese conjunto. Para obtener mas
infórmación sobre conjuntos de enumeración, consulte Conjuntos de enumeración en PI AF.
Procedimiento
1. Haga clic en el campo Valor predeterminado. El campo Valor predeterminado se convierte
en un menu desplegable con los valores del conjunto de enumeración seleccionado.
2. Seleccione un valor de la lista de constantes predefinidas. Cuando guarde los cambios, PI
System Explorer enviara el valor resultante a PI AF.
Configurar valores para los tipos de datos de objeto
Una vez que haya cónfiguradó el Tipo de valor en uno de los tipos de datos de objeto, pódra
definir el valor del atributo.
Procedimiento
1. Haga clic en el campo Valor predeterminado. El bótón de acción junto al campo cambia
segun el tipo de valor seleccionado.
152
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Tipo de valor
Acción
<Anything>
Aunque es un valor validó, no se recomienda utilizar el tipo de valor
Cualquiera.
Nota:
Cuando el tipo de valor no se especifica, muchas aplicaciones de
cliente pueden tener dificultades para trabajar con ese atributo. Por
ejemplo, PI OLEDB Enterprise, PI ProcessBook y PI Vision habrían
reducido la capacidad con tales atributos, como la incapacidad de
agregar un valor numericó a la tendencia. Ademas, las características
de PI AF estandar, como la cónversión de unidades de medida
autómatica, las fórmulas y el analisis, no pueden funcionar con
atributos que no tienen ningun tipo de valor.
Atributo
Haga clic en
para abrir la ventana Búsqueda de atributos. Introduzca los
criterios de busqueda, como se describe en Busqueda de atributos en
elementos.
Elemento
Haga clic en
para abrir la ventana Navegador de elementos, donde
puede encontrar y seleccionar un elemento.
Archivo
Haga clic en
y seleccione Cargar. Encuentre y seleccione un archivo en
la ventana Abrir. Para conocer los tipos de archivos adjuntos aceptado,
consulte /FileExtensions en Parametrós de la utilidad AFDiag.
PRECAUCIÓN:
Antes de cargar un archivo, ejecute un analisis antivirus y asegurese
de que el tamanó del archivo no supere el espacio de
almacenamiento. Algunos tipos de archivos pueden representar un
riesgo de seguridad. Se móstrara un mensaje de advertencia
preguntandóle si esta seguro que desea continuar. La lista de tipos de
archivo que PI System Explore considera poco seguros puede
cambiar. Como norma general, consulte la lista de tipos de archivos
de Microsoft bloqueados por Outlook.
2. Haga clic en Aceptar. Cuando guarde los cambios, PI System Explorer enviara el valor
resultante a PI AF.
Añadir extensiones de atributos a elementos basados en plantillas
En algunas ocasiones, es posible que desee anadir otro atributo a un elemento existente. Si el
elemento se basa en una plantilla que admite ampliaciones, pódra definir atributos adicionales
en el propio elemento, independientemente de la plantilla.
Antes de empezar
La casilla de verificación Admitir ampliaciones de la pestana General para la plantilla de
elementos en la que se basa el atributo debe ser seleccionada.
Procedimiento
1. En el explorador Elementos, seleccione el elemento al que se anadira el atributo.
2. Elija una de las siguientes acciones.
◦ En la barra de herramientas, haga clic en Nuevo atributo.
◦ Haga clic con el bótón secundario sobre el elemento en el explorador y luego haga clic en
Nuevo > Nuevo atributo.
◦ Seleccione la pestana Atributos en el visor, haga clic con el bótón secundario y luego haga
clic en Nuevo atributo en el menu contextual.
Guía del usuario PI System Explorer
153
Asociación de datos con activos de PI AF
3. En los campos Nombre y Descripción, introduzca un nombre unicó y una descripción para la
plantilla de atributos.
Nota:
Cuando necesite buscar un atributo, puede buscarlo con una descripción que tenga un
maximó de 440 caracteres.
4. Cónfigure el tipo de valor que el atributo cóntendra:
◦ En el caso de atributos con valores constantes, cónfigure el atributo Tipo de valor. Esta
cónfiguración determinara los valores que puede introducir en el campo Valor.
Los valores de atributos de constante pueden ser numerós, cadenas, archivos, fechashoras, booleanos, URLs, matrices, etc.
Nota:
Aunque es un valor validó, no se recomienda utilizar el tipo de valor Cualquiera.
Cuando el tipo de valor no se especifica, muchas aplicaciones de cliente pueden
tener dificultades para trabajar con ese atributo. Por ejemplo, PI OLEDB Enterprise,
PI ProcessBook y PI Vision habrían reducido la capacidad con tales atributos, como
la incapacidad de agregar un valor numericó a la tendencia. Ademas, las
características estandares de PI AF, como la cónversión de unidades de medida, las
fórmulas y el analisis, no pueden funcionar con atributos que no tengan ningun tipo
de valor.
Opcional. Introduzca o módifique el valor predeterminado del atributo en el campo Valor.
◦ En el caso de fórmulas, valores de PI point, matrices de PI point y datos de tabla
(incluidos los datos de las bases de datos relacionales), haga clic en Ajustes para
cónfigurar una referencia de datos.
Consulte Cónfiguración de referencias de datos para obtener infórmación sobre la
cónfiguración de diferentes tipos de referencias de datos.
5. Defina los demas campos de cónfiguración, segun resulte necesario.
Campo
Descripción
Propiedades
Seleccione una o mas de las siguientes propiedades, segun resulte
necesario.
◦ Elemento de configuración
◦ Excluido
◦ Oculto
◦ Indexado
◦ Entrada manual de datos
Para obtener mas infórmación, consulte Propiedades de atributos.
Categorías
Haga clic en
y seleccione una o mas categórías definidas previamente
desde la ventana Categorías. Tambien puede crear una nueva categóría.
Para obtener mas infórmación, consulte Categórización de objetos.
Unidad de medida
predeterminada
Seleccione una unidad de medida de la lista desplegable. Para obtener mas
infórmación, consulte Unidades de medida de PI AF.
Nota:
Puede cambiar la unidad de medida que se muestra para el atributo
en PI System Explorer; sin embargo, la unidad de medida definida en
la plantilla no cambiara.
6. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
154
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Conjuntos de enumeración en PI AF
Por lo general, los conjuntos de enumeración se utilizan para establecer valores predefinidós
para las plantillas de atributo. Cuando cónfigura atributos de elemento segun esas plantillas,
puede permitir que los usuarios seleccionen esos valores de listas completadas previamente en
lugar de escribir los valores en forma manual. Esto ayuda a garantizar que tenga una
nomenclatura coherente en toda la base de datos.
Valores de enumeración jerárquicos
A partir de PI AF 2017 R2, puede anidar valores de enumeración en una jerarquía. Esto puede
ser de mucha ayuda cuando crea un conjunto predefinidó de características de atributos de
razón. Puede crear la cantidad de niveles que necesite. Cada nivel esta designado por el caracter
|, que puede introducir manualmente o haciendo clic con el bótón secundario en una fila y clic
en Nuevo valor de enumeración secundario.
Ejemplo de conjunto de enumeración jerárquico
Supongamos que tiene un conjunto de enumeración de fabricantes de bombas, con valores de
enumeración secundarios para los tipos de bomba. Dentro de cada tipo de bomba tambien
puede crear valores de enumeración secundarios de los diferentes modelos.
Jerarquía de valores de enumeración de muestra
Cuando cónfigura la plantilla de atributo de Pump, simplemente puede seleccionar el conjunto
de enumeración Pump Manufacturer como el Tipo de valor y, a partir de esa acción, habilitar
a los usuarios para que seleccionen tipos de bombas predefinidós y numerós de modelo.
Guía del usuario PI System Explorer
155
Asociación de datos con activos de PI AF
Conjunto de enumeración de muestra en la plantilla de atributo
Criterio de ordenación
A partir de PI AF 2017 R2, cada vez que se muestran valores predefinidós definidós por
conjuntos de enumeración, los usuarios pueden seleccionar Clasificar por > Clasificar por
nombre para clasificar esos valores por nombre o Clasificar por > Clasificar por valor para
clasificar por valor de conjunto de enumeración.
Video
Para obtener infórmación sobre cómó crear conjuntos de enumeración, mire este video:
https://www.youtube.com/watch?v=nH7zvsb8kBE&rel=0
Administrar conjuntos de enumeración
Los conjuntos de enumeración se usan en las plantillas de atributo cada vez que quiere
seleccionar de las listas los valores predefinidós cuando define atributos de elemento. Tambien
puede utilizar los conjuntos de enumeración para crear características de atributos de razón
para event frames y transferencias.
Antes de empezar
A partir de PI AF 2018 SP2, puede exportar conjuntos de estados digitales de un PI Data
Archive para crear conjuntos de enumeración. Para obtener mas infórmación, consulte Revisar
conjuntos de estados digitales en un PI Data Archive.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. Elija una de las siguientes acciones.
156
Guía del usuario PI System Explorer
Asociación de datos con activos de PI AF
Para…
Haga lo siguiente…
Crear un nuevo conjunto de enumeración
a. Seleccione una de las siguientes acciones.
▪ En la barra de herramientas, haga clic en
Nuevo conjunto de enumeración.
▪ En el navegador, haga clic con el bótón
secundario en la cólección Conjuntos de
enumeración y luego haga clic en Nuevo
conjunto de enumeración.
b. En el campo Nombre, ingrese un nombre
exclusivo para el conjunto de enumeración.
c. Opcional. En el campo Descripción,
introduzca una descripción para el conjunto
de enumeración.
d. Opcional. Para utilizar valores hexadecimales,
marque la casilla de verificación
Hexadecimal.
e. Opcional. Si desea cónfigurar los permisos de
acceso para el nuevo conjunto de
enumeración que son diferentes de los
heredados de la cólección Conjuntos de
enumeración, haga clic en el enlace
Seguridad. Para obtener mas infórmación,
consulte Cónfigurar la seguridad para objetos.
Crear un nuevo valor de enumeración
a. Seleccione una de las siguientes acciones.
▪ En el navegador, haga clic en un conjunto
de enumeración existente. En el visor,
haga clic con el bótón secundario en
cualquier campo de Valor y haga clic en
Nuevo valor de enumeración.
▪ En el navegador, haga clic con el bótón
secundario en un conjunto de
enumeración existente y haga clic en
Nuevo valor de enumeración.
El valor es un valor numericó exclusivo
asociado a la enumeración y proporciona una
representación mas rapida y con menos uso
de la memoria del valor de una enumeración.
b. En el campo Valor de la ventana Propiedades
de valor de enumeración, ingrese un numeró
exclusivo en forma manual o haga clic en
para aumentar o disminuir el valor.
c. En el campo Nombre, ingrese una cadena
exclusiva que describa la cóndición o el
estado que se representa. Esta cadena se usa
como el valor mostrado cuando se selecciona
un conjunto de enumeración como el tipo de
valor de un atributo.
d. Opcional. En el campo Descripción,
introduzca una descripción para el valor de
enumeración.
Guía del usuario PI System Explorer
157
Asociación de datos con activos de PI AF
Crear un nuevo valor de enumeración secundario
en la ventana Propiedades de valor de
enumeración
a. En el navegador, haga clic en un conjunto de
enumeración existente.
b. En el visor, haga clic con el bótón secundario
en un valor existente al que desea agregar un
valor de enumeración secundario y haga clic
en Nuevo valor de enumeración secundario.
c. En la ventana Propiedades de valor de
enumeración, verifique que el valor
seleccionado en el campo Primario sea el
correcto. De lo contrario, seleccione otro
valor principal de la lista.
d. En el campo Valor, ingrese un numeró
exclusivo en forma manual o haga clic en
para aumentar o disminuir el valor.
e. En el campo Nombre, ingrese una cadena
exclusiva que describa la cóndición o el
estado que se representa. Esta cadena se usa
como el valor mostrado cuando se selecciona
un conjunto de enumeración como el tipo de
valor de un atributo.
f. Opcional. En el campo Descripción,
introduzca una descripción para el valor de
enumeración.
Crear un nuevo valor de enumeración secundario
manualmente
a. En el navegador, haga clic en un conjunto de
enumeración existente.
b. En el visor, haga clic en una fila vacía e
introduzca un numeró exclusivo en forma
manual en el campo Valor.
c. En el campo Nombre:
i. Introduzca el valor de enumeración
original para el que desea crear un valor
secundario.
ii. Introduzca un caracter |.
iii. Introduzca una cadena exclusiva que
represente el valor de enumeración
secundario.
d. Opcional. En el campo Descripción,
introduzca una descripción para el valor de
enumeración secundario.
Renombrar un valor de enumeración
a. En el navegador, haga clic en un conjunto de
enumeración existente.
b. En el visor, haga clic con el bótón secundario
en el valor existente que quiere renombrar y
haga clic en Propiedades.
c. En el campo Nombre de la ventana
Propiedades del valor de enumeración, revise
la cadena del nombre, segun sea necesario,
pero asegurese de que siga siendo exclusiva.
Si el nombre se usa como un valor de
enumeración principal, tenga en cuenta que
el cambio de nombre actualice la parte
principal de todas las cadenas de valor de
enumeración secundarias.
Volver a numerar los valores de enumeración
158
Guía del usuario PI System Explorer
Consulte Volver a numerar los valores de
enumeración.
Asociación de datos con activos de PI AF
Eliminar un valor de enumeración
a. En el navegador, haga clic en un conjunto de
enumeración existente.
b. En el visor, haga clic con el bótón secundario
en el valor existente que desea eliminar y
haga clic en Eliminar.
c. Haga clic en Sí para responder a la
advertencia de Eliminar. Tenga en cuenta que
invalidara los objetos si el valor esta en uso.
3. En la barra de herramientas, haga clic en Ingresar.
Volver a numerar los valores de enumeración
Puede volver a numerar un conjunto de enumeración, pero esto invalidara los objetos en los
que se esta utilizando el valor.
Procedimiento
1. Haga clic con el bótón secundario en cualquier lugar de un campo y seleccione Renumerar
valores de enumeración.
La ventana de cónfirmación Cambiar valor de enumeración explica que invalidara objetos que
estan usando el conjunto de enumeración existente.
2. Para continuar, haga clic en Sí.
3. En el campo Valores iniciales de la ventana Volver a enumerar, haga clic en
o disminuir el valor.
4. En el campo Incrementar en, haga clic en
para aumentar
para seleccionar un valor de incremento.
Si selecciona una fila antes de la renumeración, esta se iniciara en la fila seleccionada, que
tómara el valor inicial, y cada fila siguiente adóptara el siguiente valor de incremento. Solo la
fila seleccionada y las siguientes se módificaran durante una acción de renumeración. Si la
renumeración no se inicia en la fila que esta mas arriba, existe la posibilidad de que los
valores generados sean identicós a los que estan por encima de la fila seleccionada. Se
móstrara el siguiente mensaje de error:
Attempting to change the enumeration values would overlap previous
enumeration values prior to the selected row.
Guía del usuario PI System Explorer
159
Asociación de datos con activos de PI AF
160
Guía del usuario PI System Explorer
Configuración de referencias de datos
Puede cónfigurar un atributo o una plantilla de atributos para obtener valores de órígenes
especificadós. Esta cónfiguración se denomina referencia de datos. Los atributos que las
incluyen se denominan atributos de referencia de datos. Puede crear una referencia de datos
para las siguientes fuentes:
• PI Point
Produce un valor a partir de un PI Point, o el resumen, u otra óperación en el valor del
punto, segun la cónfiguración.
• Matriz de PI Point
Produce un unicó valor a partir de una matriz de PI Points.
• Fórmula
Produce un valor a partir de un resultado de calculó. El calculó en sí puede incluir atributos,
y tambien otros atributos de referencia de datos.
• Generador de cadenas
Produce un valor de cadena a partir de las funciones de manipulación de texto y los
parametrós de sustitución.
• Búsqueda de tabla
Produce un valor a partir de:
◦ Tabla interna
◦ Valor importado de una tabla externa (no PI)
◦ Valor vinculado en una tabla externa
• Creador de URI
Produce un vínculó dinamicó para los atributos a partir de valores de atributos y
parametrós de sustitución. Puede utilizar el atributo en una nótificación o en una aplicación
cliente como PI Vision.
En esta sección
• Cadenas de cónfiguración de atributos en PI System Explorer
• Parametrós de substitución en referencias de datos
• Referencias de datos de PI points
• Referencias de datos de matriz de PI point
• Referencias de datos Fórmula
• Referencia de datos String Builder
• Referencias de datos Table Lookup
• Referencias de datos de Uri Builder
Guía del usuario PI System Explorer
161
Configuración de referencias de datos
Cadenas de configuración de atributos en PI System Explorer
Una cadena de cónfiguración de atributo describe una referencia de datos. La sintaxis de una
cadena de cónfiguración depende del tipo de referencia de datos.
La cadena de cónfiguración para las referencias de datos String Builder puede contener
parametrós de substitución. En el caso de las plantillas de atributos, cualquier cadena de
cónfiguración puede incluir parametrós de sustitución. Consulte Lista de parametrós de
sustitución de PI AF.
En PI System Explorer, cuando selecciona un atributo con una referencia de datos, la cadena de
cónfiguración aparece en el cuadro de texto debajo del bótón Ajustes. Pódra módificar las
cadenas de cónfiguración directamente en el cuadro de texto.
La siguiente tabla contiene ejemplos de cadenas de cónfiguración para distintos tipos de
referencias de datos:
Tipo de referencia de
datos
Cadena de configuración de muestra
Fórmula
D=Density;V=Volume;[D*V]
A=Attribute3;[A*3];UOM=cm
PI Point
\\MyPIDataArchiveServer\sinusoid
\\192.168.0.255\ChocMilkMeter;TimeMethod=TimeRange;
RelativeTime=-1h;TimeRangeMethod=Total;ReadOnly=False
Matriz de PI Point
\\MyPIDataArchiveServer\Point.1|Point.2|Point.3
Generador de cadenas
"%Attribute% value is";'Attribute1';
Busqueda en tablas
SELECT Density FROM [Material Specifications] WHERE
MaterialID = @Product
Creador de URI
https://MyDataServer.int:443/Vision/#Displays/215915/MineTruck-10-Brake-Temp?Asset=\\%System%\%Database%\%Element
%&StartTime=03%2F21%2F2016 09:26:00&EndTime=&Mode=kiosk
En esta sección
• Cadenas de cónfiguración para referencias de datos de PI points
• Sintaxis de ruta para las referencias a otros atributos
Cadenas de configuración para referencias de datos de PI points
La cadena de cónfiguración de atributo para las referencias de datos de PI Point debe incluir la
ruta al punto. Ademas, la cadena tambien puede incluir los parametrós que especifican el valor
que devuelve la referencia de datos. Si se especifica en una plantilla de atributo, la cadena
puede contener parametrós que especifiquen el punto que se debe crear. En la cadena, los
parametrós se separan con punto y coma.
Ejemplos
• Referencia simple a un punto en un servidor PI Data Archive denominado
MyPIDataArchiveServer:
\\MyPIDataArchiveServer\sinusoid
• Cadena de cónfiguración que hace referencia al mismo punto, pero con una especificación de
recuperación de tiempo y unidades de medida especificadas:
\\MyPIDataArchiveServer\sinusoid;TimeMethod=ExactTime;UOM=°C
162
Guía del usuario PI System Explorer
Configuración de referencias de datos
• Cadena de cónfiguración que hace referencia al mismo punto, pero que devuelve un total de
valores de punto con respecto a un intervalo de tiempo:
\\MyPIDataArchiveServer\sinusoid;TimeMethod=NotSupported;
TimeRangeMethod=Total;RateConversion=day
• Cadena de cónfiguración de una plantilla de atributo que usa parametrós de sustitución:
\\%Server%\%Element%.%Attribute%
• La misma cadena de cónfiguración, pero con creación de etiqueta habilitada y cónfiguración
de punto especificada:
\\%Server%\%Element%.%Attribute%;ptclassname=classic;pointtype=Float32;
engunits=m3/s;location1=1;location2=30;location4=1;location5=1;pointsource=R
Parámetros de referencia de datos que especifican los valores que se
devolverán
Las cadenas de cónfiguración para las referencias de datos de PI Point pueden incluir
parametrós opcionales que especifiquen el valor que devuelven las referencias de datos. La
siguiente tabla enumera los parametrós disponibles:
Parámetro
Sintaxis
Ejemplo
TimeMethod
TimeMethod=time_method
TimeMethod=Automatic
donde time_method es uno de:
• After
• AtOrAfter
• Before
• AtOrBefore
• Automatic
• ExactTime
• Interpolated
• NotSupported
• TimeRange
• TimeRangeOverride
RelativeTime
RelativeTime=[*] +|- integer
time_unit
RelativeTime=-1h
donde time_unit es uno de:
• y
• M
• d
• h
• m
• s
Guía del usuario PI System Explorer
163
Configuración de referencias de datos
Parámetro
Sintaxis
Ejemplo
TimeRangeMethod
TimeRangeMethod=method_name
TimeRangeMethod=Total
donde method_name es uno de
• Maximum
• Minimum
• PopulationStandardDeviation
• Range
• StandardDeviation
• StartTime
• Total
TimeRangeMinPercen
tGood1
TimeRangeMinPercentGood=
percentage
CalculationBasis1
CalculationBasis= calculation_basis
donde calculation_basis es uno de:
• EventWeighted
• EventWeightedExcludeEarlies
tEvent
• EventWeightedExcludeMostRec
entEvent
• EventWeightedIncludeBothEnd
s
• TimeWeighted
• TimeWeightedContinuous
• TimeWeightedDiscrete
RateConversion2
RateConversion=uom
RateConversion=minute
donde uom es una unidad de medida
definida
UOM
UOM=uom
UOM=°C
donde uom es una unidad de medida
definida
ReadOnly
ReadOnly=boolean
ReadOnly=false
donde boolean es uno de:
• true
• false
1 Se usa cuando se especifica
TimeRangeMethod.
2 Usado solo cuando TimeRangeMethod=Total.
Parámetros de referencia de datos que especifican el PI para crear
En las plantillas de atributos que especifican los PI points nuevos, las cadenas de cónfiguración
para las referencias de datos de PI point incluyen parametrós que especifican el tipo de punto
que se creara. Los parametrós de creación de punto consisten de un valor y atributo de punto.
Para especificar un PI point nuevo, las plantillas de atributo deben incluir el atributo
pointtype como parametró; otros atributos son opcionales.
164
Guía del usuario PI System Explorer
Configuración de referencias de datos
Ejemplos
• Crear un PI point de tipo Float64 y usar los ajustes predeterminados para el resto de la
cónfiguración del punto:
\\%Server%\%Element%.%Attribute%;pointtype=Float64
• Crear un PI point que establezca los atributos del punto que se muestran en la siguiente
tabla:
Atributo de punto
Configuración
ptclassname
classic
pointtype
Float32
pointsource
R
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
Sintaxis de ruta para las referencias a otros atributos
Para hacer referencia a otros atributos, utilice rutas que ubiquen los atributos en el servidor, la
base de datos y los elementos en los que residen.
• Utilice una ruta absoluta para especificar el servidor, la base de datos y el elemento en los
que se encuentra un atributo. Por ejemplo:
\\MyPIDataArchive\MyAFDatabase\MyElement|Attribute1
• Utilice una ruta relativa para identificar un atributo en función de su nombre y del lugar que
ocupa en la jerarquía de elementos y atributos. Por ejemplo:
..\Element2|Attribute1
Componentes de una ruta
Una ruta se compone de partes; cada una representa un objeto o una lista de objetos. Cada
parte de una ruta normalmente se separa de la siguiente manera: con una barra invertida (\),
con las siguientes excepciones:
• Los atributos de PI AF y las plantillas de atributos de PI AF van precedidos del caracter de
barra vertical (|).
• El PI Data Archive debe ir precedido de dos barras invertidas (\\).
Para especificar un PI Data Archive y una base de datos puede utilizar un nombre o un
identificadór unicó global (GUID). Un GUID es un numeró exclusivo de 128 bits generado por
Windows que sirve para identificar un componente, aplicación, archivo o entrada de base de
datos concretos. Los GUID deben especificarse entre corchetes ({ y }). Por ejemplo:
\\{5c64c379-c182-4f35-8d30-78d8c2f84502}\{5c64c379-c182-4f35-8d30-78d8c2f84503}
Si especifica el nombre y el GUID, separelós con un punto y coma (;). El primero que se
especifique tendra prioridad en la busqueda. Así pues, en el siguiente ejemplo, el GUID tendra
prioridad:
\\{5c64c379-c182-4f35-8d30-78d8c2f84502};MySystem\{5c64c379c182-4f35-8d30-78d8c2f84503};MyDatabase
En esta sección
• Sintaxis de ruta para las computadores de PI Data Archive
Guía del usuario PI System Explorer
165
Configuración de referencias de datos
• Sintaxis de ruta para las bases de datos de PI AF
• Sintaxis para las rutas relativas
• Ejemplos de referencias a atributos del mismo elemento
• Ejemplos de referencias a atributos de distintos elementos
• Sintaxis de ruta para objetos dinamicós
• Sintaxis de ruta para los tipos de cólección
• Sintaxis de ruta para filtrós
• Caracteres comodines en los filtrós de nombres
Sintaxis de ruta para las computadores de PI Data Archive
Para indicar una ruta totalmente calificada de PI Data Archive, comience la ruta con dos barras
invertidas (\\) seguidas por PI Data Archive.
Para indicar el sistema actual, coloque al principio de la ruta relativa dos barras invertidas (\\).
Por ejemplo, para hacer referencia a una base de datos denominada Database2 en el sistema
actual, escriba:
\\.\Database2
Para especificar una cólección de PI Data Archives, utilice el siguiente formato:
\\PIDataArchives[MyPIDataArchiveName]
Sintaxis de ruta para las bases de datos de PI AF
La base de datos de PI AF sigue la siguiente especificación del PI Data Archive.
Puede iniciar una ruta relativa con una barra invertida simple (\) para indicar la base de datos
actual. Por ejemplo, las siguientes rutas hacen referencia a objetos de la base de datos actual:
\Element2
\Tables[MyTable]
Nota:
Puede acceder a objetos que no son de la base de datos externos a PI System. Debe
identificar la cólección como se demuestra en el siguiente ejemplo:
\\MySystem\Contacts[JSmith]
Sintaxis para las rutas relativas
Utilice un doble signo de punto (..) para indicar el objeto principal. El siguiente ejemplo hace
referencia al Attribute1 de Element2 que se encuentra en la base de datos actual:
..\Element2|Attribute1
Un signo de punto unicó (.) representa al objeto actual. Útilíceló para crear una ruta relativa
desde el objeto actual.
• Cuando el objeto actual es un atributo de PI AF, un signo de punto unicó seguido de una
barra invertida (.\) representa el elemento de PI AF propietario. Por ejemplo:
.\|Attribute1
• Un signo de punto unicó seguido de una barra vertical (.|) hace referencia a un atributo
secundario de PI AF; por ejemplo:
166
Guía del usuario PI System Explorer
Configuración de referencias de datos
.|Attribute1|Attribute2
• Cuando el objeto actual es un elemento de PI AF, se crea una ruta relativa desde la base de
datos; por ejemplo:
\Element1\Element2|Attribute1
Ejemplos de referencias a atributos del mismo elemento
Para referenciar un atributo que pertenece al mismo elemento, puede:
• Identificar el atributo relativo a su atributo antecesor de nivel superior.
• Identificar el atributo relativo al atributo actual (el atributo para el que se va a cónfigurar la
referencia de datos).
Los siguientes ejemplos se refieren a la imagen anterior.
Tipo de referencia
Para hacer referencia Desde este atributo
a este atributo
Escriba:
Atributo principal
Level
|Level
Average
o
..
Atributo primario principal
Level
Interval
|Level
o
..|..
Atributo principal
Average
Interval
|Level|Average
o
..
Atributo del mismo nivel
Average
Minimum
|Level|Average
o
Average
Atributo secundario
Average
Level
|Level|Average
o
.|Average
Atributo descendiente del secundario
Interval
Level
|Level|Average|
Interval
o
.|Average|
Interval
Atributo de nivel superior
Temperature
Cualquier atributo
|Temperature
Guía del usuario PI System Explorer
167
Configuración de referencias de datos
Ruta completa del antecesor de nivel superior
Para hacer referencia a un atributo desde otro atributo perteneciente al mismo elemento,
puede especificar la ruta completa del atributo desde el elemento. Escriba una barra vertical (|)
al principio de la ruta y utilícela para separar niveles de atributos.
En la ilustración anterior, el antecesor de nivel superior del atributo Interval es Level. Para
hacer referencia al atributo Interval desde cualquier otro atributo del mismo elemento,
escriba:
|Level|Average|Interval
Para hacer referencia a cualquier atributo de nivel superior desde cualquier otro atributo del
mismo elemento, escriba el símbóló de barra vertical seguido del nombre del atributo. Por
ejemplo, para hacer referencia al atributo Level desde cualquier lugar, escriba:
|Level
Para hacer referencia al atributo Temperature desde cualquier lugar, escriba:
|Temperature
Atributos del mismo nivel
Para especificar un elemento del mismo nivel, simplemente utilice el nombre del atributo del
mismo nivel. Por lo general, no se necesita ningun otro tipo de nótación; sin embargo, dado que
la referencia de datos de PI Point requiere algunos caracteres de ruta de atributo para
diferenciar esta referencia de una referencia de PI Point, utilice la ruta de atributo completa del
elemento.
En la ilustración anterior, los atributos de Maximum y Minimum son del mismo nivel. Para hacer
referencia al atributo Maximum al cónfigurar el atributo Minimum, debe escribir:
Maximum
Atributos principal y primario principal
Utilice un doble signo de punto (..) para ascender en la jerarquía de atributos. Por ejemplo,
para especificar el atributo principal, utilice:
..
Puede utilizar esta nótación para subir los elementos antecesores del atributo. Por ejemplo,
para hacer referencia al atributo primario principal, utilice:
..|..
En la ilustración anterior, para hacer referencia al atributo Level desde el atributo Average,
escriba:
..
Dado que Level es el atributo principal de nivel superior, otra posibilidad sería escribir:
|Level
No puede utilizar esta nótación para hacer referencia al atributo Temperature desde el
atributo Average, porque Average no es un descendiente de Temperature. Ademas, no puede
utilizar esta nótación para hacer referencia al atributo Average desde el atributo Interval,
porque Average no esta en el nivel superior de la jerarquía de atributos.
Para hacer referencia al atributo Level desde el atributo Interval, escriba:
..|..
No puede utilizar esta nótación para hacer referencia al atributo Maximum desde el atributo
Interval, porque el atributo Interval no es un descendiente del atributo Maximum. En este
caso, tendra que utilizar una ruta completa:
|Level|Maximum
168
Guía del usuario PI System Explorer
Configuración de referencias de datos
Del mismo modo, para hacer referencia al atributo Temperature desde el atributo Interval,
utilice
|Temperature
Atributos descendientes
Para hacer referencia a un atributo secundario, utilice un punto (.), que indica "este atributo",
seguido de una ruta.
En la ilustración anterior, para hacer referencia al atributo Average desde el atributo Level,
escriba:
.|Average
Para hacer referencia al atributo Interval desde el atributo Level, escriba:
.|Average|Interval
No puede utilizar esta nótación para hacer referencia al atributo Interval desde el atributo
Temperature, porque el atributo Interval no es un descendiente del atributo Temperature.
En este caso, tendra que utilizar una ruta completa:
|Level|Average|Interval
Ejemplos de referencias a atributos de distintos elementos
Puede referenciar un atributo que pertenece a diferentes elementos de las siguientes maneras:
• Directamente desde la parte superior de la jerarquía del elemento en la base de datos.
• Especifique el elemento principal del atributo de destino con una ruta relativa.
Atributos relativos a la base de datos
Para hacer referencia a un atributo basandóse en una vía de acceso relativa a la raíz de la base
de datos de PI AF, especifique el elemento entero y la ruta de los atributos de la base de datos.
Escriba una barra invertida (\) al principio de la ruta y utilícela para separar niveles de
elemento. Coloque una barra vertical (|) delante del atributo. Por ejemplo:
\Reactors\React1|pressure
Este ejemplo supone que el elemento Reactors se encuentra en el nivel superior de la
jerarquía de elementos. Siempre puede utilizar esta nótación para hacer referencia a un
atributo relativo al nivel superior de los elementos de la base de datos.
Por ejemplo, suponga que tiene la jerarquía de elementos que se muestra en la siguiente
ilustración:
Suponga que desea hacer referencia a un atributo llamado pressure, que pertenece al
elemento NewTank. Puede escribir lo siguiente:
\Tanks\Tank1\NewTank|pressure
Si desea representar un atributo secundario de pressure llamado temp, la referencia es:
\Tanks\Tank1\NewTank|pressure|temp
Atributos relativos al elemento contenedor
Puede hacer referencia a atributos relativos al elemento contenedor del atributo que va a
cónfigurar. Utilice las barras invertidas (\) para bajar la jerarquía del elemento y .. para subir la
jerarquía del elemento.
Guía del usuario PI System Explorer
169
Configuración de referencias de datos
En la ilustración anterior, cada elemento (Tank1, Tank2, Tank3 y NewTank) tiene un atributo
pressure:
Estos ejemplos demuestran la sintaxis para:
• Haga referencia a un elemento del mismo nivel:
Para hacer referencia a Tank2 del atributo pressure de Tank1, escriba:
..\Tank2|pressure
• Referencia a un elemento principal:
Para hacer referencia a Tank1 del atributo pressure de NewTank, escriba:
..\|pressure
• Referencia a un elemento secundario:
Para hacer referencia al atributo pressure de NewTank de Tank1, escriba:
.\NewTank|pressure
Sintaxis de ruta para objetos dinámicos
Tambien se admiten rutas a objetos dinamicós. Para crear un atributo de matriz de PI point con
los valores Sinusoid y Sinusoidu; por ejemplo:
PI Point Array.\\piserver2\sinusoid|sinusoidu
Si es una ruta a un PI point, se crea un atributo dinamicó. Para crear un atributo con la
referencia de datos cónfigurada para leer valores del PI point Sinusoid, por ejemplo:
\\piserver2\sinusoid
Sintaxis de ruta para los tipos de colección
Cada objeto principal tiene un tipo de cólección predeterminado. Por ejemplo, un PI Data
Archive tiene una cólección de bases de datos predeterminada y una base de datos de PI AF
predeterminada tiene una cólección de elementos predeterminada.
Utilice un signo de punto unicó entre corchetes ([.]) para representar al objeto predeterminado
del objeto principal. El siguiente ejemplo hace referencia al Element1 de la base de datos
predeterminada en el sistema actual:
\\.\Databases[.]\Element1
Sintaxis de ruta para filtros
Un filtró de cólección empieza con el signo arroba (@) seguido del nombre del filtró. Los filtrós
admitidos son @Category, @Description, @Index, @Name, @ReferenceType, @Template,
@Trait, @Type y @UOM.
Debe incluir la especificación del filtró entre corchetes ([ y ]).
Tambien puede especificar varios filtrós, que se evaluaran en el orden especificadó. Por
ejemplo:
\\MySystem\MyDatabase\Elements[@Template=Tank][@Category=Tutorial]|
Attributes[@Category=Tutorial]
Ejemplo de filtro de categoría
El siguiente ejemplo devuelve el atributo Volume de todos los elementos en la categóría,
Tutorial, que pertenecen a la base de datos denominada MyDatabase:
\\MySystem\Databases[MyDatabase]\Elements[@Category=Tutorial]|Volume
170
Guía del usuario PI System Explorer
Configuración de referencias de datos
Ejemplo de filtro de tipo
El siguiente ejemplo devuelve los atributos de Element1 que son del tipo Int32:
\Element1|Attributes[@Type=System.Int32]
Ejemplo de filtro de unidad de medida
El siguiente ejemplo devuelve los atributos de Element1 que utilizan metros como unidad de
medida:
\Element1|Attributes[@UOM=meter]
Ejemplo de filtro de índice
Utilice el filtró de índice [@Index=int] o [int] para especificar la pósición del objeto
coincidente a devolver (el primer elemento esta en la pósición de índice 1). El filtró de índice
debe ser el ultimó índice especificadó. El siguiente ejemplo devuelve la tercera base de datos en
la cólección de bases de datos de PI AF en el sistema actual:
\\Systems[MySystem]\Databases[@Index=3]
A partir de PI AF 2017, puede usar un numeró negativo para un índice desde el final de la
cólección (por ejemplo: -1 indica el elemento final, -2 indica el penultimó elemento).
\Element#1\Elements[@Name=Tank*][@Index=-3]
El nombre del filtró de índice es opcional si se especifica otro filtró delante del filtró de índice.
Por ejemplo:
\Element#1\Elements[@Name=Tank*][3]
Caracteres comodines en los filtros de nombres
Puede colocar el caracter cómódín de asterisco (*) en el nombre de cualquier objeto para que
coincida con cero o mas caracteres.
Nota:
Para encontrar las coincidencias con un asterisco literal, utilice una barra invertida
delante del asterisco (\*).
Ejemplos
\\MySystem\MyDatabase\[@Name=E*]
\\MySystem\MyDatabase\Elements[@Name=E*][@Index=3]
Parámetros de substitución en referencias de datos
Los parametrós de sustitución son variables que se colocan en plantillas de atributos para
referencias de datos, como PI point, el generador de cadenas y Uri Builder. PI AF resuelve los
parametrós de substitución cuando crea la referencia de datos para un atributo basado en esa
plantilla. Por ejemplo, puede usar los parametrós de substitución:
• Para cónfigurar una plantilla de referencia de datos de un PI point, para utilizar nombres
para tags basados en nombres de elementos creados a partir de esa plantilla.
• Para utilizar el valor de un atributo diferente en la cónfiguración de un valor de propiedad
de un PI point.
Videos
Para obtener infórmación sobre cómó utilizar los parametrós de sustitución en las plantillas,
mire este video:
Guía del usuario PI System Explorer
171
Configuración de referencias de datos
https://www.youtube.com/watch?v=8jpOjDRwQf0&rel=0
Para obtener infórmación sobre cómó utilizar los parametrós de sustitución a medida que crea
PI points, mire este video:
https://www.youtube.com/watch?v=pTo9nd_L4vI&rel=0
En esta sección
• Símbólós utilizados en los parametrós de substitución
• Sustituciones de nombre
• Referencias a valores de atributos
• Lista de parametrós de sustitución de PI AF
• Cadenas de formato para parametrós de sustitución de hora
• Encontrar el servidor predeterminado de PI Data Archive
Símbolos utilizados en los parámetros de substitución
Utilice los símbólós en la tabla a cóntinuación para crear un parametró de substitución.
Símbolo
Descripción
Ejemplos
Considera la expresión como un
parametró de substitución.
%Element%
.
Elemento o atributo actual. Utilice .
\ para desplazarse hacia abajo
desde el elemento actual. Utilice .|
para desplazarse hasta los atributos
secundarios del atributo actual.
%.\ChildElement|Attribute%
..
Navega un nivel hacia arriba.
%..\..\Element%
%…%
%Attribute%
%..|Attribute%
172
\
Separa los componentes de una ruta, %..\Element%
excepto los atributos.
|
Separa los atributos en una ruta.
Guía del usuario PI System Explorer
%..|Attribute%
Configuración de referencias de datos
Símbolo
@
Descripción
Hace referencia al valor del objeto
en lugar de su nombre.
Nota:
Solo las referencias de datos
de PI point utilizan la sintaxis
de sustitución del valor de
atributos. Otras referencias de
datos, como la fórmula, la
busqueda de tablas (Table
lookup) y String Builder,
tienen una sintaxis mas simple
para hacer referencia al valor
de los atributos.
Ejemplos
• El valor de atributo al mismo nivel que el atributo:
%@Attribute%
• El valor de atributo al nivel de raíz del mismo
elemento:
%@|Attribute%
• El valor de atributo al nivel de atributo principal:
%@..|Attribute%
• El valor de atributo al nivel de elemento principal:
%@..\|Attribute%
• El valor de atributo del atributo secundario del
mismo elemento:
%@.|Attribute%
• El valor de atributo del atributo de elemento
secundario:
%@.\ChildElement\ChildOfChild|Attribute%
• El valor de atributo del elemento principal de Event
Frames:
%@.\Elements[.]|Attribute%
Sustituciones de nombre
Cuando se utiliza una substitución de nombre, PI AF substituye directamente por el parametró
de substitución aquello que representa ese parametró concreto.
La tabla de Lista de parametrós de sustitución de PI AF enumera los parametrós de
substitución disponibles y aquello que representan. Por ejemplo, %Element% es un parametró
de substitución que representa el nombre del elemento. Despues de crear un elemento basado
en esa plantilla, indique a PI AF que cree la referencia de datos (Actualizaciones del valor de
atributo a partir de referencias de datos de PI Point). Cuando PI AF cree la referencia,
substituira el nombre del elemento actual en cualquier ubicación donde figure %Element% en
la cónfiguración.
Supongamos que tiene una plantilla de referencia de datos que hace referencia al nombre de un
PI point:
%Element%_TT
Cree un elemento denominado Tank1 que se base en esa plantilla. La referencia de datos de
atributo apuntara a un PI point denominado:
Tank1_TT
Referencias a valores de atributos
Al cónfigurar un atributo de referencia de datos de PI points, puede utilizar parametrós de
sustitución para hacer referencia al valor de otro atributo. Puede utilizar referencias de valor
de atributo para especificar un valor en el campo Tiempo relativo o en la cónfiguración de
atributo de punto para los PI points generados de forma autómatica. La sintaxis es la siguiente:
%@AttributeName%
donde AttributeName es el nombre del atributo. La @ indica que debe sustituirse el valor del
atributo indicado, y no su nombre. Para hacer referencia a un atributo que no sea del mismo
Guía del usuario PI System Explorer
173
Configuración de referencias de datos
nivel que el atributo actual, utilice la sintaxis descrita en Referencias de PI Point indirectas para
definir la ruta al atributo deseado.
PI AF no actualiza el valor de atributo a lo largo del tiempo. Cuando se utiliza una substitución
en el nombre de tag, el valor se resuelve solo cuando la referencia de datos se carga. Si un
parametró de substitución se utiliza para definir atributos de punto, PI AF utiliza el valor del
atributo al momento de la creación o actualización de la referencia de datos (consulte
Actualizaciones del valor de atributo a partir de referencias de datos de PI Point para obtener
mas infórmación). Este valor es una constante. PI AF no vuelve a evaluar este atributo, a menos
que actualice la referencia de datos.
Nota:
La excepción a esta regla son las substituciones de valor de Tiempo relativo, que se evalua
con cada llamada de valor a la referencia de datos de PI point (consulte Crear intervalos
de duraciones cónfigurables).
Lista de parámetros de sustitución de PI AF
PI AF interpreta varios tipos de parametrós de sustitución. Las siguientes tablas se agrupan por
tipo:
• Nombre
• Tiempo
• ID
• Description
• Ruta
• Variable de entorno
Parámetros de sustitución de nombre
En la siguiente tabla se incluyen los parametrós de sustitución de nombre que admite PI AF.
174
Nombre de parámetro
Sustitución
%@path%
El valor del atributo del objeto o de la plantilla de atributo,
representado por la ruta.
%Analysis%
Nombre del analisis, si es posible obtenerlo del contexto.
%Attribute%
Nombre del atributo del objeto o de la plantilla de atributo.
%|Attribute%
Nombre del atributo raíz o de la plantilla de atributo que contiene
esta referencia de datos.
%..|Attribute%
Nombre del atributo principal o de la plantilla de atributo que
contiene esta referencia de datos.
%Database%
Nombre de la base de datos PI AF en que reside el atributo.
%Destination%
Nombre del elemento de destino para la transferencia en que reside
el atributo.
%Element%
Nombre del elemento en el que reside el atributo. Para event frames,
esto se refiere al nombre del elemento principal referido.
%\Element%
Nombre del elemento raíz en que reside el atributo.
%..\Element%
Nombre del elemento principal del elemento en que reside el
atributo. Para recuperar mas predecesores, use la anótación ..\,
como %..\..\Element%.
%EventFrame%
Nombre del marco de eventos en el que reside el atributo.
%\EventFrame%
Nombre del marco de eventos raíz en el que reside el atributo.
Guía del usuario PI System Explorer
Configuración de referencias de datos
Nombre de parámetro
Sustitución
%..\EventFrame%
Nombre del Event Frame principal del Event Frame en el que reside
el atributo. Para recuperar mas predecesores, use la anótación ..\,
como %..\..\EventFrame%.
%Model%
Nombre del modelo, si puede obtenerse del contexto.
%Name:path%
Nombre del objeto representado por la ruta hacia el objeto. Si no se
especifica la ruta, devuelve un valor nulo ya que se hace referencia al
nombre del objeto actual.
%Server%
Nombre del PI Data Archive predeterminado. Primero resuelve el PI
AF predeterminado de la base de datos de PI Data Archive si se
especificó; de lo contrario, resuelve el Servidor de PI AF
predeterminado de PI Data Archive si se especificó. Si no se
especifica, se resuelve segun el PI Data Archive predeterminado
local.
Nota:
Si el PI Data Archive predeterminado no se especificó en la
base de datos de Servidor de PI AF o PI AF, se puede resolver
para un PI Data Archive para maquinas del cliente en función
de su cónfiguración.
%Source%
Nombre del elemento de origen para la transferencia en que reside el
atributo.
%System%
Nombre del conjunto o servidor PI AF donde reside el atributo.
%Template%
Nombre de la plantilla en que se basa el elemento o marco de evento.
Por ejemplo, si creó un elemento Valve101 a partir de una plantilla
denominada Valve, el texto de sustitución sería Valve.
%\Template%
Nombre de la plantilla raíz en que se basa el elemento o marco de
evento.
%..\Template%
Nombre de la plantilla principal en que se basa el elemento o marco
de evento. Para recuperar mas predecesores, use la anótación ..\,
como %..\..\Template%.
%Transfer%
Nombre de la transferencia en que reside el atributo.
Parámetros de sustitución de tiempo
PI AF admite parametrós de sustitución que especifiquen una hora o zona de huso horario en
particular, segun el contexto. Otra ópción es aumentar estos parametrós admitidos si se incluye
una cadena de formato que especifique el formato de la cadena de tiempo. Consulte Cadenas de
formato para parametrós de sustitución de hora.
En la siguiente tabla se incluyen los parametrós de sustitución de tiempo que admite PI AF.
Guía del usuario PI System Explorer
175
Configuración de referencias de datos
Nombre de parámetro
Sustitución
%Duration%
Intervalo de tiempo entre la hora de inicio y la hora de finalización, si
se puede obtener del contexto de tiempo. En los marcos de evento
abiertos, obtiene el intervalo de tiempo desde la hora de inicio hasta
la hora actual. El intervalo de tiempo utiliza un formato diferente al
de otros parametrós de sustitución de tiempo.
• Puede utilizar formatos estandares, como "c" (constante), "g"
(general, corto) o "G" (general, largo); por ejemplo:
%Duration:c%. Para obtener mas infórmación, consulte el
artículó de MSDN Cadenas de formato de intervalo de tiempo
estandar (https://msdn.microsoft.com/en-us/library/
ee372286).
• Tambien puede utilizar un formato de intervalo de tiempo
personalizado, como se describe en el artículó de MSDN Cadenas
de formato de intervalo de tiempo personalizado (https://
msdn.microsoft.com/en-us/library/ee372287).
Tenga en cuenta que tiene que definir los símbólós que separan
los días de las horas y así sucesivamente con una cadena literal.
Por ejemplo, %Duration:d\.hh\:mm\:ss% define un punto (.)
como separador entre días y horas, y dos puntos (:) como
separador entre horas, minutos y segundos.
%EndTime%
Hora de finalización local, si se puede recuperar del contexto
temporal. Para objetos basados en marco de evento que no tienen
una hora de finalización especificada, el resultado es una cadena
vacía.
%StartTime%
Hora de inicio local, si se puede recuperar del contexto temporal.
%Time%
Hora local, si se puede recuperar del contexto temporal.
%UtcEndTime%
Hora de finalización universal coordinada (UTC) si se puede
recuperar del contexto temporal. Para objetos basados en marco de
evento que no tienen una hora de finalización especificada, el
resultado es una cadena vacía.
%UtcStartTime%
Hora de inicio universal coordinada (UTC) si se puede recuperar del
contexto temporal.
%UtcTime%
Hora universal coordinada (UTC) si se puede recuperar del contexto
temporal.
Parámetros de sustitución de ID
En la siguiente tabla se incluyen los parametrós de sustitución de ID que admite PI AF.
176
Nombre de parámetro
Sustitución
%AnalysisId%
ID del analisis con que se asocia el atributo.
%AttributeId%
ID del atributo que contiene esta referencia de datos.
%|AttributeId%
ID del atributo raíz o de la plantilla del atributo raíz en que reside el
atributo.
%..|AttributeId%
ID del atributo principal o de la plantilla del atributo principal en
que reside el atributo. Se pueden recuperar mas predecesores
mediante el uso de la anótación ..|, como %..|..|AttributeId%.
%DatabaseId%
ID de la base de datos en que reside el atributo.
%ElementId%
Identificación del elemento en el que reside el atributo. Para los
event frames, esto se refiere a la identificación del elemento
principal referido.
%\ElementId%
ID del elemento raíz en que reside el atributo. En el caso de los
marcos de evento, esto se refiere al ID del elemento con referencia
principal del marco de evento raíz en que reside el atributo.
Guía del usuario PI System Explorer
Configuración de referencias de datos
Nombre de parámetro
Sustitución
%..\ElementId%
ID del elemento principal en que reside el atributo. En el caso de los
marcos de evento, esto se refiere al ID del elemento con referencia
principal del marco de evento principal en que reside el atributo. Se
pueden recuperar mas predecesores mediante el uso de la
anótación ..\, como %..\..\ElementId%.
%EventFrameId%
Identificación del Event Frame en el que reside el atributo.
%\EventFrameId%
ID del marco de evento raíz en que reside el atributo.
%..\EventFrameId%
ID del marco de evento principal en que reside el atributo. Se pueden
recuperar mas predecesores mediante el uso de la anótación ..\,
como %..\..\EventFrameId%.
%Id:path%
ID del objeto representado por la ruta hacia el objeto. Si no se
especifica la ruta, se usa la ID del objeto actual. .
%ModelId%
ID del modelo en que reside el atributo.
%SystemId%
ID del servidor PI AF en que reside el atributo.
%TransferId%
ID de la transferencia en que reside el atributo.
Parámetros de sustitución de descripción
En la siguiente tabla se incluyen los parametrós de sustitución de descripción que admite PI AF.
Nombre de parámetro
Sustitución
%Description:path%
Descripción del atributo representado por la ruta hacia el atributo.
Si no se especifica la ruta, se usa la descripción del atributo actual.
%|Description%
Descripción del atributo raíz o de la plantilla del atributo raíz en
que reside el atributo.
%..|Description%
Descripción del atributo principal o de la plantilla del atributo
principal en que reside el atributo. Se pueden recuperar mas
predecesores mediante el uso de la anótación ..|, como %..|..|
Description%.
%ElementDescription%
Descripción del elemento en el que reside el atributo. En el caso de
los event frames, esto se refiere a la descripción del elemento de
referencia primario del event frame en el que reside el atributo.
%\ElementDescription%
Descripción del elemento raíz donde reside el atributo. En el caso
de los marcos de evento, esto se refiere a la descripción del
elemento con referencia principal del marco de evento raíz en que
reside el atributo.
%..\ElementDescription%
Descripción del elemento principal en que reside el atributo. En el
caso de los marcos de evento, esto se refiere a la descripción del
elemento con referencia principal del marco de evento principal
en que reside el atributo. Se pueden recuperar mas predecesores
mediante el uso de la anótación ..\, como %..\..
\ElementDescription%.
%EventFrameDescription%
Descripción del marco de evento en que reside el atributo.
%\EventFrameDescription%
Descripción del marco de evento raíz en que reside el atributo.
%..\EventFrameDescription%
Descripción del marco de evento principal en que reside el
atributo. Se pueden recuperar mas predecesores mediante el uso
de la anótación ..\, como %..\..\EventFrameDescription%.
Parámetros de sustitución de ruta
Por lo general, las sustituciones de ruta no se pueden usar para crear referencias de otros
atributos porque contienen caracteres de barra invertida. Los parametrós de sustitución de
ruta son mas practicós con las referencias de datos del generador de cadena cuando se
Guía del usuario PI System Explorer
177
Configuración de referencias de datos
construyen rutas para salida en las cadenas. La ruta que no se produce no incluye el servidor ni
la base de datos PI AF.
En la siguiente tabla se incluyen los parametrós de sustitución de ruta que admite PI AF.
Nombre de parámetro
Substitución
%ElementPath%
Ruta del elemento de base, el elemento de un atributo o el elemento
con referencia principal de un marco de evento.
%..\ElementPath%
Ruta del elemento principal en que reside el atributo. En el caso de
los marcos de evento, esto se refiere a la ruta del elemento con
referencia principal del marco de evento principal en que reside el
atributo. Se pueden recuperar mas predecesores mediante el uso de
la anótación ..\, como %..\..\ElementPath%.
%EventFramePath%
Ruta del marco de evento o el elemento de un atributo de un marco
de evento.
%..\EventFramePath%
Ruta del marco de evento principal en que reside el atributo. Se
pueden recuperar mas predecesores mediante el uso de la
anótación ..\, como %..\..\EventFramePath%.
Parámetro variable de entorno
En la siguiente tabla se incluye el parametró variable de entorno que admite PI AF.
Nombre de parámetro
Sustitución
%Environment Variable%
Valor de la variable de entorno del sistema coincidente. Por ejemplo,
%COMPUTERNAME% se reemplaza con el nombre del equipo en que se
ejecuta la referencia de datos.
Cadenas de formato para parámetros de sustitución de hora
En los parametrós de sustitución de tiempo, se puede incluir una cadena de formato que
especifique el formato de la cadena de hora.
Formato estándar de fecha y hora
Use cualquier cadena de formato estandar admitida por el metódó DateTime.ToString, que
se describe en el artículó de MSDN, Cadenas de formato estandar de fecha y hora (https://
docs.microsoft.com/en-us/dotnet/standard/base-types/standard-date-and-time-formatstrings?). En la especificación del parametró de sustitución de hora, separe la sustitución y la
cadena de formato con dos puntos. Por ejemplo, %TIME:d% especifica la hora local en un patrón
de fecha breve.
La siguiente tabla proporciona una descripción abreviada de las cadenas de formato DateTime:
Especificador de
formato
d
Description
Ejemplo
Patrón de fecha breve
6/15/2009 (ingles-EE. UU.)
15/06/2009 (frances-Francia)
2009/06/15 (japónes-Japón)
D
Patrón de fecha extensa
Monday, June 15, 2009 (ingles-EE. UU.)
Montag, 15. Juni 2009 (de-DE)
f
178
Patrón de fecha y hora completo (hora
breve)
Guía del usuario PI System Explorer
Monday, June 15, 2009 1:45 PM
(ingles-EE. UU.)
Configuración de referencias de datos
Especificador de
formato
Description
Ejemplo
F
Patrón de fecha y hora completo (hora
extensa)
Monday, June 15, 2009 1:45:30 PM
(ingles-EE. UU.)
g
Patrón de fecha y hora general (hora
breve)
6/15/2009 1:45 PM (ingles-EE. UU.)
15/06/2009 13:45 (espanól-Espana)
2009/6/15 13:45 (zh-CN)
G
Patrón de fecha y hora general (hora
extensa)
6/15/2009 1:45:30 p. m. (inglesEE. UU.)
15/06/2009 13:45:30 (espanól-Espana)
2009/6/15 13:45:30 (zh-CN)
M, m
Patrón día/mes
June 15 (ingles-EE. UU.)
O, o
Patrón de fecha y hora circular
2009-06-15 T 13:45:30.0000000-07:00
R, r
Patrón RFC1123
Lunes 15 de junio de 2009 20:45:30,
hora del meridiano de Greenwich
s
Patrón de fecha y hora clasificable
15-06-2009 T 13:45:30
t
Patrón de hora breve
1:45 PM (ingles-EE. UU.)
T
Patrón de hora extenso
1:45:30 PM (ingles-EE. UU.)
u
Patrón de fecha y hora clasificable
universal
2009-06-15 20:45:30Z
U
Patrón de fecha y hora completo
universal
Monday, June 15, 2009 8:45:30 PM
(ingles-EE. UU.)
Patrón de mes y anó
June, 2009 (ingles-EE. UU.)
Y, y
Cualquier otro
caracter individual
Especificadór desconocido
Formato de fecha y hora personalizado
Ademas, puede construir patrones personalizados en la cadena de formato de fecha y hora con
los especificadóres de hora que se describen en el artículó de MSDN Cadenas de formato de
fecha y hora personalizado (https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.
110).aspx). Por ejemplo, %TIME:yyyy/MM/dd HH:mm:ss.ffffff% produce un resultado
similar a 31/03/2015 09:28:03.843512.
Encontrar el servidor predeterminado de PI Data Archive
Ahora puede especificar el PI Data Archive, tambien conocido como el servidor de datos
predeterminado, para el sistema de PI System y la base de datos de PI AF. De manera
predeterminada, las bases de datos de PI AF heredan el servidor de datos predeterminado local
de Servidor de PI AF.
Nota:
El parametró %Server% define su PI Data Archive predeterminado. Primero se resuelve
segun el PI Data Archive predeterminado de la base de datos actual de PI AF, si se
especifica; de lo contrario, se resuelve segun el PI Data Archive predeterminado de
Servidor de PI AF. Si no se especifica, se resuelve segun el PI Data Archive
predeterminado local. Si no se especifica el PI Data Archive predeterminado en la base de
datos de Servidor de PI AF o PI AF, se puede resolver segun un PI Data Archive diferente
cónfiguradó para cada uno, en función de los ajustes de las distintas maquinas del cliente.
Guía del usuario PI System Explorer
179
Configuración de referencias de datos
Procedimiento
1. Elija una de las siguientes acciones:
Para…
Haga esto…
Ver el servidor de datos predeterminado para la
base de datos actual
a. En la barra de herramientas de PI System
Explorer, haga clic en
.
b. En la ventana Seleccionar base de datos, haga
clic en Propiedades de la base de datos.
c. Localice el campo Servidor de datos
predeterminado en la pagina General para
ver el servidor de datos predeterminado.
d. Haga clic en Aceptar dos veces.
Ver los ajustes del servidor de datos
predeterminado para el sistema
a. Haga clic en
en la barra de herramientas
de PI System Explorer o haga clic en Archivo >
Propiedades de servidor.
b. Localice el campo Servidor de datos
predeterminado en la pagina General para
ver el servidor de datos predeterminado para
el PI System.
c. Haga clic en Aceptar.
Ver el nombre del servidor de datos
predeterminado
a. En la barra del menu de PI System Explorer,
seleccione Archivo > Conexiones.
b. Localice el icono
para identificar el
servidor de datos predeterminado de PI Data
Archive.
c. Haga clic en Cerrar.
Referencias de datos de PI points
Una referencia de datos de PI point es una referencia que procede de un atributo de PI AF a un
PI point. El valor del atributo de la referencia de datos pódría ser igual que el valor de punto o
el resultado de un calculó sobre valores de punto. Puede crear referencias de datos de PI point
para:
• un atributo de elemento o una plantilla de atributos de elemento
• un atributo de transferencias o una plantilla de atributos de transferencia
• un atributo de Event Frame o una plantilla de atributos de Event Frame
Una referencia de datos de PI point para una plantilla de atributos tiene características
adicionales. Al crear una referencia de datos de PI point en una plantilla de atributos, pódra:
• Crear de forma autómatica tags referenciados por atributos basados en la plantilla.
• Crear un esquema de asignación de nombres para los atributos basados en la plantilla de
forma que los atributos creados a partir de ella tengan nombres exclusivos que tengan una
estructura coherente.
Para hacer referencia a un PI point, utilice una referencia directa o indirecta. Hay dos metódós
rapidós para crear una referencia directa; para crear una referencia directa mas compleja o una
referencia indirecta necesita utilizar la ventana Referencia de datos de PI Point.
180
Guía del usuario PI System Explorer
Configuración de referencias de datos
Videos
Para obtener infórmación sobre cómó cónfigurar referencias de datos de PI point, mire este
video:
https://www.youtube.com/watch?v=CRejcRe22SA&rel=0
Para obtener infórmación sobre las unidades de medida en las referencias de datos de PI point,
mire este video:
https://www.youtube.com/watch?v=023T5si2Dtw&rel=0
En esta sección
• Referencias de PI point directas
• Referencias de PI Point indirectas
• Crear referencias directas de datos de PI Point desde los resultados de la busqueda de tags
• Cónfigurar referencias de datos de PI Point directas o indirectas
• Referencias a valores de atributos
• Consideraciones relativas a las unidades de medida
• Cónfiguración de metódós de recuperación de los valores de un atributo
• El valor de PI point se actualiza a partir de la referencia de datos
• Actualizaciones del valor de atributo a partir de referencias de datos de PI Point
• Cónfigurar la creación de PI Points
• Editar propiedades de PI Point
• Vista previa de los parametrós de substitución en las referencias de datos de PI Point
Referencias de PI point directas
En la cadena de cónfiguración, las referencias de punto directas utilizan dos barras invertidas
(\\) para hacer referencia a un PI point en un PI Data Archive. Por ejemplo, la siguiente cadena
de cónfiguración hace referencia al punto sinusoid en un PI Data Archive llamado MyPIServer:
\\MyPIServer\sinusoid
En el caso de las plantillas de atributos, puede utilizar tambien parametrós de substitución en
la referencia. Por ejemplo, la siguiente cadena de cónfiguración hace referencia al punto
sinusoid en el PI Data Archive predeterminado de la base de datos de PI AF para el atributo:
\\%Server%\sinusoid
Para obtener mas infórmación sobre los parametrós de substitución, consulte Parametrós de
substitución en referencias de datos.
Referencias de PI Point indirectas
Puede cónfigurar una referencia de datos de PI Points para senalar a otro atributo. El propio
atributo referenciado debe ser una referencia de datos de PI Point. Se denomina referencia
indirecta a cualquier PI Point al que hace referencia el atributo de destino. Le resultara util
hacer referencias por atributo si necesita varios atributos que utilicen los datos del mismo PI
Point.
Por ejemplo, supongamos que tiene un atributo denominado Level que hace referencia a un PI
Point que registra el nivel de un tanque. Desea contar con tres atributos secundarios que
almacenen el promedio diario y los niveles maximó y mínimó del tanque. Si cónfigura los tres
Guía del usuario PI System Explorer
181
Configuración de referencias de datos
atributos para hacer referencia al atributo Level, pódra cambiar posteriormente el atributo
Level para que haga referencia a otro punto y no tener que volver a cónfigurar los atributos
secundarios. Utilizado en conjunto con plantillas, reduce considerablemente la cantidad de
cónfiguración requerida por instancia de elemento.
Rutas relativas
Para hacer referencia a otro atributo, la cadena de cónfiguración utiliza una ruta relativa. La
ruta relativa identifica un atributo de referencia de datos en función de su nombre y del lugar
que ocupa en la jerarquía de elementos y atributos. En el caso de la referencia de datos de PI
Point, la ruta debe incluir una designación de ruta de atributo (| o ..) en la cadena de
cónfiguración para que puede diferenciarse de una referencia de PI Point.
En la siguiente tabla, se muestran las cónfiguraciónes típicas de las referencias indirectas:
182
Objeto
Sintaxis
Ejemplo
Atributo de nivel
superior del
mismo elemento
|topLevelAttribute
Consulte "Ruta completa del antecesor
de nivel superior" en Ejemplos de
referencias a atributos del mismo
elemento.
Atributo principal
..
Consulte "Atributos principal y primario
principal" en Ejemplos de referencias a
atributos del mismo elemento.
Atributo
secundario
.|childAttribute
Consulte "Atributos descendientes" en
Ejemplos de referencias a atributos del
mismo elemento.
Atributo del mismo ..|siblingAttribute
nivel (cuando no es
un atributo de
nivel superior)
Consulte "Atributos del mismo nivel" en
Ejemplos de referencias a atributos del
mismo elemento.
Del event frame al .\Elements[.]|Attribute
elemento principal
Consulte Referencias de datos a
atributos en el elemento de referencia
primario.
Del event frame al .\Elements[.]\..\|Attribute
atributo del
elemento principal
Consulte "Ejemplos que utilizan rutas
relativas" en Referencias de datos a
atributos en otros elementos.
Del event frame al
atributo del
elemento
secundario
.\Elements[.]\ChildElementName|
Attribute
Consulte "Ejemplos que utilizan rutas
relativas" en Referencias de datos a
atributos en otros elementos.
Ruta de base de
datos
\TopLevelElement|myAttribute
Consulte "Atributos relativos a la base de
datos" en Ejemplos de referencias a
atributos de distintos elementos.
Ruta completa
\\myServer\myDatabase
\myElement|myAttribute
Consulte Sintaxis de ruta para las
referencias a otros atributos.
Guía del usuario PI System Explorer
Configuración de referencias de datos
Crear referencias directas de datos de PI Point desde los resultados de la
búsqueda de tags
Puede arrastrar un PI point desde los resultados de Búsqueda de tags en la paleta para
establecer el nombre, la descripción (si el PI point tiene un descriptor) y el tipo de referencia
de datos de un PI point. Si la propiedad de unidades de ingeniería del PI point coincide con una
unidad de medida existente, incluido el caso, tambien se define el campo Default UOM (Unidad
de medida predeterminada).
Procedimiento
1. Para cónfigurar una referencia de datos de PI Point:
◦ En el navegador Elementos, seleccione el elemento que desee utilizar.
◦ En una plantilla de elementos, seleccione la plantilla de elementos que desee utilizar en el
navegador Biblioteca.
2. En la pestana Atributo o Plantillas de atributos, seleccione el atributo.
3. Seleccione Ver > Paleta > Búsqueda de tags o presione CTRL + MAYÚS + 8.
4. En la ventana Búsqueda de tags, cree una consulta de busqueda para recuperar los PI points
que desee utilizar como referencias de datos. Para obtener mas infórmación sobre la
busqueda de PI points, consulte Busqueda de PI points y Sintaxis para las busquedas de PI
point.
5. Haga clic en Buscar para recuperar los puntos coincidentes en la tabla de resultados.
6. Realice una de las opciones siguientes:
◦ Para crear un nuevo atributo, arrastre un PI point desde los resultados de busqueda hasta
la cuadrícula Atributos. Se agregara a la cuadrícula un nuevo atributo cónfiguradó como
una referencia de datos basada en el PI point.
◦ Para cónfigurar un atributo existente, seleccione el atributo en el visor y arrastre un PI
point desde los resultados de busqueda hasta el campo Ajustes del atributo para
cónfigurar el atributo como referencia de datos en función del PI point.
7. Haga clic en Ingresar para guardar la referencia de datos.
Configurar referencias de datos de PI Point directas o indirectas
Utilice la ventana Referencia de datos de PI Point para cónfigurar referencias de datos de PI
Point en atributos de elemento.
Procedimiento
1. En la pestana Atributos del visor, seleccione un atributo.
2. En la sección de cónfiguración de atributos, seleccione PI Point de la lista Referencia de
datos.
3. Haga clic en Ajustes.
Consejo:
Puede hacer clic en el campo Configuración e ingresar un nombre de tag para crear
una referencia de datos de PI Point directa en formato \\serverName\tagname. PI
System Explorer obtiene el nombre de tag del PI Data Archive predeterminado. Por
ejemplo, si introduce sinusoid, la referencia de datos de PI Point muestra \
\yourDefaultDataArchive\sinusoid.
Guía del usuario PI System Explorer
183
Configuración de referencias de datos
4. En la ventana Referencia de datos de PI Point, elija una de las siguientes acciones para crear
la referencia de datos.
Para…
Haga lo siguiente…
Crear una referencia de datos de PI Point directa
a. Deje el servidor predeterminado o elija un PI
Data Archive diferente desde la lista Servidor
de datos.
Nota:
Si el PI Data Archive deseado no aparece en
la lista, haga clic en
y seleccione un PI
Data Archive desde la ventana PI Data
Archives.
b. En el campo Nombre de tag escriba el
nombre del punto o haga clic en
para
buscar un punto en el PI Data Archive
seleccionado.
Consejo:
Puede introducir un parametró de
substitución en lugar del nombre del tag. Si
esta creando una referencia en una plantilla
de atributos, puede utilizar parametrós de
substitución en ambos campos: Servidor de
datos y Nombre de tag. Consulte Lista de
parametrós de sustitución de PI AF.
Crear una referencia de datos de PI Point
indirecta
a. Seleccione la ópción Atributo.
b. Escriba una ruta relativa al atributo, o elija
una de la lista desplegable de atributos que
tienen referencias de datos de PI Point.
Para escribir una ruta, utilice la sintaxis que
se describe en Referencias de PI Point
indirectas. El atributo al que se hace
referencia tambien debe tener una referencia
de datos de PI point.
5. Opcional. Especifique las unidades que utiliza el PI Point referenciado. Consulte
Consideraciones relativas a las unidades de medida.
Nota:
Para los totales ponderados en el tiempo, en los atributos de referencia de datos de PI
Point a los que se hace referencia, asegurese de seleccionar una unidad de medida en
la lista Source Units (Unidades de origen) que coincida con la unidad de medida del
atributo de origen. Incluso, si las unidades de origen predeterminadas parecen
coincidir con la unidad de medida del atributo de origen, no seleccione <Default>, sino
la unidad de medida de códificación fija adecuada de la lista.
6. En la sección Métodos de recuperación de valores, especifique cómó el atributo obtiene su
valor. Por ejemplo, el valor de atributo pódría ser igual que el valor de punto o el resultado
de un calculó sobre el valor de punto. Consulte Cónfiguración de metódós de recuperación
de los valores de un atributo.
7. Utilice la casilla de verificación Solo lectura para especificar si desea que PI AF vuelva a
escribir el valor de atributo en el punto de origen. De forma predeterminada, PI AF no
escribe datos en el PI Point referenciado (la casilla de verificación Solo lectura esta
seleccionada). Consulte El valor de PI point se actualiza a partir de la referencia de datos.
184
Guía del usuario PI System Explorer
Configuración de referencias de datos
Referencias a valores de atributos
Al cónfigurar un atributo de referencia de datos de PI points, puede utilizar parametrós de
sustitución para hacer referencia al valor de otro atributo. Puede utilizar referencias de valor
de atributo para especificar un valor en el campo Tiempo relativo o en la cónfiguración de
atributo de punto para los PI points generados de forma autómatica. La sintaxis es la siguiente:
%@AttributeName%
donde AttributeName es el nombre del atributo. La @ indica que debe sustituirse el valor del
atributo indicado, y no su nombre. Para hacer referencia a un atributo que no sea del mismo
nivel que el atributo actual, utilice la sintaxis descrita en Referencias de PI Point indirectas para
definir la ruta al atributo deseado.
PI AF no actualiza el valor de atributo a lo largo del tiempo. Cuando se utiliza una substitución
en el nombre de tag, el valor se resuelve solo cuando la referencia de datos se carga. Si un
parametró de substitución se utiliza para definir atributos de punto, PI AF utiliza el valor del
atributo al momento de la creación o actualización de la referencia de datos (consulte
Actualizaciones del valor de atributo a partir de referencias de datos de PI Point para obtener
mas infórmación). Este valor es una constante. PI AF no vuelve a evaluar este atributo, a menos
que actualice la referencia de datos.
Nota:
La excepción a esta regla son las substituciones de valor de Tiempo relativo, que se evalua
con cada llamada de valor a la referencia de datos de PI point (consulte Crear intervalos
de duraciones cónfigurables).
Consideraciones relativas a las unidades de medida
Al definir una referencia de datos de PI point, puede opcionalmente especificar las unidades
que utilizara el PI point referenciado. Si es posible, PI AF cambiara de forma autómatica el tipo
de atributo a un tipo de valor compatible con las unidades especificadas.
Sin embargo, si el atributo se ha definidó mediante una plantilla de atributos, PI AF no pódra
cambiar el tipo. En su lugar, PI AF intentara convertir el valor en el tipo de valor de la plantilla.
Si PI AF no puede convertir el valor, generara un error.
Configuración de métodos de recuperación de los valores de un atributo
Las aplicaciones cliente solicitan valores de atributo para una hora concreta o un intervalo de
tiempo. Por ejemplo, en PI ProcessBook, la pantalla puede proporcionar tambien un contexto
de intervalo de tiempo (en la pantalla debe estar presente un símbóló de intervalo de tiempo,
como por ejemplo una tendencia, para permitir la recepción de un intervalo de tiempo).
Cónfigure, por lo general, la referencia de datos para que espere una hora o un intervalo de
tiempo. Entonces, el valor de un atributo sera:
• El valor del punto en un momento específicó. Consulte Cónfigurar la óbtención de valores
por hora.
• El resultado de un calculó de los valores del punto a lo largo de un intervalo de tiempo.
Consulte Cónfigurar la óbtención de valores por intervalo de tiempo. Por ejemplo, el valor de
atributo puede ser el promedio de los valores de punto a lo largo de una hora.
Videos
Para obtener infórmación sobre cómó recuperar valores agregados en las referencias de datos
de PI point, mire este video:
Guía del usuario PI System Explorer
185
Configuración de referencias de datos
https://www.youtube.com/watch?v=GU3kp7W7a6w&rel=0
Para obtener infórmación sobre cómó recuperar un solo valor en una referencia de datos de PI
point, desplazado por un períódó, mire este video:
https://www.youtube.com/watch?v=4Mv5aZWz2j8&rel=0
En esta sección
• Tiempo relativo
• Opciones de recuperación de tiempo
• Opciones de recuperación de intervalo
• Cónfigurar la óbtención de valores por hora
• Cónfigurar la óbtención de valores por intervalo de tiempo
• Crear intervalos de duraciones cónfigurables
• Crear intervalos de tiempo predeterminados para los atributos de elementos
• Cónfigurar calculós de intervalos de tiempo dinamicós
• Intervalos de tiempo para event frames y transferencias
Tiempo relativo
Las expresiones de tiempo relativo son un numeró de días (d), horas (h), minutos (m) o
segundos (s) especificadó con un signo mas (+) o menos (-) delante. El campo Tiempo relativo
de la ventana Referencia de datos de PI Point cambia el contexto de tiempo con el
desplazamiento especificadó. Por ejemplo, si un cliente solicita un valor de atributo a la hora
actual, donde la expresión de tiempo relativo es -8h, PI AF devuelve datos de ocho horas antes
de la hora actual.
Se admiten tiempos fraccionarios. Por ejemplo, utilice -1.5d para indicar un día y medio.
Las expresiones de tiempo relativo pueden incluir solo un operador: + o -. Por ejemplo, lo
siguiente no se admite:
-1d+1h
Los siguientes son tiempos relativos validós:
+1d
-24h
-3.25m
+24s
Opciones de recuperación de tiempo
La siguiente tabla describe las opciones disponibles para el metódó de recuperación de valores
Por tiempo en la ventana Referencia de datos de PI Point.
186
Opción
Description
Después
Devuelve el primer valor registrado despues de la hora solicitada por la
aplicación cliente.
En o después de
Devuelve un valor registrado en la hora de la solicitud de la aplicación cliente.
Si no existe ningun valor a la hora especificada, se devuelve el siguiente valor
registrado.
En o Antes
Devuelve un valor registrado en la hora de la solicitud de la aplicación cliente.
Si no existe ningun valor en la hora especificada, se devuelve el valor
registrado anterior.
Guía del usuario PI System Explorer
Configuración de referencias de datos
Opción
Description
Automático
Un punto continuo (atributo escalón = 0) se considera como interpolado; un
punto discreto (atributo escalón = 1) se considera como At or Before.
Antes
Devuelve el primer valor registrado antes de la hora solicitada por la
aplicación cliente.
Hora exacta
Devuelve un valor registrado en la hora de la solicitud de la aplicación cliente.
Si no existe ningun valor registrado para esa hora, se devuelve un error.
Interpolado
Devuelve un valor interpolado para la hora de la solicitud de la aplicación
cliente. Los puntos discretos (atributo step = 1) arrastran el valor anterior.
No admitido
Se utiliza en los calculós de rango temporal unicamente. Si la aplicación
cliente envía una hora en lugar de un intervalo de tiempo, PI AF devólvera un
mensaje de error como valor de atributo.
Intervalo de tiempo
Se utiliza en los calculós de rango temporal unicamente. Crea un rango
temporal predeterminado para utilizar si la aplicación cliente envía una hora,
en lugar de un rango temporal. Si selecciona esta ópción, debe escribir una
expresión de tiempo relativa de PI en el campo Tiempo relativo. Consulte
Crear intervalos de tiempo predeterminados para los atributos de elementos
para obtener mas detalles.
Sustituir intervalo de
tiempo
Se utiliza en los calculós de rango temporal unicamente. Especifica un rango
temporal que siempre prevalezca sobre el rango temporal suministrado por
la aplicación cliente. Puede especificar:
• Una duración fija, como se describe en Crear intervalos de duraciones
cónfigurables.
• Una duración calculada dinamicamente, como se describe en Cónfigurar
calculós de intervalos de tiempo dinamicós.
Opciones de recuperación de intervalo
La siguiente tabla describe las opciones disponibles para el metódó de recuperación de valor
Por intervalo tiempo en la ventana Referencia de datos de PI Point.
Opción
Descripción
Promedio
Devuelve el valor promedio a lo largo del intervalo de tiempo.
Recuento
Devuelve el total de eventos a lo largo del intervalo de tiempo, cuando Base
de cálculo se cónfigura en Ponderado a evento. Devuelve la suma de la
duración del evento a lo largo del intervalo de tiempo, cuando Base de cálculo
se cónfigura en cualquiera de las opciones de pónderación de tiempo.
Delta
Devuelve la diferencia entre el valor al final del intervalo de tiempo y el valor
al principio del intervalo de tiempo.
Hora de finalización
Devuelve el valor de la hora del final del intervalo de tiempo.
Máximo
Devuelve el valor maximó a lo largo del intervalo de tiempo.
Nota:
El valor de la marca de tiempo muestra la hora en que se produjo el
valor maximó.
Mínimo
Devuelve el valor mínimó a lo largo del intervalo de tiempo.
Nota:
El valor de la marca de tiempo muestra la hora en que se produjo el
valor mínimó.
Desviación estándar de
población
Devuelve la desviación estandar de póblación a lo largo del intervalo de
tiempo.
Guía del usuario PI System Explorer
187
Configuración de referencias de datos
Opción
Descripción
Intervalo
Devuelve el intervalo de valores a lo largo del intervalo de tiempo (maximó y
mínimó)
Desviación estándar
Devuelve la desviación estandar a lo largo del intervalo de tiempo.
Hora de inicio
Devuelve el valor de la hora de inicio del intervalo de tiempo.
Total
Devuelve una tótalización a lo largo del intervalo de tiempo.
Configurar la obtención de valores por hora
Las solicitudes de un valor de atributo por parte de las aplicaciones cliente incluyen una hora.
Especifique cómó debe interpretarse esa hora para obtener los valores del atributo.
Procedimiento
1. Seleccione una ópción de la lista Por tiempo. La ópción predeterminada es Automático. Para
obtener mas infórmación, consulte Opciones de recuperación de tiempo.
2. Opcional. Si se ha cónfiguradó un atributo para que devuelva el valor a una hora
determinada, puede cónfigurar un retardo respecto de la hora solicitada. Esto puede
resultarle util cuando cree atributos con retardo de tiempo muerto.
En el campo Tiempo relativo, escriba el tiempo relativo del retardo. Utilice una expresión de
tiempo relativo de PI, como se describe en Tiempo relativo.
Nota:
Tambien puede utilizar parametrós de sustitución para leer el tiempo relativo a partir
del valor de otro atributo, como se describe en (Referencias a valores de atributos).
3. Seleccione una ópción de la lista Por intervalo tiempo. La ópción predeterminada es Hora de
finalización. Para obtener mas infórmación, consulte Opciones de recuperación de intervalo.
4. Haga clic en Aceptar.
Configurar la obtención de valores por intervalo de tiempo
Si desea que el valor de atributo sea el resultado de un calculó resumido a lo largo de un
períódó de tiempo, cónfigure la óbtención de valores por intervalo de tiempo.
Procedimiento
1. Seleccione una ópción de la lista Por tiempo. La ópción predeterminada es Automático. Para
obtener mas infórmación, consulte Opciones de recuperación de tiempo.
2. Seleccione una ópción de la lista Por intervalo tiempo. La ópción predeterminada es Hora de
finalización. Para obtener mas infórmación, consulte Opciones de recuperación de intervalo.
3. Si se habilita la lista Base de cálculo, seleccione una de las siguientes opciones.
Nota:
Si selecciona una de las opciones ponderadas en tiempo para un total, las unidades de
origen se convierten a un índice. Seleccione la unidad de tiempo de la lista junto al
campo Unidades de origen.
188
Guía del usuario PI System Explorer
Configuración de referencias de datos
Opción
Descripción
Ponderado a evento
Evalua valores con una pónderación equivalente para cada evento.
No se realiza ninguna interpólación. Para realizar un calculó
correcto, debe haber como mínimó un evento dentro del intervalo
de tiempo. Se necesitan dos eventos para calcular la desviación
estandar.
Al manejar eventos en el límite del calculó, PI AF utiliza las
siguientes reglas:
◦ Los eventos de ambos límites se utilizan cuando existe solo un
intervalo de calculó.
◦ Los eventos en la hora de inicio se incluyen cuando existen
multiples intervalos y estos se encuentran en orden de tiempo
ascendente.
◦ Los eventos en la hora de finalización se incluyen cuando
existen multiples intervalos y estos se encuentran en orden de
tiempo descendiente.
Evento ponderado: excluir
evento más reciente
Se comporta de la misma manera que un Evento ponderado,
excepto en el manejo de eventos en el límite de los intervalos de
resumen, en un calculó de intervalos multiples. Utilice esta ópción
para evitar que los eventos en los límites de intervalos se cuenten
dos veces en ambos intervalos. Con esta ópción, los eventos de la
hora de finalización (el tiempo mas reciente) de un intervalo no se
utilizan en ese intervalo.
Evento ponderado: excluir
evento más antiguo
Similar a la ópción de Evento ponderado: excluir evento más
reciente. Los eventos de la hora de inicio (hora mas temprana) de
un intervalo no se utilizan en ese intervalo.
Evento ponderado: incluir
ambos extremos
Los eventos de los dos extremos de los límites del intervalo se
incluyen en el calculó ponderado a evento.
Ponderado en tiempo
Pondera los valores del calculó a lo largo del intervalo durante el
cual se aplican. La interpólación se basa en el atributo step del
punto. Los eventos interpolados se generan en los límites si es
necesario.
Ponderado en tiempo continuo
Aplica la pónderación como en Ponderado en tiempo, pero realiza
todas las interpolaciones entre valores como si representaran
datos continuos (interpólación estandar), independientemente del
step atributo del punto.
Tiempo ponderado discreto
Aplica la pónderación como en Ponderado en tiempo, pero realiza
las interpolaciones entre valores como si representaran valores
discretos y no relacionados (plot escalonado),
independientemente del step atributo del punto.
4. En el campo Mín. porcent. correcto, introduzca un valor entre 0 y 100. Este porcentaje
representa el intervalo de tiempo mínimó durante el cual un valor debe ser correcto para
devolver un valor de resumen. Para los calculós ponderados en tiempo, el porcentaje esta
basado en el tiempo. Para los calculós ponderados a eventos, el porcentaje esta basado en el
total de eventos.
5. Haga clic en Aceptar.
Crear intervalos de duraciones configurables
Para garantizar que los intervalos de tiempo tengan siempre la misma duración, cónfigure
anulaciones de intervalo de tiempo.
Guía del usuario PI System Explorer
189
Configuración de referencias de datos
Procedimiento
1. Desde la lista Por tiempo, seleccione Anular intervalo de tiempo.
2. En el campo Tiempo relativo, escriba una expresión de tiempo relativa de PI en Tiempo
relativo.
PI AF crea un intervalo de tiempo en función de la hora de finalización suministrada por la
aplicación cliente y el desplazamiento definidó por el tiempo relativo.
Nota:
Puede utilizar parametrós de sustitución para leer el tiempo relativo a partir del valor
de otro atributo, como se describe en Referencias a valores de atributos. En este caso,
PI AF evalua el valor del atributo referenciado en el momento de cada solicitud de
datos.
Ejemplo
Para crear un promedio continuo de una hora, se utiliza la siguiente cónfiguración:
• Desde la lista Por tiempo, seleccione Anular intervalo de tiempo.
• En el cuadro Tiempo relativo, escriba -1h.
• Desde la lista Por intervalo de tiempo, seleccione Promedio.
Con esta cónfiguración, la referencia de datos siempre calcula una media de una hora, incluso
aunque la aplicación cliente especifique un intervalo de tiempo diferente.
Crear intervalos de tiempo predeterminados para los atributos de
elementos
Puede crear un intervalo de tiempo predeterminado para atributos de elemento. Un intervalo
de tiempo predeterminado es un intervalo que PI AF utiliza cuando la aplicación cliente
proporciona una hora concreta en lugar de un intervalo de tiempo.
Nota:
Los atributos de transferencia y los event frames consideran los intervalos de tiempo de
manera diferente, como se describe en Intervalos de tiempo para event frames y
transferencias.
Procedimiento
1. En la ventana Referencia de datos de PI Point (o Referencia de datos de matriz de PI Point), use
la siguiente cónfiguración de recuperación de valores:
a. En la lista Por tiempo, seleccione Intervalo de tiempo.
b. En el campo Tiempo relativo, escriba una expresión de tiempo relativa de PI en Tiempo
relativo.
Nota:
Tambien puede utilizar parametrós de sustitución para leer el tiempo relativo a
partir del valor de otro atributo, como se describe en (Referencias a valores de
atributos).
190
Guía del usuario PI System Explorer
Configuración de referencias de datos
PI AF crea un intervalo de tiempo en función de la hora especificada por la aplicación cliente
y el desplazamiento definidó por el tiempo relativo.
Ejemplo
Un medidor de tótalización requiere un intervalo de tiempo para poder entregar un valor
totalizado. Si la aplicación cliente envía una hora concreta, tendra que crear un intervalo de
tiempo de una hora que finalice en la hora especificada. Para hacerlo, utilizara los siguientes
ajustes:
1. En la lista Por tiempo, seleccione Intervalo de tiempo.
2. En el campo Tiempo relativo, escriba:
-1h
3. En la lista Por intervalo de tiempo, seleccione Total.
Nota:
Para un totalizador de 24 horas, pódría establecer un tiempo relativo de -24h o -1d.
Configurar cálculos de intervalos de tiempo dinámicos
Utilice un atributo de PI AF para calcular el intervalo de tiempo en función de factores
variables. Puede utilizar posteriormente el valor de atributo para determinar el intervalo de
tiempo de forma dinamica. Los valores de atributo deben ser tiempos relativos de PI validós,
como se describe en Tiempo relativo.
Procedimiento
1. Cónfigure un atributo para generar tiempos relativos de PI. El atributo puede hacer
referencia a un conjunto de enumeración que contenga tiempos relativos de PI o puede
crear tiempos relativos de PI en función de un calculó.
2. Cónfigure la referencia de datos de PI Point.
a. Desde la lista Por tiempo, seleccione Anular intervalo de tiempo.
b. En el campo Tiempo relativo, escriba:%@AttributeName% donde AttributeName es el
nombre del atributo que genera los valores de tiempo relativo de PI.
c. En la lista Por intervalo tiempo, seleccione un metódó de calculó.
Resultados
Con esta cónfiguración, la referencia de datos utiliza el tiempo relativo calculado como un
desplazamiento de tiempo que determina el intervalo de tiempo.
Consulte Ejemplo de hora de finalización variable para ver un ejemplo paso a paso.
Ejemplo de hora de finalización variable
En este ejemplo, se crea una referencia de datos con una hora de finalización variable.
Procedimiento
1. Cree un conjunto de enumeración, MyEnumSet, que contenga estos tres valores:
-30m
-1h
-2h
Guía del usuario PI System Explorer
191
Configuración de referencias de datos
Nota:
Los valores deben ser expresiones validas de tiempo relativo, como se describe en
Tiempo relativo.
2. Cree un atributo, denominado TimeRangeAttribute, que haga referencia al conjunto de
enumeración MyEnumSet.
Especifica el conjunto de enumeración cuando cónfigura el atributo. Desde la lista
desplegable Tipo de valor, seleccione Conjuntos de enumeración > MyEnumSet.
3. Cree otro atributo, denominado DataReferenceAttribute con una referencia de datos de
PI Point:
a. Para el PI Point, seleccione cualquier punto que tenga un valor numericó. En este
ejemplo, utilizaremos el punto sinusoid de un PI Data Archive denominado PISRV1.
b. Desde la lista Por tiempo, seleccione Anular intervalo de tiempo.
c. En el campo Tiempo relativo, escriba: %@TimeRangeAttribute%
d. Desde la lista Por intervalo de tiempo, seleccione Promedio.
Resultados
El atributo TimeRangeAttribute le permite elegir el intervalo de tiempo para el calculó.
Intervalos de tiempo para event frames y transferencias
Los event frames y las transferencias, por su naturaleza, tienen un intervalo de tiempo
asociado. Cuando una aplicación que realiza una llamada solicita un valor de un atributo, el
valor devuelto dependera de la referencia de datos y su cónfiguración:
• Cuando la aplicación que realiza la llamada no proporciona ningun contexto, PI AF calculara
el valor de atributo mediante el intervalo de tiempo de Event Frame o transferencia. Por
ejemplo, si un atributo contiene un PI Point cónfiguradó con una ópción de resumen de
intervalo de tiempo, el resumen se realizara a lo largo del intervalo de tiempo del marco de
evento o transferencia.
192
Guía del usuario PI System Explorer
Configuración de referencias de datos
Si un atributo contiene un PI Point cónfiguradó con la ópción de tiempo predeterminada, PI
AF devuelve el valor del punto a la hora de finalización de marcos de evento.
• Si la aplicación que realiza la llamada proporciona una marca de tiempo unica, PI AF
devuelve el valor a la hora especificada, aunque la hora este fuera del intervalo de tiempo
del marco de evento o la transferencia.
• Si la aplicación que realiza la llamada proporciona un intervalo de tiempo, entonces PI AF
utiliza la intersección del intervalo de tiempo proporcionado y el del marco de evento. Si no
hay ninguna intersección, se devólvera un evento de "Sin datos".
El area sombreada de la figura a cóntinuación representa la intersección entre un intervalo
de tiempo de marcos de evento y un intervalo de tiempo solicitado. Para los atributos que
contienen un PI Point cónfiguradó con una ópción de resumen de intervalo de tiempo, el
resumen se realizara a lo largo de esta intersección. Si el atributo contiene un PI Point
cónfiguradó solo con la ópción de tiempo predeterminada, el valor se devólvera a la hora de
inicio de la intersección.
Intersección entre el intervalo de tiempo del marco de evento y el intervalo de tiempo solicitado.
El valor de PI point se actualiza a partir de la referencia de datos
Los atributos con referencias de datos de PI points pueden escribir valores en los PI points. En
la ventana de cónfiguración Referencia de datos de PI point la casilla de verificación Solo lectura
determina si el atributo puede escribir datos en el PI point referenciado. La casilla de
verificación esta seleccionada de forma predeterminada (Solo lectura = Verdadero); por lo
tanto, el atributo PI AF no puede cambiar el valor del PI Point.
En casos excepcionales, es posible que desee volver a escribir el valor del atributo en el valor
del punto. Por ejemplo, si el valor del atributo es el resultado de un calculó o de un analisis,
puede actualizar el PI point con el resultado de este analisis. En este caso, borre la casilla de
verificación Solo lectura para permitir que el atributo escriba su valor en el punto.
Nota:
Las aplicaciones que utilizan el metódó de AF SDK UpdateValue , como PI Analysis
Service, pueden escribir datos en el PI Point independientemente de que se haya marcado
o no la casilla de verificación Solo lectura.
Guía del usuario PI System Explorer
193
Configuración de referencias de datos
Actualizaciones del valor de atributo a partir de referencias de datos de PI
Point
Cuando se crea un atributo basado en una plantilla con una referencia de datos, PI AF no crea
de forma autómatica las referencias de datos de PI Points asociadas con ese elemento. Para
crear las referencias de datos, debe hacer clic con el bótón secundario en el elemento del
navegador Elementos (o Marcos de evento) y hacer clic en Create or Update Data Reference
(Crear o actualizar referencia de datos). PI AF reemplaza todos los parametrós de sustitución
con los valores correspondientes en ese momento, y crea y bloquea la referencia de datos.
Bloqueo de referencia de datos
Cuando se bloquea una referencia de datos, los cambios en la plantilla de atributos ya no
afectan a las instancias del atributo. Tampoco se evaluan los parametrós de sustitución. Sin
embargo, los siguientes campos son excepciones:
• En el campo Tiempo relativo, se introduce una referencia del valor del atributo, como se
indica en Referencias a valores de atributos.
• Cualquier cambio de atributo del punto realizado en la ventana Ajustes de creación de tag.
Por ejemplo, si se realiza un cambio en el atributo del punto o si los parametrós de sustitución
definen un atributo del punto, la referencia de datos de los atributos derivados seguira siendo
afectada cada vez que haga clic con el bótón secundario en un elemento y luego haga clic en
Create or Update Data Reference (Crear o actualizar referencia de datos).
Restablecimiento de la referencia de datos
Despues del bloqueo de un valor de atributo, puede utilizar la función Restablecer a plantilla
para restablecer un elemento a las propiedades originales de su plantilla, como se describe en
Restablecer valor del atributo a sus propiedades originales.
Indicadores de atributos para actualizaciones de referencias de datos de
PI point
PI System Explorer utiliza distintos indicadores visuales para los atributos compatibles con la
ópción Crear o actualizar referencia de datos. Tambien se muestra un indicador visual cuando
un atributo ya no parece estar cónfiguradó correctamente, como despues de que se módifica un
servidor o un nombre de tag.
Los siguientes indicadores visuales para la ópción Crear o actualizar referencia de datos estan
disponibles:
Icono Description
194
Columna
El atributo se asocia con una plantilla que contiene reglas de
creación de puntos. Utilice la ópción Crear o actualizar PI point
para crear la cónfiguración de tags basandóse en la plantilla.
Asimismo, se resólveran el nombre y el ID del punto.
Columna Elemento de
configuración ( )
Especifica si la cónfiguración de referencia de datos de un
atributo difiere de la infórmación almacenada en el servidor de
datos especificadó. Esto puede ocurrir cuando se cambia el
nombre de un punto, cuando la referencia de datos de un
atributo se vincula con un PI Point sin un valor (flótante) o
cuando se reemplaza el PI Data Archive subyacente. Utilice la
ópción Crear o actualizar PI Point para actualizar la
cónfiguración.
Columna Elemento de
configuración ( )
Guía del usuario PI System Explorer
Configuración de referencias de datos
Icono Description
Columna
La referencia de datos ha devuelto un estado digital del sistema
en lugar de un valor típicó del origen. Un ejemplo es cuando un
PI Point ha sido creado, pero no tiene ningun dato.
Columna Indicador de calidad
( )
El valor devuelto por la referencia de datos es de mala calidad.
Un ejemplo es cuando un PI Point ha sido creado, pero aun no
tiene ningun dato.
Columna Indicador de calidad
( )
El atributo es un elemento de cónfiguración. Consulte
Propiedad de atributo de elemento de cónfiguración si desea
mas infórmación.
Columna Elemento de
configuración ( )
Nota:
La ópción Crear o actualizar referencia de datos no es
aplicable a los atributos de elementos de cónfiguración.
Al revisar los atributos de elementos en la pestana Atributos, la primera entrada en la columna
a la izquierda del nombre de un atributo de referencia de datos indica si puede ejecutar la
ópción Crear o actualizar referencia de datos. Inicie la ópción Crear o actualizar referencia de
datos al hacer clic con el bótón secundario sobre un elemento o un atributo y luego hacer clic
en Crear o actualizar PI Point.
La óperación Crear o actualizar referencia de datos actualiza una referencia de datos de PI
point con cualquier cambio que se haya producido en el PI point; los parametrós de
substitución se resuelven y los ID de servidor y de punto se actualizan. Si el PI point no existe
tódavía, y la cónfiguración contiene una ópción de creación de punto, se crea.
Ejemplo de actualización de atributos
Cuando vea que el indicador se muestra para un atributo, puede actualizar su cónfiguración
haciendo clic con el bótón secundario y luego haciendo clic en Crear o actualizar PI point.
Nota:
El icono no determina con anterioridad si se próduciran cambios en el tag o en su
cónfiguración.
Indicador de atributos con tooltip
Como el tooltip que se muestra arriba lo indica, al actualizar la cónfiguración, las reglas de
substitución de nombre de punto se resuelven y el identificadór del punto se guarda en los
metadatos del atributo. Esto permite una inicialización posterior mas rapida.
Guía del usuario PI System Explorer
195
Configuración de referencias de datos
Nota:
Puede usar el bótón Lista de columnas
para agregar o eliminar columnas en la
ventana Atributos.
Configurar la creación de PI Points
En una plantilla de atributos, es posible cónfigurar una referencia de datos de PI Point para
crear PI Points.
Procedimiento
1. En el navegador Biblioteca, seleccione una plantilla de elementos.
2. Haga clic en la pestana Plantillas de atributos.
3. Anada una plantilla de atributos nueva a la plantilla de elementos tal como se describe en
Crear plantillas de atributos.
4. En la lista Referencia de datos, seleccione PI Point.
5. Haga clic en Ajustes.
6. En el campo Nombre de tag de la ventana Referencia de datos de PI point, cónfigure los
nombres de PI Point para los puntos generados. Utilice parametrós de substitución para que
PI AF cree nombres de punto para los puntos que genera.
a. Haga clic en
para seleccionar la substitución de nombre y los valores de atributo
relacionados desde un menu contextual. Para obtener mas infórmación sobre los valores
de substitución de nombre, consulte Lista de parametrós de sustitución de PI AF.
Nota:
Si la substitución de valor del atributo es una cadena que contiene espacios, debera
rodear todo el nombre del tag entre comillas dobles. Concatene primero toda la
cadena y substituya despues el valor en la pórción del nombre del tag de la cadena
con el generador de cadenas. Por ejemplo:
"\\%Server%\%Element%.%ID%.%@ConcatStringName%;pointtype=String"
b. Seleccione la casilla de verificación Creación de tag.
c. Haga clic en
.
d. En la ventana Ajustes de creación de tag, especifique una clase de punto y un tipo de
punto en los campos Clase de punto y Tipo de punto. Para obtener mas infórmación
sobre las clases y los atributos de PI point, consulte el tema "Point classes and attributes"
in Live Library (https://livelibrary.osisoft.com).
e. Los valores de atributo predeterminados se muestran para la clase de punto
seleccionada. Puede editar los atributos de PI Point predeterminados o hacer clic en
Importar para importar los valores de atributo de PI Point de un punto existente que
puede localizar en la ventana Búsqueda de tags.
7. Para realizar una vista previa de cómó resolver los parametrós de substitución
seleccionados, haga clic en el vínculó Seleccionar instancia de ejemplo en la sección Vista
previa.
8. En la ventana Find Derived Elements for Element_Template (Buscar elementos derivados
para), seleccione un elemento de muestra.
9. Haga clic en Aceptar.
Los campos ConfigString y Valor muestran la resólución de los parametrós de sustitución
que selecciónó y tambien los ajustes de creación de tag.
196
Guía del usuario PI System Explorer
Configuración de referencias de datos
10. Para guardar su trabajo, presione CTRL-S o haga clic en Ingresar.
11. Cree un elemento a partir de su plantilla de elementos y haga clic en la pestana Atributos.
12. Haga clic con el bótón secundario sobre el atributo de referencia de datos de PI Point y haga
clic en Crear o actualizar referencia de datos.
13. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Resultados
Se crearan todos los puntos a los que hacen referencia los nuevos elementos. Esto unicamente
funciona porque los elementos se han basado en una plantilla y la plantilla de atributos para la
referencia de datos utiliza la ópción de creación de tags.
Qué hacer a continuación
Una vez creados los PI Points, la interfaz especificada puede tardar algo de tiempo en escribir
los valores en PI Data Archive. Hasta ese momento, los valores se móstraran como Pt. Created.
Editar propiedades de PI Point
Edite una propiedad de PI Point cuando necesite proporcionar mas infórmación sobre un PI
Point aparte de los valores predeterminados de la propiedad del tag. Por ejemplo, puede ser
util proporcionar un descriptor para un PI Point creado como resultado de un analisis.
Procedimiento
1. En el navegador Elementos, encuentre el elemento que contiene el PI Point que desea editar.
2. Haga clic en la pestana Atributos y seleccione el atributo con la referencia de datos de PI
Point.
3. Haga clic en Ajustes.
4. En la ventana Referencia de datos de PI Point, haga clic en
.
5. En la ventana Propiedades de PI Point, elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Editar el valor de una propiedad
a. Haga clic en el campo Valor que esta junto a la
propiedad.
b. Introduzca un valor revisado.
Restaurar un valor editado a PI Data Archive
predeterminado
a. Haga clic en el campo Valor que esta junto a la
propiedad editada.
b. Haga clic en
y seleccione Restaurar valores
predeterminados.
6. Haga clic en Aceptar.
Vista previa de los parámetros de substitución en las referencias de datos de
PI Point
Visualice previamente cómó se resuelven los parametrós de substitución a medida que
cónfigura una referencia de datos de PI Point en una plantilla de atributos.
Procedimiento
1. En el navegador Biblioteca, seleccione una plantilla de elementos.
2. Haga clic en la pestana Plantillas de atributos.
Guía del usuario PI System Explorer
197
Configuración de referencias de datos
3. Anada una plantilla de atributos nueva a la plantilla de elementos tal como se describe en
Crear plantillas de atributos.
4. En la lista Referencia de datos, seleccione PI Point.
5. Haga clic en Ajustes.
Los valores de substitución predeterminados se muestran en el campo Nombre de tag.
6. Utilice parametrós de substitución para que PI AF cree autómaticamente nombres de punto
para seleccionar la substitución de nombre y los
para los puntos que genera. Haga clic en
valores de atributo relacionados desde un menu contextual. Para obtener mas infórmación
sobre los valores de substitución de nombre, consulte Lista de parametrós de sustitución de
PI AF.
7. Para realizar una vista previa de cómó resolver los parametrós de substitución
seleccionados, haga clic en el vínculó Seleccionar instancia de ejemplo en la sección Vista
previa.
8. En la ventana Find Derived Elements for Element_Template(Buscar elementos derivados
para), seleccione un elemento de ejemplo.
9. Haga clic en OK.
Los campos Cadenas de conf. y Valor muestran la resólución de los parametrós de
sustitución que selecciónó y tambien los ajustes de creación de tag y los metódós de
recuperación de valor (si se seleccionaron).
10. Seleccione una de las siguientes acciones:
◦ Para cónfirmar la cónfiguración de referencia de datos de PI Point, haga clic en ACEPTAR.
◦ Para cambiar los ajustes de cónfiguración, haga clic en Cancelar y comience de nuevo al
hacer clic en Configuración.
Referencias de datos de matriz de PI point
Utilice la referencia de datos de matriz de PI point para vincular atributos de elementos a
matrices de PI points para leer o escribir sus valores. Cada nombre de tag especificadó se
córrespóndera con una entrada de la matriz. Cónfigure la referencia de datos de matriz de PI
Point como si fuera una referencia de datos de PI Point, salvo el campo Nombres de tag de la
ventana Referencia de datos de matriz de PI Point.
Video
Para obtener infórmación sobre cómó cónfigurar referencias de datos de matriz PI point, mire
este video:
https://www.youtube.com/watch?v=ozyS9QFFZgM&rel=0
Crear referencias de datos de matriz de PI Point
Cree una referencia de datos de matriz de PI Point para vincular atributos de elementos a
matrices de PI Points para leer o escribir sus valores.
Procedimiento
1. Para cónfigurar una referencia de datos de matriz de PI Point:
198
Guía del usuario PI System Explorer
Configuración de referencias de datos
◦ En el navegador Elementos, seleccione el elemento que desee utilizar.
◦ En una plantilla de elementos, seleccione la plantilla de elementos que desee utilizar en el
navegador Biblioteca.
2. En la pestana Atributo o Plantillas de atributos, seleccione el atributo.
3. En el panel de cónfiguración de atributos, elija Matriz de PI Point de la lista Referencia de
datos.
4. Haga clic en el bótón Ajustes.
5. En la ventana Referencia de matriz de datos de PI Point, deje el servidor predeterminado o
elija un PI Data Archive diferente de la lista de Servidores de datos.
Nota:
Si el PI Data Archive deseado no aparece en la lista, haga clic en
y seleccione un PI
Data Archive desde la ventana PI Data Archives.
6. En el campo Nombre de tag, elija una de las siguientes acciones:
◦ Para introducir PI Points directamente, escriba los nombres de punto separados por una
barra vertical (|). Por ejemplo:
CDM158|CDT158|SINUSOID
◦ Para buscar los PI Points, haga clic en e introduzca los criterios de busqueda en la
ventana Búsqueda de tags. Seleccione multiples PI Points en el PI Data Archive
seleccionado.
7. Opcional. Especifique las unidades que utilizan los PI Points referenciados. Consulte
Consideraciones relativas a las unidades de medida.
8. En la sección Métodos de recuperación de valores, especifique cómó el atributo obtiene su
valor. Por ejemplo, el valor de atributo pódría ser igual que los valores de punto o el
resultado de un calculó sobre el valor de punto. Consulte Cónfiguración de metódós de
recuperación de los valores de un atributo.
9. Utilice la casilla de verificación Solo lectura para especificar si desea que PI AF vuelva a
escribir el valor de atributo en los puntos de origen. De forma predeterminada, PI AF no
escribe datos en los PI Points referenciados (la casilla de verificación Solo lectura esta
seleccionada). Consulte El valor de PI point se actualiza a partir de la referencia de datos.
Referencias de datos Fórmula
Utilice referencias de datos de fórmulas para crear calculós personalizados en función de otros
atributos de elementos. Los calculós pueden ser una fórmula o una secuencia de calculós. Las
referencias de datos de fórmula pueden tener varios atributos de entrada.
Videos
Para obtener infórmación sobre cómó crear referencias de datos de fórmulas, mire este video:
https://www.youtube.com/watch?v=vReXkkMueIo&rel=0
Para obtener infórmación sobre las unidades de medida en las referencias de datos de
fórmulas, mire este video:
https://www.youtube.com/watch?v=0A_Uy5_nbCs&rel=0
En esta sección
• Operadores de referencias de datos de fórmulas
• Funciones de fórmula de referencia de datos
Guía del usuario PI System Explorer
199
Configuración de referencias de datos
• Unidades de medida en referencias de datos de fórmula
• Cónfigurar referencias de datos de fórmula
Operadores de referencias de datos de fórmulas
Puede utilizar los siguientes operadores en las referencias de datos de fórmulas (en orden de
precedencia):
Operador
Precedencia
Parentesis
9 (calculado primero)
Unario menos
8
^
7
* / mod
6
+-
5
< > <= >= == <>
4
NOT
3
AND
2
O
1 (calculado al ultimó)
No puede utilizar el operador de asignaciones = al comienzo de una fórmula.
Nota:
Las sintaxis de referencia de datos de fórmula utiliza == (dos signos de igual) para indicar
la igualdad y = (un solo signo de igual) para la asignación. La sintaxis de analisis (y
ecuación de rendimiento) utiliza = para indicar la igualdad y := para la asignación.
Operadores compuestos
Puede elegir If-Then-Else (Si/Entónces/Segun), un operador compuesto con operandos
utilizados de la siguiente manera:
If expr0 Then expr1 Else expr2
donde expr0, expr1 y expr2 son expresiones. Si expr0 es verdadero, se devuelve el valor de
expr1; de lo contrario, se devuelve el valor de expr2.
Ejemplo de fórmula
Esta fórmula de muestra calcula el costo promedio diario del reactivo por tonelada procesada,
como se muestra en el campo Valor para el Medio de molienda en la siguiente ilustración de
procesamiento de minerales:
A=.|Addition (Daily Total);B=.|Unit Cost;C=Tonnage (Past 24 Hours);[if C ==0 then
digstate("No Data") else A*B/C]
200
Guía del usuario PI System Explorer
Configuración de referencias de datos
Referencia de datos de la fórmula de muestra
Funciones de fórmula de referencia de datos
PI AF es compatible con las siguientes funciones en Fórmula de referencia de datos. Para
obtener infórmación sobre las funciones de expresiones de analisis, consulte Referencia de
funciones de expresión.
Función
Description
abs(X)
Valor absoluto de X.
acos(X)
Arcocoseno de X.
asin(X)
Arcoseno de X.
atan(X)
Arcotangente de X.
badval(x)
Devuelve 1 si el valor tiene estado incorrecto, tiene un valor de punto flótante
que no es un numeró (NaN) o no es un valor numericó; de lo contrario,
devuelve 0.
ceiling(X)
El entero mas pequenó no menor que X.
cos(X)
Coseno de X.
cosh(X)
Coseno hiperbólicó de X.
cot(X)
Cotangente de X.
coth(X)
Cotangente hiperbólica de X.
csc(X)
Cosecante de X.
csch(X)
Cosecante hiperbólica de X.
Guía del usuario PI System Explorer
201
Configuración de referencias de datos
Función
Description
digstate()
Devuelve un valor de estado digital.
• Si es correcto, el estado digital del sistema, el estado digital del sistema se
devuelve como un valor de enumeración del sistema. Para versiones de
Cliente de PI AF anterior a la 2.4, se devuelve el valor como un estado
digital de PI SDK, porque el valor de enumeración del sistema no existía.
• Si es incorrecto, el valor se devuelve como una cadena.
En ambos casos, el flag AFValue.IsGood se establece como falso y el atributo
se marca en el visor Atributos con el icono .
e()
Valor de la base lógarítmica natural.
exp(X)
Base lógarítmica natural e elevada a la potencia de X.
flóór(X)
El entero mas grande no mayor que X.
ln(X)
Logaritmo natural de X.
log(X)
Logaritmo de X con base 10.
logbase(X,Y)
Logaritmo de X con base Y.
max(X,Y)
El mayor de X e Y.
min(X,Y)
El menor de X e Y.
normalrnd(X,Y)
Numeró aleatorio que asigna la curva de distribución normal. X es la media e
Y es la desviación estandar.
pi()
Valor de pi.
poisson(X)
Valor aleatorio que asigna la distribución de Poisson. X es la media.
pow(X,Y)
X elevado a la potencia de Y.
rand()
Numeró aleatorio uniforme. Los valores pueden estar comprendidos entre 0 y
menos de 1,0
rand(X,Y)
Numeró aleatorio uniforme. Los valores pueden estar comprendidos entre XY/2 y menos de X+Y/2.
remainder(X,Y)
Devuelve el resultado restante de la división de X por Y.
round(X)
X redondeado al numeró entero mas próximó.
roundfrac(X,Y)
X redondeado al numeró de dígitós fraccionarios especificadós por Y. Y es un
numeró entero.
sec(X)
Secante de X.
sech(X)
Secante hiperbólica de X.
sign(X)
Devuelve 1 si X es mayor que cero y -1 si X es menor que cero.
sin(X)
Seno de X.
sinh(X)
Seno hiperbólicó de X.
sqrt(X)
Raíz cuadrada de X.
tan(X)
Tangente de X.
tanh(X)
Tangente hiperbólica de X.
Unidades de medida en referencias de datos de fórmula
Cuando trabaje con fórmulas y unidades de medida, tendra que cónfigurar las entradas y
salidas de la ecuación con la unidad de medida correcta:
202
Guía del usuario PI System Explorer
Configuración de referencias de datos
• Para los atributos de la ecuación, utilice la unidad de medida que la fórmula espera (NO las
unidades en las que esta el atributo).
• Para el resultado del calculó, especifique la unidad de medida en la que desea que aparezca
el resultado. Esto debe ser coherente con las unidades de medida de las entradas (valores de
atributo).
Ejemplo de unidad de medida en una referencia de datos Fórmula
Tenga en cuenta la siguiente cónfiguración de fórmula para convertir el volumen y la densidad
en masa:
V=Volume;UOM=L;D=Density;UOM=kg/L;[V*D];UOM=kg
Las unidades de medida de las entradas y salidas son coherentes: (L*kg/L = kg). Esta fórmula
funciona con cualquier atributo de entrada y de salida, independientemente de la unidad de
medida del atributo, siempre y cuando tengan especificada una unidad de medida de la clase
correcta.
Configurar referencias de datos de fórmula
Cree referencias de datos de fórmula para realizar calculós personalizados.
Antes de empezar
La referencia de datos de fórmula no admite cadenas ni otros tipos de valor no numericó.
Procedimiento
1. Seleccione una de las siguientes acciones.
◦ En el navegador Elementos, seleccione el elemento que desee utilizar.
◦ En una plantilla de elementos, seleccione la plantilla de elementos que desee utilizar en el
navegador Biblioteca.
2. En la pestana Atributo o Plantillas de atributos, seleccione el atributo.
3. En el menu desplegable Referencia de datos, seleccione Fórmula.
4. Haga clic en el bótón Configuración para abrir la ventana de cónfiguración Referencia de
datos Fórmula.
para anadirló como parametró
5. Si la ecuación requiere un valor de atributo, haga clic en
(Definir parametrós para referencias de datos de fórmulas).
6. Seleccione la casilla de verificación Valores predeterminados admitidos para que PI AF
pueda utilizar valores predeterminados de atributo en el calculó. Los valores
predeterminados se especifican en la plantilla de atributos. Si anula la selección de la casilla
de verificación, el calculó no se realizara si no estan disponibles los datos de uno o mas
atributos.
7. Haga clic en
para comenzar a definir la ecuación. Para obtener mas infórmación,
consulte Definir ecuaciones para referencias de datos de fórmulas.
8. En el campo Unidad de medida, especifique la unidad de medida del resultado de la fórmula
o de la secuencia de calculó, como se describe en Unidades de medida en referencias de
datos de fórmula.
9. En el campo Mínimo, introduzca un valor adecuado para el valor de devólución mínimó. Si el
valor calculado es inferior a este mínimó, la referencia de datos devólvera el valor mínimó
que especifique. Si no existe un valor mínimó para este calculó, deje el campo Mínimo en
blanco.
Guía del usuario PI System Explorer
203
Configuración de referencias de datos
10. En el campo Máximo, introduzca un valor adecuado para el valor de devólución maximó. Si
el valor calculado es superior a este maximó, la referencia de datos devólvera el valor
maximó que especifique. Si no existe un valor maximó para este calculó, deje el campo
Máximo en blanco.
Nota:
Seleccione la casilla de verificación Escalonado para que el valor aparezca escalonado
al trazarlo.
11. Haga clic en Evaluar para probar la referencia de datos. El valor devuelto por la secuencia de
calculó aparece en el campo adyacente. Si la referencia de datos Fórmula se cónfigura bajo
un atributo de plantilla, el calculó utiliza los valores predeterminados para los atributos de
plantilla. Cuando la cónfiguración se realiza con un atributo de elemento, se utilizan los
datos reales en el calculó.
12. Haga clic en Aceptar.
13. Cónfigure el resto de valores de atributo como lo haría con cualquier otro atributo.
En esta sección
• Definir parametrós para referencias de datos de fórmulas
• Definir ecuaciones para referencias de datos de fórmulas
Definir parámetros para referencias de datos de fórmulas
Si la ecuación requiere un valor de atributo, tendra que anadir ese atributo como parametró en
la ventana Configuración de fórmula.
Procedimiento
1. Haga clic en
junto al campo Parámetros.
Nota:
Tambien, puede hacer clic en una fila vacía e introducir una variable (a -z).
2. En la ventana Configuración de parámetros, seleccione una variable del menu Variables. El
numeró de variables disponible se limita a 26 caracteres (de la A a la Z).
3. Seleccione el atributo que la variable representa.
◦ Seleccione el atributo en el menu Atributo. En la lista se móstraran todos los atributos
admitidos del mismo nivel.
◦ Si el atributo que desea utilizar no esta en el menu, seleccione Otros. En la ventana se
para seleccionar un
móstrara un nuevo campo denominado Atributo. Haga clic en
atributo del arból. Tambien, puede escribir la ruta al atributo en el que este interesado.
En la lista figuran algunos ejemplos de rutas de atributos.
4. Seleccione la unidad de medida que desee para el atributo. Tenga en cuenta que esta no es la
UOM del atributo, sino la UOM que su fórmula requiere de esta entrada, como se describe en
Unidades de medida en referencias de datos de fórmula.
Por ejemplo, si el atributo de entrada tiene Celsius como unidad de medida pero la ecuación
requiere Fahrenheit, debera seleccionar Fahrenheit en este campo.
Definir ecuaciones para referencias de datos de fórmulas
Defina ecuaciones para utilizar en referencias de datos de fórmulas.
204
Guía del usuario PI System Explorer
Configuración de referencias de datos
Procedimiento
1. Para agregar una nueva fila de fórmulas, haga clic en
junto al campo Ecuaciones.
Tambien puede hacer clic en el area de texto y escribir una ecuación.
2. Escriba una ecuación directamente o arme su ecuación a partir de una lista de parametrós
de sustitución, funciones, operadores y variables disponibles. Haga clic en
para elegir
una de las siguientes acciones:
Para…
Haga lo siguiente…
Introducir una variable
Haga clic en Variables y luego haga clic en una
letra de la lista ordenada alfabeticamente.
Introducir un operador
Haga clic en Operadores y luego haga clic en un
operador de la lista. Los operadores validós se
enumeran en Operadores de referencias de datos
de fórmulas.
Introducir una función
Haga clic en Funciones y luego haga clic en una
función de la lista. Las funciones validas se
enumeran en Funciones de fórmula de referencia
de datos.
Introducir un parametró de sustitución
Haga clic en Parámetros de sustitución y luego
haga clic en un parametró de sustitución
temporal. En el caso de los elementos y las
transferencias, solo %Time% esta disponible,
pero en el caso de los marcos de evento, puede
seleccionar entre %StartTime, %EndTime%,
%UtcTime%, %UtcStartTime%, %UtcEndTime% y
%Duration%. Para obtener infórmación sobre
estos parametrós, consulte Lista de parametrós
de sustitución de PI AF.
Los numerós se convierten a un doble, los rangos
de tiempo a una duración en segundos y las
marcas de tiempo a segundos UTC.
3. Para agregar otra fila a la fórmula, haga clic en
y cóntinue la fórmula. Repita segun sea
necesario hasta que haya completado la fórmula.
4. Para cambiar la fórmula, elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Eliminar la ecuación seleccionada de la secuencia Seleccione la fila que desea eliminar y haga clic
de calculó
en
.
Eliminar todas las ecuaciones de la secuencia de
calculó
Haga clic en
.
Mover una ecuación hacia arriba o hacia abajo en Seleccione la fila que se va a mover y haga clic en
o
.
la secuencia de calculó
Referencia de datos String Builder
La referencia de datos String Builder permite aplicar funciones de manipulación de cadenas,
como la cóncatenación, a los valores de un atributo y generar una cadena con un nuevo
formato. Resulta practicó cuando es necesario obtener un tipo de valor numericó o de cadena
de otros atributos de elemento. La referencia de datos String Builder no hace conversiones ni
calculós de unidades de medida. Cuando utiliza una referencia de datos String Builder en una
plantilla, la substitución del valor tiene lugar durante la ejecución.
Guía del usuario PI System Explorer
205
Configuración de referencias de datos
Sintaxis de las expresiones
Tenga en cuenta las siguientes reglas cuando elabore una expresión:
• Puede crear una expresión en un solo renglón, utilizando punto y coma para separar los
terminós.
• Asimismo, puede colocar cada terminó en su propio renglón, para eliminar los punto y
coma, y hacer que la estructura de la expresión sea mas visible.
• Incluya los parametrós de substitución entre comillas dobles para que su resultado se
considere como una cadena literal.
• Puede incluir cualquier caracter del teclado en una cadena entre comillas dobles (por
ejemplo, guiones bajos, barras invertidas, dos puntos, punto y coma, etc.). Para incluir el
caracter de comillas dobles en una cadena, escriba dos caracteres de comillas dobles
consecutivos dentro de la cadena; por ejemplo, """t""e""s""t""" da lugar a "t"e"s"t".
• Puede incluir rutas de atributo de comillas simples para mostrar el valor del atributo
referenciado en el resultado.
• Debe evitar el uso de cadenas sin comillas porque pueden obtenerse resultados poco
sistematicós.
En esta sección
• Referencias de atributo en String Builder
• Implementación de funciones en el generador de cadenas
• Crear referencias de datos del generador de cadenas
Referencias de atributo en String Builder
Para hacer referencia a otros atributos, se utiliza la sintaxis en la siguiente tabla.
Objeto
Sintaxis
Atributo del mismo nivel
siblingAttribute
Atributo de nivel superior del
mismo elemento
|topLevelAttribute
Atributo principal
..
Atributo de elemento principal
..\|myAttribute
Atributo secundario
.|childAttribute
Del event frame al elemento
principal
.\Elements[.]|myAttribute
Ruta relativa de base de datos
\TopLevelElement|myAttribute
Ruta completa
\\myServer\myDatabase\myElement|myAttribute
Ejemplos
Suponga que desea recuperar el valor de PI point Environment del elemento principal
Cracking Process:
206
Guía del usuario PI System Explorer
Configuración de referencias de datos
En el elemento principal Equipment, usaría la sintaxis ..\|myAttribute e ingresaría '..\|
Environment' en la ventana Referencia de datos String Builder:
Un valor similar al siguiente se muestra en el campo Valor: 43.3071403505214.
Implementación de funciones en el generador de cadenas
En el generador de cadenas, puede utilizar diversas funciones de manipulación de texto, así
como tambien la función Format.
Extracción de texto y manipulación de mayúsculas y minúsculas
Puede utilizar funciones para manipular las mayusculas y minusculas de una cadena y extraer
determinadas secciones.
En la siguiente tabla se describe la sintaxis de las funciones de manipulación de texto en el
generador de cadenas:
Left(string, length)
Devuelve una cadena que contiene una cantidad específica de
caracteres (length) desde la izquierda de la entrada (string).
Ejemplo: Left("Temperature",4) devuelve Temp
Right(string, length)
Devuelve una cadena que contiene una cantidad específica de
caracteres (length) desde la derecha de la entrada (string).
Ejemplo: Right("GasTemp",4) devuelve Temp
Mid(string, start,
[length])
length es opcional. Devuelve una subcadena de la pósición
especificada (start) de la entrada (string). Cuando se incluye la
cantidad de caracteres (length), devuelve la cantidad especificada
de caracteres.
Ejemplo: Mid("GasPressure",4,8) devuelve Pressure
UCase(string)
Convierte string a mayusculas.
Ejemplo: UCase("Temperature") devuelve TEMPERATURE
LCase(string)
Convierte string a minusculas.
Ejemplo: LCase("TEMPERATURE") devuelve temperature
Guía del usuario PI System Explorer
207
Configuración de referencias de datos
Trim(string)
Elimina los espacios en blanco de ambos lados de string.
Ejemplo: Trim(" Temperature ") devuelve Temperature
RTrim(string)
Elimina los espacios en blanco a la derecha de string.
Ejemplo: RTrim(" Temperature ") devuelve " Temperature"
LTrim(string)
Elimina los espacios en blanco a la izquierda de string.
Ejemplo: LTrim(" Temperature ") devuelve "Temperature "
Replace(string1, string2,
string3)
La función busca string1 para string2, luego reemplaza string2
por string3.
Ejemplo: Replace("Temperature","Temp","External Temp")
devuelve "External Temperature"
Tambien puede anidar funciones de manipulación de texto.
• Por ejemplo, para un atributo denominado GasPressure, puede utilizar la función Mid
junto con la función UCase para devolver la siguiente expresión: GASPR
Mid(UCase("%Attribute%"), 1, 5);
• De manera alternativa, para el mismo atributo puede utilizar la función Mid junto con la
función LCase para devolver la siguiente expresión: pressure
Mid(LCase("%Attribute%"), 4, 8);
Nota:
A partir de PI AF 2018, puede anidar funciones en cualquier pósición, no solamente en la
primera. Por ejemplo,
Replace(Mid("abc",1,3),"b","2");
Replace("abc",Mid("abc",2,1),"2");
Replace("abc","b",Mid("123",2,1));
devuelven todos la expresión: a2c
Función formato
La función Format le permite convertir numerós reales, numerós enteros y marcas de tiempo a
una cadena segun el formato y la especificación de cultura opcional.
Nota:
A diferencia de otras funciones de cadena, la sintaxis de Formato(FechaHora, ... ) sigue la
sintaxis C# .
En la siguiente tabla se describe la sintaxis para la implementación de Function en el
generador de cadenas:
208
Guía del usuario PI System Explorer
Configuración de referencias de datos
Numerós reales
Format(real, format)
Format (real, format, culture)
El formato sigue la sintaxis del estilo de
la ecuación de rendimiento (PE), como
"%0.3f", donde el numeró anterior al
decimal indica la cantidad mínima de
caracteres totales del resultado,
rellenando previamente con espacios en
blanco, y el numeró posterior al decimal
indica la cantidad de dígitós que se
deben mostrar despues del punto
decimal.
La cultura se especifica de manera
opcional mediante una etiqueta de
lenguaje de Grupo de Trabajo de
Ingeniería de Internet (IETF), como
"en", "en-US", "de", que especifica el
lenguaje y la cultura y regiones
opcionales.
Numerós enteros
Format(integer, format)
Format(integer, format,
culture)
El formato sigue la sintaxis del estilo de
la PE, como "%4d", donde el numeró
indica la cantidad mínima de caracteres
totales del resultado, rellenando
previamente con espacios en blanco
segun sea necesario.
La cultura se especifica de manera
opcional mediante una etiqueta de
lenguaje de IETF, como "en", "en-US",
"de", que especifica el lenguaje y la
cultura y regiones opcionales.
Marcas de tiempo
Format(datetime, format)
Format(datetime, format,
culture)
El formato sigue la sintaxis C#
DateTime.ToString(format), y
puede ser una sintaxis predefinida o una
sintaxis personalizada.
El formato DateTime utiliza
cónfiguraciónes de cultura invariables.
Para mostrar las fechas y horas de una
cultura específica, agregue una etiqueta
de lenguaje de IETF, como "fr-FR" y
"fr-CA", como se describe en el
artículó de MSDN Tabla de nombres y
códigós de cultura del idioma, y metódó
de valores ISO (https://
msdn.microsoft.com/en-ca/library/
ee825488(v=cs.20).aspx).
Para obtener mas infórmación sobre los
formatos de fecha y hora, consulte
Cadenas de formato para parametrós de
sustitución de hora.
Guía del usuario PI System Explorer
209
Configuración de referencias de datos
Matrices
Format(array, delimiter)
Format(array, delimiter,
format)
Format(array, delimiter,
format, culture)
Los delimitadores predeterminados son
espacios en blanco " ", salvo que se
especifique otro caracter delimitador.
Ademas, format y culture tambien se
pueden especificar mediante la misma
sintaxis que los numerós reales e
integrales anteriores. Por ejemplo, la
referencia de los siguientes datos del
generador de cadenas a una matriz (con
los valores 11,12, 15,98 y 99,154) que
especifica un delimitador "-", "%3.3.f" y
una cultura "Fr-fr":
Format('..\|
TestArray',"-","%3.3f","Frfr");
produce un valor de
11,120-15,980-99,154.
Línea nueva
NewLine()
Asegura la presencia de una línea nueva
en el valor de salida. Por ejemplo,
cuando se introduce a;Newline();b;,
el valor de salida se muestra como:
a
b
Ejemplo de formato numérico
Supongamos que desea formatear el valor de PI Point Environment que ya recuperó del
elemento primario Cracking Process. En la ventana Referencia de datos del generador de
cadenas, seleccione la fila que contiene la expresión de la cadena, haga clic en
y seleccione
Funciones > Formato(Real, "%3.3f") para módificar la expresión:
El campo Valor cambia de 43.3071403505214 a 43.307.
Para cambiar el valor cultural del formato predeterminado de EE. UU. a un formato de cultura
en espanól, seleccione Funciones > Formato(Real, "%3.3f", "en-US") y cambie la cadena "enUS" a "es":
El campo Valor cambia de 43.307 a 43,307.
Nota:
Asegurese de que el tipo de datos que especifique coincida con el tipo de datos del
atributo. Se próducirían errores si, por ejemplo, especifica "%3.2f" para un valor de
atributo de tipo entero o "%3d" para un valor de atributo de punto flótante.
210
Guía del usuario PI System Explorer
Configuración de referencias de datos
Ejemplo de formato de fecha/hora
Supongamos que desea recuperar y formatear el valor In Service Date del elemento
secundario Condenser:
En el elemento primario Power and Steam Generation, cree un atributo denominado
Condenser Service Date. Utilice la sintaxis .\childElement|Attribute e introduzca '.
\Condenser|In Service Date' en la ventana Referencia de datos del generador de cadenas:
El valor In Service Date se recupera y se muestra en el campo Valor: 2/25/2009
12:00:00 AM.
Para cambiar el formato de la fecha predeterminada de EE. UU. a la Universal en el formato de
cultura aleman, altere la expresión para leer Format(.\Condenser|In Service
Date,"U","de"). El formato del valor del atributo Condenser Service Date se convierte
en consecuencia:
Crear referencias de datos del generador de cadenas
Cree una referencia de datos del generador de cadenas cuando necesite aplicar funciones de
manipulación de cadenas, como la cóncatenación, al valor de un atributo e imprimir una cadena
reformateada.
Antes de empezar
Cuando se utiliza una referencia de datos del generador de cadenas en una plantilla, la
substitución de valores ocurre en tiempo de ejecución.
Procedimiento
1. Seleccione una de las siguientes acciones:
◦ En el navegador Elementos, seleccione el elemento que desee utilizar.
◦ En el navegador Event Frames, seleccione el event frame que desee utilizar.
◦ En una plantilla de elementos, seleccione la plantilla de elementos que desee utilizar en el
navegador Biblioteca.
2. En la pestana Atributo o Plantillas de atributos, seleccione el atributo.
3. En el panel de cónfiguración de atributos, seleccione Generador de cadenas en la lista
Referencia de datos.
4. Haga clic en Ajustes.
Guía del usuario PI System Explorer
211
Configuración de referencias de datos
5. En la ventana Referencia de datos del generador de cadenas, haga clic en
6. En la fila resaltada, presione F2 o haga clic en
.
y seleccione una de las siguientes opciones:
Opción
Descripción
Literales
Una cadena de texto entre comillas dobles:
"Muestra"
Valores de atributo
Una lista de otros atributos para el elemento o la
plantilla de elementos seleccionada. Tenga en
cuenta que los atributos deben aparecer entre
comillas simples.
Valores de atributo relacionados
Una lista de las siguientes referencias de
atributo:
◦ '\\<Server>\<Database>\<Element>|
<Attribute>'
◦ '\\.\<Database>\<Element>|<Attribute>'
◦ '\<Root Element>|<Attribute>'
◦ '.\<Child Element>|<Attribute>'
◦ '..\| <Primary Parent Attribute>'
◦ '..\<Sibling Element>|<Attribute>'
Tambien puede seleccionar Búsqueda para
introducir los criterios de busqueda en la
ventana Búsqueda de atributos.
Parametrós de substitución
Una lista de los 20 parametrós de substitución
mas utilizados. Para obtener mas infórmación,
consulte Lista de parametrós de sustitución de PI
AF.
Funciones
Una lista de las siguientes funciones:
◦ Left(cadena, longitud)
◦ Right(cadena, longitud)
◦ Mid(cadena, longitud)
◦ Mid(cadena, inicio, longitud)
◦ UCase(cadena)
◦ LCase(cadena)
◦ Trim(cadena)
◦ RTrim(cadena)
◦ LTrim(cadena)
◦ Reemplazar(cadena, cadena, cadena)
◦ Format(Real, "%3.3f")
◦ Formato(Real "%3.3f", "en-US")
◦ Formato(FechaHora, "yyyy-MM-dd
HH:mm:ss")
◦ Formato(FechaHora, "yyyy-MM-dd
HH:mm:ss", "en-US")
◦ Formato(Matriz, Separador)
◦ NuevaLínea()
7. Desarrolle mas su expresión. Puede escribir un punto y coma (;) y continuar en la misma
para continuar en otra fila. Puede utilizar los siguientes iconos para
fila o hacer clic en
manipular la expresión:
212
Para…
Haga lo siguiente…
Anadir una nueva cadena
Haga clic en
Guía del usuario PI System Explorer
.
Configuración de referencias de datos
Eliminar una cadena
Seleccione una fila y haga clic en
.
Eliminar todas las cadenas
Haga clic en
Mover una cadena hacia arriba en una fila
Seleccione una fila debajo de la fila superior y
haga clic en
.
Mover una cadena hacia abajo en una fila
Seleccione una fila arriba de la fila inferior y haga
clic en
.
.
Cuando desarrolla la expresión de la cadena, puede tener una vista previa del resultado de la
expresión en el campo Valor.
8. Cuando la expresión de la cadena esta completa, haga clic en Aceptar.
Ejemplos
• Puede introducir los siguientes parametrós de substitución en una unica fila para
concatenar una cadena de nombre de ruta. Por ejemplo:
"%Database%";"\";"%Element%";"|";"%Attribute%";
Esta referencia de datos próducira resultados similares a: DB26\WX12000|pressure.
• Puede desarrollar una expresión en filas separadas para mostrar la duración de un evento.
Por ejemplo:
a. Haga clic en
, presione F2 y seleccione Parámetros de substitución > "%StartTime%".
b. Haga clic en
y escriba los caracteres: " to "
c. Haga clic en
, presione F2 y seleccione Parámetros de substitución > "%EndTime%".
El campo Valor muestra un intervalo de fecha y hora:
Para ver mas ejemplos, consulte Implementación de funciones en el generador de cadenas.
Guía del usuario PI System Explorer
213
Configuración de referencias de datos
Referencias de datos Table Lookup
Puede cónfigurar un atributo para que obtenga su valor de una tabla de PI AF. Puede definir la
tabla de PI AF en su totalidad en PI AF, o bien vincularla o importarla de una fuente de datos
externa a PI System (por ejemplo, una tabla de Microsoft SQL o una hoja de calculó de Microsoft
Excel).
Table lookup
La referencia de datos de busqueda de tabla esta disenada para ser una busqueda de tabla
sencilla. Utiliza el metódó .NET System.Data.DataTable.Select de Microsoft y sigue las
reglas de expresión de filtró de dicho metódó. Tenga en cuenta que no todas sus funciones se
implementan en PI AF. Por ejemplo, una referencia de datos de busqueda de tabla no incluye
funcionalidades como funciones de columna y referencias con relaciones principal-secundario.
Nota:
La referencia de datos de busqueda de tabla no se optimiza para tratar los datos de una
tabla externa como serie temporal y consultarla. Para lograr un rendimiento óptimó,
dichos datos deben almacenarse en PI tags en un PI Data Archive.
Metodología Búsqueda de tabla
Comience creando un perfil de tabla en el navegador Biblioteca, donde se establecen los ajustes
generales de zona horaria e intervalo cache para actualización de datos, así como las
definiciónes de columnas de tabla y conexiones a fuentes de datos externas a PI System si va a
vincular a datos externos o si va a importarlos.
Si va a vincular a fuentes de datos externas, planteese crear perfiles de conexiones de tabla
reutilizables en el navegador Biblioteca, como se describe en Crear conexiones de tabla
reutilizables.
Videos
Para obtener infórmación sobre cómó crear tablas internas para las referencias de datos de
busqueda de tabla, mire este video:
https://www.youtube.com/watch?v=3gQzzNWzd6o&rel=0
Para obtener infórmación sobre cómó cónfigurar referencias de datos de busqueda de tabla,
mire este video:
https://www.youtube.com/watch?v=hoy7QarxF1o&rel=0
En esta sección
• Crear tablas de PI AF
• Crear definiciónes de columna de la tabla
• Completar tablas de forma manual
• Referencias de datos desde fuera del PI System
• Cónfigurar las referencias de datos de busqueda de tabla
Crear tablas de PI AF
Puede crear un perfil de tabla de manera que los atributos puedan obtener sus valores de una
tabla interna o externa.
214
Guía del usuario PI System Explorer
Configuración de referencias de datos
Procedimiento
1. En el navegador Biblioteca, haga clic con el bótón secundario sobre la cólección Tablas y
luego haga clic en Nueva Tabla.
2. En la pestana General, introduzca Nombre y Descripción para la tabla.
3. Opcional. Asigne una o mas categórías a la tabla. Introduzca los nombres de categóría de
tabla directamente, separados por dos puntos, o haga clic en
y selecciónelós de la
ventana Categorizar.
4. Decida cómó se deben almacenar los valores DateTime en la tabla. Al establecer el valor
para la tabla en general, no es necesario que lo especifique cada vez que crea una referencia
de datos de busqueda de tabla.
a. En el campo Zona horaria, seleccione una zona horaria de la lista.
b. Seleccione o deje sin marcar la casilla de verificación Convertir a local. Elija una de las
opciones siguientes:
◦ Para convertir los valores DateTime a la hora local, seleccione la casilla de verificación
Convertir a local.
◦ Para mostrar los valores de DateTime en la zona horaria seleccionada en el campo Zona
horaria, borre la casilla de verificación Convertir a local.
Nota:
Cuando una aplicación cliente consulta la tabla, la zona horaria en la que se muestran
los valores DateTime depende de si la casilla de verificación Convert To Local
(Convertir a local) esta seleccionada. PI System Explorer utiliza este ajuste para
determinar el DateTimeMode preciso que se utilizara en una tabla de datos de
Microsoft .NET, como se describe en Ajustes de cónversión para zonas horarias.
5. En el campo Intervalo de caché, introduzca el intervalo de tiempo que debe transcurrir para
que los datos almacenados en la memoria cache de la tabla se actualicen de forma
autómatica. En la lista, seleccione si el valor es segundos, minutos, horas o días. El valor
predeterminado es cero, lo que indica una actualización manual.
Nota:
La actualización autómatica se desactiva si la tabla tiene cambios que no se han
guardado en el servidor.
Nota:
Con las actualizaciones manuales, actualice los datos de la tabla haciendo clic con el
bótón secundario en la tabla del navegador Biblioteca y luego haciendo clic en
Actualizar. De lo contrario, los datos de la tabla que estan siendo consultados por las
aplicaciones cliente se actualizan solo cuando se reinicia la aplicación. Por ejemplo,
cuando se abre PI System Explorer o cada vez que el grupo de aplicaciones de
Microsoft Internet Information Services (IIS) recicle el cliente (el ajuste
predeterminado es cada 29 horas).
6. Guarde su trabajo.
Nota:
Los campos Conexión y Consulta son de solo lectura. PI AF rellena estos campos al
vincular o importar una tabla externa.
Qué hacer a continuación
Defina y rellene la tabla utilizando una de tres maneras:
Guía del usuario PI System Explorer
215
Configuración de referencias de datos
• Defina y rellene de forma manual la tabla en PI System Explorer. En primer lugar, cree
definiciónes de columnas en la pestana Definir tabla, como se describe en Crear definiciónes
de columna de la tabla. A cóntinuación, introduzca los datos en la pestana Tabla, como se
describe en Completar tablas de forma manual.
• Importe una tabla externa fuera del servidor de PI AF. Consulte Acceso a los datos de
Microsoft Access o Excel.
• Vincule una tabla externa fuera del servidor de PI AF. Consulte Acceso a los datos de
Microsoft Access o Excel.
Ajustes de conversión para zonas horarias
El calculó de cónversión de la hora exacta depende de:
• El valor que se haya seleccionado en la columna Zona horaria. Los horarios tienen el prefijó
Tiempo Universal Coordinado (UTC), Tiempo medio de Greenwich (GMT) o Zona horaria
(TZ). La lista tambien incluye la ópción None.
• Si ha seleccionado o no la casilla Convertir a local.
• Si se trataba de una tabla interna (importada o definida en PI AF) o externa (vinculada).
En la tabla siguiente se explica cómó se determinan las horas mostradas para cada cómbinación
posible. Las opciones exactas de la lista Zona horaria dependeran de su sistema operativo.
Zona horaria Convertir a
local
Interna/
Externa
Comportamiento
None
Interna
Los campos que contienen el tipo de datos DateTime se
ajustan autómaticamente a las diferencias de zona horaria
y devuelven la hora local en el cliente.
Externa
Se asume que los campos que contienen el tipo de datos
DateTime se encuentran dentro de la zona horaria del
servidor de PI AF y se ajustan a la hora local del cliente.
Interna
Los campos que contienen el tipo de datos DateTime no se
convierten. Resulta util para guardar campos de fecha en
los que no se desea ninguna cónversión, por ejemplo, las
fechas de nacimiento.
Externa
Los campos que contienen el tipo de datos DateTime no se
convierten. Resulta util para guardar campos de fecha en
los que no se desea ninguna cónversión, por ejemplo, las
fechas de nacimiento.
Interna
Los campos que contienen el tipo de datos DateTime se
ajustan a las horas locales en el cliente.
Externa
Los campos que contienen el tipo de datos DateTime se
guardan externamente como UTC, pero se ajustan a la hora
local del cliente, representada como UTC.
Interna
Los campos que contienen el tipo de datos DateTime
siempre se representan como UTC.
Externa
Los campos que contienen el tipo de datos DateTime se
guardan externamente como UTC y se dejan como UTC en
el cliente.
None
UTC o
GMT
UTC o
GMT
216
Guía del usuario PI System Explorer
Configuración de referencias de datos
Zona horaria Convertir a
local
Interna/
Externa
Comportamiento
TZ
Interna
Los campos que contienen el tipo de datos DateTime se
ajustan a las diferencias de zona horaria y son la hora local
en el cliente. Esta cómbinación no se necesita, por lo
general, salvo durante la impórtación de datos externos a
PI System Explorer.
Externa
Los campos que contienen el tipo de datos DateTime se
ajustan a las diferencias de zona horaria y se ajustan a la
hora local en el cliente, representada como UTC.
Interna
Los campos que contienen el tipo de datos DateTime se
dejan en la zona horaria especificada. La referencia de
datos de busqueda de tabla se ajustara como corresponda;
sin embargo, puede que otras aplicaciones no lo hagan.
Externa
Los campos que contienen el tipo de datos DateTime se
dejan en la zona horaria original especificada,
representada como UTC. La referencia de datos de
busqueda de tabla se ajustara como corresponda; sin
embargo, puede que otras aplicaciones no lo hagan.
TZ
Crear definiciones de columna de la tabla
Para crear una tabla manualmente, comience por definir las columnas en la tabla.
Procedimiento
1. Una vez que haya completado los ajustes generales de la tabla en la pestana General, haga
clic en la pestana Definir tabla.
2. Determine la cantidad de columnas de la tabla y haga clic en
que se va a definir.
una vez por cada columna
3. Haga clic en la celda Nombre y reemplace la etiqueta predeterminada por el nombre de
columna requerido.
4. Haga clic en la celda adyacente Tipo de valor y seleccione un tipo de datos de una lista de
Tipos básicos o Tipos de matriz. Para la descripción o los tipos de datos, consulte Tipos de
datos de PI AF.
Consejo:
Si algun tipo de valor se establece en DateTime o String, OSIsoft recomienda que
deje el valor de la zona horaria de la columna establecido en Ninguna y seleccione un
valor de zona horaria para la tabla en general, en el campo Zona horaria de la pestana
General. Ese valor reemplaza las zonas horarias establecidas en columnas de tablas
específicas.
5. Opcional. Haga clic en la celda Unidad de medida y elija una de las siguientes acciones:
◦ Comience a escribir y seleccione una unidad de medida de la lista de unidades de medida
coincidentes.
◦ Haga clic en
y seleccione de la lista completa de unidades de medida.
Consejo:
OSIsoft recomienda establecer una unidad de medida para una columna de tabla para
no tener que especificar una cada vez que seleccione la columna en una referencia de
datos de busqueda de tabla.
Guía del usuario PI System Explorer
217
Configuración de referencias de datos
6. Repita los pasos 3 a 5 para cada columna de la tabla.
7. Para módificar la definición de columna de la tabla, haga clic con el bótón secundario en una
fila de la cuadrícula y seleccione una ópción. Otra ópción es utilizar los siguientes iconos.
Para…
Haga lo siguiente…
Insertar una nueva columna
Haga clic en
Mover una columna hacia arriba en una fila
Seleccione una fila debajo de la fila superior y
haga clic en
.
Mover una columna hacia abajo en una fila
Seleccione una fila arriba de la fila inferior y haga
clic en
.
Eliminar una columna
Seleccione una columna y haga clic en
.
.
Qué hacer a continuación
Cuando haya terminado de definir las columnas de la tabla, haga clic en la pestana Tabla para
poder introducir manualmente los datos de la fila para cada columna.
Completar tablas de forma manual
Una vez que haya completado las definiciónes de columna de la tabla, introduzca los datos de
fila para cada columna.
Procedimiento
1. Haga clic en la pestana Tabla. En función de las columnas de tabla que haya creado en la
pestana Definir Tabla, introduzca la infórmación correspondiente en las filas de cada
columna
2. Elija una de las siguientes acciones:
Para…
Haga lo siguiente…
Introducir una nueva fila
Haga clic con el bótón secundario en la
cuadrícula de la tabla y luego haga clic en Insertar
o Nuevo.
Copiar y pegar filas desde una hoja de calculó de
Excel
Reemplazar datos para celdas específicas
a. En la hoja de calculó, copie las filas que desea.
b. En la cuadrícula de la tabla, haga clic con el
bótón secundario en una nueva fila o en un
rango de filas y luego haga clic en Pegar.
a. Utilice combinaciones de teclas estandares de
Windows (como MAYÚS + <click> y
CTRL + <click>) para seleccionar celdas
contiguas y no contiguas en la tabla, como se
describe en Seleccionar varios objetos en el
visor.
b. Haga clic con el bótón secundario y luego
haga clic en Clear Cell(s) (Borrar celdas).
c. Introduzca datos nuevos en las celdas
borradas.
Eliminar una fila
Haga clic con el bótón secundario en la fila que
desea eliminar y luego haga clic en Eliminar.
3. Para guardar su trabajo, presione CTRL+G o haga clic en Ingresar.
218
Guía del usuario PI System Explorer
Configuración de referencias de datos
Referencias de datos desde fuera del PI System
Tambien puede utilizar las tablas de PI AF para acceder a datos externos a PI System. Estos
datos pueden estar incluidos en Microsoft Excel, Access o SQL Server, así como en otras fuentes
de datos OLE DB/ODBC. Puede importar la tabla o el vínculó a esta tras haber definidó la
estructura de tabla, tal como se define en Crear tablas de PI AF y Crear definiciónes de columna
de la tabla.
Tablas importadas
Las tablas de PI AF con datos importados se denominan tablas importadas. Las tablas
importadas son tablas de lectura/escritura. Tienen un tamanó limitado, pero son mas seguras
que las tablas vinculadas. Las tablas importadas se denominan en algunas ocasiones tablas
internas porque, a diferencia de las tablas vinculadas, los datos de tabla se gestionan en PI AF.
Despues de la impórtación inicial, no existira ninguna relación posterior entre la tabla externa y
la tabla de PI AF. Puede editar los datos directamente en PI AF.
Se recomienda limitar las tablas importadas a 10 000 filas de datos o menos. Las tablas
importadas no estan disenadas para almacenar bases de datos muy grandes. Si necesita
acceder a muchos datos de tablas de PI AF, vincule en su lugar a tablas externas, que no
presentan estos límites de almacenamiento. Tambien, puede dividir la tabla en distintas tablas
al importar.
Tablas vinculadas
Las tablas vinculadas se denominan en algunas ocasiones tablas externas porque los datos de
origen no se almacenan en la base de datos de PI AF. Las tablas externas no se pueden editar
desde PI AF. Las tablas vinculadas requieren en algunas ocasiones cónfiguración de seguridad
adicional, porque es necesario cónfigurar la forma en que PI AF se conecta con la fuente de
datos externa. Debera cónfigurar una cónexión de tabla reutilizable, donde cónfigurara el tipo
de autenticación para acceder a la tabla externa.
Videos
Para obtener infórmación sobre cómó importar datos de tablas externas, mire este video:
https://www.youtube.com/watch?v=MmXmnac969s&rel=0
Para obtener infórmación sobre cómó vincular a datos en tablas externas, así como seguridad
SQL, mire este video:
https://www.youtube.com/watch?v=JnhodkkyHks&rel=0
En esta sección
• Autenticación de tablas vinculadas
• Crear conexiones de tabla reutilizables
• Acceso a los datos de Microsoft Access o Excel
• Acceso a los datos de SQL Server
• Eliminar caracteres de control de tablas de AF importadas
Autenticación de tablas vinculadas
Cuando una aplicación cliente solicita datos externos, el servidor de PI AF consulta la fuente de
datos externa y devuelve los datos al cliente como una tabla de PI AF de solo lectura.
En el caso de las tablas vinculadas de forma externa, OSIsoft recomienda que el proveedor OLE
DB y el servidor de PI AF tengan los mismos valores de bits (32 o 64 bits). Para cónfigurar una
Guía del usuario PI System Explorer
219
Configuración de referencias de datos
cónexión de tabla externa en PI System Explorer, por ejemplo, debe utilizar un servidor de PI
AF que tenga los mismos valores de bits (habitualmente, 64 bits).
Al cónfigurar la tabla vinculada, debe especificar las credenciales que el servidor de PI AF
utiliza para conectarse a la base de datos. Las opciones de autenticación son:
• Simular cliente
Si la base de datos de origen es compatible con la autenticación de Windows, utilice la
identidad de Windows del cliente que solicita los datos. Se trata de una cónexión suplantada.
Este es el metódó mas seguro de autenticación y debería utilizarse cuando sea posible.
• Proporcionar contraseña
Si la base de datos de origen no es compatible con la autenticación de Windows, o si la base
de datos y el servidor de PI AF se encuentran en dominios no cónfiables y diferentes,
especifique un nombre de usuario y una cóntrasena con el acceso necesario en la base de
datos de origen. PI AF utiliza esta cuenta de códificación fija para leer los datos en la fuente
de datos externa. Por ejemplo, la base de datos MySQL no es compatible con la autenticación
de Windows, por lo tanto, debe utilizar el nombre de usuario y la cóntrasena de una cuenta
de la base de datos MySQL.
Nota:
Puede introducir un ID de usuario y una cóntrasena como parte de la cadena de
cónexión y guardarla con una cónexión de tabla de PI AF, independientemente de que
se haya habilitado previamente o no la compatibilidad con tablas externas de PI AF
para usuarios no persónificadós (con el comando afdiag /DTImp).
• No hay contexto de seguridad adicional
Esta ópción normalmente se aplica cuando se utiliza Excel u otras fuentes de datos basadas
en archivos; de lo contrario, cada usuario debe obtener acceso de lectura al archivo del
servidor. Con esta ópción, se pódra acceder a la tabla externa con la identidad del servidor
de PI AF. En este caso, no necesita especificar un nombre de usuario o cóntrasena al
cónfigurar la tabla vinculada ni tampoco es necesario cónfigurar Kerberos.
PRECAUCIÓN:
Recuerde cónfigurar la seguridad de SQL de tal forma que la identidad del servidor de
PI AF no tenga mas privilegios de los necesarios para recuperar los datos. Por motivos
de seguridad, solo los administradores de PI AF estan autorizados para cónfigurar
tablas externas. Por esta razón, debera asegurarse de que la identidad PI AF
Administrators y los derechos de acceso de Admin se encuentren asignados
unicamente a un conjunto limitado de usuarios cuando este modo de cónexión se
encuentre habilitado.
En esta sección
• Restricciones respecto a las conexiones no suplantadas
• Riesgos del uso de conexiones no suplantadas
• Recomendaciones relativas al acceso a los datos para las tablas vinculadas
• Cónfiguración de seguridad de tablas vinculadas
Restricciones respecto a las conexiones no suplantadas
Dado que las tablas vinculadas que utilizan conexiones no suplantadas plantean riesgos de
seguridad, algunos administradores del sistema del servidor de PI AF limitan o impiden su uso.
Es posible que su administrador del sistema:
220
Guía del usuario PI System Explorer
Configuración de referencias de datos
• Exija privilegios administrativos en el servidor de PI AF y privilegios de escritura en la tabla
de PI AF.
• Impida la creación de tablas de PI AF vinculadas con conexiones no suplantadas.
• Impida la creación de cualquier tabla vinculada.
Si tiene problemas con las tablas vinculadas, póngase en contacto con su administrador del
sistema para consultar acerca de la cónfiguración de las tablas externas del servidor de PI AF.
Riesgos del uso de conexiones no suplantadas
En función de la cónfiguración del SQL Server, un usuario con privilegios de administrador de
PI AF puede crear ataques al SQL Server y tomar el control total del sistema si se dan las
siguientes circunstancias:
• Se ha cónfiguradó una tabla de PI AF para que utilice una identidad del servidor de PI AF
para vincularse con una base de datos externa.
• Las tablas vinculadas (externas) no suplantadas estan habilitadas en el servidor de PI AF.
De forma predeterminada, las tablas vinculadas no suplantadas estan desactivadas en el
servidor de PI AF. Para que un usuario pudiese ejecutar un ataque, tendría que activar las
tablas externas no suplantadas.
• La cuenta del servidor de PI AF tiene derechos administrativos en un SQL Server.
El servidor de PI AF se ejecuta, de forma predeterminada, con la cuenta virtual NT SERVICE
\AFService y no cuenta con derechos administrativos en el SQL Server cónfiguradó de
forma local ni con acceso a las bases de datos de equipos remotos. Sin derechos de
administrador a la base de datos remota, se reduce la posibilidad de tener privilegios de
ataque.
PRECAUCIÓN:
Por motivos de seguridad, no otorgue privilegios administrativos al servidor de PI AF en
el equipo o SQL Server cuando se ejecuten consultas no suplantadas.
Recomendaciones relativas al acceso a los datos para las tablas vinculadas
OSIsoft recomienda seguir estas directrices a la hora de cónfigurar tablas ligadas.
• Si no es necesario acceder a tablas vinculadas, desactive el acceso.
• No le otorgue privilegios administrativos a la cuenta del servicio de aplicación PI AF en el
servidor PI AF o el SQL Server cuando se ejecute con consultas no suplantadas.
• Debe contar con privilegios administrativos en el servidor de PI AF para cónfigurar una
tabla externa que se ejecute con consultas no suplantadas.
Configuración de seguridad de tablas vinculadas
Utilice la utilidad Diagnósticó de PI AF (afdiag ubicada en la carpeta %PIHOME64%\AF) para
activar o desactivar el soporte para las tablas de PI AF externas. La utilidad hace una cónexión
directa con la base de datos de SQL Server asociada, por lo que requiere del rol sysadmin o
db_AFadmin de SQL Server.
Utilice la utilidad de diagnósticó de PI AF para ajustar los valores de seguridad de las tablas
externas.
Guía del usuario PI System Explorer
221
Configuración de referencias de datos
Tarea
Comando
Configuración
predeterminada
Activar el soporte para las tablas de PI AF externas
afdiag /DT
activada
Desactivar el soporte para las tablas de PI AF
externas
afdiag /DT-
Activar el soporte para las tablas de PI AF externas
de usuarios no suplantados
afdiag /DTImp
Desactivar el soporte para las tablas de PI AF
externas para usuarios no suplantados
afdiag /DTImp-
Cambiar la cónfiguración de seguridad para una
tabla de PI AF específica
En el navegador
Biblioteca , haga clic con
el bótón secundario
sobre la tabla y luego
haga clic en Seguridad.
De manera
predeterminada, la
cónfiguración de la tabla
requiere privilegios
administrativos en el
servidor de PI AF.
Módificar la cónfiguración de seguridad de todas
las tablas
En el navegador
Biblioteca , haga clic con
el bótón secundario
sobre Tablas y luego
haga clic en Seguridad.
De manera
predeterminada, la
cónfiguración de la tabla
requiere privilegios
administrativos en el
servidor de PI AF.
desactivada
Nota:
No es necesario activar el soporte para las tablas de PI AF externas de usuarios no
simulados. Puede incluir un ID de usuario y cóntrasena como parte de la cadena de
cónexión de una cónexión de tabla PI AF e ingresarla, independientemente de que esten
activados o no los soportes para tablas de PI AF externas para usuarios no simulados. La
cónexión de tabla PI AF definida puede utilizarse dentro de una definición de tabla PI AF.
Esto significa que si un inicio de sesión en SQL Server tiene permiso para acceder a los
datos referenciados en la cadena de cónexión, una tabla vinculada PI AF a esa cónexión de
tabla PI AF puede recuperar los datos externos.
Crear conexiones de tabla reutilizables
Cree una cónexión OLE DB y vuelva a utilizarla para cónfigurar tablas vinculadas desde el
mismo origen de datos.
Antes de empezar
Utilice PI System Explorer de 64 bits para cónfigurar conexiones a tablas vinculadas. Incluye
controladores OLE DB de 64 bits, que son obligatorios en los servidores de PI AF de 64 bits.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. Elija una de las siguientes acciones:
◦ Seleccione Conexiones de tabla y haga clic en Nueva conexión de tabla en la barra de
herramientas.
◦ En el navegador, haga clic con el bótón secundario en Conexiones de tabla y haga clic en
Nueva conexión de tabla.
Las propiedades de cónexión de tabla se muestran en el visor con el nombre
predeterminado en el campo Nombre.
3. Opcional. Edite el nombre predeterminado y anada una descripción de la cónexión de tabla
en el campo Descripción.
222
Guía del usuario PI System Explorer
Configuración de referencias de datos
4. En el campo Conexión, puede introducir una cadena de cónexión directamente o hacer clic
en Construir para cónfigurar la cónexión en la ventana Propiedades de vínculo de datos.
5. En la pestana Proveedor de Propiedades de vínculo de datos, seleccione un proveedor OLE
DB y siga las instrucciones que aparecen en la pantalla para cónfigurar la cónexión.
6. En función del proveedor seleccionado, tal vez necesite especificar la fuente de datos y la
ubicación, el nombre del servidor, el nombre de usuario, la cóntrasena o la base de datos.
7. Haga clic en Aceptar. La cadena de cónexión para la cónexión de tabla reutilizable se
muestra en el campo Conexión.
8. Si el sistema lo solicita, introduzca una cóntrasena y haga clic en Aceptar.
9. En el visor, seleccione una ópción de Seguridad. Puede que algunas opciones no esten
disponibles.
◦ Simular cliente (recomendado)
◦ Proporcionar contraseña
Nota:
Puede utilizar el bótón Cambiar contraseña para módificar la cóntrasena de SQL
Server requerida para la cónexión de la tabla.
◦ No hay contexto de seguridad adicional
Consulte Autenticación de tablas vinculadas para obtener infórmación sobre estas opciones.
10. Haga clic en Ingresar en el menu principal para ingresar y guardar la cónexión de tabla.
Acceso a los datos de Microsoft Access o Excel
Para acceder a los datos de una base de datos de Microsoft Access o un libro de trabajo de
Microsoft Excel, puede vincular o importar los datos. Los datos de una tabla vinculada se
actualizan al acceder a la tabla y siempre que la hora desde la ultima actualización sea
posterior al ajuste del intervalo de caché de la tabla.
Los datos importados se cargan en la tabla de PI AF una sola vez. Si necesita actualizar los datos
importados en una tabla, puede hacer clic con el bótón secundario en el navegador Biblioteca y
luego hacer clic en Volver a importar tabla.
Puede vincular o importar datos desde una tabla de Microsoft Access o un libro de trabajo de
Microsoft Excel despues de realizar los siguientes pasos:
• Especifique la base de datos de origen o el libro de trabajo.
• Cree una consulta que devuelva los datos deseados.
• Ingrese las credenciales de inicio de sesión necesarias para acceder a la base de datos o al
libro de trabajo.
Las instrucciones exactas dependen de la cónfiguración de hardware y de lo que intente hacer:
Servidor PI AF de 32 bits
Servidor PI AF de 64 bits
Siga las instrucciones incluidas en Vincular o importar datos.
• Para importar, siga las instrucciones incluidas en Vincular o
importar datos.
• Para vincular, siga las instrucciones incluidas en Vincular datos
en un servidor de PI AF de 64 bits.
En esta sección
• Vincular o importar datos
• Vincular datos en un servidor de PI AF de 64 bits
Guía del usuario PI System Explorer
223
Configuración de referencias de datos
Vincular o importar datos
En estas instrucciones se describe cómó importar datos en un servidor de PI AF de 32 bits o 64
bits y cómó vincular datos en un servidor de PI AF de 32 bits unicamente. Para vincular datos
en un servidor de 64 bits, consulte Vincular datos en un servidor de PI AF de 64 bits.
Procedimiento
1. En PI System Explorer, vaya a la tabla de PI AF o cree una como se describe en Crear tablas
de PI AF.
2. En el panel Biblioteca, expanda el nodo Tablas y haga clic en la tabla de PI AF que desee.
Los detalles de la tabla se móstraran en el panel derecho.
3. Haga clic en Vincular o Importar.
Se abrira la ventana correspondiente.
4. Solo para vinculaciones: Si va a vincular la tabla, active la ópción Suplantar cliente (no se
muestra en el caso de la impórtación).
5. Haga clic en Crear.
Se abrira la ventana Propiedades de vínculo de datos.
6. En la pestana Proveedor, seleccione el proveedor segun la versión de Microsoft Office que
este utilizando y haga clic en Siguiente.
◦ En Office 97-2003: seleccione Proveedor OLE DB de Microsoft Jet 4.0.
◦ En Office 2007 y posteriores, seleccione Proveedor OLE DB del motor de base de datos
de Access de Microsoft Office 12.0.
7. En la pestana Conexión, especifique lo siguiente y haga clic en Aceptar.
◦ Fuente de datos
La ubicación y el nombre de archivo de la base de datos o el libro de trabajo (por ejemplo,
C:\AFTestData.xls). Si va a realizar una vinculación, la ruta al archivo debe ser relativa
al servidor de PI AF.
◦ Nombre de usuario
Credenciales de inicio de sesión de un usuario al que se ha otorgado acceso de lectura a la
base de datos o al libro de trabajo.
Nota:
Para almacenar la cóntrasena con la infórmación de cónexión, marque la casilla de
verificación Permitir guardar contraseña. La cóntrasena se almacena como texto sin
formato (sin cifrar).
8. En la pestana Avanzadas, en la lista Permisos de acceso, seleccione Share Deny None.
9. Solo en Excel: En la pestana Todo, seleccione el valor Propiedades extendidas y haga clic en
Editar valor.
Se abrira la ventana Modificar valor de la propiedad.
Introduzca el valor de propiedad segun la versión de Microsoft Excel que este utilizando y, a
cóntinuación, haga clic en Aceptar.
◦ En Excel 97-2003: Excel 8.0
◦ En Excel 2007 y posteriores: Excel 12.0
10. Para comprobar que se puede acceder a la hoja de calculó, vuelva a la pestana Conexión y
haga clic en Probar conexión.
224
Guía del usuario PI System Explorer
Configuración de referencias de datos
Si los ajustes son validós se móstrara el mensaje Test connection succeeded.
11. Para cerrar la ventana y volver a PI System Explorer, haga clic en Aceptar.
12. Para definir los datos que se devólveran en la hoja de calculó, introduzca una consulta SQL
en el campo Consulta. Para cerrar la ventana, haga clic en Aceptar.
◦ Ejemplo de Microsoft Excel: SELECT * FROM [Sheet1$]
◦ Ejemplo de Microsoft Access: SELECT * FROM Table1
13. Para ver los resultados, examine la pestana Tabla. Si la consulta se ha especificadó de forma
correcta, la pestana cóntendra una tabla con los resultados.
14. Para guardar los cambios, haga clic con el bótón secundario sobre el nodo Tabla y haga clic
en Ingresar.
Vincular datos en un servidor de PI AF de 64 bits
Para vincular datos en una base de datos de Access o un libro de trabajo de Excel en un servidor
de PI AF de 64 bits, debe utilizar el proveedor de datos Access Database Engine (ACE) de 64
bits. No existe un proveedor de datos Jet de 64 bits.
Procedimiento
1. En PI System Explorer, vaya a la tabla de PI AF o cree una como se describe en Crear tablas
de PI AF.
2. En el panel Biblioteca, expanda el nodo Tablas y haga clic en la tabla de PI AF que desee.
Los detalles de la tabla se móstraran en el panel derecho.
3. Haga clic en Vincular.
Se abrira la ventana correspondiente.
4. Active la ópción Suplantar cliente.
5. En el campo Conexión, introduzca una cadena de cónexión valida para el libro de trabajo de
Excel o la base de datos de Access con el proveedor OLE DB del motor de base de datos de
Access de Microsoft Office 12.0 (debe estar instalado en el servidor de PI AF), como se
muestra en los siguientes ejemplos:
◦ Ejemplo de Microsoft Excel:
Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\example.xlsx;Extended
Properties="Excel 12.0 Xml";
◦ Ejemplo de Microsoft Access:
Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\example.accdb;Persist
Security Info=False;
6. Para definir los datos que se devólveran en la hoja de calculó, introduzca una consulta SQL
en el campo Consulta. Para cerrar la ventana, haga clic en Aceptar.
◦ Ejemplo de Microsoft Excel: SELECT * FROM [Sheet1$]
◦ Ejemplo de Microsoft Access: SELECT * FROM Table1
7. Para ver los resultados, examine la pestana Tabla. Si la consulta se ha especificadó de forma
correcta, la pestana cóntendra una tabla con los resultados.
8. Para guardar los cambios, haga clic con el bótón secundario sobre el nodo Tabla y haga clic
en Ingresar.
Guía del usuario PI System Explorer
225
Configuración de referencias de datos
Acceso a los datos de SQL Server
Cuando importe datos de una tabla de Microsoft SQL Server o los vincule a ella, debe definir
infórmación de cónexión valida. Los pasos de vinculación o impórtación dependen del metódó
de cónexión que elija, tal como se describe en Autenticación de tablas vinculadas.
En esta sección
• Uso de la cónexión de seguridad suplantada de Windows
• Utilizar la seguridad no suplantada de Windows
• Utilizar las funciones de seguridad de SQL Server
• Cónfiguración de la seguridad en la base de datos de la tabla de destino
• Importar o vincular tablas de SQL Server
Uso de la conexión de seguridad suplantada de Windows
Vincule o importe datos de una tabla de SQL Server con la ópción Simular cliente. Consulte
Recomendaciones relativas al acceso a los datos para tablas vinculadas.
Nota:
Si va a vincular con un SQL Server que no esta en el mismo equipo que el servidor de PI
AF, puede que sea necesario cónfigurar Kerberos para permitir que la identidad del
cliente se reenvíe desde servidor de PI AF al SQL Server.
Procedimiento
1. Crear un grupo de usuarios local para clientes simulados.
2. Cónfiguración de la seguridad en la base de datos de la tabla de destino.
3. Importar o vincular tablas de SQL Server.
Crear un grupo de usuarios local para clientes simulados
Si la tabla a la que desea conectarse reside en una instancia de SQL Server distinta de aquella
donde reside la base de datos SQL de PI AF (PIFD), asegurese de que la tabla resulte accesible
mediante autenticación de Windows.
Procedimiento
1. En el equipo donde reside la instancia de SQL Server, haga clic en Inicio > Herramientas
administrativas > Administración de equipos.
Se abrira la aplicación Administración de equipos.
2. Expanda Usuarios y grupos locales.
3. Haga clic con el bótón secundario sobre Grupos y seleccione Nuevo grupo.
4. En la ventana Nuevo grupo, cree un grupo local para los usuarios que necesiten acceder a la
tabla de bases de datos.
5. Anada a este grupo las cuentas de todos los usuarios que pódrían suplantarse.
6. Haga clic en Aceptar para anadir los usuarios seleccionados y, a cóntinuación, en Cerrar para
salir de la ventana Nuevo grupo.
7. Cierre la aplicación Administración de equipos.
226
Guía del usuario PI System Explorer
Configuración de referencias de datos
Utilizar la seguridad no suplantada de Windows
Vincule o importe datos de una tabla de SQL Server con la ópción de contexto no additional
security .
Procedimiento
1. Crear un grupo de usuarios local para la cuenta del servicio de aplicación de PI AF
2. Cónfiguración de la seguridad en la base de datos de la tabla de destino
3. Importar o vincular tablas de SQL Server
Crear un grupo de usuarios local para la cuenta del servicio de aplicación de PI AF
Si la tabla a la que desea conectarse reside en una instancia de SQL Server distinta de aquella
donde reside la base de datos SQL de PI AF (PIFD), asegurese de que la tabla resulte accesible
para la cuenta del servicio de aplicación de PI AF.
Procedimiento
1. En el equipo donde reside la instancia de SQL Server, haga clic en Inicio > Herramientas
administrativas > Administración de equipos.
Se abrira la aplicación Administración de equipos.
2. Expanda Usuarios y grupos locales.
3. Haga clic con el bótón secundario sobre Grupos y seleccione Nuevo grupo.
4. En la ventana Nuevo grupo, cree un grupo de usuarios locales que incluira la identidad del
servicio de aplicación del servidor de PI AF.
5. Anada la cuenta del usuario asociado con el servicio de aplicación del servidor de PI AF al
nuevo grupo. Si el servicio de aplicación del servidor de PI AF se ejecuta con la cuenta NT
AUTHORITY\NetworkService, anada la cuenta de equipo del servidor de PI AF a este
grupo.
Nota:
Si el servicio de aplicación del servidor de PI AF se ejecuta con la cuenta de sistema
local o de servicio local, probablemente necesitara utilizar la autenticación de SQL
Server (modo de autenticación de SQL Server y Windows) en lugar de la seguridad
integrada. Para evitar ataques malintencionados en SQL Server, OSIsoft no recomienda
usar el Sistema local. En su lugar, use el Servicio de red, una cuenta del Servicio local o
una cuenta creada específicamente con privilegios limitados.
6. Haga clic en Aceptar para anadir el usuario seleccionado.
7. Cierre la aplicación Administración de equipos.
Utilizar las funciones de seguridad de SQL Server
Vincular o importar datos de una tabla de SQL Server utilizando autenticación de SQL Server.
Antes de empezar
Si va a conectarse con una instancia remota de SQL Server, asegurese de que SQL Server se ha
cónfiguradó para aceptar conexiones remotas.
Si va a utilizar una cuenta de SQL Server, asegurese de que la instancia de SQL Server se ha
cónfiguradó para permitir autenticación de modo mixto.
Guía del usuario PI System Explorer
227
Configuración de referencias de datos
Procedimiento
1. Creación de un usuario de SQL Server.
2. Cónfiguración de la seguridad en la base de datos de la tabla de destino.
3. Importar o vincular tablas de SQL Server.
Creación de un usuario de SQL Server
Si la tabla de destino (la tabla a la que desea conectarse) reside en una instancia de SQL Server
distinta de aquella donde reside la base de datos de PI AF (PIFD), cree un usuario y active el
acceso del usuario a la base de datos como se describe en este tema.
Procedimiento
1. Abra Microsoft SQL Server Management Studio y cónectese a la instancia de SQL Server que
contiene la tabla de destino.
2. En la instancia de SQL Server, expanda la carpeta Seguridad y despues la carpeta Inicios de
sesión.
3. Cree un inicio de sesión e introduzca un nombre en el campo Nombre de inicio de sesión.
4. Seleccione una ópción en Autenticación de SQL Server.
5. Introduzca la cóntrasena en los campos Contraseña y Confirmar contraseña.
6. En la lista Base de datos predeterminada, seleccione la base de datos que contiene la tabla
de destino.
7. Seleccione la pagina Asignación de usuarios.
8. Seleccione la fila de la base de datos que contiene la tabla de destino.
9. Marque la casilla de verificación Asignar de la base de datos seleccionada.
10. Haga clic en Aceptar para cerrar la ventana Iniciar sesión - Nuevo y guarde el inicio de sesión.
11. Expanda la carpeta Bases de datos y, a cóntinuación, la carpeta de la base de datos de
destino y otorgue los permisos necesarios para ejecutar la consulta que se utilizara para el
inicio de sesión que acaba de crear.
Por ejemplo, si la consulta que se utilizara es una clausula SELECT que especifica una tabla
unica, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y,
cóntinuación, haga clic con el bótón secundario en la tabla a la que se refiera la consulta y
seleccione Propiedades.
12. En la ventana Propiedades de tabla, seleccione la pagina Permisos; a cóntinuación, Inicio de
sesión y Otorgar el inicio de sesión para seleccionar permiso. Haga clic en Aceptar para
cerrar la ventana Propiedades de tabla.
13. Cierre Microsoft SQL Server Management Studio.
Configuración de la seguridad en la base de datos de la tabla de destino
Es necesario otorgar a todas las cuentas con la que se puede ejecutar la consulta especificada
permiso para ejecutar esa consulta.
Procedimiento
1. Abra Microsoft SQL Server Management Studio y cónectese a la instancia de SQL Server que
contiene la tabla de destino.
2. En la instancia de SQL Server, expanda la carpeta Seguridad y despues la carpeta Inicios de
sesión.
228
Guía del usuario PI System Explorer
Configuración de referencias de datos
3. Haga clic con el bótón secundario en la carpeta Inicios de sesión y seleccione Nuevo inicio de
sesión.
4. Utilice el bótón Buscar para localizar el grupo creado en la sección anterior y elegir ese
grupo como nombre de inicio de sesión.
5. Seleccione la ópción Autenticación de Windows y la base de datos que contiene la tabla de
destino como la Default database.
6. Seleccione la pagina Asignación de usuarios.
7. Seleccione la fila de la base de datos que contiene la tabla de destino.
8. Marque la casilla de verificación Asignar de la base de datos seleccionada.
9. Expanda la carpeta Bases de datos y despues la carpeta de la base de datos de destino y
otorgue los permisos necesarios para ejecutar la consulta que se utilizara para el inicio de
sesión que acaba de crear.
Por ejemplo, si la consulta que se utilizara es una clausula SELECT que especifica una tabla
unica, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y,
cóntinuación, haga clic con el bótón secundario en la tabla a la que se refiera la consulta y
seleccione Propiedades.
10. En la ventana Propiedades de la tabla, seleccione la pagina Permisos, busque y seleccione
Inicio de sesión, despues Otorgar al inicio de sesión el permiso seleccionado y pulse Aceptar
para cerrar la ventana Propiedades de la tabla.
11. Cierre Microsoft SQL Server Management Studio.
Importar o vincular tablas de SQL Server
Tanto si va a importar tablas de Microsoft SQL Server como a importar desde ellas, el proceso
es basicamente el mismo. Las siguientes instrucciones describen cómó vincular una tabla de PI
AF existente utilizando PI System Explorer.
Procedimiento
1. Para examinar la tabla de PI AF de destino, abra el panel Biblioteca, expanda el nodo Tablas
y haga clic en la tabla que desee.
Las propiedades de la tabla se móstraran en el panel derecho.
2. Haga clic en Vincular.
Se abrira la ventana Vínculo de tabla.
3. Haga clic en la flecha abajo de Conexión y luego seleccione Construir.
Se abrira la ventana Propiedades de vínculo de datos.
4. En la pestana Proveedor, seleccione SQL Server Native Client 11.0.
5. En la pestana Conexión, cónfigure la instancia de SQL Server que contiene la base de datos
con la que desea conectarse.
6. Cónfigure la autenticación:
◦ Para una seguridad integrada, seleccione la ópción Use Windows NT Integrated
Security. Consulte Autenticación de tablas vinculadas si desea mas infórmación.
◦ Para la seguridad de SQL Server, seleccione la ópción Use a Specific user name and
password. Luego introduzca el nombre de inicio de sesión de SQL Server en el campo
Nombre de usuario. Haga clic para anular la selección de la casilla de verificación
Guía del usuario PI System Explorer
229
Configuración de referencias de datos
Contraseña en blanco y especifique que la cóntrasena es obligatoria. Introduzca una
cóntrasena en el campo Contraseña.
Nota:
Asegurese de que el soporte para las tablas externas de PI AF de usuarios no
suplantados se haya habilitado con el comando afdiag /DTImp.
7. Haga clic en la flecha abajo de Select the database y elija la base de datos que contenga
la tabla a la que desea conectarse.
8. Para comprobar que los ajustes de cónfiguración funcionan, haga clic en Probar conexión. Si
los ajustes son correctos, PI System Explorer móstrara un mensaje indicando que son
correctos.
Nota:
La prueba de cónexión verifica que la cuenta con la que se esta ejecutando PI System
Explorer tiene acceso a la base de datos especificada. Sin embargo, si opta por la
seguridad integrada de Windows NT en la definición de tabla y selecciona la ópción No
additional security context para la seguridad de cónexión de tabla, se utilizara
la cuenta asociada con el servicio de la aplicación del servidor de PI AF para
conectarse cuando un usuario muestre los datos al abrir la pestana Tabla.
9. Haga clic en Aceptar.
10. Si el sistema lo solicita, introduzca una cóntrasena y haga clic en Aceptar. Regresara a la
ventana Vínculo de tabla.
11. En el campo Consulta, especifique la consulta SQL que devólvera los datos deseados y haga
clic en Aceptar.
Si la cadena de cónexión requiere un ID de usuario y cóntrasena, seleccione la ópción
Proporcionar cóntrasena. Para cambiar la cóntrasena utilizada para conectarse a la tabla
SQL, haga clic en el bótón Cambiar contraseña e introduzca la nueva cóntrasena de inicio de
sesión de SQL. Esto reemplaza el valor introducido previamente en el campo Contraseña.
12. Para mostrar los datos recuperados por la consulta, abra la pestana Tabla.
13. Haga clic en Ingresar en el menu principal para ingresar y guardar la cónexión de tabla.
Eliminar caracteres de control de tablas de AF importadas
Despues de importar o vincular datos de una fuente de datos externa, debería inspeccionar si
las tablas de AF contienen caracteres de control, como retornos de carro y avances de línea
antes de ejecutar una consulta. La presencia de caracteres de control puede causar el error de
una consulta de busqueda en la tabla de AF. Elimine los caracteres de control de estas tablas
para evitar problemas con la recuperación de resultados de busqueda. Consulte Sintaxis de la
clausula WHERE para obtener infórmación sobre el uso de la clausula WHERE para obtener
valores de una columna de tabla en una referencia de datos de busqueda de tabla.
En las tablas de AF, las celdas resaltadas en amarillo indican la presencia de caracteres de
control. Si la tabla contiene datos importados, puede ver y eliminar los caracteres de control
mediante el cuadro de texto Visualizador de texto.
Nota:
Las celdas que contienen caracteres de control en las tablas vinculadas tambien aparecen
resaltadas. Puede utilizar el Visualizador de texto para ver estos caracteres de control,
pero no puede editarlos o eliminarlos.
Procedimiento
1. En el navegador Biblioteca, desplacese hasta la tabla importada o vinculada.
2. Haga clic en la pestana Tabla.
230
Guía del usuario PI System Explorer
Configuración de referencias de datos
3. En la pestana Tabla, localice las celdas resaltadas en amarillo.
4. Coloque el puntero del mouse sobre la celda resaltada y luego haga clic en la celda. La
infórmación sobre herramientas muestra el contenido de la celda y el texto <*Contains
Control Characters*> .
5. Haga clic con el bótón secundario en la celda y luego seleccione Mostrar el contenido de la
celda seleccionada. Se abre el cuadro de texto Visualizador de texto.
6. Haga clic en la casilla de verificación Mostrar los caracteres de control para visualizar todos
los caracteres de control de la celda.
Nota:
El cuadro de texto Visualizador de texto es de solo lectura cuando se muestran los
caracteres de control. No puede editar el contenido de la celda o eliminar los
caracteres de control en una tabla importada cuando la ópción Mostrar caracteres de
control esta seleccionada. Para editar el contenido de la celda en una tabla importada,
primero debe anular la selección de la ópción Mostrar caracteres de control.
7. Haga clic en la casilla de verificación Mostrar caracteres de control para anular la selección
de la ópción y ocultar todos los caracteres de control.
8. Opcional: Si tiene datos importados en una tabla de AF, puede eliminar todos los caracteres
de control, como retornos de carro (<CR>), espacios (·) y avances de línea (<LF>), a fin de
asegurarse de que permanezcan solo los caracteres esenciales.
9. Una vez que todos los caracteres de control hayan sido eliminados, haga clic en Aceptar. La
celda dejara de estar resaltada en amarillo una vez que los caracteres de control hayan sido
eliminados.
10. Repita los pasos 3 al 9 para continuar visualizando y eliminando los caracteres de control en
una tabla importada.
11. Para guardar su trabajo, haga clic con el bótón secundario en la tabla del navegador
Biblioteca y seleccione Ingresar.
Configurar las referencias de datos de búsqueda de tabla
Si desea que un atributo obtenga su valor de una columna de tabla, cree una referencia de datos
de busqueda de tabla.
Procedimiento
1. En el navegador Elementos o Biblioteca, seleccione el elemento o la plantilla de elemento que
desee utilizar.
2. En el visor, seleccione el atributo o la plantilla de atributos que desea que posean un valor
de busqueda de tabla.
3. En la lista del campo Referencia de datos de la paleta, elija Búsqueda de tabla.
4. Haga clic en Ajustes.
5. En la ventana Referencia de datos de búsqueda de tabla, seleccione una tabla anteriormente
definida en la lista desplegable Tabla. Tambien puede seleccionar una de las siguientes
opciones.
Guía del usuario PI System Explorer
231
Configuración de referencias de datos
◦ Haga clic en
(Administrar tablas) para abrir una lista de tablas en las que pódra
realizar busquedas o aplicar filtrós. Para seleccionar una tabla, resaltela en la lista y haga
clic en Aceptar.
◦ Haga clic en
(Propiedades de tabla) para ver o editar las propiedades de la tabla
seleccionada.
◦ Haga clic en
(Crear tabla) para definir una nueva tabla.
6. En la lista Columna de resultados, seleccione la columna en la tabla de la que desee leer el
valor.
Nota:
Seleccione la casilla Escalonado para que el valor aparezca escalonado al trazarlo en
una tendencia. En esta cónfiguración, no hay interpólación entre los valores de la tabla.
7. En la lista Unidad de medida, seleccione la unidad de medida en la que se encuentran
almacenados los datos de la columna de resultados.
Nota:
Es preferible cónfigurar las UOM directamente en la definición de tabla para no tener
que especificarla en cada busqueda de tabla.
8. En Zona horaria, puede definir un ajuste si no se ha definidó anteriormente en la definición
de tabla o columna.
9. En la lista Regla, seleccione una ópción:
◦ Select first row matching criteria
Utilice la lista Ordenar por para especificar el orden que se utilizara. Este orden sirve para
seleccionar una fila cuando mas de una coincida con los criterios. Para obtener mas
infórmación, consulte Seleccionar primera fila que coincida con los criterios.
◦ Summarize all rows matching criteria
Seleccione una óperación de resumen en la lista Resumen para realizar la óperación
elegida en la columna seleccionada en un rango de filas coincidentes con los criterios.
Para obtener mas infórmación, consulte Resumir todas las filas que coincidan con los
criterios.
◦ Table provided time series data
Seleccione esta ópción si la tabla tiene valores con marcas de fecha y hora asociadas y
desea considerar estos valores como datos de series temporales. En la lista Columna de
hora, seleccione la columna de tabla que contenga las marcas de tiempo que desea
utilizar. Solo figuran en la lista las columnas con un tipo de valor de fecha y hora. Si
selecciona esta ópción, la clausula WHERE no es necesaria. Para obtener mas infórmación,
consulte Datos de serie temporal proporcionados por tablas.
Nota:
Para garantizar que se muestren las columnas con los tipos de valor de fecha y hora,
solo tiene que especificar los valores de zona horaria en la pestana General de la
definición de tabla general. No especifique las zonas horarias en la definición de la
columna (en la pestana Definir tabla).
10. Utilice los menus y los botones del panel Donde para elaborar la consulta de tabla.
Nota:
Tambien puede escribir la clausula entera en el campo de texto Cláusula DONDE
completa:. Consulte Sintaxis de la clausula WHERE si desea mas infórmación.
232
Guía del usuario PI System Explorer
Configuración de referencias de datos
◦ En la lista Columna , seleccione la columna de la tabla que se utilizara en la consulta.
◦ En la lista Operador, seleccione el operador relacional que se utilizara en la consulta.
◦ En la lista Atributo o valor, seleccione un atributo o un valor literal para utilizarlo en la
consulta.
◦ Haga clic en Añadir y o Añadir o para escribir la clausula WHERE en el campo Cláusula
DONDE completa con un operador AND o OR.
◦ Edite la clausula en el campo Cláusula DONDE completa segun proceda.
Nota:
Los botones Añadir y o Añadir o generaran, siempre que resulte posible, de forma
autómatica la sintaxis, la UOM y la zona horaria necesarias.
11. Opcional. Edite los valores de los parametrós de tabla.
Los parametrós de tabla solo se aplican a las tablas vinculadas. Para obtener mas
infórmación, consulte Parametrós de consultas de tablas vinculadas.
12. Opcional. En Valores de sustitución, seleccione los atributos o los valores literales que se
devólveran cuando la consulta de tabla no encuentre una fila coincidente o encuentre un
resultado nulo.
En esta sección
• Seleccionar primera fila que coincida con los criterios
• Resumir todas las filas que coincidan con los criterios
• Datos de serie temporal proporcionados por tablas
• Sintaxis de la clausula WHERE
• Parametrós de consultas de tablas vinculadas
Seleccionar primera fila que coincida con los criterios
La regla Select first row matching criteria permite especificar la primera fila
coincidente con el valor devuelto por la clausula WHERE.
Sintaxis
SELECT column FROM table WHERE where clause ORDER BY column ASC|DESC; options and
parameters
Argumentos
• SELECCIONE column
Si un nombre de columna contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ].
• DE table
Si un nombre de tabla contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ].
• DONDE clause
Ademas de los operadores relacionales =, <>, >, >=, <, <=, LIKE y IN, puede especificar
INTERPOLATE para interpolar un valor para la columna de resultado basandóse en una
interpólación de las columnas de entrada especificadas.
A partir de PI AF 2018, puede realizar dos tipos de interpolaciones:
Guía del usuario PI System Explorer
233
Configuración de referencias de datos
◦ Interpólación lineal, en la que la interpólación es para dos columnas de datos. Para
especificar la interpólación lineal, use la sintaxis INTERPOLATE(column, value).
◦ Interpólación estandar de dos líneas, en la que la interpólación es para tres columnas de
datos. Para especificar la interpólación de dos líneas, use la sintaxis
INTERPOLATE(column_X, value_X) AND INTERPOLATE(column_Y, value_Y).
Actualmente, el sistema no es compatible con la interpólación irregular de dos líneas y la
extrapólación de dos líneas.
Nota:
El comportamiento predeterminado del operador INTERPOLATE consiste en
extrapolar si el valor de entrada esta por fuera del rango de tabla observado. Tenga en
cuenta ademas que los cambios de extrapólación cuando se selecciona la casilla de
verificación Escalonado.
Para obtener mas infórmación sobre la sintaxis de la clausula WHERE, consulte Sintaxis de la
clausula WHERE. Para conocer ejemplos de uso del operador INTERPOLATE, consulte
Ejemplos de interpólación lineal y de dos líneas en referencias de datos Table Lookup.
• ORDENAR POR column
Opcional. Especifica el criterio de órdenación para poder utilizar la fila correcta cuando
exista mas de una fila coincidente con la clausula WHERE. El orden Ascendente (ASC) es el
predeterminado, a menos que se especifique Descendente (DESC).
• Opciones
Puede introducir las siguientes opciones en una lista separadas por punto y coma.
Escalonado
Cuando se establece en True, el valor devuelto se muestra
escalonadamente en las aplicaciones.
TZ=time zone
Especifica la zona horaria de la tabla de origen.
Nota:
OSIsoft recomienda cónfigurar la zona horaria en la descripción
general de la tabla para no tener que especificarla en cada busqueda
de tabla.
UOM=uom
Especifica la unidad de medida del valor devuelto por la columna de
resultado.
Nota:
Tambien puede cónfigurar la unidad de medida en la definición de
columna de la tabla para no tener que especificarla en cada busqueda
de tabla.
RWM=value
Especifica el valor que devolver cuando no existe ninguna columna
coincidente. Si el valor es No Data, se devuelve el estado digital de No
Data.
RWN=value
Especifica el valor que devolver cuando la columna de resultado es nula. Si
el valor es No Data, se devuelve el estado digital de No Data.
• Parámetros
Puede introducir los siguientes opciones en una lista separadas por punto y coma. Empiece
cada nombre de parametró con el caracter @ en formato @parameter=value (value se
describe en "Atributo o valor" en Sintaxis de la clausula WHERE). Para obtener mas
infórmación sobre cómó utilizar los parametrós, consulte Parametrós de consultas de tablas
vinculadas.
234
Guía del usuario PI System Explorer
Configuración de referencias de datos
Ejemplo
SELECT [Installation Date] FROM [Equipment Specifications] WHERE [Asset ID] =
'%Element%'
Ejemplos de interpolación lineal y de dos líneas en referencias de datos Table Lookup
Ejemplo de interpolación lineal
En una tabla de calibración de tanques que contenga una columna de Level y una columna de
Volume, la siguiente cadena de cónfiguración interpola el volumen en función del resultado de
nivel:
SELECT Volume FROM MyTable WHERE INTERPOLATE(Level, @MyLevelReading)
Se asume que la taba de ejemplo incluye las siguientes filas:
Level
Volume
1
0,0
2
20,0
3
30,0
4
40,0
5
60,0
6
70,0
• Una lectura de Level de 2,2 da lugar a un Volume de 22,0.
• Una lectura de Level de 2,7 da lugar a un Volume de 20,0 cuando Por pasos esta
seleccionado (verdadero).
• Extrapólación: Una lectura de Level de 6,5 da lugar a un Volume de 75,0 cuando Por pasos
no esta seleccionado (falso).
• Extrapólación: Una lectura de Level de 6,5 da lugar a un Volume de 70,0 cuando Por pasos
esta seleccionado (verdadero).
Ejemplo de interpolación de dos líneas
En una tabla de velocidad del aire que contenga una columna de X Horizontal Position,
una columna de Y Vertical Position y una columna de Velocity, la siguiente cadena de
cónfiguración interpola la velocidad en función de la posiciones de los ejes X horizontal e Y
vertical:
SELECT Velocity FROM Table1 WHERE INTERPOLATE([X Horizontal Position], @X) AND
INTERPOLATE([Y Vertical Position], @Y)
Se asume que la taba de ejemplo incluye las siguientes filas:
Posición X horizontal
Posición Y vertical
Velocidad
180
140
4,6
220
140
4,1
260
140
2.7
180
180
4,8
220
180
4,4
260
180
2,5
180
220
4.5
220
220
4,4
Guía del usuario PI System Explorer
235
Configuración de referencias de datos
Posición X horizontal
Posición Y vertical
Velocidad
260
220
2,5
Un resultado de X Horizontal Position de 245 y un resultado de Y Vertical Position
de 165 da lugar a un Velocity de 3,2171875.
Resumir todas las filas que coincidan con los criterios
La regla Summarize all rows matching criteria permite realizar una óperación de
resumen en las filas de una columna de tabla que coincidan con los criterios de selección.
Sintaxis
SELECT summary(column) FROM table WHERE where clause; options and parameters
Argumentos
• SELECCIONE summary(column)
Si un nombre de columna contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ]. Puede seleccionar una de los siguientes operaciones.
Operación
Descripción
Sum
Total de valores de todas las filas.
Avg
Media de valores de todas las filas.
Min
Valor mínimó de todas las filas.
Max.
Valor maximó de todas las filas.
Count
Numeró de filas.
StDev
Grado de desviación de valores de todas las filas.
Var
Medida media de la diferencia de los valores de todas las filas con respecto a la
media.
Ninguna
Cuando no se especifica ninguna óperación:
◦ Si el atributo de resultado no es una matriz, se devuelve el valor de la
columna seleccionada en la primera fila que coincide con la clausula
WHERE.
◦ Si el atributo de resultado es una matriz, se devuelve una matriz con un
valor de cada columna de todas las filas que coinciden con la clausula
WHERE.
• DE table
Si un nombre de tabla contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ].
• DONDE clause
Para obtener mas infórmación sobre la sintaxis de la clausula WHERE, consulte Sintaxis de la
clausula WHERE.
• Opciones
Puede introducir las siguientes opciones en una lista separadas por punto y coma.
Escalonado
236
Cuando se establece en True, el valor devuelto se muestra
escalonadamente en las aplicaciones.
Guía del usuario PI System Explorer
Configuración de referencias de datos
TZ=time zone
Especifica la zona horaria de la tabla de origen.
Nota:
OSIsoft recomienda cónfigurar la zona horaria en la descripción
general de la tabla para no tener que especificarla en cada busqueda
de tabla.
UOM=uom
Especifica la unidad de medida del valor devuelto por la columna de
resultado.
Nota:
Tambien puede cónfigurar la unidad de medida en la definición de
columna de la tabla para no tener que especificarla en cada busqueda
de tabla.
RWM=value
Especifica el valor que devolver cuando no existe ninguna columna
coincidente. Si el valor es No Data, se devuelve el estado digital Sin datos.
RWN=value
Especifica el valor que devolver cuando la columna de resultado es nula. Si
el valor es No Data, se devuelve el estado digital Sin datos.
• Parámetros
Puede introducir los siguientes opciones en una lista separadas por punto y coma. Empiece
cada nombre de parametró con el caracter @ en formato @parameter=value (value se
describe en "Atributo o valor" en Sintaxis de la clausula WHERE). Para obtener mas
infórmación sobre cómó utilizar los parametrós, consulte Parametrós de consultas de tablas
vinculadas.
Datos de serie temporal proporcionados por tablas
La regla Table provided time series data permite seleccionar una tabla que contenga
valores con un tipo de datos DateTime y especificar la columna que contiene los datos de serie
temporal.
Sintaxis
SELECT column FROM table WHERE where clause; TC=column; options and parameters
Argumentos
• SELECCIONE column
Si un nombre de columna contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ].
• DE table
Si un nombre de tabla contiene caracteres no alfanumericós, incluidos espacios, debera
estar comprendido entre corchetes [ ].
• DONDE clause
Opcional. Para obtener mas infórmación sobre la sintaxis de la clausula WHERE, consulte
Sintaxis de la clausula WHERE.
• TC column
Especifica la columna que contiene los valores de serie temporal. Si un nombre de columna
contiene caracteres no alfanumericós, incluidos espacios, debera estar comprendido entre
corchetes [ ].
Guía del usuario PI System Explorer
237
Configuración de referencias de datos
• Opciones
Puede introducir las siguientes opciones en una lista separadas por punto y coma.
Escalonado
Cuando se establece en True, el valor devuelto se muestra
escalonadamente en las aplicaciones.
TZ=time zone
No admitido a nivel de columna. Tiene que especificar una zona horaria en
el campo Zona horaria en la pestana General para la tabla en general.
UOM=uom
Especifica la unidad de medida del valor devuelto por la columna de
resultado.
Nota:
Tambien puede cónfigurar la unidad de medida en la definición de
columna de la tabla para no tener que especificarla en cada busqueda
de tabla.
RWM=value
Especifica el valor que devolver cuando no existe ninguna columna
coincidente. Si el valor es No Data, se devuelve el estado digital Sin datos.
RWN=value
Especifica el valor que devolver cuando la columna de resultado es nula. Si
el valor es No Data, se devuelve el estado digital Sin datos.
• Parámetros
Puede introducir los siguientes opciones en una lista separadas por punto y coma. Empiece
cada nombre de parametró con el caracter @ en formato @parameter=value (value se
describe en "Atributo o valor" en Sintaxis de la clausula WHERE). Para obtener mas
infórmación sobre cómó utilizar los parametrós, consulte Parametrós de consultas de tablas
vinculadas.
Ejemplo
En el siguiente ejemplo,
SELECT [Installation Date] FROM location; WHERE RowID =@id; TZ=China Standard
Time; TC=Installation Date
Sintaxis de la cláusula WHERE
La clausula WHERE utiliza la sintaxis de SQL y cumple en general con la sintaxis descrita en la
pagina de MSDN DataColumn.Expression Property (https://msdn.microsoft.com/en-us/
library/system.data.datacolumn.expression(v=vs.110).aspx). Puede escribir la clausula
directamente en el campo Cláusula DONDE completa de la ventana Referencia de datos de
búsqueda de tabla, o permitir que PSE proporcione la sintaxis correcta utilizando las listas
Columna, Operador y Atributo o valor en la sección Donde. La clausula WHERE es opcional para
la regla Table provided time series data.
La sintaxis de la clausula WHERE sigue estas directrices.
Columna
Los nombres de columna que contienen símbólós que no son alfanumericós
deben ir entre corchetes:
[Asset ID] ='%Element%'
238
Guía del usuario PI System Explorer
Configuración de referencias de datos
Operador
• El operador INTERPOLATE esta disponible con la regla Select first
row matching criteria.
• Los operadores de cómparación =, <>, >, >=, <, <=, IN y LIKE son
compatibles con todas las reglas de busqueda.
Puede utilizar los caracteres * y % indistintamente como caracteres
cómódín en una cómparación de LIKE. Se permite un cómódín al principio
y final de un patrón, así como al final de un patrón y al principio de un
patrón, pero nunca en medio de una cadena. Si la cadena de una clausula
LIKE contiene un símbóló * o %, dichos caracteres deben ir entre
corchetes [ ].
Atributo o valor
@attribute
Devuelve el valor del atributo PI AF. El atributo debe ir entre corchetes [ ] si
contiene algun caracter no alfanumericó, incluidos los espacios, o si incluye
una especificación de unidades de medida o Zona horaria. Por ejemplo:
[height] >= @[Level Gauge;UOM=m]
literal
• Las cadenas deben ir entre comillas simples.
• Los valores numericós no van entre comillas y deben ir en un formato
invariable (donde el caracter decimal sea '.').
• La mejor forma de especificar marcas de tiempo es en formato
yyyy.mm.dd hh.mm.ss (0-23 para hh), y rodeadas del caracter #. Por
ejemplo:
#2015.01.30 14:00:00#
substitution
Seleccione o introduzca un parametró de substitución en formato
'%substitution parameter%'. Para obtener mas infórmación sobre los
parametrós de sustitución, consulte Lista de parametrós de sustitución de PI
AF.
Los operadores Like e IN
Los operadores LIKE e IN le permiten especificar una coincidencia no exacta para resultados
de consulta en una clausula WHERE. Utilice el caracter % para especificar cero, uno o varios
caracteres al inicio o fin de cada cadena.
Nota:
Puede utilizar los operadores LIKE e IN como alternativa del operador = cuando los
resultados de consulta no se pueden recuperar de una tabla debido a la presencia de
caracteres de control. Consulte Eliminar caracteres de control de tablas de AF importadas
para obtener mas infórmación sobre la eliminación de caracteres de control desde una
tabla de AF importada.
Ejemplo de consulta con errores
En el siguiente ejemplo, la consulta no devuelve datos porque el valor de busqueda (ValueA)
esta ubicado en una celda que contiene caracteres de control y el operador = especifica una
coincidencia exacta para un valor en la misma celda. La presencia de caracteres de control evita
que la instrucción SELECT devuelva una coincidencia exacta.
SELECT ColumnB FROM Table1 WHERE ColumnA = 'ValueA'
Ejemplo de consulta sin errores
Puede utilizar los operadores LIKE o IN para especificar una coincidencia no exacta desde una
columna que contiene caracteres de control. Considere los ejemplos siguientes para ejecutar
una busqueda correcta para datos en MyTable. Tanto ColumnA como ColumnB contienen
caracteres de control.
Guía del usuario PI System Explorer
239
Configuración de referencias de datos
SELECT ColumnA FROM MyTable WHERE ColumnB LIKE '%ValueA%'
Otra alternativa es utilizar el operador IN para especificar varios valores en una clausula
WHERE.
SELECT ColumnA FROM MyTable WHERE ColumnB IN ('ValueA', 'ValueB', 'ValueC')
Parámetros de consultas de tablas vinculadas
La consulta de una tabla vinculada determina que datos procedentes de un origen externo se
incluiran en la tabla. Puede incluir parametrós en la consulta y, al cónfigurar una referencia de
datos de consulta de tabla que utilice la tabla vinculada, pódra especificar valores de
parametró. Esto le permitira utilizar una unica tabla vinculada para obtener distintos
resultados en cada referencia de datos Table Lookup que la utilice.
El uso de parametrós en una consulta de tabla vinculada es util, por ejemplo, para limitar el
numeró de filas que devuelve una tabla externa muy grande. Puede anadir condiciones y
parametrós para devolver resultados mas concretos, por ejemplo, todas las filas que incluyan
un numeró de ID de dispositivo o fabricante, específicós de cada referencia de datos Table
Lookup.
Al cónfigurar una tabla vinculada en la ventana Vínculo de tabla pódra anadir parametrós de
tabla a su consulta y definir valores predeterminados para ellos. Luego, en la ventana
Referencia de datos Table Lookup cuando defina una referencia de datos con la tabla vinculada,
pódra introducir parametrós de tabla específicós para esa referencia de datos. Tambien puede
introducir valores de parametró mediante prógramación con AF SDK. Los valores de parametró
pueden ser valores específicós o proceder de otros valores de atributos o de variables de
sustitución predefinidas, como %Element%.
Añadir parámetros de tabla a una consulta de tabla vinculada
Cuando defina una tabla ligada en la ventana Vínculo de tabla, pódra anadir parametrós a la
consulta de tabla y establecer valores predeterminados para ellos.
Procedimiento
1. Edite el texto del campo Consulta para incluir el nuevo parametró o parametrós. Los
nombres de parametró deben comenzar por el caracter @.
2. Haga clic dentro de la tabla Parámetros para mostrar los nuevos parametrós de la consulta.
3. Especifique valores predeterminados para cada parametró a fin de determinar los
resultados predeterminados de la consulta y haga clic en Aceptar. Una vez anadidós los
parametrós a la consulta, pódra especificar valores para ellos cuando cónfigure una
referencia de datos de busqueda de tabla que utilice la tabla vinculada.
Ejemplo
Planteese la siguiente consulta para una tabla ligada llamada MyTable. La clausula DONDE
limita la selección de una tabla externa (BigTable) a aquellas filas con un RowID específicó:
SELECT * FROM BigTable WHERE RowID = 101
Reemplace el valor fijó 101 con un parametró de consulta de tabla @id (tenga en cuenta que los
nombres de parametró deben comenzar por el caracter @):
SELECT * FROM BigTable WHERE RowID = @id
Ahora, para cada referencia de datos de busqueda de tabla que use MyTable, usted puede
suministrar diferentes valores de parametrós de tabla para @id a fin de obtener distintos
resultados de la consulta.
240
Guía del usuario PI System Explorer
Configuración de referencias de datos
Por ejemplo, en la ventana Referencia de datos de búsqueda de tabla, escriba @AssetID para el
valor de @id en la lista Parámetros de tabla mientras cónfigura una referencia de datos. De esta
forma, @id adóptara el valor actual del atributo AssetID. La consulta correspondiente sería:
SELECT Result FROM MyTable; @id=@AssetId
Esta consulta devuelve filas cuyo RowID coincide con el valor actual de AssetID.
Referencias de datos de Uri Builder
En versiones anteriores de PI Nótificatións, era posible definir un vínculó web o un vinculo a
una aplicación cliente, como PI WebParts o PI Vision, como contenido dentro de una
nótificación. Sin embargo, al haberse desconectado los vínculós de los elementos y atributos de
PI System Explorer, solo los usuarios que tenían PI Nótificatións instalado pódían encontrar
objetos referenciados en la propia nótificación de correo electrónicó. Ademas, solo era posible
incluir contenido dinamicó como un valor de un parametró.
En cambio, con URI Builder en PI AF 2016, es posible cónfigurar referencias de datos que crean
vínculós dinamicós en event frames, transferencias, elementos o modelos, así como incluir los
mismos valores de atributo y parametrós de substitución que otras referencias de datos, como
String Builder o Fórmula. Uri Builder cumple con las reglas sintacticas estandares (descritas en
el documento Solicitud de comentarios RFC 3986 URI Generic Syntax (https://tools.ietf.org/
html/rfc3986)) y maneja autómaticamente el escape de caracteres que resultan complejos y
engorrosos de introducir manualmente. Tambien es compatible con vínculós web genericós
(que utilizan esquemas http y https), así como vínculós de PI Vision.
Tambien puede utilizar PI Nótificatións 2016 para enviar el vínculó a otros usuarios por correo
electrónicó, un cliente de mensajería instantanea o una aplicación cliente, como PI Vision.
Crear referencias de datos de Uri Builder
Copie un vínculó web existente o un vínculó de PI Vision y cónviertaló en una referencia de
datos de Uri Builder dinamica en la que sustituya la parte de Uri por un valor derivado de un
atributo, una referencia de atributo o un parametró de sustitución. Se asigna el valor de vínculó
web dinamicó o de PI Vision a una plantilla de atributo o un atributo.
Antes de empezar
Cuando se utiliza una referencia de datos de Uri Builder en una plantilla, la substitución de
valores ocurre en tiempo de ejecución.
Procedimiento
1. Abra un navegador web y busque el vínculó web o el vínculó de PI Vision que utiliza como
punto de inicio para crear un valor de vínculó en una plantilla de atributo o un atributo.
2. Seleccione todo el Uri y cópieló.
3. En el panel del navegador de PI System Explorer, seleccione entre las siguientes acciones.
Para crear una referencia de datos de Uri en...
Haga lo siguiente…
Una plantilla
a. Haga clic en Biblioteca.
b. Amplíe Plantillas en el arból del navegador.
c. Elija un tipo de plantilla y seleccione una
plantilla existente o haga clic en Nueva
plantilla.
Guía del usuario PI System Explorer
241
Configuración de referencias de datos
Un elemento
a. Haga clic en Elementos.
b. Seleccione un elemento existente en el arból
del navegador o haga clic en Nuevo elemento.
Un modelo
a. Haga clic en Elementos.
b. Seleccione un modelo existente en el arból del
navegador o haga clic con el bótón secundario
en Nuevo modelo.
Un event frame
a. Haga clic en Event Frames.
b. Expanda una cólección de busqueda para ver
los event frames en el arból del navegador.
c. Seleccione un event frame existente o haga
clic en Nuevo Event Frame.
Una transferencia
a. Haga clic en Event Frames.
b. Expanda una cólección de busqueda para ver
las transferencias en el arból del navegador.
c. Seleccione una transferencia existente o haga
clic en Nueva transferencia.
4. Elija una de las siguientes acciones.
◦ En la pestana Plantillas de atributos, seleccione una plantilla de atributos existente o
haga clic en Nueva plantilla de atributos para crear una nueva plantilla de atributos.
◦ En la pestana Atributos, seleccione un atributo existente o haga clic en Nuevo atributo
para crear un nuevo atributo.
5. En el panel de cónfiguración de atributos, cónfigure la plantilla de atributos o el atributo
necesarios y seleccione Uri Builder en la lista desplegable Referencia de datos.
6. Haga clic en Ajustes.
7. En la ventana Referencia de datos de Uri Builder, haga clic en el campo Pegue un URI desde
un navegador web para usar como plantilla para la configuración. y pegue el Uri que cópió
en el paso 2.
8. Haga clic en Continuar.
El Uri pegado se móstrara en la ventana Referencia de datos de Uri Builder, desglosado en sus
componentes de campo Esquema, Dirección o host, Puerto y Ruta. Si el Uri contiene
consultas y fragmentos, estos tambien se móstraran en los campos Consulta y Fragmento.
9. En la ventana Referencia de datos de Uri Builder, elija una de las siguientes acciones.
242
Guía del usuario PI System Explorer
Configuración de referencias de datos
Para configurar...
Haga lo siguiente…
Un vínculó web dinamicó
Módifique los componentes del Uri pegado segun
proceda.
◦ Puede elegir entre valores de Esquema de
http y https.
◦ Es posible cambiar el valor de Puerto a
cualquier numeró entre el 1 y el 65535. Los
valores predeterminados para esquemas http
y https son 80 y 443, respectivamente.
◦ Para volver dinamicas partes del campo Ruta,
seleccione un segmento. A cóntinuación, haga
clic en
y seleccione una de las opciones
siguientes:
▪ Una lista de otros atributos para el objeto
seleccionado. Tenga en cuenta que los
atributos deben aparecer entre comillas
simples.
▪ Una lista de referencias de atributo.
Tambien puede seleccionar Búsqueda
para introducir los criterios de busqueda
en la ventana Búsqueda de atributos.
▪ Una lista de los parametrós de
substitución mas utilizados. Para obtener
mas infórmación, consulte Lista de
parametrós de sustitución de PI AF.
◦ En la tabla Consulta, puede módificar los
ajustes Clave y Valor segun proceda.
▪ Para anadir una clave, haga clic en
. En
los campos Clave y Valor, escriba un valor
o haga clic en
y seleccione entre las
mismas opciones que las arriba indicadas.
▪ Para eliminar un parametró, seleccione
una clave o un valor y haga clic en
.
Guía del usuario PI System Explorer
243
Configuración de referencias de datos
Un vínculó de PI Vision
a. Haga clic en la ópción PI Vision.
b. En el campo Mostrar, módifique el valor
segun proceda. Tambien puede hacer clic en
y seleccionar una de las opciones
siguientes:
▪ Una lista de otros atributos para el objeto
seleccionado. Tenga en cuenta que los
atributos deben aparecer entre comillas
simples.
▪ Una lista de referencias de atributo.
Tambien puede seleccionar Búsqueda
para introducir los criterios de busqueda
en la ventana Búsqueda de atributos.
▪ Una lista de los parametrós de
substitución mas utilizados. Para obtener
mas infórmación, consulte Lista de
parametrós de sustitución de PI AF.
c. En la tabla Parámetros, módifique los ajustes
Clave y Valor segun proceda.
▪ Para anadir una clave, haga clic en
el campo Clave, haga clic en
. En
,
seleccione un parametró y asigne un valor.
Ademas de escribir un valor, puede
seleccionar entre las mismas opciones que
las indicadas en el paso b anterior.
▪ Para eliminar un parametró, seleccione
.
una clave o un valor y haga clic en
Cuando vincule a una pantalla en un event
frame, Uri Builder anadira autómaticamente
los parametrós Activo, Hora de inicio y Hora
de finalización. Para obtener mas infórmación
sobre otros parametrós, consulte el tema de
PI Vision "Referencia de parametrós de URL"
in Live Library (https://
livelibrary.osisoft.com).
10. Haga clic en Aceptar.
244
Guía del usuario PI System Explorer
Unidades de medida de PI AF
PI AF incluye una gran cantidad de clases de unidades de medidas estandar y factores de
cónversión. Puede ampliar estas clases anadiendó unidades de medida nuevas, así como nuevas
clases de medidas. La implementación de unidades de medida en PI AF se basa en el sistema
internacional de unidades (SI).
Base de datos de unidades de medida
Todas las bases de datos de PI AF utilizan el mismo conjunto de unidades de medida, que se
definen en la base de datos de unidades de medida. Todas las unidades de medida disponen del
conjunto de permisos de lectura, si bien es posible establecer otros permisos para la base de
datos de unidades de medida en conjunto, tal como se describe en Cónfigurar la seguridad para
la base de datos de unidades de medida.
A partir de PI AF 2017 R2, los usuarios con privilegios de administración pueden revisar los
datos de pista de auditóría en la base de datos de UOM si seleccionan Archivo > Eventos de
Pista de Auditoría despues de que hayan hecho clic en Unidad de medición en el navegador.
Para obtener mas infórmación, consulte Seguimiento de los cambios en PI AF con pista de
auditóría.
Clases de unidades de medida y unidades canónicas
En PI AF, cada unidad de medida se basa en una clase UOM. Las clases representan propiedades
mensurables, como la temperatura, la longitud, el tiempo y la masa. Cada clase tiene una
canonical unit. Es la unidad base que PI AF utiliza como base para convertir valores a otras
unidades cuando es necesario. Por ejemplo, la unidad canónica de la clase Length es meter, y
su abreviatura es m.
Conversiones de unidades de medida en aplicaciones cliente
La función de unidades de medida permite realizar conversiones autómaticas de unidades en
aplicaciones cliente. Por ejemplo, supongamos que un atributo de PI AF tiene meter como
unidades de medida. Un usuario de PI ProcessBook que este mirando ese valor de atributo
puede optar por ver el valor en otra unidad, por ejemplo, en pies. foot. PI AF convierte
autómaticamente los datos de metros a pies.
Abreviaturas de unidades de medida
Antes de PI AF 2015 R2, todas las abreviaturas de UOM no distinguían mayusculas y
minusculas. En PI AF 2015 R2 (v2.7.5), se agregó una ópción nueva que permitió a los usuarios
cónfigurar el servidor PI AF para que admita abreviaturas de UOM con distinción de
mayusculas y minusculas. Las abreviaturas de UOM con distinción de mayusculas y minusculas
le permiten definir abreviaturas que se diferencian solo por la letra, por ejemplo, MV
(megavoltio) y mV (milivoltio) o s (segundo) y S (Siemens).
Nota:
A partir de PI AF 2017 R2, la distinción de mayusculas y minusculas de la UOM esta
habilitada de manera predeterminada en una nueva instalación, pero durante una
actualización la cónfiguración con distinción de mayusculas y minusculas actual sigue sin
módificarse. Cuando esta habilitada la distinción de mayusculas y minusculas, solo PI AF
2015 R2 o los clientes de versiones posteriores pueden conectarse a ese servidor.
Unidades de medida integrales de tiempo
A partir de PI AF 2017, puede ver las unidades de medida asociadas con un total ponderado en
el tiempo (Automático y Por día) de las unidades de medida de velocidad. Las unidades de
medida de velocidad son de clases que contienen tiempo en el denominador de sus Unidades
Guía del usuario PI System Explorer
245
Unidades de medida de PI AF
de medida de base (por ejemplo, el caudal masivo contiene Time-1, la presión contiene
Time-2). Cada propiedad total ponderada en el tiempo muestra el nombre de la unidad de
medida que sera el resultado de una llamada de datos total de resumen (Por día) o
TotalWithUOM (Automático).
Grupos de UOM
A partir de PI AF 2017 R2, los grupos de UOM, como el Sistema Métrico y el Sistema de
unidades de medición tradicional de EE. UU. estan disponibles para que pueda asignar las UOM
de una clase de UOM a la cónfiguración que sea mas adecuada para su ubicación. Si selecciona
la ópción Mostrar grupo de UOM en Herramientas > Opciones, puede ver los valores de
atributo en la unidad de medición preferida del valor seleccionado en el campo UOM
predeterminada de la plantilla de atributo. Para obtener mas infórmación sobre el grupo de
UOM del Sistema de unidades de medición tradicional de EE. UU., consulte el artículó de
Wikipedia Unidades de medición tradicionales de los Estados Unidos (https://
en.wikipedia.org/wiki/United_States_customary_units).
Video
Para obtener infórmación sobre cómó editar unidades de medida, mire este video:
https://www.youtube.com/watch?v=YTG3Dk_SxNM&rel=0
En esta sección
• Distinción de mayusculas en abreviaturas de unidades de medida
• Clases base y clases derivadas
• Crear clases de UOM
• Crear unidades de medida
• Calcular valores de cónversión para una unidad de medida
• Grupos de UOM
• Origen de las UOM
Distinción de mayúsculas en abreviaturas de unidades de
medida
Un Cliente de PI AF mas antiguo que PI AF 2015 R2 (v2.7.5) no puede conectarse a un PI
System que tenga activado el uso de abreviaturas de unidades de medida con distinción de
mayusculas y minusculas. El motivo es que existe la posibilidad de que las abreviaturas de
unidades de medida se malinterpreten: suelen almacenarse en referencias de datos, reglas de
analisis y archivos de aplicaciones cliente, como hojas de calculó y pantallas de PI ProcessBook.
Nota:
Debe actualizar un Cliente de PI AF a PI AF 2015 R2 o posterior para poder utilizar
unidades de medida con distinción de mayusculas y minusculas.
Referencias a abreviaturas de unidades de medida
Cuando esta activada la función de distinción de mayusculas y minusculas de unidades de
medida en PI AF 2015 R2 o posterior, si hay referencias almacenadas a una abreviatura de
unidades de medida sera necesario utilizar la caja tipógrafica correcta. Por ejemplo:
246
Guía del usuario PI System Explorer
Unidades de medida de PI AF
• Las referencias de datos cónfiguradas con unidades de medida (como fórmulas de referencia
de datos) deben utilizar la abreviatura correcta pues, de lo contrario, fallaría la busqueda de
unidades de medida.
• Las reglas de analisis, como la función Convert fallan si se cónfiguran con una caja
tipógrafica incorrecta: Convert('x', 'Kg') en lugar de Convert('x', 'kg').
• Las aplicaciones o referencias de datos que acceden mediante prógramación a la base de
datos de unidades de medida deben utilizar la caja tipógrafica correcta.
Nota:
No es posible utilizar la ópción de distinción de mayusculas y minusculas en PI System
para recibir alertas de usos cónfiguradós que puedan contener una caja tipógrafica
incorrecta.
Nombres de unidades de medida
A diferencia de las abreviaturas, los nombres de unidades de medida no funcionan con
distinción de mayusculas y minusculas en PI AF 2015 R2 o posterior cuando esta activada la
función de unidades de medida sin distinción de mayusculas y minusculas. Sin embargo, al
crear una abreviatura de unidades de medida, esta no puede coincidir con el nombre de otra
unidades de medida, incluso si difiere en el uso de la caja tipógrafica.
Por ejemplo, es validó lo siguiente:
Nombre
Abreviatura
nombre_UOM1
UOM1
UOM2
uom1
UOM3
Uom1
Lo siguiente no es validó y genera este mensaje de error: 'uom1' already exists in Unit
of Measure 'UOM1' in Unit-of-Measure Database.
Nombre
Abreviatura
UOM1
uom
UOM2
uom1
Configuración de abreviaturas de unidades de medida con distinción de
mayúsculas y minúsculas
A pesar de que las abreviaturas de UOM con distinción de mayusculas y minusculas estan
habilitadas de manera predeterminada en las instalaciones de PI AF 2017 R2 nuevas, en el caso
de las versiones de servidor PI AF anteriores puede cambiar el valor de las UOM con distinción
de mayusculas y minusculas desde el estado de deshabilitado con la PI AFUtilidad de línea de
comandos de diagnósticó (afdiag).
Para obtener mas infórmación sobre la utilidad afdiag, consulte Utilidad de diagnósticó de PI
AF.
Activar abreviaturas de unidades de medida con distinción de mayúsculas y minúsculas
Para activar abreviaturas de unidades de medida con distinción de mayusculas y minusculas,
introduzca la línea de comandos afdiag /ucs.
Una nueva unidad de medida, millivolt con una abreviatura de unidades de medida de mV, se
anade a la base de datos de unidades de medida siempre y cuando no haya cónflictó con otras
unidades de medida existentes.
Guía del usuario PI System Explorer
247
Unidades de medida de PI AF
Desactivar abreviaturas de unidades de medida con distinción de mayúsculas y
minúsculas
Puede reiniciar el servidor de PI AF para que las abreviaturas de unidades de medida no hagan
distinción de mayusculas y minusculas con la misma utilidad de afdiag.
Para desactivar abreviaturas de unidades de medida con distinción de mayusculas y
minusculas, introduzca la línea de comandos afdiag /ucs-.
Si alguna abreviatura de unidades de medida existente solo difiere en la caja tipógrafica, la
utilidad no permitira que la función se desactive y móstrara un alista de abreviaturas en
cónflictó. Como mínimó, es necesario eliminar la unidad de medida milivoltios creada al activar
las abreviaturas de unidades de medida con distinción de mayusculas y minusculas, pues
millivolt (mV) entra en cónflictó con megavolt (MV).
Clases base y clases derivadas
PI AF tiene un conjunto pequenó predefinidó de clases base y un conjunto mas amplio de clases
derivadas de las clases base que se denomina clases derivadas. Las clases derivadas son clases
simples que se pueden expresar como las clases base de las unidades de medida. Por ejemplo,
la clase Area y la clase Volume se derivan ambas de la clase Length. Puede definir todas las
unidades de medida en terminós de un grupo pequenó de clases base de unidades de medida.
PI AF utiliza la unidad canónica de la clase base a fin de determinar las unidades canónicas de
todas las clases derivadas de esa clase base. Las unidades canónicas de una clase base o una
clase derivada no se pueden módificar. Por ejemplo, ya que la clase Area se basa en la clase
Length, la unidad canónica del Area es el metro cuadrado (m²).
PI AF incluye numerosas unidades de medida estandar, clases de unidades de medida y factores
de cónversión, pero siempre se puede anadir nuevos. Por lo general, no resulta necesario crear
clases base, aunque es posible que ocasionalmente desee anadir una para las mediciones que
no sean físicas. Por ejemplo, puede anadir una clase denominada Bytes que incluya bytes, KB,
MB, GB, etc. como unidades de medida.
En esta sección
• Clases base de unidades de medida
• Clases derivadas de unidades de medida comunes
Clases base de unidades de medida
Las siguientes clases basadas en unidades de medida predefinidas estan disponibles en PI AF.
248
Clase
Unidad canónica
Corriente electrica
Amperio (A)
Longitud
metro (m)
Masa
kilogramo (kg)
Moles (cantidad de sustancia)
mol (mol)
Anguló plano
radian (rad)
Cantidad
recuento
Relación
porcentaje (%)
Temperatura
kelvin (K)
Hora
second (segundo) (s)
Guía del usuario PI System Explorer
Unidades de medida de PI AF
Clases derivadas de unidades de medida comunes
Las siguientes clases de derivadas de unidades de medida predefinidas estan disponibles en PI
AF.
Clase
Basándose en…
Unidad canónica
Velocidad angular
Anguló plano * Tiempo-1
radian por segundo (rad/s)
Area
Longitud 2
metro cuadrado (m2).
Densidad
Masa * Longitud-3
kilogramo por metro cubicó (kg/m3).
Carga electrica
Corriente electrica * Hora
culombio (C)
potencial electricó
Corriente electrica-1 * Longitud2 *
Masa * Tiempo-3
voltio (V)
Energía
Longitud2 * Masa * Tiempo-2
julio (J)
Fuerza
Masa * Longitud * Tiempo-2
newton (N)
Frecuencia
Hora-1
hertzio (Hz)
Indice de caudal
masicó
Masa * Tiempo-1
kilogramo por segundo (kg/s)
Potencia
Masa * Longitud2 * Tiempo-3
vatio (W)
Presión
Masa * Longitud-1 * Tiempo-2
pascal (Pa)
Energía específica,
entalpía específica
Longitud2 * Tiempo-2
julio por kilogramo (J/kg)
Velocidad
Longitud * Tiempo-1
metro por segundo (m/s)
Volumen
Longitud3
metro cubicó (m3).
Indice de caudal
vólumetricó
Longitud3 * Tiempo-1
metro por segundo (m3/s)
Crear clases de UOM
Cree clases de UOM cuando necesite realizar adiciones a las clases predefinidas en la base de
datos de unidades de medida.
Procedimiento
1. En el navegador, haga clic en Unidad de medida.
2. Elija una de las siguientes acciones.
◦ En la barra de herramientas, haga clic en el icono Nueva clase.
◦ Haga clic con el bótón secundario en el navegador Unidad de medida y seleccione Clase de
unidad de medida nueva.
3. En la ventana Propiedades de clase de unidad de medida, complete las propiedades en la
pestana General.
a. En el campo Nombre, introduzca un nombre para la clase. Consulte Caracteres validós en
nombres de objetos de PI AF, si es necesario.
b. Opcional. En el campo Descripción, facilite una descripción de la clase de UOM.
c. En el campo UOM canónica, escriba el nombre de la UOM canónica para esta clase. Si la
UOM no existe, PI AF la crea al crear la nueva clase.
Guía del usuario PI System Explorer
249
Unidades de medida de PI AF
d. En el campo Abreviatura de UOM canónica, introduzca una abreviatura exclusiva.
e. En el campo Unidades de medida base, introduzca un calculó de la unidad de medida.
Elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Anadir un calculó de clase base
a. Haga clic en
.
b. En la ventana Añadir clase base UOM,
seleccione una clase base de la lista Clases
base UOM.
c. En el campo Potencia base, escriba el valor de
exponente o haga clic en alguna de las teclas
de dirección hasta que se muestre el
exponente que desee.
d. Haga clic en Aceptar.
e. Repita estos pasos segun proceda para crear
un calculó de multiplicación (potencia de
base positiva) o de división (potencia de base
negativa).
Quitar un calculó de clase base
a. Seleccione una entrada de calculó de clase
base.
b. Haga clic en
.
c. En la ventana de cónfirmación Eliminar, haga
clic en Sí.
Nota:
Si va a definir una clase base, deje en blanco el campo Unidades de medida base.
4. Opcional. Puede anadir nuevas unidades de medida a la clase que este definiendó.
a. Haga clic en la pestana Unidades de medida.
b. Haga clic con el bótón secundario en la lista y seleccione Nueva unidad de medida.
c. En la ventana Propiedades de unidad de medida, defina la nueva unidad de medida. Para
obtener mas infórmación, consulte Crear unidades de medida.
5. Haga clic en Aceptar.
Crear unidades de medida
Puede crear unidades de medida para una clase de unidades de medida en la base de datos de
unidades de medida.
Procedimiento
1. En el navegador, haga clic en Unidad de medida.
2. En el navegador Unidad de medida, seleccione la clase que desee anadir a una nueva unidad
de medida.
3. Elija una de las siguientes acciones.
◦ En la barra de herramientas, haga clic en Nueva UOM.
◦ Haga clic con el bótón secundario en la clase del navegador y seleccione Nueva unidad de
medida.
◦ Haga clic con el bótón secundario en el visor de UOM y seleccione Nueva unidad de
medida.
250
Guía del usuario PI System Explorer
Unidades de medida de PI AF
4. En la ventana Propiedades de unidades de medida, introduzca un nombre exclusivo para la
unidad de medida en el campo Nombre.
Nota:
El nombre no puede ser el mismo que lo anteriormente definidó como abreviatura de
unidades de medida o nombre de unidades de medida.
5. En el campo Abreviatura, introduzca una abreviatura exclusiva para la unidad de medida.
Si se ha activado la distinción de mayusculas de unidades de medida, puede utilizar la
misma abreviatura que la abreviatura de unidades de medida definida anteriormente, a
cóndición de que la caja tipógrafica sea distinta. Por ejemplo, puede utilizar FR, fr, Fr y fR
para cuatro abreviaturas de unidades de medida distintas.
Nota:
La abreviatura no puede ser la misma que lo anteriormente definidó como nombre de
unidades de medida, independientemente de la caja tipógrafica.
6. Opcional. En el campo Descripción, introduzca una descripción de la unidad de medida.
7. En el campo Referencia UOM, seleccione una clase de unidad de referencia que se utilizara
como base para convertir la nueva unidad. El valor predeterminado es el mismo que el valor
UOM canónica de solo lectura.
8. Seleccione uno de los siguientes metódós de cónversión.
PRECAUCIÓN:
Las conversiones que se basan en Fórmulas presentan algunas limitaciones, ademas de
afectar al rendimiento. Solo debera seleccionar Fórmula cuando las conversiones
Simples resulten inadecuadas.
Guía del usuario PI System Explorer
251
Unidades de medida de PI AF
Opción
Descripción
Simple
Convierte una UOM basandóse en un factor de
escala y en valores de desplazamiento base
introducidos en los siguientes campos.
◦ En el campo Factor, introduzca el factor de
cónversión de la unidades de medida de
referencia a la nueva unidades de medida. Por
ejemplo, los grados ºC tienen un factor 1
respecto a los grados Kelvin.
◦ En el campo Desplazamiento, introduzca un
desplazamiento de cónversión del valor de
unidades de medida de referencia. Por
ejemplo, los grados ºC tienen un
desplazamiento de 273,15 respecto a los
grados Kelvin.
Nota:
A pesar de que PI AF admite totalizaciones
ponderadas en el tiempo que pueden
asignar autómaticamente las unidades de
medición adecuadas, es fundamental que el
factor de cónversión de la UOM este
definidó con el mayor nivel de precisión
posible para que se active esta función. Por
ejemplo, si tuviera que definir una UOM de
caudal, como galones estadounidenses por
día, con un factor de cónversión de
4,38126E-08, las conversiones autómaticas
estarían deshabilitadas para esta UOM,
mientras que si el factor de cónversión
fuera 4,381263638889E-08, las
conversiones autómaticas estarían activas.
Fórmula
Convierte una unidad de medida basandóse en
un calculó de cónversión complejo. Para obtener
mas infórmación, consulte Calculó de cónversión
de unidades de medida con una fórmula.
9. Opcional. Para establecer un nombre de UOM alternativo de manera que los usuarios
puedan ver los valores de atributo en su UOM preferida, en la lista Asignaciones, seleccione
un nombre de UOM de la lista Asignaciones para cada grupo de UOM.
Nota:
Si bien se proporcionan asignaciones predeterminadas para el Sistema Métrico y el
Sistema de unidades de medición tradicionales de EE. UU., puede módificarlós segun
sea necesario. Para módificar varias asignaciones de UOM en grupos de UOM, OSIsoft
le recomienda que use PI Builder.
10. Haga clic en Aceptar para guardar la nueva unidad de medida.
Cálculo de conversión de unidades de medida con una fórmula
En general, OSIsoft recomienda especificar calculós de cónversión de unidades de medida con
un factor de escala y un desplazamiento base del valor de unidades de medida de referencia.
PRECAUCIÓN:
Las conversiones que se basan en Fórmulas presentan algunas limitaciones, ademas de
afectar al rendimiento. Solo debera seleccionar Fórmula cuando las conversiones Simples
resulten inadecuadas.
252
Guía del usuario PI System Explorer
Unidades de medida de PI AF
Límites de cálculo de conversión
Existen las siguientes limitaciones con los calculós de cónversión de unidades de medida.
Tipo de conversión
Limitaciones
cónversión
Ninguno.
Factor con desplazamiento
Para los calculós de cónversión delta, es necesario definir una
unidades de medida independiente. Consulte la clase de unidades de
medida Temperatura (Delta) para conocer ejemplos.
Fórmula
• Los calculós delta no son unidades de medida asignadas.
• Los calculós de resumen en un intervalo de datos no son
unidades de medida asignadas. Esto afecta a las funciones de
expresiones de analisis, como Maximó, Mínimó, Desviación
estandar de póblación, Intervalo, Desviación estandar y Total.
Tambien afecta a las llamadas de datos de resumen mediante
prógramación frente a referencias de datos de PI point con
unidades de medida asignadas.
• Las busquedas de valores de atributos excluyen atributos cuyo
valor se mide en unidades de medida de fórmulas.
Evaluación de fórmulas de unidades de medida
PI AF utiliza C# para evaluar fórmulas de unidades de medida. Siga estas indicaciones:
• Escriba todas las unidades de medida en los terminós de la abreviatura de la unidad de
medida. Si una abreviatura no es un nombre de variable C# validó, incluyala entre corchetes.
• Respete las reglas de evaluación de C#.
• Opcionalmente, puede invocar metódós estaticós .NET estandares, como Math.Log10(),
para realizar el calculó. Se vera limitado a lo disponible en el ensamblaje del sistema (clase
Matematicas .NET Framework (https://msdn.microsoft.com/en-us/library/
System.Math(v=vs.110).aspx)).
Ejemplo de método de conversión con fórmula
Como ejemplo, watts (W) es la unidad de medida canónica de la clase Power. Para crear una
unidades de medida de Decibel-milliwatts (dBm) en la clase Power, puede introducir la
siguiente fórmula:
W = Math.Pow(10,(dBm - 30)/10)
dBm = 10 * Math.Log10( W ) + 30
Calcular valores de conversión para una unidad de medida
Utilice la unidad de medida Calculador de conversión para convertir una determinada cantidad
de unidades de medida en un valor equivalente para otros miembros de su clase.
Procedimiento
1. En el navegador, haga clic en Unidad de medida.
2. En el navegador Unidad de medida, seleccione una clase de unidad de medida.
3. En el campo Cantidad del panel de Calculador de conversión, introduzca la cantidad que
desea convertir.
4. Opcional. En el campo UOM, cambie la unidad de medida del valor predeterminado a otra
unidad de medida en la clase.
Guía del usuario PI System Explorer
253
Unidades de medida de PI AF
Se muestran los valores convertidos para cada unidad de medida en la clase.
Grupos de UOM
A partir de PI AF 2017 R2, las unidades de medición que estan incluidas como parte de PI AF se
asignan a los grupos de UOM, como Sistema Métrico y Sistema de unidades de medición
tradicionales de EE. UU. Una vez que haya seleccionado que grupo de UOM prefiere para usar
en su lugar, puede mostrar todos los valores de atributo con las unidades de medición
asignadas a ese grupo de UOM, en lugar de las UOM predeterminadas que estan definidas en las
plantillas de atributo.
Puede seleccionar que grupo de UOM prefiere en Herramientas > Opciones. Cuando no se
selecciona un grupo de UOM preferido, todos los valores de atributo se muestran con la UOM
predeterminada que esta definida en las plantillas de atributo, a menos que tambien este
seleccionada la ópción Usar unidad de medición de origen para mostrar atributo. Para obtener
mas infórmación, consulte Opciones de persónalización de PI System Explorer.
Asignaciones de muestra para una clase de UOM
A modo de ejemplo, la siguiente tabla ilustra las asignaciones para la clase de UOM de longitud.
UOM
Grupo de UOM del Sistema
Métrico
centímetró
Grupo de UOM del Sistema de
unidades de medición
tradicionales de EE. UU.
pulgada
pie
metro
pulgada
centímetró
milla nautica internacional
kilómetró
Milla
metro
yarda
milímetró
16 de pulgada
16 de pulgada
milímetró
yarda
metro
Si no se define una asignación, como la milla nautica internacional, no se asigna una UOM y se
usa la cónfiguración de UOM original.
Base de datos de unidades de medida
Los grupos de UOM estan disponibles para todos los usuarios y se almacenan en el servidor PI
AF como parte de la base de datos de UOM. Cada selección de grupo de UOM del usuario en
Herramientas > Opciones tambien se guarda en la base de datos de UOM.
Los usuarios con permiso para módificar la base de datos de UOM pueden módificar las
asignaciones y los grupos de UOM, que incluye aquellos enviados de manera predeterminada.
Para obtener mas infórmación, consulte Cónfigurar la seguridad para la base de datos de
unidades de medida.
Importar o exportar base de datos de UOM
Puede importar y exportar grupos de UOM, y tambien sus asignaciones, con Archivo > Exportar
a archivo y Archivo > Importar desde archivo. Cuando exporte, asegurese de seleccionar la
ópción Incluir todos los objetos de referencia.
254
Guía del usuario PI System Explorer
Unidades de medida de PI AF
Administrar grupos de UOM
Ademas de los grupos de UOM del Sistema Métrico y del Sistema de unidades de medición
tradicionales de EE. UU. que estan instalados en PI System Explorer, puede crear otros grupos
de UOM a los que puede asignarle unidades de medición. Ademas, puede módificar y eliminar
nombres y descripciones de grupo.
Antes de empezar
Para crear, módificar y eliminar grupos de UOM, debe tener permiso de escritura para la base
de datos de UOM.
Procedimiento
1. Para administrar grupos de UOM, haga clic en Unidad de medición en el navegador.
2. Elija una de las siguientes acciones.
◦ En la barra de herramientas, haga clic en el icono Grupos de UOM.
◦ Haga clic en Archivo > Grupos de UOM.
3. Elija una de las siguientes acciones.
Para...
Haga esto...
Crear un grupo nuevo
a. Haga clic en Nuevo grupo de UOM.
b. En la ventana Propiedades de unidades de
medición, introduzca un nombre exclusivo
para el grupo de UOM en el campo Nombre.
c. Opcional. En el campo Descripción,
introduzca una descripción para el grupo de
UOM.
d. Haga clic en Aceptar. El grupo nuevo se
agrega a la lista en la ventana Grupos de UOM.
Módificar un grupo
a. Seleccione el grupo que desea módificar y
haga clic en Propiedades.
b. En la ventana Propiedades de unidad de
medición, realice los cambios, segun sea
necesario, en el nombre o en la descripción.
c. Haga clic en Aceptar.
Eliminar un grupo
a. Seleccione el grupo que desea eliminar y haga
clic en Eliminar.
b. En la ventana de cónfirmación Eliminar, haga
clic en Sí.
Nota:
Si el grupo de UOM eliminado se selecciónó
anteriormente en Herramientas > Opciones
en la pestana General, el valor Mostrar
grupo de UOM se restablece a <None>. Los
atributos se restablecen a la UOM
predeterminada definida en la plantilla de
elemento asociada.
4. Revise los cambios realizados en la base de datos de UOM.
Guía del usuario PI System Explorer
255
Unidades de medida de PI AF
Origen de las UOM
A partir de PI AF 2017 R2, puede verificar el origen de una definición de UOM en la base de
datos de UOM. El campo Origen esta incluido en la ventana Propiedades de la unidad de
medición, así como el visor de UOM. Tambien esta admitido en PI Builder.
Los valores posibles que se muestran en la columna Origen son:
Origen
Descripción
Unknown
Se desconoce el origen de cómó se definió la UOM.
System Defined
La UOM esta definida por el sistema y no se módificó.
Nota:
Si solo se módifica una asignación de UOM, el Origen se mantiene
cónfiguradó en System Defined.
System Modified
La UOM estaba definida por el sistema, pero se módificarón los campos
Nombre o Descripción.
System Replaced
La UOM conserva su abreviatura original definida por el sistema y los valores
de UOM canónicós, pero se módificarón otros campos, ademas de Nombre y
Descripción.
User Defined
La UOM fue creada por el usuario.
Si se módifica una UOM que genera que el Origen se establezca en System Modified o
System Replaced, pero mas tarde se restablece su definición original, el Origen tambien
vuelve a System Defined.
256
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
PI AF 2015 (versión 2.7) y versiones posteriores utilizan un modelo de seguridad similar al que
utiliza PI Data Archive. Este modelo depende de la seguridad integrada de Windows para la
autenticación, pero proporciona su autórización propia para objetos de PI AF mediante
identidades y asignaciones de PI AF.
Nota:
La infórmación de cónfiguración de seguridad descrita en esa sección asume que existe
un servidor PI AF 2015 y un cliente PI AF 2015.
El modelo de seguridad de PI AF permite a los administradores cónfigurar acceso para
identidades de PI AF en todos los niveles de la jerarquía de PI AF. PI AF utiliza la seguridad de
Windows integrada para otorgar o denegar conexiones al servidor de PI AF para ver o editar
bases de datos y cambiar colecciones.
Para obtener infórmación detallada sobre cómó se implementa la seguridad en PI Data Archive,
consulte PI Data Archive Security Configuration Guide o vea el tema "Intróducción a la seguridad
del Archivo de datos de PI" in Live Library (https://livelibrary.osisoft.com) de Cónfiguración de
seguridad.
Video
Para obtener infórmación sobre cómó crear, asignar y otorgar permisos a identidades de PI AF,
mire este video:
https://www.youtube.com/watch?v=bWqHvoLuXzs&rel=0
En esta sección
• Identidades y asignaciones de PI AF
• Identidades de PI AF incorporadas
• Jerarquía de seguridad
• Herencia de seguridad de los objetos de PI AF
• Derechos de acceso de PI AF
• Opción para rechazar permisos
• Ventana de cónfiguración de seguridad
• Seguridad del servidor de PI AF
• Seguridad de bases de datos de PI AF
• Seguridad de colecciones en PI AF
• Seguridad de objetos de PI AF
• Cónfigurar la seguridad para la base de datos de unidades de medida
• Diferencias del modelo de seguridad de PI Data Archive
Identidades y asignaciones de PI AF
Una identidad de PI AF representa un conjunto de permisos de acceso en el servidor de PI AF.
Cada asignación de PI AF refiere a un usuario o grupo de Windows a una identidad de PI AF. A
partir del Servidor PI AF 2015 (v2.7), no puede otorgarle acceso directo a un usuario o grupo
de Windows a un recurso del servidor de PI AF (por ejemplo, a objetos o una cólección de
Guía del usuario PI System Explorer
257
Seguridad de objetos en PI AF
elementos). En su lugar, puede crear una identidad de PI AF que tenga acceso y luego crear una
asignación de PI AF entre el usuario o grupo de Windows y dicha identidad de PI AF.
Los miembros de los grupos de Windows asignados a una identidad de PI AF reciben
autómaticamente los permisos de acceso para dicha identidad de PI AF. Por ejemplo, en la
ilustración a cóntinuación, la identidad de PI AF de nombre Engineers tiene acceso de
lectura/escritura a la cólección Elementos. Debido a que el grupo de Active Directory (AD)
Engineering Team esta asignado a Engineers, todos los miembros del grupo AD tienen
permiso de escritura/lectura para la cólección Elementos.
Asignación del grupo AD a una identidad de PI AF
Varias identidades
Un usuario de Windows puede estar asignado a varias identidades de PI AF, por lo general, a
traves de las asignaciones de los varios grupos de Windows de los que es miembro. Se le
otorgan permisos a un usuario en base a todas las identidades de PI AF a las que esta asignado.
Los permisos disponibles se determinan al sumar el conjunto de todos los permisos de la
identidad y al restar el conjunto de todos los permisos denegados. Por ejemplo, en la
ilustración a cóntinuación, el usuario de Windows llamado Bob pertenece a ambos grupos AD.
Por lo tanto, Bob recibe los permisos cónfiguradós para PI AF IDENTITY1 y PI AF
IDENTITY2.
258
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Usuarios de Windows con permisos de acceso acumulados
Ademas, el usuario debe contar con permiso de lectura en una base de datos de PI AF para
poder leer cualquier objeto que se encuentre en su interior. De la misma manera, el usuario
debe contar con permiso de escritura en una base de datos de PI AF para poder escribir en
cualquier objeto que se encuentre en su interior.
Para obtener mas infórmación sobre cómó trabajar con identidades y asignaciones, consulte
Administrar identidades en PI AF y Administrar asignaciones en PI AF.
Identidades de PI AF incorporadas
PI AF incluye las siguientes identidades de PI AF incorporadas:
Identidad de PI AF
Descripción
Administrators
De manera predeterminada, esta identidad tiene todos los permisos de
acceso a cada cólección y objeto en el servidor de PI AF, incluidas todas las
bases de datos. No se puede módificar ni eliminar. Las asignaciones, sin
embargo, se pueden anadir y eliminar, y en caso de necesidad a esta
identidad se le pueden negar los permisos de acceso a los objetos.
OSIsoft recomienda que el acceso a esta identidad se limite a solo unos
pocos usuarios.
Asset Analytics
(Parte de la instalación de PI Analysis Service). Esta identidad tiene el
permiso de acceso necesario para trabajar con analisis. De forma
predeterminada, la cuenta utilizada para ejecutar PI Analysis Service se
asigna a esta identidad durante la instalación. Las asignaciones a esta
cuenta se pueden agregar o eliminar.
Asset Analytics
Recalculation
(Parte de la instalación de PI Analysis Service). Esta identidad tiene
permiso de ejecución, lo que permite a los usuarios asignados a esta
rellenar y recalcular los analisis.1
Guía del usuario PI System Explorer
259
Seguridad de objetos en PI AF
Identidad de PI AF
Descripción
Engineers
Esta identidad tiene los mismos privilegios que Administrators, con la
excepción del permiso de administrador (a). A esta identidad tampoco se le
permite eliminar bases de datos de PI AF.
OSIsoft recomienda que esta identidad se limite a aquellos usuarios que
esten definiendó la base de datos de activos. Se deben crear otras
identidades para reducir el alcance del acceso dentro de PI AF.
Notifications
(Parte de la instalación de PI Nótificatións). Esta identidad tiene el permiso
de acceso necesario para trabajar con reglas de nótificación. De forma
predeterminada, la cuenta utilizada para ejecutar PI Nótificatións se asigna
a esta identidad durante la instalación. Las asignaciones a esta cuenta se
pueden agregar o eliminar.
Owner
Esta identidad de solo lectura puede agregarse explícitamente a la
cónfiguración de seguridad de objetos PI AF específicós para permitir a los
usuarios administradores cónfigurar privilegios para el propietario de un
objeto. Se aplican las siguientes restricciones:
• No puede agregar asignaciones a esta identidad.
• No puede módificar, deshabilitar ni eliminar esta identidad.
• A partir de PI AF 2018 SP2, esta identidad ya no tiene autómaticamente
el permiso Read and ReadData. El permiso Read and ReadData se debe
establecer en otra de las identidades asignadas al usuario.
Esta identidad ha leídó los permisos de acceso a cada cólección y objeto en
el servidor de PI AF. No se puede módificar ni eliminar. Las asignaciones,
sin embargo, se pueden anadir y eliminar.
World
De manera predeterminada, esta identidad se asigna al grupo de usuarios
Everyone de Windows.
1
Si instala PI AF 2017 (versión 2.9) o una versión posterior por primera vez, es necesario anadir usuarios a la identidad de
Asset Analytics Recalculation para poder rellenar o recalcular. Si realizó la actualización de una versión anterior a PI AF
2017 (versión 2.9), todos los usuarios se asignaran autómaticamente a la identidad de Asset Analytics Recalculation. Se
recomienda que, al momento de la actualización, se elimine esta asignación autómatica para todos los usuarios y que se
asignen explícitamente aquellos usuarios que requieran permisos de rellenado o recalculó.
Jerarquía de seguridad
PI AF utiliza la seguridad integrada de Windows para autenticar usuarios y establecer sus
identidades de PI AF a traves de asignaciones. PI AF utiliza las identidades de PI AF para los
permisos de control, lectura, escritura, de eliminación y otros en componentes de PI AF que se
pueden observar en la ilustración a cóntinuación. Cada objeto de PI AF asegurable (elemento,
Event Frame, nótificación, etc.) en toda la jerarquía tiene un descriptor de seguridad asociado
que contiene la infórmación de permisos de acceso de dicho objeto.
Todos los objetos de PI AF del mismo tipo forman parte de una cólección. Por ejemplo, todo
elemento de PI AF en una base de datos forma parte de la cólección Elementos en dicha base de
datos. Cada cólección tiene un descriptor de seguridad asociado que contiene la infórmación de
permisos de acceso. Los descriptores de seguridad de algunas colecciones estan cónfiguradós
para un servidor de PI AF completo (como las Identidades y Asignaciones), mientras que otros
(como Analisis, Elementos y Event Frames) pueden cónfigurarse para una base de datos
específica.
260
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
La jerarquía de PI AF de colecciones asegurables
Para obtener mas infórmación sobre la seguridad de colecciones, consulte Seguridad de
colecciones en PI AF.
Herencia de seguridad de los objetos de PI AF
La siguiente tabla proporciona detalles sobre la seguridad que se requiere para crear objetos de
PI AF específicós.
Objeto
Herencia de seguridad
Elemento
Un elemento secundario hereda la seguridad del elemento principal si se agrega a
la referencia principal-secundario (fuerte) o a la referencia de cómpósición. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de
elementos.
Los derechos de seguridad de un elemento creado a nivel de la base de datos
derivan de la cólección de elementos relacionada con una base de datos de PI AF.
Para obtener mas infórmación, consulte Seguridad de colecciones en PI AF.
Guía del usuario PI System Explorer
261
Seguridad de objetos en PI AF
Objeto
Herencia de seguridad
Event frame
Un event frame secundario hereda la seguridad del event frame principal si se
agrega a la referencia principal-secundario (fuerte). Si un event frame no posee
una referencia principal-secundario, los derechos de seguridad derivan de la
plantilla de event frame si esta se creó a partir de una plantilla. Si no se creó a
partir de una plantilla, los derechos de seguridad derivan de la cólección de event
frames relacionados con una base de datos de PI AF.
Nota:
Para permitir a los usuarios hacer cambios a event frames basados en una
plantilla, pero evitar que módifiquen la plantilla de origen, cónfigure
derechos de seguridad en la plantilla de event frame estableciendo los
siguientes permisos de acceso para las identidades de PI AF asociadas:
• Para evitar que los usuarios accedan o módifiquen una plantilla de event
frame, desactive la casilla Permitir correspondiente al permiso de Write
en la ventana Configuración de seguridad. Consulte Cónfigurar la
seguridad para objetos para aprender cómó establecer permisos de
acceso para identidades de PI AF.
• Seleccione el permiso de Write Data para permitir que los usuarios
realicen cambios a los event frames que estan basados en la plantilla.
• Seleccione el permiso de Read Data para brindar a los usuarios la
capacidad de ver y leer el objeto de event frame. Otorgar el permiso de
Read Data sobre un objeto tambien otorga el permiso de Read.
Consulte Derechos de acceso de PI AF para obtener mas infórmación sobre
los permisos de acceso.
Transferencia
Si se crea una transferencia a partir de una plantilla, los derechos de seguridad
derivan de la plantilla. Si no se creó a partir de una plantilla, los derechos de
seguridad derivan de la cólección de transferencia relacionada con una base de
datos de PI AF.
Caso
Los derechos de seguridad derivan del analisis que posee el caso.
Para todos los demas tipos de objetos, los derechos de acceso de seguridad iniciales se calculan
a partir de la cólección correspondiente asociada con una base de datos de PI AF.
Por ejemplo, los derechos de acceso de seguridad para una nótificación derivan inicialmente
de la cólección Regla de nótificación de una base de datos de PI AF.
Nota:
Cuando se asocia un analisis o una plantilla de analisis con una nótificación o plantilla de
nótificaciónes heredadas (nótificaciónes de la versión 2012 o anteriores), se sincronizan
los derechos de acceso de seguridad para los dos objetos.
Herencia de permisos para objetos de elementos
Al cambiar los permisos de acceso de un elemento, los permisos de acceso de los elementos
principales o secundarios puede que cambien tambien. El comportamiento depende del tipo de
referencia.
Tipo de referencia principal-secundario
Cuando se crea un objeto o una cólección, se asigna un conjunto predeterminado de permisos
de acceso segun los permisos de acceso que estan establecidos en el elemento principal.
Cuando los permisos de acceso se establecen en un elemento principal, se evaluan los
siguientes ajustes de Permisos secundarios en la pagina Permisos de la ventana Configuración
de seguridad:
262
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Opción
Description
Do not modify child permissions
Evita que los permisos de acceso que se han establecido para el
objeto o la cólección actual se repliquen en colecciones y objetos
secundarios de la jerarquía de PI AF.
Esta ópción es la predeterminada cuando el servidor de PI AF
conectado cuenta con la versión 2.5 o anterior.
Update child permissions for
módified identities
Para cada elemento seleccionado en la lista Elementos para
configurar de la ventana Configuración de seguridad, replica los
permisos de acceso de todas las colecciones y objetos secundarios
para cada identidad de la lista Identidades cuyos permisos de acceso
se han módificadó.
Esta ópción es la predeterminada cuando el servidor de PI AF
conectado cuenta con la versión 2.6 o posterior. Esta ópción no esta
disponible cuando el servidor de PI AF conectado cuenta con la
versión 2.5 o anterior.
Replace child permissions for all
identities
Para cada elemento seleccionado de la lista Elementos para
configurar de la ventana Configuración de seguridad, reemplaza todos
los permisos secundarios para cada identidad de la lista Identidades
con los permisos de acceso del elemento principal.
Consejo:
Antes de aplicar esta ópción, OSIsoft recomienda que revise los
ajustes de los permisos de acceso de todos los elementos de la
lista Elementos para configurar para evitar la sustitución no
intencional de permisos personalizados que puedan estar
aplicados en alguna parte de la jerarquía de colecciones.
Repase el siguiente ejemplo para obtener clarificación.
Ejemplos
La siguiente jerarquía tiene tres elementos, cada uno con un ajuste de permiso de acceso
diferente.
Jerarquía de elemento de muestra
• Las identidades Administrators y World tienen permisos de acceso para los tres
elementos: EasternUS, SavannahSite y ProductionLine1.
• La identidad Savannah_IT tiene acceso al elemento SavannahSite.
• La identidad SavnEngineers tiene acceso al elemento ProductionLine1.
Guía del usuario PI System Explorer
263
Seguridad de objetos en PI AF
Permisos de acceso para jerarquía de muestra
Supongamos que desea agregar una identidad CorporateEngineering a cada elemento de la
jerarquía. Agregaría la identidad al elemento principal EasternUS:
Añadir identidad a elemento principal
Para replicar los permisos del elemento principal sin afectar las identidades que ya tienen
permisos de acceso asignados, debe cónfigurar la ópción Permisos secundarios a Actualizar
permisos secundarios para las entradas modificadas. La cadena de seguridad para los tres
elementos muestra que se ha agregado la identidad CorporateEngineering, pero las otras
identidades permanecen sin cambios:
264
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Replicar identidad y modificar permisos de acceso existentes
Para replicar los permisos del elemento principal para todas las identidades de la jerarquía,
debe cónfigurar la ópción Permisos secundarios a Reemplazar permisos secundarios para todas
las identidades. La cadena de seguridad de los tres elementos muestra que se ha agregado la
identidad CorporateEngineering, pero ha reemplazado los permisos de acceso con aquellos
asignados al elemento EasternUS:
Replicar identidad y reemplazar permisos de acceso existentes
Tenga en cuenta que las identidades Savannah_IT y SavnEngineers ya no aparecen en la
cadena de seguridad de los elementos SavannahSite y ProductionLine1 porque no fueron
incluidos en la lista Identidades del elemento EasternUS principal.
Guía del usuario PI System Explorer
265
Seguridad de objetos en PI AF
Tipo de referencia de composición
Los permisos de acceso del objeto secundario y principal son siempre los mismos.
Si cambia los permisos de acceso para el objeto secundario, los permisos de acceso del
principal se cambian autómaticamente para coincidir con los permisos del secundario. Del
mismo modo, si cambia los permisos de acceso para el objeto principal, los permisos de acceso
del secundario se cambian autómaticamente para coincidir con los permisos del principal.
Estos cambios se aplican en cascada en sentido descendente (y ascendente) en la totalidad de
la jerarquía.
Tipo de referencia débil
Los permisos de acceso no se heredan nunca.
Derechos de acceso de PI AF
La siguiente tabla describe los permisos de acceso que puede asignar a identidades de PI AF
para todos los objetos de la jerarquía de PI AF.
Derecho de acceso
Abreviatura
de cadena de
seguridad
Read
r
Definición
Permite al usuario ver el objeto. Se requieren derechos de
seguridad de Read para poder ver el objeto en aplicaciones
cliente. El permiso Read tambien permite a un usuario ver los
valores de cónfiguración de los atributos de elementos.
Los siguientes objetos siempre tienen el permiso Read,
independientemente de sus valores de seguridad, siempre que
el usuario registrado tenga acceso de lectura a PI System y a la
base de datos de PI AF. La unica excepción es la plantilla de
contacto de nótificación en que el usuario registrado solo
requiere acceso de lectura a PI System:
• Plantilla de analisis
• Categórías
• Plantilla de elementos
• Conjunto de enumeración
• Plantilla de event frame
• Plantilla de modelo
• Plantilla de contacto de nótificación
• Plantilla de nótificaciónes
• Tipo de referencia
• Plantilla de transferencia
• Base de datos de unidades de medida
Write
Read/Write
266
w
No aplicable
Guía del usuario PI System Explorer
Permite al usuario crear y módificar un objeto. La excepción es
que los event frames y las transferencias tambien requieren el
permiso Write Data en la plantilla de elementos a partir de la
que se crean, y los casos requieren el permiso Write Data en el
analisis en el que estan contenidos.
Permite al usuario leer y escribir el objeto asociado. Cuando se
elige, selecciona autómaticamente los permisos Read y Write.
Seguridad de objetos en PI AF
Derecho de acceso
Read Data
Abreviatura
de cadena de
seguridad
rd
Definición
Permite al usuario leer valores que no son de cónfiguración y
que proceden de atributos de elementos (no esta marcada la
propiedad Elemento de configuración para un atributo).
Asimismo, este permiso controla si un usuario puede ver las
transferencias creadas a partir de una determinada plantilla de
elementos de transferencia. Del mismo modo, controla si un
usuario puede consultar los casos creados en un analisis
específicó.
Si los siguientes objetos tienen permiso de Read Data, tambien
se les otorga permiso de Read:
• Caso
• Element
• Event frame
• Modelo
• Nótificación
• Transferencia
Write Data
Read/Write Data
wd
No aplicable
Permite al usuario escribir valores que no son de cónfiguración
en los atributos de un elemento (no esta marcada la propiedad
Elemento de configuración para un atributo). Asimismo, este
permiso controla si un usuario puede crear o módificar event
frames o transferencias creados a partir de una determinada
plantilla de elementos de transferencia. Del mismo modo,
controla si un usuario puede crear o módificar casos en un
analisis específicó.
Permite al usuario leer datos y escribir datos en el objeto
asociado. Cuando se elige, selecciona autómaticamente los
permisos Read y Write Data.
Delete
d
Permite al usuario eliminar un objeto. Elimine los derechos de
seguridad requeridos para eliminar un objeto, directa o
indirectamente al eliminarlo de otros objetos.
Execute
x
Permite a un usuario poner en cola el rellenado o el recalculó de
los analisis en el servicio de analisis. Tambien permite a un
usuario realizar la mayóría de las acciones en un caso de
analisis.
Admin
a
Permite al usuario módificar los ajustes de seguridad, o el
propietario, de un objeto. Los derechos de seguridad de
administración son necesarios para forzar un Deshacer
extracción sobre un objeto que esta extraídó a otro usuario,
como tambien para bloquear y desbloquear un Event Frame.
Nota:
Los usuarios con permiso de administración en el objeto
del servidor de PI AF tienen otorgados todos los derechos
no solo para el sistema, sino tambien para todos los
objetos dentro del sistema, incluidas las bases de datos.
Subscribe
s
Permite al usuario suscribirse y cancelar la suscripción a una
nótificación.
Subscribe Others
so
Permite al usuario suscribir y cancelar la suscripción de otros
usuarios a una nótificación.
Guía del usuario PI System Explorer
267
Seguridad de objetos en PI AF
Derecho de acceso
Abreviatura
de cadena de
seguridad
Annotate
an
Definición
Permite a un usuario anotar y cónfirmar event frames.
Nota:
Este derecho de acceso se anadió en PI AF de 2016. Tras
una actualización desde versiones anteriores del servidor,
los objetos con el derecho de acceso Write Data (wd)
reciben el derecho de acceso Annotate autómaticamente.
Las actualizaciones de clientes y servidores deben utilizar
este nuevo permiso.
Permisos de PI Data Archive
Para conectarse a un servidor PI Data Archive, PI AF requiere que se cónfigure el permiso de
Read en ese servidor. Tenga en cuenta que debido a la determinación de los permisos en un
servidor PI Data Archive requiere que se concrete una cónexión real, la lista completa de
servidores PI Data Archive cónfigurada en la maquina de un cliente siempre esta disponible.
Ademas, PI Data Archive siempre tiene permiso de Delete.
Opción para rechazar permisos
Seleccione la ópción Denegar en los siguientes casos:
• Para excluir un subconjunto de una asignación de identidad que tiene permisos concedidos.
• Para excluir un permiso especial cuando ya haya otorgado el control total a una identidad.
Nota:
PI Module Database no admite la ópción Denegar. Si utiliza PI MDB y PI AF, evite la ópción
Denegar para evitar problemas de sincrónización.
Ventana de configuración de seguridad
Puede ver y cónfigurar permisos de acceso para identidades, y tambien buscar los permisos y
las restricciones de un usuario de dominio de Windows mediante las identidades asignadas en
la ventana Configuración de seguridad.
Puede abrir la ventana Configuración de seguridad en cualquier lugar de PI System Explorer
donde observe un enlace de Seguridad en una ventana o donde aparezca Seguridad en un
menu contextual.
En esta sección
• Pestana Permisos
• Pestana Acceso eficaz
• Ver el acceso eficaz por usuario
Pestaña Permisos
Puede ver y cónfigurar permisos de acceso para elementos individuales o multiples por
identidad en la pagina Permisos de la ventana Configuración de seguridad.
268
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Permisos
Lista Elementos para configurar
El contenido de la lista Elementos para configurar se determina a partir del contexto de
jerarquía e indica si puede cónfigurar permisos de acceso para toda la jerarquía de PI AF, una
sola base de datos y a contenedores, o a un solo contenedor y un objeto.
Guía del usuario PI System Explorer
269
Seguridad de objetos en PI AF
Para cónfigurar permisos de acceso solo para algunos de los elementos, puede borrar aquellos
que no desee cónfigurar.
Lista Identidades
La lista Identidades enumera las identidades que tienen permisos para todos los elementos
seleccionados en la lista Elementos para configurar . Utilice las funciones Añadir y Eliminar
para administrar que identidades aparecen en la lista.
Si el servidor de PI AF conectado actualmente no es compatible con las identidades (PI AF 2014
o anteriores), la ventana Configuración de seguridad muestra los permisos de acceso de Grupos
o Usuarios, y puede agregar o eliminar cuentas de Windows mediante las ventanas estandares
de Active Directory.
Lista Permisos
De la misma manera que cada identidad seleccionada esta en la lista Identidades, los permisos
asociados a los elementos marcados en la lista Elementos para configurar se muestran en la
lista Permisos. Puede otorgar o denegar permisos para cada identidad como lo desee sin perder
los cambios. Los permisos de acceso que establece para cada identidad se conservan hasta que
hace clic en los botones Aceptar, Cancelar o Aplicar.
Nota:
Si selecciona mas de una entrada Elementos para configurar y la identidad seleccionada
actualmente tiene uno de los permisos en una o mas, pero no en todas las entradas
seleccionadas en la lista Elementos , la casilla de verificación para ese permiso móstrara
un punto ( ) para indicar que algunas entradas en la lista Elementos tienen establecido
el permiso, mientras que otras no lo tienen.
Pestaña Acceso eficaz
Puede ver el acceso de un usuario a los elementos en PI AF en la pagina Acceso eficaz de la
ventana Configuración de seguridad.
La pagina Acceso eficaz le permite ver todos los permisos de acceso de un usuario para los
elementos de PI AF, como bases de datos y colecciones, y se basa en las asignaciones de
identidad de PI AF actuales del usuario. Cada identidad tiene su propio conjunto de permisos
de acceso en el servidor de PI AF. Los ajustes de los permisos de acceso permiten o impiden
270
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
que un usuario pueda leer, escribir, eliminar y realizar otras acciones en los objetos. Los
derechos de acceso de un usuario se determinan mediante la "fusión" o suma del conjunto de
todos los permisos de la identidad y la resta del conjunto de todos los permisos denegados. A
cóntinuación, se otorga acceso eficaz a un usuario a los elementos sobre la base de los permisos
"fusionados" de las identidades asignadas.
Por ejemplo, el usuario de Windows Maria es miembro de las identidades PI AF Ingenieros,
Administradores y Operarios de planta. Las identidades Ingenieros y Administradores pueden
leer analisis, pero la identidad Operarios de planta tiene el acceso denegado a la lectura de
analisis. Como resultado, el acceso eficaz de Maria en PI AF es la capacidad de leer analisis. Para
obtener mas infórmación sobre identidades y asignaciones, consulte Identidades y
asignaciones de PI AF.
Acceso eficaz
Sección Cuenta
La sección Cuenta es donde introduce un nombre de usuario de dominio de Windows, por
ejemplo rsmith, para comenzar a ver sus permisos para los elementos. El identificadór de
seguridad y las asignaciones de identidad de un usuario tambien se muestran en esta sección.
Guía del usuario PI System Explorer
271
Seguridad de objetos en PI AF
Lista Elementos para ver el acceso
La lista Elementos para ver el acceso se basa en los elementos seleccionados para la
cónfiguración de seguridad en la pestana Permisos. Para ver los permisos de un usuario para
un elemento, seleccione el elemento en la lista Elementos para ver el acceso.
Lista Permisos
Puede ver los permisos de acceso específicós de un usuario para un elemento seleccionado en
la lista Permisos. Para obtener mas infórmación sobre los permisos asignados, consulte
Derechos de acceso de PI AF.
Ver el acceso eficaz por usuario
Utilice la pagina Acceso eficaz de la ventana Configuración de seguridad para ver detalles sobre
los permisos de acceso de un usuario para elementos en PI AF.
Antes de empezar
Para mostrar los permisos de acceso de un usuario de PI AF, necesitara el nombre de dominio
de Windows del usuario.
Procedimiento
1. Elija uno de los siguientes metódós para abrir la ventana Configuración de seguridad:
Para abrir desde…
Haga lo siguiente…
La ventana Propiedades del servidor de PI AF
a. En la barra de herramientas, haga clic en
.
b. En la ventana Propiedades del servidor de PI
AF, haga clic en el enlace Seguridad.
La ventana Seleccionar base de datos
a. En la barra de herramientas, haga clic en el
bótón Base de datos.
b. En la ventana Seleccionar base de datos, haga
clic en el bótón Editar seguridad.
Navegador de PI System Explorer
a. Haga clic con el bótón derecho en un objeto o
una cólección y haga clic en Seguridad.
b. En la ventana Propiedades del servidor de PI
AF, haga clic en el enlace Seguridad.
2. En la ventana Configuración de seguridad, haga clic en la pestana Acceso eficaz.
3. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows de un
usuario cuyos permisos desea ver.
4. Presione el tabulador o Intro para validar su entrada.
Nota:
Puede hacer clic en
junto al campo Usuario de dominio para buscar el nombre de
dominio de Windows de un usuario.
Los campos y las listas en la pagina Acceso eficaz se completan con la siguiente infórmación:
◦ Campo SID de usuario: muestra el identificadór de seguridad del usuario
◦ Lista Identidades: enumera todas las identidades de PI AF asignadas a la cuenta de
usuario de dominio de Windows en el paso 3
272
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
◦ Lista Elementos para ver acceso: muestra los elementos seleccionados para la
cónfiguración de seguridad. La lista refleja los elementos mostrados en la lista Elementos
para configurar en la tarjeta Permisos.
◦ Lista Permisos: muestra los permisos de acceso para el elemento actualmente
seleccionado en la lista Elementos para configurar.
5. Haga clic y arrastre la barra de separación horizontal hacia arriba o hacia abajo para ajustar
la cantidad de infórmación que se muestra en los cuadros de lista.
6. Seleccione un elemento diferente en la lista Elementos para ver acceso. Los permisos de
acceso del usuario para el elemento seleccionado se muestran en la lista Permisos. Para
obtener mas infórmación sobre derechos de acceso, consulte Derechos de acceso de PI AF.
7. Repita el paso 6 segun sea necesario para ver permisos de acceso para otros elementos.
8. Haga clic en Aceptar para salir de la ventana Configuración de seguridad.
Seguridad del servidor de PI AF
Cuando el servidor de PI AF se instala por primera vez, el acceso de administrador (todos los
permisos) se le otorga a la identidad Administrators integrada, y se le otorga permiso de
lectura de todos los objetos y colecciones a la identidad World. Para todas las demas
identidades que se asignan a usuarios y grupos de Windows, un administrador debe cónfigurar
el acceso correcto al servidor de PI AF, las bases de datos, las colecciones y los objetos.
Configurar la seguridad de un servidor de PI AF
Cónfigure los permisos de acceso para un servidor de PI AF conectado de manera que una
identidad de PI AF pueda acceder a bases de datos, colecciones y objetos.
Antes de empezar
Para conectarse a un servidor de PI AF, una identidad debe tener permisos de lectura para el
objeto del servidor de PI AF.
Procedimiento
1. Elija uno de los siguientes metódós para abrir la pestana Permisos en la ventana
Configuración de seguridad para un servidor de PI AF:
Para abrir desde…
La ventana Servidores
Haga lo siguiente…
a. Seleccione Archivo > Conexiones.
b. En la ventana Servidores, haga clic con el
bótón secundario en el servidor de PI AF
(
) predeterminado y luego haga clic en
Seguridad.
La ventana Propiedades del servidor de PI AF
a. En la barra de herramientas, haga clic en
.
b. En la ventana Propiedades del servidor de PI
AF, haga clic en el enlace Seguridad.
La ventana Seleccionar base de datos
a. En la barra de herramientas, haga clic en el
bótón Base de datos.
b. En la ventana Seleccionar base de datos, haga
clic en el bótón Editar seguridad.
Guía del usuario PI System Explorer
273
Seguridad de objetos en PI AF
En la lista Elementos para configurar de la ventana Configuración de seguridad, el servidor y
cada cólección estan seleccionados.
2. Borre las colecciones a las que no desea que se les asigne la misma cónfiguración de
permisos que al servidor. Por ejemplo, es posible que desee asignar derechos de acceso para
colecciones a nivel del servidor, como las asignaciones y las identidades, pero utilice un
conjunto diferente de permisos de acceso para las bases de datos y sus colecciones.
3. En la lista Identidades, revise las identidades existentes y valide los permisos. Tambien
puede anadir y eliminar identidades, segun sea necesario.
Para…
Haga lo siguiente…
Anadir o módificar permisos de identidades
existentes
a. Seleccione una identidad de la lista
Identidades.
b. En la lista Permisos para Identity, marque o
borre las casillas de verificación Permitir o
Denegar junto a los permisos que desea
cónfigurar.
Anadir otra identidad a la lista Identidades
a. Haga clic en Agregar.
b. En la ventana Seleccionar identidades,
seleccione la identidad que desea anadir.
c. Haga clic en Aceptar. La identidad se anade a
la lista.
d. En la lista Permisos para Identity, cónfigure
los permisos de acceso, segun sea necesario
(la cónfiguración predeterminada es que
todos esten seleccionados).
Consejo:
Si necesita crear una identidad y una
asignación nueva, haga clic en Nueva
identidad. Para obtener mas infórmación,
consulte Administrar identidades en PI AF.
Eliminar una identidad de la lista Identidades
a. Seleccione una identidad de la lista
Identidades.
b. Haga clic en Eliminar.
4. Seleccione una de las opciones de Permisos secundarios. Para obtener mas infórmación,
consulte Herencia de permisos para objetos de elementos.
5. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
6. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
7. Opcional. Presione las teclas Tab o Intro para validar su entrada.
8. Haga clic en Aceptar.
Seguridad de bases de datos de PI AF
Para visualizar una base de datos de PI AF, una identidad debe tener al menos permisos de
lectura para el objeto de la base de datos. Cónfigure permisos individualmente para cada base
de datos o para la cólección completa de bases de datos.
A partir de PI AF 2017 R2, ya no es necesario que los usuarios tengan permiso de escritura en
una base de datos de PI AF para tener permiso de escritura en otros objetos de la base de datos.
274
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Los usuarios solo necesitan que se les asigne una identidad con acceso de escritura para
objetos, como elementos, de manera que puedan editarlos. Para prevenir que los usuarios
tengan acceso de escritura a objetos específicós, conviene asignarles una identidad con acceso
de solo lectura a esos objetos.
En esta sección
• Cónfigurar la seguridad para nuevas bases de datos de PI AF
• Cónfigurar la seguridad para una unica base de datos de PI AF
Configurar la seguridad para nuevas bases de datos de PI AF
Cónfigure Derechos de acceso de PI AF predeterminados para todas las identidades que
necesitan acceso a las bases de datos en un servidor de PI AF.
Procedimiento
1. En la barra de herramientas, haga clic en el bótón Base de datos.
2. En la ventana Seleccionar base de datos, haga clic en el bótón Editar seguridad.
En la lista Elementos para configurar de la ventana Configuración de seguridad, el servidor y
cada cólección estan seleccionados.
3. En la lista Elementos para configurar, borre el servidor y las siguientes colecciones:
Contactos, Plantillas de contactos de notificación, Identidades y Asignaciones. Se deben
seleccionar las Bases de datos y todas las Base de datos - Collections.
4. En la lista Identidades, revise las identidades existentes y valide los permisos. Tambien
puede anadir y eliminar identidades, segun sea necesario.
Para…
Haga lo siguiente…
Anadir o módificar permisos de identidades
existentes
a. Seleccione una identidad de la lista
Identidades.
b. En la lista Permisos para Identity, seleccione o
borre las casillas de verificación Permitir o
Denegar junto a los permisos que desea
cónfigurar.
c. Repita esta acción para cada identidad.
Anadir otra identidad a la lista Identidades
a. Haga clic en Agregar.
b. En la ventana Seleccionar identidades,
seleccione la identidad que desea anadir.
c. Haga clic en Aceptar. La identidad se anade a
la lista.
d. En la lista Permisos para Identity, cónfigure
los permisos de acceso, segun sea necesario
(la cónfiguración predeterminada es que
todos esten marcados).
Consejo:
Si necesita crear una identidad y una
asignación nueva, haga clic en Nueva
identidad. Para obtener mas infórmación,
consulte Administrar identidades en PI AF.
Eliminar una identidad de la lista Identidades
a. Seleccione una identidad de la lista
Identidades.
b. Haga clic en Eliminar.
Guía del usuario PI System Explorer
275
Seguridad de objetos en PI AF
5. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
6. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
7. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
8. Opcional. Presione las teclas Tab o Intro para validar su entrada.
9. Haga clic en Aceptar.
Configurar la seguridad para una única base de datos de PI AF
Para una unica base de datos, cónfigure Derechos de acceso de PI AF para identidades que
necesitan tener acceso a sus colecciones y objetos.
Procedimiento
1. En la barra de herramientas, haga clic en el bótón Base de datos.
2. En la ventana Seleccionar base de datos, haga clic en el bótón secundario sobre una base de
datos en la lista Bases de datos y seleccione Seguridad.
En la lista Elementos para configurar de la ventana Configuración de seguridad, la base de
datos y cada cólección de la base de datos estan marcados.
3. Opcional. Borre las colecciones que no desea módificar desde su cónfiguración
predeterminada y las identidades asignadas.
4. En la lista Identidades, revise las identidades existentes y valide los permisos. Tambien
puede anadir y eliminar identidades, segun sea necesario.
Para…
Haga lo siguiente…
Anadir o módificar permisos de identidades
existentes
a. Seleccione una identidad de la lista
Identidades.
b. En la lista Permisos para Identity, marque o
borre las casillas de verificación Permitir o
Denegar junto a los permisos que desea
cónfigurar.
c. Repita esta acción para cada identidad.
Anadir otra identidad a la lista Identidades
a. Haga clic en Agregar.
b. En la ventana Seleccionar identidades,
seleccione la identidad que desea anadir.
c. Haga clic en Aceptar. La identidad se anade a
la lista.
d. En la lista Permisos para Identity, cónfigure
los permisos de acceso, segun sea necesario
(la cónfiguración predeterminada es que
todos esten marcados).
Consejo:
Si necesita crear una identidad y una
asignación nueva, haga clic en Nueva
identidad. Para obtener mas infórmación,
consulte Identidades y asignaciones de PI
AF.
276
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Eliminar una identidad de la lista Identidades
a. Seleccione una identidad de la lista
Identidades.
b. Haga clic en Eliminar.
5. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
6. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
7. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
8. Opcional. Presione las teclas Tab o Intro para validar su entrada.
9. Haga clic en Aceptar.
Seguridad de colecciones en PI AF
El descriptor de seguridad de una cólección de PI AF determina los permisos de acceso para
esa cólección, como tambien los permisos de acceso predeterminados para nuevos objetos de
la cólección. Por ejemplo, los permisos de la cólección Elementos determinan que identidades
pueden crear y eliminar elementos. Los permisos de la cólección Elementos se replican como el
descriptor de seguridad para cualquier objeto de Elemento creado recientemente.
Puede cónfigurar permisos de acceso para colecciones en diversos puntos de la jerarquía de PI
AF. Puede cónfigurarlós en el nivel del servidor para que los permisos asignados a las
identidades del servidor tambien se asignen a las mismas identidades de todas las colecciones
de la base de datos (consulte Cónfigurar la seguridad de un servidor de PI AF). Puede
cónfigurarlós en el nivel de la base de datos para que los permisos asignados a las identidades
de una base de datos tambien se asignen a las mismas identidades de todas las colecciones de
esa base de datos (consulte Cónfigurar la seguridad para una unica base de datos de PI AF).
Nota:
Los objetos de la biblioteca (plantillas, conjuntos de enumeración, tipos de referencia,
tablas, conexiones de tabla y categórías) siempre tienen permiso de lectura (r) sin
importar sus cónfiguraciónes de seguridad.
Configurar la seguridad para colecciones
Asigne permisos de acceso para una cólección específica en una base de datos de PI AF.
Procedimiento
1. Elija uno de los siguientes metódós para abrir la ventana Configuración de seguridad para
una cólección de bases de datos:
Para abrir…
Haga lo siguiente…
Cólección Elementos
En el navegador Elementos, haga clic con el bótón
secundario sobre la cólección Elementos ( ) y
luego haga clic en Seguridad.
Cólección Event Frames
En el navegador Event Frames, haga clic con el
bótón secundario sobre la busqueda de event
frames ( ) y luego haga clic en Seguridad.
Cólección Transferencias
En el navegador Event Frames, haga clic con el
bótón secundario sobre la busqueda de
transferencias ( ) y luego haga clic en
Seguridad.
Guía del usuario PI System Explorer
277
Seguridad de objetos en PI AF
Cólección Plantillas de elementos
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Plantillas de elementos y luego
haga clic en Seguridad.
Nota:
Los permisos de acceso para la cólección
Plantillas de elementos tambien cónfiguran
permisos de acceso para plantillas de event
frames, plantillas de modelos y plantillas de
transferencias.
Cólección Conjuntos de enumeración
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Conjuntos de enumeración y
luego haga clic en Seguridad.
Cólección Tipos de referencia
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Tipos de referencia y luego
haga clic en Seguridad.
Cólección Tablas
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Tablas y luego haga clic en
Seguridad.
Cólección Conexiones de tablas
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Conexiones de tablas y haga
clic en Seguridad.
Cólección Categórías
En el navegador Biblioteca, haga clic con el bótón
secundario sobre Categorías y luego haga clic en
Seguridad.
En la lista Elementos para configurar de la ventana Configuración de seguridad, la cólección
esta seleccionada.
2. En la lista Identidades, revise las identidades existentes y valide los permisos. Tambien
puede anadir y eliminar identidades, segun sea necesario.
Para…
Haga lo siguiente…
Anadir o módificar permisos de identidades
existentes
a. Seleccione una identidad de la lista
Identidades.
b. En la lista Permisos para Identity, seleccione o
borre las casillas de verificación Permitir o
Denegar junto a los permisos que desea
cónfigurar.
c. Repita esta acción para cada identidad.
Anadir otra identidad a la lista Identidades
a. Haga clic en Agregar.
b. En la ventana Seleccionar identidades,
seleccione la identidad que desea anadir.
c. Haga clic en Aceptar. La identidad se anade a
la lista.
d. En la lista Permisos para Identity, cónfigure
los permisos de acceso, segun sea necesario
(la cónfiguración predeterminada es que
todos esten seleccionados).
Consejo:
Si necesita crear una identidad y una
asignación nueva, haga clic en Nueva
identidad. Para obtener mas infórmación,
consulte Administrar identidades en PI AF.
278
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Eliminar una identidad de la lista Identidades
a. Seleccione una identidad de la lista
Identidades.
b. Haga clic en Eliminar.
3. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
4. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
5. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
6. Opcional. Presione las teclas Tab o Intro para validar su entrada.
7. Haga clic en Aceptar.
Seguridad de objetos de PI AF
Puede definir permisos de acceso específicós para una identidad que difiera de la cónfiguración
predeterminada heredada de otro lugar en la jerarquía de PI AF para cualquier objeto (o grupo
de objetos) y cólección en una base de datos.
En esta sección
• Cónfigurar la seguridad para objetos
• Cónfigurar la seguridad de analisis y plantillas de analisis
Configurar la seguridad para objetos
Cónfigure los permisos de acceso para las identidades de los objetos en el navegador o el visor
en situaciones en las que el acceso debe ser diferente de los permisos heredados. Tambien
puede establecer permisos personalizados para las identidades de una cólección específica en
la Biblioteca.
Nota:
Debe tener privilegios de administrador y pertenecer a la identidad de administrador de
PI AF para cónfigurar los ajustes de seguridad.
Procedimiento
1. Elija una de las siguientes acciones:
Para establecer permisos de acceso para…
Haga lo siguiente…
Un objeto del navegador
Haga clic con el bótón secundario sobre el objeto
y haga clic en Seguridad.
Varios objetos
a. Cuando se muestran varios objetos en el visor
(despues de una busqueda, por ejemplo),
utilice las teclas de Windows estandar para
resaltar objetos contiguos (MAYÚS+<click>) o
no contiguos (CTRL+<click>).
b. Haga clic con el bótón secundario y luego
haga clic en Pronósticos.
2. En la lista Identidades, revise las identidades y valide los permisos. Tambien puede anadir y
eliminar una identidad de la lista.
Guía del usuario PI System Explorer
279
Seguridad de objetos en PI AF
Para…
Haga lo siguiente…
Anadir o módificar permisos de identidades
existentes
a. Seleccione una identidad de la lista
Identidades.
b. En la lista Permisos para Identity, marque o
borre las casillas de verificación Permitir o
Denegar junto a los permisos que desea
cónfigurar.
c. Repita esta acción para cada identidad.
Anadir otra identidad a la lista Identidades
a. Haga clic en Agregar.
b. En la ventana Seleccionar identidades,
seleccione la identidad que desea anadir.
c. Haga clic en Aceptar. La identidad se anade a
la lista.
d. En la lista Permisos para Identity, cónfigure
los permisos de acceso, segun sea necesario
(la cónfiguración predeterminada es que
todos esten seleccionados).
Consejo:
Si necesita crear una identidad y una
asignación nuevas, haga clic en Nueva
identidad. Para obtener mas infórmación,
consulte Administrar identidades en PI AF.
Eliminar una identidad de la lista Identidades
a. Seleccione una identidad de la lista
Identidades.
b. Haga clic en Eliminar.
3. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
4. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
5. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
6. Opcional. Presione las teclas Tab o Intro para validar su entrada.
7. Haga clic en Aceptar.
Configurar la seguridad de análisis y plantillas de análisis
Utilice la ventana Configuración de seguridad para administrar los permisos de acceso para las
identidades de PI AF que pueden funcionar con analisis y plantillas de analisis.
Para obtener infórmación sobre permisos específicós que se necesita que funcionen con
analisis, consulte Derechos de acceso de PI AF.
Procedimiento
1. Elija una de las siguientes acciones:
280
Guía del usuario PI System Explorer
Seguridad de objetos en PI AF
Para…
Haga lo siguiente…
Cónfigurar permisos de acceso para un analisis
a. En el navegador Elementos, seleccione el
elemento que contiene el analisis.
b. Haga clic en la pestana Análisis.
c. Haga clic con el bótón secundario sobre el
nombre y luego haga clic en Seguridad.
Cónfigurar permisos de acceso para una plantilla
de analisis
a. En el navegador Biblioteca, seleccione la
plantilla de elementos que contiene la
plantilla de analisis.
b. Haga clic en la pestana Plantillas de análisis.
c. Haga clic con el bótón secundario sobre el
nombre y luego haga clic en Seguridad.
Cónfigurar permisos de acceso para todos los
analisis en una base de datos de PI AF
a. En la barra de herramientas, haga clic en Base
de datos.
b. En la ventana Seleccionar base de datos, haga
clic con el bótón secundario sobre el nombre
de la base de datos y luego haga clic en
Seguridad.
c. En la ventana Configuración de seguridad,
borre la casilla de verificación del Elemento
arriba de la lista Elementos para configurar.
d. Seleccione el elemento database: Análisis.
Cónfigurar permisos de acceso para todas las
plantillas de analisis en una base de datos de PI
AF
a. En la barra de herramientas, haga clic en Base
de datos.
b. En la ventana Seleccionar base de datos, haga
clic con el bótón secundario sobre el nombre
de la base de datos y luego haga clic en
Seguridad.
c. En la ventana Configuración de seguridad,
borre la casilla de verificación del Elemento
arriba de la lista Elementos para configurar.
d. Seleccione el elemento database: Plantillas
de análisis.
2. En la lista Identidades, revise las identidades y valide los permisos. Tambien puede anadir y
eliminar una identidad de la lista, como se describe en Cónfigurar la seguridad para objetos.
3. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
4. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
5. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
6. Opcional. Presione las teclas Tab o Intro para validar su entrada.
7. Haga clic en Aceptar.
Guía del usuario PI System Explorer
281
Seguridad de objetos en PI AF
Configurar la seguridad para la base de datos de unidades de
medida
No puede definir permisos para clases de UOM o UOM individuales. Sin embargo, sí puede
cónfigurarlós para la totalidad de la base de datos de unidades de medida.
Antes de empezar
Las unidades de medida siempre tienen permiso de lectura, independientemente de otras
cónfiguraciónes de seguridad.
Procedimiento
1. En el navegador, seleccione Unidad de medida.
2. En la barra de herramientas, haga clic en Seguridad de UOM.
En la lista Elementos para configurar de la ventana Configuración de seguridad, el elemento
Base de datos de unidades de medida esta seleccionado.
3. En la lista Identidades, revise las identidades existentes y valide los permisos. Tambien
puede anadir y eliminar identidades, como se describe en Cónfigurar la seguridad para
objetos.
4. En la sección Permisos secundarios, elija una de las opciones de permisos heredados. Para
obtener mas infórmación, consulte Herencia de permisos para objetos de elementos.
5. Opcional. Para ver todos los permisos de acceso de un usuario para elementos de PI AF
basados en la asignaciones de identidad actuales de PI AF, haga clic en la pestana Acceso
eficaz.
6. Opcional. En el campo Usuario de dominio, introduzca el nombre de dominio de Windows
de un usuario cuyos permisos desea ver.
7. Opcional. Presione las teclas Tab o Intro para validar su entrada.
8. Haga clic en Aceptar.
Diferencias del modelo de seguridad de PI Data Archive
Aunque el modelo de seguridad es similar al que utiliza PI Data Archive, hay varias diferencias:
• El privilegio Denegar es compatible. Consulte Opción para rechazar permisos.
• Hay un conjunto mas amplio de permisos de acceso disponible. Consulte Derechos de acceso
de PI AF.
• No se admite el equivalente de las identidades PI user y PI group.
• No se admiten los PI trusts y los inicios de sesión explícitós de PI.
• No se admite el concepto de un indicador que no se puede eliminar en una identidad o
asignación.
• No se puede deshabilitar las asignaciones. Solo se puede desactivar las identidades de PI AF.
• Puede asignar una unica identidad de usuario de Windows a mas de una identidad de PI AF.
• Se instala un conjunto de identidades incorporadas diferente: Administrators,
Engineers y World.
282
Guía del usuario PI System Explorer
Event Frames en PI AF
La captura de eventos importantes del proceso y la recópilación de datos pertinentes
relacionados con esos eventos pueden ayudar a analizar el motivo por el que se han producido.
Por ejemplo, puede supervisar de cerca eventos, como el períódó de inactividad de los activos,
las desviaciones del proceso, el inicio y apagado de los equipos y las desviaciones
medioambientales, para identificar las posibles causas de los errores o los puntos donde es
probable que se produzcan.
La recópilación de datos a lo largo de períódós de tiempo repetidos, como los batches de
seguimiento de productos, las ejecuciones de productos o los cambios de operador, puede
aumentar la eficacia de esos procesos. La captura de datos completos y asociados con un evento
de ese tipo puede ayudar a realizar un seguimiento del proceso o evento, o realizar
comparaciones o analisis.
Al igual que los elementos permiten recopilar y almacenar datos sobre activos, los marcos de
evento permiten recopilar y almacenar datos sobre eventos. OSIsoft le recomienda utilizar el
analisis basado en activos para realizar el seguimiento de sus eventos mediante Event Frames.
PI Datalink, PI Vision y PI WebParts son herramientas cliente que permiten visualizar marcos
de evento.
Un marco de evento sintetiza el períódó de tiempo del evento con datos de activo completos y
pertinentes:
Datos de evento de ejemplo
Videos
Para obtener infórmación sobre los marcos de evento, mire este video:
https://www.youtube.com/watch?v=4XPL7J7u61U&rel=0
Otra ópción es mirar todos los videos en la lista de repróducción de Event Frames:
https://www.youtube.com/playlist?list=PLMcG1Hs2JbcunItGs7JS6kFl3WYMb-p3D&rel=0
En esta sección
• Estructura de marcos de evento
• Ventajas de los marcos de evento
• Ejemplos de marcos de evento
• ¿Event frames o batch?
• Metódós de creación de marcos de evento
• Visualización de marcos de evento
• Plantillas de event frames
Guía del usuario PI System Explorer
283
Event Frames en PI AF
• Crea event frames.
• Captura de valores para event frames y transferencias
• Bloquear marcos de evento o transferencias
• Reconocimiento de event frames
• Transferencias
Estructura de marcos de evento
Cada marco de evento tiene un nombre, una hora de inicio, una hora de finalización, uno o mas
atributos y uno o mas elementos de PI AF referenciados. Al igual que con los elementos, debería
crear plantillas de Event Frames para estandarizar y administrar los atributos para distintos
tipos de eventos.
Con los marcos de evento, puede realizar busquedas de los propios eventos en PI System de
forma sencilla, en lugar de buscar eventos por hora. Puede cónfigurar los Event Frames para
que devuelvan de forma autómatica todos los datos de evento relacionados en tiempo real para
que no resulte necesario consultar datos de eventos y de procesos en varios sistemas y tener
que fusionarlos de forma manual. Tambien puede cónfigurar marcos de evento para recuperar
datos históricós.
Cuándo utilizar Event Frames
Existen dos categórías de eventos de los que se puede realizar un seguimiento que se ajustan a
un perfil de marco de evento:
• Eventos "correctos": Eventos de los que se desea realizar un seguimiento como parte
habitual de la actividad empresarial; por ejemplo, seguimiento de productos, cambios, etc.
• Eventos "incorrectos": Eventos inesperados que es necesario analizar y tal vez solucionar
rapidamente si se producen, como cierres inesperados o desviaciones. Estos son los eventos
a los que desea realizarles un seguimiento y para los que desea generar informes a lo largo
de un períódó de tiempo.
Estas son algunas de las preguntas que puede hacerse para identificar eventos o condiciones de
los que es necesario realizar un seguimiento:
• ¿A que horas se ha producido el evento X en este tipo de activo?
• ¿Puedo asociar datos procedentes de diferentes tags para un intervalo de tiempo o para un
punto unicó en el tiempo?
• ¿Cuales son los datos asociados para el períódó de tiempo concreto en el que se produjo un
problema o pódría producirse en el futuro?
• ¿Cuales son los eventos de proceso esenciales que es necesario nótificar a alguien?
• ¿Existe algun estado digital para los tags de PI System que sea significativó cuando se
módifica y deba iniciar alguna otra acción?
Ventajas de los marcos de evento
Los marcos de evento ofrecen las siguientes ventajas:
• Flexibilidad
Event Frames:
284
Guía del usuario PI System Explorer
Event Frames en PI AF
◦ Hace referencia a varios elementos dentro del mismo evento.
◦ Admite la superpósición de varios eventos en un elemento de PI AF.
◦ Capta cualquier evento; un “batch” es simplemente un tipo de evento capturable.
• Opciones de búsqueda fácil
Las busquedas se pueden especificar en una serie de atributos de Event Frame
cónfigurables: especificar un intervalo de tiempo es opcional. Por ejemplo, puede realizar
busquedas introduciendo simplemente el nombre del marco de evento. Los atributos de
Event Frame mas cómunmente buscados se pueden cónfigurar como atributos indexados a
traves de plantillas de Event Frame, las cuales aceleran las busquedas de los usuarios finales.
• Escalabilidad
Los marcos de evento son extremadamente escalables, mientras que el rendimiento de la
busqueda se degrada con un gran numeró (decenas de miles) de lotes.
Ejemplos de marcos de evento
Ejemplo de Event Frames en una empresa de generación de energía eólica
Tomemos como ejemplo una empresa de generación de energía eólica que tiene distintos tipos
de molinos en diferentes ubicaciones y utiliza PI AF para organizar sus datos. Su estructura de
activos se basa en una plantilla de elementos basicós de tipo "molino" y tiene distintos
elementos secundarios basados en OEM, un modelo y una potencia nominal expresada en
megavatios. Es posible que el operador de energía eólica desee obtener contratos de garantía
favorables demostrando que las aspas estan funcionando de forma segura. O es posible que el
operador necesite supervisar parametrós, como la presión del aceite lubricante, el voltaje
maximó, el factor de potencia o el funcionamiento correcto de los servofrenos mecanicós y
electrónicós en las actas antes de que se produzcan desviaciones de proceso. En todos estos
casos, se pueden asociar Event Frames con atributos de Event Frame específicós.
El elemento Molino de ejemplo puede incluir estos atributos de activos y atributos de marcos
de evento asociados:
Atributo de activo
Atributo de Event Frame
RPM
Velocidades instantanea y maxima
Voltaje
Voltaje maximó
Potencia
Potencia en el momento actual
Giro
Giro en el momento actual
Paso
Paso en el momento actual
Presión del aceite lubricante
Presión maxima del aceite lubricante
Puesto que todos los tipos de turbina comparten atributos identicós, puede crear solo una
plantilla de Event Frames y utilizarla para supervisar eventos similares en diferentes activos.
Por ejemplo, puede que el interese el atributo RPM para capturar un evento basado en la
velocidad. Si utiliza la nótación especial .\Elements[.]|RPM en la plantilla, pódra utilizar la
plantilla en cualquier molino y acceder al atributo del elemento concreto referenciado.
Ejemplo de Event Frames utilizando el análisis de activos
Para ver un ejemplo de la creación de Event Frames con analisis basado en activos, consulte
Crear de forma autómatica event frames para realizar un seguimiento de la ineficiencia.
Guía del usuario PI System Explorer
285
Event Frames en PI AF
¿Event frames o batch?
Batch proporciona un procedimiento para generar datos de eventos de batch en función de PI
tags. Los event frames proporcionan un metódó para realizar un seguimiento y analizar datos
de proceso y empresariales relacionados con eventos definidós en atributos de PI AF.
Las diferentes empresas y usuarios provienen de distintos niveles de implementación de PI
System y del uso de funciones de PI System; por lo tanto, recomendar batch o event frames es
muy subjetivo. No obstante, como recómendación general, todos los clientes deberían migrar a
event frames en el futuro cercano. A cóntinuación, se mencionan algunos ejemplos de
situaciones en las que pueden verse involucrados los clientes:
• Es usuario de batch y utiliza RtReports.
Debido a que RtReports 4.1 ahora admite AF y event frames, debería ejecutar la migración
«Batch a event frames» y, luego, migrar las plantillas de RtReports para usar los contextos de
AF.
• No utiliza actualmente Batch pero tiene casos de uso de batches o debe utilizar RtReports.
OSIsoft recomienda usar event frames. Los event frames satisfacen todas sus necesidades.
• No utiliza Batch y no tiene casos de uso de batches.
Debe utilizar event frames. Los casos de uso típicós de event frames incluyen tiempos de
inactividad o cortes de suministro en el sector de la electricidad, desviaciones en el sector
del suministro de agua, etcetera.
Nota:
OSIsoft no recomienda ejecutar instancias dobles o en paralelo de interfaces de Batch y
event frames en la próducción porque aumentan la complejidad de la migración.
Métodos de creación de marcos de evento
Si bien puede crear marcos de evento con varios productos de OSIsoft diferentes, OSIsoft
recomienda enfaticamente que utilice el analisis de activos.
Análisis basados en activos
PI Data Archive permite crear eventos de una sola capa y activar expresiones que abran o
cierren marcos de evento. Consulte Analisis de generación de marcos de evento.
PI Event Frame Generator (PI EFGen)
PI EFGen utiliza tanto PI SDK como AF SDK para crear una jerarquía de eventos o convertir una
estructura de PI BaGen en una estructura generadora de marcos de evento. Utilice PI System
Explorer o PI Builder para crear las plantillas de marcos de evento, los atributos asociados y las
referencias de PI points.
Para obtener instrucciones sobre cómó crear marcos de evento con PI EFGen, mire este video:
https://www.youtube.com/watch?v=UbideDwhawg&rel=0
Interfaces de PI para sistemas de ejecución de batches y fabricación
PI Batch Framework 3.x y versiones posteriores pueden crear Event Frames en una base de
datos de PI AF u objetos de PI Batch en una base de datos de PI Batch. Para obtener mas
infórmación sobre la creación de marcos de evento y el uso de interfaces de PI para rellenar la
base de datos PI AF con datos basados en eventos, consulte:
286
Guía del usuario PI System Explorer
Event Frames en PI AF
• "Interfaces de PI para sistemas de ejecución de batches y fabricación" in Live Library
(https://livelibrary.osisoft.com)
• "Administrador de la interfaz de marcos de evento de PI" in Live Library (https://
livelibrary.osisoft.com)
Interfaces programables
Puede crear su propio programa personalizado con AF SDK y PI ACE para crear y supervisar
eventos.
Creación manual de marcos de evento
OSIsoft no recomienda en absoluto la creación y administración manual de marcos de evento y
recomienda que utilice PI Data Archive con el soporte de analisis basado en activos o PI Batch,
en función de las necesidades del proceso. Consulte ¿Event frames o batch?
Visualización de marcos de evento
Puede utilizar las herramientas cliente PI Datalink, PI Vision y PI WebParts para visualizar
marcos de evento. Tambien puede utilizar PI OLEDB Enterprise, PI JDBC Driver o PI Web
Services para integrar datos de event frames en otras herramientas de generación de informes
de terceros.
Nota:
PI ProcessBook, PI BatchView y PI Manual Logger actualmente no admiten la
visualización de event frames.
• PI Datalink
La compatibilidad de PI Datalink con event frames incluye explorar y comparar eventos
jerarquicós. Para obtener mas infórmación, consulte "Eventos en hojas de calculó" in Live
Library (https://livelibrary.osisoft.com).
• PI Vision
PI Vision permite ver y analizar datos de PI System durante el intervalo de tiempo de un
evento determinado. Por ejemplo, es posible que quiera examinar el rendimiento de un
activo durante el turno de un operador o comparar los datos de varios activos durante un
períódó de inactividad.
PI Vision es compatible con marcos de evento mediante el visor “Eventos relacionados”. Para
obtener mas infórmación, consulte "Analisis y cómparación de eventos" in Live Library
(https://livelibrary.osisoft.com).
• PI WebParts
PI WebParts no incluye funciones específicas relacionadas con la visualización de event
frames. Sin embargo, puede crear un conjunto de datos en función de un origen de datos
relacional que obtenga event frames mediante PI OLEDB Enterprise. Los datos de este event
frame se pueden mostrar en un elemento web de PI Table, por ejemplo, y utilizarlos para
proporcionar un contexto, como las horas de inicio y finalización, a los demas elementos
web de la pagina.
Plantillas de event frames
Mediante plantillas de event frames, puede definir y estandarizar los datos relacionados
(atributos de event frames) asociados con distintos tipos de evento. Para mantener la
Guía del usuario PI System Explorer
287
Event Frames en PI AF
uniformidad, se recomienda crear objetos de event frame a partir de plantillas. Para obtener
mas infórmación, consulte Plantillas base y derivadas. Puede utilizar atributos de event frames
para proporcionar un contexto adicional en torno al evento que resulta util en las busquedas y
los informes. Por ejemplo, los eventos de inactividad tienen con frecuencia un códigó de motivo
que es posible que los usuarios deseen buscar o filtrar durante el analisis de sus eventos de
inactividad.
Nota:
Los event frames no se pueden crear directamente a partir de plantillas marcadas como
Plantilla base únicamente (BTO). Se crea una plantilla derivada a partir de la plantilla
BTO y luego se crean event frames a partir de la plantilla derivada. Cuando se crea un
event frame basado en una plantilla derivada, este hereda todos los atributos de la
plantilla derivada y la plantilla BTO.
Tambien puede cónfigurar atributos de Event Frame para que hagan referencia a datos de
proceso en el contexto del evento. Por ejemplo, un evento de desviación de la temperatura es
probable que tenga un atributo para la temperatura maxima. Puede cónfigurar event frames
para registrar esos valores. Ademas, para cada tipo de evento, puede cónfigurar un índice para
los atributos buscados mas frecuentemente. Este enfoque agiliza y simplifica las busquedas en
el servidor de PI AF cuando hace el seguimiento de varios tipos de eventos o millones de
eventos.
Referencias de datos en plantillas de event frames
Cuando crea event frames dinamicamente con plantillas de event frames, normalmente tiene
que hacer referencia a elementos, atributos, plantillas u otros objetos relacionados en función
de esas plantillas de event frames. Dado que cada event frame individual se produce en un
contexto ligeramente diferente, puede utilizar parametrós de sustitución para hacer referencia
a otros objetos de PI AF dinamicamente, en lugar de referencias estaticas y absolutas. Por
ejemplo, puede utilizar una plantilla de marcos de evento de tiempo de inactividad para
cualquier cantidad de activos, como una bomba, un motor, una caldera, un compresor, etcetera.
En las referencias de datos de PI point, los parametrós de sustitución son utiles para realizar lo
siguiente:
• Crear referencias de nombre de tag en función de los valores de jerarquía u otros valores de
atributos.
• Hacer referencia a otros atributos de PI point, como desde un marco de evento hasta el
elemento de referencia primario.
La principal limitación de las referencias de datos de PI point es que el atributo de elementos
tambien debe ser una referencia de datos de PI point.
En las referencias de datos del generador de cadenas, los parametrós de sustitución son utiles
para realizar lo siguiente:
• Obtener valores numericós o valores de cadenas cuando los atributos de elementos de
referencia no tienen una referencia de datos de PI point.
• Crear una cadena mediante la cóncatenación de varios valores de los atributos de elementos
de referencia y otro texto.
• Pasar un contexto de tiempo, incluida la hora de finalización del marco de evento.
• Obtener el nombre de los elementos de referencia o sus primarios.
La limitación de las referencias de datos del generador de cadenas es que no realizan
conversiones de unidades de medida ni realizan agregados o calculós.
Se requiere una sintaxis específica para los atributos de referencia de las plantillas de marcos
de evento, como se describe en Referencias de datos a atributos en el elemento de referencia
primario y Referencias de datos a atributos en otros elementos.
288
Guía del usuario PI System Explorer
Event Frames en PI AF
Video
Para obtener infórmación sobre cómó cónfigurar las plantillas de marcos de evento, mire este
video:
https://www.youtube.com/watch?v=OgKaw9p4FA0&rel=0
Elementos referenciados primarios
Cada event frame hace referencia a uno o varios elementos. La pestana Elementos
referenciados del marco de evento enumera todos los elementos a los que hace referencia el
marco de evento. El principal elemento referenciado por el marco de evento se denomina
elemento referenciado primario y se indica mediante una marca de verificación en el icono de
elemento:
De manera predeterminada, el primer elemento referenciado que se agrega se cónfigura como
el elemento con referencia principal, pero usted puede cambiarlo al hacer clic con el bótón
secundario en otro elemento y seleccionar Establecer como referencia del elemento primario.
Nota:
Si elimina la referencia al elemento principal, PI System Explorer no establece
autómaticamente un nuevo elemento referenciado primario. Debe seleccionar
manualmente un nuevo elemento referenciado primario.
Referencias de datos a atributos en el elemento de referencia primario
En las referencias de datos de una plantilla de marco de evento, puede hacer referencia a un
atributo en el elemento de referencia primario de un marco de evento con la sintaxis:
.\Elements [.]|AttributeName
.
Indica el objeto actual, que es el marco de evento.
\Elements
Especifica la cólección de elementos del objeto
actual.
[.]
Indica el objeto predeterminado del objeto actual.
En este caso, se trata del elemento de referencia
del event frame.
|AttributeName
Especifica el nombre del atributo.
Por ejemplo, .\Elements [.]|Flowrate obtiene el valor del atributo Flowrate del
elemento de referencia primario.
Nota:
Esta sintaxis se usa principalmente para referencias de datos de PI point. Para obtener
mas infórmación sobre la asignación de valores estaticós a un atributo, consulte
Propiedad de atributo de elemento de cónfiguración, Definir valores constantes para las
plantillas de atributos y Crear atributos en event frames.
Referencias de datos a atributos en otros elementos
En las referencias de datos de una plantilla de event frame, puede hacer referencia a otros
elementos y atributos con los filtrós de cólección y las rutas relativas.
Ejemplos que utilizan filtros de colección
Puede hacer referencia a otros elementos y atributos con los filtrós de cólección que se
muestran en la siguiente tabla.
Guía del usuario PI System Explorer
289
Event Frames en PI AF
Filtro de
colección
Ejemplo
Explicación
@Category
.\Elements[@Category=MyCategory]
Obtiene el valor del primer
elemento de referencia que se
asigna a la categóría
MyCategory.
@Description .\Elements[@Description=My Description]
Obtiene el valor del primer
elemento de referencia que tiene
la descripción My Description.
@Index
.\Elements[@Index=3]
Obtiene el valor del tercer
elemento de referencia.
.\Elements[@Index=2]|FlowRate
Obtiene el valor del atributo
FlowRate del segundo elemento
de referencia.
.\Elements[@Name=Tank1]
Obtiene el valor del elemento
llamado Tank1.
@Name
Nota:
.\Elements[@Name=*2]|FlowRate
Puede
utilizar
comodines
con
@Name.
Obtiene el valor del atributo
FlowRate del primer elemento
de referencia cuyo nombre
finaliza en 2.
@ReferenceTy .\Elements[@ReferenceType=Area]
pe
Obtiene el valor del primer
elemento de referencia que
utiliza el tipo de referencia Area.
@Template
.\Elements[@Template=MyTemplate]
Obtiene el valor del primer
elemento de referencia que
utiliza la plantilla MyTemplate.
.\Elements[@Template=Pump Template]|
%attribute%
Obtiene el valor del atributo que
tiene el mismo nombre que el
atributo de este marco de evento
del primer elemento de
referencia que utiliza Pump
Template.
@Trait
.\Elements[@Name=Tank*]|
Attributes[@Trait=LoLo]
Obtiene el valor del atributo con
un rasgo de LoLo en el primer
elemento de referencia cuyo
nombre comienza con Tank.
@Type
.\Elements[@Name=Tank*]|
Attributes[@Type=System.Int32]
Obtiene el valor del primer
atributo que tiene un tipo de
valor de Int32 en el primer
elemento de referencia cuyo
nombre comienza con Tank.
@UOM
.\Elements[@Name=Tank*]|[@UOM=meter]
Obtiene el valor del primer
atributo que utiliza la unidad de
medida meter en el primer
elemento de referencia cuyo
nombre comienza con Tank.
Ejemplos que combinan filtros de colección
Tambien puede combinar los criterios del filtró de cólección, como se muestra en los siguientes
ejemplos:
290
Guía del usuario PI System Explorer
Event Frames en PI AF
Ejemplo
Explicación
.\Elements[@Name=*2][@Category=Pump]|FlowRate
Obtiene el valor del atributo
FlowRate del primer elemento
de referencia cuyo nombre
termina en 2 y cuya categóría de
elemento es Pump.
.\Elements[@Name=Pump*][@Template=Pump Template]|
FlowRate
Obtiene el valor del atributo
FlowRate del primer elemento
de referencia cuyo nombre
comienza con Pump y cuya
plantilla de elemento es Pump
Template.
.\EventFrames[@Template=Machine Template]|Pressure
Obtiene el valor del atributo
Pressure del primer Event
Frame secundario cuya plantilla
es Machine Template.
.\EventFrames[@Template=Machine Template][@Index=-1]| Obtiene el valor del atributo
Pressure
Pressure del Event Frame
secundario mas reciente cuya
o
plantilla es Machine Template.
.\EventFrames[@Template=Machine Template][-1]|
Nota:
Pressure
A partir de PI AF 2017,
puede usar un numeró
negativo para un índice
desde el final de una
cólección (por ejemplo: -1
indica el elemento final, -2
indica el penultimó
elemento).
El filtró @Index es opcional
si se especifica otro filtró
antes del filtró de índice.
Ejemplos que utilizan rutas relativas
Puede utilizar la sintaxis de ruta relativa para navegar por la jerarquía Elementos desde un
Event Frame y obtener otros valores de atributos. Por ejemplo, supongamos que tiene la
siguiente jerarquía de elementos:
En un Event Frame que tiene Production Line 1 como elemento de referencia primario,
puede obtener el valor del atributo Price asignado al elemento principal Unit 1 con la
siguiente sintaxis:
.\Elements[.]\..\|Price
Si el atributo Price estuviera dos niveles mas arriba en la jerarquía, debería utilizar:
.\Elements[.]\..\..|Price
Puede obtener el valor del atributo de PI Point Inflow asignado al elemento secundario Pump
1 con la siguiente sintaxis:
.\Elements[.]\Pump 1|Inflow
Guía del usuario PI System Explorer
291
Event Frames en PI AF
Si el elemento secundario Pump 1 estuviera basado en la plantilla de elementos Pump, debería
utilizar:
.\Elements[.]\[@Template=Pump]|Flow
Crea plantillas de event frames
Cree y cónfigure plantillas de event frames para garantizar definiciónes uniformes de los event
frames en su estructura de activos.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, haga clic en Plantillas de event frames.
3. Para crear una nueva plantilla de event frames, seleccione una de las siguientes acciones:
◦ En la barra de herramientas, haga clic en Nueva plantilla.
◦ Haga clic con el bótón secundario sobre Plantillas de event frames y haga clic en Nueva
plantilla.
◦ Haga clic con el bótón secundario del ratón en el panel Plantillas de event frames y haga
clic en Nueva plantilla.
4. En la pestana General de la ventana Propiedades de plantilla de event frames, introduzca un
nombre y una descripción exclusivos para la plantilla de event frames en los campos
Nombre y Descripción.
5. Ajuste valores en las pestanas para cónfigurar la plantilla de event frames. PI System
Explorer proporciona valores predeterminados para los valores obligatorios, pero puede
cónfigurar usted mismo esos valores. Los valores son:
Opción
Description
Plantilla base
Puede basar la plantilla en una plantilla de event frame existente, que se
selecciona en la lista desplegable. Para obtener mas infórmación sobre
plantillas base, consulte Plantillas base y derivadas.
Gravedad
Seleccione una cónfiguración de gravedad para event frames basados en la
plantilla. Puede seleccionar Ninguna (predeterminado), Información,
Advertencia, Menor, Mayor y Crítica.
Nota:
Los event frames ya creados con una cónfiguración de gravedad
específica no se actualizan autómaticamente si se cambia mas tarde
la cónfiguración Gravedad de una plantilla de event frame.
292
Categorías
Opcional. Para organizar plantillas de event frames, agrupelas en
categórías de elementos. Para ver las distintas categórías disponibles o
crear una nueva categóría, haga clic en
.
Atributo
predeterminado
Opcional. Una vez creados los atributos de la plantilla, pódra seleccionar un
atributo por defecto en la lista desplegable. Para obtener mas infórmación,
consulte Atributo predeterminado.
Guía del usuario PI System Explorer
Event Frames en PI AF
Opción
Description
Patrón de asignación
de nombres
Opcional. Puede introducir una cadena de texto o hacer clic en
para
elegir los parametrós de substitución de los siguientes con el fin de definir
un patrón de asignación de nombres.
◦ %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora de inicio local actual del objeto que usa el formato
especificadó. Si no se especifica un formato, se usa el
predeterminado. El formato utiliza cadenas de formato estandar
admitidas por el metódó DateTime.ToString, como se describe en
Cadenas de formato para parametrós de sustitución de hora.
◦ %UTCSTARTTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora de inicio del Tiempo Universal Coordinado (UTC) actual
del objeto que usa el formato especificadó. Si no se especifica un
formato, se usa el predeterminado.
◦ %TEMPLATE%
Es el nombre de la plantilla del objeto.
◦ %@Attribute%
Es el valor de la plantilla del atributo del objeto representado por la
ruta.
◦ %ELEMENT%
Es el nombre del elemento de referencia primario del event frame del
objeto.
◦ %ELEMENTDESCRIPTION%
Es la descripción del elemento de referencia primario del event frame
del objeto.
Tambien puede usar otros parametrós de substitución de patrón de
asignación de nombre. Por ejemplo, si desea que se incluya un nombre de
analisis de generación de event frame en el patrón de asignación de
nombre, ingrese %ANALYSIS% como parametró de substitución. Para
obtener una lista completa de los parametrós de sustitución de patrón de
asignación de nombre, consulte Patrones de asignación de nombres.
Cada elemento derivado de la plantilla tendra un nombre de identificación
unicó. Para asegurarse de que los nuevos elementos creados a partir de la
plantilla tengan un numeró incremental, introduzca * al final de cualquier
patrón que introduzca aquí.
Los patrones de asignación de nombres se evaluan de nuevo en un event
frame cuando se módifica la Hora de inicio, la Hora de finalización o el
elemento de referencia primario despues de que se creó. No se vólvera a
evaluar si se carga desde otra aplicación. Para obligar a un elemento o
event frame a que vuelva a evaluar su patrón de asignación de nombre,
haga clic en el bótón secundario en el objeto y haga clic en Volver a evaluar
el patrón de asignación de nombre.
Algunos parametrós de substitución no se pueden aplicar cuando se crea
un elemento derivado. Para asegurarse de que el nombre de un event
frame derivado refleje por completo el patrón de asignación de nombres,
haga clic con el bótón secundario en el event frame y, luego, clic en
Reevaluar el patrón de asignación de nombres.
Nota:
El nombre generado por el patrón de asignación de nombres debe
contener una cantidad de caracteres menor que la cantidad maxima
de 260 caracteres.
Si se deja en blanco, PI System Explorer utiliza las siguientes reglas:
◦ Los marcos de evento que se generan mediante analisis de
generación de marcos de evento utilizan un patrón de asignación de
nombres predeterminado de: %ANALYSIS% %STARTTIME:yyyy-MMdd HH:mm:ss.fff%
Guía del usuario PI System Explorer 293
◦ Los marcos de evento que se crean mediante otros metódós utilizan
el nombre de la plantilla de marco de evento y la fecha actual:
%TEMPLATE%yyyyMMdd
Event Frames en PI AF
Opción
Description
Permitir extensiones
Seleccione esta casilla de verificación para poder definir atributos
adicionales para un event frame distintos de los definidós en su plantilla.
Para obtener mas infórmación, consulte Extensiones.
Nota:
Las categórías, los analisis y las nótificaciónes no se veran afectados
si se habilita la casilla de verificación Permitir extensiones.
No se puede confirmar
Seleccione esta casilla de verificación para que los usuarios puedan
cónfirmar un event frame. Para obtener mas infórmación, consulte
Reconocimiento de event frames.
Nota:
Este ajuste solamente afecta los event frames creados despues de
crear o módificar una plantilla.
Plantilla base
únicamente
Seleccione esta casilla de verificación para asignar la propiedad Plantilla
base únicamente (BTO) a una plantilla de event frame. Un event frame no
se puede crear directamente desde una plantilla BTO. Para obtener mas
infórmación, consulte Plantillas base y derivadas.
Propiedades
extendidas
Este enlace es una característica avanzada. Para obtener mas infórmación,
consulte Almacenamiento de infórmación específica de la aplicación.
Ubicación
Haga clic en este enlace si desea especificar características del atributo de
motivo la plantilla de Event Frame. Para obtener mas infórmación, consulte
Cónfigurar características del atributo de ubicación.
Motivo
Haga clic en este vínculó si desea cónfigurar características del atributo de
razón para la plantilla de event frame de manera que los usuarios puedan
seleccionar códigós de motivo para tiempo de inactividad, excursiones y
otros eventos. Para obtener mas infórmación, consulte Cónfigurar
características del atributo de razón.
Seguridad
Haga clic en este vínculó si desea cónfigurar permisos de acceso
personalizados para la plantilla de event frames ademas de los que ya se
establecieron en el ambitó del servidor y de la base de datos. Para obtener
mas infórmación, consulte Cónfigurar la seguridad para objetos.
6. Utilice la pestana Plantillas de atributos para crear una plantilla de atributos para cada
propiedad o elemento de datos de la plantilla. Consulte Crear plantillas de atributos.
Cambiar plantillas de event frames
Puede cambiar la plantilla en la que se basa un event frame existente o anadir una plantilla a un
event frame que no base en una plantilla.
Antes de empezar
Tenga cuidado al cambiar un event frame, ya que puede haber consecuencias no deseadas. Por
ejemplo, es posible que se eliminen atributos si se definierón con la plantilla antigua y no se
encuentran presentes en la nueva. Asegurese de que los atributos con el mismo nombre de las
plantillas antigua y nueva tengan el mismo tipo de datos.
Procedimiento
1. En el navegador, haga clic en Event Frames.
2. En el navegador Event Frames, haga clic con el bótón secundario en la cólección Búsquedas
de event frames y luego haga clic en Nueva búsqueda.
3. En la ventana Búsqueda de event frames, introduzca los criterios para buscar el event frame
que desee cambiar.
294
Guía del usuario PI System Explorer
Event Frames en PI AF
4. Haga clic con el bótón secundario sobre el event frame adecuado y luego haga clic en
Convertir > Cambiar plantilla.
5. En la ventana Seleccionar plantilla de event frame, seleccione la plantilla que desee de la lista
Plantilla de event frame.
a. Opcional. Para mostrar solo las plantillas en una categóría específica, seleccione una
categóría de la lista Plantillas de categoría.
6. Haga clic en Aceptar.
Crea event frames.
Aunque normalmente se utilizan analisis de generación de event frames o PI Event Frames
Generator (PI EFGen) para crear event frames, tambien es posible crearlos manualmente. Sin
embargo, no resulta recomendable.
Procedimiento
1. En el navegador, seleccione Event Frames.
2. Para crear un nuevo event frame, seleccione una de las siguientes acciones:
◦ En la barra de herramientas, haga clic en Nuevo event frame.
◦ En el navegador Event Frames, haga clic con el bótón secundario en la cólección
Búsquedas de event frames y luego haga clic en Nuevo event frame.
◦ En el visor, haga clic con el bótón secundario en Nuevo > Nuevo event frame.
3. En la sección Plantilla de event frame de la ventana Seleccionar plantilla de event frame,
seleccione una plantilla de event frame y haga clic en Aceptar.
El nuevo event frame aparecera en el visor con cuatro pestanas para poder cónfigurarló.
4. En la pestana General, introduzca un nombre y una descripción exclusivos para el event
frame en los campos Nombre y Descripción.
5. Ajuste valores en las pestanas para cónfigurar el event frame. PI System Explorer
proporciona valores predeterminados para los valores obligatorios, pero puede cónfigurar
usted mismo esos valores. Los valores son:
Opción
Descripción
Plantilla
Muestra la plantilla que se ha seleccionado al
crear el event frame. Para ver las propiedades de
la plantilla, haga clic en
.
Gravedad
Seleccione una cónfiguración de gravedad para el
event frame. Puede seleccionar Ninguna
(predeterminado), Información, Advertencia,
Menor, Mayor y Crítica.
Hora de inicio
El valor predeterminado es la fecha y hora actual.
Pulse F2 o haga clic en
para abrir la ventana
Selector de fecha y hora, donde pódra seleccionar
una hora de inicio distinta.
Hora de finalización
El valor predeterminado es sin fecha ni hora.
para abrir la ventana
Pulse F2 o haga clic en
Selector de fecha y hora, donde pódra seleccionar
una hora de finalización distinta.
Guía del usuario PI System Explorer
295
Event Frames en PI AF
Categorías
Opcional. Puede organizar event frames
agrupandólós en categórías de elementos. Para
examinar las categórías disponibles, haga clic en
.
Atributo predeterminado
Opcional. Este campo es de solo lectura si el
event frame se basa en una plantilla. Una vez
creados los atributos del event frame en la
pestana Atributos, pódra seleccionar un atributo
por defecto en la lista desplegable. Para obtener
mas infórmación, consulte Atributo
predeterminado.
Propiedades extendidas
Este enlace es una característica avanzada. Para
obtener mas infórmación, consulte
Almacenamiento de infórmación específica para
cada aplicación.
Anotaciones
Haga clic en este vínculó si desea introducir un
comentario o anadir un archivo adjunto
específicó del event frame. Para obtener mas
infórmación, consulte Anadir anotaciones a event
frames.
Ubicación
Haga clic en este enlace si desea especificar
características del atributo de ubicación para el
Event Frame. Para obtener mas infórmación,
consulte Cónfigurar características del atributo
de ubicación.
Motivo
Haga clic en este vínculó si desea cónfigurar una
característica del atributo de razón para el event
frame. Para obtener mas infórmación, consulte
Cónfigurar características del atributo de razón.
Seguridad
Haga clic en este vínculó si desea cónfigurar
permisos de acceso personalizados para el event
frame ademas de los que ya se establecieron en el
ambitó del servidor y de la base de datos. Para
obtener mas infórmación, consulte Cónfigurar la
seguridad para objetos.
6. Opcional. Puede elegir una de las siguientes acciones, segun corresponda.
Opción
Descripción
Capturar valores
Para mejorar el rendimiento, puede guardar
valores de atributos de event frames en PI AF en
lugar de calcular y ejecutar referencias de datos.
Para obtener mas infórmación, consulte Captura
de valores para event frames y transferencias.
Bloquear
Una vez finalizada la acción subyacente de un
event frame, como la finalización de lotes, puede
hacer clic en este vínculó para impedir que se
módifique. Para obtener mas infórmación,
consulte Bloquear marcos de evento o
transferencias.
Nota:
Los event frames solo pueden
desbloquearlos usuarios que sean
administradores.
296
Guía del usuario PI System Explorer
Event Frames en PI AF
Confirmar
Si el event frame se basa en una plantilla con la
cónfiguración No se puede confirmar y los
derechos de acceso de anótación activados, haga
clic en este vínculó para indicar que ha
cónfirmadó el event frame. Para obtener mas
infórmación, consulte Reconocimiento de event
frames.
7. Módifique las pestanas restantes, segun sea necesario.
◦ Para agregar atributos, consulte Crear atributos en event frames.
◦ Para establecer un elemento de referencia primario, consulte Elementos referenciados
primarios.
Crear atributos en event frames
Cree atributos o event frames de la misma forma que en los elementos.
Procedimiento
1. En el navegador Marcos de evento, busque y seleccione el marco de evento principal.
2. En el visor, seleccione la pestana Atributos.
3. Si no existen atributos, haga clic en el vínculó Nuevo atributo. De manera alternativa, en la
barra de herramientas, haga clic en Nuevo atributo.
Nota:
Si el event frame se basa en una plantilla, no pódra anadir un atributo a menos que la
plantilla admita extensiones.
4. En el campo Nombre, introduzca un nombre exclusivo para el atributo.
5. En el campo Descripción, introduzca una descripción para el atributo.
6. En el campo Propiedades, seleccione propiedades de atributo segun proceda. Para obtener
mas infórmación, consulte Propiedades de atributos.
7. Opcional. En el campo Categorías, asigne el atributo a una categóría. Para examinar las
categórías disponibles, haga clic en .
8. En el campo Unidad de medida predeterminada, seleccione la unidad de medida del
atributo.
9. Seleccione el tipo de datos del atributo en el campo Tipo de valor.
10. Para asignar un valor al atributo, elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Introduzca un valor estaticó.
Introducir un valor en el campo Valor.
Derivar o calcular un valor a partir de una
referencia de datos
a. Seleccione un tipo de referencia de datos en
la lista Referencia de datos.
b. Haga clic en Ajustes para cónfigurar la
referencia de datos. Para obtener infórmación
sobre la cónfiguración de las referencias de
datos, consulte Cónfiguración de referencias
de datos.
11. Opcional. Cuando la ópción de sistema Usar DisplayDigits para valores de atributos y
plantillas de atributos esta seleccionada, es posible anular el valor de propiedad
predeterminado de DisplayDigits de -5 y especificar en el campo Mostrar dígitos la cantidad
de dígitós que se visualizara. Esto solamente repercute en los valores numericós del campo
Guía del usuario PI System Explorer
297
Event Frames en PI AF
Valor. Para los atributos que no tienen como base una plantilla, la precisión de las referencia
de datos de PI point se obtiene a partir del mismo PI point.
◦ Introduzca un numeró negativo hasta -20 para indicar la cantidad total de dígitós que se
visualizara.
◦ Introduzca un numeró positivo hasta 10 para indicar la cantidad de dígitós que se
visualizara despues del punto decimal, incluidos los ceros finales.
Para obtener mas infórmación, consulte Controlar la visualización de los valores de
atributos y plantillas de atributos y Opciones de persónalización de PI System Explorer.
12. Para guardar su trabajo, presione CTRL-G o haga clic en Ingresar.
Captura de valores para event frames y transferencias
Para mostrar valores de Event Frames o de una transferencia, PI AF ejecuta referencias de datos
para obtener valores de atributo asociados al períódó de tiempo. Sin embargo, puede utilizar
Capturar valores para guardar esos valores en una tabla de base de datos de PI AF
(AFEventFrameAttributeValue). Al hacerlo puede mejorar el rendimiento, puesto que es
mas rapidó mostrar los valores guardados que recuperarlos.
Tambien puede utilizar Capturar valores para asegurarse de que los valores de atributo
mostrados para Event Frames seran iguales en el futuro al valor que tenían cuando fueron
capturados. Ademas, Capturar valores proporciona una manera de conservar valores que es
posible que no esten disponibles en el futuro, como la transferencia de datos en streaming, que
no se mantiene a largo plazo.
Recapturar valores
La recapturación autómatica se produce cuando se módifica la hora de inicio y la hora de
finalización de un marco de evento o transferencia capturada.
Cada vez que agrega atributos nuevos a un marco de evento o transferencia, debe recapturar
valores para garantizar que estos tambien se capturen para los atributos nuevos.
Tenga en cuenta que, cuando recaptura valores, se puede producir la perdida de datos si la
referencia de datos se módificó desde la captura de valor inicial. Por ejemplo, si se módificarón
los valores de una tabla a la que tenía acceso la referencia de datos de busqueda de tabla.
Capturar valores
Captura valores para guardar los valores de event frames o de atributos de transferencias a una
tabla en la base de datos PI AF. Esto puede mejorar el rendimiento ya que PI AF no ejecuta
ninguna referencia de datos.
Nota:
Si agrega atributos nuevos a event frames o transferencias con valores capturados, debe
recapturar esos valores para asegurarse de que se capturen valores de los atributos
nuevos.
Procedimiento
1. En el navegador, haga clic en Event Frames.
2. En el navegador Event Frames, elija una de las siguientes acciones:
298
Guía del usuario PI System Explorer
Event Frames en PI AF
Para capturar valores para ...
Haga lo siguiente…
Todas las transferencias o event frames
principales de una cólección
a. Haga clic con el bótón secundario en una
busqueda o cólección reciente.
b. Haga clic en Capturar o recapturar valores.
En forma alternativa, lleve a cabo lo siguiente.
a. Haga clic en una busqueda o cólección
reciente.
b. En el visualizador, haga clic con el bótón
secundario debajo de la lista de event frames
o transferencias.
c. Haga clic en Capturar o recapturar valores.
Event frames secundarios en una cólección
a. Haga clic en una busqueda o cólección
reciente.
b. En el visor, haga clic en junto a cada event
frame para el cual desea capturar valores.
Se móstraran los event frames secundarios.
c. En el visor, utilice las teclas de selección de
Windows para seleccionar event frames y
event frames secundarios:
▪ Para seleccionar objetos continuos,
presione SHIFT+<click>.
▪ Para seleccionar objetos no continuos,
presione CTRL+<click>.
▪ Para seleccionar todos los objetos que
pueden mostrarse, presione CTRL+A.
d. Haga clic con el bótón secundario en un event
frame seleccionado.
e. Haga clic en Capturar o recapturar valores.
Un solo event frame
a. Expanda una busqueda o una cólección
reciente de event frame.
b. Seleccione el event frame.
c. Elija una de las siguientes acciones.
▪ En la pestana General, haga clic en el
vínculó Capturar valores.
▪ Haga clic con el bótón secundario y, luego,
haga clic en Capturar o recapturar valores.
Nota:
Para las capturas de valores subsiguientes,
el vínculó cambia a Recapturar valores.
Una sola transferencia
a. Expanda una busqueda o una cólección
reciente de transferencias.
b. Seleccione la transferencia.
c. Haga clic con el bótón secundario y, luego,
haga clic en Capturar o recapturar valores.
3. En la ventana Capturar o recapturar valores, compruebe el estado y haga clic en Cerrar.
Resultados
Se muestra el icono Tiene valores capturados ( ) en el visor junto a cada event frame o
transferencia que tenga un valor capturado.
Guía del usuario PI System Explorer
299
Event Frames en PI AF
Bloquear marcos de evento o transferencias
Despues de finalizada la acción de un event frame o transferencia (por ejemplo, tras finalizar un
batch), el event frame o la transferencia seguiran abiertos y pódran continuar recibiendo datos.
No obstante, los event frames o las transferencias se pueden bloquear para evitar cambios
posteriores en ellos.
Para desbloquear un event frame o una transferencia, se necesita disponer de permiso de
administrador. Solo los usuarios con este tipo de permiso sobre un objeto pódran
desbloquearlo.
Procedimiento
1. En el navegador, haga clic en Marcos de evento.
2. En el navegador Event Frames, abra la cólección Búsquedas de event frames (o Búsquedas
de transferencias) que contenga el objeto que desea bloquear.
3. Haga clic con el bótón secundario sobre el objeto y luego haga clic en Bloquear.
4. Para verificar que el objeto este bloqueado, seleccione el event frame o la cólección
busqueda de transferencias que contenga el objeto.
El objeto se muestra en el visor con
junto a la columna de Bloqueo.
Reconocimiento de event frames
En PI AF 2016 y versiones posteriores, es posible requerir que se efectue el reconocimiento de
un event frame. La función de reconocimiento es utilizada por las nótificaciónes y las PI AF
aplicaciones cliente, como PI Vision. La función de reconocimiento de event frames reemplaza
la funcionalidad de nótificación de reconocimiento en la versión heredada de Nótificaciónes.
• Para obtener mas infórmación sobre la cónfiguración del reconocimiento de event frames en
las nótificaciónes, consulte Cónfiguración de reglas de nótificación para analisis o event
frames.
• Para obtener mas infórmación sobre la visualización y la cónfirmación de event frames
utilizando PI Vision, consulte el tema PI Vision "Ver detalles del evento y anotar eventos" in
Live Library (https://livelibrary.osisoft.com).
Seguridad del reconocimiento de event frames
Todos los usuarios deberan tener una PI AF identidad con el permiso Anotar (an) habilitado.
Para obtener mas infórmación sobre derechos de acceso, consulte Derechos de acceso de PI AF.
Configuración del reconocimiento de event frames
Para cónfigurar el reconocimiento, seleccione la casilla No se puede confirmar cuando
cónfigure una plantilla de event frame. Todo marco de evento basado en esa plantilla móstrara
un vínculó Confirmar en la pestana General. En marcos de evento basados en plantillas de
marcos de evento que no tengan seleccionada la casilla No se puede confirmar, el vínculó
Acknowledge se encóntrara inactivo. Tampoco se puede efectuar el acuse de recibo de marcos
de evento no basados en una plantilla de marco de evento.
Nota:
El ajuste Se puede confirmar solamente afecta los Event Frames creados despues de crear
o módificar una plantilla.
300
Guía del usuario PI System Explorer
Event Frames en PI AF
Buscar reconocimientos de event frames
Es posible buscar marcos de evento que cuyo acuse de recibo pueda efectuarse, así como
aquellos en los que este se haya realizado. El estado de reconocimiento puede consultarse en el
visor de la cólección Búsquedas de event frames, donde se muestra la columna Cónfirmadó ( ).
Los valores posibles son los siguientes:
No esta cónfirmadó
Is acknowledged
en
blanco
No se puede cónfirmar
Para agrupar los event frames por estado de cónfirmación, haga clic en el icono de columna .
Realizar el acuso de recibo de event frames
La cónfirmación de los event frames se realiza en el navegador Event Frames o en la ficha
General de un event frame seleccionado en el visor de Event Frames .
Procedimiento
1. En el navegador, haga clic en Marcos de evento.
2. En el navegador Event Frames, haga clic en una cólección de Busqueda de Event Frame. El
contenido de la cólección se móstrara en el visor.
3. Opcional. Para agrupar los event frames por estado de cónfirmación, haga clic en el icono de
columna .
4. Elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Acuse de recibo de un event frame
a. Seleccione una de las siguientes acciones:
▪ Haga clic con el bótón secundario en un
event frame del visor y luego haga clic en
Acuse de recibo en el menu contextual.
▪ Haga doble clic en un event frame del
visor y, en la pestana General, haga clic en
el vínculó Acuse de recibo.
b. Haga clic en Sí como respuesta a la pregunta
¿Está seguro de que desea confirmar el
marco de evento Event_Frame_Name?
c. Se próduciran los siguientes cambios:
▪ En la cólección Busqueda de Event Frame
que se muestra en el visor, la columna
Cónfirmadó ( ) cambia al estado Aceptar.
▪ En la ficha General, el campo Confirmado
se muestra con una marca de tiempo y
fecha. El ID de usuario del usuario que
realizó el acuse de recibo se muestra en el
campo Por.
Guía del usuario PI System Explorer
301
Event Frames en PI AF
Revisar un acuse de recibo
a. En la cólección Busqueda de Event Frame que
se muestra en el visor, haga doble clic en un
event frame con el estado Aceptar ( ).
b. En la ficha General, consulte la marca de
tiempo y fecha del campo Confirmado,
ademas del ID de usuario del usuario que
haya realizado el reconocimiento.
Transferencias
Las transferencias son un tipo de marco de evento. Determinan el movimiento de materiales en
cantidades discretas. Tienen una hora de inicio y finalización. Las transferencias son exclusivas
de un modelo porque son temporales y solo aparecen en un modelo cuando se ha producido
una transferencia de materiales. Por ejemplo, utilice transferencias para realizar un
seguimiento de los movimientos de materiales dentro y fuera de las instalaciones, de las
materias primas utilizadas en el proceso y los productos acabados que se almacenan y de las
transferencias de materiales de tanque a tanque.
En esta sección
• Crear plantillas de transferencia
• Crear transferencias
• Crear puertos de transferencias
Crear plantillas de transferencia
Cree y cónfigure plantillas de transferencia para garantizar definiciónes uniformes de las
transferencias en su estructura de activos.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, haga clic en Plantillas de transferencia.
3. Para crear una nueva plantilla de transferencia, seleccione una de las siguientes acciones:
◦ En la barra de herramientas, haga clic en Nueva plantilla.
◦ En el panel Plantillas de transferencia, haga clic en Nueva plantilla.
◦ Haga clic con el bótón secundario en Plantillas de transferencia y haga clic en Nueva
plantilla.
4. En la pestana General de la ventana Propiedades de la plantilla de transferencia, introduzca
un nombre y una descripción exclusivos para la plantilla de transferencia en los campos
Nombre y Descripción.
5. Ajuste los valores en las pestanas para cónfigurar la plantilla de transferencia. PI System
Explorer proporciona valores predeterminados para los valores obligatorios, pero puede
cónfigurar usted mismo esos valores. Los valores son:
302
Opción
Description
Plantilla base
Puede basar la plantilla en una plantilla de transferencia existente, que se
selecciona en la lista. Para obtener mas infórmación sobre plantillas base,
consulte Plantillas base y derivadas.
Guía del usuario PI System Explorer
Event Frames en PI AF
Opción
Description
Categorías
Opcional. Para organizar plantillas de transferencia, agrupelas en
categórías de elementos. Para ver las distintas categórías disponibles o
crear una nueva categóría, haga clic en
.
Atributo
predeterminado
Opcional. Una vez creados los atributos de la plantilla, pódra seleccionar un
atributo por defecto en la lista. Para obtener mas infórmación, consulte
Atributo predeterminado.
Guía del usuario PI System Explorer
303
Event Frames en PI AF
Opción
Description
Patrón de asignación
de nombres
Opcional. Puede introducir una cadena de texto o hacer clic en
para
elegir los parametrós de substitución de los siguientes con el fin de definir
un patrón de asignación de nombres.
◦ %TIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora local actual del objeto que usa el formato especificadó. Si
no se especifica un formato, se usa el predeterminado. El formato
utiliza cadenas de formato estandar admitidas por el metódó
DateTime.ToString, como se describe en Cadenas de formato para
parametrós de sustitución de hora.
◦ %UTCTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora del Tiempo Universal Coordinado (UTC) actual del objeto
que usa el formato especificadó. Si no se especifica un formato, se usa
el predeterminado.
◦ %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora de inicio local actual del objeto que usa el formato
especificadó. Si no se especifica un formato, se usa el
predeterminado.
◦ %UTCSTARTTIME:yyyy-MM-dd HH:mm:ss.fff%
Es la hora de inicio del Tiempo Universal Coordinado (UTC) actual
del objeto que usa el formato especificadó. Si no se especifica un
formato, se usa el predeterminado.
◦ %TEMPLATE%
Es el nombre de la plantilla del objeto.
◦ %@Attribute%
Es el valor de la plantilla del atributo del objeto representado por la
ruta.
◦ %SOURCE%
Nombre del elemento de origen para la transferencia.
◦ %DESTINATION%
Nombre del elemento de destino para la transferencia.
Tambien puede usar otros parametrós de sustitución de patrón de
asignación de nombre. Para obtener una lista completa de los parametrós
de sustitución de patrón de asignación de nombre, consulte Patrones de
asignación de nombres.
Cada transferencia derivada de la plantilla tendra un nombre de
identificación unicó. Para asegurarse de que las nuevas transferencias
creadas a partir de la plantilla tengan un numeró incremental, introduzca *
al final de cualquier patrón que introduzca aquí.
Los patrones de nombres se evaluan de nuevo en una transferencia cuando
se módifica la Hora de inicio despues de que se creó. No se vólvera a
evaluar si se carga desde otra aplicación. Para obligar a una transferencia a
que vuelva a evaluar su patrón de nombres, haga clic con el bótón
secundario en el objeto y haga clic en Reevaluar el patrón de nombres.
Es posible que algunos parametrós de sustitución no se apliquen cuando se
crea una transferencia derivada. Para asegurarse de que el nombre de una
transferencia derivada refleje completamente el patrón de nombres, haga
clic con el bótón secundario en la transferencia y haga clic en Reevaluar el
patrón de nombres.
Nota:
El nombre generado por el patrón de nombres debe contener una
cantidad de caracteres menor que la cantidad maxima de 260
caracteres.
304
Si se deja vacíó, PI System Explorer usa el nombre de la plantilla de
Guía del usuario PI System Explorertransferencia y la fecha actual: %TEMPLATE%yyyyMMdd
Event Frames en PI AF
Opción
Description
Permitir extensiones
Seleccione esta casilla para poder definir atributos adicionales para una
transferencia, distintos de los definidós en su plantilla. Para obtener mas
infórmación, consulte Extensiones.
Nota:
Las categórías no se veran afectadas si se habilita la casilla Permitir
extensiones.
Plantilla base
únicamente
Seleccione esta casilla de verificación para asignar la propiedad Plantilla
base únicamente (BTO) a una plantilla de transferencia. Las plantillas BTO
solo se pueden utilizar para crear plantillas derivadas. No se pueden crear
transferencias directamente desde las plantillas BTO. Para obtener mas
infórmación, consulte Plantillas base y derivadas.
Propiedades
extendidas
Este enlace es una característica avanzada. Para obtener mas infórmación,
consulte Almacenamiento de infórmación específica para cada aplicación.
Motivo
Haga clic en este enlace si desea cónfigurar una característica del atributo
de motivo para la plantillas de transferencia. Para obtener mas
infórmación, consulte Cónfigurar características del atributo de razón.
Seguridad
Haga clic en este enlace si desea cónfigurar los permisos de acceso
personalizado para la plantilla de transferencia mas alla de los que ya se
establecieron a nivel del servidor y de la base de datos. Para obtener mas
infórmación, consulte Cónfigurar la seguridad para objetos.
6. Utilice la pestana Plantillas de atributos para crear una plantilla de atributos para cada
propiedad o elemento de datos de la plantilla. Consulte Crear plantillas de atributos.
7. Opcional. Use la pestana Puertos para definir puertos adicionales que definan puntos finales
para las conexiones entre elementos de la transferencia, o para módificar los puertos
predeterminados de Entrada y Salida. Consulte Crear puertos de transferencias.
Crear transferencias
Las transferencias se crean en el navegador Event Frames.
Antes de empezar
Los puertos de transferencia predeterminados de Entrada y Salida con tipos de cónexión de
Límite y Nodo se crean autómaticamente para cada transferencia.
Procedimiento
1. En el navegador, haga clic en Marcos de evento.
2. En el navegador Event Frames, haga clic en la cólección Búsquedas de transferencias (o
Transferencias recientes).
3. Para crear una nueva transferencia, seleccione una de las siguientes acciones:
◦ En la barra de herramientas, haga clic en el bótón Nueva transferencia.
◦ En el navegador Event Frames, haga clic con el bótón secundario en la cólección
Búsquedas de transferencias y luego haga clic en Nueva transferencia.
◦ En el visor, haga clic con el bótón secundario y luego haga clic en Nueva transferencia.
4. En la ventana Seleccione plantilla de transferencia, elija una plantilla existente para la
transferencia. Aunque no se recomienda, tambien puede elegir <None>.
a. Opcional. Par asignar la transferencia a una categóría, seleccione una de la lista Plantillas
de categoría.
5. Haga clic en Aceptar.
Guía del usuario PI System Explorer
305
Event Frames en PI AF
La nueva transferencia aparecera en el visor con tres pestanas para poder cónfigurarla. En la
pestana General, se móstrara un nombre predeterminado para la nueva transferencia segun
el patrón de nombres, así como una hora de inicio predeterminada.
6. Opcional. Sustituya el nombre predeterminado por un nombre unicó e introduzca una
descripción para la transferencia en los campos Nombre y Descripción.
7. Opcional. Puede organizar los objetos agrupandólós en categórías. Para examinar las
categórías disponibles, haga clic en . Consulte Categórización de objetos si desea mas
infórmación.
8. En los campos Hora de inicio y Hora de finalización introduzca las horas de inicio y
finalización de realización de la transferencia. Para examinar una fecha, haga clic en
.
9. En los campos Origen y Puerto, seleccione el elemento y el puerto que proporcionan el
material de la transferencia.
10. En los campos Destino y Puerto, seleccione el elemento y el puerto que reciben la
transferencia.
11. Si la transferencia se basa en una plantilla, aparecera un valor de solo lectura en el campo
Atributo por defecto. Sin embargo, si crea una transferencia manualmente, puede
seleccionar un atributo por defecto despues de anadir atributos en la pestana Atributos.
12. Opcional. Para anadir una anótación a la transferencia, haga clic en Anotaciones. Para
obtener mas infórmación, consulte Anadir anotaciones a transferencias.
Qué hacer a continuación
Si esta seleccionada la casilla Permitir extensiones en la plantilla de transferencia o si crea una
transferencia manualmente, siga estos pasos adicionales.
• Use la pestana Atributos para definir un atributo para cada propiedad o elemento de datos.
Consulte Crear plantillas de atributos.
• Use la pestana Puertos para definir puertos adicionales que definan puntos finales para las
conexiones entre elementos de la transferencia, o para módificar los puertos
predeterminados de Entrada y Salida. Para obtener mas infórmación, consulte Crear
puertos de transferencias.
Crear puertos de transferencias
Use la pestana Puertos para revisar los ajustes de los puertos de transferencia Entrada y Salida.
Antes de empezar
Solamente puede módificar o anadir puertos para una transferencia que derive de una plantilla
si esta habilitada la ópción Permitir extensiones en la plantilla de transferencia.
Procedimiento
1. Para crear un nuevo puerto de transferencia o revisar puertos existentes, seleccione una de
las siguientes acciones:
◦ En el navegador Marcos de evento, expanda una cólección de Búsquedas de
transferencias. Seleccione una transferencia o haga clic con el bótón secundario en una
transferencia y haga clic en Propiedades.
◦ En el navegador Biblioteca, expanda Plantillas de transferencia. Seleccione una plantilla
de transferencia o haga clic con el bótón secundario en una plantilla y haga clic en
Propiedades.
2. Haga clic en la pestana Puertos.
306
Guía del usuario PI System Explorer
Event Frames en PI AF
3. Elija una de las siguientes acciones.
Para…
Haga lo siguiente…
Crear un nuevo puerto
a. Seleccione una de las siguientes acciones.
▪ En la barra de herramientas, haga clic en Nuevo puerto.
▪ Haga clic con el bótón secundario en el visor y haga clic en
Nuevo puerto.
b. Seleccione una de las siguientes acciones. Consulte
Propiedades de la pestana Puertos de transferencia para
conocer las descripciones de los valores requeridos.
▪ Edite los valores en las columnas Puertos directamente.
▪ Haga clic con el bótón secundario en el puerto y haga clic
en Propiedades. Introduzca los valores y haga clic en
Aceptar para guardar los cambios.
Módificar un puerto existente
Seleccione una de las siguientes acciones. Consulte Propiedades de
la pestana Puertos de transferencia para conocer las descripciones
de los valores requeridos.
◦ Edite los valores en las columnas Puertos directamente.
◦ Haga clic con el bótón secundario en el puerto y haga clic en
Propiedades. Edite los valores y haga clic en Aceptar para
guardar los cambios.
Especificar un puerto
predeterminado
a. Haga clic con el bótón secundario en un puerto con el icono
.
b. Seleccione Ajustar como puerto predeterminado.
Módificar un puerto
predeterminado
a. Haga clic con el bótón secundario en un puerto con el icono
.
b. Seleccione Propiedades.
c. En la ventana Propiedades de puerto, anule la selección de la
casilla de verificación Puerto predeterminado.
d. Haga clic en Aceptar.
4. Registre los cambios.
Propiedades de la pestaña Puertos de transferencia
La pestana Puertos de una transferencia contiene las siguientes columnas.
Campo
Description
Nombre
El nombre del puerto.
Descripción
Opcional. La descripción del puerto.
Tipo de puerto
Indica el tipo de puerto: Entrada, Salida o No dirigido (para medidores, por
ejemplo).
Categorías permitidas
Las categórías a las que pertenece el puerto. Para asignar categórías, haga clic
en
y seleccione las categórías en la ventana Categorizar.
Conexiones máximas
La cantidad maxima de conexiones que se pueden establecer para el puerto.
El valor predeterminado de conexiones para una transferencia es 1. Un valor
cero indica una cantidad ilimitada de conexiones.
Tipo de conexión
El tipo de conexiones a las que puede conectarse el puerto. Los tipos de
conexiones predeterminados para una transferencia son Límite y Nodo. Para
obtener mas infórmación sobre los valores de tipos de cónexión, consulte
Tipos de elementos de los modelos.
Guía del usuario PI System Explorer
307
Event Frames en PI AF
308
Campo
Description
Plantilla permitida
El valor predeterminado es todas las plantillas de elementos, pero puede
seleccionar una plantillas específica de la lista.
Guía del usuario PI System Explorer
Anotaciones en PI AF
A partir de PI AF 2016, las aplicaciones cliente como PI Vision utilizan la función de anótación,
aunque los administradores pueden utilizarla facilmente para hacer anotaciones en los
siguientes objetos:
• Caso
• Element
• Event frame
• Modelo
• Transferencia
Archivos adjuntos
Los usuarios pueden adjuntar un unicó archivo a una anótación. De forma predeterminada, se
permiten los siguientes tipos de archivos:
Tipo de archivo
Extensión permitida
MS Office
csv, docx, pdf, xlsx
Texto
rtf, txt
Imagen
gif, jpeg, jpg, png, svg, tiff
ProcessBook
pdi
El tamanó de archivo maximó predeterminado es de 10 MB.
Los administradores pueden utilizar el Utilidad de diagnósticó de PI AF (afdiag que se
encuentra en la carpeta \PIPC\AF) para especificar los tipos de archivo que se pueden
adjuntar a las anotaciones (con el parametró FileExtensions), así como el tamanó de archivo
maximó (con el parametró FileMaxLength).
Seguridad de las anotaciones
Todos los usuarios deberan tener una PI AF identidad con el permiso Anotar (an) habilitado.
Para obtener mas infórmación sobre derechos de acceso, consulte Derechos de acceso de PI AF.
En esta sección
• Anotaciones de elementos
• Anotaciones de event frames
• Anotaciones de transferencias
Anotaciones de elementos
Los usuarios pueden anotar un elemento, ademas de cargar un archivo para vincular a una
anótación.
Configuración de anotaciones de elementos
Para cónfigurar una anótación, abra una ventana Anotaciones de un elemento específicó que
haya seleccionado en el navegador o visor Elementos. En la ventana Anotaciones, puede anadir,
editar y eliminar anotaciones, ademas de cargar, cambiar y eliminar un archivo adjunto de una
anótación.
Guía del usuario PI System Explorer
309
Anotaciones en PI AF
Consultar anotaciones de elementos
Puede consultar el estado de las anotaciones de un elemento en el visor Elementos, donde
aparece una columna Anotado ( ).
Para ver el contenido de una anótación, mueva el cursor del ratón sobre el icono de junto a un
elemento para ver el texto de la anótación. Si se adjunta un archivo, tambien se móstrara su
nombre.
Añadir anotaciones a elementos
Es posible anadir una o varias anotaciones a un elemento.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, elija una de las siguientes acciones.
◦ Haga clic en la cólección de Elementos.
◦ Desplacese al elemento específicó que desea anotar.
3. Para anadir una nueva anótación, seleccione una de las siguientes acciones.
◦ En el navegador Elementos, haga clic con el bótón secundario en el elemento y haga clic
en Anotar.
◦ Si se selecciona un elemento en el navegador Elementos, haga clic en el vínculó
Anotaciones en la pestana General del visor.
◦ Si se selecciona la cólección de Elementos en el navegador, haga clic con el bótón
secundario en un elemento del visor y luego haga clic en Anotar.
Nota:
Para anadir otra anótación a un elemento anteriormente anotado en el visor, haga
doble clic junto a este.
4. En la ventana Anotaciones, haga clic en Nueva anotación.
5. Introduzca una anótación en el campo Comentario.
Nota:
Si necesita mas espacio al escribir, pulse F2 e introduzca una anótación en la ventana
Visualizador de texto. Haga clic en Aceptar para cerrar la ventana.
6. Para adjuntar un archivo a la anótación, haga clic en Agregar adjunto.
a. En la ventana Abrir, vaya al directorio donde se encuentre el archivo que desea cargar.
b. Seleccione el archivo y haga clic en Abrir.
El nombre de archivo se muestra en el campo Adjunto.
7. Haga clic en Cerrar.
Resultados
Cuando los elementos se enumeran en el visor Elementos, se muestra la columna Anotados
junto al elemento. Mueva el cursor sobre el icono para ver el texto de la anótación. Si se adjunta
un archivo, tambien se móstrara su nombre.
310
Guía del usuario PI System Explorer
Anotaciones en PI AF
Anotaciones de event frames
Los usuarios pueden anotar un event frame, ademas de cargar un archivo para vincular a una
anótación.
Configuración de anotaciones de event frames
Para cónfigurar una anótación, abra una ventana Anotaciones de un event frame específicó que
haya seleccionado en el navegador o en el visor Event Frames. En la ventana Anotaciones, puede
anadir, editar y eliminar anotaciones, ademas de cargar, cambiar y eliminar un archivo adjunto
de una anótación.
Buscar anotaciones de event frames
Puede buscar event frames que se hayan anotado. El estado de anótación puede consultarse en
el visor de la cólección Búsquedas de event frames, donde se muestra la columna Anotado ( ).
Para agrupar event frames por estado de anótación, haga clic en el icono de columna .
Añadir anotaciones a event frames
Es posible anadir una o varias anotaciones a un event frame.
Antes de empezar
Para anotar un event frame bloqueado, antes es necesario que un usuario con permisos de
administrador lo desbloquee.
Procedimiento
1. En el navegador, haga clic en Event Frames.
2. En el navegador Event Frames, haga clic en una cólección de Búsqueda de Event Frames. El
contenido de la cólección se móstrara en el visor. Junto a los event frames que tienen
anotaciones aparece el icono Anotados ( ).
3. Para anadir una nueva anótación, seleccione una de las siguientes acciones.
◦ En el visor, haga clic con el bótón secundario en un event frame y luego haga clic en
Anotar.
◦ En el visor, haga doble clic en un event frame y luego haga clic en el vínculó Anotaciones
en la pestana General.
◦ En el navegador Event Frames, haga clic con el bótón secundario en un event frame de
una cólección de event frames y haga clic en Anotar.
◦ Para anadir otra anótación a un event frame anteriormente anotado, haga doble clic
junto a el.
4. En la ventana Anotaciones, haga clic en Nueva anotación.
5. Introduzca una anótación en el campo Comentario.
Nota:
Si necesita mas espacio al escribir, pulse F2 e introduzca una anótación en la ventana
Visualizador de texto. Haga clic en Aceptar para cerrar la ventana.
6. Para adjuntar un archivo a la anótación, haga clic en Agregar adjunto.
a. En la ventana Abrir, vaya al directorio donde se encuentre el archivo que desea cargar.
b. Seleccione el archivo y haga clic en Abrir.
Guía del usuario PI System Explorer
311
Anotaciones en PI AF
El nombre de archivo se muestra en el campo Adjunto.
7. Haga clic en Cerrar.
Resultados
En la columna Anotados, se muestra junto al event frame. Mueva el cursor sobre el icono para
ver el texto de la anótación. Si se adjunta un archivo, tambien se móstrara su nombre.
Anotaciones de transferencias
Los usuarios pueden anotar una transferencia, ademas de cargar un archivo para vincular a una
anótación.
Configuración de anotaciones de transferencias
Para cónfigurar una anótación, abra una ventana Anotaciones de una transferencia específica
que haya seleccionado en el navegador o en el visor Marcos de evento. En la ventana
Anotaciones, puede anadir, editar y eliminar anotaciones, ademas de cargar, cambiar y eliminar
un archivo adjunto de una anótación.
Consultar anotaciones de transferencias
El estado de anótación puede consultarse en el visor de la cólección Búsquedas de
transferencias, donde se muestra la columna Anotado ( ).
Para agrupar transferencias por estado de anótación, haga clic en el icono de columna .
Añadir anotaciones a transferencias
Es posible anadir una o varias anotaciones a una transferencia.
Procedimiento
1. En el navegador, haga clic en Event Frames.
2. En el navegador Event Frames, haga clic en una cólección de Búsqueda de transferencia. El
contenido de la cólección se móstrara en el visor. Junto a las transferencias que tienen
anotaciones aparece el icono Anotados ( ).
3. Para anadir una nueva anótación, seleccione una de las siguientes acciones.
◦ En el visor, haga clic con el bótón secundario en una transferencia de la lista de resultados
de busqueda y luego haga clic en Anotar.
◦ En el visor, haga doble clic en una transferencia y luego haga clic en el vínculó
Anotaciones de la pestana General.
◦ En el navegador de Event Frames, haga clic con el bótón secundario en una transferencia
de una cólección de Búsqueda de transferencia y luego haga clic en Anotar.
◦ Para anadir otra anótación a una transferencia anteriormente anotada, haga doble clic
junto a ella.
4. En la ventana Anotaciones, haga clic en Nueva anotación.
5. Introduzca una anótación en el campo Comentario.
Nota:
Si necesita mas espacio al escribir, pulse F2 e introduzca una anótación en la ventana
Visualizador de texto. Haga clic en Aceptar para cerrar la ventana.
6. Para adjuntar un archivo a la anótación, haga clic en Agregar adjunto.
312
Guía del usuario PI System Explorer
Anotaciones en PI AF
a. En la ventana Abrir, vaya al directorio donde se encuentre el archivo que desea cargar.
b. Seleccione el archivo y haga clic en Abrir.
El nombre de archivo se muestra en el campo Adjunto.
7. Haga clic en Cerrar.
Resultados
En la columna Anotados, se muestra junto a la transferencia. Mueva el cursor sobre el icono
para ver el texto de la anótación. Si se adjunta un archivo, tambien se móstrara su nombre.
Guía del usuario PI System Explorer
313
Anotaciones en PI AF
314
Guía del usuario PI System Explorer
Análisis basados en activos
El analisis basado en activos es la función en PI Asset Framework (PI AF) que se usa para crear
y administrar los analisis. Un analisis lee los valores de atributos de PI AF, realiza calculós, y
escribe resultados para otros atributos. Dentro de PI System Explorer, puede acceder al analisis
basado en activos cuando trabaja con elementos y plantillas de elementos.
En esta sección
• Intróducción a los analisis
• Analisis de expresiones
• Analisis de resumen
• Analisis de generación de marcos de evento
• Analisis de SQC
• Analisis de ejemplo
• Rellenado y recalculó de analisis
• Gestión de analisis en la base de datos de PI AF
• Referencia de funciones de expresión
• Funciones del vapor para expresiones de analisis
• Administración de PI Analysis Service
Introducción a los análisis
Un analisis realiza calculós en un horario determinado. El analisis toma valores de atributos de
PI AF existentes como entradas y genera nuevas salidas, ya sean nuevos valores calculados o
nuevos event frames. Cada analisis tiene un elemento o elemento de plantilla asociado.
Los siguientes tipos de analisis estan disponibles:
• Expresión
Calcula uno o mas valores de salida a partir de las funciones, los operadores y los valores de
entrada especificadós.
• Resumen
Calcula funciones estadísticas estandar para un grupo de atributos seleccionados. Este
grupo se selecciona de los atributos de un elemento o del conjunto de todos los atributos de
sus subelementos.
• Generación de Event Frame
Inicia o finaliza event frames basandóse en las condiciones especificadas.
• SQC
Utiliza metódós de control de calidad estadísticó (SQC) para monitorear que los valores de
atributo permanezcan dentro de los límites predeterminados.
Todos los analisis pueden crearse a partir de plantillas de analisis con el estado Enabled o
Disabled; de forma predeterminada, los analisis se habilitaran cuando se creen. Para crear un
analisis con el estado Disabled, asegurese de desactivar la casilla de verificación Habilitar
análisis cuando se crea desde una plantilla en la plantilla de analisis.
Guía del usuario PI System Explorer
315
Análisis basados en activos
Para los analisis de generación de marcos de evento y los analisis de SQC con salidas de marcos
de evento, puede crear una plantilla de regla de nótificación haciendo clic en Create a new
notification rule template for (Crear una nueva plantilla de regla de notificación para) Analysis
Template Name.
Para los analisis de expresiones y los analisis de generación de marcos de evento, especifique
las entradas en expresiones.
Para los analisis de generación de event frame (que tienen instalado PI Analysis Service 2017
R2 o versiones posteriores), analisis de expresión y de rollup, puede asignar salidas de analisis
a los atributos de PI AF. Si asigna salidas a atributos cónfiguradós como referencias de datos de
PI point, el analisis guarda el historial de la salida para un PI point. OSIsoft recomienda que
guarde las salidas de analisis para los PI point. Puede utilizar PI point en herramientas de
visualización para ver la tendencia del analisis. Guardar salidas para los PI point tambien
permite lograr un mejor rendimiento de PI AF que al guardar salidas para los atributos sin
referencias de datos.
Nota:
PI Analysis Service no utiliza informes de excepciones mientras escribe en salidas
cónfiguradas como referencias de datos de PI point. Aunque no se utilicen ajustes de
excepciones para el PI Point de salida, se utilizaran ajustes de cómpresión para el PI Point
de salida con el fin de determinar que salidas se escriben en PI Data Archive.
A partir de PI AF 2018 SP2, los analisis respetaran los dígitós mostrados que se cónfigurarón en
un atributo o en una plantilla de atributos. Los valores que visualiza cuando evalua un analisis
u obtiene la vista previa de los resultados móstraran el mismo numeró de dígitós que el
atributo de salida siempre que haya asignado el atributo de salida. Para obtener mas
infórmación, consulte Controlar la visualización de los valores de atributos y plantillas de
atributos.
En esta sección
• Cónfigurar y administrar analisis en un elemento
• Plantillas de analisis
• Actualización de analisis y plantillas de analisis
• Atributos excluidos en analisis
• Prógramación de analisis
• Expresiones para analisis
• Analisis y datos futuros
Configurar y administrar análisis en un elemento
Un analisis recien creado aparece en la tabla de la pestana Análisis. Puede ver su estado actual,
si esta asociado o no con una plantilla, su tipo de analisis, nombre y estado de rellenado o
recalculó. Pase el puntero del ratón sobre los elementos o los iconos de la lista para ver su
infórmación sobre herramientas. Para administrar varios analisis en el panel Administración,
consulte Administración de analisis.
Para ver la expresión y prógramación de un analisis, seleccióneló en el visor Análisis.
Puede realizar estas operaciones en el visor Análisis:
• Crear un análisis
Puede hacer clic en (New Analysis [Nuevo analisis]) en la parte superior del visor, o hacer
clic con el bótón secundario en cualquier parte del visor y luego hacer clic en Nuevo.
316
Guía del usuario PI System Explorer
Análisis basados en activos
• Habilitar o deshabilitar un análisis seleccionado
Puede seleccionar un analisis y hacer clic en (Enable Analysis [Habilitar analisis]) o
(Disable Analysis [Deshabilitar analisis]) en la parte superior del visor.
• Seleccionar columnas para mostrar
Puede hacer clic con el bótón secundario en cualquier encabezado de columna y seleccionar
encabezados para mostrar.
• Vista previa de resultados
Puede obtener una vista previa de los resultados de un analisis para ver cómó funciona a lo
largo de un intervalo de tiempo especificadó al hacer clic con el bótón secundario sobre un
analisis y seleccionar Vista previa de resultados. Puede exportar la tabla de resultados a una
hoja de calculó o copiar las filas seleccionadas de la tabla de resultados a otras aplicaciones.
Para obtener infórmación sobre cómó ver graficós de tendencias de tiempos de salida
especificadós como relativos para tiempos de activación, consulte Graficós de tendencias en
Vista previa de resultados.
• Reponer o recalcular datos de un análisis
Para rellenar o recalcular los datos, puede ejecutar un analisis durante un periodo de tiempo
anterior, como se describe en Reponer o recalcular datos de un analisis.
Un analisis de expresión, resumen o SQC puede rellenar o recalcular datos si las salidas de
analisis se asignan a atributos de PI point. Puede rellenar los datos faltantes en un rango de
tiempo y conservar los datos existentes, o puede recalcular, lo que elimina y recalcula los
datos en el rango de tiempo.
Un analisis de generación de marcos de evento tambien puede recalcular marcos de evento
durante un periodo especificadó. Sin embargo, el proceso de recalculó elimina
autómaticamente todos los event frames existentes para ese períódó, así como anotaciones
sobre event frames afectados.
Para rellenar/recalcular, necesita permiso de ejecución sobre los analisis. El permiso
adecuado se puede obtener mediante la asignación de su cuenta a la identidad de Asset
Analytics Recalculation. Tenga en cuenta que el recalculó solo esta disponible para PI
Analysis Service 2016 R2 o una versión posterior. Ademas, PI Data Archive que almacena PI
points debe ejecutar la versión 2016 R2 o una versión posterior.
• Habilitar el recálculo automático para un análisis
En PI AF 2017 R2, los analisis pueden recalcularse autómaticamente. Si bien el recalculó
autómaticó esta habilitado a nivel general de manera predeterminada, tiene que elegir en el
nivel de analisis individual (plantilla) si espera datos que llegan mas tarde o fuera de orden
que puedan activar un recalculó.
Si un analisis aparece en la lista con , significa que el recalculó autómaticó esta habilitado.
Consulte Cónfigurar el recalculó autómaticó de analisis y plantillas de analisis si desea mas
infórmación.
• Ir a la plantilla
Un analisis detallado con se basa en una plantilla de analisis. Puede abrir la plantilla
directamente desde el analisis al hacer clic con el bótón secundario sobre el analisis y, luego,
hacer clic en Ir a plantilla.
Nota:
Puede ir directamente al analisis desde el atributo al hacer clic con el bótón
secundario en el atributo y, luego, hacer clic en Ir al análisis. Si no hubiera un analisis
cónfiguradó en el atributo, aparecera la ópción Análisis nuevo.
Guía del usuario PI System Explorer
317
Análisis basados en activos
• Evento de pista de auditoría
Puede abrir el registro de auditóría directamente desde el analisis al hacer clic con el bótón
secundario sobre el analisis y, luego, hacer clic en Eventos de pista de auditoría. Para
obtener mas infórmación sobre pistas de auditóría, consulte Seguimiento de los cambios en
PI AF con pista de auditóría.
• Restablecer a plantilla
Solo se pueden realizar cambios de prógramación en un analisis que se base en una plantilla
de analisis. Para revertir la prógramación de un analisis, haga clic con el bótón secundario
en el analisis y luego haga clic en Restablecer a plantilla.
• Convertir a plantilla
Si el elemento de un analisis deriva de una plantilla de elementos, pódra convertir el analisis
en una plantilla de analisis en esa plantilla de elementos al hacer clic con el bótón
secundario sobre el analisis y seleccionar Convertir a plantilla. Esta función permite crear y
depurar un analisis en relación con un elemento específicó antes de generalizarlo como
plantilla.
Nota:
Si alguna de las salidas de analisis escribe en un PI point específicó, se le sólicitara que
elija cómó especificar el PI point en la plantilla de analisis para garantizar que las
salidas de los analisis derivados escriban en PI points unicós.
Para crear tipos específicós de analisis, consulte:
• Crear un analisis de expresiones
• Crear un analisis de resumen
• Crear un analisis de generación de marcos de evento
• Crear un analisis de SQC
Plantillas de análisis
Para aplicar un analisis a un elemento, especifique el elemento directamente al crear el analisis.
Sin embargo, para aplicar un analisis a un grupo de elementos (creados a partir de la misma
plantilla de elementos), es mucho mas eficaz utilizar una plantilla de análisis que aplicar el
analisis de forma individual a cada elemento.
Las plantillas de analisis definen el formato de un analisis. Los analisis derivados de ellas seran
similares, pero tendran atributos de entrada y de salida específicós. Las plantillas de analisis
permiten aprovechar las ventajas de la jerarquía de PI AF. Todos los elementos derivados de
una plantilla de elementos adquieren autómaticamente los analisis de sus plantillas de analisis.
Cree una plantilla de analisis en una plantilla de elementos siguiendo el mismo procedimiento
que cuando se crea un analisis en un elemento. Cuando anada o módifique una plantilla de
analisis en una plantilla de elementos, esos cambios se própagaran a todos los elementos
derivados de la plantilla de elementos. Al eliminar una plantilla de analisis, borra todos los
analisis derivados de ella, excepto los analisis vinculados a las nótificaciónes.
Con PI Server 2015 R2 y versiones posteriores, al crear una plantilla de analisis en una plantilla
de elementos derivada de una plantilla base de elemento, es posible seleccionar atributos de
entrada definidós como derivados y como plantillas base de elemento. Analógamente, puede
asignar salidas de analisis a atributos de plantilla base y derivados.
Nota:
Un analisis derivado de una plantilla de analisis no puede ser eliminado de un elemento
directamente.
318
Guía del usuario PI System Explorer
Análisis basados en activos
Para crear tipos específicós de plantillas de analisis, consulte:
• Crear una plantilla de analisis de expresiones
• Crear una plantilla de analisis de resumen
• Crear una plantilla de analisis de generación de marcos de evento
• Crear una plantilla de analisis de SQC
Actualización de análisis y plantillas de análisis
Tan pronto como se inserta un analisis, se activa de forma autómatica y esta disponible para
ejecutarse. Cualquier cambio que se inserte es captado de forma inmediata por todos los
analisis a los que afecta, incluso cuando se estan ejecutando. Los cambios que pueden afectar a
un analisis incluyen:
• Ediciones realizadas directamente en el analisis.
• Cambios en un elemento que afectan sus analisis, incluso la adición o eliminación de un
analisis.
• Cambios en una plantilla de elementos, que se propagan a todos los elementos que
provengan de esa plantilla, incluso la adición o eliminación de una plantilla de analisis.
• Cambios en una plantilla de analisis, que se propagan a todos los analisis que provengan de
la plantilla.
• Cambios en una plantilla de marcos de evento utilizados por un analisis; los nuevos marcos
de evento se basan en la plantilla actualizada.
Atributos excluidos en análisis
En PI Asset Framework 2015, se introdujeron los atributos excluidos. Para obtener mas
infórmación sobre los atributos excluidos, consulte Propiedad de atributo apagado. A partir de
PI AF 2018, el comportamiento y el manejo de los atributos excluidos cambiaron en terminós
de expresión, generación de Event Frames y analisis SQC.
Antes de 2018, los analisis cónfiguradós con atributos excluidos devólvían el valor Error de
cálculo despues de la evaluación y fallaban. A partir de PI AF 2018, dichos analisis se
suspenderan y se marcaran con un icono ( ) en el Visor de análisis. Si pasa el mouse sobre el
icono vera un tooltip con mas infórmación.
Si no desea que se suspendan los analisis con atributos excluidos, puede validar el atributo
excluido con una función de expresión BadVal. Suponiendo que 'att1' sea un atributo excluido,
en el ejemplo que figura a cóntinuación, BadVal pódría usarse para evitar que se suspenda el
analisis. En este caso, el analisis cóntinuara ejecutandóse:
If BadVal('att1') Then ('att2') Else ('att1' + 'att2)
Nota:
PI Analysis Service detecta autómaticamente cualquier cambio en la cónfiguración del
atributo excluido en el analisis. Por ejemplo, si decide cambiar la propiedad de 'att1' para
que no se excluya mas y registrar el cambio, el servicio lo detectara y ejecutara el analisis
con 'att1.'
Cuando selecciona Desencadenada por eventos como una ópción de prógramación, debe
seleccionar una entrada de activación. Tenga en cuenta que, si el atributo excluido es la unica
entrada de activación disponible, se suspendera el analisis aunque lo valide con BadVal. Esto
sucede porque los analisis no activan atributos excluidos. Asegurese de tener otras entradas
para activar en el analisis. Para obtener mas infórmación, consulte Prógramación de analisis.
Guía del usuario PI System Explorer
319
Análisis basados en activos
Programación de análisis
Cada analisis requiere que usted especifique la prógramación. La prógramación indica cuandó
evaluar un analisis de forma autómatica. Existen dos tipos de prógramación:
• Periódica
Con la prógramación periódica, la evaluación se produce basandóse en la hora de reloj.
Puede especificar una hora determinada para la evaluación de cada día o el tiempo que
transcurre entre las evaluaciones. Con PI Server 2015 R2 y versiones posteriores, la
frecuencia maxima que se puede definir para los analisis es de 120 veces por segundo.
Nota:
◦ Si existiesen analisis anteriormente cónfiguradós para ejecutarse a mas de 120
veces por segundo, debera reducir el períódó a menos del maximó permitido pues,
de lo contrario, estos generaran errores al ejecutarse con PI Server 2015 R2.
Analógamente, si va a establecer programaciones periódicas fuera de la interfaz de
usuario de PI System Explorer, asegurese de que el períódó se establezca en un
valor inferior al maximó permitido.
◦ Si el períódó no puede dividirse exactamente cada 7 minutos en 24 horas, por
ejemplo, la hora de evaluación se restablecera al comienzo de cada día. Imagine que
prógramó el analisis para que se ejecute cada 7 minutos y la ultima evaluación fue a
las 11:56 p. m. La próxima evaluación se realizara a la medianoche (4 minutos
despues) y no a las 12:03 a. m. del siguiente día.
• Desencadenada por eventos
Con la prógramación desencadenada por eventos, la evaluación se produce basandóse en
eventos. Puede especificar uno o mas atributos de entrada que desencadenen una
evaluación siempre que el valor del atributo cambie.
Nota:
Cuando esta activado el rellenado autómaticó, se ignoran los eventos activadores con
marcas de tiempo anteriores a la hora de inicio del servicio de analisis a efectos de la
evaluación en tiempo real. Para obtener mas infórmación sobre la evaluación en
tiempo real y la repósición autómatica, incluida la cónfiguración del parametró de
cónfiguración de AutoBackfillingEnabled, consulte Cónfiguración del servicio de
analisis.
De forma predeterminada, los analisis utilizan la prógramación desencadenada por eventos,
que se desencadena de acuerdo a los cambios que se realizan en las entradas.
Muchos factores afectan la velocidad en la que un analisis ejecuta y escribe los valores de
salida:
• Arquitectura del sistema, incluidas las entradas y salidas
• Cónfiguración de red
• Carga y rendimiento de los diferentes equipos
Supervise y pruebe sus analisis; en particular, aquellos que son programados en frecuencias
altas, para garantizar que los recursos del sistema respalden la cónfiguración.
Marcas de tiempo de salida para los análisis
Para los analisis programados, la marca de tiempo predeterminada para los valores de salida es
la hora de activación. Para la prógramación periódica, la hora de activación es la hora de
320
Guía del usuario PI System Explorer
Análisis basados en activos
evaluación programada, y para la prógramación activada por eventos, la hora de activación es la
hora en que un atributo especificadó cambia valores.
Puede especificar la marca de tiempo de los valores de salida de los analisis. Al especificar la
marca de tiempo de salida, puede:
• Producir resultados con marca de tiempo en una cómpensación especificada de la hora de
activación.
• Producir resultados con marca de tiempo en una hora particular del día, sin importar
cuandó se evalua realmente el analisis. Por ejemplo, puede fijar una marca de tiempo a las
6:00 p. m. para la salida de un analisis que calcula resultados para un turno de próducción
diario que finaliza a las 6:00 p. m., incluso si el analisis no se evalua realmente hasta las
10:00 p. m.
• Evaluar un analisis repetidas veces para calcular un valor de previsión para una hora y fecha
particulares, a medida que cambian las condiciones de entrada. Los resultados de cada
evaluación tienen la misma marca de tiempo: los valores de salida del analisis reflejan los
resultados de la evaluación mas reciente.
Especificar la marca de tiempo para las salidas de análisis
Utilice la ventana Opciones avanzadas en un analisis para especificar la marca de tiempo de los
valores de salida del analisis.
Procedimiento
1. En el navegador Elementos, seleccione un elemento y, en el visor, haga clic en la pestana
Análisis.
2. Seleccione un analisis de la lista y luego haga clic en Avanzadas en el area de prógramación
cerca de la parte inferior de la ventana.
3. En la ventana Opciones avanzadas, especifique la marca de tiempo de la salida:
◦ Hora de activación
Valor predeterminado. La hora de reloj que especifica un programa o que un valor de
entrada módifica.
◦ Hora de ejecución
La hora de reloj en la que el analisis calcula el valor. Esto difiere de la hora de activación
cuando el sistema tiene una hora retrasada o cuando hay un tiempo de espera del calculó
cónfiguradó (consulte CalculationWaitTimeInSeconds en Cónfiguración del servicio
de analisis).
◦ Relativa a la hora de activación
Una hora especificada por una expresión de tiempo de PI. Introduzca una expresión de
tiempo valida, como un tiempo relativo a la hora de activación o un tiempo fijó. En la
expresión, la hora actual y la hora de referencia implícita es la hora de activación (es
decir, la hora de reloj que especifica el programa o en la que un valor de entrada cambia).
Si ingresa una hora fija, todos los valores de salida del analisis tendran la marca de
tiempo ingresada. Cuando no esta especificada, la unidad de medición predeterminada
para el tiempo relativo es la hora.
Para obtener infórmación sobre cómó ver graficós de tendencias de tiempos de salida
especificadós como relativos para tiempos de activación, consulte Graficós de tendencias
en Vista previa de resultados.
◦ Variable
Guía del usuario PI System Explorer
321
Análisis basados en activos
Use el valor de una variable como marca de tiempo de salida. Variable debe ser una
marca de tiempo del tipo de valor datetime. Si este valor se calcula a partir de una
expresión, PI Analysis Service usa el valor calculado para cada evento del activador como
la marca de tiempo de salida. Esta ópción esta disponible solamente para analisis de
expresiones.
Puede crear una vista previa de los resultados haciendo clic con el bótón secundario en el
analisis y seleccionando Vista previa de resultados. Para obtener mas infórmación,
consulte Graficós de tendencias en Vista previa de resultados.
Gráficos de tendencias en Vista previa de resultados
Cuando hace clic con el bótón derecho en una expresión o rollup analyses y selecciona la Vista
previa de los resultados, puede ver el graficó de tendencia con los valores de atributos de
entrada y de salida a diferentes horas de activación.
Si selecciona Relativa a la hora de activación y especifica, por ejemplo, “*-8h” como marca de
tiempo de salida, se muestran dos graficós de tendencias, uno para la entrada y otro para la
salida. El graficó de entrada muestra el mismo intervalo de tiempo que la hora de inicio y
finalización cónfigurada; sin embargo, el graficó de salida muestra la hora que se calcula
mediante la anulación de la marca de tiempo de salida respecto a la hora de activación. Cada
graficó de tendencias muestra un maximó de cuatro atributos de entrada y cuatro de salida;
actualmente, los atributos de entrada y de salida que se muestran en el graficó los selecciona
autómaticamente PI Analysis Service.
En la tabla, la columna Tiempo de salida indica el tiempo de salida calculado con el calculó de
intervalo de tiempo.
Nota:
Los graficós de Vista previa de resultados pueden representar datos que difieran de los
resultados reales de PI Analysis Service. Por ejemplo, si los mismos datos de marca de
tiempo se sobrescriben varias veces, la tabla y los graficós de Vista previa de resultados
muestran cada valor escrito del punto de datos, pero PI Analysis Service solo utiliza el
ultimó valor escrito.
Expresiones para análisis
Para los analisis de expresiones y los analisis de generación de marcos de evento, usted
especifica las entradas y los calculós en expresiones. En PI System Explorer, introduce cada
expresión en una fila. Cada fila tiene las siguientes columnas:
• Nombre
El nombre de una variable para el valor calculado por la fila. Esta variable es interna del
analisis. Puede utilizar esta variable como una entrada para expresiones especificadas por
filas posteriores en el analisis.
• Expresión
La especificación de un calculó realizado. La expresión puede incluir atributos de PI AF,
variables de filas anteriores del analisis y funciones.
• Valor en la evaluación
El valor calculado actual de la expresión. Haga clic en Evaluar para calcular nuevamente.
• Valor en el último desencadenante
El valor en el que se cómputó el ultimó desencadenante.
322
Guía del usuario PI System Explorer
Análisis basados en activos
• Atributo de resultado
Para los analisis de expresiones, el atributo que almacena el valor calculado. Si el analisis
contiene multiples expresiones, puede asignar el valor de cualquier expresión a un atributo
de resultado. Sin embargo, debe asignar por lo menos una expresión a un atributo de
resultado.
Por ejemplo, un analisis de expresiones puede contener una expresión, especificada en una sola
fila.
Nombre
Expresión
Valor en la
evaluación
Atributo de resultado
Variable1
PrevVal('Att1') - 100
505
Analysis1_Output
Tambien puede especificar el calculó de un analisis con multiples expresiones en diversas filas.
Por ejemplo, un analisis puede contener tres expresiones: las primeras dos calculan variables
V1 y V2, que se utilizan como entradas para la ultima expresión.
Nombre
Expresión
V1
'Att1'/2
V2
'Att2' - 'Att3'
Result
V1 + 3*V2
Los analisis con multiples expresiones evaluan las expresiones en orden: primero la fila
superior, luego la siguiente, etc. Debido a que las expresiones de las filas inferiores pueden
depender de los resultados de las filas superiores, puede cambiar el orden de las filas para
evaluarlas en el orden adecuado.
Puede hacer clic en Añadir nueva variable para anadir una fila y en el icono
para eliminarla.
Consejo:
• Puede anadir un salto de línea dentro de la expresión presionando las teclas Shift
+Intro.
• Puede facilitar la lectura de las expresiones mediante la adición de comentarios junto a
una expresión o dentro de esta. Utilice la barra doble (//) para introducir un
comentario o colocar el comentario entre la barra y el asterisco (/*), y el asterisco y la
barra (*/).
// Add comments here
IF x THEN y ELSE /*Do this if x is false*/ z
En esta sección
• Especificación de las expresiones
• Simplificación de una expresión con la refactórización
Especificación de las expresiones
Para crear una expresión, haga clic en la columna Expresión de una fila y especifique los
atributos de entrada, las variables y las funciones que definen un calculó. Puede hacer lo
siguiente:
Guía del usuario PI System Explorer
323
Análisis basados en activos
• Seleccionar e insertar atributos y funciones en la expresión desde Funciones y Atributos, y
los paneles a la derecha de la expresión.
• Ingresar el texto directamente en la expresión. A medida que escriba, las funciones, los
atributos y las variables que coincidan con el texto que escribió apareceran en una lista de
selección en el punto donde este el cursor y pódra seleccionar el elemento que desee
insertar.
Las expresiones de tiempo y los atributos se incluyen entre comillas simples.
Las cadenas se incluyen entre comillas dobles.
Simplificación de una expresión con la refactorización
En las aplicaciones del mundo real, la expresión de un analisis puede ser extremadamente
compleja y los nombres de atributo largos pueden contribuir a aumentarla. Para simplificar
una expresión complicada, refactórícela como un grupo de expresiones mas pequenas
asignadas a variables.
Los analisis refactorizados son mas faciles de comprender. El analisis refactorizado tambien es
mas facil de probar y depurar, ya que permite evaluar de forma simultanea las expresiones mas
pequenas para aislar un error.
Para refactorizar un analisis, defina los componentes del analisis como expresiones separadas y
haga referencia por nombre de la variable. Por ejemplo, puede definir una expresión separada
que defina un nombre de atributo largo como una variable separada o que defina un calculó
particular como una variable separada. Para crear estas expresiones separadas, solo debe
agregar nuevas filas de expresiones al analisis e introducir texto en las columnas Nombre y
Expresión.
Para reducir la escritura, puede seleccionar un terminó en una expresión, hacer clic con el
bótón secundario sobre la selección y hacer clic en Asignar a variable. En la fila sobre la
expresión, PI System Explorer inserta una nueva fila que asigna el terminó seleccionado al
nombre de una nueva variable. En la expresión original, PI System Explorer reemplaza el
terminó con el nombre de la nueva variable.
Pódra editar el nombre de cualquier fila. Sin embargo, si cambia el nombre de una fila de
expresión que se utiliza como variable en otras expresiones, rómpera la cónexión entre ellas.
Ejemplo
Suponga que tiene una expresión compleja definida en una sola fila:
Nombre
Expresión
Variable1
2*'LongAttributeName' + Avg('Att2', 'Att3', 'Att4')
Puede refactorizar la expresión en las siguientes tres filas que contengan expresiones mas
sencillas. Tenga en cuenta que la tercera fila usa los nombres de las filas anteriores como
variables.
324
Nombre
Expresión
Variable1
'LongAttributeName'
Variable2
Avg('Att2', 'Att3', 'Att4')
Variable3
2*Variable1 + Variable2
Guía del usuario PI System Explorer
Análisis basados en activos
Análisis y datos futuros
Puede utilizar datos futuros como entradas de un analisis. Tambien puede utilizar un analisis
para producir datos futuros al especificar una marca de tiempo futura para el resultado de un
analisis.
Las expresiones pueden utilizar valores de eventos futuros como entradas de un analisis. Sin
embargo, si un analisis utiliza prógramación activada por eventos, las entradas con datos
futuros pueden generar evaluaciones de analisis. Si un atributo de activación tiene eventos
futuros, una evaluación ocurre a medida que cada evento entra en vigor, cuando la hora del
reloj coincide con la hora del evento.
Las siguientes secciones muestran dos usos de datos futuros en analisis. El primer ejemplo
muestra cómó utilizar datos futuros como entradas de un analisis. El segundo ejemplo muestra
cómó utilizar un analisis para producir datos futuros.
Ejemplo: Datos futuros de entrada para evaluar valores de previsión
Supongamos que necesita evaluar valores de previsión para la temperatura exterior
proporcionada por un servicio de terceros. Para hacerlo, cree un analisis que encuentre las
diferencias entre los valores de previsión y los reales.
El analisis necesita dos atributos de entrada:
• ActualTemp
Almacena lecturas de temperatura de un termómetró exterior casi en tiempo real.
• ForecastTemp
Almacena datos futuros; en este caso los valores de previsión para la temperatura exterior
todos los días a las 6 a. m., 2 p. m. y 10 p. m.
El analisis calcula la diferencia entre los valores ActualTemp y ForecastTemp y escribe los
resultados en un atributo de resultado denominado DeltaTemp.
Elija una prógramación activada por eventos para el analisis con el atributo ForecastTemp
como el unicó atributo de entrada de activación. Con la prógramación activada por eventos, se
lleva a cabo una evaluación cuando el analisis detecta un nuevo evento para un atributo de
activación. Debido a que este atributo de activación almacena datos futuros, el analisis detecta
un nuevo evento tres veces por día, cuando la hora del reloj marca las 6 a. m., 2 p. m. y 10 p. m.;
esto activa una evaluación y un nuevo resultado para el atributo DeltaTemp.
Ejemplo: Datos futuros de resultado para calcular metas de emisiones semanales
Supongamos que necesita fijar metas semanales para las emisiones de una planta de cemento
que funciona bajo una capacidad anual voluntaria de CO2 . Es probable que la meta semanal
cambie todas las semanas en respuesta a los niveles reales de emisión de la semana anterior y a
la cantidad restante de la capacidad anual voluntaria.
Al finalizar cada semana, cónócera las emisiones reales desde el comienzo del anó y pódra
calcular una nueva meta de emisiones semanal. Querra que la marca de tiempo para la nueva
meta sea exactamente a una semana de la hora del calculó, que coincide con la hora del calculó
de las emisiones reales para la semana siguiente.
En PI AF, cree atributos para los parametrós que requieren los calculós, como la capacidad
anual.
A cóntinuación, cree un nuevo analisis de expresión que calcule un atributo de resultado
denominado WeeklyGoal. El analisis completa los siguientes pasos:
Guía del usuario PI System Explorer
325
Análisis basados en activos
1. Encuentre las emisiones reales desde el comienzo del anó.
2. Encuentre la diferencia entre el total anual hasta la fecha y la capacidad anual.
3. Divida la diferencia por la cantidad de días restantes de la capacidad anual y multiplíqueló
por siete para calcular el atributo WeeklyGoal.
4. Guarde el atributo WeeklyGoal como un PI point de datos futuros, que preserva el historial
y permite la generación de tendencias y otros usos.
Cuando crea el analisis, elija la prógramación periódica para todos los días a las 12:00 a. m. La
sintaxis del analisis garantiza que los calculós solo se ejecuten los domingos.
Por ultimó, especifique la marca de tiempo para los resultados del analisis. Introduzca la
expresión * + 7d para establecer la marca de tiempo exactamente a siete días de la hora de
activación. El atributo WeeklyGoal tendra una marca de tiempo que es una semana en el
futuro (es decir, el siguiente domingo a las 12:00 a. m.)..
Análisis de expresiones
El analisis de expresiones calcula uno o mas valores de resultado a partir de las funciones, las
operaciones y los valores de entrada especificadós. Usted especifica las entradas y los calculós
para estos analisis en expresiones. Puede asignar cualquier resultado que una expresión calcula
a un atributo. Debe asignar por lo menos un resultado a un atributo.
Puede asignar el resultado a un atributo existente o puede crear un nuevo atributo cuando
asigna el resultado. Si crea un nuevo atributo cuando asigna el resultado (desde la pestana
Análisis en PI System Explorer), debe decidir si guardara el historial de resultados o no lo hara;
el sistema crea el tipo de atributo apropiado:
• Si elige guardar el historial de resultados, el sistema crea un atributo con una referencia de
datos de PI point y crea un PI point en el PI Data Archive especificadó. Con el resultado
guardado en un PI point, puede utilizar herramientas de visualización para ver la tendencia
asociada con el calculó, y puede recuperar el valor para cualquier hora que el analisis realizó
el calculó. El analisis calcula y almacena un valor como se especifica por el programa de
analisis.
• Si elige no guardar el historial de resultados, PI System Explorer crea un atributo con una
referencia de datos del analisis. Un analisis solamente calcula el valor para expresiones
asignadas a atributos con una referencia de datos de analisis cuando se lo solicita. Para
obtener un mejor rendimiento, asigne los atributos de resultado a atributos con referencias
de datos de analisis si solamente necesita conocer el valor mas reciente y no necesita los
valores anteriores.
En esta sección
• Crear una plantilla de analisis de expresiones
• Crear un analisis de expresiones
Crear una plantilla de análisis de expresiones
En PI System Explorer, puede crear una plantilla de analisis de expresiones para una plantilla
de elementos. En la plantilla, puede crear una expresión para cada calculó. Para registrar el
valor que una expresión calcula, asigne la salida a una plantilla de atributos. Puede crear
nuevas plantillas de atributos a partir de la plantilla de analisis de expresiones.
326
Guía del usuario PI System Explorer
Análisis basados en activos
Antes de empezar
Determine los valores de salida que desea calcular y guardar. Identifique las funciones, los
operadores y los atributos de entrada necesarios para los calculós.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, seleccione la plantilla de elementos en la que desea crear la
plantilla de analisis.
3. En el visor, haga clic en la pestana Plantillas de análisis.
La pestana muestra todas las plantillas de analisis ya definidas para la plantilla de
elementos.
4. Cree una nueva plantilla de analisis para la plantilla de elementos:
◦ Si no existe ninguna plantilla de analisis, haga clic en Crear nueva plantilla de análisis
para crear la primera.
◦ De lo contrario, haga clic en Nueva plantilla de análisis
para crear una nueva.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en Expresión.
6. Opcional. Desactive la casilla de verificación Habilitar análisis cuando se crea desde una
plantilla para que el analisis se cree en el estado Disabled.
De forma predeterminada, los nuevos analisis se crean con el estado Enabled. Si no desea
iniciar el analisis cuando se crea, borre esta ópción.
7. Opcional. Para evaluar temporalmente expresiones en la plantilla de analisis segun los
valores de un elemento en particular, haga clic en el vínculó Seleccionar un elemento de
ejemplo y seleccione un elemento en función de la plantilla de elementos actual. Si no se han
creado elementos a partir de la plantilla de elementos actual, primero debe crear un
elemento.
Las plantillas no tienen datos concretos asociados con sus atributos. Es imposible evaluar
una expresión en una plantilla de analisis, excepto tomando prestados atributos de valor de
un determinado elemento para ello.
PI System Explorer cónfigura un elemento de ejemplo para el elemento que selecciónó.
8. Especifique una o mas expresiones para el analisis.
Introduzca cada expresión en una fila. Una expresión especifica entradas y calculós.
Consulte Expresiones para analisis.
9. Asigne al menos una expresión a una plantilla de atributos de salida.
Guía del usuario PI System Explorer
327
Análisis basados en activos
a. En la columna Atributo de salida de la expresión, haga clic en Asignar.
b. Especifique la plantilla de atributos.
Para…
Haga lo siguiente…
Asignar la salida a una plantilla de atributos
existente
Haga clic en el nombre de la plantilla de
atributos.
Seleccione una plantilla de atributos con una
referencia de datos de PI Point para guardar el
historial del calculó. Para un mejor rendimiento
cuando no requiere un historial, utilice una
plantilla de atributos con una referencia de
analisis de datos.
Asignar la salida a una nueva plantilla de
atributos
a. Haga clic en Nueva plantilla de atributos para
abrir la ventana Propiedades de plantilla de
atributos.
b. Indique si el atributo debe guardar el
historial de la salida:
▪ Haga clic en Sí para crear un atributo con
una referencia de datos de PI Point. Este
atributo guarda el historial de la salida.
▪ Haga clic en No para crear un atributo con
una referencia de datos de analisis. Este
atributo calcula un nuevo valor cuando se
solicita.
c. Cónfigure la plantilla de atributo para crear:
▪ Nombre
Nombre del atributo creado.
▪ Descripción
Texto opcional que describe al atributo.
▪ Servidor de datos
Para atributos que guardan el historial de
salida, el servidor de PI Data Archive que
guarda la referencia de datos de PI Point.
De forma predeterminada, esto se
establece en %Server%, lo cual se
establece en el servidor de PI Data
Archive predeterminado.
▪ Tipo de valor
El tipo de datos que el atributo guarda.
Despues de crear la plantilla de atributos,
puede refinar su definición en la pestana
Plantillas de atributos.
d. Haga clic en Aceptar para crear la plantilla de
atributos.
10. Opcional. Si especificó un elemento de ejemplo, haga clic en Evaluar para verificar los
valores de salida de las expresiones individuales.
11. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
12. Opcional. Si especificó un elemento de ejemplo, verifique el analisis al revisar los resultados
obtenidos con los datos históricós:
328
Guía del usuario PI System Explorer
Análisis basados en activos
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
13. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas.
en la barra de
14. Haga clic en Ingresar en la barra de herramientas para guardar la plantilla de analisis en el
servidor de PI AF y para crear el analisis de cualquier elemento segun la plantilla de
elementos.
Crear un análisis de expresiones
En PI System Explorer, puede crear un analisis de expresiones unicas para un elemento
individual. En el analisis, puede crear una expresión para cada calculó. Para registrar el valor
que una expresión calcula, asigne la salida a un atributo. Puede crear nuevos atributos al
cónfigurar un analisis.
Antes de empezar
Determine los valores de salida que desea calcular y guardar. Identifique las funciones, los
operadores y los atributos de entrada necesarios para los calculós.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, seleccione el elemento en el que desea crear el analisis.
3. En el visor, haga clic en la pestana Análisis.
La pestana muestra todos los analisis ya definidós para el elemento.
4. Cree un nuevo analisis para el elemento:
◦ Si no existe ningun analisis, haga clic en Crear nuevo análisis para crear el primero.
◦ De lo contrario, haga clic en Nuevo análisis
para crear uno nuevo.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en Expresión.
6. Especifique una o mas expresiones para el analisis.
Introduzca cada expresión en una fila. Una expresión especifica entradas y calculós.
Consulte Expresiones para analisis.
7. Asigne al menos una expresión a un atributo de salida:
Guía del usuario PI System Explorer
329
Análisis basados en activos
a. En la columna Atributo de salida de la expresión, haga clic en Asignar.
b. Especifique el atributo.
Para…
Haga lo siguiente…
Asignar la salida a un atributo existente
Haga clic en el nombre del atributo.
Seleccione un atributo con una referencia de
datos de PI Point para guardar el historial del
calculó. Para un mejor rendimiento cuando no
requiere un historial, utilice un atributo con una
referencia de datos de analisis.
Asignar la salida a un nuevo atributo
a. Haga clic en Nuevo atributo para abrir la
ventana Propiedades de atributos.
b. Indique si el atributo debe guardar el
historial de la salida:
▪ Haga clic en Sí para crear un atributo con
una referencia de datos de PI Point. Este
atributo guarda el historial de la salida.
▪ Haga clic en No para crear un atributo con
una referencia de datos de analisis. Este
atributo calcula un nuevo valor cuando se
solicita.
c. Cónfigure el atributo:
▪ Nombre
Nombre del atributo creado.
▪ Descripción
Texto opcional que describe al atributo.
▪ Servidor de datos
Para atributos que guardan el historial de
salida, el servidor de PI Data Archive que
guarda la referencia de datos de PI Point.
De forma predeterminada, esto se
establece en %Server%, lo cual se
establece en el servidor de PI Data
Archive predeterminado.
▪ Tipo de valor
El tipo de datos que el atributo guarda.
Despues de crear el atributo, puede refinar su
definición en la pestana Atributos.
d. Haga clic en Aceptar para crear el atributo.
8. Opcional. Haga clic enEvaluar para comprobar los valores de salida en las horas de Última
activación y Evaluación.
9. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
10. Opcional. Para comprobar el analisis, revise los resultados obtenidos con los datos
históricós:
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
330
Guía del usuario PI System Explorer
Análisis basados en activos
11. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas. Esta acción no ejecuta el analisis.
en la barra de
12. Haga clic en Ingresar en la barra de herramientas.
PI System Explorer guarda y registra su analisis, y luego comienza a ejecutar el analisis.
Análisis de resumen
Los analisis de resumen calculan valores estadísticós, como la suma y el promedio de los
atributos seleccionados asociados con un elemento. Por ejemplo, un analisis de resumen de un
elemento de fabrica pódría utilizar el atributo temperatura con todas las bombas de la fabrica
para calcular el promedio de temperatura.
Los atributos para incluir en un analisis de resumen se pueden seleccionar de dos fuentes:
• Atributos de elementos
Por ejemplo, supongamos que desea verificar que el nivel del tanque es constante
comprobando que todas las entradas y salidas suman cero. En la lista de los atributos del
elemento del tanque, seleccione sus atributos de entrada y salida para calcular el total de la
suma. Un resumen que utiliza los propios atributos de un elemento se conoce tambien como
agregación.
• Atributos de los elementos secundarios del elemento
Por ejemplo, puede que necesite calcular el promedio de consumo de energía de un grupo
de bombas en una refinería. Para ello, tendra que crear un analisis de resumen en el
elemento principal (la refinería) que calcule el promedio de atributos de consumo de
energía a partir de sus elementos secundarios (bombas).
Utilice criterios de selección para elegir los atributos para el resumen. Puede seleccionar
atributos que coincidan con el nombre de atributo que ingresa o que esten asociados con la
categóría o la plantilla de elementos que especifica.
Con Servidor PI 2015 R2 y versiones posteriores, puede seleccionar atributos secundarios para
analisis de resumen. Para obtener mas infórmación, consulte Crear un analisis de resumen.
Debe especificar una o mas funciones para calcular las estadísticas de los atributos
seleccionados en el resumen (consulte Funciones del analisis de resumen). Asegurese de
asignarle un atributo de salida a cada salida.
Tenga en cuenta lo siguiente:
• Debe seleccionar los atributos cuidadosamente para obtener resultados apropiados. Evite
seleccionar conjuntos de unidades de medida (como temperatura y masa) o tipos de valor
(como valores numericós y marcas de tiempo) mezclados. Siempre y cuando las entradas y
las salidas tengan diferentes unidades dentro de la misma clase de unidades de medida, el
sistema hace un esfuerzo razonable por convertir las unidades de entrada a las de la salida
para el calculó.
• Pódra anadir o eliminar elementos o atributos de la jerarquía sin tener que actualizar los
analisis de resumen. Debido a que un resumen identifica los atributos de entrada cada vez
que se ejecuta, este incluye autómaticamente todo atributo nuevo que coincida con el
criterio de busqueda.
• Algunos atributos seleccionados (como aquellos con valores de cadena) no participan del
calculó del resumen, que opera solo con valores numericós o DateTime.
En esta sección
• Funciones del analisis de resumen
• Crear una plantilla de analisis de resumen
Guía del usuario PI System Explorer
331
Análisis basados en activos
• Crear un analisis de resumen
Funciones del análisis de resumen
Puede especificar una o mas de las siguientes funciones para calcular las estadísticas de los
atributos de entrada en el analisis de resumen.
Nota:
• Los atributos de entrada incorrectos se omiten del analisis de resumen. Por ejemplo, si
posee cinco atributos que coinciden con los criterios pero uno es un valor incorrecto,
la función Recuento devólvera cuatro.
• Los tipos de valores ingresados numericó, DateTime y Enumeration value estan
admitidos para las funciones Mínimo, Máximo y Recuento. La función Promedio
admite los tipos de valores numericó y DateTime. Los valores ingresados para todas
las demas funciones deben ser del tipo numericó.
Función
Descripción
Tipos de datos
admitidos
Sum
La suma de los valores de los atributos seleccionados.
Numericó
Promedio
El promedio de los valores de dos o mas atributos seleccionados.
Numericó, DateTime
Mínimó
El valor mínimó de los atributos seleccionados.
Numericó, DateTime,
Enumeration value
Maximó
El valor maximó de los atributos seleccionados.
Numericó, DateTime,
Enumeration value
Cantidad
El numeró de atributos que se utiliza en el calculó del resumen, que puede
diferir del numeró total de atributos seleccionados. Por ejemplo, un
atributo con un valor de cadena (como un nombre de parte) puede
coincidir con los criterios de selección, pero pódría no participar del
calculó del rollup y ser excluido del Recuento.
Numericó, DateTime,
Enumeration value
Median.
El valor medio de tres o mas valores de atributos seleccionados; para un
grupo de valores par, el promedio de los dos valores centrales. El mismo
numeró de valores por debajo y por encima de la media.
Numericó
Desviación
estandar de
póblación
La desviación estandar de póblación, que se calcula en base a toda la
póblación. Resulta util cuando todos los valores de una póblación estan
disponibles para incluirse como entradas para el calculó.
Numericó
Desviación
estandar de
la muestra
La desviación estandar de muestra, que se calcula en base a los valores de
una muestra de la póblación. Es util para proporcionar un valor estimado
de la desviación estandar de la póblación cuando es difícil o imposible
incluir todos los valores de la póblación en el calculó.
Numericó
Crear una plantilla de análisis de resumen
En PI System Explorer, puede crear una plantilla de analisis de resumen para una plantilla de
elementos seleccionada. Seleccione los valores de entrada del resumen de los atributos de la
plantilla de elementos seleccionada o de los atributos de una plantilla de elementos
secundarios (cuyo elemento principal derive de la plantilla de elementos). Puede elegir un
elemento secundario de ejemplo y utilizar sus atributos como ayuda a la hora de crear una
plantilla de analisis de resumen.
Antes de empezar
Identifique las funciones estadísticas que desee calcular en el resumen y dónde guardar los
resultados. Cuando cónfigure una plantilla de analisis, puede asignar los resultados de una
función a un atributo existente de la plantilla de elementos o crear un nuevo atributo de salida.
332
Guía del usuario PI System Explorer
Análisis basados en activos
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, seleccione la plantilla de elementos en la que desea crear la
plantilla de analisis.
3. En el visor, haga clic en la pestana Plantillas de análisis.
La pestana muestra todas las plantillas de analisis ya definidas para la plantilla de
elementos.
4. Cree una nueva plantilla de analisis para la plantilla de elementos:
◦ Si no existe ninguna plantilla de analisis, haga clic en Crear nueva plantilla de análisis
para crear la primera.
◦ De lo contrario, haga clic en Nueva plantilla de análisis
para crear una nueva.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en Resumen.
6. Opcional. Desactive la casilla de verificación Habilitar análisis cuando se crea desde una
plantilla para que el analisis se cree en el estado Disabled.
De forma predeterminada, los nuevos analisis se crean con el estado Enabled. Si no desea
iniciar el analisis cuando se crea, borre esta ópción.
7. En Atributos de resumen de, indique la fuente de los valores de entrada:
◦ Haga clic en Elementos secundarios de Element Template Name para resumir los
atributos de elementos secundarios de un elemento basado en la plantilla de elementos
actual.
◦ Haga clic en Este elemento - Element Template Name para resumir atributos de un
elemento basado en la plantilla de elementos actual.
8. Seleccione un elemento de ejemplo para proporcionar atributos candidatos:
a. Haga clic en el enlace Seleccionar un elemento de ejemplo para abrir una ventana que
muestre elementos derivados de la plantilla de elementos seleccionada.
b. Seleccione un elemento y haga clic en Aceptar.
9. Seleccione los atributos que incluira en el resumen:
Guía del usuario PI System Explorer
333
Análisis basados en activos
Si los atributos de Entonces:
resumen proceden
de:
Elementos hijo
a. En la lista Elemento secundario de muestra, seleccione el elemento del cual
desea ver los atributos.
La tabla muestra los atributos del elemento seleccionado. Para mejorar el
rendimiento, la tabla solo muestra una cantidad limitada de atributos. Puede
hacer clic en el enlace Mostrar más atributos debajo de la tabla para mostrar
atributos adicionales del elemento seleccionado.
b. A la izquierda de la tabla, especifique los criterios que seleccionan los
atributos que debe resumir:
▪ Nombre del atributo
Escriba un nombre de atributo completo o parte de un nombre con
caracteres cómódín. Por ejemplo, escriba temp* para seleccionar todos
los atributos que comienzan con "temp", como Temperature y Temp1.
Nota:
La selección de los atributos depende de si Attribute Level esta
cónfiguradó en "Nivel de raíz" o "Nivel secundario".
▪ Nivel de atributo
Seleccione Nivel de raíz para elegir entre atributos de nivel superior o
Nivel secundario para elegir entre atributos secundarios. No es posible
elegir atributos secundarios y atributos de nivel superior en un unicó
analisis de resumen.
▪ Categoría de atributo
Seleccione una categóría para limitar los atributos seleccionados a los
que estan en esa categóría.
▪ Categoría de elementos
Seleccione una categóría de elemento para limitar los atributos
seleccionados a atributos que tengan elementos principales en esa
categóría.
▪ Plantillas de elementos
Seleccione una categóría de elemento para limitar los atributos
seleccionados a atributos que tengan elementos principales basados en
esa plantilla.
Nota:
Los criterios se aplican a todos los atributos de cualquier elemento
secundario, no solo los que se muestran en la tabla.
Puede especificar criterios que seleccionan atributos que no aparecen en la
tabla. Por ejemplo, si establece un Elemento secundario de muestra para un
elemento de la categóría CatX, pero establece la Categoría de elemento en
CatY, no debe seleccionar los atributos de la tabla, pero el analisis
igualmente incluira los atributos en el resumen.
334
Guía del usuario PI System Explorer
Análisis basados en activos
Este elemento
A la izquierda de la tabla, especifique los criterios que seleccionan los atributos
que debe resumir:
◦ Nombre del atributo
Escriba un nombre de atributo completo o parte de un nombre con
caracteres cómódín. Por ejemplo, escriba temp* para seleccionar todos los
atributos que comienzan con "temp", como Temperature y Temp1.
Nota:
La selección de los atributos depende de si Attribute Level esta
cónfiguradó en "Nivel de raíz" o "Nivel secundario".
◦ Nivel de atributo
Seleccione Nivel de raíz para elegir entre atributos de nivel superior o Nivel
secundario para elegir entre atributos secundarios. No es posible elegir
atributos secundarios y atributos de nivel superior en un unicó analisis de
resumen.
◦ Categoría de atributo
Seleccione una categóría para limitar los atributos seleccionados a esa
categóría.
La tabla muestra una marca de verificación junto a cualquier atributo incluido en el
resumen.
10. En la tabla de funciones, especifique los calculós y la salida de resumen:
a. Seleccione las casillas de verificación junto a cualquier función estadística que desee
resumir para calcular.
b. Haga clic en Asignar para guardar los resultados de un calculó para un atributo de salida.
Puede asignar la salida a un atributo existente o asignar la salida a un nuevo atributo de
salida.
c. Opcional. En la parte superior de la tabla, haga clic en Evaluar para comprobar los valores
de salida de las funciones seleccionadas.
11. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
12. Opcional. Para comprobar el analisis, revise los resultados obtenidos con los datos
históricós:
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca horas de inicio y finalización que no sean posteriores a la hora actual y haga
clic en Generar resultados para ver una lista de resultados.
13. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas.
en la barra de
14. Haga clic en Ingresar en la barra de herramientas para guardar la plantilla de analisis en el
servidor de PI AF y para crear el analisis de cualquier elemento segun la plantilla de
elementos.
Crear un análisis de resumen
En PI System Explorer, cree un analisis de resumen para un elemento seleccionado. Seleccione
los atributos de entrada para el resumen, ya sea de atributos del elemento seleccionado o de
atributos de elementos secundarios.
Guía del usuario PI System Explorer
335
Análisis basados en activos
Antes de empezar
Identifique las funciones estadísticas que desee calcular en el resumen y dónde guardar los
resultados. Cuando cónfigure una plantilla de analisis, puede asignar los resultados de una
función a un atributo existente del elemento o puede crear un nuevo atributo de salida.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, seleccione el elemento en el que desea crear el analisis.
3. En el visor, haga clic en la pestana Análisis.
La pestana muestra todos los analisis ya definidós para el elemento.
4. Cree un nuevo analisis para el elemento:
◦ Si no existe ningun analisis, haga clic en Crear nuevo análisis para crear el primero.
◦ De lo contrario, haga clic en Nuevo análisis
para crear uno nuevo.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en Resumen
6. En Atributos de resumen de, indique la fuente de los valores de entrada:
◦ Haga clic en Elementos secundarios de Element Name para resumir atributos de un
elemento secundario.
◦ Haga clic en Este elemento - Element Name para resumir atributos del elemento actual.
7. Seleccione los atributos que incluira en el resumen:
336
Guía del usuario PI System Explorer
Análisis basados en activos
Si los atributos de Haga lo siguiente…
resumen proceden
de ...
Elementos hijo
a. En la lista Elemento secundario de muestra, seleccione el elemento del cual
desea ver los atributos.
La tabla muestra los atributos del elemento seleccionado. Para mejorar el
rendimiento, la tabla solo muestra una cantidad limitada de atributos. Puede
hacer clic en el enlace Mostrar más atributos debajo de la tabla para mostrar
atributos adicionales del elemento seleccionado.
b. A la izquierda de la tabla, especifique los criterios que seleccionan los
atributos que debe resumir:
▪ Nombre del atributo
Escriba un nombre de atributo completo o parte de un nombre con
caracteres cómódín. Por ejemplo, escriba temp* para seleccionar todos
los atributos que comienzan con "temp", como Temperature y Temp1.
Nota:
La selección de los atributos depende de si Attribute Level esta
cónfiguradó en "Nivel de raíz" o "Nivel secundario".
▪ Nivel de atributo
Seleccione Nivel de raíz para elegir entre atributos de nivel superior o
Nivel secundario para elegir entre atributos secundarios. No es posible
elegir atributos secundarios y atributos de nivel superior en un unicó
analisis de resumen.
▪ Categoría de atributo
Seleccione una categóría para limitar los atributos seleccionados a los
que estan en esa categóría.
▪ Categoría de elementos
Seleccione una categóría de elemento para limitar los atributos
seleccionados a atributos que tengan elementos principales en esa
categóría.
▪ Plantillas de elementos
Seleccione una categóría de elemento para limitar los atributos
seleccionados a atributos que tengan elementos principales basados en
esa plantilla.
Nota:
Los criterios se aplican a todos los atributos del elemento secundario
seleccionado, no solo los que se muestran en la tabla.
Puede especificar criterios que seleccionan atributos que no aparecen en la
tabla. Por ejemplo, si establece un Elemento secundario de muestra para un
elemento de la categóría CatX, pero establece la Categoría de elemento en
CatY, no debe seleccionar los atributos de la tabla, pero el analisis
igualmente incluira los atributos en el resumen.
Guía del usuario PI System Explorer
337
Análisis basados en activos
Este elemento
A la izquierda de la tabla, especifique los criterios que seleccionan los atributos
que debe resumir:
◦ Nombre del atributo
Escriba un nombre de atributo completo o parte de un nombre con
caracteres cómódín. Por ejemplo, escriba temp* para seleccionar todos los
atributos que comienzan con "temp", como Temperature y Temp1.
Nota:
La selección de los atributos depende de si Attribute Level esta
cónfiguradó en "Nivel de raíz" o "Nivel secundario".
◦ Nivel de atributo
Seleccione Nivel de raíz para elegir entre atributos de nivel superior o Nivel
secundario para elegir entre atributos secundarios. No es posible elegir
atributos secundarios y atributos de nivel superior en un unicó analisis de
resumen.
◦ Categoría de atributo
Seleccione una categóría para limitar los atributos seleccionados a esa
categóría.
La tabla muestra una marca de verificación junto a cualquier atributo incluido en el
resumen.
8. En la tabla de funciones, especifique los calculós y la salida de resumen:
a. Seleccione las casillas de verificación junto a cualquier función estadística que desee
resumir para calcular.
b. Haga clic en Asignar para guardar los resultados de un calculó para un atributo de salida.
Puede asignar la salida a un atributo existente o asignar la salida a un nuevo atributo de
salida.
c. Opcional. En la parte superior de la tabla, haga clic en Evaluar para comprobar los valores
de salida de las funciones seleccionadas.
9. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
10. Opcional. Para comprobar el analisis, revise los resultados obtenidos con los datos
históricós:
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
11. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas. Esta acción no ejecuta el analisis.
en la barra de
12. Haga clic en Ingresar en la barra de herramientas.
PI System Explorer guarda y registra su analisis, y luego comienza a ejecutar el analisis.
Análisis de generación de marcos de evento
Un analisis de generación de marcos de evento especifica las condiciones para iniciar y finalizar
marcos de evento autómaticamente.
Este tipo de analisis incluye una o dos expresiones. Cuando una cóndición unica activa el inicio
y la finalización de un marco de evento, solo se necesita una expresión de start trigger,
designada en el campo StartTrigger1. Por ejemplo, el aumento de un valor de temperatura por
338
Guía del usuario PI System Explorer
Análisis basados en activos
encima de un umbral puede iniciar un marco de evento y finalizarló al volver a situarse por
debajo del umbral. Cuando las condiciones de inicio y finalización sean distintas, se necesitara
tambien una expresión EndTrigger. Dado que prueban las condiciones de inicio y finalización,
las expresiones de los analisis de generación de marcos de evento deben dar como resultado
verdadero o falso. Para obtener mas infórmación, consulte Condiciones del activador de inicio y
finalización.
Puede escribir expresiones para que se usen como activadores de inicio o de fin. Si la expresión
queda muy compleja, puede dividirla en un grupo de expresiones mas pequenas y asignarlas a
las variables. Para obtener mas infórmación, consulte Simplificación de expresión con
refactórización.
A partir de la versión de 2018, existe una nueva manera de generar Event Frames en la que no
hace falta ajustar un activador explícitó. Para obtener mas infórmación, consulte Modos
implícitós de generación de Event Frame en Asset Analytics.
Cuando cónfigure analisis de generación de event frame, puede agregar expresiones al grupo
Salidas en el cierre para escribir salidas de vuelta a los atributos del event frame. Segun si
desea guardar el historial de salida, puede seleccionar cualquier atributo con una referencia de
datos de PI point o atributos de event frame estaticós. Si guarda el historial de salida en los
atributos del event frame cónfiguradó como una referencia de datos de PI Point, el atributo
debe estar asignado a un atributo de referencia de datos de PI point correspondiente del
elemento de referencia.
Nota:
• Las salidas de los event frames de la causa raíz solo se escriben en atributos estaticós.
• Los event frames primarios con varios event frames secundarios tambien se escribiran
solo en los atributos estaticós. Para obtener mas infórmación sobre la generación de
event frame secundarios, consulte Generación de marcos de evento con varios start
triggers.
En sus expresiones, puede usar entradas que provengan de activos para escribir salidas de
atributos de Event Frames cuando se cierre un Event Frame. Tambien puede usar la función
EventFrame para tener acceso a la hora de inicio, la hora de finalización y la duración del Event
Frame. Para obtener mas infórmación, consulte la función de expresión EventFrame.
Por lo general, un patrón de asignación de nombres de event frames incluye parametrós de
sustitución. Para obtener mas infórmación sobre el patrón de asignación de nombres, consulte
Patrones de asignación de nombres.
Nota:
• Se evaluaran los parametrós %Endtime% y %Duration% en un patrón de asignación de
nombres de event frame al final de un event frame cuando se cierre el event frame.
• Un valor de atributo puede actualizarse en cualquier momento determinado. Para
evitar confusiones, el parametró de sustitución %@Attribute% (que se resuelve segun
un valor de un atributo) en un patrón de asignación de nombres de un event frame
siempre sera evaluado o reevaluado en el contexto de inicio de un event frame.
• Ante la ausencia de un nombre o si la evaluación del nombre de un event frame ofrece
un valor nulo, se usara un patrón de asignación de nombres predeterminado
(%ANALYSIS% %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%).
En el caso excepcional de que la duración de un event frame con %@Attribute% en su
patrón de asignación de nombre coincida con el valor Verdadero para cónfiguradó, el
nombre del event frame regresara al patrón de asignación de nombres
predeterminado.
Puede crear varios activadores de inicio para el analisis y especificar diferentes condiciones
booleanas para activar cada event frame. Para obtener mas infórmación sobre varios
Guía del usuario PI System Explorer
339
Análisis basados en activos
activadores de inicio y la generación de event frames, consulte Generación de marcos de evento
con varios start triggers.
Nota:
Si cambia el nombre de un activador de inicio que tenía el nombre predeterminado,
debera hacer lo mismo con todos los activadores de inicio y utilizar nombres exclusivos
para cada activador.
Un pico en los datos de entrada puede activar el inicio de un Event Frame no deseado. Para
contrarrestar los efectos de los picos de datos, puede establecer que para poder crear un marco
de evento, el activador de inicio debe ser verdadero obligatoriamente durante un determinado
intervalo de tiempo. Para especificar el intervalo de tiempo, introduzca un valor en el campo
True for.
Tambien puede especificar un nivel de Gravedad para el activador. Las opciones disponibles de
gravedad son: Ninguna, Infórmación, Advertencia, Menor, Mayor y Crítica.
Un analisis de generación de marcos de evento se basa en una plantilla de marcos de evento,
que especifica los atributos de los marcos de evento generados. Antes de crear un analisis de
generación de marcos de evento, asegurese de que este disponible una plantilla de marcos de
evento adecuada.
Por lo general, los marcos de evento incluyen una cólección de elementos de referencia. El
elemento asociado con un analisis de generación de marcos de evento se convierte en el
elemento de referencia primario para sus marcos de evento generados. Para obtener mas
infórmación, consulte Elementos referenciados primarios. Se puede hacer referencia a otros
elementos utilizando rutas relativas en función del elemento de referencia primario, como se
describe en Referencias de datos a atributos en otros elementos.
En algunos eventos, como los cierres forzados, es posible que desee evaluar las condiciones que
conducen a ese evento. Para ello, PI Analysis Service puede generar marcos de evento de causa
raíz. Cuando esta cónfiguradó, cada marco de evento generado incluye un marco de evento de
causa raíz secundario que captura los atributos durante un intervalo de tiempo específicó justo
antes del inicio del marco de evento generado. Para obtener mas infórmación sobre cómó
generar un marco de evento de causa raíz, consulte el paso 11 en Crear una plantilla de analisis
de generación de marcos de evento.
Video
Para obtener infórmación sobre cómó cónfigurar analisis de generación de marcos de evento,
mire este video:
https://www.youtube.com/watch?v=iNYe_YZzj58&rel=0
En esta sección
• Modos implícitós de generación de Event Frame en Asset Analytics
• Crear una plantilla de analisis de generación de marcos de evento
• Crear un analisis de generación de marcos de evento
• Condiciones del activador de inicio y finalización
• Generación de marcos de evento con varios start triggers
Modos implícitos de generación de Event Frame en Asset Analytics
A partir de la versión de 2018, los usuarios de Asset Analytics en PI AF tienen la ópción de
seleccionar diferentes modos de generación de Event Frame. Antes de 2018, los usuarios
debían ajustar explícitamente un activador de inicio (ahora denominado activador explícitó).
En la versión 2018 o versiones posteriores de PI AF, es posible elegir entre tres modos
implícitós, ademas de un activador explícitó: pulso, escalón y escalón continuo. Despues de que
340
Guía del usuario PI System Explorer
Análisis basados en activos
seleccione la generación de Event Frame como tipo de analisis, elija uno de los siguientes
modos como Modo de generación:
• Pulso: una transición desde el estado Zeroth State a cualquier otro estado comienza un
Event Frame y la transición al estado Zeroth State finaliza el Event Frame. Tiene la
posibilidad de generar un Event Frame de causa raíz en Ajustes avanzados de Event Frame.
• Escalón: cualquier cambio de los valores finaliza un Event Frame y comienza el siguiente,
excepto cuando el valor cambia al estado Zeroth State, que finaliza el Event Frame actual
pero no comienza uno nuevo.
• Escalón continuo: todas las transiciones cerraran el Event Frame abierto y cómenzaran un
Event Frame nuevo.
Tenga en cuenta que, para estos Event Frames, debe seleccionar un atributo de activación que
sea un numeró entero, una cadena o un valor de enumeración. Para los Event Frames de pulso y
escalón, debera seleccionar un atributo como activador y ajustarlo al estado Zeroth State. Los
Event Frames de escalón continuo no son compatibles con el estado Zeroth State. El estado
Zeroth State determina cuandó debe cerrarse el Event Frame. Puede seleccionar estados Zeroth
State del estado digital o los conjuntos de enumeración. Para obtener mas infórmación,
consulte el tema de PI EFGen "Event start and end detection" in Live Library (https://
livelibrary.osisoft.com).
Crear una plantilla de análisis de generación de marcos de evento
En PI System Explorer, puede crear una plantilla de analisis de generación de event frame para
una plantilla de elemento.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, seleccione la plantilla de elementos en la que desea crear la
plantilla de analisis.
3. En el visor, haga clic en la pestana Plantillas de análisis.
La pestana muestra todas las plantillas de analisis ya definidas para la plantilla de
elementos.
4. Cree una nueva plantilla de analisis para la plantilla de elementos:
◦ Si no existe ninguna plantilla de analisis, haga clic en Crear nueva plantilla de análisis
para crear la primera.
◦ De lo contrario, haga clic en Nueva plantilla de análisis
para crear una nueva.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
Guía del usuario PI System Explorer
341
Análisis basados en activos
◦ Tipo de análisis
Haga clic en Generación de Event Frame.
6. Opcional. Desactive la casilla de verificación Habilitar análisis cuando se crea desde una
plantilla para que el analisis se cree en el estado Disabled.
De forma predeterminada, los nuevos analisis se crean con el estado Enabled. Si no desea
iniciar el analisis cuando se crea, borre esta ópción.
7. Opcional. Para evaluar temporalmente expresiones en la plantilla de analisis segun los
valores de un elemento en particular, haga clic en el vínculó Seleccionar un elemento de
ejemplo y seleccione un elemento en función de la plantilla de elementos actual. Si no se han
creado elementos a partir de la plantilla de elementos actual, primero debe crear un
elemento.
Las plantillas no tienen datos concretos asociados con sus atributos. Es imposible evaluar
una expresión en una plantilla de analisis, excepto tomando prestados atributos de valor de
un determinado elemento para ello.
PI System Explorer cónfigura un elemento de ejemplo para el elemento que selecciónó.
8. En la lista Plantilla de event frames, seleccione la plantilla para el event frame que este
analisis genera.
Para crear una plantilla de event frame, consulte Crea plantillas de event frames. Por lo
general, un patrón de asignación de nombres de event frame incluye parametrós de
substitución. Para obtener mas infórmación sobre el patrón de asignación de nombres,
consulte Patrones de asignación de nombres.
Nota:
◦ Se evaluaran los parametrós %Endtime% y %Duration% en un patrón de asignación
de nombres de event frame al final de un event frame cuando se cierre el event
frame.
◦ Un valor de atributo puede actualizarse en cualquier momento determinado. Para
evitar confusiones, el parametró de substitución %@Attribute% (que se resuelve
segun un valor de un atributo) en un patrón de asignación de nombres de un event
frame siempre sera evaluado en el contexto de inicio de un event frame.
◦ Ante la ausencia de un nombre o si la evaluación de un event frame ofrece un valor
nulo, se usara un patrón de asignación de nombres predeterminado (%ANALYSIS%
%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%).
9. Especifique las expresiones necesarias para el analisis:
a. En el campo StartTrigger1, introduzca la expresión booleana que indica la cóndición que
inicia un event frame.
b. Opcional. Cambie el nombre predeterminado del activador de inicio.
Nota:
Si cambia el nombre de un activador de inicio que tenía el nombre predeterminado,
debera hacer lo mismo con todos los activadores de inicio y utilizar nombres
exclusivos para cada activador.
c. Opcional. En el campo Verdadero para, introduzca la cantidad de tiempo en que la
cóndición del activador de inicio debe ser verdadera antes de que el analisis inicie un
event frame.
Nota:
Especifique un valor en el campo Verdadero para para reducir el numeró de event
frames no deseados causados por fluctuaciónes mómentaneas en los datos de
entrada.
342
Guía del usuario PI System Explorer
Análisis basados en activos
d. Opcional. En el campo Gravedad, introduzca la gravedad de la activación. Las opciones
disponibles de gravedad son: Ninguna, Infórmación, Advertencia, Menor, Mayor y Crítica.
Si ha definidó varios activadores de inicio, aquel con mayor gravedad sera el activador de
inicio efectivo; si todos tienen la misma gravedad, el primero de la lista sera el efectivo.
e. Para agregar varios activadores de inicio, haga clic en Añadir un nuevo activador de
inicio. Para cada activador de inicio, introduzca una expresión booleana, especifique un
valor para Verdadero para y seleccione un valor para Gravedad.
Nota:
Si ha cambiado el nombre predeterminado de un activador de inicio, asegurese de
asignar nombres exclusivos a todos los activadores de inicio.
f. Opcional. Si una cóndición diferente finaliza el event frame, introduzca la expresión en la
fila EndTrigger. De lo contrario, el event frame se cerrara cuando la cóndición de
activación de inicio ya no sea verdadera.
g. Opcional. Haga clic en Añadir una nueva variable para insertar un nuevo campo de
expresión donde pueda especificar una variable y la expresión para utilizarlas en una de
las expresiones de activación.
h. Opcional. Haga clic en Agregar una expresión de salida nueva para insertar una
expresión nueva y escribir salidas para los atributos del event frame. Puede asignar la
salida como un atributo estaticó (no guarda el historial) o PI point (guarda el historial).
Cuando asigne un atributo de PI point, asegurese de que se asigne de vuelta al atributo
del activo.
10. Opcional. Si especificó un elemento de ejemplo, haga clic en Evaluar para verificar los
valores de salida de las expresiones individuales.
11. Opcional. Genere un marco de evento de causa raíz para cada marco de evento que el
analisis genera. Un marco de evento de causa raíz captura datos de activos, lo que permite
analizar las condiciones justo antes de que se inicie el marco de evento.
Nota:
Las salidas de los event frames de la causa raíz solo se escriben en atributos estaticós.
a. En la ventana Configuración avanzada de event frame, seleccione Generar event frame de
causa raíz secundario antes de que se inicie un event frame primario.
b. En el campo Duración, introduzca la duración del marco de evento de causa raíz.
El marco de evento de causa raíz inicia esta duración antes de que se genere el evento
principal.
12. Opcional. Asigne un nombre y una expresión del activador de inicio a un atributo de event
frame.
a. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger name to event frame attribute (Guardar nombre
del activador de inicio en el atributo de marco de evento) y luego seleccione un atributo
(plantilla) o cree una nueva plantilla de atributo en la plantilla de marco de evento en la
que se guarde el nombre del activador de inicio.
b. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger expression to event frame attribute (Guardar
expresión del activador de inicio en el atributo de marco de evento) y luego seleccione un
atributo (plantilla) o cree una nueva plantilla de atributo en la plantilla de marco de
evento en la que se guarde la expresión del activador de inicio.
El nombre del activador de inicio y la expresión del activador de inicio pódran ahora
visualizarse en event frames generados, en los atributos seleccionados.
Guía del usuario PI System Explorer
343
Análisis basados en activos
13. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
14. Opcional. Si especificó un elemento de ejemplo, verifique el analisis al revisar los resultados
obtenidos con los datos históricós:
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
15. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas.
en la barra de
16. Haga clic en Ingresar en la barra de herramientas para guardar la plantilla de analisis en el
servidor de PI AF y para crear el analisis de cualquier elemento segun la plantilla de
elementos.
Crear un análisis de generación de marcos de evento
En PI System Explorer, puede crear un analisis de generación de marcos de evento para un
elemento individual.
Antes de empezar
Compruebe que una plantilla de event frames este disponible para el analisis.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, seleccione el elemento en el que desea crear el analisis.
3. En el visor, haga clic en la pestana Análisis.
La pestana muestra todos los analisis ya definidós para el elemento.
4. Cree un nuevo analisis para el elemento:
◦ Si no existe ningun analisis, haga clic en Crear nuevo análisis para crear el primero.
◦ De lo contrario, haga clic en Nuevo análisis
para crear uno nuevo.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en Generación de Event Frame.
6. En la lista Plantilla de event frames, seleccione la plantilla para el event frame que este
analisis genera.
344
Guía del usuario PI System Explorer
Análisis basados en activos
Para crear una plantilla de event frame, consulte Crea plantillas de event frames. Por lo
general, un patrón de asignación de nombres de event frame incluye parametrós de
sustitución. Para obtener mas infórmación sobre el patrón de asignación de nombres,
consulte Patrones de asignación de nombres.
Nota:
◦ Se evaluaran los parametrós %Endtime% y %Duration% en un patrón de asignación
de nombres de event frame al final de un event frame cuando se cierre el event
frame.
◦ Un valor de atributo puede actualizarse en cualquier momento determinado. Para
evitar confusiones, el parametró de sustitución %@Attribute% (que se resuelve
segun un el valor de un atributo) en un patrón de asignación de nombres de un
event frame siempre sera evaluado en el contexto de inicio de un event frame.
◦ Ante la ausencia de un nombre o si la evaluación de un event frame ofrece un valor
nunó, se usara un patrón de asignación de nombres predeterminado (%ANALYSIS%
%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%).
7. Especifique las expresiones necesarias para el analisis:
a. En el campo StartTrigger1, introduzca la expresión booleana que indica la cóndición que
inicia un event frame.
b. Opcional. Cambie el nombre predeterminado del activador de inicio.
Nota:
Si cambia el nombre de un activador de inicio que tenía el nombre predeterminado,
debera hacer lo mismo con todos los activadores de inicio y utilizar nombres
exclusivos para cada activador.
c. Opcional. En el campo Verdadero para, introduzca la cantidad de tiempo en que la
cóndición del activador de inicio debe ser verdadera antes de que el analisis inicie un
event frame.
Nota:
Especifique un valor en el campo Verdadero para para reducir el numeró de event
frames no deseados causados por fluctuaciónes mómentaneas en los datos de
entrada.
d. Opcional. En el campo Gravedad, introduzca la gravedad de la activación. Las opciones
disponibles de gravedad son: Ninguna, Infórmación, Advertencia, Menor, Mayor y Crítica.
Si ha definidó varios activadores de inicio, aquel con mayor gravedad sera el activador de
inicio efectivo; si todos tienen la misma gravedad, el primero de la lista sera el efectivo.
e. Para agregar varios activadores de inicio, haga clic en Añadir un nuevo activador de
inicio. Para cada activador de inicio, introduzca una expresión booleana, especifique un
valor para Verdadero para y seleccione un valor para Gravedad.
Nota:
Si ha cambiado el nombre predeterminado de un activador de inicio, asegurese de
asignar nombres exclusivos a todos los activadores de inicio.
f. Opcional. Si una cóndición diferente finaliza el event frame, introduzca la expresión en la
fila EndTrigger. De lo contrario, el event frame se cerrara cuando la cóndición de
activación de inicio ya no sea verdadera.
g. Opcional. Haga clic en Añadir una nueva variable para insertar un nuevo campo de
expresión donde pueda especificar una variable y la expresión para utilizarlas en una de
las expresiones de activación.
h. Opcional. Haga clic en Agregar una expresión de salida nueva para insertar una
expresión nueva y escribir salidas para los atributos del event frame. Puede asignar la
Guía del usuario PI System Explorer
345
Análisis basados en activos
salida como un atributo estaticó (no guarda el historial) o PI point (guarda el historial).
Cuando asigne un atributo de PI point, asegurese de que se asigne de vuelta al atributo
del activo.
Consulte Expresiones para analisis si desea mas infórmación.
8. Opcional. Haga clic enEvaluar para comprobar los valores de salida en las horas de Última
activación y Evaluación.
9. Opcional. Genere un marco de evento de causa raíz para cada marco de evento que el
analisis genera. Un marco de evento de causa raíz captura datos de activos, lo que permite
analizar las condiciones justo antes de que se inicie el marco de evento.
Nota:
Las salidas de los event frames de la causa raíz solo se escriben en atributos estaticós.
a. En la ventana Advanced Event Frame Settings Cónfiguración avanzada de marcos de
evento, seleccione Generate child root cause event frame before parent event frame
starts (Generar marco de evento de causa raíz secundario antes de que se inicie un marco
de evento principal).
b. En el campo Duración, introduzca la duración del marco de evento de causa raíz.
El marco de evento de causa raíz inicia esta duración antes de que se genere el evento
principal.
Nota:
El marco de evento de causa raíz se crea solo para la primera instancia, y no para
cada vez que el activador se True.
10. Opcional. Asigne un nombre y una expresión del activador de inicio a un atributo de event
frame.
Nota:
Recomendamos poner nombres significativós a los activadores de inicio de analisis
cuando los guarde en un atributo de event frame.
a. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger name to event frame attribute (Guardar nombre
del activador de inicio en el atributo de marco de evento) y luego seleccione un atributo
(plantilla) o cree una nueva plantilla de atributo en la plantilla de marco de evento en la
que se guarde el nombre del activador de inicio.
b. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger expression to event frame attribute (Guardar
expresión del activador de inicio en el atributo de marco de evento) y luego seleccione un
atributo (plantilla) o cree una nueva plantilla de atributo en la plantilla de marco de
evento en la que se guarde la expresión del activador de inicio.
El nombre del activador de inicio y la expresión del activador de inicio pódran ahora
visualizarse en event frames generados, en los atributos seleccionados.
11. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
12. Opcional. Para comprobar el analisis, revise los resultados obtenidos con los datos
históricós:
a. En la lista de analisis, haga clic con el bótón secundario sobre el nombre del analisis y
haga clic en Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
346
Guía del usuario PI System Explorer
Análisis basados en activos
13. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en
herramientas. Esta acción no ejecuta el analisis.
en la barra de
14. Haga clic en Ingresar en la barra de herramientas.
PI System Explorer guarda y registra su analisis, y luego comienza a ejecutar el analisis.
Condiciones del activador de inicio y finalización
Un analisis de generación de marcos de evento inicia un marco de evento cuando la cóndición
del activador de inicio es verdadera. Dado que el pico aleatorio de un valor de entrada puede
convertir a esa cóndición en verdadera, estos datos ruidosos pueden generar muchos marcos
de evento no deseados. Para contrarrestar los efectos de los picos de datos, puede definir un
intervalo de tiempo antes de iniciar un event frame al ingresar un valor en el campo Verdadero
durante.
Cuando una cóndición de start trigger pase a ser verdadera, el valor Verdadero durante
determina cuantó tiempo es necesario esperar para volver a evaluarla, si sigue siendo
verdadera y si se ha iniciado un event frame.
Nota:
• Con la prógramación Periodic, el analisis evaluara unicamente en el horario
especificadó en el programa, independientemente de la cónfiguración Verdadero
durante. La evaluación Verdadero durante en este caso sera la primera evaluación
periódica tras la finalización del períódó Verdadero durante.
Segun cómó se cónfigure el programa Periodic, es posible que no haya evaluaciones
dentro del períódó Verdadero durante. Si quiere asegurarse de que el analisis realice la
evaluación dentro de dicho marco de tiempo, debera cónfigurar el programa periódicó
para que sea mas breve que el valor Verdadero durante (por ejemplo, evaluar cada
minuto y Verdadero durante 5 minutos), o bien, optar por un programa EventTriggered.
Si quiere que el analisis arroje una evaluación correcta al fin del períódó Verdadero
durante, alinee la ópción Verdadero durante para que coincida con el programa
periódicó (evaluar cada 3 minutos con el valor Verdadero durante de 9 minutos, por
ejemplo), o bien, elija el programa Event-Triggered.
• Con el programa Event-Triggered, el analisis realizara una evaluación cada vez que
el valor del atributo de entrada de activación se actualiza. El hecho de cónfigurar el
analisis para que sea Event-Triggered y se active con cada atributo de entrada en la
cóndición inicio de activación puede evitar que al analisis le falten evaluaciones.
La hora de inicio del marco de evento es la hora en la que la cóndición del activador de inicio se
evaluó por primera vez como verdadera.
El valor Verdadero durante no tiene ningun efecto sobre la hora de finalización del event frame.
El event frame se cerrara cuando la cóndición del activador de inicio sea falsa. La cónfiguración
de un activador de finalización es opcional. Si se cónfiguran las condiciones del activador de
inicio y finalización, el event frame finalizara cuando se cumpla la cóndición del activador de
finalización. Esto es independiente de si la cóndición del activador de inicio sigue siendo
verdadera.
Guía del usuario PI System Explorer
347
Análisis basados en activos
Consejo:
• Si utilizan activadores de inicio y finalización, asegurese de que las expresiones nunca
se evaluen como TRUE al mismo tiempo, ya que esto pódría conducir a event frames
con duraciones de cero segundos.
• Intente cónfigurar los event frames para utilizar unicamente una expresión de
activador de inicio.
Generación de marcos de evento con varios start triggers
PI Analysis Service puede capturar Event Frames secundarios. Los Event Frames secundarios
son utiles cuando necesita escalar nótificaciónes o realizar un analisis detallado de eventos
pasados. En este tema, se aborda lo siguiente:
• Un video que demuestra cómó cónfigurar Event Frames con varios activadores de inicio
• Activadores de inicio efectivos
• Ejemplo de generación de Event Frames secundarios
Nota:
Este tema se aplica solamente a activadores explícitós.
Video
Para obtener infórmación sobre cómó cónfigurar Event Frames con varios activadores de inicio
y niveles de gravedad, vea el siguiente video:
https://www.youtube.com/watch?v=R15X4fYYxAQ&rel=0
Activadores de inicio efectivos
El analisis de generación de Event Frame es compatible con varios activadores de inicio. Al
activar un analisis, el activador de inicio efectivo se determina teniendo en cuenta los siguientes
tres elementos: evaluación del activador, gravedad y orden de los activadores.
• Evaluación
Si solamente un activador de inicio tiene la valóración True, ese es el activador de inicio
efectivo. Si la evaluación da como resultado varios activadores de inicio con la valóración
True, el analisis debe tener en cuenta la gravedad.
• Gravedad
Si la evaluación da como resultado varios activadores de inicio con la valóración True, el
efectivo sera aquel que presente el nivel mas alto de gravedad. Por ejemplo, si hay dos
activadores de inicio, StartTrigger1 con gravedad y Major y StartTrigger2 con
gravedad Critical, y ambos tiene la valóración True en el mismo momento,
StartTrigger2 se cónsiderara el activador efectivo por tener la mayor gravedad.
Nota:
Los niveles de gravedad (en orden descendente) son: Critical, Major, Minor,
Warning, Information y None (predeterminado).
• Orden
Si varios activadores de inicio con la misma gravedad reciben la valóración True, el
activador de inicio efectivo sera aquel que se haya definidó en primer lugar.
En definitiva, solamente hay un activador de inicio efectivo.
348
Guía del usuario PI System Explorer
Análisis basados en activos
Generación de Event Frames secundarios debido a cambios en el activador de inicio
efectivo
Es posible que un analisis con varios activadores de inicio cree autómaticamente Event Frames
secundarios. Por ejemplo, habitualmente, un analisis de generación de Event Frame completa
los siguientes pasos:
1. Un activador de inicio recibe la valóración True y no hay ningun Event Frame abierto. El
analisis inicia un Event Frame.
2. En una segunda evaluación, mientras el Event Frame cóntinua abierto, el activador de inicio
efectivo no se módifica y cóntinua recibiendo la valóración True. Por lo tanto, el Event
Frame permanecera abierto.
3. Otra evaluación hace que el activador de inicio efectivo sea diferente del paso 1. En
consecuencia, el analisis realiza lo siguiente:
a. Inicia un nuevo Event Frame principal con la misma hora de inicio que el Event Frame
original.
b. Convierte al Event Frame original en un Event Frame secundario de este nuevo Event
Frame principal.
c. Cierra el Event Frame original (que ahora es un Event Frame secundario).
d. Crea un nuevo Event Frame secundario con el nuevo activador de inicio efectivo.
4. Otra evaluación no hace que el activador de inicio efectivo se módifique. El analisis mantiene
abiertos los Event Frames secundario y principal.
5. Otra evaluación hace que el activador de inicio efectivo se módifique nuevamente. Entonces:
a. El Event Frame secundario creado en 3d se cierra.
b. Sin embargo, el nuevo activador de inicio efectivo crea otro Event Frame secundario.
6. Otra evaluación hace que todos los activadores de inicio reciban la valóración False.
Entonces:
a. El Event Frame secundario creado en 5b se cierra.
b. El Event Frame principal creado en 3a se cierra.
Análisis de SQC
Con PI System Explorer, puede crear analisis de SQC que utilicen pruebas estandares de control
de calidad estadísticó (SQC) para determinar si el valor de un atributo de PI AF se halla dentro
de los margenes de error especificadós por el usuario. Ademas, puede especificar atributos o
marcos de evento como salidas del analisis de SQC.
Pueden seleccionarse las siguientes pruebas de patrón SQC:
• Fuera de control:
Cuenta el numeró de muestras fuera del límite de control a un lado de la línea central.
• Fuera del sigma 2:
Evalua la muestra frente a un límite trazado a 2/3 de la distancia entre la línea central y el
límite de control.
• Fuera del sigma 1:
Evalua la muestra frente a un límite trazado a 1/3 de la distancia entre la línea central y el
límite de control.
Guía del usuario PI System Explorer
349
Análisis basados en activos
• Un lado de la línea central
Cuenta el numeró de muestras a un lado de la línea central.
• Estratificación:
Cuenta el numeró de muestras comprendidas entre los límites superior e inferior de Sigma
uno a ambos lados de la línea central.
• Combinación:
Cuenta el numeró de muestras que se encuentran fuera de los límites superior e inferior de
Sigma uno a ambos lados de la línea central.
• Tendencia:
Cuenta el numeró de muestras que aumentan o disminuyen en una secuencia mónótónica.
Crear una plantilla de análisis de SQC
En PI System Explorer, puede crear una plantilla de analisis de SQC para una plantilla de
elementos.
Procedimiento
1. En el navegador, haga clic en Biblioteca.
2. En el navegador Biblioteca, seleccione la plantilla de elementos en la que desea crear la
plantilla de analisis.
3. En el visor, haga clic en la pestana Plantillas de análisis.
La pestana muestra todas las plantillas de analisis ya definidas para la plantilla de
elementos.
4. Cree una nueva plantilla de analisis para la plantilla de elementos:
◦ Si no existe ninguna plantilla de analisis, haga clic en Crear nueva plantilla de análisis
para crear la primera.
◦ De lo contrario, haga clic en Nueva plantilla de análisis
para crear una nueva.
5. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Descripción
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en SQC.
6. Opcional. Desactive la casilla de verificación Habilitar análisis cuando se crea desde una
plantilla para que el analisis se cree en el estado Disabled.
350
Guía del usuario PI System Explorer
Análisis basados en activos
De forma predeterminada, los nuevos analisis se crean con el estado Enabled. Si no desea
iniciar el analisis cuando se crea, borre esta ópción.
7. Opcional. Seleccione un elemento de ejemplo.
8. Proporcione las entradas para la prueba de patrón SQC. Todas estas entradas deberan ser
plantillas de atributos anteriormente definidas en su PI System.
a. En el campo Origen, seleccione la PI AF plantilla de atributo que proporcione los datos de
la prueba de patrón.
b. En los campos Upper Control Limit (Límite de control superior) y Lower Control Limit
(Límite de control inferior), seleccione la PI AF plantilla de atributos que proporcione los
datos de los límites mayor y menor de la dimensión de los datos sometidos a prueba.
c. En el campo Center Line (Línea central), seleccione la PI AF plantilla de atributos que
proporcione el valor normal o ideal de los datos.
9. Seleccione la salida del analisis como Event Frame o Atributo de AF. Si elige Event Frame,
seleccione una plantilla de Event Frame. Si selecciona Atributo de AF, pódra elegir en una
lista o crear una nueva plantilla de atributo. La regla de analisis SQC crea autómaticamente
un conjunto de enumeración llamado Enumeración SQC. Este conjunto de enumeración
tiene los mismos valores que se usaron en el conjunto SQC DigitalState de PI Data Archive
para que se conserve la continuidad con el PI Data Archive existente. La Enumeración SQC
se crea cuando: 1) usted asigna la salida a un nuevo atributo de AF, 2) este u otro conjunto
de enumeración con el nombre y los valores requeridos tódavía no existen y 3) usted tiene el
derecho de crear conjuntos de enumeración. La salida del atributo de AF se establece de
manera predeterminada en un atributo de cadena si no se cumplen las condiciones
mencionadas anteriormente.
10. Opcional. Genere un event frame de causa raíz para cada event frame que el analisis genera.
Un event frame de causa raíz captura datos de activos, lo que le permite analizar las
condiciones justo antes de que se inicie un event frame.
a. En el menu Configuración avanzada de Event Frame, seleccione Generar Event Frame
secundario de causa raíz antes de que se inicie un Event Frame principal.
b. En el campo Duración, introduzca la duración del Event Frame de causa raíz.
El Event Frame de causa raíz inicia esta duración antes de que se genere el evento
principal.
Nota:
Únicamente se creara el event frame de causa raíz correspondiente a la primera
instancia, y no para cada vez que un activador se True.
11. Opcional. Asigne un nombre y una expresión del activador de inicio a un atributo de event
frame.
a. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger name to event frame attribute (Guardar nombre
del activador de inicio en el atributo de marco de evento) y seleccione una plantilla de
atributo en la plantilla de marco de evento en la que se guarde el nombre del activador de
inicio.
b. En la ventana Advanced Event Frame Settings (Cónfiguración avanzada de marcos de
evento), seleccione Save start trigger expression to event frame attribute (Guardar
expresión del activador de inicio en el atributo de marco de evento) y seleccione una
plantilla de atributo en la plantilla de marco de evento en la que se guarde la expresión
del activador de inicio.
El nombre del activador de inicio y la expresión del activador de inicio ahora se pódran
visualizar en event frames generados, en los atributos seleccionados.
Guía del usuario PI System Explorer
351
Análisis basados en activos
12. Introduzca infórmación de prueba de patrón SQC.
a. Seleccione la casilla para cada prueba de patrón SQC que desee aplicar a los datos.
b. En la columna X de Y , seleccione valores numericós adecuados para X e Y para cada
prueba de patrón seleccionada que requiera esta entrada. Especifique el numeró de
valores X de un numeró de valores Y de muestra, que puede ser superior o inferior a los
límites de prueba de patrón correspondientes.
De manera predeterminada, se muestran los patrones (valores X e Y) sugeridos por
Western Electric.
Nota:
X no puede ser mayor que Y.
c. Seleccione el Límite como Superior, Inferior o Ambos para cada prueba de patrón
seleccionada. De forma predeterminada, las pruebas se aplican a ambas partes de la línea
central.
13. Opcional. Seleccione la casilla de verificación Borrar en Cambio de límite de control.
Con la casilla Clear on Control Limit Change (Borrar en Cambio de límite de control)
seleccionada, si alguno de los límites de control cambia, el analisis basado en activos
restablece el estado de un calculó de SQC en ejecución y este se reinicia con los valores
módificadós. Ademas, los event frames abiertos asociados se cierran antes de reanudar el
calculó.
Con la casilla Borrar en Cambio de límite de control no seleccionada, el calculó simplemente
cóntinua utilizando los valores módificadós de límites de control.
14. Opcional. Haga clic enEvaluar para comprobar los valores de salida en las horas de Última
activación y Evaluación. Si se superan todas las pruebas de SQC seleccionadas, el campo
Valor de salida indica "Normal". Si algunas pruebas fallan, el campo Valor de salida móstrara
la prueba que haya fallado con mayor prioridad. Si se cambia cualquiera de las entradas de
SQC, se bórrara el campo Valor de salida.
15. Especifique la prógramación para el analisis. Consulte Prógramación de analisis.
16. Haga clic en Ingresar en la barra de herramientas para guardar la plantilla de analisis en el
servidor de PI AF y para crear el analisis de cualquier elemento segun la plantilla de
elementos.
Crear un análisis de SQC
Antes de empezar
Identifique el patrón de control de calidad estadísticó (SQC) que desea utilizar. Consulte
Analisis de SQC si desea mas infórmación.
Procedimiento
1. En el navegador, haga clic en Elementos.
2. En el navegador Elementos, seleccione el elemento en el que desea crear el analisis.
3. En el visor, haga clic en la pestana Análisis.
La pestana muestra todos los analisis ya definidós para el elemento.
4. Cree un nuevo analisis para el elemento:
◦ Si no existe ningun analisis, haga clic en Crear nuevo análisis para crear el primero.
◦ De lo contrario, haga clic en Nuevo análisis
para crear uno nuevo.
5. Introduzca la infórmación para identificar el analisis:
352
Guía del usuario PI System Explorer
Análisis basados en activos
◦ Nombre
El nombre que identifica unicamente a este analisis.
◦ Description
Texto opcional que describe el analisis.
◦ Categorías
Categóría opcional que puede asignar al analisis. Haga clic en la lista y seleccione la
casilla de verificación junto a las categórías que desee asignar o haga clic en Nuevo para
crear una nueva categóría.
◦ Tipo de análisis
Haga clic en SQC.
6. Proporcione las entradas para la prueba de patrón SQC. Todas estas entradas deberan ser
atributos o plantillas de atributos anteriormente definidós en su PI System.
a. En el campo Origen, seleccione el atributo de PI AF o la plantilla de atributo que
proporcione los datos de la prueba de patrón.
b. En los campos Upper Control Limit (Límite de control superior) y Lower Control Limit
(Límite de control inferior), seleccione el PI AF atributo o la plantilla de atributos que
proporcione los datos de los límites mayor y menor de la dimensión de los datos
sometidos a prueba.
c. En el campo Center Line (Línea central), seleccione el PI AF atributo o la plantilla de
atributos que proporcione el valor normal o ideal de los datos.
7. Seleccione la salida del analisis como Event Frame o Atributo de AF. Si elige Event Frame,
seleccione una plantilla de Event Frame. Si selecciona Atributo de AF, pódra elegir en una
lista o crear un nuevo atributo. La regla de analisis SQC crea autómaticamente un conjunto
de enumeración llamado Enumeración SQC. Este conjunto de enumeración tiene los mismos
valores que se usaron en el conjunto SQC DigitalState de PI Data Archive para que se
conserve la continuidad con el PI Data Archive existente. La Enumeración SQC se crea
cuando: 1) usted asigna la salida a un nuevo atributo de AF, 2) este u otro conjunto de
enumeración con el nombre y los valores requeridos tódavía no existen y 3) usted tiene el
derecho de crear conjuntos de enumeración. La salida del atributo de AF se establece de
manera predeterminada en un atributo de cadena si no se cumplen las condiciones
mencionadas anteriormente.
8. Opcional. Genere un event frame de causa raíz para cada event frame que el analisis genera.
Un event frame de causa raíz captura datos de activos, lo que le permite analizar las
condiciones justo antes de que se inicie un event frame.
a. En el menu Configuración avanzada de event frames, seleccione Generar event frame de
causa raíz secundario antes de que se inicie un event frame principal.
b. En el campo Duración, introduzca la duración del Event Frame de causa raíz.
El Event Frame de causa raíz inicia esta duración antes de que se genere el evento
principal.
Nota:
Únicamente se creara el event frame de causa raíz correspondiente a la primera
instancia, y no para cada vez que un activador se True.
9. Opcional. Asigne un nombre y una expresión del activador de inicio a un atributo de event
frame.
a. En la ventana Configuración avanzada de event frames, seleccione Guardar nombre del
activador de inicio en el atributo de event frame y seleccione un atributo o una plantilla
Guía del usuario PI System Explorer
353
Análisis basados en activos
de atributo en la plantilla de event frame en la que se guarde el nombre del activador de
inicio.
b. En la ventana Configuración avanzada de event frames, seleccione Guardar expresión del
activador de inicio en el atributo de event frame y seleccione un atributo o una plantilla
de atributo en la plantilla de event frame en la que se guarde la expresión del activador
de inicio.
El nombre del activador de inicio y la expresión del activador de inicio ahora se pódran
visualizar en event frames generados, en los atributos seleccionados.
10. Introduzca infórmación de prueba de patrón SQC.
a. Seleccione la casilla para cada prueba de patrón SQC que desee aplicar a los datos.
b. En la columna X de Y , seleccione valores numericós adecuados para X e Y para cada
prueba de patrón seleccionada que requiera esta entrada. Especifique el numeró de
valores X de un numeró de valores Y de muestra, que puede ser superior o inferior a los
límites de prueba de patrón correspondientes.
De manera predeterminada, se muestran los patrones (valores X e Y) sugeridos por
Western Electric.
Nota:
X no puede ser mayor que Y.
c. Seleccione el Límite como Superior, Inferior o Ambos para cada prueba de patrón
seleccionada. De forma predeterminada, las pruebas se aplican a ambas partes de la línea
central.
11. Opcional. Seleccione la casilla de verificación Borrar en cambio de límite de control. Con la
casilla Borrar en cambio de límite de control seleccionada, si alguno de los límites de control
cambia, el analisis basado en activos restablece el estado de un calculó de SQC en ejecución y
este se reinicia con los valores módificadós. Ademas, los event frames abiertos asociados se
cierran antes de reanudar el calculó.
Con la casilla Borrar en cambio de límite de control no seleccionada, el calculó simplemente
cóntinua utilizando los valores módificadós de límites de control.
12. Opcional. Haga clic enEvaluar para comprobar los valores de salida en las horas de Última
activación y Evaluación. Si se superan todas las pruebas de SQC seleccionadas, el campo
Valor de salida indica "Normal". Si algunas pruebas fallan, el campo Valor de salida móstrara
la prueba que haya fallado con mayor prioridad. Si se cambia cualquiera de las entradas de
SQC, se bórrara el campo Valor de salida.
13. Haga clic en Ingresar en la barra de herramientas.
PI System Explorer guarda y registra su analisis, y luego comienza a ejecutar el analisis.
Análisis de ejemplo
Los analisis de muestra que se incluyen en esta sección realizan los siguientes calculós en la
misma base de datos de PI AF:
1. Utiliza un analisis de tipos de una expresión para realizar un seguimiento de la desviación
de la eficiencia por parte del activo y los procesos representados por el elemento, Ethylene.
2. Crea una plantilla para generar un conjunto de analisis de resumen que sumen la energía
total extraída por todos los procesos de una refinería. La plantilla de elementos a partir de la
cual se ha creado el elemento de cada refinería se denomina Refinery.
3. Crea Event Frames para capturar datos siempre que el promedio de eficiencia de ejecución
de 15 minutos del elemento, Ethylene, descienda por debajo del 90%.
354
Guía del usuario PI System Explorer
Análisis basados en activos
Crear un análisis de expresión para estudiar la desviación de la eficiencia
En este ejemplo se muestra cómó crear un analisis de tipos de expresión. El analisis realiza un
seguimiento de cómó la eficiencia de un proceso se desvía de la eficiencia meta.
En primer lugar, calcularemos el promedio de eficiencia por hora, luego determinaremos
cuantó se desvía de la eficiencia meta.
En este ejemplo, se crea un nuevo PI Point para guardar los datos de salida (la desviación de la
eficiencia meta, ya que varía con el tiempo). Cuando cree sus propios analisis, OSIsoft le
recomienda crear los PI Points que necesite para los datos de resultados antes de crear el
analisis.
Antes de empezar
Cree un elemento llamado Ethylene que tenga un atributo llamado Efficiency que contenga
una referencia de datos de PI Point.
Procedimiento
1. En Elementos, seleccione el elemento para el cual desea crear el analisis, como Etileno.
2. Haga clic en la pestana Análisis.
3. Cree un nuevo analisis para el elemento:
◦ Si no existe ningun analisis, haga clic en Crear nuevo análisis para crear el primero.
◦ De lo contrario, haga clic en Nuevo análisis
para crear uno nuevo.
4. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis. Por ejemplo, EfficiencyCalc.
◦ Tipo de análisis
Haga clic en Expresión. El analisis de expresión es el tipo de analisis mas simple; contiene
una o varias expresiones e infórmación sobre la prógramación. Para obtener mas
infórmación, consulte Analisis de expresiones.
Guía del usuario PI System Explorer
355
Análisis basados en activos
5. En la tabla de expresiones, cree una variable que incluya el valor de constante de la
eficiencia meta:
a. En la columna Nombre, escriba Target.
b. En la columna Expresión, introduzca 90.
Indica que el valor de constante de la variable es 90.
6. Cree una segunda variable para calcular el promedio de eficiencia por hora:
a. Haga clic en Añadir nueva expresión.
b. Asigne un nombre a la variable HourlyEfficiency.
c. En la columna Expresión, introduzca la siguiente sintaxis de ecuación de rendimiento:
TagAvg('Efficiency', '*-1h', '*')
Esta expresión calcula el valor promedio del atributo denominado Efficiency a lo largo
de la ultima hora.
7. Cree una tercera variable para calcular en que grado la eficiencia por hora se desvía de la
eficiencia meta, 90:
a. Haga clic en Añadir nueva expresión.
b. Asigne un nombre a la variable Deviation.
c. En la columna Expresión, introduzca la siguiente expresión:
HourlyEfficiency - Target
8. Guarde el resultado de la variable Deviation en un PI Point:
a. En la columna Atributo de salida, haga clic en Asignar.
b. Haga clic en Nuevo atributo para crear un nuevo atributo de PI AF.
c. Para definir el atributo como una referencia de datos de PI Point, haga clic en Sí para
guardar el historial de salidas.
d. En el campo Nombre, introduzca el nombre del atributo; por ejemplo,
EfficiencyDifference.
e. Haga clic en Aceptar para crear el atributo.
9. Especifique la prógramación para el analisis:
a. Cónfigure la ópción Programación como Periódico.
b. Haga clic en Configurar y especifique un períódó de 30 segundos.
El calculó se ejecutara cada 30 segundos.
10. Compruebe que los resultados parezcan razonables:
a. En la tabla de analisis, haga clic con el bótón secundario en el analisis y luego haga clic en
Vista previa de resultados.
b. Introduzca el rango de tiempo de la vista previa. El intervalo de tiempo predeterminado
comienza en la medianoche anterior y termina en la hora actual, pero si lo prefiere,
puede introducir diferentes horas de inicio y finalización.
c. Haga clic en Generar resultados.
356
Guía del usuario PI System Explorer
Análisis basados en activos
11. Cuando este satisfecho con el nuevo analisis, haga clic en Ingresar en la barra de
herramientas para guardar su trabajo.
PI System Explorer guarda y registra su analisis, y luego comienza a ejecutar el analisis.
Un círculó verde en la columna Estado de la tabla de analisis indica que PI Analysis Service
esta ejecutando el analisis.
12. Opcional. Reponga el PI Point que el calculó da como resultado utilizando datos del pasado.
PI Analysis Service puede reponer resultados de calculós que tengan atributos de salida
asignados a referencias de datos de PI Point. Sin embargo, el PI Point no pude contener
datos en las horas especificadas. Si lo desea, puede eliminar los datos existentes con
anterioridad y, a cóntinuación, reponer ese intervalo de tiempo.
a. Haga clic con el bótón secundario en la tabla de analisis y, a cóntinuación, haga clic en
Reponer/Recalcular.
b. Especifique una hora de inicio y finalización para la repósición.
c. Seleccione Eliminar datos existentes de forma permanente y recalcular.
d. Haga clic en Iniciar.
Crear una plantilla para los análisis de resumen de potencia
En este ejemplo se muestra cómó crear una plantilla para generar un conjunto de analisis de
resumen. La plantilla de analisis suma la energía total extraída de todos los procesos de una
refinería.
Antes de empezar
Cree los objetos necesarios en su base de datos de PI AF:
• Plantilla de elementos llamada Refinery
• Elemento llamado Rotterdam Refinery, derivado de la plantilla Refinery
• Elemento secundario llamado Catalytic Cracking en el elemento Rotterdam
Refinery
• Atributo llamado Power Draw en el elemento secundario Catalytic Cracking
Procedimiento
1. En el navegador Biblioteca, seleccione la plantilla de elementos para la que desea crear la
plantilla de analisis.
En este ejemplo, la plantilla de elementos se denomina Refinery. Esta plantilla se utiliza
para crear elementos de refinería.
2. Haga clic en la pestana Plantillas de análisis.
3. Cree una nueva plantilla de analisis para la plantilla de elementos:
◦ Si no existe ninguna plantilla de analisis, haga clic en Crear nueva plantilla de análisis
para crear la primera.
◦ De lo contrario, haga clic en Nueva plantilla de análisis
para crear una nueva.
4. Introduzca la infórmación para identificar el analisis:
◦ Nombre
El nombre que identifica unicamente a este analisis. Por ejemplo, PowerRollup.
Guía del usuario PI System Explorer
357
Análisis basados en activos
◦ Tipo de análisis
Haga clic en Resumen. Los analisis de resumen calculan datos estadísticós para los
atributos especificadós, como el total o el promedio. Para obtener mas infórmación,
consulte Analisis de resumen.
5. Seleccione un elemento de ejemplo para proporcionar atributos candidatos:
a. Haga clic en el enlace Seleccionar un elemento de ejemplo para abrir una ventana que
muestre elementos derivados de la plantilla de elementos seleccionada.
b. Seleccione un elemento y haga clic en Aceptar.
Por ejemplo, en la lista de elementos derivados de la plantilla Refinery, seleccione
Refinería de Rotterdam.
6. Para elegir la ópción Atributos de resumen de, haga clic en Elementos secundarios de
Refinería de Rotterdam para indicar que el analisis resume los atributos de elementos
secundarios del elemento de refinería.
7. Seleccione los atributos que incluira en el resumen:
a. En la lista Elemento secundario de muestra, seleccione el elemento del cual desea ver los
atributos.
Por ejemplo, seleccione Craqueo catalítico para ver los atributos del elemento
Catalytic Cracking en la tabla de atributos.
La tabla solo muestra los atributos del elemento seleccionado. El resumen incluye
atributos de todos los elementos secundarios que coinciden con los criterios que
especifica.
b. A la izquierda de la tabla de atributos, especifique los criterios que seleccionan los
atributos que debe resumir.
Por ejemplo, en el campo Nombre de atributo, escriba Power* para especificar todos los
atributos que comienzan con Power. La tabla de atributos muestra una marca de
verificación junto a los atributos en el elemento secundario seleccionado que coinciden
con estos criterios. Sin embargo, el resumen incluye atributos de cualquier elemento
secundario que coinciden con los criterios, no solo los de la tabla.
8. En la tabla de funciones, especifique los calculós y la salida de resumen:
a. Seleccione las casillas de verificación junto a cualquier función estadística que desee
resumir para calcular.
Por ejemplo, haga clic en la casilla de verificación Suma para ver los valores totales.
b. En la columna Salida(s), haga clic en Asignar para guardar los resultados del calculó para
un atributo de salida.
c. Haga clic en Nueva plantilla de atributos para crear una nueva plantilla de atributos con
una referencia de datos de PI Point.
d. Especifique los valores que definen el atributo creado y el punto, y haga clic en Aceptar.
Por ejemplo, puede utilizar los valores predeterminados, los cuales nombran el punto y el
atributo PowerRollup_Sum y escribir el punto en el PI Data Archive predeterminado,
que se indica en el parametró de substitución.
9. Haga clic en Evaluar y compruebe si el resultado devuelto en la columna Valor es validó.
10. Cónfigure la ópción Programación como Desencadenado por eventos.
11. Para comprobar el analisis, revise los resultados obtenidos con los datos históricós:
358
Guía del usuario PI System Explorer
Análisis basados en activos
a. En la lista de analisis, haga clic con el bótón secundario sobre el analisis y haga clic en
Vista previa de resultados.
b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y
haga clic en Generar resultados para ver una lista de resultados.
12. Haga clic en Ingresar en la barra de herramientas para guardar la plantilla de analisis en el
servidor de PI AF y para crear el analisis de cualquier elemento segun la plantilla de
elementos.
Crear de forma automática event frames para realizar un seguimiento de la
ineficiencia
Hemos creado un analisis de muestra para realizar un seguimiento de la desviación de la
eficiencia de un proceso respecto a la eficiencia meta en Crear un analisis de expresión para
estudiar la desviación de la eficiencia. En este ejemplo, crearemos event frames para capturar
datos siempre que el promedio de eficiencia de ejecución de 15 minutos descienda por debajo
del 90%.
Antes de empezar
Complete los pasos en Crear un analisis de expresión para estudiar la desviación de la
eficiencia.
Procedimiento
1. En el navegador Biblioteca, expanda Plantillas.
2. Haga clic con el bótón secundario sobre Plantillas de event frames y seleccione Nueva
plantilla para crear una nueva plantilla de event frame.
3. En el campo Nombre, ingrese EfficiencyAnomaly.
4. En el campo Patrón de asignación de nombres, especifique el nombre de los event frames
que se producen desde la plantilla.
Puede utilizar parametrós de substitución para especificar un nombre diferente. PI AF
resuelve los parametrós cuando crea event frames. Entonces, cada event frame tendra un
nombre exclusivo e identificable.
a. Haga clic en la flecha que esta junto al campo para ver los parametrós de substitución
validós que puede agregar al nombre.
b. Seleccione %ELEMENT%.
c. Seleccione %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.
El parametró de substitución STARTTIME incluye el patrón de formato de fecha-hora que
se utilizara.
Guía del usuario PI System Explorer
359
Análisis basados en activos
5. Haga clic en la pestana Plantillas de atributos.
6. Cree un atributo de referencia de datos de PI Point con la plantilla de atributos.
a. Haga clic en Nueva plantilla de atributo.
b. En el campo Nombre, escriba Efficiency.
c. Haga clic en Ajustes e introduzca la siguiente cadena de cónfiguración en el campo
Nombre de tag:
.\Elements[.]|Efficiency; uom=%
d. En la lista UOM predeterminada, seleccione porcentaje.
7. En el panel Elementos, haga clic en Etileno, el elemento para el que desarrólló un analisis en
Crear un analisis de expresión para estudiar la desviación de la eficiencia.
8. Haga clic en la pestana Análisis.
9. Haga clic en Nuevo análisis
.
10. Introduzca la infórmación para identificar el analisis:
◦ Nombre
Introduzca EfficiencyAnomalyEvent.
◦ Tipo de análisis
Haga clic en Generación de event frame.
11. Desde la lista Plantilla de event frame, seleccione AnomalíaEficiencia.
Esta es la plantilla de event frame que creó en los pasos anteriores.
12. Introduzca expresiones que especifiquen el inicio y el fin del event frame:
◦ StartTrigger1
TagAvg('Efficiency', '*-15m', '*') <90
Crea un event frame siempre que el promedio de eficiencia de 15 minutos disminuya por
debajo del 90%.
◦ EndTrigger
TagAvg('Efficiency', '*-15m', '*') >92
Finaliza el event frame siempre que el promedio de eficiencia de 15 minutos se recupere
y supere el 92%.
360
Guía del usuario PI System Explorer
Análisis basados en activos
13. Haga clic en Evaluar para verificar los valores actuales de las expresiones.
La columna Valor se rellenara con True o False para cada una de las condiciones.
14. Especifique la prógramación para el analisis.
a. En la ópción Programación, especifique Periódico.
b. Haga clic en Configurar para que el analisis se ejecute cada minuto.
15. Guarde su trabajo.
Rellenado y recálculo de análisis
Rellenar o recalcular
Cuando rellena un analisis para un intervalo de tiempo especificadó, los datos que faltan se
calculan para completar los espacios vacíós de las salidas. Por otra parte, el recalculó borra
todos los datos del intervalo de tiempo y calcula los resultados para las salidas del analisis de
nuevo. Actualmente, hay cuatro opciones diferentes para el rellenado y el recalculó. Para
obtener mas infórmación, consulte el artículó de la Base de conocimientos de OSIsoft Asset
analytics backfilling and recalculation milestones and requirements (https://
customers.osisoft.com/s/knowledgearticle?knowledgeArticleUrl=KB01697).
Los analisis de expresión, rollup o SQC se pueden rellenar o recalcular durante un periodo de
tiempo anterior si las salidas de analisis se asignan a los atributos de PI point. Puede rellenar
los datos faltantes en un intervalo de tiempo y conservar los datos existentes, o puede
recalcular, lo que elimina y recalcula los datos en el intervalo de tiempo. Los analisis de
generación de marcos de evento pueden recalcular marcos de evento durante un períódó
especificadó, pero eliminan autómaticamente todos los marcos de evento existentes en ese
períódó, así como las anotaciones en los marcos de evento afectados.
Para rellenar/recalcular, necesita permiso de ejecución sobre los analisis. El permiso adecuado
se puede obtener mediante la asignación de su cuenta a la identidad de Asset Analytics
Recalculation. Para obtener mas infórmación sobre la asignación de identidad, consulte PI
AF identities and mappings (Identidades y asignaciones de PI AF).
Nota:
Para las salidas de escritura de analisis a atributos cónfiguradós como PI point, el
rellenado o el recalculó pódrían dar lugar a la escritura de eventos fuera de orden. Dichos
eventos se escriben en el PI Data Archive sin cómpresión.
Habilitar el rellenado autómaticó resulta util, ya que completa los espacios vacíós en caso de
que ocurra un tiempo de inactividad breve durante el servicio de analisis. Para obtener mas
infórmación, consulte los parametrós AutoBackfillingEnabled y
MaximumAllowedAutoBackfillingSpanInHours en Cónfiguración del servicio de analisis.
Desde PI AF 2017 R2, puede habilitar el recalculó autómaticó de los analisis. PI AF Para usar el
recalculó autómaticó, se necesita un servidor y PI Analysis Service 2017 R2 o una versión
posterior. Si bien el recalculó autómaticó esta habilitado a nivel general de manera
predeterminada (AutoRecalculationEnabled), tiene que elegir en el nivel de analisis
individual (plantilla) si espera datos que llegan mas tarde o fuera de orden que puedan activar
un recalculó. Para obtener mas infórmación, consulte Cónfigurar el recalculó autómaticó de
analisis y plantillas de analisis, Habilitar o deshabilitar el recalculó autómaticó para multiples
analisis y los parametrós AutoRecalculationEnabled,
AutoRecalculationIgnoreTimeInSeconds,
AutoRecalculationMinWaitTimeInSeconds, y
MaxAllowedAutoRecalculationSpanInDays en Cónfiguración del servicio de analisis. Para
analizar un archivo de registro con una lista de solicitudes de rellenado o recalculó manual y
Guía del usuario PI System Explorer
361
Análisis basados en activos
autómaticó en fila para la sólución de problemas, consulte Abrir la carpeta de registro de
recalculó.
Nota:
Los analisis de generación de Event Frame y de SQC que se cónfiguran para generar Event
Frames se excluyen del recalculó autómaticó.
Reponer o recalcular datos de un análisis
Antes de empezar
PI Analysis Service 2016 R2 presentó capacidades de recalculó para analisis de expresión,
resumen y SQC. PI Data Archive que almacenen los PI points de salida deben ejecutar la versión
2016 R2 o una versión posterior. A partir de PI Analysis Service 2018, puede elegir recalcular
todos los analisis dependientes. Un analisis dependiente es aquel cuya entrada proviene de la
salida de otro analisis.
Procedimiento
1. En el navegador Elementos, seleccione un elemento y haga clic en la pestana Análisis para
ver los analisis definidós para el elemento.
2. En la lista de analisis, haga clic con el bótón secundario en el analisis en ejecución que desea
utilizar para rellenar o recalcular los datos y, a cóntinuación, haga clic en Backfill/
Recalculate (Rellenar/Recalcular).
3. En la ventana Backfilling or recalculation for analysis name (Rellenado o recalculó para),
realice las siguientes acciones.
a. En los campos Hora de inicio y Hora de finalización, especifique el períódó para el que
desea rellenar los datos faltantes mientras conserva los datos existentes, o eliminar y
recalcular los datos. Puede utilizar expresiones horarias estandar de PI o hacer clic en
para seleccionar un períódó de fecha específicó.
b. Decida cómó deben tratarse los datos existentes. En el caso de una expresión, un
resumen o analisis de SQC que genera un resultado de un atributo:
▪ Para garantizar que se conserven los datos existentes y solo se rellenen los datos
faltantes, seleccione Leave existing data and fill in gaps (Dejar los datos existentes y
completar los espacios vacíós).
▪ Si cambiaron los datos de entrada o los algoritmos de analisis, y desea eliminar los
datos de salida existentes, seleccione Eliminar datos existentes de forma permanente
y recalcular.
◦
Opcional. Seleccione la casilla junto a Recalcular análisis dependientes para poner
en la cola de recalculó manual todos los analisis dependientes.
Nota:
362
◦
Si selecciona esta ópción, es posible que el recalculó se realice varias veces
para los analisis dependientes
◦
El intervalo de tiempo de recalculó para analisis dependientes puede
diferir del intervalo de tiempo que selecciónó cuando puso los analisis en
cola para el recalculó. Para obtener mas infórmación, consulte la nota al
final del paso 7 en Rellenar o recalcular datos de varios analisis.
Guía del usuario PI System Explorer
Análisis basados en activos
Nota:
Los event frames se borran y recalculan autómaticamente para los analisis de
generación de event frame. Tenga en cuenta que se perdera infórmación en esos
marcos de evento, como anotaciones, reconocimientos o códigós de motivo.
4. Haga clic en Inicio para iniciar el proceso de repósición o recalculó.
5. Para obtener detalles sobre el estado del rellenado o del recalculó, o para cancelar, haga clic
con el bótón secundario en el analisis y, a cóntinuación, haga clic en Backfill/Recalculate
Status (Estado de rellenadó/recalculó).
Video
Para obtener infórmación sobre cómó rellenar o recalcular datos para un analisis, mire este
video:
https://www.youtube.com/watch?v=m7F0FwEykpw&rel=0
Rellenar o recalcular datos de varios análisis
Antes de empezar
PI Analysis Service 2016 R2 presentó capacidades de recalculó para analisis de expresión,
resumen y SQC. El PI Data Archive que almacene los PI Points de salida debe ejecutar la versión
2016 R2 o una versión posterior. A partir de PI Analysis Service 2018, puede elegir recalcular
todos los analisis dependientes. Un analisis dependiente es aquel cuya entrada proviene de la
salida de otro analisis.
Procedimiento
1. En el navegador, seleccione Management (Administración) en la parte inferior de la lista.
2. Seleccione el bótón de radio Análisis en el panel Management (Administración).
3. Opcional. En Analysis Searches (Busquedas de analisis), seleccione una consulta de
busqueda y luego seleccione el resultado sobre el que desea operar. Por ejemplo, seleccione
Habilitado. Solo se muestran los analisis que cumplen con el criterio ( ).
4. En el panel Análisis, seleccione los analisis que desea rellenar o recalcular.
5. En el panel Operaciones, seleccione Rellenar o recalcular cola para los análisis seleccionados.
Nota:
En PI AF 2018 SP2, tambien puede cancelar el rellenado de multiples analisis con
Cancelar rellenar o recalcular para los análisis seleccionados.
6. En los campos Hora de inicio y Hora de finalización, especifique el periodo de tiempo para el
que desea rellenar los datos faltantes mientras conserva los datos existentes, o eliminar y
recalcular datos. Puede utilizar expresiones horarias estandar de PI o hacer clic en para
seleccionar un períódó de fecha específicó.
7. Elija una de las siguientes acciones:
Guía del usuario PI System Explorer
363
Análisis basados en activos
Para rellenar o recalcular...
Haga lo siguiente…
Analisis de expresión, resumen o SQC solamente
Decida cómó deben tratarse los datos existentes:
◦ Para garantizar que se conserven los datos
existentes y solo se rellenen los datos
faltantes, seleccione Leave existing data and
fill in gaps (Dejar los datos existentes y
completar los espacios vacíós).
◦ Si cambiaron los datos de entrada o los
algoritmos de analisis, y desea eliminar los
datos de salida existentes, seleccione Eliminar
datos existentes de forma permanente y
recalcular.
Una mezcla de analisis que incluye analisis de
generación de marcos de evento
o
Mas de una pagina de selecciones de analisis
Realice una de las siguientes acciones:
◦ Mantenga seleccionada la ópción Leave
existing data and fill in gaps (Dejar los datos
existentes y completar los espacios vacíós) y
tenga en cuenta que los marcos de evento en
el intervalo de tiempo se eliminaran de forma
permanente con todas las anotaciones en
esos marcos de evento.
◦ Seleccione Eliminar datos existentes de
forma permanente y recalcular. Se perderan
todas las anotaciones en los event frames.
▪ Opcional. Seleccione la casilla junto a
Recalcular análisis dependientes para
poner en la cola de recalculó manual todos
los analisis dependientes.
Nota:
◦ Si selecciona esta ópción, es
posible que el recalculó se
realice varias veces para los
analisis dependientes
◦ El intervalo de tiempo de
recalculó para analisis
dependientes puede diferir del
intervalo de tiempo que
selecciónó cuando puso los
analisis en cola para el recalculó.
Existen tres factores que repercuten en el intervalo de tiempo de recalculó de los analisis
dependientes:
◦ El intervalo de tiempo del analisis original
◦ Cómó se usa la salida del analisis original en los analisis dependientes
◦ Si esta cónfigurada la anulación de tiempo de salida en el analisis original
8. Haga clic en Cola para iniciar el proceso de multiples reposiciones o recalculós.
9. Revise el panel Pending Operations (Operaciones pendientes) para obtener detalles sobre el
estado de rellenado o recalculó.
Conciliación de event frames durante el rellenado
Al reiniciar PI Analysis Service tras breves períódós de inactividad, se inicia la repósición
autómatica al mismo tiempo que el analisis en tiempo real.
364
Guía del usuario PI System Explorer
Análisis basados en activos
Nota:
Con PI Server 2015 y PI Server 2015 R2, PI Analysis Service no inicia el proceso de
repósición autómatica si el tiempo de inactividad es superior a 72 horas. Con PI Server
2016, puede cónfigurar el parametró de cónfiguración
MaximumAllowedAutoBackfillingSpanInHours en PI Analysis Service para
especificar el tiempo deseado.
Cuando PI Analysis Service se reinicie, cónciliara los event frames abiertos. Cuando termina el
rellenado autómaticó de los analisis, el analisis de activos determina si existen event frames
para conciliar e inicia la fase de cónciliación. La cónciliación de event frames puede ser
necesaria para cualquier event frame en curso que no pueda cerrarse dentro del intervalo de
tiempo de repósición autómatica por no ser posible encontrar ningun evento de cierre. Estos
marcos de evento pueden generarse en cualquiera de estas formas:
• El marco de evento pódría encontrarse ya presente cuando se detuvo el servicio de analisis.
• El marco de evento pódría acabar de crearse durante la repósición autómatica.
Es posible que dichos event frames en curso tengan que conciliarse con los generados durante
la evaluación en tiempo real.
Cuando selecciona un analisis utilizando la pestana Análisis o el complemento Administración,
un icono naranja ( ) en la ventana de analisis indica que la cónciliación de event frames aun
no finalizó. Mueva el cursor sobre el icono para ver detalles como el numeró de eventos que se
estan procesando, las horas de inicio y finalización y la hora de la ultima evaluación. Una vez
finalizada la cónciliación, el icono pasara del naranja al verde.
Configurar el recálculo automático de análisis y plantillas de análisis
Antes de empezar
En PI AF 2017 R2, los analisis pueden recalcularse autómaticamente. Si bien el recalculó
autómaticó esta habilitado a nivel general de manera predeterminada, tiene que elegir en el
nivel de analisis individual (plantilla) si espera datos que llegan mas tarde o de fuera de orden
que puedan activar un recalculó. Para cónfigurar el recalculó autómaticó de un analisis en
particular (plantilla), siga este procedimiento.
Nota:
• Se necesita un servidor PI AF y PI Analysis Service 2017 R2 o una versión posterior.
• Los analisis de generación de event frames y de SQC que se cónfiguran para generar
event frames se excluyen del recalculó autómaticó.
• Un evento se considera demorado si su marca de tiempo es anterior a la ultima hora de
ejecución del analisis. La ultima hora de activación es la misma marca de tiempo del
evento de ejecución mas reciente en un analisis (activado por el evento) o la ultima
hora en que se llevó a cabo un analisis (periódicó).
Procedimiento
1. Vaya al analisis (plantilla) al que desea habilitarle el recalculó autómaticó.
2. Haga clic en el bótón Avanzado en la parte inferior del panel. Se abre la ventana Opciones
avanzadas.
3. Marque la casilla de verificación junto a Recalcular análisis para eventos de entrada fuera de
orden y haga clic en Aceptar.
Nota:
No puede elegir y anular su elección de recalculó autómaticó mediante el acceso al
analisis basado en una plantilla. Vaya a la plantilla para realizar los cambios.
Guía del usuario PI System Explorer
365
Análisis basados en activos
Habilitar o deshabilitar el recálculo automático para múltiples análisis
Antes de empezar
En el caso de la escritura de analisis a atributos (expresión, rollup y SQC), el recalculó
autómaticó esta disponible en PI Analysis Service 2017 R2 o en versiones posteriores. Ademas,
se necesita Servidor de PI AF 2017 R2 o una versión posterior.
Nota:
Los analisis de generación de event frames y de SQC que se cónfiguran para generar event
frames se excluyen del recalculó autómaticó.
Procedimiento
1. En el navegador, seleccione Management (Administración) en la parte inferior de la lista.
2. Seleccione el bótón de radio Análisis en el panel Management (Administración).
3. Opcional. En Analysis Searches (Busquedas de analisis), seleccione una consulta de
busqueda y luego seleccione el resultado sobre el que desea operar. Por ejemplo, seleccione
Habilitado. Solo se muestran los analisis que cumplen con el criterio ( ).
4. En el panel Análisis, seleccione los analisis para los que desea habilitar o deshabilitar el
recalculó autómaticó.
5. En el panel Operaciones, haga clic en Habilitar o Deshabilitar recálculo automático para
análisis seleccionados.
6. Marque la casilla de verificación que esta al lado del reconocimiento y haga clic en Habilitar
o Deshabilitar.
7. Revise el panel Operaciones pendientes para realizar el seguimiento del progreso de la
óperación habilitada o deshabilitada.
Abrir la carpeta de registro de recálculo
Para acceder a un archivo de registro integral de solicitudes de relleno y recalculó autómaticó o
manual en la cola para la sólución de problemas, siga el procedimiento.
Procedimiento
1. En el navegador, seleccione Management (Administración) en la parte inferior de la lista.
2. Seleccione el bótón de radio Análisis en el panel Management (Administración).
3. Haga clic con el bótón secundario en cualquier lugar del panel Operaciones y, luego, haga
clic en Abrir carpeta de registro de recálculo. Se abre una carpeta que contiene un archivo
csv con relleno y recalculó en la cola.
Gestión de análisis en la base de datos de PI AF
La función de Administración (que incluye analisis y reglas de nótificación) esta disponible si
su instalación de PI System Explorer incluye el complemento Administración.
Para obtener mas infórmación, vaya a Administración de analisis. Para buscar analisis en su
base de datos, consulte Buscar reglas de analisis o nótificación. Para obtener infórmación sobre
la administración de nótificaciónes, consulte Reglas de administración de nótificaciónes.
366
Guía del usuario PI System Explorer
Análisis basados en activos
Referencia de funciones de expresión
Las funciones de expresión que estan disponibles para ser usadas en expresión y en los analisis
de generación de event frame se enumeran alfabeticamente. Estas funciones siguen la sintaxis
de Performance Equation (PE).
En esta sección
• Abs
Devuelve el valor absoluto de un numeró entero o real.
• Acos
Devuelve el coseno inverso o (arcocoseno) de un numeró entero o real.
• AND
Operador de cónjunción lógica de dos expresiones.
• ArrayLength
Obtiene la longitud de una matriz.
• Ascii
Devuelve el códigó de caracter ASCII del primer caracter de una cadena.
• Asin
Devuelve el seno inverso (arcoseno) de un numeró.
• Atn
Devuelve la tangente inversa (arcotangente) de un numeró.
• Atn2
Devuelve la arcotangente de un valor de tangente a/b especificadó.
• Avg
Devuelve el promedio ponderado en el tiempo o ponderado en eventos de uno o mas
valores.
• BadVal
Pruebe un valor para ver si es incorrecto.
• Bod
Devuelve una marca de tiempo correspondiente al comienzo del día a partir de una
expresión de tiempo.
• Bom
Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes a
partir de una expresión de tiempo dada.
• Bonm
Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes
siguiente a partir de una expresión de tiempo dada.
• Ceiling
Devuelve el entero mas pequenó no menor que x.
• Char
Devuelve una cadena generada a partir de los códigós de caracter ASCII especificadós.
• Compare
Comparar dos cadenas utilizando caracteres cómódín ("*" y "?").
• Concat
Cóncatenación de dos o mas cadenas.
• Contains
Determina si la primera cadena contiene la segunda cadena y devuelve True o False.
Guía del usuario PI System Explorer
367
Análisis basados en activos
• Convert
Convierte un valor desde su unidad de medida actual (UOM) en una UOM especificada.
• Cos
Devuelve el coseno trigónómetricó de un numeró entero o real.
• Cosh
Devuelve el coseno hiperbólicó de un numeró.
• Cot
Devuelve la cotangente trigónómetrica de un numeró.
• Coth
Devuelve la cotangente hiperbólica de un numeró.
• Cov
Determine la covarianza entre dos conjuntos de valores segun los atributos con respecto a
un intervalo de tiempo especificadó.
• Csc
Devuelve la cosecante trigónómetrica de un numeró.
• Csch
Devuelve la cosecante hiperbólica de un numeró.
• Curve
Para un valor x determinado, devuelve el valor de una función de interpólación lineal por
trozo definida por el conjunto de n puntos (x1,y1)...(xn,yn).
• Day
Extrae el día del mes a partir de una expresión de tiempo.
• DaySec
Devuelve el tiempo total, en segundos, entre el comienzo del día (medianoche) y la hora
designada en el argumento.
• DeltaValue
Devuelve la diferencia entre los valores o las evaluaciones actual e inmediatamente anterior
de un atributo con un tipo de valor numericó o DateTime.
• DigState
Traduce una cadena de caracteres que representa un estado digital a su estado digital
correspondiente.
• DigText
Obtiene el texto que corresponde al estado digital.
• E
Función de constante que devuelve el valor de e (la base del logaritmo natural).
• ELSE
Operador que devuelve el segundo de dos valores especificadós cuando la expresión
condicional del enunciado IF-THEN-ELSE es True.
• EventCount
Encuentra la cantidad de eventos de un atributo durante un intervalo de tiempo
especificadó.
• EventFrame
Devuelve el valor de las propiedades de event frame.
• Exit
Detenga el analisis para que no ejecute mas evaluaciones.
• Exp
Devuelve el exponencial de un numeró entero o real.
368
Guía del usuario PI System Explorer
Análisis basados en activos
• FilterData
Obtener todos los valores en una matriz que cumplen con una cóndición determinada.
• FindEq
Encuentra la marca de tiempo mas próxima a starttime en un intervalo de tiempo
especificadó en que un atributo es igual a un valor especificadó.
• FindGE
Encuentra la primera vez en un intervalo de tiempo en que un atributo es mayor o igual que
un valor especificadó.
• FindGT
Encuentra la primera vez en un intervalo de tiempo en que un atributo es mayor que un
valor especificadó.
• FindLE
Encuentra la primera vez en un intervalo de tiempo en que un atributo es menor o igual que
un valor especificadó.
• FindLT
Encuentra la primera vez en un intervalo de tiempo en que un atributo es menor que un
valor especificadó.
• FindNE
Encuentra la primera vez en un intervalo de tiempo en que un atributo no es igual al valor
especificadó.
• FirstValue
Obtener el primer valor en una matriz que cumpla con una cóndición determinada.
• Float
Convertir una cadena en un numeró.
• Floor
Devuelve el numeró entero mas grande no mayor que x.
• Format
Convierte un numeró en una cadena en función de una expresión de formato.
• Frac
Devuelve la parte fraccionaria de un numeró real. Devuelve 0 en el caso de los enteros.
• HasChanged
Devuelve True si un atributo ha tenido algun evento en el períódó especificadó; de lo
contrario, devuelve False.
• HasValueChanged
Determina si el valor de un atributo o de una expresión cambió desde la ultima evaluación
durante un analisis.
• Hour
Extrae la hora de una expresión de tiempo.
• IF
La cóndición de un enunciado IF-THEN-ELSE.
• IN
Operador que indica si un valor esta incluido en un conjunto o rango de valores.
• InStr
Determina la ubicación dentro de una cadena en la que se encuentra por primera vez una
subcadena.
• Int
Devuelve la parte entera de un numeró entero o real.
Guía del usuario PI System Explorer
369
Análisis basados en activos
• InterpolatedValues
Obtenga los valores interpolados en un rango de tiempo especificadó usando el valor de
timestep definidó.
• IsSet
Para un atributo asociado con un PI point, determina si el punto esta anotado, se sustituye o
es cuestionable.
• LastValue
Obtener el ultimó valor en una matriz que cumpla con una cóndición determinada.
• LCase
Convierte en minusculas una cadena.
• Left
Determina un numeró específicó de caracteres de una cadena empezando por la izquierda.
• Len
Determina la longitud de una cadena.
• LinRegr
Devuelve una matriz de pendientes con base uno, la intersección y R2 en función de los
valores con marca de tiempo.
• Log
Devuelve el logaritmo natural (base e = 2.7182818...) de un numeró entero o real.
• Log10
Devuelve el logaritmo en base 10 de un numeró entero o real.
• Logbase
El logaritmo de un valor numericó positivo en una determinada base.
• LTrim
Eliminar los espacios en blanco al comienzo de una cadena.
• MapData
Aplicar una función a cada valor en la matriz.
• Max
Devuelve el valor maximó ponderado en el tiempo o ponderado en eventos de un conjunto
de valores.
• Median
Devuelve el valor medio (mediano) ponderado en el tiempo o ponderado en eventos de un
conjunto de uno o mas valores.
• Mid
Devuelve una subcadena dentro de una cadena.
• Min
Devuelve el valor mínimó ponderado en el tiempo o ponderado en eventos de un conjunto
de valores.
• Minute
Extrae el minuto de una expresión de tiempo.
• Mod
El operador que devuelve el resto del cociente de dos valores numericós.
• Month
Extrae el mes de una expresión de tiempo.
• NextEvent
Encuentra la marca de tiempo del siguiente valor registrado despues de una hora
especificada.
370
Guía del usuario PI System Explorer
Análisis basados en activos
• NextVal
Encuentra el siguiente valor registrado despues de una hora especificada.
• Noon
Devuelve la marca de tiempo correspondiente a las doce del mediódía de una expresión de
tiempo dada.
• NoOutput
No escribe el resultado del calculó actual.
• Normalrnd
Devuelve un numeró aleatorio que correlaciona la curva de distribución normal utilizando
un promedio y una desviación estandar determinados.
• NOT
Operador que devuelve la negación de una expresión.
• NumOfChanges
Devuelve la cantidad de cambios de valor de un atributo en un intervalo de tiempo
especificadó.
• O
Operador de disyunción lógica de dos expresiones.
• ParseTime
Traduce una expresión de tiempo de PI en una marca de tiempo.
• PctGood
Encuentra el porcentaje ponderado en el tiempo o ponderado en eventos, durante un
intervalo de tiempo especificadó, para el cual el atributo tenía valores correctos.
• Pi
Función de constante que devuelve el valor de pi.
• Poisson
Devuelve un numeró aleatorio que correlaciona una distribución de Poisson con una media
específica.
• Poly
Devuelve el polinomio c0 + c1x + c2x2 + … +cnxn.
• Pow
Devuelve x elevado a la potencia y.
• PrevEvent
Encuentra la marca de tiempo del ultimó valor registrado antes de una hora especificada.
• PrevVal
Encuentra el ultimó valor registrado antes de una hora especificada.
• PStDev
Devuelve la desviación estándar de la población ponderada en el tiempo o ponderada en
eventos de una póblación de uno o mas valores.
• Rand
Devuelve un numeró aleatorio a partir de un rango especificadó.
• Range
Encuentra la diferencia ponderada en el tiempo o ponderada en eventos entre los valores
maximó y mínimó de un atributo durante un intervalo de tiempo especificadó. Los valores
ponderados en el tiempo se interpolan en los límites de tiempo cuando es posible y, de lo
contrario, se extrapolan.
• Rate
Devuelve la diferencia a lo largo del tiempo entre el valor actual y un valor evaluado
anteriormente de un atributo o una expresión (de tiempo).
Guía del usuario PI System Explorer
371
Análisis basados en activos
• RecordedValues
Obtiene valores dentro de un intervalo de tiempo específicó segun el tipo de límite
especificadó por el usuario.
• RecordedValuesByCount
Obtiene una cantidad de valores especificada empezando en la hora de inicio solicitada y en
la dirección especificada.
• Remainder
Devuelve el resto que resulta de la división de x por y utilizando el metódó IEEERemainder.
• Right
Determina un numeró específicó de caracteres de una cadena empezando por la derecha.
• Round
Redondea un numeró o una hora a la unidad mas próxima.
• Roundfrac
Redondea un valor a un numeró especificadó de posiciones decimales.
• RTrim
Elimina los espacios en blanco finales de una cadena.
• Sec
Devuelve la secante trigónómetrica de un numeró.
• Sech
Devuelve la secante hiperbólica de un numeró.
• Second
Extrae el segundo de una expresión de tiempo.
• SecSinceChange
Devuelve la hora en segundos desde que se actualizó el valor de un atributo.
• Sgn
Devuelve un indicador del signo numericó de un numeró.
• Sin
Devuelve el seno trigónómetricó de un numeró.
• Sinh
Devuelve el seno hiperbólicó de un numeró.
• Split
Divide una cadena en subcadenas segun un delimitador especificadó.
• Sqr
Devuelve la raíz cuadrada de un numeró.
• StateNo
Traduce un estado digital a su valor de enumeración correspondiente.
• SStDev
Devuelve la desviación estándar de muestra ponderada en el tiempo o ponderada en eventos
de dos o mas argumentos que son una muestra de una póblación mayor.
• StDev
Encuentra la desviación estandar ponderada en el tiempo o ponderada en eventos de los
valores de un atributo a partir de un intervalo de tiempo especificadó.
• String
Convierte cualquier valor en una cadena.
• TagAvg
Encuentra el promedio ponderado en el tiempo o ponderado en eventos de los valores de un
atributo durante un intervalo de tiempo especificadó.
372
Guía del usuario PI System Explorer
Análisis basados en activos
• TagBad
Evalua el punto para un estado anormal a un tiempo especificadó.
• TagDesc
Para un atributo asociado a un PI point, recupera el descriptor de ese punto de la base de
datos de puntos.
• TagEU
Para un atributo asociado a un PI point, recupera la cadena de unidades de ingeniería de ese
punto de la base de datos de puntos.
• TagExDesc
Para un atributo asociado a un PI point, recupera el descriptor extendido de ese punto de la
base de datos de puntos.
• TagMax
Encuentra el valor maximó ponderado en el tiempo o ponderado en eventos de un atributo
durante un intervalo de tiempo especificadó. Los valores ponderados en el tiempo se
interpolan en los límites de tiempo cuando es posible y, de lo contrario, se extrapolan.
• TagMean
Encuentra el promedio (media) de los valores de un atributo durante un intervalo de tiempo
especificadó. TagAvg con la ópción ponderada en eventos proporciona el mismo resultado
que TagMean. Considere usar TagAvg en lugar de TagMean especialmente si TagAvg se
utiliza en otros analisis con la ópción ponderada en el tiempo.
• TagMin
Encuentra el valor mínimó ponderado en el tiempo o ponderado en eventos de un atributo
durante un intervalo de tiempo especificadó. Los valores ponderados en el tiempo se
interpolan en los límites de tiempo cuando es posible y, de lo contrario, se extrapolan.
• TagName
Para un atributo asociado a un PI point, obtiene un nombre de ese punto de la base de datos
de puntos.
• TagNum
Para un atributo asociado a un PI point, obtiene un numeró de ese punto de la base de datos
de puntos.
• TagSource
Para un atributo asociado a un PI point, obtiene un origen de punto de ese punto de la base
de datos de puntos.
• TagSpan
Para un atributo asociado a un PI point, obtiene un períódó de ese punto de la base de datos
de puntos.
• TagTot
Encuentra el valor total ponderado en el tiempo (integral de tiempo) o ponderado en
eventos de los valores de un atributo durante un intervalo de tiempo especificadó. Los
valores ponderados en el tiempo se interpolan en los límites de tiempo cuando es posible y,
de lo contrario, se extrapolan.
• TagType
Para un atributo asociado a un PI point, obtiene un tipo de punto de ese punto de la base de
datos de puntos.
• TagTypVal
Para un atributo asociado a un PI point, obtiene un valor típicó de ese punto de la base de
datos de puntos.
• TagVal
Devuelve el valor de un atributo a una hora especificada.
Guía del usuario PI System Explorer
373
Análisis basados en activos
• TagZero
Para un atributo con una referencia de datos de PI point, obtiene un valor "cero" de ese
punto de la base de datos de puntos.
• Tan
Devuelve la tangente trigónómetrica de un numeró.
• Tanh
Devuelve la tangente hiperbólica de un numeró.
• Text
Concatena cadenas que representan valores de argumento.
• THEN
Operador que devuelve el primero de dos valores especificadós cuando la expresión
condicional del enunciado IF-THEN-ELSE es True.
• TimeEq
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo es igual a un
valor especificadó.
• TimeGE
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo es mayor o
igual que un valor especificadó.
• TimeGT
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo es mayor
que un valor especificadó.
• TimeLE
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo es menor o
igual que un valor proporcionado.
• TimeLT
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo es menor
que un valor especificadó.
• TimeNE
Encuentra el tiempo total, dentro de un intervalo, en que el valor de un atributo no es igual a
un valor especificadó.
• TimeStamp
Devuelve la marca de tiempo para una solo valor con marca de tiempo o una matriz de
valores con marca de tiempo.
• Total
Devuelve la suma de dos o mas valores ponderada en el tiempo o ponderada en eventos.
• Trim
Elimina los espacios en blanco a ambos lados de una cadena.
• Trunc
Trunca un numeró o una hora a la siguiente unidad mas baja.
• UCase
Convierte en mayusculas una cadena.
• Weekday
Extrae el día de la semana a partir de una expresión de tiempo.
• Year
Extrae el anó de una expresión de tiempo.
• Yearday
Extrae el día del anó a partir de una expresión de tiempo.
374
Guía del usuario PI System Explorer
Análisis basados en activos
Abs
Devuelve el valor absoluto de un numeró entero o real.
Sintaxis
Abs(x)
Argumentos
• x
Un numeró entero o real
Devuelve
El valor absoluto de x
Excepciones
Devuelve un error si x no es un numeró entero o real
Notas
La unidad de medida del argumento, si existe, se traslada al resultado
Ejemplo
• Abs(-2.2)
[Devuelve 2.2]
• Abs('att1')
[Devuelve el valor absoluto de 'att1' al momento de la activación]
Acos
Devuelve el coseno inverso o (arcocoseno) de un numeró entero o real. El coseno inverso de x
es el anguló en radianes cuyo coseno es igual a x.
Sintaxis
Acos(x)
Argumentos
• x
Debe ser un numeró real entre -1.0 y 1.0, inclusive
Devuelve
El coseno inverso de x, en radianes
Excepciones
Si x no es un numeró, o es menor de -1.0 o mayor de 1.0, devuelve un error
Ejemplo
• Acos(-0.5)
[Devuelve 2.0944]
• Acos(0.75)
Guía del usuario PI System Explorer
375
Análisis basados en activos
[Devuelve 0.72273]
AND
La cónjunción lógica de dos expresiones que devuelve True si ambas expresiones son
verdaderas y False en caso contrario.
Sintaxis
expression1 AND expression2
Argumentos
• expression1, expression2
Cualquier expresión que da como resultado verdadero o falso
Devuelve
True si ambas expresiones son verdaderas (distintas de cero) y False (cero) en caso contrario.
Excepciones
Ninguna
Notas
Si las entradas son numericas, AND puede hacer operaciones con bits.
Ejemplo
• ('att1' > 50) AND ('att2' = "good")
ArrayLength
Obtiene la longitud de una matriz.
Sintaxis
ArrayLength(a1)
Argumentos
• a1
una variable que representa la matriz de óperación
Devuelve
el numeró de valores en la matriz
Excepciones
Ninguna
Notas
Ninguna
Ejemplo
• ArrayLength(Data)
[Devuelve el numeró de valores de una matriz denominada Data]
376
Guía del usuario PI System Explorer
Análisis basados en activos
Ascii
Devuelve el códigó de caracter ASCII del primer caracter de una cadena.
Sintaxis
Ascii(s1)
Argumentos
• s1
Cualquier expresión que se evalue en una cadena
Devuelve
El códigó del primer caracter de la cadena
Excepciones
Si el argumento no es una cadena, se devuelve un error.
Ejemplo
• Ascii("D")
[Devuelve 68, el códigó de caracter ASCII de D]
• Ascii("Program")
[Devuelve 80, el códigó de caracter ASCII de la primera letra de una cadena]
Asin
Devuelve el seno inverso (arcoseno) de un numeró. El seno inverso de x es el anguló en
radianes cuyo seno es igual a x.
Sintaxis
Asin(x)
Argumentos
• x
Debe ser un numeró real entre -1.0 y 1.0, inclusive
Devuelve
El seno inverso de x, en radianes
Excepciones
Si x no es un numeró, o es menor de -1.0 o mayor de 1.0, se devuelve un error.
Ejemplo
• Asin(-0.5)
[Devuelve -0.5236]
• Asin(TagVal('att1','y+8h'))
[Devuelve el seno inverso del valor de 'att1' a las 8:00 a. m. de ayer]
• Asin('att1')
Guía del usuario PI System Explorer
377
Análisis basados en activos
[Devuelve el seno inverso del valor de 'att1' a la hora de activación]
Atn
Devuelve la tangente inversa o (arcotangente) de un numeró entero o real. La tangente inversa
de x es el anguló en radianes cuya tangente es igual a x.
Sintaxis
Atn(x)
Argumentos
• x
Debe ser un numeró entero o real.
Devuelve
La tangente inversa de x, en radianes
Excepciones
Devuelve un error si x no es un numeró entero o real
Ejemplo
• Atn(1)
[Devuelve 0.7854]
• Atn(-2.2)
[Devuelve -1.1442]
• Atn('att1')
[Devuelve la tangente inversa del valor de 'att1' a la hora de activación]
• Atn('att1' - 'att2')
[Devuelve la tangente inversa de la diferencia entre 'att1' y 'att2' a la hora de activación]
Atn2
Devuelve la tangente inversa (arcotangente) de un valor de tangente a/b. La tangente inversa
es el anguló medido en radianes desde el eje x positivo hasta una línea cuyos puntos finales son
el origen y las coordenadas cartesianas (b,a).
Sintaxis
Atn2(x, y)
Argumentos
• x
Un numeró entero o real
• y
Un numeró entero o real distinto de cero
Devuelve
La tangente inversa en radianes del valor de tangente x/y
378
Guía del usuario PI System Explorer
Análisis basados en activos
Excepciones
Devuelve un error si x o y no es un numeró entero o real
Ejemplo
• Atn2(1,2)
[Devuelve 0.46365]
• Atn2('att1', 'att2')
[Devuelve la tangente inversa en radianes del valor de tangente 'att1'/'att2' a la hora de
activación]
• Atn2(TagVal('att1','y+8h'), TagVal('att2', 'y+8h'))
[Devuelve la tangente inversa en radianes del valor de tangente 'att1'/'att2' a las 8 a. m. de
ayer]
Avg
Devuelve el promedio ponderado en el tiempo o ponderado en eventos de un conjunto de uno o
mas valores.
Sintaxis
Avg(x1 [, ... xn])
Avg(array [, calculationBasis])
Argumentos
• x1, ... xn
Los argumentos o una sola matriz del mismo tipo de valor (numerós enteros y reales,
expresiones de tiempo o intervalos de tiempo)
• calculationBasis
Opcional. El tipo de calculó a realizar entre comillas dobles. Elija entre "Ponderado en
eventos" o "Ponderado en el tiempo". Si no lo elige, el valor predeterminado se pónderara en
eventos. Si selecciona "Ponderado en el tiempo", la primera marca de tiempo del valor marca
la hora de inicio y la ultima marca de tiempo marca el final del intervalo de tiempo.
Devuelve
El promedio de uno o mas valores. El resultado es del mismo tipo de datos que los argumentos.
Excepciones
Los argumentos cuyos valores de tiempo de ejecución sean cadenas de caracteres o estados
digitales no se incluyen en el promedio. Si todos los valores son cadenas de caracteres o estados
digitales, Avg devuelve un error. Devuelve un error si la matriz no se compone del mismo tipo
de valor.
Guía del usuario PI System Explorer
379
Análisis basados en activos
Notas
• La unidad de medida (UOM) del argumento se traslada al resultado cuando por lo menos un
argumento tiene una UOM definida, mientras que otras no la tienen. El valor devuelto no
contiene una UOM si los argumentos tienen diferentes UOM.
Ejemplo
• Avg(14, 'att1', 14.5, TagVal('att2', '14-Dec-16'))
[Encuentra el promedio de estos valores: 14, el valor actual de 'att1', 14.5, y el valor de 'att2'
correspondiente al 14 de diciembre de 2016 al comienzo del día (12:00 a. m.)]
• Avg('*', 'y+8h', 'Saturday')
[Encuentra el promedio de estas marcas temporales: ahora, ayer a las 8:00 a. m., y el sabadó
pasado al comienzo del día (12:00 a. m.)]
• Avg('*'-'*-1h', 't+4h'-'y+8h', 'y+2h'-'20')
[Encuentra el promedio de estos períódós: desde hace 1 hora hasta ahora, desde ayer a las
8:00 a. m. hasta hoy a las 4:00 a. m., y desde ayer a las 2:00 a. m. hasta el 20 de este mes al
comienzo del día (12:00 a. m.)]
• Avg(Variable1)
Nota:
Name
Expresión
Valor en la evaluación
Variable1
RecordedValues('att1',
'*-10m', '*')
[1, 3, 5, 7, 9]
Variable 2
Avg(Variable1)
5
[Encuentra el promedio de los valores de una matriz denominada Variable1]
• Avg(Data)
[Devuelve el promedio ponderado en eventos de los valores de una matriz denominada
Data]
• Avg(Data, "EventWeighted")
[Devuelve el promedio ponderado en eventos de los valores de una matriz denominada
Data]
• Avg(Data, "TimeWeighted")
[Devuelve el promedio ponderado en el tiempo de los valores de una matriz denominada
Data con la primera marca de tiempo del valor como la hora de inicio y la ultima marca de
tiempo como la hora de finalización.]
BadVal
Pruebe un valor para ver si es incorrecto. Para un atributo asociado a un PI point, el valor del
estado digital del sistema se considera incorrecto (No Data o Calc Failed, por ejemplo).
Sintaxis
Badval(x)
Argumentos
380
Guía del usuario PI System Explorer
Análisis basados en activos
• x
cualquier expresión que se evalue en un valor
Devuelve
True si el valor es incorrecto
False si el valor es correcto
Excepciones
Devuelve True para PI points de BLOB. Devuelve False para PI points de cadenas
Ejemplo
• BadVal(1/0)
[Devuelve True]
• BadVal(10)
[Devuelve False]
• BadVal('att1')
[Devuelve True si el valor de 'att1' es incorrecto]
• BadVal(FindEq('att1', 't', '*', 10))
[Devuelve True si la función integrada (FindEq en este ejemplo) no tiene resultado o tiene
un error por algun motivo]
Bod
Devuelve una marca de tiempo correspondiente al comienzo del día a partir de una expresión
de tiempo.
Sintaxis
Bod(t1)
Argumentos
• t1
Una expresión de tiempo entre comillas simples
Devuelve
Marca de tiempo correspondiente al comienzo del día
Excepciones
Ninguna
Notas
Esta función es util para establecer una hora de reloj unica independiente de la duración de
días concretos.
Ejemplo
• Bod('*')
[Devuelve una marca de tiempo correspondiente al comienzo del día de hoy.]
• Bod('y')
Guía del usuario PI System Explorer
381
Análisis basados en activos
[Devuelve una marca de tiempo correspondiente al comienzo del día de ayer.]
• Bod(FindEq('att1', '-3d', '*', 50))
[Devuelve una marca de tiempo correspondiente al comienzo del día en que el valor de 'att1'
fue igual a 50 por primera vez en las ultimas 72 horas.]
Bom
Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes a
partir de una expresión de tiempo dada.
Sintaxis
Bom(t1)
Argumentos
• t1
Una expresión de tiempo
Devuelve
Marca de tiempo correspondiente al comienzo del mes.
Excepciones
Ninguna
Notas
Esta función es util para establecer una hora de reloj unica independiente de la duración de
días concretos.
Ejemplo
• Bom('*')
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día de este
mes.]
• Bom(PrevEvent('att1', '*'))
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes en
que 'att1' tuvo un valor antes del actual.]
• Bom(FindEq('att1', '-60d', '*', 50))
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes en
que el valor de 'att1' fue igual a 50 por primera vez en los ultimós 60 días.]
Bonm
Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes
siguiente a partir de una expresión de tiempo dada.
Sintaxis
Bonm(t1)
Argumentos
382
Guía del usuario PI System Explorer
Análisis basados en activos
• t1
Expresión de tiempo entre comillas simples
Devuelve
Marca de tiempo correspondiente al comienzo del mes siguiente.
Excepciones
Ninguna
Notas
Esta función es util para establecer una hora de reloj unica independiente de la duración de
días concretos.
Ejemplo
• Bonm('*')
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes
siguiente.]
• Bonm('y')
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes
siguiente a partir de la fecha de ayer.]
• Bonm(FindEq('att1', '-60d', '*', 50))
[Devuelve una marca de tiempo correspondiente a la medianoche del primer día del mes
siguiente en que el valor de 'att1' fue igual a 50 por primera vez en los ultimós 60 días.]
Ceiling
Devuelve el entero mas cercano mayor o igual que x.
Sintaxis
Ceiling(x)
Argumentos
• x
numeró entero o real, un atributo cuyo valor da como resultado un numeró
Devuelve
El numeró entero mas cercano mayor o igual que x
Excepciones
Devuelve un error si x es un estado digital, una expresión de tiempo, un intervalo de tiempo o
una cadena
Notas
La unidad de medida del argumento, si existe, se traslada al resultado
Ejemplo
• Ceiling(2.3)
Guía del usuario PI System Explorer
383
Análisis basados en activos
[Devuelve 3]
• Ceiling(-2.3)
[Devuelve -2]
• Ceiling(TagVal('att1', '12/30/16'))
[Devuelve el numeró entero mas cercano del valor de 'att1' correspondiente al 30 de
diciembre de 2016 al comienzo del día (12:00 a. m.)]
Char
Genera una cadena a partir de códigós de caracter ASCII.
Sintaxis
Char(x1, ... xn)
Argumentos
• x1, ... xn
Enteros
Devuelve
Una cadena generada a partir de códigós de 80 caracteres
Excepciones
Devuelve un error si un argumento no es un numeró.
Ejemplo
• Char(80, 73)
[Devuelve "PI".]
• Char(65)
[Devuelve "A".]
• Char(5 * 10)
[Devuelve "2".]
Compare
Comparar dos cadenas utilizando caracteres cómódín ("*" y"?") o comparar dos operandos
utilizando operadores lógicós y un valor de la banda muerta.
Sintaxis
Compare {[(s1, s2 [, caseSensitive])]|[x1, x2, op, deadband]}
Argumentos
• s1, s2
cadenas (s2 puede incluir caracteres cómódín)
384
Guía del usuario PI System Explorer
Análisis basados en activos
• caseSensitive
Indicador opcional que senala si la cómparación distingue entre mayusculas y minusculas. Si
es False (el valor predeterminado), la cómparación no distingue entre mayusculas y
minusculas. Si es True, la cómparación distingue entre mayusculas y minusculas.
• x1, x2
Valor numericó (numeró entero o real) o expresión de tiempo
• op
Un operador que se utiliza para la cómparación. Debe ser uno de los siguientes operadores,
o una variable definida como una de estas: <, >, <=, >=
• deadband
Valor numericó (numeró entero o real) o períódó. Deadband especifica un bufer (tolerancia)
en torno a x2 y evita la repetición de alertas cuando el valor fluctua en el rango de la
deadband.
Returns
• True si s1 = s2
• True if x1 <op> x2 is true, and uses deadband value for subsequent evaluations
False en caso contrario
Excepciones
Los caracteres cómódín en s1 se tratan de forma literal y no como comodines.
El valor de la banda muerta se aplica a x2, y no a x1.
Ejemplo
• Compare('att1', 100, "<=", 5)
[Devuelve True si 'att1' es menor o igual que 100, y utiliza el valor 5 de la banda muerta
para evaluaciones posteriores.]
• Compare("What", "what", True)
[Devuelve False.]
• Compare("b", "a")
[Devuelve False.]
• Compare("What", "wha?")
[Devuelve True.]
• Compare("What", "wh")
[Devuelve False.]
Concat
Cóncatenación de dos o mas cadenas.
Sintaxis
Concat(s1, s2 [, ... sn])
Guía del usuario PI System Explorer
385
Análisis basados en activos
Argumentos
• s1, ... sn
Deben ser cadenas de caracteres o expresiones que produzcan cadenas de caracteres.
Devuelve
Cadenas de caracteres concatenadas juntas. Esta función no inserta espacios en blanco entre
los argumentos. Para incluir un espacio en una cadena concatenada, agregue un argumento que
consista de una cadena que contenga un espacio simple entre comillas dobles.
Ejemplo
• Concat("shut", "down")
[Devuelve "shutdown"]
• Concat("shut ", "down")
[Devuelve "shut down"]
Contains
Determina si la primera cadena contiene la segunda cadena y devuelve True o False.
Sintaxis
Contains(s1, s2 [,caseSensitive])
Argumentos
• s1
Cadena principal
• s2
Subcadena que se busca en la cadena principal
• caseSensitive
Opcional: valor booleano que indica si la busqueda distingue entre mayusculas y
minusculas. Si es False (o se omite), la busqueda no distingue entre mayusculas y
minusculas. Si es True, la busqueda distingue entre mayusculas y minusculas
Devuelve
True si la cadena principal (s1) contiene la subcadena (s2), y False en caso contrario
Excepciones
Si alguno de los dos primeros argumentos (s1 o s2) no es una cadena, la función devuelve un
error
Si el tercer argumento opcional (caseSensitive) no es un valor booleano, la función devuelve un
error
Ejemplo
• Contains("What","Hat",True)
[Devuelve False]
• Contains("What","Hat")
386
Guía del usuario PI System Explorer
Análisis basados en activos
[Devuelve True]
• Contains("What","at")
[Devuelve True]
• Contains("hat","what")
[Devuelve False]
Convert
Convertir un valor desde su unidad de medida actual (UOM) en una UOM especificada; para un
valor que no tenga ninguna UOM, asigne la UOM especificada.
Sintaxis
Convert(x, toUnit)
Argumentos
• x
Cualquier expresión que se resuelve en un valor numericó, incluido el nombre de un
atributo numericó entre comillas simples, un nombre de variable o una constante.
• toUnit
La UOM de salida entre comillas dobles
Returns
El valor numericó convertido en la UOM especificada
Excepciones
Devuelve un error si toUnit y la UOM inicial de x no estan en la misma clase de UOM.
Ejemplo
• Convert('MetricWeight', "lb")
• Convert('Ambient Temperature', "degC")
Nota:
PI AF sustituye deg con °, si no se encuentra en la busqueda.
Cos
Devuelve el coseno trigónómetricó de un numeró entero o real.
Sintaxis
Cos(x)
Argumentos
• x
Debe ser un numeró entero o real, que representa un anguló en radianes
Devuelve
El coseno de x
Guía del usuario PI System Explorer
387
Análisis basados en activos
Excepciones
Si x no es un numeró entero ni real, devuelve un error
Ejemplo
• Cos(1.1)
[Devuelve 0.4536]
• Cos(1)
[Devuelve 0.5403]
• Cos('att1')
[Devuelve el coseno trigónómetricó del valor de 'att1' a la hora de activación]
Cosh
Devuelve el coseno hiperbólicó de un numeró.
Sintaxis
Cosh(x)
Argumentos
• x
Debe ser un numeró entero o real.
Devuelve
El coseno hiperbólicó de x
Excepciones
Si x no es un numeró entero ni real, devuelve un error
Ejemplo
• Cosh(1)
[Devuelve 1.5431]
• Cosh(-1)
[Devuelve 1.5431]
• Cosh('att1')
[Devuelve el coseno hiperbólicó del valor de 'att1' a la hora de activación]
Cot
Devuelve la cotangente trigónómetrica de un numeró.
Sintaxis
Cot(x)
Argumentos
• x
Debe ser un numeró entero o real, que representa un anguló en radianes
388
Guía del usuario PI System Explorer
Análisis basados en activos
Devuelve
La cotangente de x
Excepciones
Si x no es un numeró, devuelve un error
Ejemplo
• Cot(1)
[Devuelve 0.64209]
• Cot(1.1)
[Devuelve 0.50897]
• Cot('att1')
[Devuelve la cotangente trigónómetrica del valor de 'att1' a la hora de activación]
Coth
Devuelve la cotangente hiperbólica de un numeró.
Sintaxis
Coth(x)
Argumentos
• x
Debe ser un numeró entero o real.
Devuelve
La cotangente hiperbólica de x
Excepciones
Si x no es un numeró, devuelve un error
Ejemplo
• Coth(1)
[Devuelve 1.313]
• Coth(1.1)
[Devuelve 1.2492]
• Coth('att1')
[Devuelve la cotangente hiperbólica del valor de 'att1' a la hora de activación]
Cov
Determine la covarianza entre dos conjuntos de valores segun los atributos con respecto a un
intervalo de tiempo especificadó.
Sintaxis
Cov(x, y, mode, starttime, endtime, type [, pctgood])
Guía del usuario PI System Explorer
389
Análisis basados en activos
Argumentos
• x
Un atributo con el primer conjunto de datos temporales en serie (referencia de datos de PI
point) entre comillas simples.
• y
Un atributo con el segundo conjunto de datos temporales en serie (referencia de datos de PI
point) entre comillas simples.
• de diseño.
Un numeró que especifica cómó alinear valores con marca de tiempo.
Elija entre 0, 1 o 2, donde:
0 representa la cómbinación de valores con marcas de tiempo de x e y.
1 representa valores de ambos atributos segun las marcas de tiempo de x.
2 representa valores de ambos atributos segun las marcas de tiempo de y.
• starttime
Una expresión de tiempo que representa el comienzo de un intervalo de tiempo entre
comillas simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a un
endtime absoluto.
• endtime
Una expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a un starttime
absoluto.
• tipo
Un numeró que especifica el tipo de covarianza: use 0 para “póblación” y 1 para “muestra”.
• pctgood
Opcional. Porcentaje mínimó de tiempo durante el intervalo de tiempo en el que los valores
del atributo deben ser correctos.
Puede establecer pctgood como un umbral para asegurarse de que hay valores correctos
suficientes para calcular la Cov.
Returns
Covarianza de x y y.
Excepciones
Si el atributo no posee valores correctos, o no se alcanza el pctgood mínimó para el intervalo de
tiempo especificadó, se devuelve un valor erróneó.
Notas
Los valores incorrectos se excluyen del calculó de Cov.
390
Guía del usuario PI System Explorer
Análisis basados en activos
PRECAUCIÓN:
Si el atributo posee muy pocos valores correctos durante el intervalo de tiempo, es
posible que el resultado de esta función no sea cónfiable. Utilice la función PctGood para
averiguar que porcentaje de los valores es correcto.
Ejemplo
• Cov('att1', 'att2', 0, 't', '+1h', 1, 80)
[Devuelve la covarianza de muestra de 'att1' y 'att2' entre las 12:00 a. m. y la 1:00 a. m. de
hoy cuando, al menos, el 80 % de los valores eran correctos. Devuelve un error si no se
alcanza el mínimó de pctgood].
• Cov('att1', 'att2', 1, 't', '+1h', 1)
[Devuelve la covarianza de póblación de 'att1' y 'att2' segun las marcas de tiempo de 'att1'
entre las 12:00 a. m. y la 1:00 a. m. de hoy],
Csc
Devuelve la cosecante trigónómetrica de un numeró.
Sintaxis
Csc(x)
Argumentos
• x
Debe ser un numeró entero o real, que representa un anguló en radianes
Devuelve
La cosecante de x
Excepciones
Si x no es un numeró, devuelve un error
Ejemplo
• Csc(1)
[Devuelve 1.1884]
• Csc(1.1)
[Devuelve 0.7487]
• Csc('att1')
[Devuelve la cosecante trigónómetrica del valor de 'att1' a la hora de activación]
Csch
Devuelve la cosecante hiperbólica de un numeró.
Sintaxis
Csch(x)
Argumentos
Guía del usuario PI System Explorer
391
Análisis basados en activos
• x
Debe ser un numeró entero o real.
Devuelve
La cosecante hiperbólica de x
Excepciones
Si x no es un numeró, devuelve un error
Ejemplo
• Csch(1)
[Devuelve 0.85092]
• Csch(1.1)
[Devuelve 0.748]
• Csch('att1')
[Devuelve la cosecante hiperbólica del valor de 'att1' a la hora de activación]
Curve
Para un valor x determinado, devuelve el valor de una función de interpólación lineal por trozo
definida por el conjunto de n puntos (x1,y1)...(xn,yn).
Sintaxis
Curve(x, (x1,y1) (x2,y2) … (xn,yn) )
Argumentos
• x
Expresión que se evalue en un numeró
• x1, y1
El primer punto de la curva. Los valores de xi's y de yi's son constantes numericas que se
evaluan durante el tiempo de cómpilación. Los valores ajustados para xi's deben estar en
orden ascendente.
Devuelve
Para un valor x determinado, devuelve el valor de una función de interpólación lineal por trozo
definida por el conjunto de n puntos (x1,y1)...(xn,yn). Si el valor de x es menor que x1 entonces y1
se devuelve, y si es mayor que xn, yn se devuelve. Se presupone que los puntos estan ordenados
en el sentido de x, del mas pequenó al mas grande.
Excepciones
Si el valor de x no es un numeró entero o real, se devuelve un error
Ejemplo
• Curve(3, (0,100) (100,0) )
[Devuelve 97]
• Curve('att1', (25,25) (75,75) )
392
Guía del usuario PI System Explorer
Análisis basados en activos
Day
Extrae el día del mes a partir de una expresión de tiempo.
Sintaxis
Day(t1)
Argumentos
• t1
expresión de tiempo incluida entre comillas simples
Returns
El día del mes de una expresión de tiempo, en el rango de 1 a 31.
Excepciones
Ninguna
Ejemplo
• Day('*')
[Devuelve el día del mes que es hoy.]
• Day('y')
[Devuelve el día del mes que fue ayer.]
• Day(FindEq('att1', '-28d', '*', 50))
[Devuelve el día del mes que fue cuando el valor de 'att1' fue igual a 50 por primera vez en
los ultimós 28 días.]
DaySec
Devuelve el tiempo total, en segundos, entre el comienzo del día (medianoche) y la hora
designada en el argumento.
Sintaxis
DaySec(t1)
Argumentos
• t1
Una expresión de tiempo entre comillas simples
Devuelve
Cantidad total de segundos desde el comienzo del día (medianoche) hasta t1, en el rango de
0 a 86399
Excepciones
Ninguna
Ejemplo
• DaySec('*')
[Devuelve la cantidad de segundos desde el comienzo del día (medianoche) hasta ahora]
Guía del usuario PI System Explorer
393
Análisis basados en activos
DeltaValue
Devuelve la diferencia entre los valores o las evaluaciones actual e inmediatamente anterior de
un atributo con un tipo de valor numericó o DateTime.
Sintaxis
DeltaValue(x [, prevEval])
Argumentos
• x
Un atributo o expresión de un tipo de valor numericó o DateTime
• prevEval
(Booleano) Si False o no se especifica, x debe ser un atributo, y DeltaValue devuelve la
diferencia entre su valor actual y el valor inmediatamente anterior.
Si True, DeltaValuedevuelve la diferencia entre las evaluaciones actual e inmediatamente
anterior de x, que puede ser cualquier expresión con un tipo de valor numericó o DateTime
Devuelve
Devuelve la diferencia entre el valor actual y el valor inmediatamente anterior de un atributo
con un tipo de valor numericó o DateTime, o la diferencia entre las evaluaciones actual e
inmediatamente anterior de cualquier expresión con un tipo de valor numericó o DateTime
Notas
Si x es de un tipo de dato DateTime, DeltaValue devuelve el intervalo de tiempo (en
segundos) entre dos valores DateTime. Si el valor de intervalo de tiempo se asigna a un
atributo, asegurese de que el tipo de dato del atributo este cónfiguradó para duplicarse
Esta función puede emplear valores de entrada de PI points. Si la cómpresión esta activada para
un PI point, es posible que no se conserven todos sus valores en PI Data Archive. Antes de
intentar validar los resultados de esta función con una herramienta cliente, como PI DataLink,
asegurese de que la cómpresión este desactivada. Esto es para garantizar que todos los valores
de PI point asociados se incluyan en la validación. Una vez finalizada la validación, procure
volver a activar la cómpresión como practica óptima
La unidad de medida del argumento, si existe, se traslada al resultado
Ejemplo
• DeltaValue('att1' [, FALSE])
[Devuelve la diferencia entre los valores actual e inmediatamente anterior de 'att1']
• DeltaValue('att1', TRUE)
[Devuelve la diferencia entre el valor actual y el ultimó valor evaluado de 'att1']
DigState
Convierte una cadena en un objeto del estado digital de PI Data Archive correspondiente, ya sea
en función de la enumeración del estado digital del atributo o de los valores de un conjunto de
enumeración del sistema (por ejemplo, Calc Failed). Use el comando DigState integrado en
otras funciones si el objeto del estado digital de PI Data Archive es necesario para una entrada
(por ejemplo, con StateNo) o en forma conjunta con otras funciones para la cómparación con
atributos de estado digital.
394
Guía del usuario PI System Explorer
Análisis basados en activos
Sintaxis
DigState(s1 [, x])
Argumentos
• s1
Una cadena que representa un estado digital entre comillas dobles
• x
Opcional: un atributo con una referencia de estado digital de PI point o de un conjunto de
enumeración de tipos de valor. Si se omite, solo el conjunto digital del sistema se buscara
para esa cadena determinada.
Devuelve
Un valor de enumeración
Excepciones
Si la cadena no representa un estado digital del atributo especificadó, la función devuelve Calc
Failed. Si el atributo se omite, y la cadena no representa un estado digital del sistema, se
devuelve Calc Failed.
Ejemplo
• 'att1' > DigState("Program", 'att1')
[Devuelve True si el estado digital actual de 'att1' es mayor que el estado digital
representado por el valor "Program"]
• DigState("No Result")
[Construye un valor con el estado digital del sistema No Result]
DigText
Obtiene el texto que corresponde al estado digital.
Sintaxis
DigText(digstate)
Argumentos
• digstate
Un argumento que da como resultado un estado digital
Devuelve
El texto para el estado digital
Excepciones
Devuelve un error si el argumento no es un estado digital.
Ejemplo
• DigText(TagVal('enum_att1', 'y'))
[Devuelve el valor de estado digital en una cadena]
• DigText('enum_att1')
Guía del usuario PI System Explorer
395
Análisis basados en activos
[Devuelve un valor de estado digital en una cadena. Devuelve un mensaje de error si
'enum_att1' no es un atributo de PI point con un valor de estado digital]
E
Devuelve el valor de e (la base del logaritmo natural).
Sintaxis
E()
Argumentos
Ninguna
Returns
El valor de e (la base del logaritmo natural).
Excepciones
Ninguna
Ejemplo
• E()
ELSE
Operador que devuelve el segundo de dos valores especificadós cuando la expresión
condicional del enunciado IF-THEN-ELSE es True.
Sintaxis
IF (expression) THEN (x) ELSE (y)
Argumentos
• expression
Cualquier expresión que da como resultado verdadero o falso
• x, y
Una expresión que da como resultado un valor de salida
Devuelve
x cuando la expresión condicional es verdadera y y cuando la expresión es falsa
Excepciones
Ninguna
Ejemplo
• IF ('att1' > 50) THEN ('att2') ELSE ('att3')
[Si el valor de 'att1' es mayor de 50, devuelve el valor de 'att2'; de lo contrario, devuelve el
valor de 'att3']
396
Guía del usuario PI System Explorer
Análisis basados en activos
EventCount
Encuentra la cantidad de eventos de un atributo durante un intervalo de tiempo especificadó.
Sintaxis
EventCount(attname, starttime, endtime [, pctgood])
Argumentos
• attname
atributo con datos temporales en serie (referencia de datos de PI point) entre comillas
simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a un starttime
absoluto
• pctgood
Opcional: porcentaje mínimó de valores correctos de los eventos que se encuentran en el
intervalo de tiempo especificadó.
Devuelve
Cantidad de eventos de un atributo durante un intervalo de tiempo especificadó.
Excepciones
Arroja un error si no se llega al mínimó de pctgood para el intervalo de tiempo especificadó.
Notas
PRECAUCIÓN:
Si el atributo posee muy pocos valores correctos durante el intervalo de tiempo, es
posible que el resultado de esta función no sea cónfiable. Use las funciones PctGood para
averiguar que porcentaje de los valores es correcto.
Ejemplo
• EventCount('att1', 't', '+1h')
[Devuelve el recuento de eventos entre las 12:00 a. m. y la 1:00 a. m. de hoy.]
• EventCount('att1', 't', '+1h', 80)
[Devuelve el recuento de eventos entre las 12:00 a. m. y la 1:00 a. m. de hoy cuando al menos
el 80 % de los valores eran correctos.]
EventFrame
Devuelve el valor de las propiedades de event frame.
Guía del usuario PI System Explorer
397
Análisis basados en activos
Sintaxis
EventFrame(parameter)
Argumentos
• parameter
StartTime, EndTime o Duration de la cadena de parametrós entre comillas dobles; no
distingue entre mayusculas y minusculas
Devuelve
El valor del parametró
Excepciones
Si event frame no esta activo o aun esta abierto, devuelve No Results
Notas
• Esta función solo se debe utilizar cuando se cónfiguran las expresiones de salida en un
analisis de generación de event frame
• La salida puede asignarse a un atributo con el tipo de valor DateTime para StartTime y
EndTime. Para Duration, seleccionar dobles (el tiempo se devuelve en segundos)
• Puede crear una vista previa de los resultados haciendo clic con el bótón derecho en el
analisis
Ejemplo
• EventFrame("Duration")
[Devuelve la duración de un event frame. El tiempo se devuelve en segundos]
• TagAvg('att1', EventFrame("StartTime"), EventFrame("EndTime"))
[Encuentra el promedio ponderado en el tiempo de los valores de 'att1' durante un event
frame]
Exit
Detenga el analisis para que no ejecute mas evaluaciones.
Sintaxis
Exit()
Argumentos
Ninguna
Notas
• Es importante incluir los parentesis despues de esta función. Use Exit() en lugar de Exit.
• Supongamos que tiene multiples expresiones en un unicó analisis o en una secuencia de
analisis que forma una cadena de dependencias. El calculó finaliza cuando presiona Salir.
Ejemplo
• IF 'att1' < 100 OR 'att1' > 200 THEN 'att1' ELSE Exit()
398
Guía del usuario PI System Explorer
Análisis basados en activos
Exp
Devuelve el exponencial de un numeró entero o real. Este es el numeró ex, donde e =
2.7182818...
Sintaxis
Exp(x)
Argumentos
• x
Debe ser un numeró entero o real.
Devuelve
El exponencial de x
Excepciones
Si x no es un numeró entero ni real, devuelve un error
Ejemplo
• Exp(11)
[Devuelve 59874]
• Exp('att1')
[Devuelve el exponencial del valor de 'att1' a la hora de activación]
• Exp(TagVal('att1','t'))
[Devuelve el exponencial del valor de 'att1' correspondiente al comienzo del día de hoy
(12:00 a. m.)]
FilterData
Obtener todos los valores en una matriz que cumplen con una cóndición determinada.
Sintaxis
FilterData(a1, condition($val))
Argumentos
• a1
una variable que representa la matriz de óperación
• condition($val)
cualquier declaración PE compatible, como una función de $val, que devuelve un valor
verdadero o falso. $val es un placeholder para cada valor de la matriz
Devuelve
Una matriz de todos los valores que cumplan con la cóndición determinada
Excepciones
Ninguna
Guía del usuario PI System Explorer
399
Análisis basados en activos
Notas
Ninguna
Ejemplo
• FilterData(Data, (NOT BadVal($val) AND $val > 50))
[A partir de una matriz denominada Data, devuelve una nueva matriz de valores en la que
ninguno es un valor incorrecto y todos superan 50]
FindEq
Encuentra la marca de tiempo mas próxima a starttime en un intervalo de tiempo
especificadó en que un atributo es igual a un valor especificadó.
Sintaxis
FindEq(attname, starttime, endtime, x)
Argumentos
• attname
nombre de un atributo entre comillas simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
• x
El valor para buscar debe ser un numeró entero o real, o un estado digital (cadena de
caracteres).
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo especificadó en el cual el
atributo era igual al valor especificadó.
Excepciones
Si el atributo nunca era igual al valor especificadó; se devuelve un error.
Notas
• Si es necesario, se realiza una interpólación entre los valores de atributo para determinar
cuandó el atributo era igual al valor especificadó.
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo.
400
Guía del usuario PI System Explorer
Análisis basados en activos
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado anteriormente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindEq('att1', '-1h', '*', 40)
[Devuelve la marca de tiempo de la primera vez desde hace una hora (starttime) en que
'att1' era igual a 40]
• FindEq('enum_att1', '30-March-17', '*', "On")
[Devuelve la marca de tiempo de la primera vez desde el comienzo del día
(12:00 a. m.starttime) del 30 de marzo de 2017 en que el valor de enumeración
'enum_att1' era igual a "On"]
FindGE
Encuentra la primera vez en un intervalo de tiempo en que un atributo es mayor o igual que un
valor especificadó.
Sintaxis
FindGE(attname, starttime, endtime, x)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
• x
El valor para buscar debe ser un numeró entero o real, o un estado digital (cadena de
caracteres).
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo de tiempo especificadó en el cual el
atributo era mayor o igual que el valor especificadó. Devuelve el estado digital del sistema
correspondiente (No Result, No Data y similares) si el atributo fue siempre menor al valor
especificadó.
Excepciones
Ninguna
Guía del usuario PI System Explorer
401
Análisis basados en activos
Notas
• Si es necesario, se realiza una interpólación entre los valores de atributo para determinar
cuandó el atributo era mayor o igual que el valor especificadó.
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado previamente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindGE('att1', 'y', '+2h', 40)
[Devuelve la marca de tiempo entre la medianoche y las 2:00 a. m. de ayer cuando 'att1' era
mayor o igual que 40 por primera vez]
FindGT
Encuentra la primera vez en un intervalo de tiempo en que un atributo es mayor que un valor
especificadó.
Sintaxis
FindGT(attname, starttime, endtime, x)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
• x
El valor para buscar debe ser un numeró entero o real, o un estado digital (cadena de
caracteres).
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo de tiempo especificadó en el cual el
atributo era mayor que el valor especificadó. Devuelve el estado digital del sistema
correspondiente (No Result, No Data, y similares) si el atributo nunca fue superior al valor
especificadó.
402
Guía del usuario PI System Explorer
Análisis basados en activos
Excepciones
Ninguna
Notas
• Si es necesario, se realiza una interpólación entre los valores del atributo para determinar
cuandó el atributo era mayor que el valor especificadó
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado previamente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindGT('att1', 't', '*', 40)
[Devuelve la marca de tiempo de la primera vez despues de la medianoche del día actual en
que 'att1' era mayor que 40]
• FindGT('att1', '-1h', '*', TagVal('att1', 'y+18h'))
[Devuelve la marca de tiempo de la primera vez desde hace una hora en que 'att1' era menor
que su valor a las 6:00 p. m. de ayer.]
FindLE
Encuentra la primera vez en un intervalo de tiempo en que un atributo es menor o igual que un
valor especificadó.
Sintaxis
FindLE(attname, starttime, endtime, x)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
• x
El valor para buscar debe ser un numeró entero o real, o un estado digital (cadena de
caracteres).
Guía del usuario PI System Explorer
403
Análisis basados en activos
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo de tiempo especificadó en el cual el
atributo era menor o igual que el valor especificadó. Devuelve el estado digital del sistema
correspondiente (No Result, No Data, y similares) si el atributo siempre fue superior al valor
especificadó.
Excepciones
Ninguna
Notas
• Si es necesario, se realiza una interpólación entre los valores de atributo para determinar
cuandó el atributo era igual al valor especificadó
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado previamente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindLE('att1', 't', '*', 40)
[Devuelve la marca de tiempo de la primera vez despues de la medianoche del día actual en
que att1 era menor o igual que 40]
FindLT
Encuentra la primera vez en un intervalo de tiempo en que un atributo es menor que un valor
especificadó.
Sintaxis
FindLT(attname, starttime, endtime, x)
Argumentos
• attname
El nombre de un atributo con una referencia de datos de PI point entre comillas simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
404
Guía del usuario PI System Explorer
Análisis basados en activos
• x
El valor que buscar debe ser un numeró entero o real, o un estado digital (cadena de
caracteres).
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo de tiempo especificadó en el cual el
atributo era menor que el valor especificadó. Devuelve el estado digital del sistema
correspondiente (No Result, No Data, y similares) si el atributo nunca fue inferior al valor
especificadó.
Excepciones
Ninguna
Notas
• Si es necesario, se realiza una interpólación entre los valores de atributo para determinar
cuandó el atributo era menor que el valor especificadó
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado previamente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindLT('att1', 'y', 't', 40)
[Devuelve la marca de tiempo de la primera vez entre la medianoche de ayer y la
medianoche de hoy en que 'att1' fue menor que 40]
• FindLT('att1', '-1h', '*', TagVal('att1', 'y+18h'))
[Devuelve la marca de tiempo de la primera vez desde hace una hora en que 'att1' era menor
que su valor a las 6:00 p. m. de ayer.]
FindNE
Encuentra la primera vez en un intervalo de tiempo en que un atributo no es igual al valor
especificadó. Se ómitiran los eventos "No Data".
Sintaxis
FindNE(attname, starttime, endtime, x)
Argumentos
• attname
El nombre de un atributo incluido entre comillas simples.
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "-3h") en referencia a un endtime
absoluto
Guía del usuario PI System Explorer
405
Análisis basados en activos
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, "+1h") en referencia a un starttime
absoluto
• x
El valor que buscar; debe ser un numeró entero o real o un estado digital (cadena de
caracteres).
Devuelve
La marca de tiempo mas próxima a starttime en el intervalo especificadó para el cual el
atributo no era igual al valor especificadó. Se ómitiran los eventos "No Data".
Excepciones
Si el atributo siempre era igual al valor especificadó; se devuelve un valor de error.
Notas
• Si es necesario, se realiza una interpólación entre los valores de atributo para determinar
cuandó el atributo no era igual al valor especificadó.
La interpólación ocurre cuando:
◦ el PI point subyacente tiene desactivado el atributo escalón
◦ no hay valor registrado con la marca de tiempo especificada
El valor interpolado se definira segun los valores antes y despues de la marca de tiempo.
Ningun valor se interpólara si esta activado el atributo escalón. En este caso, el valor de
registro sera el valor al momento del evento (si existe) o el valor registrado anteriormente.
• Si endtime sucede antes que starttime, el intervalo de tiempo se busca hacia atras.
Ejemplo
• FindNE('att1', '-1h', '*', 40)
[Devuelve la marca de tiempo de la primera vez desde hace una hora en que 'att1' no era
igual a 40.]
• FindNE('enum_att1', '30-March-17', '*', "On")
[Devuelve la marca de tiempo de la primera vez desde el comienzo del día (12:00 a. m.) del
30 de marzo de 2017 en que el valor de enumeración 'enum_att1' no era igual a "On".]
FirstValue
Obtener el primer valor en una matriz que cumpla con una cóndición determinada.
Sintaxis
FirstValue(a1 [, condition($val)])
Argumentos
• a1
una variable que representa la matriz de óperación
406
Guía del usuario PI System Explorer
Análisis basados en activos
• condition($val)
cualquier declaración PE compatible, como una función de $val, que devuelve un valor
verdadero o falso. $val es un placeholder para cada valor de la matriz
Devuelve
El primer valor que cumpla con una cóndición determinada
Excepciones
Ninguna
Notas
Ninguna
Ejemplo
• FirstValue(Data)
[Devuelve el primer valor de una matriz denominada Data]
• FirstVal(Data, $val < 90)
[A partir de la matriz denominada Data, devuelve el primer valor en la matriz que sea
inferior a 90]
Float
Convertir una cadena en un numeró.
Sintaxis
Float(x)
Argumentos
• x
Una cadena o un numeró, o un atributo cuyo valor da como resultado un numeró al
momento de la evaluación.
Devuelve
Un numeró para una cadena numerica. Si x ya es un numeró, se devuelve x
Excepciones
Si x no es un numeró ni una cadena numerica, se devuelve Calc Failed
Notas
La unidad de medida del argumento, si existe, se traslada al resultado. Float tambien adopta
timespan y boolean como argumento. Sin embargo, tenga en cuenta que Float solo convierte el
formato timespan a la cantidad de segundos desde las 12:00 a. m. del 1 de enero de 1970.
Ejemplo
• Float("12.3")
[Convierte la cadena en un numeró y devuelve 12.3]
• Float(12.3)
Guía del usuario PI System Explorer
407
Análisis basados en activos
[Devuelve 12.3]
• Float('*')
[Devuelve la cantidad total de segundos transcurridos desde el 1 de enero de 1970]
Floor
Devuelve el numeró entero mas cercano menor o igual que x.
Sintaxis
Floor(x)
Argumentos
• x
Un numeró entero o real, o un atributo cuyo valor da como resultado un numeró al momento
de la evaluación.
Devuelve
El numeró entero mas cercano menor o igual que x
Excepciones
Devuelve un error si x es un estado digital, una expresión de tiempo, un intervalo de tiempo o
una cadena
Notas
La unidad de medida del argumento, si existe, se traslada al resultado
Ejemplo
• Floor(3.14)
[Devuelve 3]
• Floor(-3.14)
[Devuelve -4]
• Floor(TagVal('att1', '*'))
[Devuelve el numeró entero mas cercano menor o igual que el valor actual de 'att1']
Format
Convierte un numeró en una cadena en función de una expresión de formato.
Sintaxis
Format(x, format [,culture])
Argumentos
• x
Un numeró entero o real
• format
Cadena de control de formato, similar a la que se usa en la función de lenguaje C Sprintf
408
Guía del usuario PI System Explorer
Análisis basados en activos
• culture
Opcional. Cadena de nombre de referencia cultural, incluido entre comillas dobles. Algunos
ejemplos son "de-DE", "ja-jp", "pt-br" o "zh-cn". Utilice "" para especificar el ajuste de
referencia cultural-invariable (ajuste predeterminado)
Returns
Una cadena con formato
Ejemplo
• Format(1234.567, "%10.2f", "de-DE")
[Devuelve "1234,57", una cadena con formato]
• Format(45, "%3.3d")
[Devuelve "045"]
Frac
Devuelve la parte fraccionaria de un numeró real. Devuelve 0 en el caso de los enteros.
Sintaxis
Frac(x)
Argumentos
• x
Debe ser un numeró entero o real.
Devuelve
La parte fraccionaria de x
Excepciones
Si x no es un numeró entero ni real, devuelve un error
Notas
Por definición: Int(x) + Frac(x) = x
La unidad de medida del argumento, si existe, se traslada al resultado
Ejemplo
• Frac(1)
[Devuelve 0]
• Frac(1.3)
[Devuelve 0.3]
• Frac(TagVal('att1', '*'))
[Devuelve la parte fraccional del valor de 'att1' a la hora actual.]
HasChanged
Devuelve True si un atributo ha tenido algun evento en el períódó especificadó; de lo contrario,
devuelve False.
Guía del usuario PI System Explorer
409
Análisis basados en activos
Sintaxis
HasChanged(attname, t1)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• t1
El comienzo de un períódó que finaliza a la hora de ejecución; puede ser cualquier expresión
de tiempo relativa entre comillas simples (por ejemplo, 't - 4h')
Devuelve
True si attname posee algun evento en el períódó especificadó; de lo contrario, devuelve False
Ejemplo
• HasChanged('att1', 't-4h')
[Devuelve True si 'att1' recibió alguna actualización desde las 8:00 p. m. de anoche,
independientemente de si la actualización cambió el valor real del atributo]
HasValueChanged
Determina si el valor de un atributo o de una expresión cambió desde la ultima evaluación
durante un analisis.
Sintaxis
HasValueChanged(x)
Argumentos
• x
atributo o expresión
Devuelve
True si el valor de x cambió desde la ultima evaluación durante el analisis; de lo contrario,
devuelve False.
Si x es una expresión que esta función aun no evaluó durante el analisis, la función devuelve
False.
Si x es un atributo que esta función aun no evaluó durante el analisis, la función busca el valor
anterior registrado y lo compara con el valor actual. Si no hay valores anteriores, la función
devuelve False.
Notas
HasValueChanged es una función "stateful". Las evaluaciones anteriores se almacenan en la
memoria y se comparan con el valor nuevo para comprobar si hubo un cambio de estado. Si PI
Analysis Service se reinicia durante un analisis, la memoria se elimina y se pierden todas las
evaluaciones anteriores.
Ejemplo
• HasValueChanged('att1')
410
Guía del usuario PI System Explorer
Análisis basados en activos
[Devuelve True si el valor de att1 cambió desde la ultima evaluación durante el analisis]
• HasValueChanged('att1'+'att2')
[Devuelve True si el valor de la suma de att1 y att2 cambió desde la ultima evaluación
durante el analisis]
Hour
Extrae la hora de una expresión de tiempo.
Sintaxis
Hour(t1)
Argumentos
• t1
Una expresión de tiempo entre comillas simples.
Devuelve
La hora de la expresión de tiempo, en el rango de 0 a 23.
Excepciones
Ninguna
Ejemplo
• Hour('*')
[Devuelve la parte de la hora del momento actual.]
• Hour('Saturday')
[Devuelve 0.]
• Hour(FindEq('att1', '-1d', '*', 50))
[Devuelve la hora de la expresión de tiempo cuando el valor de 'att1' fue igual a 50 por
primera vez en las ultimas 24 horas.]
IF
Operador que incorpora la cóndición en el enunciado IF-THEN-ELSE. Devuelve el primero de
dos valores especificadós si la expresión condicional es verdadera. De lo contrario, devuelve el
segundo valor.
Sintaxis
IF (expression) THEN (x) ELSE (y)
Argumentos
• expression
Cualquier expresión que da como resultado verdadero o falso
• x, y
Una expresión que da como resultado un valor de salida
Guía del usuario PI System Explorer
411
Análisis basados en activos
Devuelve
x cuando la expresión condicional es verdadera y y cuando la expresión es falsa
Excepciones
Ninguna
Ejemplo
• IF ('att1' > 50) THEN ('att2') ELSE ('att3')
[Si el valor de 'att1' es mayor de 50, devuelve el valor de 'att2'; de lo contrario, devuelve el
valor de 'att3']
IN
Devuelve True si un valor esta incluido en un conjunto o un rango de valores inclusivos.
Sintaxis
x In (y1 [, ... yn])
x In (y1...yn)
Argumentos
• x
valor numericó o cadena
• y1 [, ... yn]
un conjunto de valores numericós o de cadenas
• y1 ... yn
un rango de valores numericós
Devuelve
True cuando x esta incluido en un conjunto o un rango de valores
Excepciones
Ninguna
Ejemplo
•
1 In (9, 10)
[Devuelve False, ya que 1 no esta incluido en un conjunto de 9 y 10]
•
2 In (1...10)
[Devuelve True, ya que 2 esta incluido en el rango de 1 a 10]
InStr
Devuelve la ubicación dentro de una cadena en la que se encuentra por primera vez una
subcadena.
412
Guía del usuario PI System Explorer
Análisis basados en activos
Sintaxis
InStr([start,] s1, s2 [,caseSensitive])
Argumentos
• start
Opcional: un numeró entero que especifica el caracter en s1 por el que se cómenzara la
cómparación. Deber mayor o igual que 1.
• s1, s2
Dos cadenas para comparar.
• caseSensitive
Opcional: indicador que senala que la cómparación distingue entre mayusculas y
minusculas. Si es 0 (el valor predeterminado), la cómparación distingue entre mayusculas y
minusculas; si es 1, no distingue entre ellas.
Returns
0 si s2 no es una subcadena de s1 que comienza desde la pósición inicial; de lo contrario, la
ubicación del caracter donde s2 coincide por primera vez con los caracteres de s1 a partir de la
pósición inicial.
Excepciones
Los caracteres cómódín no se tratan como comodines.
Ejemplo
• InStr("What", "At")
[Devuelve 3.]
• InStr("What What What", "What")
[Devuelve 1.]
• InStr("what", "At", 1)
[Devuelve 0.]
• InStr(4, "what", "At")
[Devuelve 0.]
• InStr('att1', "Error")
[Devuelve 1 si el valor de att1 es "Error".]
Int
Devuelve la parte entera de un numeró entero o real.
Sintaxis
Int(x)
Argumentos
• x
Un numeró, un valor booleano, una cadena numerica, un períódó o un atributo cuyo valor da
como resultado un numeró al momento de la evaluación.
Guía del usuario PI System Explorer
413
Análisis basados en activos
Returns
Si x es un numeró, se devuelve la parte entera de x. Si x es una cadena, se convierte primero en
un numeró. Si x es un timespan, se devuelve la cantidad de segundos desde las 12:00 a. m. del 1
de enero de 1970.
Excepciones
Devuelve un error si la variable no esta asignada.
Notas
Int('*') devuelve la hora UTC, en segundos, desde las 12:00 a. m. del 1 de enero de 1970.
Ejemplo
• Int('att1')
[Devuelve la parte entera del valor de 'att1' a la hora actual.]
• Int('*'-'t')
[Devuelve la cantidad de segundos que transcurrieron desde el comienzo del día de hoy.]
• Int(2.1)
[Devuelve 2.]
• Int("2.1")
[Primero convierte la cadena en un numeró y devuelve 2.]
• Int(true)
[Devuelve 1.]
InterpolatedValues
Obtenga los valores interpolados en un rango de tiempo especificadó usando el valor de
timestep definidó.
Sintaxis
InterpolatedValues(attname, starttime, endtime, timestep)
Argumentos
• attname
atributo con datos de serie temporal (por ejemplo, la referencia de datos de PI point) entre
comillas simples
• starttime
una expresión de tiempo que representa el comienzo de un intervalo de tiempo entre
comillas simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a una hora
final absoluta
• endtime
una expresión de tiempo que representa el comienzo de un intervalo de tiempo entre
comillas simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a una hora
final absoluta
414
Guía del usuario PI System Explorer
Análisis basados en activos
• timestep
un intervalo de tiempo entre comillas simples (por ejemplo, '+1m' o '-10s') que representa
el cambio de tiempo incremental entre el rango especificadó para obtener los valores
interpolados
Devuelve
Una matriz de los valores obtenidos dentro del intervalo especificadó en intervalos de timestep
Excepciones
Si el atributo no es compatible con llamadas de intervalo o valores interpolados de llamadas de
intervalo, la función devuelve un error que así lo indica
Notas
• Si starttime es anterior a endtime, los valores que resulten estaran en orden crónólógicó
ascendente; de lo contrario, estaran en orden crónólógicó descendente.
• Cuando se especifica un valor de timestep positivo, el calculó de intervalo comienza en la
hora límite mas temprana del intervalo de tiempo y aplica el intervalo de manera reiterada
en dirección crónólógica ascendente para generar intervalos de calculó.
• Si se especifica un valor de timestep negativo, el calculó de intervalo comienza en la hora
límite mas tardía del intervalo de tiempo y aplica el intervalo de manera reiterada en
dirección crónólógica descendente para generar intervalos de calculó.
• Tenga en cuenta que el orden de los valores devueltos tódavía se vera reflejadó en el
intervalo de tiempo, independientemente del signo de timestep.
Ejemplo
• InterpolatedValues('att1', 't', '+1h', '+10m')
[Devuelve los valores de 'att1' entre las 12:00 a. m. y la 1:00 a. m. de hoy en intervalos de
10 minutos]
• InterpolatedValues('att1', 't', '+1h', '-14m')
[Devuelve los valores de 'att1' entre las 12:00 y la 1:00 a. m. de hoy en intervalos de
14 minutos, delimitando a partir de la 1:00 a. m. (es decir, 12:04, 12:18, 12:32, 12:46, 1:00)]
IsSet
Para un atributo asociado con un PI point, determina si el punto esta anotado, se sustituye o es
cuestionable.
Sintaxis
IsSet(attname, select)
Argumentos
• attname
Un atributo asociado con un PI point de tipo de valor entero, numeró real, valor de
enumeración o cadena
• select
Una cadena, pero solo se considera el primer caracter: "a" para anotar, "s" para sustituir y
"q" para cuestionable. Not distingue entre mayusculas y minusculas
Guía del usuario PI System Explorer
415
Análisis basados en activos
Devuelve
True o False
Excepciones
Ninguna
Ejemplo
• IsSet('att1', "a")
[Devuelve True si el valor de 'att1' esta anotado]
• IsSet('att1', "s")
[Devuelve True si el valor de 'att1' se sustituyó]]
• IsSet('att1', "q")
[Devuelve True si el valor de 'att1' es cuestionable]
LastValue
Obtener el ultimó valor en una matriz que cumpla con una cóndición determinada.
Sintaxis
LastValue(a1 [, condition($val)])
Argumentos
• a1
una variable que representa la matriz de óperación
• condition($val)
cualquier declaración PE compatible, como una función de $val, que devuelve un valor
verdadero o falso. $val es un placeholder para cada valor de la matriz
Devuelve
El ultimó valor que cumpla con una cóndición determinada
Excepciones
Ninguna
Notas
Ninguna
Ejemplo
• LastValue(Data)
[Devuelve el ultimó valor de una matriz denominada Data]
• LastValue(Data, $val > 90 and $val < 105)
[A partir de la matriz denominada Data, devuelve el ultimó valor en la matriz que sea
superior a 90 e inferior a 105]
416
Guía del usuario PI System Explorer
Análisis basados en activos
LCase
Convierte en minusculas una cadena.
Sintaxis
LCase(s1)
Argumentos
• s1
string
Returns
Una cadena que se ha convertido en minusculas.
Excepciones
Si el argumento no es una cadena, devuelve un error.
Ejemplo
• LCase("String")
[Devuelve "string".]
Left
Devuelve un numeró específicó de caracteres de una cadena empezando por la izquierda.
Sintaxis
Left(s1, len)
Argumentos
• s1
Cadena
• len
Numeró entero.
Returns
Los primeros caracteres len de la cadena, empezando por la izquierda.
Excepciones
Si los argumentos no son del tipo requerido, devuelve un error.
Ejemplo
• Left("String_att", 3)
[Devuelve "Str".]
Len
Devuelve la longitud de una cadena.
Guía del usuario PI System Explorer
417
Análisis basados en activos
Sintaxis
Len(s1)
Argumentos
• s1
string
Returns
La longitud de una cadena
Excepciones
Si el argumento no es una cadena, devuelve un error.
Ejemplo
• Len("String")
[Devuelve 6.]
• Len('sinusoid')
[Devuelve Calc Failed.]
LinRegr
Aplica el ajuste lineal por mínimós cuadrados a dos conjuntos de valores dados por atributos
en un intervalo de tiempo especificadó. La salida es una matriz con base uno, con los valores de
la pendiente, la intersección y R2.
Sintaxis
LinRegr(x, y, mode, starttime, endtime [, pctgood])
LinRegr(y, starttime, endtime [, pctgood])
Argumentos
• x
un atributo con el primer conjunto de datos de series temporales (como referencia de datos
de PI point) entre comillas simples
• y
un atributo con el segundo conjunto de datos de series temporales (como referencia de
datos de PI point) entre comillas simples
• mode
un numeró que especifica cómó alinear valores con marca de tiempo
selecciona entre 0, 1 o 2; donde:
0 representa la cómbinación de los valores con marca de tiempo entre x y y
1 representa los valores de ambos atributos de acuerdo con las marcas de tiempo de x
2 representa los valores de ambos atributos de acuerdo con las marcas de tiempo de y
418
Guía del usuario PI System Explorer
Análisis basados en activos
• starttime
una expresión de tiempo que representa el comienzo de un intervalo de tiempo entre
comillas simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a un
endtime absoluto
• endtime
una expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a un starttime
absoluto
• pctgood
Opcional. Porcentaje mínimó de tiempo durante el intervalo de tiempo en que los valores del
atributo deben ser correctos.
Puede establecer pctgood como límite para asegurarse de que haya suficientes valores
correctos para realizar el calculó LinRegr.
Devuelve
Matriz con base uno, con los valores de la pendiente, la intersección y R2.
Excepciones
Si el atributo no posee valores correctos, o no se alcanza el mínimó pctgood para el intervalo de
tiempo dado, devuelve un error
Notas
Los valores incorrectos se excluyen del calculó de LinRegr calculó
PRECAUCIÓN:
Si el atributo posee muy pocos valores correctos durante el intervalo de tiempo, es
posible que el resultado de esta función no sea cónfiable. Use la utilidad PctGood para
averiguar que porcentaje de los valores es correcto
Indexa la pendiente, la intersección y R2 salidas de [1].
Ejemplo
• LinRegr('att1', 'att2', 0, 't', '+1h', 80)
[Devuelve una matriz de pendientes con base uno, la intersección y R2 en función de los
valores con marca de tiempo de 'att1' y 'att2' entre las 12:00 a. m. y la 1:00 a. m. de hoy
cuando, al menos, el 80 % de los valores eran correctos. Devuelve un error si no se alcanza el
mínimó pctgood]
• LinRegr('att1', 'att2', 1, 't', '+1h')
Guía del usuario PI System Explorer
419
Análisis basados en activos
[Devuelve una matriz de pendientes con base uno, la intersección y R2 en función de los
valores con marca de tiempo de 'att1' entre las 12:00 a. m. y la 1:00 a. m. de hoy]
• LinRegr('att1', 't', '+1h', 80)
[Devuelve una matriz de pendientes con base uno, la intersección y R2 de 'att1' entre las
12:00 a. m. y la 1:00 a. m. de hoy cuando al menos el 80 % de los valores eran correctos.
Devuelve un error si no se alcanza el mínimó pctgood]
• LinRegr('att1', 't', '+1h')
[Devuelve una matriz de pendientes con base uno, la intersección y R2 de 'att1' entre las
12:00 a. m. y la 1:00 a. m. de hoy]
Log
Devuelve el logaritmo natural (base e = 2.7182818...) de un numeró entero o real.
Sintaxis
Log(x)
Argumentos
• x
Debe ser un numeró entero o real mayor de cero
Devuelve
El logaritmo natural de x
Excepciones
Si x es cero o es un numeró negativo, o no es un numeró, devuelve un error
Ejemplo
• Log(14)
[Devuelve 2.6391]
• Log(TagVal('att1', '14-Dec-16'))
[Devuelve el logaritmo natural del valor de 'att1' a las 12:00 a. m. del 14 de diciembre de
2016]
Log10
Devuelve el logaritmo en base 10 de un numeró entero o real.
Sintaxis
Log10(x)
Argumentos
• x
Debe ser un numeró entero o real mayor de cero
Devuelve
El logaritmo en base 10 de x
420
Guía del usuario PI System Explorer
Análisis basados en activos
Excepciones/errores
Si x es cero o es un numeró negativo, o no es un numeró, devuelve un error
Ejemplo
• Log10(100)
[Devuelve 2]
• Log10(TagVal('att1', '14-Dec-16'))
[Devuelve el logaritmo en base 10 del valor de 'att1' a las 12:00 a. m. del 14 de diciembre de
2016]
Logbase
Devuelve el logaritmo de un valor numericó positivo x en una determinada base y.
Sintaxis
Logbase(x,y)
Argumentos
• x
Un numeró entero o real mayor que cero
• y
Un numeró entero positivo que indica la base del logaritmo
Devuelve
El logaritmo de x en base y
Excepciones
Si x es cero o es un numeró negativo, o no es un numeró, devuelve un error
Ejemplo
• Logbase(256, 2)
[Devuelve 8]
• Logbase(1000, 10)
[Devuelve 3]
• Logbase(TagVal('att1', '14-Dec-16'), 16)
[Devuelve el logaritmo del valor de 'att1' a las 12:00 a. m. del 14 de diciembre de 2016 en
base 16]
LTrim
Eliminar los espacios en blanco al comienzo de una cadena.
Sintaxis
LTrim(s1)
Argumentos
Guía del usuario PI System Explorer
421
Análisis basados en activos
• s1
string
Returns
Una cadena con los espacios en blanco al comienzo eliminados
Excepciones
Si s1 no es una cadena, se devuelve un error.
Ejemplo
• LTrim(" String")
[Devuelve "string".]
• LTrim("String ")
[Devuelve "string".]
MapData
Aplicar una función a cada valor en la matriz.
Sintaxis
MapData(a1, function($val))
Argumentos
• a1
una variable que representa la matriz de óperación
• function($val)
cualquier declaración PE compatible, como una función de $val, que ejecuta una óperación.
$val es un placeholder para cada valor de la matriz
Devuelve
La matriz transformada de todos los valores
Excepciones
Ninguna
Notas
La matriz de salida tiene las mismas marcas de tiempo que la matriz de entrada.
Ejemplo
• MapData(Data, (IF BadVal($val) THEN 0 ELSE $val))
[A partir de una matriz denominada Data, devuelve una matriz nueva con valores
incorrectos cónfiguradós en 0]
Max
Devuelve el valor maximó ponderado en el tiempo o ponderado en eventos de un conjunto de
valores.
422
Guía del usuario PI System Explorer
Análisis basados en activos
Sintaxis
Max(x1, ... xn)
Max(array [, calculationBasis])
Argumentos
• x1, ... xn
Los argumentos o una sola matriz del mismo tipo de valor (numerós enteros y reales,
valores de enumeración, expresiones de tiempo o intervalos de tiempo)
• calculationBasis
Opcional. El tipo de calculó a realizar entre comillas dobles. Elija entre "Ponderado en
eventos" o "Ponderado en el tiempo". Si no lo elige, el valor predeterminado se pónderara en
eventos. Si selecciona "Ponderado en el tiempo", la primera marca de tiempo del valor marca
la hora de inicio y la ultima marca de tiempo marca el final del intervalo de tiempo.
Devuelve
El valor maximó a partir de un conjunto de argumentos. El resultado es del mismo tipo de datos
que los argumentos
Excepciones
No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados
digitales. Si todos los valores son estados digitales, Max devuelve un error. Devuelve un error si
la matriz no se compone del mismo tipo de valor.
Notas
• La unidad de medida (UOM) del argumento se traslada al resultado cuando por lo menos un
argumento tiene una UOM definida, mientras que otras no la tienen. El valor devuelto no
contiene una UOM si los argumentos tienen diferentes UOM.
Ejemplo
• Max(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Encuentra el maximó de estos valores: 14, el valor de 'att1' a la hora de activación, 14.5 y el
valor de 'att2' correspondiente al 14 de diciembre de 2016 al comienzo del día (12:00 a. m.)]
• Max('enum_att1', 'enum_att2', 'enum_att3')
[A la hora de activación, halla el valor maximó de un conjunto de enumeración, y devolver el
nombre]
• Max('*', 'y', 'Saturday')
[Encuentra la marca de tiempo mas reciente. Devuelve la hora actual del ejemplo anterior]
• Max('*'-'*-1h', 't+8h'-'y+4h', '*'-'t')
[Encuentra el intervalo de mayor duración de estos períódós: desde hace 1 hora hasta ahora,
desde ayer a las 4:00 a. m. hasta hoy a las 8:00 a. m., desde ayer a las 12:00 a. m. hasta el 20
de este mes a las 12:00 a. m. y desde el comienzo del día de hoy (12:00 a. m.) hasta ahora]
• Max(Variable1)
Guía del usuario PI System Explorer
423
Análisis basados en activos
Nota:
Name
Expresión
Valor en la evaluación
Variable1
RecordedValues('att1',
'*-10m', '*')
[1, 3, 5, 7, 9]
Variable 2
Max(Variable1)
9
[Encuentra el valor maximó de los valores de una matriz denominada Variable1]
• Max(Data)
[Devuelve el valor maximó ponderado en eventos de los valores de una matriz denominada
Data]
• Max(Data, "EventWeighted")
[Devuelve el valor maximó ponderado en eventos de los valores de una matriz denominada
Data]
• Max(Data, "TimeWeighted")
[Devuelve el valor maximó ponderado en el tiempo de los valores de una matriz
denominada Data con las marcas de tiempo del primer y ultimó valor de la matriz como la
hora de inicio y la hora de finalización respectivamente]
Median
Devuelve el valor medio (valor mediana) ponderado en el tiempo o ponderado en eventos de
uno o mas valores.
Sintaxis
Median(x1 [, ... xn])
Median(array)
Argumentos
• x1 [, ... xn]
Los argumentos y una sola matriz del mismo tipo de valor (numerós enteros y reales,
expresiones de tiempo o intervalos de tiempo)
Devuelve
El valor medio de los argumentos de entrada. Si el numeró de argumentos es par, se devuelve el
promedio de los dos valores medios. Devuelve un error si la matriz no se compone del mismo
tipo de valor.
Excepciones
No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados
digitales. La función debe tener uno o mas argumentos que den como resultado estados no
digitales; de lo contrario, Median devuelve un valor de error. Tambien devuelve un error si la
matriz no se compone del mismo tipo de valor.
Notas
Los argumentos deben ser del mismo tipo de valor. El tipo de datos del primer argumento
establece el caracter del resto.
424
Guía del usuario PI System Explorer
Análisis basados en activos
La unidad de medida (UOM) del argumento se traslada al resultado cuando por lo menos un
argumento tiene una UOM definida, mientras que otras no la tienen. El valor devuelto no
contiene una UOM si los argumentos tienen diferentes UOM.
Ejemplos
• Median(14, 'att1', 14.5, TagVal('att2', '14-Dec-16'))
[Encuentra el valor medio de estos valores: 14, el valor actual de att1, 14.5, y el valor de att2
correspondiente a la medianoche del 14 de diciembre de 2016]
• Median('*', 'y', 'Saturday')
[Encuentra el valor medio de estas marcas temporales: ahora, ayer a las 12:00 a. m., y el
sabadó pasado a las 12:00 a. m.]
• Median('*'-'*-1h', 't+4h'-'y+8h', 'y+2h'-'20')
[Encuentra el valor medio de estos períódós: desde hace 1 hora hasta ahora, desde ayer a las
8:00 a. m. hasta hoy a las 4:00 a. m., y desde ayer a las 2:00 a. m. hasta el 20 de este mes al
comienzo del día (12:00 a. m.).]
• Median(Variable1)
Nota:
Name
Expresión
Valor en la evaluación
Variable1
RecordedValues('att1',
'*-10m', '*')
[1, 3, 5, 7, 9]
Variable 2
Median(Variable1)
5
[Encuentra el valor medio de los valores de una matriz denominada Variable1]
• Median(Data)
[Devuelve el valor medio ponderado en eventos de los valores de una matriz denominada
Data]
Mid
Devuelve una subcadena dentro de una cadena.
Sintaxis
Mid(s1, start [,len])
Argumentos
• s1
string
• start
Un entero que especifica la pósición del primer caracter dentro de la cadena. El primer
caracter de la cadena es el numeró 1.
• len
Opcional: la longitud maxima de la cadena devuelta. El valor predeterminado es la longitud
de la cadena.
Guía del usuario PI System Explorer
425
Análisis basados en activos
Returns
Caracteres len de la cadena a la derecha (e inclusive) del primer caracter cuya pósición este
especificada por el comienzo.
Excepciones
Si los argumentos no son del tipo requerido, devuelve un error. El numeró maximó de
caracteres devueltos es 999.
Ejemplo
• Mid("String", 3)
[Devuelve "ring".]
• Mid("String", 3, 2)
[Devuelve "ri".]
Min
Devuelve el valor mínimó ponderado en el tiempo o ponderado en eventos de un conjunto de
valores.
Sintaxis
Min(x1, ... xn)
Min(array [, calculationBasis])
Argumentos
• x1, ... xn
Los argumentos o una sola matriz del mismo tipo de valor (numerós enteros y reales,
valores de enumeración, expresiones de tiempo o intervalos de tiempo)
• calculationBasis
Opcional. El tipo de calculó a realizar entre comillas dobles. Elija entre "Ponderado en
eventos" o "Ponderado en el tiempo". Si no lo elige, el valor predeterminado se pónderara en
eventos. Si selecciona "Ponderado en el tiempo", la primera marca de tiempo del valor marca
la hora de inicio y la ultima marca de tiempo marca el final del intervalo de tiempo.
Devuelve
El valor mínimó a partir de un conjunto de argumentos. El resultado es del mismo tipo de datos
que los argumentos
Excepciones
No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados
digitales. Si todos los valores son estados digitales, Min devuelve un error. Devuelve un error si
la matriz no se compone del mismo tipo de valor.
426
Guía del usuario PI System Explorer
Análisis basados en activos
Notas
• La unidad de medida (UOM) del argumento se traslada al resultado cuando por lo menos un
argumento tiene una UOM definida, mientras que otras no la tienen. El valor devuelto no
contiene una UOM si los argumentos tienen diferentes UOM.
Ejemplo
• Min(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Encuentra el mínimó de estos valores: 14, el valor de 'att1' a la hora de activación, 14.5 y el
valor de 'att2' correspondiente al 14 de diciembre de 2016 al comienzo del día (12:00 a. m.)]
• Min('enum_att1', 'enum_att2', 'enum_att3')
[A la hora de activación, halla el valor mínimó de un conjunto de enumeración, y devuelve el
nombre]
• Min('*', 'y', 'Saturday')
[Encuentra la marca de tiempo mas antigua de un conjunto]
• Min('*'-'*-1h', 't+8h'-'y+4h', 'y'-'20', '*'-'t')
[Encuentra el intervalo mas corto de estos períódós: desde hace 1 hora hasta ahora, desde
ayer a las 4:00 a. m. hasta hoy a las 8:00 a. m., desde ayer a las 12:00 a. m. hasta el 20 de este
mes a las 12:00 a. m., y desde el comienzo del día de hoy (12:00 a. m.) hasta ahora]
• Min(Variable1)
Nota:
Nombre
Expresión
Valor en la evaluación
Variable1
RecordedValues('att1',
'*-10m', '*')
[1, 3, 5, 7, 9]
Variable 2
Min(Variable1)
1
[Encuentra el mínimó de los valores en una matriz Variable1]
• Min(Data)
[Devuelve el valor mínimó ponderado en eventos de los valores de una matriz denominada
Data]
• Min(Data, "EventWeighted")
[Devuelve el valor mínimó ponderado en eventos de los valores de una matriz denominada
Data]
• Min(Data, "TimeWeighted")
[Devuelve el valor mínimó ponderado en el tiempo de los valores de una matriz denominada
Data con las marcas de tiempo del primer y ultimó valor de la matriz como la hora de inicio
y la hora de finalización respectivamente]
Minute
Extrae el minuto de una expresión de tiempo.
Sintaxis
Minute(t1)
Guía del usuario PI System Explorer
427
Análisis basados en activos
Argumentos
• t1
Una expresión de tiempo entre comillas simples.
Returns
Los minutos de la expresión de tiempo, en el rango de 0 a 59.
Excepciones
Ninguno.
Ejemplo
• Minute('*')
[Extrae el minuto de la hora actual.]
• Minute(FindGT('att1', '-1h', '*', 5)
[Extrae el minuto de una marca de tiempo cuando el valor de 'att1' fue mayor que 5 por
primera vez durante la ultima hora. Devuelve un error si nunca fue mayor que 5.]
Mod
El operador de móduló (mod) devuelve el resto del cociente de dos valores numericós. Para x
Mod y, este es el resto de x/y.
Sintaxis
x Mod y
Argumentos
• x
Cualquier expresión que da como resultado un valor numericó
• y
Cualquier valor numericó distinto de cero
Devuelve
Resto de x/y
Excepciones
Ninguna
Notas
La UOM de x, si existe, se traslada al resultado
Ejemplo
• 11 Mod 3
[Devuelve 2]
428
Guía del usuario PI System Explorer
Análisis basados en activos
Month
Extrae el mes de una expresión de tiempo determinada.
Sintaxis
Month(t1)
Argumentos
• t1
Una expresión de tiempo entre comillas simples
Returns
El mes de la expresión de tiempo, en el rango de 1 a 12.
Excepciones
Ninguna
Ejemplo
• Month('*')
[Devuelve el mes actual.]
• Month(FindEq('att1', '-10d', '*', 5')
[Devuelve el mes de una marca de tiempo cuando el valor de 'att1' fue igual a 5 por primera
vez en los ultimós 10 días.]
NextEvent
Encuentra la marca de tiempo del siguiente valor registrado despues de una hora especificada.
Sintaxis
NextEvent(attname, t1)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• t1
Una expresión de tiempo
Returns
La marca de tiempo del siguiente valor registrado despues de una hora especificada para el
atributo especificadó
Excepciones
Si no hay valores registrados despues de la hora especificada, la función devuelve No Data.
Ejemplo
• NextEvent('att1', 't')
Guía del usuario PI System Explorer
429
Análisis basados en activos
[Encuentra y devuelve la marca de tiempo del siguiente valor registrado de 'att1' desde el
comienzo del día (12:00 a. m.) de hoy.]
NextVal
Encuentra el siguiente valor registrado despues de una hora especificada.
Sintaxis
NextVal(attname, t1)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• t1
Una expresión de tiempo
Returns
El siguiente valor registrado despues de una hora especificada para el atributo especificadó
Excepciones
Si no hay valores registrados despues de la hora especificada, la función devuelve un error.
Ejemplo
• NextVal('att1', 't')
[Encuentra y devuelve el siguiente valor registrado de 'att1' desde el comienzo del día
(12:00 a. m.) de hoy.]
Noon
Devuelve la marca de tiempo correspondiente a las doce del mediódía de una expresión de
tiempo dada.
Sintaxis
Noon(t1)
Argumentos
• t1
Una expresión de tiempo entre comillas simples
Returns
Una marca de tiempo correspondiente a las doce del mediódía de una expresión de tiempo
dada
Excepciones
Ninguna
Notas
Esta función es util para establecer una hora de reloj unica independiente de la duración de
días concretos.
430
Guía del usuario PI System Explorer
Análisis basados en activos
Ejemplo
• Noon('*')
[Devuelve una marca de tiempo correspondiente a las doce del mediódía del día en que
'att1' fue igual a 50 por primera vez en los ultimós 3 días. ]
• Noon(FindEq('att1', '-3d', '*', 50))
[Devuelve una marca de tiempo correspondiente a las doce del mediódía del día en que
'att1' fue igual a 50 por primera vez en los ultimós 3 días. ]
NoOutput
No escribe el resultado del calculó actual.
Sintaxis
NoOutput()
Argumentos
Ninguna
Notas
Es importante incluir los parentesis despues de esta función (utilice NoOutput() en lugar de
NoOutput porque NoOutput es una sintaxis no valida). Esta función solo se aplica al calculó
actual.
Ejemplo
• If 'att1' < 100 or 'att1' > 200 then 'att1' else NoOutput()
Normalrnd
Devuelve un numeró aleatorio que correlaciona la curva de distribución normal utilizando un
promedio y una desviación estandar determinados.
Sintaxis
Normalrnd(x, y)
Argumentos
• x
Un numeró real que especifica el promedio de la curva de distribución normal
• y
Un numeró real que especifica la desviación estandar de la curva de distribución normal
Devuelve
Un numeró aleatorio que correlaciona la curva de distribución normal con un promedio y una
desviación estandar determinados
Excepciones
Ninguna
Guía del usuario PI System Explorer
431
Análisis basados en activos
Ejemplo
• Normalrnd(300, 2.5)
NOT
Devuelve la negación de una expresión. Devuelve True si el valor verdadero de una expresión
es falso y False si el valor verdadero de una expresión es verdadero.
Sintaxis
NOT expression
Argumentos
• expression
Cualquier expresión que da como resultado verdadero o falso
Devuelve
True cuando la expresión es falsa y False cuando la expresión es verdadera
Excepciones
Ninguna
Ejemplo
•
NOT (1 In (1...10))
[Devuelve False, ya que (1 en (1...10)) es verdadero.]
NumOfChanges
Devuelve la cantidad de cambios de valor de un atributo en un intervalo de tiempo
especificadó.
Sintaxis
NumOfChanges(attname, starttime, endtime)
Argumentos
• attname
El nombre de un atributo.
• starttime
Una expresión de tiempo que especifica el comienzo de un intervalo de tiempo, o un períódó
de tiempo (por ejemplo, '-3h') que especifica la hora de inicio en relación con endtime; las
entradas deben estar entre comillas simples
• endtime
Una expresión de tiempo que especifica el final de un intervalo de tiempo, o un períódó de
tiempo (por ejemplo, '+3h') que especifica la hora de finalización en relación con startime;
las entradas deben estar entre comillas simples
Devuelve
El recuento de cambios de valor de attname en el intervalo de tiempo especificadó
432
Guía del usuario PI System Explorer
Análisis basados en activos
Ejemplo
• NumOfChanges('att1', 't', '*')
[Devuelve la cantidad de veces en que el valor de 'att1' cambió desde la medianoche hasta
ahora]
O
La disyunción lógica de dos expresiones que devuelve True si una de las expresiones es
verdadera y False si ambas son falsas.
Sintaxis
expression1 OR expression2
Argumentos
• expression1
Cualquier expresión que da como resultado verdadero o falso
• expression2
Cualquier expresión que da como resultado verdadero o falso
Devuelve
True si una de las expresiones es verdadera y False si ambas son falsas
Excepciones
Ninguna
Notas
Si las entradas son numericas, OR puede hacer operaciones con bits.
Ejemplo
• ('att1' > 50) OR ('att2' = "good")
ParseTime
Traduce una expresión de tiempo de PI en una marca de tiempo. Utiliza una expresión de
tiempo regular entre comillas simples para ofrecer un mejor rendimiento.
Sintaxis
ParseTime(s1)
Argumentos
• s1
Una cadena de caracteres o una matriz de cadenas en formato de tiempo de PI entre
comillas dobles
Devuelve
La marca de tiempo correspondiente a s1
Excepciones
Si s1 no es una cadena de caracteres, o si existe un error de sintaxis, devuelve un valor de error.
Guía del usuario PI System Explorer
433
Análisis basados en activos
Si la matriz no se compone de cadenas en un formato de hora, devuelve un error.
Notas
Se recomienda encarecidamente usar la expresión de tiempo '01-Jan-2018' en lugar de la
cadena "01-Jan-2018".
Ejemplo
• ParseTime(Concat("12", "-31", "-16"))
[Devuelve 12/31/2016 12:00:00 a. m., que es lo mismo que '12/31/16']
• ParseTime("14-Dec-16")
[Devuelve el mismo resultado que '14-Dec-16'. Se utiliza solo cuando son necesarias las
operaciones de cadena]
• ParseTime("*")
[Devuelve el mismo resultado que '*'. Se utiliza solo cuando son necesarias las operaciones
de cadena]
• ParseTime(Variable1)
Nota:
Nombre
Expresión
Valor en la evaluación
Variable1
'TimeStringArray'
[t, t+3h, t+14h]
Variable 2
ParseTime(Variable1)
[3/14/2018 12:00:00 a. m.,
3/14/2018 3:00:00 a. m.,
3/14/2018 2:00:00 p. m.]
[Devuelve los resultados de la matriz en un formato de hora de PI adecuado, suponiendo
que hoy es 3/14/18]
PctGood
Encuentra el porcentaje ponderado en el tiempo o ponderado en eventos, durante un intervalo
de tiempo especificadó, para el cual el atributo tenía valores correctos.
Sintaxis
PctGood(attname, starttime, endtime [, calculationBasis])
Argumentos
• attname
atributo con datos temporales en serie (referencia de datos de PI point) entre comillas
simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a un starttime
absoluto
434
Guía del usuario PI System Explorer
Análisis basados en activos
• calculationBasis
Opcional. Una cadena que indica el tipo de calculó a realizar entre comillas dobles. Elija
entre "Ponderado en el tiempo" o "Ponderado en eventos". Si no lo elige, el valor
predeterminado se pónderara en el tiempo.
Devuelve
Un numeró entero o real entre 0 y 100: el porcentaje de tiempo mínimó ponderado en el
tiempo o ponderado en eventos durante un intervalo de tiempo especificadó para el cual el
atributo tenía valores correctos.
Ejemplo
• PctGood('att1', 't', '+1h')
[Devuelve el porcentaje ponderado en el tiempo entre las 12:00 y la 1:00 a. m. de hoy para el
cual 'att1' tenía valores correctos.]
• PctGood('att1', '-1h', '*')
[Devuelve el porcentaje ponderado en el tiempo entre ahora y hoy hace una hora para el
cual 'att1' tenía valores correctos.]
• PctGood('att1', '-1h', '*', "EventWeighted")
[Devuelve el porcentaje ponderado en eventos entre ahora y hoy hace una hora para el cual
'att1' tenía valores correctos.]
Pi
Devuelve el valor de pi.
Sintaxis
Pi()
Argumentos
•
Devuelve
El valor de pi
Excepciones
Ninguna
Ejemplo
• Pi()
Poisson
Devuelve un numeró aleatorio que correlaciona una distribución de Poisson con una media
específica.
Sintaxis
Poisson(x)
Argumentos
Guía del usuario PI System Explorer
435
Análisis basados en activos
• x
Debe ser un numeró entero o real.
Devuelve
Un numeró aleatorio que correlaciona una distribución de Poisson con una media específica
Excepciones
Ninguna
Ejemplo
• Poisson(15)
Poly
Devuelve el polinomio c0 + c1x + c2x2 + … +cnxn.
Sintaxis
Poly(x, c0 [, ... cn])
Argumentos
• x
Variable. Un numeró entero o real
• c0 [, ... cn]
Cóeficientes. Debe haber como mínimó un cóeficiente. Todos deben ser numerós
Devuelve
El valor de un polinomio
Excepciones
Si x o cualquier cóeficiente no es un numeró entero o real, Poly devuelve un error
Ejemplo
• Poly(3, 4, 5)
[Devuelve 19]
• Poly('att1', 2, 3)
Pow
Devuelve x elevado a la potencia y.
Sintaxis
Pow(x, y)
Argumentos
• x
valor numericó
• y
valor numericó
436
Guía del usuario PI System Explorer
Análisis basados en activos
Devuelve
El valor de x elevado a la potencia y
Excepciones
Ninguna
Notas
• Se abre Pow solo tiene validez en las funciones de expresión de analisis basados en activos PI
Asset Framework (PI AF). Utilice el acento circunflejó (^) como operador con el mismo fin
en PI Data Archive Performance Equations
• Tanto Pow(2, 3) como 2^3 son admisibles en las funciones de expresión de analisis
basados en activos PI AF
Ejemplo
• Pow(2, 3)
[Devuelve 8]
• Pow(2.5, 3)
[Devuelve 15.625]
• Pow(TagVal('att1', '*'), 8)
[Devuelve el valor actual de 'att1' elevado a la potencia 8]
PrevEvent
Encuentra la marca de tiempo del ultimó valor registrado antes de una hora especificada.
Sintaxis
PrevEvent(attname, t1)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• t1
Una expresión de tiempo
Returns
La marca de tiempo del ultimó valor registrado antes de una hora especificada para el atributo
especificadó
Excepciones
Si no hay valores registrados antes de la hora especificada, la función devuelve un error.
Ejemplo
• PrevEvent('att1', '*')
[Encuentra la marca de tiempo del ultimó valor registrado de 'att1' antes de la hora actual.]
Guía del usuario PI System Explorer
437
Análisis basados en activos
PrevVal
Encuentra el ultimó valor registrado antes de una hora especificada.
Sintaxis
PrevVal(attname, t1)
Argumentos
• attname
El nombre de un atributo entre comillas simples
• t1
Una expresión de tiempo
Returns
El ultimó valor registrado antes de una hora especificada para el atributo especificadó
Excepciones
Si no hay valores registrados antes de la hora especificada, la función devuelve un error.
Ejemplo
• PrevVal('att1', '*')
[Encuentra y devuelve el ultimó valor registrado de 'att1' antes de la hora actual.]
• PrevVal('att1', '15-Mar-17')
[Encuentra y devuelve el ultimó valor registrado de 'att1' antes del comienzo de día
(12:00 a. m.) del 15 de marzo de 2017.]
PStDev
Devuelve la desviación estándar de la población ponderada en el tiempo o ponderada en eventos
de una póblación de uno o mas valores.
Sintaxis
PStDev(x1 [, ... xn])
PStDev(array [, calculationBasis])
Argumentos
• x1, ... xn
Los argumentos y una sola matriz del mismo tipo de valor (numerós enteros y reales,
expresiones de tiempo o intervalos de tiempo)
• calculationBasis
Opcional. El tipo de calculó a realizar entre comillas dobles. Elija entre "Ponderado en
eventos" o "Ponderado en el tiempo". Si no lo elige, el valor predeterminado se pónderara en
eventos. Si selecciona "Ponderado en el tiempo", la primera marca de tiempo del valor marca
la hora de inicio y la ultima marca de tiempo marca el final del intervalo de tiempo.
438
Guía del usuario PI System Explorer
Análisis basados en activos
Devuelve
La desviación estándar de población de los argumentos. Devuelve un valor numericó si los
argumentos son numerós. Para los argumentos que son expresiones de tiempo (hora o
períódó), se devuelve un numeró que indica un períódó expresado en segundos.
La desviación estandar de póblación de una póblación x1, ..., xn es
donde
es el promedio de los argumentos; es decir,
Excepciones
No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados
digitales. Si todos los valores son estados digitales, se devuelve un error. Devuelve un error si la
matriz no se compone del mismo tipo de valor.
Notas
• PStDev utiliza todos los valores de una póblación para calcular la desviación estandar de la
póblación. Sin embargo, es frecuente, especialmente en poblaciones grandes, calcular la
desviación estandar a partir de una muestra de la póblación. SStDev utiliza un conjunto de
valores muestreados para calcular la desviación estandar de la muestra, que arroja un valor
aproximado de la desviación estandar de la póblación.
• La unidad de medida (UOM) del argumento se traslada al resultado cuando por lo menos un
argumento tiene una UOM definida, mientras que otras no la tienen. El valor devuelto no
contiene una UOM si los argumentos tienen diferentes UOM.
Ejemplo
• PStDev(14, 'att1', 14.5, TagVal('att2','14-Dec-16'))
[Devuelve la "desviación estandar de póblación" de estos valores: 14, el valor actual de 'att1',
14.5, y el valor de 'att2' correspondiente al 14 de diciembre de 2016 al comienzo del día
(12:00 a. m.).]
• PStDev('*', 'y', 'Saturday')
[Devuelve la "desviación estandar de póblación" de estas marcas de tiempo.]
• PStDev('*'-'*-1h', 't+8h'-'y+4h', 'y'-'20', '*'-'t')
[Devuelve la "desviación estandar de póblación" de estos períódós: desde hace 1 hora hasta
ahora, desde ayer a las 4:00 a. m. hasta hoy a las 8:00 a. m., desde ayer a las 12:00 a. m. hasta
el 20 de este mes a las 12:00 a. m., y desde el comienzo del día de hoy (12:00 a. m.) hasta
ahora.]
• PStDev(Variable1)
Guía del usuario PI System Explorer
439
Análisis basados en activos
Nota:
Name
Expresión
Valor en la evaluación
Variable1
RecordedValues('att1',
'*-10m', '*')
[1, 3, 5, 7, 9]
Variable 2
PStDev(Variable1)
2,8284
[Encuentra la "desviación estandar de la póblación" de los valores de una matriz
denominada Variable1]
• PStDev(Data)
[Encuentra la "desviación estandar de la póblación" ponderada en eventos de los valores de
una matriz denominada Data]
• PStDev(Data, "EventWeighted")
[Encuentra la "desviación estandar de la póblación" ponderada en eventos de los valores de
una matriz denominada Data]
• PStDev(Data, "TimeWeighted")
[Devuelve la "desviación estandar de la póblación" ponderada en el tiempo de los valores de
una matriz denominada Data con las marcas de tiempo del primer y ultimó valor de la
matriz como la hora de inicio y la hora de finalización respectivamente]
Rand
Devuelve un numeró aleatorio entre 0 y 1. Para los valores x e y especificadós, devuelve un
numeró aleatorio entre x - y/2 y x + y/2.
Sintaxis
Rand(x, y)
Argumentos
• x
Un numeró real que especifica el punto central del rango.
• y
Un numeró real que especifica el tamanó del rango.
Si no se especifican argumentos, el rango predeterminado es de 0 a 1.
Returns
Un numeró aleatorio entre 0 y 1. Para los valores x e y especificadós, devuelve un numeró
aleatorio entre x - y/2 y x + y/2.
Excepciones
Ninguna
Ejemplo
• Rand()
• Rand(500, 250)
440
Guía del usuario PI System Explorer
Análisis basados en activos
Range
Encuentra la diferencia ponderada en el tiempo o ponderada en eventos entre los valores
maximó y mínimó de un atributo durante un intervalo de tiempo especificadó. Los valores
ponderados en el tiempo se interpolan en los límites de tiempo cuando es posible y, de lo
contrario, se extrapolan.
Sintaxis
Range(attname, starttime, endtime [, pctgood, calculationBasis])
Argumentos
• attname
atributo con datos temporales en serie (referencia de datos de PI point) entre comillas
simples
• starttime
expresión de tiempo que representa el comienzo de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a un endtime
absoluto
• endtime
expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a un starttime
absoluto
• pctgood
Opcional. Porcentaje de tiempo mínimó ponderado en el tiempo o ponderado en eventos,
durante un intervalo de tiempo especificadó, para el cual el atributo tenía valores correctos.
• calculationBasis
Opcional. Una cadena que indica el tipo de calculó a realizar entre comillas dobles. Elija
entre "Ponderado en el tiempo" o "Ponderado en eventos". Si no lo elige, el valor
predeterminado se pónderara en el tiempo.
Devuelve
La diferencia ponderada en el tiempo o ponderada en eventos entre los valores maximó y
mínimó del atributo durante el tiempo especificadó. Los valores ponderados en el tiempo se
interpolan en los límites de tiempo cuando es posible y, de lo contrario, se extrapolan.
Excepciones
Si el atributo no posee valores correctos, o no se alcanza el pctgood mínimó en el intervalo de
tiempo dado, se devuelve un error.
Notas
• Los valores incorrectos se excluyen del calculó de Intervalo .
• A fin de cónfigurar un parametró opcional, debe especificarse cualquier parametró opcional
anterior.
Guía del usuario PI System Explorer
441
Análisis basados en activos
PRECAUCIÓN:
Si el atributo posee muy pocos valores correctos durante el intervalo de tiempo, es
posible que el resultado de esta función no sea cónfiable. Use las funciones PctGood para
averiguar que porcentaje de los valores es correcto.
Ejemplo
• Range('att1', 't', '+1h')
[Devuelve la diferencia ponderada en el tiempo entre el valor maximó y el valor mínimó de
'att1', entre las 12:00 a. m. y la 1:00 a. m. de hoy.]
• Range('att1', 't', '+1h', 80)
[Devuelve la diferencia ponderada en el tiempo entre los valores maximó y mínimó de 'att1',
entre las 12:00 a. m. y la 1:00 a. m. de hoy cuando al menos el 80 % de los valores eran
correctos.]
• Range('att1', 't', '+1h', 80, "EventWeighted")
[Devuelve la diferencia ponderada en eventos entre los valores maximó y mínimó de 'att1'
entre las 12:00 a. m. y la 1:00 a. m. de hoy cuando al menos el 80 % de los valores eran
correctos.]
Rate
Devuelve la diferencia a lo largo del tiempo entre el valor actual y un valor evaluado
anteriormente de un atributo o una expresión (de tiempo).
Sintaxis
Rate(x)
Argumentos
• x
Un atributo o una expresión (de tiempo) que se resuelve en un valor numericó.
Returns
• La diferencia calculada utilizando el valor del atributo, el valor numericó o de marca de
tiempo del parametró de expresión, segun esta fórmula: (valor actual – valor evaluado
anteriormente) / (marca de tiempo actual – marca de tiempo de la evaluación anterior).
Ejemplo
• Rate(‘att1’)
• Rate('sinusoid')
• Rate(DaySec(‘*’) + 1)
RecordedValues
Obtiene valores dentro de un intervalo de tiempo específicó segun el tipo de límite especificadó
por el usuario.
Sintaxis
RecordedValues(attname, starttime, endtime [, boundarytype])
442
Guía del usuario PI System Explorer
Análisis basados en activos
Argumentos
• attname
atributo con datos de serie temporal (por ejemplo, la referencia de datos de PI point) entre
comillas simples
• starttime
una expresión de tiempo que representa el comienzo de un intervalo de tiempo entre
comillas simples; puede ser un tiempo relativo (por ejemplo, '-3h') en referencia a una hora
final absoluta
• endtime
una expresión de tiempo que representa el final de un intervalo de tiempo entre comillas
simples; puede ser un tiempo relativo (por ejemplo, '+1h') en referencia a una hora de inicio
absoluta
• boundarytype
una cadena que indica el comportamiento de recuperación de datos en los puntos finales de
un tiempo especificadó en comillas dobles:
"Inside": devuelve los valores mas cercanos registrados dentro del intervalo de tiempo
solicitado como el primer y ultimó valor
"Outside": devuelve los valores mas cercanos registrados fuera del intervalo de tiempo
solicitado como el primer y ultimó valor
"Interpolated": crea un valor interpolado en los puntos finales del intervalo de tiempo
solicitado si no existe un valor registrado en ese momento
Nota:
Si no se especifica, el modo predeterminado es "Inside".
Devuelve
Una matriz de los valores obtenidos dentro del intervalo especificadó
Excepciones
Si el atributo no es compatible con llamadas de intervalo, la función devuelve un error que así
lo indica
Notas
• Si starttime es anterior a endtime, los valores que resulten estaran en orden crónólógicó
ascendente; de lo contrario, estaran en orden crónólógicó descendente.
• Cuando no hay valores disponibles, pero usted especifica los tipos de límite "Outside" o
"Interpolated", devuelve un valor especial (NoData).
• Esta función recupera hasta 500 000 valores cada vez.
Ejemplo
• RecordedValues('att1', 't+2h', 't+8h')
[Devuelve los valores de 'att1' entre las 2:00 a. m. y las 8:00 a. m. de hoy usando el modo de
recuperación predeterminado "Inside"]
• RecordedValues('att1', 't', '+1h', "Outside")
[Devuelve los valores de 'att1' entre las 12:00 a. m. y la 1:00 a. m. de hoy usando el modo de
recuperación "Outside"]
Guía del usuario PI System Explorer
443
Análisis basados en activos
RecordedValuesByCount
Obtiene una cantidad de valores especificada empezando en la hora de inicio solicitada y en la
dirección especificada.
Sintaxis
RecordedValuesByCount(attname, starttime, count [, timedirection, boundarytype])
Argumentos
• attname
atributo con datos de serie temporal (por ejemplo, la referencia de datos de PI point) entre
comillas simples
• starttime
una expresión de tiempo que representa el inicio de la solicitud
• count
la cantidad de valores almacenados (registrados) para devolver. El valor debe ser mayor que
cero
• timedirection
una cadena que indica la dirección de tiempo en la recuperación de datos entre comillas
dobles:
"Backward": comienza a la hora de inicio y se desplaza hacia atras en el tiempo. Los valores
se devólveran en orden crónólógicó descendente
"Forward": comienza a la hora de inicio y se desplaza hacia adelante en el tiempo. Los
valores se devólveran en orden crónólógicó ascendente
Nota:
Si no se especifica, el modo predeterminado es "Backward".
• boundarytype
una cadena que indica el comportamiento de recuperación de datos en el punto final de un
tiempo especificadó en comillas dobles:
"Inside": devuelve los valores mas cercanos registrados dentro del límite de tiempo
solicitado
"Outside": devuelve los valores mas cercanos registrados fuera del límite de tiempo
solicitado
"Interpolated": crea un valor interpolado en el límite de tiempo solicitado si no existe un
valor registrado en ese momento
Nota:
Si no se especifica, el modo predeterminado es "Inside".
Devuelve
Una matriz de la cantidad especificada de valores (si esta disponible)
Excepciones
Si el atributo no es compatible con las llamadas, la función devuelve un error que así lo indica
444
Guía del usuario PI System Explorer
Análisis basados en activos
Notas
• Cuando no hay valores disponibles, pero usted especifica los tipos de límite "Outside" o
"Interpolated", devuelve un valor especial (NoData).
Ejemplo
• RecordedValuesByCount('att1', 't+2h', 5)
[Devuelve cinco valores de 'att1' en orden crónólógicó descendente, comenzando a las
2:00 a. m. de hoy y usando el modo de recuperación predeterminado "Inside" desplazandóse
hacia atras en el tiempo]
• RecordedValuesByCount('att1', 't+8h', 3, "Forward", "Outside")
[Devuelve los tres primeros valores de 'att1' desde las 8 a. m. de hoy usando el modo de
recuperación "Outside"]
Remainder
Devuelve el resto que resulta de la división de x por y utilizando el metódó IEEERemainder.
Este resto equivale a x - (y Q), donde Q es el cociente de x / y redondeado al entero mas
próximó (si x / y se queda en la mitad de dos enteros, se devuelve el entero par). Si x - (y Q) es
cero, se devuelve el valor +0 si x es positivo o -0 si x is negativo. Si y = 0, se devuelve NaN
(distinto de un numeró).
Sintaxis
Remainder(x, y)
Argumentos
• x
Cualquier valor numericó
• y
Cualquier valor numericó distinto de cero
Devuelve
Devuelve el resto que resulta de la división de x por y utilizando el metódó IEEERemainder
Nota:
No es el mismo resto que el que se devuelve utilizando el operador Mod (modulus)
Excepciones
Ninguna
Notas
La unidad de medida de x, si existe, se traslada al resulta
