PI System Explorer 2014 R2 User Guide ES

PI System Explorer
Gua del usuario
Para PI Asset Framework 2.6.1 incluido con PI Server 2014 R2

OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 USA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com
PI System Explorer Gua del usuario

2009-2014 by OSIsoft, LLC. Reservados todos los derechos.
Ninguna parte de esta publicacin puede ser reproducida, almacenada en un sistema de recuperacin o
transmitida, de ninguna forma ni por ningn medio, mecnico, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset
Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI
BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI Web API,
PI WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports y RtWebParts son
todas marcas comerciales de OSIsoft, LLC. Todas las dems marcas y nombres comerciales aqu utilizados
son propiedad de sus respectivos propietarios.
EE. UU. DERECHOS DEL GOBIERNO
Su uso, rplica o difusin por parte del Gobierno de EE.UU. est 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, segn proceda. OSIsoft, LLC.
Versin: 2.6.1
Publicacin: Julio de 2014
Contenido
Introduccin a PI Asset Framework.........................................................................1
Cmo se representan los activos en PI AF..................................................................................................1
Herramientas para trabajar con PI AF........................................................................................................2
Uso de PI System Explorer..................................................................................... 3

Componentes de la interfaz de usuario de PI System Explorer...................................................................3
Trabajo con el contenido del visor......................................................................................................... 4
Ajustar configuracin de idioma............................................................................................................8
Ingresar y extraer trabajo.......................................................................................................................... 8
Mtodos abreviados de teclado...............................................................................................................10
Cambiar el idioma................................................................................................................................... 11
Importacin y exportacin de bases de datos y objetos de base de datos................................................ 11
Importar y exportar una base de datos.................................................................................................11
Exportar objetos de biblioteca a otra base de datos.............................................................................14
Conexin a servidores y bases de datos................................................................. 17

Gestionar preferencias de conexin para PI System Explorer................................................................... 17
Conexin a servidores de PI AF................................................................................................................18
Conexin a un servidor de PI AF...........................................................................................................18
Aadir un servidor de PI AF a la lista de conexiones............................................................................. 19
Cambiar miembros colectivos............................................................................................................. 23
Cambiar a un miembro colectivo concreto...........................................................................................23
Conexin a PI Servers.............................................................................................................................. 23
Conexin a un PI Server....................................................................................................................... 23
Aadir un PI Server a la lista de conexiones......................................................................................... 25
Ver el estado de bfer de un PI Server................................................................................................. 26
Conexin a bases de datos de PI AF........................................................................................................ 26
Bases de datos de PI AF....................................................................................................................... 27
Crear una base de datos...................................................................................................................... 27
Ver o editar las propiedades de una base de datos............................................................................... 27
Configurar la base de datos predeterminada....................................................................................... 28
Renombrar una base de datos............................................................................................................. 28
Buscar una base de datos.................................................................................................................... 28
Actualizar la lista de bases de datos.....................................................................................................28
Acerca de la eliminacin de bases de datos......................................................................................... 28
Configurar permisos de seguridad para una base de datos.................................................................. 29
Configurar permisos de seguridad para todas las bases de datos.........................................................29
Localizar y consultar informacin de activos.......................................................... 31

Exploracin de activos............................................................................................................................. 31
Elementos mostrados por el navegador...............................................................................................31
Exploracin de elementos....................................................................................................................31
Exploracin de otros objetos............................................................................................................... 32
Configurar el tamao de la pgina del navegador................................................................................ 33
Abrir ventanas adicionales del navegador............................................................................................ 33
Buscar activos y datos de activo.............................................................................................................. 33
Bsqueda rpida..................................................................................................................................34
Paginacin de resultados de bsqueda................................................................................................ 34
Bsqueda en una fecha concreta......................................................................................................... 35
Bsqueda de PI points......................................................................................................................... 35
Buscar elementos................................................................................................................................ 37
Bsqueda de atributos en elementos.................................................................................................. 40
Buscar marcos de evento.................................................................................................................... 42
PI System Explorer Gua del usuario iii

Contenido
Buscar atributos en marcos de evento................................................................................................. 43

Buscar una transferencia..................................................................................................................... 44
Bsqueda de atributos en transferencias............................................................................................. 45
Crear una tendencia en PI System Explorer............................................................................................. 46
Gestionar cambios de equipos y procesos............................................................................................... 47
Crear una versin de un elemento o un modelo................................................................................... 48
Crear una versin de tabla................................................................................................................... 48
Visualizacin de diferentes versiones de objeto y objetos obsoletos....................................................48
Ver datos de series temporales................................................................................................................51
Estadsticas......................................................................................................................................... 52
Ponderacin........................................................................................................................................ 52
Expresin de filtro............................................................................................................................... 53
Tipo de lmite...................................................................................................................................... 54
Restricciones de visualizacin de los datos de serie temporal.............................................................. 54
Abreviaturas de configuracin de atributos......................................................................................... 55
Diseo e implementacin de modelos de activos de PI AF.......................................57

Organizacin de modelos de activos....................................................................................................... 57
Estructuracin del modelo de activos.................................................................................................. 57
Cmo tomar decisiones sobre jerarquas............................................................................................. 58
Crear vistas mltiples de activos..........................................................................................................59
Uso de categoras para facilitar la localizacin de objetos....................................................................62
Representacin de activos en PI Asset Framework.................................................................................. 63
Uso de elementos para modelar activos.............................................................................................. 64
Uso de elementos para representar activos......................................................................................... 70
Seguridad de objetos en PI AF................................................................................................................. 73
Configurar permisos para objetos........................................................................................................ 73
Configurar permisos para colecciones................................................................................................. 78
Asociacin de datos con activos.............................................................................................................. 78
Crear una plantilla de atributos............................................................................................................79
Trabajo con conjuntos de enumeracin............................................................................................... 80
Definicin de valores de atributos de constante.................................................................................. 82
Configuracin de referencias de datos.................................................................................................84
Trabajo con unidades de medida........................................................................................................... 128
Unidades de medida de PI AF............................................................................................................ 128
Clases base y clases derivadas........................................................................................................... 129
Crear una unidad de medida.............................................................................................................. 129
Crear una clase de unidad de medida................................................................................................. 130
Clases base de unidades de medida................................................................................................... 131
Algunas clases derivadas de unidades de medida comunes................................................................ 131
Asset-Based Analytics para PI Server...................................................................133

Acerca de los anlisis............................................................................................................................. 133
Uso de plantillas de anlisis................................................................................................................134
Programacin de anlisis................................................................................................................... 134
Actualizacin de anlisis y de plantillas de anlisis............................................................................. 135
Expresiones....................................................................................................................................... 135
Anlisis de expresiones..........................................................................................................................136
Crear una plantilla de anlisis de expresiones..................................................................................... 137
Crear una plantilla de anlisis de expresiones.....................................................................................138
Anlisis de resumen...............................................................................................................................138
Crear una plantilla de anlisis de resumen..........................................................................................139
Crear un anlisis de resumen............................................................................................................. 140
Anlisis de generacin de marcos de evento..........................................................................................141
Crear una plantilla de anlisis de generacin de marcos de evento.....................................................142
Crear anlisis de generacin de marcos de evento............................................................................. 143
Especificar durante cunto tiempo debe ser verdadero un activador de inicio....................................144
iv PI System Explorer Gua del usuario

Contenido
Gestin de los anlisis de un elemento.................................................................................................. 144

Reponer datos de un anlisis..............................................................................................................145
Gestin de la seguridad de los anlisis y las plantillas de anlisis........................................................ 146
Anlisis de ejemplo............................................................................................................................... 146
Crear un anlisis de expresin............................................................................................................146
Crear una plantilla de anlisis de resumen......................................................................................... 149
Crear de forma automtica marcos de evento para realizar un seguimiento de los datos................... 151
Gestin de anlisis en la base de datos de AF.........................................................................................153
Gestin de PI Analysis Service............................................................................................................... 154
Ver estadsticas del servicio de anlisis...............................................................................................155
Ver o modificar el servicio de anlisis................................................................................................. 155
Configuracin del servicio de anlisis................................................................................................. 155
Referencia de funciones de expresin.................................................................................................... 157
Abs.................................................................................................................................................... 157
Acos...................................................................................................................................................157
AND.................................................................................................................................................. 158
Ascii...................................................................................................................................................158
Asin................................................................................................................................................... 159
Atn.................................................................................................................................................... 159
Atn2.................................................................................................................................................. 160
Avg....................................................................................................................................................160
Badval............................................................................................................................................... 161
Bod....................................................................................................................................................161
Bom.................................................................................................................................................. 162
Bonm................................................................................................................................................ 162
Ceiling............................................................................................................................................... 163
Char...................................................................................................................................................163
Compare........................................................................................................................................... 164
Concat...............................................................................................................................................165
Convert............................................................................................................................................. 165
Cos.................................................................................................................................................... 166
Cosh.................................................................................................................................................. 166
Cot.................................................................................................................................................... 166
Coth.................................................................................................................................................. 167
Csc.....................................................................................................................................................167
Csch.................................................................................................................................................. 168
Curve.................................................................................................................................................168
Day................................................................................................................................................... 169
DaySec.............................................................................................................................................. 169
DigState............................................................................................................................................ 170
DigText..............................................................................................................................................170
E........................................................................................................................................................ 171
ELSE.................................................................................................................................................. 171
EventCount........................................................................................................................................172
Exp.................................................................................................................................................... 173
FindEq............................................................................................................................................... 173
FindGE...............................................................................................................................................174
FindGT...............................................................................................................................................175
FindLE............................................................................................................................................... 176
FindLT................................................................................................................................................177
FindNE...............................................................................................................................................178
Float.................................................................................................................................................. 178
Floor.................................................................................................................................................. 179
Formato.............................................................................................................................................179
Frac................................................................................................................................................... 180
Hour.................................................................................................................................................. 180
IF....................................................................................................................................................... 181
PI System Explorer Gua del usuario v

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

Contenido
TagMean........................................................................................................................................... 214
TagMin..............................................................................................................................................214
TagName.......................................................................................................................................... 215
TagNum............................................................................................................................................ 216
TagSource......................................................................................................................................... 216
TagSpan............................................................................................................................................ 217
TagTot...............................................................................................................................................217
TagType............................................................................................................................................ 218
TagVal...............................................................................................................................................219
TagZero............................................................................................................................................ 219
Tan....................................................................................................................................................220
Tanh..................................................................................................................................................220
Text.................................................................................................................................................. 220
THEN................................................................................................................................................ 221
TimeEq..............................................................................................................................................221
TimeGE............................................................................................................................................. 222
TimeGT............................................................................................................................................. 223
TimeLE............................................................................................................................................. 224
TimeLT..............................................................................................................................................225
TimeNE............................................................................................................................................. 225
Timestamp........................................................................................................................................226
Total..................................................................................................................................................227
Trim.................................................................................................................................................. 227
Trunc................................................................................................................................................. 227
UCase............................................................................................................................................... 228
Yearday.............................................................................................................................................229
Year.................................................................................................................................................. 229
Weekday........................................................................................................................................... 230
Funciones del vapor para expresiones de anlisis...................................................................................230
Rangos de las entradas de la funcin de vapor................................................................................... 231
Conversin de unidades de medida para funciones de vapor............................................................. 234
Estados de referencia de la propiedad del vapor................................................................................ 235
Referencia de funciones del vapor..................................................................................................... 235
Uso de marcos de evento para capturar eventos de proceso.................................. 247

Marcos de evento.................................................................................................................................. 247
Ejemplos de marcos de evento.......................................................................................................... 249
Ventajas de PI Event Frames............................................................................................................. 249
PI Event Frames o PI Batch?.............................................................................................................250
Mtodos de creacin de marcos de evento............................................................................................250
Plantillas de marcos de evento.............................................................................................................. 251
Visualizacin de marcos de evento con herramientas cliente.................................................................252
Representacin de eventos en PI Asset Framework...............................................................................252
Trabajo con marcos de evento...........................................................................................................252
Trabajo con transferencias................................................................................................................ 256
Captura de valores para marcos de evento y transferencias...............................................................258
Bloquear un marco de evento o una transferencia............................................................................. 259
Temas avanzados.............................................................................................. 261

Cadenas de configuracin de atributos..................................................................................................261
Cadenas de configuracin para referencias de datos de PI points...................................................... 262
Especificacin de PI points................................................................................................................ 262
Configuracin de valores de atributo................................................................................................. 263
Cadenas de configuracin para creacin automtica de puntos.........................................................265
Actualizaciones masivas de cadenas de configuracin...........................................................................265
Sintaxis de referencia de atributo.......................................................................................................... 267
Sintaxis de las especificaciones de ruta.............................................................................................. 267
PI System Explorer Gua del usuario vii

Contenido
Ejemplos de cmo referenciar atributos del mismo elemento .......................................................... 269

Ejemplos de cmo referenciar atributos de distintos elementos........................................................ 273
Ejemplos de cmo referenciar atributos de un marco de evento con el elemento referenciado principal
.......................................................................................................................................................... 274
Utilidades de PI AF................................................................................................................................ 274
Iniciar PSE con opciones de lnea de comandos................................................................................. 274
Exportar objetos de PI AF.................................................................................................................. 276
Importar objetos de PI AF.................................................................................................................. 278
AFDiag: Utilidad de diagnstico de PI AF...........................................................................................280
Configurar la utilidad del servidor de PI AF........................................................................................ 288
Capturar salidas de trazos de eventos en AF SDK.............................................................................. 288
Seguimiento de los cambios en AF con Pista de auditora..................................................................289
Persistencia...........................................................................................................................................291
Limitaciones respecto a los nombres de objetos de AF.......................................................................... 291
Introduccin de valores para tipos de valor............................................................................................291
Configurar el valor de atributo con el nombre de otro atributo.......................................................... 292
Creacin de tipos de referencia personalizados..................................................................................... 292
Nivel de fortaleza de los tipos de referencia de elemento.................................................................. 292
Tipos de referencia predefinidos....................................................................................................... 294
Crear tipos de referencia personalizados........................................................................................... 294
Copiar rutas.......................................................................................................................................... 294
Almacenar informacin especfica de aplicaciones................................................................................ 295
Gestin de mdulos.............................................................................................................................. 296
Ver mdulos instalados actualmente.................................................................................................296
Registro de mdulos mediante la lnea de comandos........................................................................ 296
Crear un archivo de registro XML...................................................................................................... 299
Crear un script de registro SQL.......................................................................................................... 300
Registrar un mdulo mediante el script SQL generado...................................................................... 300
Gestin de proveedores de mdulos de confianza............................................................................. 300
Modelado de un proceso....................................................................................................................... 301
mbito del modelo............................................................................................................................ 301
Pautas para configurar un modelo..................................................................................................... 302
Ver y editar modelos..........................................................................................................................303
Crear modelos................................................................................................................................... 303
Puertos y conexiones.........................................................................................................................304
Capas................................................................................................................................................ 306
Trminos de PI AF.............................................................................................. 307

Atributos...............................................................................................................................................308
Plantillas de atributos............................................................................................................................308
Plantillas base....................................................................................................................................... 308
Atributos de configuracin.................................................................................................................... 308
Referencias de datos............................................................................................................................. 309
Atributo predeterminado...................................................................................................................... 309
Plantilla de elementos........................................................................................................................... 309
Elementos.............................................................................................................................................309
Marco de evento....................................................................................................................................310
Propiedades ampliadas......................................................................................................................... 310
Datos externos...................................................................................................................................... 310
Fuente de datos externos...................................................................................................................... 310
Tabla externa........................................................................................................................................ 310
Conexin suplantada............................................................................................................................. 311
Tabla importada.................................................................................................................................... 311
Atributos indexados...............................................................................................................................311
Tabla externa.........................................................................................................................................311
Tabla vinculada......................................................................................................................................311
Modelos................................................................................................................................................ 312
viii PI System Explorer Gua del usuario

Contenido
Conexin no suplantada........................................................................................................................ 312

Bases de datos de PI AF......................................................................................................................... 312
Biblioteca guardada de PI AF................................................................................................................. 312
Servidor de PI AF................................................................................................................................... 313
Base de datos SQL de PI AF................................................................................................................... 313
Tabla..................................................................................................................................................... 313
PI Asset Framework (PI AF)....................................................................................................................313
Referencia de datos de matriz de PI point..............................................................................................314
Referencia de datos de PI point............................................................................................................. 314
Fecha de consulta..................................................................................................................................314
Parmetros de sustitucin..................................................................................................................... 314
Plantillas................................................................................................................................................315
Referencia de datos de bsqueda de tabla............................................................................................. 315
Unidades de medida (UOM).................................................................................................................. 315
Soporte tcnico y otros recursos......................................................................... 317
PI System Explorer Gua del usuario ix

Contenido
x PI System Explorer Gua del usuario

Introduccin 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 creacin y
gestin de objetos de PI AF. Las dos funcionalidades ms importantes que proporcionan son:
Compatibilidad con marcos de eventos

Los marcos de eventos permiten capturar eventos de proceso importantes. Consulte Uso de
marcos de evento para capturar eventos de proceso para obtener una descripcin general
de los marcos de evento.
Anlisis basados en activos

Integrados en PI System Explorer, los anlisis basados en activos permiten crear clculos y
configurar declaraciones condicionales relacionadas con valores de activo. Consulte Asset-
Based Analytics para PI Server para obtener ms informacin.
En esta seccin
Cmo se representan los activos en PI AF
Herramientas para trabajar con PI AF
Cmo se representan los activos en PI AF

PI Asset Framework (PI AF) le permite crear una representacin del equipo y los procesos,
proporcionndole de este modo una excelente visin general de los datos. En PI AF, el equipo y
los procesos objeto de supervisin se denominan activos. La representacin general de todos
los activos y procesos en PI AF se denomina modelo de activos. El modelo de activos organiza la
totalidad del equipo en una estructura que hace que encontrar la informacin resulte sencillo.
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 atributosde ese elemento. Los atributos
pueden incluir valores simples, que representan informacin fija, como el dimetro de un
tanque, por ejemplo. Un atributo puede hacer referencia tambin a un PI point, una frmula, un
valor de una base de datos relacional, un archivo, una fotografa, 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 presin (leda de
un PI point), la temperatura de entrada y la temperatura de salida. Para establecer un modelo
de estos datos en AF, puede crear un elemento que represente la bomba y a continuacin los
tres atributos que representen los datos asociados.
En la siguiente ilustracin, 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 ningn momento los nombres
de los PI points. Todos los datos estn disponibles directamente en el elemento.
PI System Explorer Gua del usuario 1

Introduccin a PI Asset Framework
Herramientas para trabajar con PI AF

OSIsoft proporciona dos herramientas para crear y editar objetos de PI AF:
PI System Explorer proporciona una interfaz grfica de usuario para crear, editar y
administrar objetos de PI AF. Utilice PI System Explorer para crear y administrar su
infraestructura de activos que incluye los elementos de las bases de datos de PI AF, las
plantillas y todos los dems objetos de PI AF. Si es la primera vez que utiliza PI AF, empiece
con PI System Explorer.
Para abrir PI System Explorer desde el men Inicio de Windows, seleccione Todos los
programas > PI System > PI System Explorer.
PI Builder es un complemento de Microsoft Excel que permite trabajar con objetos de PI AF
de forma masiva. Para obtener ms informacin sobre PI Builder, consulte la PI Builder User
Guide.
Adems, todas las aplicaciones cliente de PI permiten a los usuarios ver elementos y atributos
de PI AF.
2 PI System Explorer Gua del usuario

Uso de PI System Explorer
PI System Explorer permite a los usuarios encontrar informacin sobre equipos y procesos:
Encontrar los datos de un elemento concreto del equipo. Por ejemplo: Datos de PI points,
resultados de clculos, informacin de mantenimiento, etc. Por ejemplo, puede utilizar PI
System Explorer para encontrar informacin sobre un determinado tanque en una planta
concreta.
Encontrar un equipo completo con determinados valores de atributo o rangos de valores.
Por ejemplo, encontrar todos los tanques fabricados por la empresa XYZ.
PI System Explorer dispone tambin de muchas funciones para modelar los equipos y
procesos.
En esta seccin
Componentes de la interfaz de usuario de PI System Explorer
Ingresar y extraer trabajo
Mtodos abreviados de teclado
Cambiar el idioma
Importacin y exportacin de bases de datos y objetos de base de datos
Componentes de la interfaz de usuario de PI System Explorer

En la siguiente ilustracin se muestran los principales componentes de PI System Explorer.

1. Barra de mens
2. Barra de herramientas
3. Navegador
4. Panel de navegacin
5. Barra de estado
6. Paleta
7. Visor
En esta seccin
Trabajo con el contenido del visor
Ajustar configuracin de idioma
Trabajo con el contenido del visor

En las siguientes secciones se explica cmo configurar la visualizacin de elementos en el visor
y cmo trabajar con los contenidos.
En esta seccin
Control del nmero de objetos en el visor
Configuracin de las columnas mostradas
Seleccin de varios objetos para las operaciones
Mostrar valores de atributo en unidad de medida de origen
Cambiar la unidad de medida de un valor de atributo
Copiar objetos del visor
Mostrar atributos como columnas

Control del nmero de objetos en el visor

Para controlar el nmero de objetos que aparecen en el visor, especifique el tamao mximo de
las consultas en la ventana Opciones (haga clic en Herramientas > Opciones). Si el nmero de
objetos supera el lmite, la coleccin se pagina y solo se puede ordenar por nombre. En la
siguiente ilustracin, se muestra la primera de las dos pginas de objetos disponibles. Haga clic
en 2 o Siguiente para ver la segunda pgina.
Haga clic en para abrir la ventana Seleccionar nmero de pgina.
Configuracin de las columnas mostradas

Algunas de las pestaas del visor muestran columnas de datos. Puede seleccionar las columnas
que se mostrarn. Las columnas disponibles dependen de la pestaa del visor que se seleccione
y del objeto seleccionado en el navegador. Para especificar las columnas que se mostrarn,
haga clic en y seleccione las columnas que desee.
Seleccin de varios objetos para las operaciones

Para seleccionar en el visor varios objetos para operaciones como copiar, eliminar, exportar,
insertar/extraer, cambiar de plantilla, etc., utilice el ratn y las combinaciones de teclado
estndar de Windows:
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 Mays y haga clic en el ltimo 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 seleccin de
algn objeto individual dentro del grupo seleccionado, pulse la tecla CTRL y haga clic en
cada objeto.
Nota:
Solo se pueden seleccionar varios objetos en el visor. Del mismo modo que no puede
seleccionar varias carpetas en la vista de carpetas (vista de rbol) de Windows Explorer,
tampoco puede seleccionar varios objetos en el navegador de PI System Explorer.
Una vez seleccionados lo objetos, haga clic con el botn secundario y seleccione la operacin
que desee realizar en el men que aparece.
Mostrar valores de atributo en unidad de medida de origen

Puede optar por mostrar valores para los atributos en las unidades definidas mediante una
referencia de datos en lugar de en las unidades predeterminadas.
Procedimiento
1. Seleccione Herramientas > Opciones.
2. En la pestaa General, seleccione Utilizar unidad de medida origen para visualizar atributo.
3. Haga clic en Aplicar.
4. Haga clic en Aceptar para cerrar el dilogo.

Cambiar la unidad de medida de un valor de atributo

Puede cambiar si lo desea la unidad de medida (UOM) en la que se muestra un valor de
atributo.
Procedimiento
1. En el visor, pulse con el botn derecho del ratn sobre el valor de un atributo y seleccione
Cambiar despliegue UOM.
2. Seleccione la nueva unidad de medida en la que se mostrar el valor.
Copiar objetos del visor

Puede copiar objetos individuales o varias filas de objetos y pegar la informacin de esos
objetos en una hoja de clculo en un formato separado por tabulaciones. Utilice el men
contextual (seleccione y haga clic con el botn secundario) y elija una de estas opciones:
Copiar copia una fila entera.

Copiar ruta copia el objeto y su ruta, incluido el servidor de PI AF (Copia de rutas).
Copiar celda copia el texto en una nica celda.
Una fila seleccionada, el elemento MixTruck, en el tutorial Chocolate Milk
Mostrar atributos como columnas

Puede seleccionar atributos para mostrarlos como columnas en el visor.
Procedimiento
1. En PI System Explorer, pulse el botn Elementos en el panel del navegador.
2. En la parte superior del navegador, seleccione el contenedor de elementos.

3. En el extremo derecho del visor, haga clic en y elija Seleccionar atributos en el men
emergente. Se abre el cuadro de dilogo Seleccionar atributos.
4. Seleccione los atributos que desea mostrar en el visor:
Seleccione el botn de opcin Aadir atributos desde la plantilla o Aadir atributos desde
el elemento. Los atributos disponibles aparecern en la lista de seleccin Atributos, en el
cuadro de dilogo a la izquierda. Haga clic en para mover todos los atributos a la
lista de atributos mostrados (en el lado derecho del cuadro de dilogo) o en para
aadir solo el atributo seleccionado.
Nota:
Las plantillas comparten con frecuencia atributos que tienen el mismo nombre. Los
nombres deben aadirse de uno en uno. Por ejemplo, si la lista ya contiene el atributo
Volume, no podr aadirlo otra vez.
En el campo de texto Otros, introduzca nombres de atributos separados por un punto y

coma o haga clic en para buscar un atributo por el nombre. A continuacin, haga clic
en el botn Aadir para aadir los atributos a la lista de atributos mostrados.
5. Si lo desea, cambie el orden de aparicin de los atributos en la lista.
6. Haga clic en Aceptar para finalizar la seleccin de atributos.
Los atributos seleccionados aparecern como columnas en el visor.
Qu hacer a continuacin
Si desea eliminar o incluir atributos adicionales, abra el cuadro de dilogo Seleccionar atributos
y repita el proceso.
En esta seccin
Seleccionar atributos de una plantilla
Seleccionar atributos de un elemento
Seleccionar atributos por nombre
Seleccionar atributos de una plantilla
Procedimiento
1. En el visor, haga clic en y elija Seleccionar atributos en el men emergente.
2. Seleccione Aadir atributos desde la plantilla.

3. Haga clic en para elegir una plantilla.
4. Seleccione un atributo en la plantilla y haga clic en para aadir el atributo a la lista de

atributos mostrados.
5. Si desea aadir ms atributos procedentes de diferentes plantillas, vuelva a hacer clic en
y seleccione otra plantilla.
Tenga en cuenta que las plantillas comparten con frecuencia atributos que tienen el mismo
nombre. Los nombres deben aadirse de uno en uno. Por ejemplo, si la lista ya contiene el
atributo Volume, no podr volver a aadirlo.


7. Haga clic en Aceptar para finalizar la seleccin de atributos. Los atributos seleccionados
aparecern como columnas en el visor.
Seleccionar atributos de un elemento
Procedimiento
1. En el visor, haga clic en y elija Seleccionar atributos en el men emergente. Se abre la
ventana Seleccionar atributos.
2. Seleccione Aadir atributos desde el elemento.
3. Haga clic en para localizar un elemento concreto o haga clic en para buscar un
elemento por el nombre.
4. Seleccione un atributo en el elemento y haga clic en para aadir el atributo a la lista de
atributos mostrados.
Los atributos seleccionados aparecern como columnas en el visor.
Seleccionar atributos por nombre
Procedimiento
1. En el visor, haga clic en y elija Seleccionar atributos en el men emergente. Se abre el
cuadro de dilogo Seleccionar atributos.
2. En Otros, introduzca nombres de atributo separados por un punto y coma.
3. Si lo desea, haga clic en para buscar un atributo por el nombre.
4. Haga clic en Aadir para aadir los atributos a la lista de atributos mostrados.
7. Los atributos seleccionados aparecern como columnas en el visor.
Ajustar configuracin de idioma

Si tiene varios paquetes de idiomas instalados, la opcin Configuracin de idioma se mostrar
en el men Ver. Seleccione esta opcin y cambie el idioma predeterminado en la ventana de
herramientas de configuracin de idiomas de PI que se abre. Tendr que cerrar y reiniciar PI
System Explorer para que el cambio se aplique.
Ingresar y extraer trabajo

Debe guardar en la base de datos los cambios que realice en un objeto. Los cambios que no se
han guardado se indican con un icono de marca de verificacin 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 verificacin 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, pulse el botn Ingresar.
En el navegador, haga clic con el botn secundario sobre un objeto y seleccione Ingresar.
Las dos primeras opciones le permiten guardar los cambios de todos los objetos que haya
modificado. Se mostrar el cuadro de dilogo Ingresar con los objetos que se han modificado.
Puede ingresarlos todos o seleccionar solo algunos y dejar el resto fuera. Pulse el botn
Sesin en el cuadro de dilogo para seleccionar los objetos modificados solo en la sesin
actual. Seguir teniendo la posibilidad de ingresar los objetos modificados en otras sesiones.
La tercera opcin, que aparece en la siguiente figura, guarda en la base de datos solo los
cambios en ese objeto. Otros objetos modificados no se ingresan.
Si opta por no guardar los cambios, utilice la opcin Deshacer extraccin.

Puede realizar cambios en un objeto y aplicarlos sin ingresarlos en la base de datos. Haga clic
en Aplicar cambios, como se muestra ms abajo.
Mtodos abreviados de teclado

PI System Explorer proporciona mtodos abreviados de teclado para navegar y realizar otras
tareas que necesitan un ratn u otro dispositivo sealador.
Acceso directo Accin
CTRL+A Selecciona todos los objetos del 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.
SUPR Elimina el objeto seleccionado.
MAYS+SUPR Igual que CTRL+X
INSERT Aade un objeto nuevo al visor o al navegador.
INICIO Selecciona la primera fila del visor; por ejemplo, la
primera fila de una tabla de atributos.
FIN Selecciona la ltima fila del visor.
CTRL+INICIO Selecciona la primera celda de la pgina actual del
visor.
CTRL+FIN Selecciona la ltima celda de la pgina actual del
visor.
ALT+INICIO Selecciona la primera pgina de objetos del visor.
ALT+FIN Selecciona la ltima pgina de objetos del visor.
CTRL+RE PG Selecciona la pgina de objetos anterior del visor.
CTRL+AV PG Selecciona la pgina de objetos siguiente del visor.
CTRL+ENTER Si el visor contiene varias pginas de objetos,
muestra la ventana Seleccionar nmero de pgina.
ALT+ENTER En el navegador, muestra las propiedades del
objeto seleccionado.
BARRA ESPACIADORA Pulsa el botn seleccionado en ese momento.
o
ENTER
Flechas izquierda, derecha, arriba y abajo Navegue por los objetos del visor o del navegador.
F2 Edita el objeto seleccionado en el visor. En el caso
de los objetos completos, muestra la ventana de
edicin del objeto.

Acceso directo Accin

F4 Muestra las opciones del cuadro de lista
seleccionado. En el caso de las listas con capas,
o
muestra la jerarqua completa de las opciones.
ALT+flecha arriba
o
ALT+fecha abajo
Cambiar el idioma
Podr cambiar el idioma de la aplicacin instalada en su equipo si dispone de un paquete de
idioma y tiene instalados los recursos del idioma deseado. La configuracin de idioma se
corresponde con la configuracin regional del usuario. Por lo tanto, si otros usuarios desean
utilizar la aplicacin en el mismo equipo iniciando sesin con otra cuenta, podrn utilizar otros
recursos de idioma, si estn disponibles.
1. Ejecute el paquete de idioma y seleccione los recursos de idioma que desee instalar, si no
estn an disponibles.
2. Haga clic en Ver > Configuracin de idioma. Se mostrar el dilogo de la herramienta de
configuracin de idioma.
3. Seleccione el idioma de destino y haga clic en Aceptar.
4. Salga y reinicie la aplicacin.
La aplicacin se mostrar en el idioma especificado. Tenga en cuenta que los usuarios que
inicien sesin con la misma cuenta vern el mismo idioma, pero cambiar para los que
inicien sesin en el equipo con otras cuentas.
Importacin y exportacin de bases de datos y objetos de

base de datos
En esta seccin
Importar y exportar una base de datos
Exportar objetos de biblioteca a otra base de datos
Importar y exportar una base de datos

PI System Explorer permite exportar una base de datos en XML y restaurarla despus a partir
del archivo XML importndolo de nuevo en AF.
Para exportar la base de datos sin tener que gestionar archivos XML, exporte la base de datos
como una biblioteca (Guardar una base de datos como biblioteca).
En esta seccin
Exportar una base de datos a XML
Restaurar una base de datos

Exportar una base de datos a XML

Este procedimiento archiva bases de datos AF en un archivo XML que se puede restaurar
posteriormente.
Nota:
Tambin puede exportar objetos de PI AF desde una utilidad de lnea de comandos. Vase
Exportar objetos de PI AF.
Procedimiento
1. Haga clic en Archivo > Exportar a archivo.
Se mostrar el cuadro de dilogo Exportar a archivo.
2. Seleccione las opciones de exportacin que desee (Opciones de exportacin a XML).
3. Haga clic en Aceptar.
PI System Explorer exportar la base de datos actual a un archivo XML.
En esta seccin
Opciones de exportacin a XML
Formato de archivo de exportacin y restauracin
Opciones de exportacin a XML

Casilla de verificacin Resultado
Incluir todos los objetos referenciados Esta opcin origina la exportacin de las
referencias dependientes. Por ejemplo, si exporta
un elemento, se exportarn tambin la plantilla de
elementos, las categoras utilizadas, etc. Utilice esta
opcin para facilitar el movimiento de objetos
entre diferentes bases de datos de PI AF.
Incluir ajustes de seguridad Esta opcin origina la exportacin de los ajustes de
seguridad de objetos individuales. Aumenta el
tiempo necesario para realizar la exportacin y las
subsiguientes operaciones de importacin. Debe
tener privilegios de administrador para importar
objetos que tengan especificada la opcin de
ajustes de seguridad.
Incluir valores predeterminados Seleccione esta casilla de verificacin para incluir
los valores predeterminados asignados a los
objetos. Sin esta opcin, en la salida no se incluirn
las propiedades cuyo valor predeterminado no se
haya modificado. Esto ahorra una gran cantidad de
espacio y tiempo cuando se exportan grandes
cantidades de datos.
Incluir IDs nicos Esta opcin incluye el ID exclusivo de cada objeto
de la exportacin. Si incluye esta opcin, podr
renombrar los elementos existentes durante una
importacin a la misma base de datos. A menos
que sea necesario renombrar los elementos,
resulta ms eficaz dejar esta opcin sin activar.

Casilla de verificacin Resultado

XML plano Seleccione esta casilla de verificacin para
exportar objetos jerrquicos en formato plano. La
exportacin sin formato puede hacer que la
edicin en algunas herramientas resulte ms
sencilla. Los objetos jerrquicos que se exportarn
sin formato son: atributos, plantillas de atributos,
elementos y marcos de evento.
Solo objetos de la Biblioteca Si selecciona esta casilla, se desactivarn las
opciones de marcos de evento, transferencias y
casos.
Simplificar cadenas de configuracin Si selecciona esta casilla, se eliminarn el PI Server
y los identificadores de tag de las cadenas de
configuracin para las referencias de datos de PI
points. Asimismo, se resolvern los parmetros de
sustitucin.
Nota:
La seleccin de esta opcin ralentiza el

proceso de exportacin porque requiere la
evaluacin de las cadenas de configuracin
guardadas.
Incluir marcos de eventos, transferencias y casos Seleccione esta casilla para exportar marcos de
evento, transferencias y casos.
Formato de archivo de exportacin y restauracin

El formato XML de importacin/exportacin se describe en el archivo de esquema ubicado en
el directorio de instalacin PIPC\AF,OSIsoft.AF.xsd.
Muchos de los objetos AF admiten un atributo de operacin en el XML que permite la
eliminacin. Del mismo modo, puede ejecutar la opcin de configuracin automtica del punto
de forma selectiva en los elementos utilizando la misma tcnica. 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 est incluida en el nombre de campo. Ejemplo:
...
<AFElement> <Name>RootElement</Name> ... </AFElement>
<AFElement> <Name>RootElement\ChildElement1<\Name> ... </AFElement>
<AFElement> <Name>RootElement\ChildElement2<\Name> ... </AFElement>
...
Restaurar una base de datos

Este procedimiento restaura una base de datos exportada a XML.
Tambin puede importar objetos de PI AF desde una utilidad de lnea de comandos. Vase
Importar objetos de PI AF.
Procedimiento
1. Haga clic en Archivo > Importar desde archivo. Se abrir la ventana Importar a archivo.
2. Seleccione el archivo XML que contenga los datos y elija las opciones correspondientes.
Permitir crear

Esta opcin permite crear objetos. Si el propsito de la operacin es actualizar los

elementos existentes, desmarque esta opcin para evitar la creacin accidental de
objetos.
Permitir actualizar
Esta opcin permite actualizar los objetos existentes. Si la finalidad de la operacin es
simplemente aadir elementos nuevos, desmarque esta opcin para evitar que se
sobrescriban objetos de forma accidental.
Ingreso automtico
Esta opcin permite a la operacin de importacin ingresar objetos de forma automtica
a medida que se realiza dicha operacin. De esta forma, se reducen los requisitos de
mximo de memoria de la operacin. Utilice esta opcin cuando vaya a importar un
nmero considerable de objetos.
Crear o actualizar PI Points
Esta opcin actualiza los atributos con una configuracin de PI Point especificada en el
archivo XML si ya existen o los crea si no existen. Esta opcin invoca la opcin
CreateConfig de Referencia de datos correcta, que crea o actualiza PI points, adems de
resolver tambin los parmetros de sustitucin y configurar el servidor y los point ID.
Cuando se selecciona esta opcin, el rendimiento de la operacin de importacin se ve
afectado.
Nota:
El PI point no se crea si no se selecciona la casilla de verificacin Creacin de tag en la
ventana Referencia de datos de PI Point.
Exportar objetos de biblioteca a otra base de datos

Puede exportar objetos de biblioteca (plantillas, frmulas, unidades de medida, etc.) de una
base de datos a otra.
En esta seccin
Biblioteca guardada de PI AF
Ver las bibliotecas instaladas actualmente
Guardar una base de datos como biblioteca
Cargar una biblioteca de bases de datos
Renombrar o editar una biblioteca de bases de datos
La biblioteca guardada de PI AF ofrece una coleccin de objetos de aplicacin o de dominio
especfico que se puede importar a una base de datos de PI AF. Las bibliotecas guardadas
incluyen, por lo general, categoras, plantillas de elementos, conjuntos de enumeracin, tipos
de referencia, tablas y la base de datos de unidades de medida. No obstante, al guardar una
biblioteca tendr la opcin de incluir otros objetos, como elementos y notificaciones. Aunque la
base de datos de unidades de medida no se muestra en la pestaa Biblioteca del panel del
navegador, se incluye siempre como parte de las bibliotecas guardadas.
Nota:
Las bibliotecas se almacenan como XML dentro de la base de datos SQL de AF. Esta
opcin no es igual que la de Exportar a archivo, que exporta una base de datos completa
como un archivo XML.

Ver las bibliotecas instaladas actualmente

Procedimiento
1. Seleccione Archivo > Propiedades de servidor AF.
Se mostrar la ventana Propiedades de servidor AF.
2. Seleccione la pestaa Bibliotecas.
Las bibliotecas instaladas actualmente se incluirn en esta pestaa.
Nota:
Pulse con el botn secundario sobre una biblioteca para ver sus propiedades.
Guardar una base de datos como biblioteca

Procedimiento
1. Haga clic en Archivo > Guardar como biblioteca. Se mostrar la ventana Guardar base de
datos como biblioteca.
2. Introduzca un nombre y una descripcin.
3. Seleccione la opcin Remplazar la biblioteca existente sin preguntar para permitir que se
sustituya una biblioteca con el mismo nombre.
4. Seleccione la opcin Incluir objetos ajenos a la biblioteca para incluir objetos, como
elementos y notificaciones, en la biblioteca.
Cargar una biblioteca de bases de datos

Procedimiento
1. Haga clic en Archivo > Cargar biblioteca. Se mostrar la ventana Cargar biblioteca en base
de datos.
2. Seleccione la biblioteca y haga clic en Aceptar. PI System Explorer cargar la biblioteca en la
base de datos actual.
Renombrar o editar una biblioteca de bases de datos

Procedimiento
1. Haga clic en Archivo > Propiedades de servidor AF. Se mostrar la ventana Propiedades de
servidor AF.
2. En la pestaa Bibliotecas, pulse con el botn secundario sobre la biblioteca y seleccione
Propiedades.
3. Realice los cambios en la ventana Propiedades de biblioteca cuando aparezca.


Conexin a servidores y bases de datos
En esta seccin
Gestionar preferencias de conexin para PI System Explorer
Conexin a servidores de PI AF
Conexin a PI Servers
Conexin a bases de datos de PI AF
Gestionar preferencias de conexin para PI System Explorer

Utilice la ventana Opciones de servidor para definir cmo se debe conectar PI System Explorer
a un colectivo de AF o un PI collective, si se permitirn solicitudes de inicio de sesin y si desea
que los servidores se aadan de forma automtica a la tabla de servidores conocidos.
Procedimiento
1. En PI System Explorer, seleccione Herramientas > Opciones > Opciones de servidor.
2. Defina los Ajustes de servidor AF:
Ajuste Descripcin
Preferencia de conexin al Esta preferencia se utiliza para influir en la seleccin de un
servidor AF miembro colectivo cuando se realiza una conexin a un colectivo
de AF.
Preferir primario
PI System Explorer intentar conectarse con el servidor
principal del colectivo y, si no est disponible, utilizar los
ajustes de prioridad del miembro colectivo para influir en la
seleccin de la conexin del servidor. Este es el ajuste
predeterminado.
Requerir primario
Es obligatorio conectar PI System Explorer con el servidor
principal del colectivo. Si el servidor principal no est
disponible, la conexin falla.
Cualquiera
PI System Explorer se puede conectar con cualquier
miembro disponible del colectivo y utilizar los ajustes de
prioridad individuales del miembro colectivo para influir en
la seleccin de la conexin del servidor.
Permitir solicitud de inicio de Seleccione esta opcin si desea que se muestre una solicitud de
sesin en el servidor AF inicio de sesin cuando falle una conexin con el servidor debido a
una excepcin de seguridad.
Aadir automticamente Seleccione esta opcin para aadir de forma automtica un
servidores AF servidor a la tabla de servidores conocidos.
Cuando PI System Explorer intenta conectarse con un servidor en
un colectivo que no est en la tabla de servidores conocidos, si el
nombre del equipo es vlido y PI System Explorer encuentra el
nombre de equipo del servidor en la red, el servidor se aadir de
forma automtica a la tabla de servidores conocidos.
3. Defina los Ajustes de PI Server:

Ajuste Descripcin
Preferencia de conexin a PI Esta preferencia se utiliza para influir en la seleccin de un
Server miembro colectivo cuando se realiza una conexin a un colectivo
de PI Server.
Preferir primario
PI System Explorer intentar conectarse con el servidor
principal del colectivo y, si no est disponible, utilizar los
ajustes de prioridad del miembro colectivo para influir en la
seleccin de la conexin del servidor. Este es el ajuste
predeterminado.
Requerir primario
Es obligatorio conectar PI System Explorer con el servidor
principal del colectivo. Si el servidor principal no est
disponible, la conexin falla.
Cualquiera
PI System Explorer se puede conectar con cualquier
miembro disponible del colectivo y utilizar los ajustes de
prioridad individuales del miembro colectivo para influir en
la seleccin de la conexin del servidor.
Permitir solicitud de inicio de Seleccione esta opcin si desea que se muestre una solicitud de
sesin en el PI Server inicio de sesin cuando falle una conexin con el servidor debido a
una excepcin de seguridad.
Aadir automticamente Seleccione esta opcin para aadir de forma automtica un
servidores AF servidor a la tabla de servidores conocidos.
Cuando PI System Explorer intenta conectarse con un servidor en
un colectivo que no est en la tabla de servidores conocidos, si el
nombre del equipo es vlido y PI System Explorer encuentra el
nombre de equipo del servidor en la red, el servidor se aadir de
forma automtica a la tabla de servidores conocidos.
Conexin a servidores de PI AF
En esta seccin
Conexin a un servidor de PI AF
Aadir un servidor de PI AF a la lista de conexiones
Cambiar miembros colectivos
Cambiar a un miembro colectivo concreto
Conexin a un servidor de PI AF
Procedimiento
1. En PI System Explorer, seleccione Archivo > Conexiones.
Se abrir la ventana Servidores, con una lista de todos los PI Servers servidores de PI AF
para los que se ha configurado una conexin. Los servidores conectados actualmente
se indicarn con un crculo de color verde.

Los PI Server de las versiones 3.4.375 y 3.4.370 se indican con un tringulo de color
amarillo y un aviso de que est conectado a un servidor no admitido. No se admiten las
conexiones a servidores anteriores a la versin 3.4.370.
2. Para conectarse a un servidor de PI AF diferente, pulse con el botn secundario sobre el
nombre del servidor y seleccione Conectar.
Nota:
Si no se muestra el servidor que necesita, podr aadirlo como se describe en Aadir
un servidor de PI AF a la lista de conexiones.
Puede hacer clic en Renombrar en cualquier servidor de AF conectado para asignarle
otro nombre. Sin embargo, tenga en cuenta que el cambio de nombre del servidor
afectar a todos los clientes. El campo Nombre no tiene que coincidir con Descripcin.
En esta seccin
Ver recuentos de objetos del servidor de PI AF
Ver el ID del servidor de AF, el puerto y otras propiedades
Ver recuentos de objetos del servidor de PI AF

Podr consultar los recuentos de objetos del servidor de PI AF a los que est conectado, como
el nmero de bases de datos, elementos, plantillas de elementos, marcos de evento, etc.
Procedimiento
1. En PI System Explorer, seleccione Archivo > Propiedades de servidor AF.
Se abrir la ventana Propiedades de servidor AF.
2. Seleccione la pestaa Recuentos.
Ver el ID del servidor de AF, el puerto y otras propiedades

Podr ver informacin sobre el servidor de PI AF al que est conectado en ese momento, como:
Nombre del servidor de AF, nombre de host e ID
Cuenta del servidor de AF
Nmero de versin del servidor de AF
Puerto del servidor de AF, tiempo de espera y alias
Procedimiento
1. En PI System Explorer, seleccione Archivo > Propiedades de servidor AF.
Se abrir el cuadro de dilogo Propiedades de servidor AF.
2. Haga clic en la pestaa General.
Nota:
La pestaa General incluye tambin el botn Configurar Active Directory. Consulte
Configuracin de acceso a Active Directory para los contactos para obtener ms
informacin.
Aadir un servidor de PI AF a la lista de conexiones

Procedimiento
1. En PI System Explorer, haga clic en Archivo > Conexiones.
Se abrir la ventana Servidores. En esta ventana aparece cualquier PI Server o servidor
de PI AF para el que se ha configurado una conexin.
Los servidores conectados en ese momento se indicarn con un crculo de color verde. El PI
Server y el servidor de PI AF predeterminados se indicarn con una marca de verificacin
Los PI Server de las versiones 3.4.375 y 3.4.370 se indican con un tringulo de color
amarillo y un aviso de que est conectado a un servidor no admitido. No se admiten las
conexiones a servidores anteriores a la versin 3.4.370.
2. Haga clic en Aadir servidor AF.
3. Especifique las propiedades del servidor de PI AF.
No es necesario que el Nombre coincida con el nombre de host. Una vez conectado a un
servidor de PI AF, podr cambiarle el Nombre haciendo clic en Renombrar para
introducir otro nombre.
Warning:
El cambio de nombre del servidor de AF afectar a todos los clientes
El nombre del Host puede ser el nombre de dominio completo, el nombre del servidor o
la direccin IP. Las direcciones IPv6 deben incluirse entre parntesis [ ].
Deje el campo Cuenta en blanco.
El valor predeterminado de Tiempo lmite de 300 segundos es vlido en la mayora de los
casos. Si experimenta errores de tiempo de espera excedido cuando trabaje con PI
System Explorer, incremente el valor del campo Tiempo lmite.
(Opcional) Los Alias son nombres alternativos que se pueden utilizar con el servidor de
PI AF cuando los usuarios busquen este servidor. Los alias del servidor de PI AF se
almacenan solo localmente en el cliente cuando se configuran.
(Opcional) El enlace Configurar Active Directory sirve para configurar la lista de
contactos de PI Notifications. Es una funcin del administrador del sistema de PI AF.
Nota:
Si aparece un mensaje de error indicando que no puede conectarse al servidor de PI
AF, tendr que rellenar el campo Cuenta.
En esta seccin
Rellenar el campo Cuenta
Configuracin de acceso a Active Directory para los contactos
Configuracin de la seguridad de un servidor de AF
Rellenar el campo Cuenta

Cuando se aade una nueva conexin de servidor de PI AF a PI System Explorer, el campo
Cuenta se deja en blanco. Si, al hacer clic en conectar, aparece un mensaje de error indicando
que no se puede conectar con al servidor de PI AF, uno de los motivos podra ser que es
necesario introducir un valor en el campo Cuenta. Si sabe que el servicio de aplicaciones de PI
AF se ejecuta en una cuenta de dominio concreta, tendr que rellenar el campo Cuenta.

1. Escriba el nombre de la cuenta con la que se ejecuta el servicio de aplicaciones de PI AF. Por
ejemplo:
company.net\afcollective
Nota:
Solo podr modificar la cuenta cuando no est conectado al servidor.
2. Si sigue sin poder conectase, consulte los temas sobre resolucin de problemas en la gua de
instalacin y actualizacin de PI AF.
Configuracin de acceso a Active Directory para los contactos

Cuando utilice PI Notifications con el servidor de PI AF, es posible que necesite especificar
cmo se debe acceder a Active Directory de Microsoft para obtener nombres de contacto para
las listas de contactos de PI Notifications.
Todas las opciones del servidor de PI AF ofrecen la posibilidad de especificar el dominio y la
subcarpeta de contactos, as como la cuenta necesaria para acceder a Active Directory y
obtener nombres de contacto. La cuenta con la que se ejecuta el servicio de aplicacin del
servidor de PI AF se utiliza, de forma predeterminada, para acceder a Active Directory. Para
utilizar otra cuenta o acceder a Active Directory en otro dominio configure el acceso en la
ventana Configurar acceso a Active Directory para los contactos.
Procedimiento
1. Abra PI System Explorer y conctese a una base de datos que pertenezca al servidor de PI
AF para el que desea configurar el acceso a Active Directory.
2. En el men Archivo, seleccione Propiedades de servidor AF y en esa ventana haga clic en el
vnculo Configurar acceso a Active Directory para los contactos.
3. En el cuadro de texto Nombre de dominio de Active Directory, introduzca el nombre DNS
completo del dominio de Active Directory del que se obtendrn los nombres para los
contactos de PI Notifications (por ejemplo,contoso.com).
Si se deja en blanco este campo, se utilizar el dominio en el que resida el servicio de
aplicacin de PI AF.
4. En el cuadro de texto Subcarpeta de contactos de Active Directory, introduzca la ruta a la
carpeta que contiene la lista de contactos de este dominio.
En los dominios de Active Directory ms extensos, los contactos se pueden organizar en
subcarpetas. El uso de subcarpetas puede agilizar la obtencin de una lista de contactos de
Active Directory.
Utilice esta estructura con la subcarpeta:
DomainUserFolder/SubDomainUserFolder/Sub SubDomainUserFolder
5. Seleccione una opcin en Cuenta de acceso a Active Directory:
Utilizar la cuenta con la que se ejecuta el servidor de AF como
Esta es la opcin por defecto. Seleccione esta opcin para acceder a Active Directory con
la cuenta con la que se ejecuta el servicio de aplicacin de PI AF. El servidor de PI AF se
instala, de forma predeterminada, con la cuenta de Servicio de red. No obstante, la cuenta
de servicio del servidor de PI AF se puede cambiar. Si la cuenta de servicio del servidor
de PI AF no tiene permiso de lectura de Active Directory, no obtendr ningn nombre de
contacto para la lista de contactos. Si la seguridad de Active Directory se ha configurado
para que la cuenta de servicio del servidor de PI AF tenga permiso de lectura de Active
Directory, esta es la opcin ms simple.
Utilizar la cuenta con la que se ejecuta el cliente de AF como

Seleccione esta opcin para utilizar las credenciales de la cuenta de usuario con la que se
ejecuta la aplicacin cliente que se conecta. Si el servicio de servidor de PI AF se ejecuta
con una cuenta (la de Servicio de red es la cuenta predeterminada) que no tiene permiso
de lectura de Active Directory, se puede utilizar esta opcin. Cuando la cuenta de usuario
con la que se ejecuta la aplicacin cliente que se conecta tenga permiso de lectura de
Active Directorio, se devolver una lista de nombres de contacto a la lista Contactos. El
contenido de la lista Contactos puede variar en funcin de la cuenta de acceso utilizada,
puesto que la seguridad relativa a la lectura de la lista de contactos viene determinada
por Active Directory.
Nota:
Si se especifica esta opcin, es posible que sea necesario configurar Kerberos en el
supuesto de que una aplicacin de AF SDK utilice la suplantacin en un nivel
intermedio, como un servicio web.
Utilizar la cuenta especificada
Esta opcin permite especificar una cuenta para leer el Active Directory. Puede resultar
til cuando el servidor de Active Directory y PI AF estn en dominios distintos o cuando
las cuentas de las dos primeras opciones no tienen permiso de lectura de Active
Directory. En Nombre de cuenta, utilice el formato Domain\User. Compruebe que la
cuenta especificada tenga el permiso adecuado para leer el Active Directory de destino.
6. Seleccione Utilizar catlogo global almacenado en cach local de Active Directory para
utilizar el catlogo global en las bsquedas del controlador de dominio de Active Directory.
En caso contrario, las bsquedas deben destinarse al controlador de dominio propietario.
Active Directory almacena la informacin en un repositorio de datos distribuido
denominado catlogo global. En el caso de las instalaciones en las que hay varios
controladores de dominio distribuidos, cada controlador de dominio tiene almacenadas en
cach de las partes del catlogo global de las que es responsable para que no sea necesario
hacer referencia a las bsquedas de Active Directory en el controlador de dominio. Esto
mejora el rendimiento de las consultas que, de otra forma, tendran que acceder a un
controlador de dominio remoto.
7. Seleccione un valor para el campo Devolver todas las personas.
Los objetos de Active Directory se derivan unos de otros del siguiente modo:
Top>Persons>OrganizationalPerson>Contact
y
Top>Persons>OrganizationalPerson>User
Seleccione esta casilla para devolver personas, personas de organizaciones, contactos y

usuarios desde el Active Directory de destino.
Anule la seleccin de esta casilla para devolver solo usuarios.
Configuracin de la seguridad de un servidor de AF

Puede configurar la seguridad de un servidor de AF que est conectado en ese momento. Para
ello, asigne a los usuarios y grupos permisos de acceso a las reas u objetos del servidor.
Procedimiento
1. Seleccione Archivo > Conexiones. La ventana Servidor muestra los PI Servers y servidores
de AF disponibles; el punto de color verde en el icono de un servidor indica que est
conectado en ese momento.
2. Haga clic con el botn secundario en un servidor de AF conectado y seleccione Seguridad.
En el men en cascada, seleccione el rea o los objetos para los que desea configurar los
permisos. (Observe que en las listas Bases de datos se muestran varias opciones

adicionales.) Se abrir una ventana de permisos donde puede configurar permisos de grupo
o de usuario.
Cambiar miembros colectivos

Cuando se conecta a un colectivo de PI AF, PI AF le conecta de forma automtica al miembro
colectivo con la prioridad ms alta (nmero ms bajo). Este procedimiento cambia la conexin
al siguiente miembro de la lista de colectivos. El siguiente miembro de la lista est determinado
por la priorirdad asignada a los miembros.
Procedimiento
1. En PI System Explorer, seleccione Archivo > Conexiones.
2. Pulse con el botn secundario sobre el colectivo y seleccione Cambiar miembro colectivo.
Cambiar a un miembro colectivo concreto

Al conectarse a un colectivo de Asset Framework, lo har tambin de forma automtica al
miembro colectivo con la prioridad ms alta (nmero ms bajo). Puede cambiar a un miembro
concreto del colectivo.
Procedimiento
1. En PI System Explorer, seleccione Conexiones.
2. Pulse con el botn secundario sobre el colectivo y seleccione Conectar con miembro
colectivo. Aparecer el cuadro de dilogo Seleccionar miembro del colectivo.
3. En la lista Miembro colectivo, seleccione el miembro colectivo con el que desea conectar.
4. Haga clic en Aceptar. Ahora estar conectado con el miembro colectivo seleccionado.
Conexin a PI Servers
En esta seccin
Conexin a un PI Server
Aadir un PI Server a la lista de conexiones
Ver el estado de bfer de un PI Server
Conexin a un PI Server
Procedimiento
1. Haga clic en Archivo > Conexiones.
Se mostrar el cuadro de dilogo Servidores. El cuadro de dilogo muestra una lista de todos
los PI Servers y servidores de PI AF para los que se ha configurado una conexin. Los PI
Servers y servidores de PI AF conectados en ese momento se indican mediante un crculo de
color verde. Los PI Servers que ejecutan versiones anteriores a la 3.4.370 no son
compatibles y se marcan con un tringulo de color amarillo. Aunque es posible conectarse a
las versiones anteriores del PI Server, tal vez no puedan utilizarse todas las funciones.
2. Para conectarse a un PI server diferente, pulse con el botn secundario sobre el nombre del
servidor y seleccione Conectar. Si no se muestra el servidor que necesita, podr aadirlo
como se describe en Aadir un PI Server a la lista de conexiones.

En esta seccin
Problemas de conexin con PI Server
Configuracin de clientes para permitir solicitudes de inicio de sesin explcitas
Problemas de conexin con PI Server

La autenticacin de Windows solo utiliza mapeos de identidad y no emplea los trusts de
autenticacin definidos con credenciales de Windows ni ningn otro tipo de trust que se
configure. Al conectarse a un PI Server, es posible que aparezcan mensajes de error si no se ha
configurado ningn mapeo de PI y existe alguna de estas condiciones:
Utiliza un nombre de usuario y contrasea de PI para iniciar sesin en el PI Server.
Utiliza el nombre de usuario con una contrasea en blanco para iniciar sesin en el PI
Server.
Estos errores se producen porque en PI AF 2012 y versiones posteriores, los ajustes de
seguridad son ms estrictos que en las versiones anteriores. Los clientes que se conectan con
los PI Servers a travs 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
sesin explcito excepto si se ha configurado la opcin Permitir solicitud de inicio de sesin.
Este ajuste controla lo que sucede cuando falla la autenticacin en PI Server. Si se ha
marcado la opcin Permitir solicitud de inicio de sesin, se mostrar un cuadro de dilogo
solicitando al usuario que proporcione un nombre de usuario y una contrasea. Si no se ha
marcado esta opcin, se mostrar un mensaje de error. Este ajuste es especfico de cada
equipo cliente.
Ya no existe compatibilidad con las conexiones de usuario predeterminadas.
Para resolver las condiciones que producen errores, configure asignaciones de PI para los
usuarios que vayan a conectarse a PI Server. Consulte la gua del usuario PI Server Security para
obtener instrucciones.
Mensajes de error de conexin con PI Server

Mensaje de error Condiciones del error de conexin
No tiene privilegios suficientes para acceder al PI Las conexiones de usuario predeterminadas se han
Server. activado en PISDK.
Sin acceso: objeto seguro
Las conexiones de usuario predeterminadas al PI
Server estn activadas actualmente para este
cliente, pero han dejado de ser compatibles con PI
AF.
No tiene privilegios suficientes para acceder al PI Las conexiones de usuario predeterminadas son el
Server. No hay activado ningn mtodo de nico mtodo de autenticacin activado en PISDK.
autentificacin compatible.
Las conexiones de usuario predeterminadas al PI
Server estn activadas actualmente para este
cliente, pero han dejado de ser compatibles con PI
AF.

Mensaje de error Condiciones del error de conexin

No tiene privilegios suficientes para acceder al PI La opcin de inicio de sesin explcito no se ha
Server. configurado en el registro.
La solicitud explcita de inicio de sesin no est
configurada en este ordenador y por lo tanto no
est permitida.
Configuracin de clientes para permitir solicitudes de inicio de sesin

explcitas
Procedimiento
1. Abra PISDKUtility desde el men Inicio de Windows.
2. Seleccione Conexiones > Opciones.
Se mostrar la ventana Opciones de conexin.
3. Seleccione la casilla de verificacin Solicitar inicio de sesin (si fallan protocolos
configurados).
Aadir un PI Server a la lista de conexiones

Procedimiento
1. Abra PI System Explorer y seleccione Archivo > Conexiones.
Se mostrar el cuadro de dilogo Servidores. El cuadro de dilogo muestra una lista de todos
los PI Servers y servidores de PI AF para los que se ha configurado una conexin. Los
servidores conectados en ese momento se indican con un crculo de color verde. Los PI
Servers y servidores de PI AF predeterminados se indican con una marca de verificacin.
(Los PI Servers de la versin 3.4.370 y anteriores se indican con un tringulo amarillo en
lugar del crculo de color verde. Puede conectarse a estas versiones anteriores del servidor,
pero tal vez no pueda utilizar todas las funciones.)
2. Haga clic en Aadir PI Server.
Aparecer el cuadro de dilogo Propiedades de PI Server.
3. (Opcional) Para cambiar el nombre en el campo Nombre, haga clic en Renombrar,
introduzca otro nombre y haga clic en Aceptar. No es necesario que este nombre coincida
con el nombre de host.
4. Introduzca el nombre de host en el campo Host. El nombre de host puede ser el nombre de
dominio completo, el nombre del servidor o la direccin IP.
5. Salvo que su aplicacin concreta necesite otro puerto, acepte los valores predeterminados
en el campo Puerto.
Nota:
Para modificar el nombre de host y el puerto, debe estar desconectado del servidor.
6. Los valores predeterminados de los campos Tiempo de espera de conexin y Tiempo de
esperade datos son vlidos en la mayora de los casos. Si experimenta excesos de tiempo de
espera de conexin al conectar al PI Server desde PI System Explorer, aumente el tiempo en
el campo Tiempo de esperade conexin. Si experimenta errores de excesos de tiempo de

espera al acceder a los datos del PI Server, incremente el tiempo en el campo Tiempo de
espera de datos.
7. (Opcional) Puede introducir un alias en el campo Alias.
Los alias son nombres alternativos que se pueden utilizar con el PI Server. Los alias de PI
Server se almacenan solo de forma local en el cliente cuando se configuran.
8. Haga clic en Conectar para conectarse al PI Server.
Nota:
Los campos ID, Zona horaria y Versin no se pueden editar.IDes el ID del PI Server,
Zona horaria es la zona horaria local del PI Server y Versin es la versin del PI Server.
Ver el estado de bfer de un PI Server

Antes de empezar
Se necesita PI Buffer Subsystem 4.3 o posterior para ver el estado de bfer, as como para
utilizar Buffering Manager.
PI Buffer Subsystem debe estar en ejecucin para poder iniciar Buffering Manager.
Procedimiento
1. Haga clic en Archivo > Conexiones.
Se abrir la ventana Servidores con una lista de todos los PI Servers y servidores de PI AF
para los que se ha configurado una conexin. Estado del bfer indica el estado del bfer de
cada PI Server.
Nota:
Las versiones 3.4.380 y anteriores de PI Buffer Subsystem muestran el estado
Desconocido.
2. Para ver ms detalles y gestionar el almacenamiento en bfer de un PI Server, haga clic en
Buffering Manager para abrir la herramienta Buffering Manager.
Nota:
Tambin puede abrir Buffering Manager desde el men Herramientas de PI System
Explorer.
Para obtener ms informacin sobre Buffering Manager, consulte la ayuda correspondiente.
Conexin a bases de datos de PI AF

En esta seccin
Bases de datos de PI AF
Crear una base de datos
Ver o editar las propiedades de una base de datos
Configurar la base de datos predeterminada
Renombrar una base de datos
Buscar una base de datos

Actualizar la lista de bases de datos

Acerca de la eliminacin de bases de datos
Configurar permisos de seguridad para una base de datos
Configurar permisos de seguridad para todas las bases de datos
PI AF almacena objetos de Asset Framework (elementos, plantillas, etc.) en bases de datos de
PI AF. Aunque puede tener varias bases de datos de PI AF en PI AF, solo podr conectarse a una
de ellas al mismo tiempo. Por lo general, trabaje con bases de datos de PI AF en PI System
Explorer o en PI Builder. Al iniciar PI System Explorer, se conecta a la base de datos de PI AF
predeterminada. Si no se ha definido ninguna base de datos, PI System Explorer le solicitar
que cree una.
Nota:
Los clientes de PI AF utilizan la base de datos de configuracin para interactuar con PI AF.
No utilice esta base de datos con sus propios datos de aplicacin.
Crear una base de datos

Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Base de datos.
Aparecer la ventana Seleccionar base de datos.
2. Seleccione el servidor AF en el que desee crear la base de datos.
3. Pulse el botn Nueva base de datos.
Se mostrar la ventana Propiedades de base de datos.
4. Introduzca un nombre y una descripcin opcional.
5. Para cargar una biblioteca existente en la nueva base de datos, seleccinela en el men
Cargar biblioteca. Este men no aparece si no existe ninguna biblioteca. Para obtener ms
informacin, consulte Biblioteca guardada de PI AF.
Ver o editar las propiedades de una base de datos

Procedimiento
1. En PI System Explorer, pulse el botn Base de datos para abrir la ventana Seleccionar base
de datos.
2. Pulse con el botn secundario y seleccione Propiedades para acceder a la ventana
Propiedades de base de datos de la base de datos seleccionada.
3. Utilice las siguientes pestaas para consultar o modificar las propiedades disponibles:
General
Muestra el nombre, la descripcin, todas las bibliotecas existentes (consulte Guardar una
base de datos como biblioteca) y el servidor de AF.
Recuentos
Incluye los recuentos de los distintos tipos de objeto utilizados por la base de datos.

Configurar la base de datos predeterminada

La base de datos predeterminada se muestra al abrir PI System Explorer por primera vez. Tras
esta primera vez, al ejecutar PI System Explorer se mostrar la base de datos que estaba
abierta la ltima vez que cerr PSE.
Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Base de datos. Se
mostrar el cuadro de dilogo Seleccionar base de datos.
2. Haga clic con el botn secundario sobre una base de datos y seleccione Ajustar como base
de datos predeterminada.
Renombrar una base de datos

Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Base de datos. Aparecer
la ventana Seleccionar base de datos.
2. Pulse con el botn secundario sobre una base de datos y seleccione Renombrar.
Buscar una base de datos

Procedimiento
2. En el campo Bases de datos, comience a escribir el nombre de la base de datos.
El icono Buscar cambiar a Buscando . Los resultados se filtrarn segn el nmero de
letras que escriba.
3. Seleccione una base de datos en la lista y haga clic en Aceptar. La ventana se cerrar y podr
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
cerrar.
Actualizar la lista de bases de datos

Puede que otros usuarios aadan bases de datos al servidor y que las bases de datos aadidas
recientemente no se muestren.
Procedimiento
2. Pulse con el botn secundario sobre el recuadro Bases de datos y seleccione Actualizar.
Acerca de la eliminacin de bases de datos

Al eliminar una base de datos, se elimina tambin toda la informacin contenida en ella. La
operacin de eliminacin no se puede deshacer. Compruebe que ha seleccionado la base de

datos que desea eliminar. Recuerde que podr recuperar los datos si restaura la ltima copia
de seguridad de SQL Server.
Configurar permisos de seguridad para una base de datos

Procedimiento
2. Haga clic con el botn secundario sobre la base de datos y seleccione Seguridad > Base de
datos. Se mostrarn las propiedades de los permisos para la base de datos seleccionada.
3. Seleccione usuarios y configure permisos segn necesite. Para obtener ms informacin
sobre la configuracin de permisos, consulte Configurar permisos para objetos.
Configurar permisos de seguridad para todas las bases de datos

Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Base de datos.
Aparecer la ventana Seleccionar base de datos.
2. Haga clic en .
Se mostrarn las propiedades de los permisos para la base de datos seleccionada.
3. Seleccione usuarios y configure permisos segn necesite.
Para obtener ms informacin sobre la configuracin de permisos, consulte Configurar
permisos para objetos.


Localizar y consultar informacin de activos
En esta seccin
Exploracin de activos
Buscar activos y datos de activo
Crear una tendencia en PI System Explorer
Gestionar cambios de equipos y procesos
Ver datos de series temporales
Exploracin de activos
En esta seccin
Elementos mostrados por el navegador
Exploracin de elementos
Exploracin de otros objetos
Configurar el tamao de la pgina del navegador
Abrir ventanas adicionales del navegador
Elementos mostrados por el navegador

El contenido del navegador de PI System Explorer depende del botn que se seleccione en el
panel del navegador. Los objetos disponibles predeterminados del panel del navegador son
elementos, marcos de evento, objetos de biblioteca y unidades de medida.
El panel del navegador puede contener otros tipos de objeto si se instalan otros productos de
PI. Por ejemplo, si se instala PI Notifications, los siguientes objetos aparecern tambin en el
panel del navegador: Notificaciones, Contactos y MyPI.
Exploracin de elementos
Los elementos se muestran en el navegador en forma de rbol. La estructura del rbol de
elementos vara segn cada organizacin. El diseador de modelos de activos elige la
estructura ms pertinente para los usuarios de la organizacin. En la imagen que figura a
continuacin, los elementos estn organizados por ubicacin de planta. Si es el responsable de
todos los equipos de una determinada planta, este modelo puede resultarle til. Para alguien
que tenga otra funcin, sera ms til otro modelo.

El rbol de elementos puede incluir otros subrboles que ofrecen un contexto diferente para
los mismos activos. Esto permite a los usuarios localizar elementos en el contexto que les
resulte ms til para la tarea que tienen entre manos. Por ejemplo, adems de la organizacin
por ubicacin de planta que se muestra ms arriba, puede tener tambin una organizacin por
fabricante de equipos, como se muestra en la siguiente imagen.
Los elementos que representan las bombas aparecen en las jerarquas Manufacturers
(Fabricantes) y Plant Location (Ubicacin de planta). En la jerarqua Manufacturer, los
elementos de bomba no son elementos nuevos independientes, sino que son referencias a los
elementos que ya existan en el rbol de Plant Location. Para indicar que son referencias de
elementos, se representan mediante el icono del elemento referenciado .
Exploracin de otros objetos

Puede explorar objetos que no sean elementos. Haga clic en el botn correspondiente del panel
del navegador para ver objetos con el tipo:
Unidades de medida (UOMs): Al pulsar el botn Unidad de medida del panel del navegador,
todas las clases de unidades de medida aparecern en el navegador. Al seleccionar una
clase, las unidades de medida que pertenecen a ella aparecern en el visor.
Objetos de biblioteca: Al pulsar el botn Biblioteca del panel del navegador, las siguientes
colecciones de objetos en el navegador: categoras, plantillas, conjuntos de enumeracin,
tipos de referencia y tablas. Para ver todos los objetos de un determinado tipo, expanda la
coleccin de ese tipo.
Marcos de evento y transferencias: Dado que los modelos de activos pueden tener miles de
marcos de evento o transferencias, estos objetos no se muestran en una jerarqua del
navegador. En su lugar, cada uno de ellos tiene una coleccin de bsquedas. Pulse con el
botn secundario sobre la coleccin de bsquedas para iniciar una bsqueda nueva. Las
bsquedas recientes se incluyen en la coleccin de bsquedas.

Configurar el tamao de la pgina del navegador

El panel de PI System Explorer Browser est paginado. Esto significa que muestra varios
objetos al mismo tiempo. Si existen ms objetos, PI System Explorer los muestra en otra pgina.
En este caso, los controles Siguiente y Anterior se muestran en el navegador.
El nmero mximo de objetos que pueden mostrarse en el navegador es, de forma
predeterminada, 1000. Puede modificar ese nmero si lo desea.
Procedimiento
1. En PI System Explorer, seleccione Herramientas > Opciones.
2. En el campo Tamao mximo de pgina de rama de rbol, introduzca el nmero mximo de
objetos que se pueden mostrar en el navegador.
Abrir ventanas adicionales del navegador
Procedimiento
1. Pulse con el botn secundario sobre cualquier elemento del panel del navegador.
2. En el men que aparece, seleccione Abrir en nueva ventana.
Buscar activos y datos de activo

PI System Explorer ofrece distintas opciones para buscar activos, datos de activos y PI points.
Encontrar datos para un determinado equipo. Por ejemplo: Datos de PI points, resultados de
clculos, informacin de mantenimiento, etc. Por ejemplo, puede utilizar PI System Explorer
para encontrar informacin sobre un determinado tanque en una planta concreta.
Encontrar un equipo completo con determinados valores de atributo o rangos de valores.
Por ejemplo, obtener una lista de todos los tanques con una temperatura superior a los 200
F.
En esta seccin
Bsqueda rpida
Paginacin de resultados de bsqueda
Bsqueda en una fecha concreta

Bsqueda de PI points
Buscar elementos
Bsqueda de atributos en elementos
Buscar marcos de evento
Buscar atributos en marcos de evento
Buscar una transferencia
Bsqueda de atributos en transferencias
Bsqueda rpida
Puede utilizar el cuadro de bsqueda rpida en el extremo derecho de la barra de herramientas
de PI System Explorer para buscar elementos, marcos de evento, plantillas de elementos o
tipos de unidades de medida.
Procedimiento
1. Realice una seleccin en el panel del navegador para establecer el contexto de la bsqueda
rpida. Por ejemplo, seleccione Marcos de evento en el panel del navegador para definir la
bsqueda rpida para los marcos de evento.
2. En el cuadro de bsqueda rpida, seleccione un lmite de bsqueda en Acciones ,
introduzca criterios de bsqueda y pulse la tecla Intro. Los resultados de bsqueda
aparecern en el visor y en el navegador.
Nota:
Los resultados de bsqueda que aparecen en el navegador permanecern all para que
pueda acceder fcilmente a ellos en caso de que los necesite. Puede hacer clic con el
botn secundario y eliminarlos del navegador; tambin se eliminarn al salir de PI
System Explorer. Puede hacer clic con el botn secundario y gurdelos para
conservarlos hasta que los elimine.
Paginacin de resultados de bsqueda

Cuando busque un nmero considerable de elementos o marcos de evento, puede utilizar la
opcin Ajustar tamao mximo de consulta para devolver resultados de bsquedas rpidas en
fragmentos ms manejables. Esto se conoce como paginacin. Cambie el valor de Ajustar
tamao mximo de consulta al nmero de objetos que desea buscar y valos todos a la vez en
los resultados de la bsqueda. Si la bsqueda devuelve un nmero de objetos mayor que el
especificado por el valor de Ajustar tamao mximo de consulta, los resultados se paginarn.
Tenga en cuenta que:
Solo se paginarn los resultados de bsqueda para elementos, transferencias y marcos de

evento.
La opcin Ajustar tamao mximo de consulta solo se aplica a las bsquedas rpidas de
elementos, transferencias o marcos de evento. Si busca otros objetos, la bsqueda no tendr
en cuenta el valor indicado en Ajustar tamao mximo de consulta.
Si realiza una bsqueda avanzada, el valor de Recuento mximo del cuadro de dilogo
Bsqueda de elemento sustituir al valor del campo Ajustar tamao mximo de consulta.
Por ejemplo, si el valor de Ajustar tamao mximo de consulta es 100.000 el servidor de SQL
intenta encontrar 100.000 objetos coincidentes antes de devolver los resultados. Es probable
que no desee esperar a que el servidor de SQL encuentre tantas coincidencias y que desee

verlas en una nica pgina de resultados de bsqueda. Si cambia el valor de Ajustar tamao
mximo de consulta a 100, el servidor de SQL enviar los resultados despus de encontrar 100
coincidencias y podr ver los 100 objetos a la vez en los resultados de bsqueda.
Definir el tamao mximo de la consulta

Utilice uno de estos dos mtodos:
Defina la opcin Tamao mximo de consulta en la barra de herramientas (Herramientas >

Opciones). De esta forma, se configurar el valor predeterminado de PI System Explorer.
Introduzca un valor en el campo Cont. mx. en una ventana de bsqueda. De esta forma, se
establecer el tamao mximo de la consulta para la bsqueda avanzada. El valor del campo
Cont. mx. sustituye al valor del campo Tamao mximo de consulta.
Bsqueda en una fecha concreta

Para realizar una bsqueda en PI System Explorer en una fecha y hora concretas, introdzcalas
en el campo Fecha de consulta. PI System Explorer mostrar tambin las versiones del objeto
para esa fecha. Consulte Fecha de consulta y tiempo en PI System Explorer para obtener ms
informacin sobre los objetos a los que afecta la Fecha de consulta.
Adems, podr 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 est. Para ello, configure el
campo Establecer contexto temporal. Vase Establecer el contexto temporal de los valores de
atributo mostrados.
Bsqueda de PI points
Compruebe que Elementos est seleccionado en el panel del navegador.
Procedimiento
1. En la barra de mens de PI System Explorer, seleccione Editar > Bsqueda de tags.
(Tambin puede elegir Ver > Paleta > Bsqueda de tags para ejecutar bsquedas de tags en
la Paleta.)
Se abrir la ventana Bsqueda de tags.
2. Seleccione los PI Servers en los que desea realizar bsquedas. Puede seleccionar varios en la
lista desplegable o hacer clic en el botn Examinar para localizar y aadir ms PI Servers.
3. Comience por escribir una cadena de bsqueda en el cuadro de texto de bsqueda situado
junto al botn Buscar.
De forma predeterminada, PI AF buscar los nombres de punto que comiencen con su
cadena de bsqueda.
Para buscar nombres que finalicen, incluyan o coincidan exactamente con la cadena de
bsqueda, haga clic en y seleccione la opcin correspondiente.
Para buscar en funcin de la descripcin del punto adems del nombre, haga clic en y
seleccione Incluir descripcin en la bsqueda.
Para buscar en funcin de determinados atributos de punto, haga clic en . Podr
buscar en funcin del nombre, del origen del punto, del tipo de datos y de la clase de
punto. (Haga clic en Aadir criterios para aadir unidades de ingeniera o una
descripcin.)

4. Haga clic en Buscar para ver los resultados de la bsqueda. Para seleccionar las columnas
que se mostrarn en los resultados de bsqueda, haga clic en el icono de seleccin de
columnas en la parte derecha de los encabezados de columna.
5. Haga clic en Aceptar para mostrar los resultados en los paneles del visor y el navegador.
Caracteres especiales en bsquedas de tags

En el campo Bsqueda de tags puede utilizar los siguientes caracteres especiales en la cadena
de bsqueda.
Nota:
Los resultados de los ejemplos que figuran a continuacin asumen que utiliza la opcin
de bsqueda predeterminada, que busca los nombres de los PI point que empiezan por su
cadena de bsqueda.
Carcter especial Descripcin Ejemplo

* Sustituye cualquier nmero de sin*
caracteres sin especificar.
Devuelve todos los PI points
cuyos nombres empiecen por sin;
por ejemplo, sinusoid y
sinusoidu.
? Sustituye un nico carcter sin CD?158

especificar.
cuyos nombres empiecen por CD,
seguido de cualquier carcter
nico, seguido de 158 (por
ejemplo, CD1158, CDA158, etc.).
: Cuando se realizan bsquedas de pointsource:R

todos los PI points con un valor
Devuelve todos los PI points que
de atributo concreto (distinto a
tengan R como pointsource.
nombre) separar el atributo y el
valor que est buscando. "ba:temp.1"ba\:temp.1
Consejo: Cualquiera de los dos ejemplos
Al buscar el nombre de un anteriores devuelve el PI point
PI point que incluya dos denominado ba:temp.1.
puntos, incluya el nombre
entre comillas dobles o
coloque una barra diagonal
inversa delante de los dos
puntos. (Consulte los
ejemplos.)
>, < o = Mayor que, menor que o igual al span:<=100

valor numrico especificado
Devuelve los PI points que tienen
un valor de atributo span inferior
o igual a 100.

Carcter especial Descripcin Ejemplo

'' Delimitadores de las cadenas de '*Owner Change*'
bsqueda que contienen espacios
o u
o caracteres especiales
"" "*Owner Change*"
Devuelve todos los PI points con
nombres que contengan Owner
Change.
"ba:temp.?"
cuyos nombres comiencen por
ba:temp. y terminen con
cualquier carcter simple.
Buscar elementos
Compruebe que Elementos est seleccionado en el panel del navegador.
Procedimiento
1. En el men principal de PI System Explorer, seleccione Editar > Bsqueda de elemento.
Aparecer la ventana Bsqueda de elemento.
2. Configure la ventana Bsqueda de elementos para localizar el elemento o elementos
deseados en la base de datos de PI AF:
a. En la lista Acciones , seleccione el tipo de filtro para aplicar: Contiene, Coincidencia
exacta, Empieza por o Termina en.
b. En Criterios, defina los campos para limitar los elementos recuperados:
Nombre
Introduzca el nombre del elemento para recuperar, en funcin del tipo de filtro. Puede
introducir caracteres especiales para buscar coincidencias de una parte de un
nombre. Consulte Caracteres especiales en bsquedas de nombres.
Plantilla
Seleccione la plantilla en la que deben basarse los elementos obtenidos. Despus de
seleccionar una plantilla, puede aadir criterios para buscar elementos por valor de
atributo.
Categora
Seleccione la categora con la que deben coincidir los elementos obtenidos.
Valor de atributo
Disponible si especifica una plantilla. Especifique una condicin de atributo-valor: un
nombre de atributo, un operador y un valor de atributo; por ejemplo, Temperature
>= 98. Para recuperar ms detalles, consulte Configurar una condicin de valor-
atributo.
c. Si lo desea, haga clic en Aadir Criterios y seleccione campos adicionales para insertar en
la ventana; a continuacin, configure estos campos para limitar los elementos
recuperados:

Valor de atributo
Disponible si especifica una plantilla. Puede especificar un mximo de tres
condiciones de atributo-valor. Para cada condicin, especifique un nombre de
atributo, un operador y un valor de atributo; por ejemplo, Temperature >= 98.
Tipo de elemento
Seleccione el tipo con el que deben coincidir los elementos obtenidos.
Raz de bsqueda de elementos

Introduzca el elemento que desea utilizar como raz o nivel base de la bsqueda de
elementos. Escriba el nombre exacto o haga clic en Explorar para abrir la ventana
Navegador de elementos, donde podr consultar la jerarqua de elementos y
seleccionar un elemento. No puede incluir caracteres comodn en el nombre que
introduzca. Si no especifica un elemento, establezca el nivel principal de la jerarqua
de elementos como la raz. En funcin de su jerarqua de PI AF, la especificacin de un
elemento en el campo Raz de bsqueda de elementos puede mejorar el rendimiento
de las bsquedas.
Todos los descendientes

Seleccione Verdadero para recuperar cualquier subelemento de la jerarqua que
coincida con los criterios especificados. Seleccione Falso para recuperar slo los
elementos de nivel raz que coincidan con los criterios especificados.
Resultados por pgina

Introduzca el nmero mximo de elementos para mostrar en una sola pgina de los
resultados de bsqueda.
Si especifica valores para varios ajustes, la bsqueda devolver slo aquellos elementos que
coincidan con los ajustes especificados.
3. Haga clic en Buscar para encontrar resultados y mostrarlos. Puede seleccionar qu
columnas desea mostrar. Para ello, haga clic en el icono de seleccin de columnas en la parte
derecha de los encabezados de columna.
4. Seleccione los resultados que desee utilizar y haga clic en Aceptar. Los resultados de la
bsqueda de elementos seleccionada se mostrarn en el visor y el navegador.
En el navegador, pulse con el botn secundario para guardar o asignar otro nombre a los
resultados de bsqueda y conservarlos hasta que los elimine. Tambin puede hacer clic con
el botn secundario para eliminarlos o permitir que se eliminen al salir de PI System
Explorer.
En esta seccin
Configurar una condicin de valor-atributo
Utilice el campo Valor de atributo en una ventana de bsqueda para configurar una
condicin de valor-atributo.
Caracteres especiales en bsquedas de nombres de elemento
Configurar una condicin de valor-atributo

Puede restringir la bsqueda en funcin del valor de un atributo. Una vez especificada una
plantilla, utilice el campo Valor de atributo para configurar una condicin con la que debe
coincidir la bsqueda en relacin con un valor de atributo.

Procedimiento
1. Haga clic en Muestra la seleccin de atributos y seleccione un atributo.
El men agrupa atributos en las siguientes categoras:
Atributos indexados
Atributos indexados, incluidos los atributos de configuracin.
Atributos de configuracin
Los atributos de configuracin que no estn indexados.
Otros atributos
Los atributos que no son de configuracin que no estn indexados.
Nota:
La evaluacin de los atributos sin indexar puede tardar bastante tiempo,
especialmente si estn configurados con una referencia de datos.
El men no muestra atributos con los tipos Object o Array. No podr buscar estos
atributos.
2. Haga clic en el botn de operador y seleccione un operador matemtico.
En el caso de los tipos de valor de atributo Single y Double, las consultas no admiten el
operador In.
Con los tipos de valor de atributo String,Boolean e Int64, las consultas no admiten los
siguientes operadores:
< (menor que)
> (mayor que)
<= (menor que o igual a)
>= (menor que o igual a)
3. Escriba un valor.
Introduzca un valor en las unidades especificadas por la UOM predeterminada en la plantilla
de atributos.
En el caso de los atributos indexados que almacenan tipos de valor String, la bsqueda
slo utiliza los primeros 40 caracteres del valor introducido.
Caracteres especiales en bsquedas de nombres de elemento

Puede utilizar caracteres especiales en el campo Nombre es de una bsqueda de elementos:
Carcter especial Finalidad
* Sustituir cualquier nmero de caracteres sin
especificar.
. Sustituir un solo carcter sin especificar.
[xyz] Especificar un conjunto de caracteres (x, y o z) para
coincidir.
[!xyz] Especificar un conjunto de caracteres (x, y o z) para
impedir una coincidencia.


\ Ignorar el carcter especial siguiente e
interpretarlo como su carcter real.
Ejemplos de caracteres especiales

Caracteres * y .
Supongamos que tiene una serie de elementos denominados Element1,Element54 y
Element64.
Para recuperar estos tres elementos, escriba:
E*
Para recuperar Element54 y Element 64, escriba:
Element.4
Para recuperar solo Element1, escriba:
E*1
Carcter \
Para buscar un elemento denominado Element*A42, escriba:
Element\*A42
Para buscar un elemento denominado Element\A42, escriba:
Element\\A42
Caracteres []
Supongamos que tiene una serie de elementos denominados
ElementA,ElementB,ElementC,ElementD y ElementE.
Para recuperar ElementA yElementB, escriba:
Element[AB]
Tambin, para recuperar ElementA yElementB, puede escribir:
Element[!CDE]
Bsqueda de atributos en elementos

Puede buscar un atributo o un grupo de atributos. Tal vez desee localizar un determinado
atributo, por ejemplo, para configurar una referencia de datos de frmula o asignarlo como
valor a otro atributo. (Para buscar un valor de atributo determinado, seleccione una plantilla y
un valor de atributo como criterios de bsqueda de elementos.)
Procedimiento
1. En el panel del navegador, haga clic en el botn Elementos. De esta forma, se establecer el
contexto correcto para el men Buscar. Para buscar atributos de marco de evento o de
transferencia, tendra que hacer clic en el botn Marcos de evento.
2. Pulse Editar > Bsqueda de atributos.
Se abrir la ventana Bsqueda de atributos.
3. Configure la ventana Bsqueda de atributos para localizar los atributos deseados en la base
de datos de PI AF:
a. En Donde, defina los campos para limitar los atributos recuperados:

Nombre de atributo
Introduzca el nombre del atributo que desea recuperar. Puede introducir caracteres
especiales para buscar coincidencias de una parte de un nombre. Vase Caracteres
especiales en bsquedas de nombres.
Categora de atributo
Seleccione la categora con la que deben coincidir los atributos recuperados.
Tipo de valor de atributo

Seleccione el tipo de valor que deben almacenar los atributos recuperados.
Recuento mximo
Introduzca el nmero mximo de atributos coincidentes para recuperar.
b. En el rea Criterios de elemento, configure los campos para limitar los elementos en los
que se buscarn atributos coincidentes:
Raz de bsqueda
Introduzca el elemento que desee utilizar como la raz o el nivel base de la bsqueda
de atributos. Escriba el nombre exacto o haga clic en Explorar para abrir la
ventana Navegador de elementos, donde podr consultar la jerarqua de elementos y
seleccionar un elemento. No puede incluir caracteres comodn en el nombre que
introduzca. Si no especifica un elemento, establezca el nivel principal de la jerarqua
de elementos como la raz. En funcin de la jerarqua de PI AF, la especificacin de un
elemento en el campo Raz de bsqueda puede mejorar el rendimiento de las
bsquedas.
Seleccione la casilla de verificacin Buscar subelementos para buscar la raz
introducida y los subelementos. Desmarque esta casilla para buscar slo en la raz
introducida.
Nombre
Introduzca el nombre de los elementos en los que desee buscar atributos. Puede
nombre. Vase Caracteres especiales en bsquedas de nombres.
Categora
Seleccione la categora de los elementos en los que desea buscar atributos.
Plantilla
Seleccione la plantilla de los elementos en los que se buscarn los atributos.
Tipo
Seleccione el tipo de los elementos en los que desea buscar atributos.
Si especifica valores para varios ajustes, la bsqueda devolver slo aquellos atributos que
coincidan con todos los ajustes especificados.
4. Haga clic en Buscar para recuperar todos los atributos coincidentes en la tabla Resultados
de bsqueda.
Tambin, puede utilizar el rbol de elementos debajo de Resultados de bsqueda para
buscar de forma manual los atributos bajo determinados elementos y, a continuacin,
seleccionar los atributos para aadirlos a la tabla Resultados de bsqueda.
5. Seleccione elementos en la lista de resultados de bsqueda y haga clic en Aceptar para
mostrar los elementos seleccionados en el visor y el navegador. En el navegador, pulse con

el botn secundario para guardar o asignar otro nombre a los resultados de bsqueda y
conservarlos hasta que los elimine. Tambin puede hacer clic con el botn secundario para
eliminarlos o permitir que se eliminen al salir de PI System Explorer.
Caracteres especiales en bsquedas de nombres

Al buscar objetos por nombre, como nombres de elemento o nombres de atributo, puede
utilizar caracteres especiales:
* Sustituir cualquier nmero de caracteres sin especificar.
? Sustituir un nico carcter sin especificar.
[xyz] Especificar un conjunto de caracteres (x,y oz) para coincidir.
[!xyz] Especificar un conjunto de caracteres (x,y oz) para excluir una
coincidencia.
\ Ignorar el caracter especial siguiente e interpretarlo como su
carcter real.
Buscar marcos de evento

Procedimiento
1. En el panel del navegador, haga clic en el botn Marcos de evento.
2. Haga clic en Editar > Bsqueda de marcos de eventos. (Otra posibilidad es pulsar con el
botn secundario en el navegador sobre Bsquedas de marcos de evento y seleccionar
Nueva bsqueda.)
3. Introduzca criterios de bsqueda de marcos de evento. Observe el tringulo situado al final
del campo Buscar; le permitir alternar entre distintos operadores, como: Contiene y
Empieza por.
Marque la casilla de verificacin En curso si desea que en los resultados se muestren solo
marcos de evento sin una Hora de finalizacin concreta.
En el campo Nombre, puede introducir caracteres especiales para encontrar coincidencias
de una parte del nombre. Para obtener ms informacin, consulte Caracteres especiales en
bsquedas de nombres.
Para aadir campos que permitan especificar criterios adicionales, haga clic en Aadir
criterios y seleccione un parmetro de la lista.
Puede utilizar el criterio Raz de bsqueda de marco de evento para indicar que en los
resultados de bsqueda solo se incluyan los marcos de evento que sean secundarios del
marco de evento especificado.
Puede aadir dos criterios en el campo Duracin, si es necesario. Por ejemplo, si desea
buscar un marco de evento cuya duracin haya sido de una hora como mnimo, pero no
superior a tres, defina los dos campos de duracin en consecuencia:
a. Seleccione el operador mayor que o igual a (>=) e introduzca 1h en el campo
b. Seleccione el operador menor que o igual a (<=) e introduzca 3h en el campo
4. Haga clic en Buscar para encontrar los resultados que coinciden con los criterios. Los
resultados aparecern en la tabla Resultados.
5. Opcional: Haga clic en Aceptar para mostrar los resultados en el visor y en el rbol del
navegador. Puede seleccionar la forma en que se mostrarn los resultados de la bsqueda

en el navegador. Pulse con el botn secundario sobre una de las bsquedas de la lista,
seleccione Ordenar pory elija una opcin.
Pulse con el botn secundario para guardar o asignar otro nombre a los resultados de
bsqueda y conservarlos hasta que los elimine. Tambin puede hacer clic con el botn
secundario para eliminarlos o permitir que se eliminen al salir de PI System Explorer.
Buscar atributos en marcos de evento

Procedimiento
1. En el panel del navegador, seleccione Marcos de evento para establecer el contexto de los
mens de bsqueda.
2. En el men principal de PI System Explorer, seleccione Editar > Bsqueda de atributos de
marcos de eventos. Se abrir la ventana Bsqueda de atributos de marcos de eventos.
3. Configure la ventana Bsqueda de atributos de marcos de eventos para localizar los atributos
que desee en la base de datos de PI AF:
Nombre de atributo

Recuento mximo
b. En el rea Criterios de marco de evento, configure los campos para limitar la bsqueda a
los atributos que coincidan:
Buscar
Seleccione criterios para buscar las transferencias que estn dentro del perodo
especificado por Inicio de bsqueda y Final de bsqueda.
Inicio de bsqueda/Final de bsqueda

Seleccione o introduzca las horas de inicio y finalizacin del perodo de bsqueda.
Raz de bsqueda
Introduzca el marco de evento para utilizar como raz o nivel bsico de la bsqueda de
atributos. Escriba el nombre exacto o haga clic en Explorar para abrir la ventana
Explorador de marcos de evento, donde podr consultar la jerarqua de marcos de
evento y seleccionar uno. No puede incluir caracteres comodn en el nombre que
introduzca. Si no especifica un marco de evento, la raz se establecer en el nivel
principal de la jerarqua. En funcin de la complejidad de su jerarqua de PI AF, la
especificacin de una raz de bsqueda puede mejorar el rendimiento de la bsqueda.
Seleccione la casilla de verificacin Buscar marcos de subeventos para buscar la raz
introducida y sus elementos secundarios. Desmarque esta casilla para buscar slo en
la raz introducida.

Nombre
Introduzca el nombre de los marcos de evento cuyos atributos desee buscar. Puede
Duracin
Introduzca valores de duracin mximos y mnimos para limitar la bsqueda de
atributos a marcos de evento cuya duracin se encuentre dentro de estos lmites.
Categora
Seleccione la categora de los marcos de evento cuyos atributos desee buscar.
Plantilla
Seleccione la plantilla de los marcos de evento cuyos atributos desee buscar.
Tipo
Seleccione el tipo de los marcos de evento cuyos atributos desee buscar.
de bsqueda. Puede limitar los resultados an ms para mostrar nicamente los atributos
que coincidan con el texto introducido en el campo Resultados de bsqueda.
5. Seleccione elementos en la lista de resultados de bsqueda y haga clic en Aceptar para
mostrar los elementos seleccionados en el visor y el navegador. En el navegador, pulse con
el botn secundario para guardar o asignar otro nombre a los resultados de bsqueda para
conservarlos hasta que los elimine. Tambin puede hacer clic con el botn secundario para
eliminarlos o permitir que se eliminen al salir de PI System Explorer.
Buscar una transferencia

Procedimiento
1. En el panel del navegador, haga clic en Marcos de evento.
El navegador mostrar las colecciones: Bsquedas de marcos de evento y Bsquedas de
transferencias.
Nota:
Si ha creado recientemente un marco de evento, tambin se mostrar en el navegador
la coleccin Marcos de evento recientes. Del mismo modo, si ha creado recientemente
una transferencia, se mostrar la coleccin Transferencias recientes en el navegador.
2. Pulse con el botn secundario sobre Bsquedas de transferencias y seleccione Nueva
bsqueda.
Aparecer el cuadro de dilogo Criterios de bsqueda de transferencias.
3. Introduzca criterios de bsqueda de transferencias. Tenga en cuenta que en el campo
Nombre, puede introducir caracteres especiales para buscar coincidencias de una parte de
un nombre. Para obtener ms informacin, consulte Caracteres especiales en bsquedas de
nombres.
Los campos Origen y Destino permiten especificar elementos como origen y destino de una
transferencia.
El campo Cont. mx. limita el nmero de resultados de bsqueda devueltos.

4. Una vez definidos los criterios de bsqueda, haga clic en Buscar.

Los resultados de la bsqueda aparecern en el rea Resultados de bsqueda de la ventana
Criterios de bsqueda de transferencias.
5. Para filtrar an ms la bsqueda, escriba en el campo de texto situado en la parte superior
de los resultados de bsqueda. A medida que escriba, se irn filtrando los resultados.
Bsqueda de atributos en transferencias

Procedimiento
1. En el panel del navegador, seleccione Marcos de evento para establecer el contexto de los
mens de bsqueda.
2. En el men principal de PI System Explorer, seleccione Editar > Bsqueda de atributo de
transferencia. Se abrir la ventana Bsqueda de atributo de transferencia.
3. Configure la ventana Bsqueda de atributo de transferencia para localizar los atributos que
desee en la base de datos de PI AF:
Nombre de atributo

Recuento mximo
b. En el rea Criterio de transferencia, configure los campos para limitar la bsqueda de
atributos a las transferencias que cumplan los criterios especificados:
Buscar
Seleccione criterios para buscar las transferencias que estn dentro del perodo
especificado por Inicio de bsqueda y Final de bsqueda.
Inicio de bsqueda/Final de bsqueda

Seleccione o introduzca las horas de inicio y finalizacin del perodo de bsqueda.
Nombre
Introduzca el nombre de las transferencias cuyos atributos desee buscar. Puede
Origen
Introduzca o examine y seleccione el elemento de origen de las transferencias cuyos
atributos desee incluir en la bsqueda.

Destino
Introduzca o examine y seleccione el elemento de destino de las transferencias cuyos
atributos desee incluir en la bsqueda.
Plantilla
Seleccione la plantilla de las transferencias cuyos atributos desea buscar.
Categora
Seleccione la categora de las transferencias cuyos atributos desea buscar.
de bsqueda.
Puede limitar los resultados an ms para mostrar nicamente los atributos que coincidan
con el texto introducido en el campo Resultados de bsqueda.
Los resultados de bsquedas de atributos anteriores se mostrarn en el panel hasta que los
elimine.
Crear una tendencia en PI System Explorer

Mientras explora elementos en PI System Explorer, puede crear de forma fcil tendencias
sencillas para poder verificar las frmulas, los clculos y otras mtricas que cree en PI AF.
Mientras disea una frmula de AF, es posible que desee comprobar cules sern los
resultados de las ltimas horas. Si va a crear atributos de PI point que incluyan resmenes,
podra ser til ver cmo sern para las horas ms recientes.
Puede aadir los atributos de AF o los PI points que le interesen a una tendencia. Una forma de
hacerlo es arrastrndolos y soltndolos en ella. Despus, podr explorar los datos ajustando la
duracin y las horas de inicio y finalizacin de la tendencia.
Una vez creada la tendencia, se mostrar en la ventana Tendencia aunque est utilizando otras
funciones en PI System Explorer. Podr aadir o eliminar trazos de la tendencia siempre que lo
desee. Dispone de un cursor de tendencia, y al hacer clic en la tendencia, se mostrar un men
contextual.
Tambin podr ver la tendencia de un atributo cuando consulte sus datos de serie temporal
(para ver los datos de serie temporal, pulse con el botn secundario sobre un atributo y
seleccione Datos de serie temporal). La tendencia se muestra de forma automtica en la parte
inferior de la ventana Datos de serie temporal.
Nota:
OSIsoft recomienda utilizar herramientas de visualizacin, como PI Coresight, PI
ProcessBook y PI Webparts, para crear y guardar cualquier tendencia que tenga previsto
utilizar en ms de una ocasin.
Procedimiento
1. Seleccione Mostrar tendencia en el men Ver. Se abrir la ventana Tendencia.
2. Para aadir un atributo de AF a la tendencia, haga clic en Aadir atributos. Se abrir la
ventana Bsqueda de atributos.
a. Si es necesario, especifique parmetros de bsqueda en Nombre de atributo, Categora
de atributo y otros campos para localizar el atributo que le interese.
b. Expanda la jerarqua de elementos en el rea Resultados de bsqueda y seleccione el
atributo.

c. Haga clic en Aceptar. La ventana Tendencia muestra una tendencia que indica cmo ha
variado el atributo a lo largo de la ltima hora (1 hora es la duracin predeterminada).
d. Puede ajustar la duracin especificando tiempos en los campos Hora de inicio y Hora de
finalizacin.
3. Para aadir un PI point a la tendencia, haga clic en Aadir PI points. Se abrir la ventana
Bsqueda de tags.
a. Localice el PI point que desea consultar y seleccinelo en los resultados.
b. Haga clic en Aceptar. El PI point se aadir a la tendencia.
4. Aada cualquier otro atributo de AF o PI point cuyos datos desee consultar.
Los trazos en la ventana Tendencia se mantendrn hasta que la cierre. En cualquier
momento que desee, podr arrastrar atributos y PI points desde otros resultados de
bsqueda y soltarlos en la tendencia para aadirlos.
Tambin puede pulsar con el botn secundario sobre un atributo y seleccionar Aadir a
tendencia.
5. Para ajustar los trazos que se vern en la tendencia, pulse Trazos y anule la seleccin de la
casilla de los atributos o puntos que no desee ver.
Gestionar cambios de equipos y procesos

Cuando necesite cambiar un equipo, por ejemplo, sustituir una bomba averiada por otra de
similares caractersticas, puede seguir utilizando el elemento existente para representar la
bomba nueva. Sin embargo, para indicar que se ha producido un cambio, es recomendable
crear una versin del elemento. De esa forma, tendr un registro del cambio del equipo que el
elemento representa.
Del mismo modo, es posible que necesite crear versiones de una tabla. Por ejemplo, las tablas
de calibracin de los tanques se actualizan de forma peridica para ajustarse a las cambiantes
caractersticas fsicas del tanque. Si versiona la tabla, podr utilizarla con la misma
configuracin que tena en el momento de la recopilacin de datos.
PI System Explorer permite crear varias versiones de elementos, modelos y tablas.
Tambin, se puede indicar que un elemento, modelo o tabla no estar en funcionamiento a
partir de una determinada fecha si selecciona esta como su fecha de caducidad.
En esta seccin
Crear una versin de un elemento o un modelo
Crear una versin de tabla
Visualizacin de diferentes versiones de objeto y objetos obsoletos

Crear una versin de un elemento o un modelo

Procedimiento
1. En el panel del navegador, haga clic en Elementos y seleccione el elemento o el modelo que
desee versionar en el rbol del navegador.
2. Haga clic en la pestaa Versin del panel del visor y pulse Nueva versin. (Tambin puede
pulsar con el botn secundario sobre el elemento o modelo en el navegador y seleccionar
Crear versin.) Se mostrar la ventana Crear versin.
3. Introduzca una Fecha efectiva para la versin o haga clic en para elegir una y haga clic
en Aceptar. PI System Explorer crea una versin.
Nota:
La creacin de una versin producir un ingreso del elemento o del modelo.
Crear una versin de tabla

Procedimiento
1. En el panel del navegador, haga clic en Biblioteca y seleccione la tabla que desee versionar
en el rbol del navegador.
2. Pulse con el botn secundario sobre la coleccin Tablas y seleccione Nueva tabla.
3. Haga clic en la pestaa Versin del panel del visor y pulse Nueva versin. (Tambin puede
pulsar con el botn secundario sobre el elemento o modelo en el navegador y seleccionar
Crear versin.) Se mostrar la ventana Crear versin.
4. Introduzca una Fecha efectiva para la versin o haga clic en para elegir una y haga clic
en Aceptar. PI System Explorer crea una versin.
Nota:
La creacin de una versin producir un ingreso en la tabla.
Visualizacin de diferentes versiones de objeto y objetos obsoletos

De forma predeterminada, PI System Explorer muestra las versiones ms 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 una fecha obsoleta (aunque sea una
fecha futura). Por consiguiente, si especifica una fecha obsoleta para un objeto y la guarda,
desaparecer inmediatamente de PI System Explorer.
Sin embargo, podr buscar y ver un objeto obsoleto, o una determinada versin de un objeto, si
configura en Fecha de consulta una fecha fija en la que el objeto o la versin son actuales. Por
ejemplo, para mostrar un elemento que 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.
En esta seccin
Fecha de consulta y tiempo en PI System Explorer
Mostrar una fecha y hora concretas
Establecer el contexto temporal de los valores de atributo mostrados
Comparar dos versiones

Fecha de consulta y tiempo en PI System Explorer

Fecha de consulta determina los valores de tiempo que PI System Explorer utiliza para:
buscar y mostrar valores de atributo

identificar versiones actuales de objetos para mostrar e incluir en los resultados de
bsqueda
El valor predeterminado de Fecha de consulta, Ajustar a ms reciente, determina que PI
System Explorer busque y muestre los datos ms recientes de los valores de atributo. (Puede
sustituir el ajuste de Fecha de consulta para ver los valores de un momento distinto con
Establecer contexto temporal. Vase Establecer el contexto temporal de los valores de atributo
mostrados.)
Ajustar a ms reciente tambin hace que PI System Explorer utilice las versiones ms recientes
de objetos, aunque estas versiones sean futuras, y excluye cualquier objeto con una fecha
obsoleta, aunque sea una fecha futura.
Puede cambiar el valor de Fecha de consulta para especificar una fecha y hora fijas:
El selector de fecha y hora permite elegir una fecha y hora concretas.

Las selecciones Ajustar a ahora y Ajustar a hoy utilizan el momento actual para establecer
una fecha y hora fijas. Por ejemplo, si el lunes elige Ajustar a ahora, el mircoles Fecha de
consulta se establecer en lunes.
Cmo afecta la fecha de consulta a PI System Explorer
Qu se ve afectado La fecha de consulta es Ajustar a La fecha de consulta es una fecha y
ms reciente hora fijas
Todos los objetos de PI System PI System Explorer utiliza las PI System Explorer utiliza las
Explorer versiones ms recientes aunque versiones de objetos que estn
sean versiones futuras; excluye vigentes en ese momento.
cualquier objeto con una fecha
obsoleta, aunque sea una fecha
futura.
Elemento, modelo y versiones de PI System Explorer devuelve las PI System Explorer devuelve las
tabla en la bsqueda versiones ms recientes, aunque versiones que estn vigentes en ese
sean futuras. momento.
Tiempo relativo en las bsquedas PI System Explorer define el tiempo PI System Explorer define el tiempo
actual (*) como el momento de la actual (*) como el tiempo
bsqueda. especificado en Fecha de consulta.
Datos PI Se devuelve el valor de instantnea Los datos PI devueltos representan
ms reciente de los datos PI. el valor de la marca de tiempo
especificada en Fecha de consulta.
Mostrar una fecha y hora concretas

Cuando defina la fecha de consulta en un da y hora concretos, ese da y hora se mantendrn
constantes hasta que la modifique.
Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Fecha de consulta.

Aparecer el selector de fecha y hora.

2. Seleccione la fecha y hora que desee. Si desea definir la fecha de consulta como el da y la
hora actuales, pulse el botn Ajustar a ahora.
Nota:
Al seleccionar Ajustar a ahora como fecha de consulta, la fecha de consulta se define
como un da 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
opcin Ajustar a ms reciente.
Establecer el contexto temporal de los valores de atributo mostrados

La hora o el intervalo de tiempo que PI System Explorer utiliza para mostrar valores de
atributo estn determinados por el valor indicado en Establecer contexto temporal.
PI System Explorer muestra los valores ms recientes de los atributos en funcin de la hora
actual. El valor de Fecha de consulta refleja la configuracin 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 Establecer contexto temporal.
Algunos valores de atributo reflejan un intervalo de tiempo (por ejemplo, el promedio de
valores de punto de la ltima hora). Puede utilizar Establecer contexto temporal para
especificar un intervalo de tiempo distinto para los valores de atributo mostrados.
La configuracin de la hora y del intervalo de tiempo del campo Establecer contexto temporal
solo se aplica a los valores de atributo mostrados. El valor de Fecha de consulta seguir
aplicndose a todos los dems objetos de PI System Explorer.
Procedimiento
1. En la barra de herramientas de PI System Explorer, pulse el botn Establecer contexto
temporal para abrir la ventana Establecer contexto temporal.
Tambin puede hacer clic en Herramientas > Opciones y seleccionar la pestaa Contexto
temporal.
2. Seleccione una de las siguientes opciones. Introduzca valores temporales para una opcin
directamente o haga clic en el botn del selector de fecha y hora para seleccionarlos.
Tambin puede utilizar el botn de men en cascada para crear una expresin temporal.
Opcin Descripcin
Hora y fecha de la consulta El cuadro de texto muestra la configuracin
actual de Fecha de consulta. Puede seleccionar
otra configuracin temporal.
Hora alternativa Introduzca una nueva hora para utilizar con los
valores de atributo mostrados.
Intervalo de tiempo Introduzca las horas de inicio y finalizacin para
especificar un nuevo intervalo de tiempo para los
valores que atributo mostrados que requieren un
intervalo de tiempo.
3. Opcional: Haga clic en Establecer como predeterminado para registrar la configuracin

actual como el contexto temporal predeterminado o haga clic en Restaurar valores
predeterminados para restaurar el contexto temporal a la Hora y fecha de la consulta
definida como Ms reciente disponible.
4. Haga clic en Aplicar para ver los cambios y en Aceptar para guardarlos.

Comparar dos versiones

Puede comparar dos versiones de cualquier objeto que pueda tener diferentes versiones
(elemento, modelo o tabla).
Procedimiento
1. Seleccione el objeto cuyas versiones desee examinar y haga clic en la pestaa Versin.
2. Haga clic en Mostrar historial. Se abrir la ventana Mostrar historial. Todas las versiones
existentes se mostrarn en el panel de la izquierda.
3. Seleccione dos versiones en el panel izquierdo. Las diferencias se muestran en el panel
derecho mediante barras de colores.
El color rojo significa que el elemento estaba presente en la versin anterior y no est en
la ms reciente.
El color verde significa que el elemento est presente en la versin ms reciente, pero no
lo estaba en la anterior.
El color amarillo significa que el elemento se ha modificado entre las dos versiones.
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, podr obtener una vista previa cmo
funcionarn las configuraciones de referencias de datos con los datos recopilados en otras
herramientas cliente de PI, como PI ProcessBook, PI Coresight, PI DataLink y PI WebParts.
Nota:
Algunas configuraciones de atributos no admiten este tipo de datos. Consulte
Restricciones de visualizacin de los datos de serie temporal
Procedimiento
1. Pulse con el botn secundario sobre el atributo en el visor y seleccione la opcin Datos de
serie temporal en el men que aparece. Se mostrar la ventana Datos de serie temporal.
2. Seleccione la pestaa que represente el tipo de datos que desea consultar:
Archivado
Para PI points. Muestra los valores archivados en la hora especificada. Los ajustes son
Tipo de lmite y Expresin de filtro.
Muestreado
Devuelve valores interpolados y repartidos de manera uniforme a lo largo de un
intervalo regular. Puede incluir una Expresin de filtro.
Plot
Obtiene valores a lo largo del intervalo de tiempo especificado que sirven para trazar el
nmero de intervalos especificados. Por lo general, los intervalos representan pxeles y
esta funcin puede utilizarse para representar el ancho de la pantalla disponible para el
plot.
Resumen
Muestra Estadsticas estadsticas que resumen los valores de atributo que admiten esta
caracterstica. Puede especificar Ponderacin.

En esta seccin
Estadsticas
Ponderacin
Expresin de filtro
Tipo de lmite
Abreviaturas de configuracin de atributos
Estadsticas
La pestaa Resumen proporciona las siguientes estadsticas de los atributos que admiten esas
estadsticas:
Porcentaje correcto
Muestra el porcentaje de tiempo para el que se devuelven valores correctos en relacin con
el intervalo de tiempo total. Los valores correctos son valores de evento que se han
determinado como vlidos y no tienen el estado de error.
Promedio
Calcula el promedio de los valores durante el intervalo.
Mnimo
Devuelve el valor mnimo durante el intervalo.
Mximo
Devuelve el valor mximo durante el intervalo.
Intervalo
Calcula el valor mximo menos el valor mnimo durante el intervalo.
Desviacin estndar
Calcula la desviacin estndar de los valores durante el intervalo.
Desviacin estndar de poblacin
Calcula la desviacin estndar de poblacin de los valores durante el intervalo.
Recuento
Devuelve el total de valores almacenados durante el intervalo.
Ponderacin
La pestaa Resumen permite seleccionar la ponderacin de los clculos estadsticos:
Ponderado en tiempo
Valor predeterminado Pondera cada valor de evento en funcin del intervalo de tiempo
durante el que se aplica.
Ponderado en tiempo continuo
Pondera los valores en funcin del tiempo, pero realiza la interpolacin entre los valores
como si estos representaran datos continuos (interpolacin estndar), independientemente
de si el atributo es escalonado.

Ponderado en tiempo discreto

Pondera los valores en funcin del tiempo, pero realiza la interpolacin entre los valores
como si estos representaran valores discretos y no relacionados (plot escalonado),
independientemente de si el atributo es escalonado.
Ponderado a evento
Pondera todos los eventos de manera uniforme. Este mtodo requiere como mnimo un
evento en un intervalo de tiempo (dos eventos para los clculos de desviacin estndar). De
forma predeterminada, los eventos que se encuentran en el lmite del clculo se gestionan
del siguiente modo:
utilizar eventos en ambos lmites cuando hay solo un intervalo de clculo
incluir eventos a la hora de inicio en varios intervalos y ordenar estos de menos a ms
reciente
incluir eventos a la hora de finalizacin en varios intervalos y ordenar estos de ms a
menos reciente
Ponderado a evento - Excluir evento ms temprano
Ponderado a evento, salvo que el evento a la hora de inicio (hora ms temprana) de un
intervalo no se utiliza en ese intervalo.
Ponderado a evento - Excluir evento ms reciente:
Ponderado a evento, salvo que el evento a la hora de finalizacin (hora ms reciente) de un
intervalo no se utiliza en ese intervalo.
Ponderado a evento incluye ambos extremos:
Los eventos de los dos extremos de los lmites del intervalo se incluyen en el clculo
ponderado a evento.
Expresin de filtro
Aada una expresin de filtro para filtrar valores de evento mediante una expresin
matemtica y eliminar los datos para los que la expresin d como resultado falso. Por ejemplo,
la expresin de filtro simple:
. < 70
eliminar todos los valores del clculo superiores a 70. Asimismo, en la expresin de filtro
puede utilizar cualquier ecuacin de rendimiento de PI vlida para elaborar expresiones ms
complejas que eliminen los picos atpicos de los valores de datos, por ejemplo.
Las variables de expresin estn limitadas a los atributos o PI Points originados desde un nico
PI Server. Los atributos que se resolveran en un valor esttico (sin ninguna referencia de datos
configurada) son tambin vlidos. Consulte Referencia indirecta para obtener una descripcin
completa de una posible sintaxis de referencia.
Ejemplos de variables de atributo
Expresin de filtro Accin
. Hace referencia al atributo que se est consultando
Level Hace referencia al atributo Level en el mismo nivel de
jerarqua de atributos del elemento o marco de evento.
.. Hace referencia al atributo principal del atributo que se
est consultando. Solo es vlido para los atributos
secundarios anidados.
.|HighLimit Hace referencia al atributo secundario HighLimit del
atributo que se est consultando.


|Temperature Hace referencia al atributo Temperature en el nivel de
jerarqua superior del elemento o marco de evento
actuales.
\\MyPIServer\sinusoid Ruta absoluta a un PI Point. Debe estar en el mismo PI
Server que el atributo actual consultado.
\\myAFServer\myDatabase\myElement|myAtttribute Ruta absoluta a un atributo AF.
\myRootElement|myAtttribute Ruta relativa de base de datos a un atributo AF
Ejemplos de variable de PI Point

. Hace referencia al PI Point que se est consultando
sinusoid Hace referencia al PI Point sinusoid en el mismo PI
Server.
Tipo de lmite
Especifique un tipo de lmite para determinar cmo se gestionarn las bsquedas de valores de
datos cuando se encuentren cerca de las horas de inicio y finalizacin del rango de valores:
Dentro (valor predeterminado)

Devuelve valores a las horas de inicio y finalizacin, si existen, o los valores ms prximos
dentro del rango.
Fuera
Devuelve los valores ms prximos que estn inmediatamente fuera del rango.
Interpolado
Devuelve valores interpolados a las horas de inicio y finalizacin.

Algunas configuraciones de atributos no admiten determinadas funciones de datos. En la
siguiente tabla se muestran las funciones admitidas y las configuraciones de referencias de
datos que las admiten. Estas restricciones tambin se aplican en otras herramientas cliente,
como PI DataLink, PI Coresight, PI ProcessBook y PI WebParts.
Para obtener una descripcin de las abreviaturas de configuracin de atributos en el
encabezado de tabla y las definiciones de cada tipo de configuracin, consulte Abreviaturas de
configuracin de atributos.
Funcin PI PI-Arc PI-Rel PI-TR PI-TR- NO-DR F CC CTS
Rel
Interpol S S S NO S S S Opcional Cdigo
atedValu
e
atedValu
es
atedValu
esAtTim
es

Funcin PI PI-Arc PI-Rel PI-TR PI-TR- NO-DR F CC CTS

Rel
Recorde S NO S NO NO S S Opcional Cdigo
dValue
dValues
dValues
ByCount
PlotValu S NO S NO NO S S Opcional Cdigo
es
Summar S NO S NO NO S S Opcional Cdigo
y
Summar S NO S NO NO S S Opcional Cdigo
ies
Filtered S NO NO NO NO NO NO NO Cdigo
Summar
ies
UpdateV S NO S NO NO S NO NO Cdigo
alue
UpdateV S NO S NO NO S NO NO Cdigo
alues
Annotati v S S NO NO NO NO NO Cdigo
ons
Filters S NO NO NO NO NO NO NO Cdigo
Abreviaturas de configuracin de atributos

En la siguiente tabla se definen las abreviaturas de configuracin de atributos que se utilizan
en Restricciones de visualizacin de los datos de serie temporal.
Abreviatura Significado Descripcin
PI PI Point configurado de forma Ninguna configuracin adicional
simple Time Method es Automatic,
Interpolated o AtOrBefore
PI-Arc PI Point especificado para Time Method es Before, Exact,
recuperacin de archivos AtOrAfter, After
PI-Rel PI Point con tiempo relativo PI Point configurado de forma
simple con tiempo relativo. Time
Method es Automatic,
Interpolated o AtOrBefore
PI-TR PI Point solo para intervalo de No es compatible con
tiempo TimeMethod.
PI-TR-Rel Intervalo de tiempo con tiempo TimeMethod se establece en
relativo TimeRange o
TImeRangeOverride.
No-DR Sin referencias de datos Sin referencias de datos
F Referencia de datos basada en un Si no hay entradas, se
clculo con las entradas de series comportar bsicamente como
temporales como frmula. No-DR.
CC Referencia de datos
personalizada basada en clculos

Abreviatura Significado Descripcin

CTS Referencia de datos
personalizada que genera sus
propios datos de series
temporales

Diseo e implementacin de modelos de activos de
PI AF
En esta seccin
Organizacin de modelos de activos
Representacin de activos en PI Asset Framework
Seguridad de objetos en PI AF
Asociacin de datos con activos
Trabajo con unidades de medida
Organizacin de modelos de activos

El objetivo de la organizacin de los modelos de activos es hacer que a los usuarios les resulte
fcil encontrar los activos. El mtodo de organizacin principal es el rbol de elementos. Los
elementos de PI AF se organizan en una estructura de rbol. Los elementos individuales se
pueden organizar y reagrupar dentro del rbol, sin limitaciones. Si acaba de empezar a utilizar
PI AF, comience por crear la jerarqua de elementos. Vase Estructuracin del modelo de
activos.
Puede realizar la organizacin tambin por categoras para agilizar y simplificar la exploracin
y la bsqueda de informacin. Considere las categoras como etiquetas que se pueden aplicar a
objetos de PI AF. Cada objeto puede tener varias categoras. Vase Uso de categoras para
facilitar la localizacin de objetos.
Nota:
Tambin puede organizar activos dentro de un proceso. Vase Modelado de un proceso.
En esta seccin
Estructuracin del modelo de activos
Cmo tomar decisiones sobre jerarquas
Crear vistas mltiples de activos
Uso de categoras para facilitar la localizacin de objetos
Estructuracin del modelo de activos

Los objetos de PI AF se organizan en una estructura de rbol, similar a la estructura de archivos
de un ordenador 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 AF. La
organizacin de elementos en jerarquas hace ms fcil navegar por ellos y ofrece informacin
sobre cmo se relacionan los elementos entre s.
Al crear un modelo de activos, tendr que decidir qu estructura har ms fcil a los usuarios
encontrar los diferentes activos. Tenga en cuenta quines son sus usuarios y lo que buscan. Por
ejemplo, es posible que los ingenieros de mantenimiento deseen utilizar PI System Explorer
para buscar y registrar informacin de mantenimiento. Para este grupo, es posible que desee
agrupar activos por tipo de equipo.

Diseo e implementacin de modelos de activos de PI AF
Por ejemplo, si tuviera tres elementos de bomba, tal vez desee crear un elemento denominado
Bombas y, a continuacin, colocar todos los elementos de bombas en l. Si tuviera dos
elementos que representaran tanques, podra 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 ese mismo
ingeniero de mantenimiento prefiera ver todos los equipos ubicados en su propia planta. La
siguiente ilustracin muestra los mismos elementos organizados por planta.
Modelo de activos organizados por ubicacin
No esta limitado a una nica estrategia de organizacin. Puede utilizar referencias de elemento
para incluir el mismo activo en diferentes ubicaciones del rbol. Por ejemplo, puede optar por
organizar los elementos por tipo de equipo y planta tambin. En la siguiente ilustracin, la
jerarqua incluye el rbol geogrfico y el rbol de equipos uno junto al otro.
Modelo de activos mixto
Tambin, puede anidar la organizacin por equipos en la organizacin por zonas geogrficas.
Cmo tomar decisiones sobre jerarquas

El objetivo es crear una jerarqua de elementos que tenga sentido para las personas que
necesitan utilizarla. Si tiene distintos tipos de usuario, es posible que necesite varias
estructuras de rbol.
Si est empezando, no intente hacerlo todo a la vez. Cree una jerarqua 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 sera crear una
jerarqua para un determinado tipo de usuario.
Rena informacin:

Qu activos se incluirn en el rbol? En otras palabras, qu tipo de equipo desea incluir en

el modelo?
Quin necesitar encontrar activos en este rbol? Los ingenieros de mantenimiento? Los
ingenieros de control de proceso? Los operarios? Qu tareas necesitar realizar cada tipo
de usuario?
Qu activos son importantes para cada usuario y qu tipo de informacin necesitan?
Plantese preguntar a un nmero reducido de usuarios representativos de cada tipo a qu
datos necesitan acceder y cmo. Esto le proporcionar informacin sobre la estrategia
organizativa.
Una vez ms, empiece a pequea escala. Puede comenzar por un nico 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
responsables del equipo en esa planta, probablemente desear incluir un rbol que organice el
equipo por plantas.
A partir de este punto, puede preguntarles a algunos ingenieros de mantenimiento cmo
desean acceder a la informacin del equipo. Probablemente, con frecuencia buscarn activos
por tipo de equipo, pero en algunas ocasiones necesitarn buscarlos por fabricante. Puede
crear dos rboles paralelos: uno organizado por tipo de equipo y el otro por fabricante. Cada
activo aparecer entonces en cada uno de los rboles. Tambin, puede crear el rbol por tipo
de equipo y utilizar categoras para etiquetar cada activo por fabricante.
Una vez creada la jerarqua para un tipo de usuario, puede pedirles a algunos de ellos que la
prueben durante un cierto tiempo y pedirles que le proporcionen comentarios para mejorar la
jerarqua. Las jerarquas pueden modificarse siempre que se desee.
Nota:
Cuando piense en los usuarios, recuerde que la jerarqua de elementos puede mostrarse
tambin en determinadas aplicaciones cliente de PI. Tenga en cuenta tambin a los
usuarios de esas aplicaciones. Por ejemplo, PI Coresight muestra el rbol a los usuarios
que buscan activos relacionados. En PI Coresight, los activos relacionados son elementos
creados a partir de la misma plantilla.
Crear vistas mltiples de activos

Puede utilizar referencias de elementos para aadir el mismo elemento varias veces a la
jerarqua de elementos, como se describe en Estructuracin del modelo de activos. Cuando se
crea una referencia a un elemento existente, se crea fundamentalmente un marcador en la
jerarqua que vuelve a sealar 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 depender del tipo de referencia.
En esta seccin
Tipos de referencia
Crear una referencia de elemento
Crear varias referencias de elemento
Localizar otras referencias al mismo elemento

Tipos de referencia
Al aadir una referencia de elemento a una jerarqua de elementos, la relacin exacta entre el
elemento referenciado y el elemento al que se aade depende del tipo de referencia. PI AF
proporciona tres tipos de referencia de forma predeterminada:
Tipo de referencia principal-secundario

Tipo de referencia de composicin
Tipo de referencia dbil
Tambin puede crear sus propios tipos de referencia personalizados con la Representacin de
plantillas secundarias.
En esta seccin

Principal-secundario es el tipo de referencia predeterminado. Este tipo permite que el
elemento secundario tenga muchos principales. Si se elimina el ltimo elemento principal del
secundario, el propio elemento secundario se eliminar. Por ejemplo, supongamos que un
medidor que pertenece a una empresa se vincula a un edificio. Tendra que utilizar una
referencia principal-secundario entre el elemento de la empresa y el elemento del medidor
secundario y otra referencia principal-secundario entre el elemento del edificio y el elemento
del medidor secundario.
Si el medidor se elimina del edificio, seguir existiendo porque sigue teniendo una referencia
principal-secundario al elemento de la empresa. Si se elimina tambin de la empresa, dejar de
existir porque se habrn eliminado todas las referencias principal-secundario.

Un tipo de referencia con la fuerza de composicin significa que el elemento secundario forma
parte del principal y no puede existir sin l. Si elimina un elemento principal que tenga un
elemento secundario con una referencia de composicin, eliminar tambin el elemento
secundario.
Utilice una referencia de composicin cuando los dos objetos de la relacin se consideren un
solo elemento. Por ejemplo, un medidor puede estar compuesto de dos sensores; por lo tanto,
tendra que utilizar una referencia de composicin entre el elemento del medidor y cada uno
de sus dos elementos secundarios de sensor. Si elimina el elemento del medidor, eliminar
tambin los elementos secundarios de sensor. Cuando extraiga uno de los elementos de sensor
para realizar un cambio, el otro elemento de sensor y el elemento del medidor se extraern
tambin.

Utilice una referencia dbil entre dos elementos cuando desee crear una relacin entre dos
elementos, pero no desee que la relacin determine la duracin 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 automticamente de la

agrupacin. En este caso, tendra que utilizar una referencia dbil entre el elemento principal
del grupo y el elemento secundario del medidor.
Crear una referencia de elemento

Procedimiento
1. En el navegador, haga clic en el elemento al que desea hacer referencia y arrstrelo al
elemento principal que corresponda.
Se mostrar la ventana Seleccionar tipo de referencia.
2. Seleccione el tipo de referencia. Si no est seguro de qu tipo de referencia prefiere,
mantenga el tipo predeterminado: principal-secundario. Consulte Tipos de referencia para
obtener ms informacin.
Los elementos referenciados aparecern en el navegador. El icono de elemento referenciado
indica que son referencias.
Crear varias referencias de elemento

Procedimiento
1. En el navegador, pulse con el botn secundario sobre un elemento, seleccione Nuevo y, a
continuacin, Aadir referencia de elemento. Observe que tambin puede seleccionar un
elemento y arrastrarlo al principal. Aparecer la ventana Aadir elementos.
2. Pulse el botn Buscar mltiples elementos.
Aparecer la ventana Bsqueda de elemento.
3. Seleccione criterios de bsqueda para localizar el elemento deseado y pulse el botn Buscar.
El campo de resultados de la bsqueda mostrar los resultados de su bsqueda.

4. Seleccione los elementos a los que desee hacer referencia y haga clic en Aceptar.
Aparecer la ventana Aadir elementos.
5. Seleccione el tipo de referencia. Si no est seguro de qu tipo de referencia prefiere,
mantenga el tipo predeterminado: principal-secundario. Consulte Tipos de referencia para
obtener ms informacin.
Los elementos referenciados aparecern en el navegador. El icono de elemento referenciado
indica que son referencias.
Localizar otras referencias al mismo elemento

Un nico elemento puede estar referenciado en diferentes lugares dentro de la jerarqua. Podr
localizar todos los elementos dentro de la jerarqua que contienen el elemento o una referencia
al elemento.

Procedimiento
1. Seleccione el elemento en el navegador.
2. En la hoja de propiedades, haga clic en la pestaa General.
3. Haga clic en el vnculo Primarios.
Se mostrarn los primarios del elemento.
Uso de categoras para facilitar la localizacin de objetos

En esta seccin
Categoras
Crear una categora
Ver categoras
Aadir un objeto a una categora
Categoras
PI System Explorer permite organizar objetos en categoras. Las categoras son bsicamente
grupos de objetos definidos por los usuarios. Su finalidad es ayudar a encontrar objetos con
ms facilidad. Cuando busque un objeto, puede utilizar la categora como filtro para reducir la
lista de resultados. Defina tantas categoras como desee. Los objetos pueden pertenecer a
varias categoras.
Por ejemplo, supongamos que tiene un conjunto de elementos que representan tanques. La
mitad de los tanques estn fabricados por la empresa ACME y la otra, por la empresa EMCA.
Para ubicar los tanques por fabricante, cree dos categoras: ACME y EMCA.
Cada tipo de objeto tendr sus propias categoras. No podr aplicar las categoras de un tipo de
objeto a un objeto de otro tipo. Por ejemplo, no podr aplicar una categora de elemento a una
tabla. PI AF admite los siguientes tipos de categora:
Anlisis
Atributo
Elemento
Tipo de referencia
Tabla
Crear una categora

Este procedimiento utiliza PI System Explorer para crear una categora. Tambin puede utilizar
PI Builder para crear distintas categoras a partir de una hoja de clculo Excel.
Procedimiento
1. Abra PI System Explorer.
2. Haga clic en la pestaa Biblioteca del panel del navegador.
3. En el navegador, en Categoras, pulse con el botn secundario sobre el tipo de objeto de
categora y seleccione Nueva categora en el men que aparece.
Se mostrar el cuadro de dilogo Propiedades de categora.

4. Asigne un nombre a la categora y, si lo desea, escriba una descripcin.

5. Haga clic en Aceptar. La categora aparecer en el visor.
6. Guarde su trabajo.
Ver categoras
Procedimiento
2. Haga clic en la pestaa Biblioteca del panel del navegador.
3. En el navegador, en Categoras, haga clic en un tipo de objeto de categora. Las categoras
definidas para ese objeto aparecern en el visor.
Aadir un objeto a una categora

Procedimiento
1. En el visor, haga clic con el botn secundario sobre el objeto o los objetos que desee incluir
en la categora y seleccione Categorizar en el men que aparece.
Se abrir la ventana Categorizar.
Nota:
Podr seleccionar varios objetos consecutivos y no consecutivos.

2. Seleccione la categora o categoras que desea aplicar a los objetos seleccionados.
Nota:
Si la categora que necesita no aparece en la lista, haga clic en el botn Nueva

categora para crearla.
Representacin de activos en PI Asset Framework

Todos los objetos fsicos que incluya en el modelo estarn representados por un elemento de PI
AF. Los objetos fsicos 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 informacin fija, como el dimetro de un tanque, por ejemplo. Un atributo
puede tambin hacer referencia a un PI point, una frmula, un valor procedente de una base de
datos relacional externa, etc.
Puede crear los elementos uno por uno, pero es mejor basar los elementos individuales en una
plantilla de activos que represente el tipo de equipo. Las plantillas de elementos le permiten:
Configurar la plantilla una nica vez; no es necesario configurar los elementos basados en la
plantilla uno por uno.
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
En esta seccin
Uso de elementos para modelar activos
Uso de elementos para representar activos

Uso de elementos para modelar activos

PI AF permite basar objetos similares en una nica plantilla. Las plantillas definen
principalmente un conjunto de atributos base para todos los objetos que utilicen esa plantilla.
Cree la plantilla una vez y, despus, podr crear tantos elementos como necesite basndose en
la plantilla. Si realiza un cambio en una plantilla, este cambio se reflejar automticamente en
todos los elementos que utilicen esa plantilla.
Por ejemplo, supongamos que tiene 100 bombas que tienen los mismos tres atributos. Puede
crear una plantilla para una bomba y despus basar todas las dems bombas en esa plantilla.
Los atributos de la plantilla se crearn de forma automtica en las bombas que se basen en esa
plantilla.
Ahora, supongamos que necesita realizar un cambio en los objetos de bomba. Realice el cambio
en la plantilla y PI AF propagar de forma automtica el cambio a todos los objetos de bomba
que se basen en esa plantilla. Las plantillas son una potente herramienta, no solo para crear
objetos, sino para que los objetos existentes mantengan la coherencia y estn actualizados.
Otra ventaja es que las herramientas de visualizacin pueden ofrecer caractersticas especiales
para los objetos basados en plantillas. Por ejemplo, supongamos que crea una tendencia para
una bomba basada en una plantilla. Una herramienta de visualizacin podra permitirle
intercambiar o aadir 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:
Puede crear plantillas para marcos de evento, transferencias modelos y PI Notifications

(si dispone de una licencia para PI Notifications).
En esta seccin
Estrategia de plantillas
Plantillas de elementos
Definicin de plantillas para otros objetos
Representacin de plantillas secundarias
Estrategia de plantillas
Prcticamente en todos los casos, es mejor basar los elementos en plantillas. No solo ahorrar
tiempo, sino que le asegura que dispondr de definiciones coherentes de todos los elementos
en funcin de esa plantilla. Todos los cambios que realice en una plantilla de elementos se
propagarn a todos los elementos basados en esa plantilla. Una nica modificacin de la
plantilla puede alterar cientos de elementos. Esto le permitir realizar cambios en su modelo
desde un nico lugar; no tendr que actualizar todos los elementos.
No tendr 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 qu datos, clculos y otras propiedades necesitar almacenar para ese tipo de
activo. Cada uno de estos elementos requiere una plantilla de atributos.
El uso de la plantilla puede ser muy amplio o muy especfico. Una plantilla puede definir un
tipo especfico de dispositivo de medicin, como un instrumento de una marca concreta, o
puede ser una plantilla de uso amplio que especifica una determinada funcin, como medidor

de masa lquida. En funcin de la amplitud con la que defina la plantilla, puede encontrarse con
que la lista de atributos es ligeramente diferente para distintos subconjuntos de activos. En
esta situacin, plantese utilizar una plantilla base (Plantillas base). La alternativa es utilizar
una plantilla diferente para cada subconjunto de activos.
Tambin puede permitir que los elementos incluyan atributos que no estn definidos ni
mantenidos por la plantilla (Extensiones). De esta forma, podr aadir atributos simples y
especficos de activos sin necesidad de aadirlos a todas las instancias de la plantilla.
Plantillas de elementos
Una plantilla de elementos es fundamentalmente un modelo de un tipo de activo. Las plantillas
de elementos hacen que crear pantallas, notificaciones, clculos y anlisis resulte mucho ms
fcil, porque los equipos con el mismo tipo pueden compartir la implementacin. Por lo
general, cree una plantilla de elementos que represente un tipo de equipo, como un tanque o
una bomba. Podr crear de forma sencilla elementos a partir de la plantilla porque la mayor
parte de la configuracin del elemento estar definida en la plantilla.
Cuando modifique una plantilla de elementos, los cambios se propagarn a todos los elementos
derivados de ella.
La supresin de una plantilla de elementos eliminar todas las notificaciones o plantillas de
anlisis que se refieran a ella.
Tenga en cuenta que:
Un elemento derivado de una plantilla obtiene su definicin de las categoras, atributos y

puertos de la plantilla.
Si la plantilla admite ampliaciones, un elemento derivado podr contener categoras,
puertos y atributos extra que no se hayan definido en la plantilla.
Las plantillas de elementos pueden especificar las referencias principales y secundarias
(tipos de referencias primarias y tipos de referencias secundarias) de un elemento creado a
partir de la plantilla. Esto limita las relaciones permitidas entre elementos de la jerarqua.
En esta seccin
Crear una plantilla de elementos
Cree y configure una plantilla de elementos.
Configurar la generacin automtica de puntos
Configure una referencia de datos de PI point para que cree automticamente PI points por
usted.
Localizar dnde se encuentra referenciada una plantilla
Consultar referencias de plantillas.
Crear una plantilla de elementos
Procedimiento
1. En el navegador, pulse con el botn secundario sobre la coleccin de plantillas de elementos
y seleccione Nueva plantilla.
2. Ajuste valores en las pestaas para configurar la plantilla de elementos. PI System Explorer
proporciona valores predeterminados para los valores obligatorios, pero puede configurar
usted mismo esos valores. Los valores son:
Plantilla base

Puede basar la plantilla en una plantilla existente. Seleccione la plantilla existente (base)
en el campo.
Tipo
Elemento, lmite, nodo, etc.
Categoras
Puede organizar objetos agrupndolos en categoras (opcional). Para examinar las
categoras disponibles, haga clic en Categoras.
Atributo predeterminado
Haga clic en para seleccionar un atributo predeterminado (opcional). Consulte
Patrn de nombres
Opcional: Haga clic en para seleccionar parmetros de sustitucin y definir un patrn
de nombres para que cada elemento derivado de la plantilla tenga un nombre nico e
identificable.
(Es posible que algunos parmetros de sustitucin no se apliquen cuando se crea un
elemento derivado. Para asegurarse de que el nombre de un elemento derivado refleja
plenamente el patrn de nombres, pulse con el botn secundario sobre el elemento y
haga clic en Reevaluar el patrn de nombres.)
Permitir extensiones
Casilla de verificacin para permitir realizar cambios en los elementos en funcin de esta
plantillla; por ejemplo, aadir atributos. Vase Extensiones.
Nota:
Las propiedades ampliadas son propiedades que otras aplicaciones definen en
objetos de PI AF. Por ejemplo, PI WebParts almacena Icono y URL en las
propiedades ampliadas de los elementos de PI AF. Las aplicaciones acceden, por lo
general, a la informacin almacenada en Propiedades ampliadas mediante
programacin con el PI AF SDK. En general, los usuarios de PI System Explorer no
necesitan utilizar esta caracterstica avanzada.
3. Utilice la pestaa Plantillas de atributos para crear una plantilla de atributos para cada
propiedad o elemento de datos de la plantilla. Vase Asociacin de datos con activos.
4. Utilice la pestaa Puertos para especificar puertos, que definen los puntos finales de las
conexiones entre elementos dentro de un modelo. Vase Modelado de un proceso.
En esta seccin
Plantillas base
Extensiones
El atributo predeterminado es un atributo que utilizan las aplicaciones cliente para representar
el elemento cuando no se ha especificado ningn atributo. El atributo debe estar en el nivel
superior de la jerarqua de atributos del elemento. No se puede anidar en otro atributo.
Seleccione el atributo que parezca el ms representativo del elemento. Por ejemplo, si un

usuario quisiera hacer referencia a un tanque, el mejor atributo individual para utilizar sera
nivel. En el caso de un medidor elctrico, los voltios de corriente.
Nota:
Algunas aplicaciones pueden utilizar el atributo predeterminado, pero muchas de ellas,

no.
Plantillas base
Si tiene varios elementos similares, pero con algunos atributos adicionales, plantese utilizar
una plantilla base. Una plantilla base incluye, de hecho, todos los atributos y puertos de la
plantilla de elementos base en la plantilla de elementos creada recientemente. Cuando se crea
un elemento a partir de una plantilla de elementos que incluye una plantilla base, el elemento
contendr todos los atributos y puertos de ambas plantillas de elementos.
Por ejemplo, si tiene un conjunto de tanques, algunos de dos vlvulas y otros de una sola,
puede crear una plantilla de elementos para los modelos de una sola vlvula y utilizarla como
plantilla base para los modelos de dos. Cuando cree objetos que se basen en el modelo de dos
vlvulas, tendrn todos los atributos del modelo de una sola vlvula, adems de cualquier
atributo adicional que se haya definido en el modelo de dos vlvulas.
Extensiones
Puede permitir que algunos atributos estn definidos en el propio elemento,
independientemente de la plantilla. Para ello, configure la plantilla para admitir extensiones.
Los atributos que se crean como ampliaciones no cambian cuando se modifica la plantilla. Si
modifica la plantilla para que deje de admitir ampliaciones, las extensiones de atributo
existentes se mantendrn, pero no podr aadir otras nuevas.
La extensin ofrece flexibilidad en aquellos casos en los que los activos son similares en
muchas reas, pero hay muchas variaciones pequeas. Por ejemplo, supongamos que crea una
plantilla para un modelo de coche concreto. Todos los coches de este modelo tienen el mismo
conjunto bsico de caractersticas: cuatro ruedas, un volante, etc. Sin embargo, puede que un
coche tenga un alern donde otro no lo tiene. Uno puede tener aire acondicionado y otro, no.
Las extensiones permiten tener en cuenta este tipo de variaciones.
Las extensiones le permiten basar todos los elementos en una plantilla, al tiempo que aade
informacin adicional para cada elemento. Si tiene muchos elementos que son similares a la
definicin de plantilla, pero todos necesitan los mismos atributos adicionales, tal vez resulte
ms til una plantilla base que las ampliaciones.
Nota:
Si tiene una plantilla que admite extensiones y la modifica para no admitirlas, no se

podrn aadir nuevos atributos de elemento extendidos a los elementos basados en esa
plantilla. Sin embargo, todos los atributos de elemento extendidos se mantedrn.
Configurar la generacin automtica de puntos

Puede configurar una referencia de datos de PI point en una plantilla de atributos para que
cree automticamente PI points por usted.
Procedimiento
1. Cree una plantilla de elementos en PI System Explorer.
2. Aada una plantilla de atributos nueva a la plantilla de elementos.
3. En el men desplegable Referencia de datos, seleccione PI Point.

4. Haga clic en Ajustes. Se mostrar el cuadro de dilogo Referencia de datos de PI Point.

5. En el campo de texto Nombre de tag, defina los nombres de PI point para los puntos
generados. Utilice parmetros de sustitucin para que PI AF cree automticamente los
nombres de punto para los puntos que genere.
6. Marque la casilla Creacin de tag.
7. Haga clic en .
Se abrir la ventana Ajustes de creacin de tag. Esta ventana muestra una lista de los valores
predeterminados de cada atributo de PI point. Edite los valores de atributo si es necesario.
Puede editar los atributos de PI point predeterminados o hacer clic en el botn Importar
para importar los valores de atributo de PI point de un punto existente. Se abrir la ventana
Bsqueda de tags. Puede utilizar parmetros de sustitucin (por ejemplo, %Element%) con
muchos valores de atributo.
9. Cree un elemento a partir de su plantilla de elementos y haga clic en la pestaa Atributos.
10. Pulse con el botn secundario sobre el atributo de referencia de datos de PI point y
seleccione Crear o actualizar referencia de datos en el men emergente.
11. Guarde su trabajo. De esta forma, se crearn todos los puntos a los que hagan referencia los
nuevos elementos. Esto nicamente funciona porque los elementos se han basado en una
plantilla y la plantilla de atributos para la referencia de datos utiliza la opcin de creacin de
tags.
Nota:
Una vez creados los PI Points, la interfaz especificada puede tardar algo de tiempo en
escribir los valores. Hasta ese momento, los valores aparecern como Pt. Created.
Localizar dnde se encuentra referenciada una plantilla

Seleccione la plantilla y haga clic en la pestaa General. Utilice los enlaces en la parte inferior
de la pestaa:
Haga clic en Plantillas derivadas para incluir todas las plantillas que tengan esta plantilla de
elementos como plantilla base. La lista tambin incluye plantillas de elementos que se
derivan indirectamente de esta plantilla, a travs de varias plantillas
Haga clic en Elementos para listar todos los elementos, modelos, transferencias y marcos de
evento que se hayan creado directamente a partir de esta plantilla de elementos
Haga clic en Elementos derivados para listar todos los elementos, modelos, transferencias y
marcos de evento que se hayan creado a partir de esta plantilla de elementos o que se
deriven de ella.
Haga clic en Plantillas primarias referenciadas para listar todas las plantillas de elementos
que se hayan vinculado especficamente con esta plantilla de elementos como primaria a
travs de un tipo de referencia. La lista de plantillas incluye aquellas que se han enlazado
indirectamente mediante plantillas heredadas.
Haga clic en Plantillas hijas referenciadas para listar todas las plantillas de elementos que se
hayan vinculado especficamente a esta plantilla de elementos como secundarias mediante
un tipo de referencia. La lista de plantillas incluye aquellas que se han vinculado
indirectamente a travs de una plantilla heredada.

Definicin de plantillas para otros objetos

Adems de las plantillas de elementos, puede definir plantillas para marcos de evento, modelos
y transferencias. Estas plantillas incluyen todos los atributos y propiedades necesarios para el
rol del objeto. Puede crear instancias del objeto basndolas en la plantilla configurada.
1. Haga clic en Biblioteca en el panel del navegador.

2. En el rbol del navegador, abra Plantillas para mostrar sus cuatro colecciones de objetos:
Plantillas de elementos, Plantillas de marcos de evento, Plantillas de modelos y Plantillas de
transferencia.
3. Pulse con el botn secundario sobre la coleccin de objetos y seleccione Nueva plantilla.
4. La nueva plantilla mostrar las siguientes pestaas:
General
Plantillas de atributos
Puertos (no disponible para plantillas de marcos de evento)
Plantillas de anlisis (solo plantillas de elementos)
Rellene estas pestaas igual que una plantilla de elementos. Vase Crear una plantilla de
elementos.
Representacin de 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 cigeal. Desea que la plantilla del cigeal sea una
plantilla secundaria de la del motor. No podr crear directamente una plantilla secundaria de la
misma forma que un elemento secundario. En su lugar, tendr que crear una plantilla
referenciada dentro de la plantilla Motor.
Se crear tambin un tipo de referencia en la coleccin Tipos de referencia.
Ahora, supongamos que desea crear un elemento basado en la plantilla Motor. PI System
Explorer no crea de forma automtica el elemento secundario, Cigeal. Sin embargo, cuando
cree de forma manual un elemento secundario en el elemento motor, el tipo de referencia
Motor-Cigeal de motor aparecer en la lista de tipos de referencia y la plantilla Cigeal
aparecer en la lista Plantilla de elementos.

Crear una referencia de plantilla secundaria
Procedimiento
1. En PI System Explorer, pulse el botn Biblioteca del panel del navegador.
2. Pulse con el botn secundario sobre la plantilla a la que desee aadir la referencia de
plantilla secundaria y haga clic en Nueva plantilla referenciada. Se mostrar el cuadro de
dilogo Definir nombre de plantilla de elemento referenciado.
3. Escriba el nombre de la plantilla secundaria y haga clic en Aceptar. Se crear una plantilla
secundaria en la coleccin Plantillas y un nuevo tipo de referencia en la coleccin Tipos de
referencia.
Uso de elementos para representar activos

En el modelo de activos, los elementos representan objetos fsicos, 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 seccin
Crear un elemento a partir de una plantilla
Crear un elemento sin tomar como base una plantilla
Eliminacin de elementos
Restablecer las propiedades de plantilla para un elemento
Cambiar elementos de plantilla o aadir una plantilla
Crear un elemento a partir de una plantilla
Procedimiento
1. En el navegador, haga clic con el botn secundario sobre la coleccin de elementos de un
elemento individual y seleccione Nuevo elemento.
Aparecer la ventana Seleccionar plantilla de elemento.
2. En el campo situado en la parte inferior de la ventana Seleccionar plantilla de elemento, haga
clic en la plantilla de elementos.
3. En el campo situado en la parte superior de la ventana Seleccionar plantilla de elemento,
haga clic en un tipo de referencia de la lista de tipos disponibles. Los tipos de referencia
disponibles dependen de la plantilla de elementos y de los tipos de referencia definidos en
la base de datos. Si no est seguro de qu tipo de referencia prefiere, mantenga el tipo
predeterminado: principal-secundario.
Las pestaas de propiedad de elemento aparecern en el visor. Dado que el elemento se
basa en una plantilla, la mayora de los archivos de la pestaa General sern de solo lectura
(atenuados o con almohadillas). Haga clic en el botn Atributos para ver los atributos
definidos por la plantilla. No podr aadir atributos nuevos salvo que la plantilla admita
ampliaciones.
5. Escriba el nombre del elemento.

Localizar dnde se utiliza un elemento

En el caso de los elementos seleccionados en el panel del navegador, los vnculos de la parte
inferior de la pestaa General muestran informacin acerca de dnde y cmo se utiliza el
elemento en el modelo de activos:
Primarios muestra todos los elementos principales de este elemento.

Modelos muestra todos los modelos en los que se utiliza el elemento.
Capas muestra las capas con las que est asociado el elemento.
Conexiones muestra los elementos con los que est conectado el elemento.
Secundarios muestra los elementos secundarios del elemento.
Marcos de evento muestra los marcos de eventos con los que est conectado el elemento.
Nota:
En funcin de las aplicaciones complementarias que haya instalado, es posible que se
muestren otros vnculos, como Notificaciones, por ejemplo.
Crear un elemento sin tomar como base una plantilla

Es mejor basar los elementos en plantillas. Muchas aplicaciones cliente de PI ofrecen potentes
funciones para los elementos basados en plantillas.
Procedimiento
1. En el navegador, haga clic con el botn secundario sobre la coleccin de elementos de un
elemento individual y seleccione Nuevo elemento.
2. En el campo situado en la parte inferior de la ventana Seleccionar plantilla de elemento,
haga clic en l y seleccione Ninguno.
3. En el cuadro de dilogo situado en la parte superior de la ventana Seleccionar plantilla de
elemento, seleccione un tipo de referencia. Los tipos de referencia disponibles dependen de
la plantilla de elementos y de los tipos de referencia definidos en la base de datos. Si no est
seguro de qu tipo de referencia prefiere, mantenga el tipo predeterminado: principal-
secundario.
Las pestaas de propiedad de elemento aparecen en el visor.
Utilice la pestaa General para realizar la configuracin bsica del elemento.

Utilice la pestaa Atributo para crear un atributo para cada propiedad o elemento de
datos de la plantilla.
Utilice la pestaa Puertos nicamente para modelar un proceso.
La pestaa Elementos secundarios se utiliza fundamentalmente para ver los elementos
secundarios de un elemento existente. Tambin puede crear elementos secundarios
directamente desde esta pestaa.

Nota:
Las propiedades ampliadas son propiedades que otras aplicaciones definen en objetos
de PI AF. Por ejemplo, PI WebParts almacena Icono y URL en las propiedades
ampliadas de los elementos de PI AF. Las aplicaciones acceden, por lo general, a la
informacin almacenada en Propiedades ampliadas mediante programacin con el PI
AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta
caracterstica avanzada.
Eliminacin de elementos
En PI AF 2.4 y posteriores, al eliminar un elemento, PI AF elimina de forma automtica las
notificaciones y los anlisis que tienen como destino ese elemento. Si desea reasignar una
notificacin vinculada a un elemento que tiene previsto eliminar, hgalo antes de eliminar el
elemento.
Tambin, puede cambiar el comportamiento predeterminado para que PI AF no elimine de
forma automtica las notificaciones y anlisis cuando elimine el elemento de destino. Para
realizar este cambio, utilice afdiag el programa de utilidad de lnea de comandos con el
parmetro /EnablePropagationOfTargetDeletion:
afdiag /EnablePropagationOfTargetDeletion-
Sin embargo, la desactivacin del ajuste puede originar algunos problemas, como:
Las notificaciones quedan abiertas (permanecen activas)

No se crean notificaciones nuevas
No se envan los correos electrnicos previstos
Restablecer las propiedades de plantilla para un elemento

Haga clic con el botn secundario sobre el atributo del elemento, seleccione Restablecer a
plantilla y, a continuacin, la opcin Crear o actualizar PI Points para restablecer las
propiedades de la plantilla para el elemento. Esto resulta til si ha creado elementos y
plantillas en un entorno de prueba y desea transferir su trabajo a un entorno de produccin.
Por ejemplo, supongamos que configura un atributo de PI AF para que utilice el nombre del PI
Server como parte de la configuracin del atributo en un entorno de prueba. Puede que desee
que esto se refleje en el nombre del nuevo PI Server cuando transfiera su trabajo a un entorno
de produccin.
Cambiar elementos de plantilla o aadir una plantilla

Para cambiar la plantilla en la que se basa un marco de evento existente o para aadir una
plantilla a un marco de evento que no base en una plantilla:
Procedimiento
1. En PI System Explorer, pulse el botn Elementos en el panel del navegador.
2. En el navegador, haga clic con el botn secundario sobre el elemento que desee modificar y
seleccione Convertir > Cambiar plantilla. Aparecer la ventana Cambiar plantilla de
elemento.
3. Seleccione una plantilla en la lista y haga clic en Aceptar.

Seguridad de objetos en PI AF
La seguridad en PI AF est estrechamente ligada a la seguridad de Windows. Los objetos y sus
permisos efectivos se basan en la identidad de usuario de Windows. Se pueden establecer
permisos para objetos individuales y colecciones.
Nota:
Si los usuarios disponen de privilegios administrativos en el servidor de PI AF, se les
otorgarn todos los derechos de seguridad a todos los objetos en el servidor de PI AF,
incluidas todas las bases de datos. Esto se cumple, independientemente de si se han
concedido o denegado al usuario derechos especficos sobre objetos individuales.
En esta seccin
Configurar permisos para objetos
Configurar permisos para colecciones
Configurar permisos para objetos

Algunos objetos de PI AF tienen un conjunto de informacin de control de acceso asociado a
ellos. Esta informacin consiste en un descriptor de seguridad que controla el tipo de acceso
otorgado a un conjunto de usuarios y grupos de Windows. El descriptor de seguridad se crea
de forma automtica al crear el objeto AF. En el caso de los elementos secundarios, la seguridad
del elemento principal se utiliza como seguridad predeterminada. En los dems objetos, la
seguridad predeterminada es la seguridad de la coleccin.
Nota:
Los objetos de biblioteca incluyen categoras, plantillas, conjuntos de enumeracin, tipos
de referencia y unidades de medida. Los objetos de biblioteca siempre disponen de
permiso de lectura, independientemente de sus valores de seguridad.
Son susceptibles de proteccin los siguientes objetos AF de nivel superior:
PISystem AFElementTemplate
AFContact AFEnumerationSet
AFCategory AFReferenceType
AFDatabase AFTable
AFAnalysis AFNotification
AFAnalyisTemplate AFNotificationContactTemplate
AFElement UOMDatabase
En esta seccin
Cmo cambiar los permisos de acceso en los objetos de AF
Seguridad de elemento
Seguridad de los marcos de evento y de las transferencias
Seguridad relativa a las unidades de medida
Seguridad de objetos de base de datos
Configuracin de permisos de acceso a objetos de AF
Cundo utilizar la opcin Deny

Cmo cambiar los permisos de acceso en los objetos de AF

Establezca permisos para objetos en el navegador, el visor y las hojas de propiedades donde
aparezcan.
Procedimiento
1. Haga clic con el botn secundario sobre el objeto y seleccione Seguridad en el men que
aparece. Se mostrar el cuadro de dilogo de propiedades de los permisos para el objeto
seleccionado.
2. Seleccione usuarios y configure permisos segn necesite. Los permisos se definen en
Configuracin de permisos de acceso a objetos de AF.
Los grupos y usuarios utilizados para definir la seguridad se basan en la seguridad de
Windows. Es mejor asignar permisos a grupos que a usuarios. No resulta eficaz mantener
cuentas de usuario directamente.
Seguridad de elemento
Al cambiar los permisos de acceso de un elemento, los permisos de acceso de los elementos
principales o secundarios puede que cambien tambin. El comportamiento depende del tipo de
referencia.
Tipo de referencia Descripcin
Dbil Los permisos de acceso no se heredan nunca.
Composicin 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 automticamente 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 automticamente para coincidir con los permisos del
principal. Estos cambios se aplican en cascada en sentido descendente (y ascendente) en
la totalidad de la jerarqua.
Principal-secundario Los elementos secundarios no heredan los permisos de acceso del elemento principal.
Puede copiar los permisos de acceso del principal a todos los objetos secundarios de la
ruta principal. Tendr que repetir el proceso cada vez que cambien los permisos de acceso
al principal y desee que los elementos secundarios de la ruta principal tengan los nuevos
permisos de acceso.
Los elementos secundarios de la ruta principal son fcilmente reconocibles: tienen
referencias fuertes a su elemento principal y son propiedad del elemento principal.
Muestran el icono de elemento estndar en la jerarqua.
Los elementos secundarios que tienen una referencia fuerte al elemento principal, pero
son propiedad de otro elemento, no estn en la ruta principal. Estos elementos
secundarios tienen una flecha de referencia en el icono de elemento estndar, que deja
claro que no estn en la ruta principal.
Copiar los permisos de acceso de un objeto principal a objetos secundarios

Lleve a cabo lo siguiente para copiar los permisos de acceso del objeto principal en sus objetos
secundarios en la ruta principal.
Nota:
Para determinar el objeto principal primario, seleccione el objeto secundario y haga clic
en el vnculo Primarios en PI System Explorer. El objeto principal primario tiene una
marca de verificacin en su icono.

Procedimiento
1. En el navegador, pulse con el botn secundario sobre el objeto cuyos permisos heredados
desee modificar y seleccione la opcin Seguridad en el men.
2. En la ventana Permisos de <Objeto>, haga clic en Opciones avanzadas.
3. En la ventana Configuracin de seguridad avanzada para <Objeto>, realice los cambios que
desee en los permisos de acceso.
a. Seleccione el Objeto principal que desee modificar.
b. Pulse Editar.
c. En la ventana Entrada de permiso para <Objeto>, seleccione los permisos que desee y
haga clic en Aceptar.
4. En la parte inferior de la ventana Configuracin de seguridad avanzada para <objeto>,
seleccione en la casilla Reemplazar todas las entradas de permisos de objetos secundarios
por entradas de permisos heredables de este objeto.
Nota:
Si est utilizando un sistema operativo ms antiguo, la frase de esta casilla puede ser
algo distinta, pero el efecto es el mismo.
6. En la ventana Seguridad de Windows, haga clic en S.
7. Haga clic en Aceptar para cerrar la ventana Permisos de <Objeto>.
Resultados
Los permisos de acceso a los objetos principales se copian en todos los objetos secundarios de
la ruta principal una sola vez Tendr que repetir este proceso siempre que cambien los
permisos de acceso al objeto principal y desee copiar otra vez esos permisos a los objetos
secundarios en la ruta principal.
Seguridad de los marcos de evento y de las transferencias

Marco de evento
En el momento de la creacin, los permisos de acceso asignados a un marco de evento que no
tiene un principal de referencia fuerte se calculan a partir de la plantilla de marcos de evento
con la que se ha creado. Si los permisos de acceso no se crean a partir de una plantilla, se
basarn en el elemento de seguridad del marco de evento asociado con la base de datos de PI
AF actual.
Cuando se aade un marco de evento secundario a un marco de evento existente, los permisos
de acceso del marco de evento secundario se asignan en funcin del marco de evento principal
en el momento de agregar el marco de evento secundario. Puede copiar los permisos de acceso
del principal a todos los marcos de evento secundarios de la ruta principal. Es necesario repetir
este proceso cada vez que cambien los permisos de acceso del principal y desee que los marcos
de evento secundarios de la ruta principal posean los nuevos permisos de acceso.
Los marcos de evento secundarios de la ruta principal son fcilmente reconocibles, puesto que
tienen referencias fuertes a su marco de evento principal y son propiedad del marco de evento
principal. Muestran un icono de marco de evento estndar en la jerarqua. Los marcos de
evento secundarios que tienen una referencia fuerte al marco de evento principal, pero son
propiedad de otro marco de evento, no estn en la ruta principal. Estos marcos de evento

secundarios tienen una flecha de referencia en el icono de marco de evento estndar, que deja
claro que no estn en la ruta principal.
Transferencia
Cuando se crea una transferencia, sus permisos de acceso se asignan en funcin de la plantilla
de transferencias asignada a la nueva transferencia, si se cre tomando como base una
plantilla. A las transferencias que no se crean a partir de una plantilla se les asignan permisos
de acceso en funcin del elemento de seguridad de transferencia asociado con la base de datos
de PI AF actual.
Modificacin del permiso de acceso

Para modificar el permiso de acceso de un marco de evento, lleve a cabo lo siguiente:
En AF SDK, utilice el parmetro applyToChildren enAFSecurity.SetAccessControl
Method en un objeto de marco de evento.
En PI System Explorer Browser, pulse con el botn secundario sobre el marco de evento
cuyos permisos heredados desee modificar y siga el mismo procedimiento descrito en
Copiar los permisos de acceso de un objeto principal a objetos secundarios.
Seguridad relativa a las unidades de medida

No puede configurar permisos para unidades de medida individuales o clases de unidades de
medida. Sin embargo, s puede configurarlos para la totalidad de la base de datos de unidades
de medida. Haga clic con el botn secundario en un rea en blanco, como se muestra en la
siguiente figura, y seleccione Seguridad.
Nota:
Las unidades de medida se pueden leer siempre (tienen el permiso de lectura),

independientemente de su configuracin de seguridad.
Seguridad de objetos de base de datos

El permiso de escritura de una base de datos de AF se aplica automticamente a cada objeto de
la base de datos. Esto proporciona un mecanismo ms sencillo para inhabilitar el permiso de
escritura sin tener que volver a calcular descriptores de seguridad para todos los objetos de la
base de datos.

Configuracin de permisos de acceso a objetos de AF

Permiso Definicin
Leer Capacidad de leer o consultar el objeto. Sin este
permiso, no es posible obtener el objeto.
Escribir Capacidad de crear y modificar un objeto. La
excepcin es que los marcos de evento y las
transferencias requieren el permiso Escribir datos
para la plantilla de elementos a partir de la cual se
crean y los casos requieren el permiso Escribir
datos para el anlisis en el que estn contenidos.
Asimismo, si los usuarios no tienen el permiso
Escribir en la base de datos de AF, no podrn
modificar ningn objeto en la base de datos,
independientemente del permiso especfico que
tengan para ese objeto.
Eliminar Capacidad para eliminar un objeto.
Admin Capacidad para modificar los valores de seguridad,
o el propietario, de un objeto.
Leer datos Capacidad para leer valores que no son de
configuracin y que proceden de atributos de
elementos. 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
anlisis especfico.
Escribir datos Capacidad para escribir valores que no son de
configuracin en los atributos de un elemento.
Asimismo, este permiso controla si un usuario
puede crear o modificar marcos de evento o
transferencias creados a partir de una
determinada plantilla de elementos de
transferencia. Del mismo modo, controla si un
usuario puede crear o modificar casos en un
anlisis especfico.
Ejecutar Capacidad para ejecutar casos de anlisis.
Suscribir Capacidad para suscribirse uno mismo a
notificaciones o anular la suscripcin.
Suscibir a otros Capacidad para suscribir a otros a notificaciones o
anular la suscripcin.
Cundo utilizar la opcin Deny

Seleccione la opcin Deny en los siguientes casos:
Para excluir un subconjunto de un grupo que tiene otorgados permisos.

Para excluir un permiso especial cuando ya haya otorgado control total a un usuario o a un
grupo.
Nota:
PI Module Database no admite la opcin Deny. Si utiliza PI MDB y PI AF, evite la opcin
Deny para evitar problemas de sincronizacin.

Configurar permisos para colecciones

Puede asignar permisos de acceso predeterminados para cada tipo de coleccin de una base de
datos de PI AF. Por ejemplo, puede asignar permisos de acceso predeterminados para todas las
tablas de la base de datos. La seguridad se basa en las identidades de Windows. Los permisos
de acceso definidos en una coleccin:
Controlan si un usuario dispone de permiso para crear objetos en la coleccin

Se utilizan como permisos de acceso predeterminados para los objetos creados en la
coleccin.
Procedimiento
1. Abra PI System Explorer y pulse el botn Biblioteca en el panel del navegador.
2. Pulse con el botn secundario en la base de datos de PI AF (el objeto raz del navegador),
seleccione Seguridad y, a continuacin, el tipo de coleccin deseado. Se mostrar la ventana
Permisos.
3. Configure los permisos correspondientes a la coleccin.
4. Para configurar los permisos de los miembros existentes de una coleccin, haga clic en
Avanzado. Se mostrar la ventana Configuracin de seguridad avanzada.
5. Marque la casilla Reemplazar entradas de permiso.
6. Seleccione la entrada de permiso y haga clic en Editar.
7. Especifique los permisos, cuya descripcin se encuentra en Configurar permisos para
objetos.
Asociacin de datos con activos

Para asociar datos con un activo, cree atributos en el elemento que representen ese activo.
Los atributos pueden incluir valores simples que representen informacin fija, como el
dimetro de un tanque. Tambin pueden incluir valores procedentes de PI Points, derivarse de
frmulas o incluir datos que no son de PI System utilizando tablas de PI AF.
En lugar de crear atributos en cada elemento, comience por crear plantillas de atributos en una
plantilla de elementos. A continuacin, cuando cree elementos basados en esa plantilla, PI AF
crear automticamente los atributos por usted. No obstante, tendr que otorgar un valor a
cada atributo.
Tenga en cuenta que si necesita un atributo para incluir solo valores predefinidos, podr
utilizar un conjunto de enumeracin. Un conjunto de enumeracin correlaciona un conjunto
ordenado de valores de constante definidos por el usuario con un conjunto de cadenas. Puede
utilizar las cadenas para suministrar un texto breve y descriptivo que se puede utilizar con el
modelo de AF.
En esta seccin
Crear una plantilla de atributos
Trabajo con conjuntos de enumeracin
Definicin de valores de atributos de constante
Configuracin de referencias de datos

Crear una plantilla de atributos

Procedimiento
1. Seleccione la plantilla de elementos en el navegador y haga clic en la pestaa Plantillas de
atributos del visor.
2. Pulse con el botn secundario sobre la plantilla de atributos y seleccione Nueva plantilla de
atributo en el men que aparece.
3. Escriba un nombre para la plantilla.
4. Especifique valores en los campos de configuracin, segn resulte necesario. Los campos
incluyen elementos de configuracin, elementos indexados, categoras y unidades de
medida. Para obtener ms informacin, consulte Atributos de configuracin, Atributos
indexados, Categoras y Unidades de medida (UOM).
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 cambiar.
5. Configure el tipo de valor que el atributo contendr.
En el caso de los atributos con valores de constante, configure el atributo Tipo de valor.
Los valores de atributos de constante pueden ser nmeros, cadenas, archivos, fechas-
horas, booleanos, URLs, matrices, etc.
Nota:
Aunque es un valor vlido, no se recomienda utilizar el tipo de valor Cualquiera.
En el caso de frmulas, valores de PI points, matrices de PI points y datos de tabla
(incluidos los datos de las bases de datos relacionales), haga clic en Ajustes para
configurar una referencia de datos.
Consulte Configuracin de referencias de datos para obtener informacin sobre la
configuracin de diferentes tipos de referencias de datos.
6. (Opcional) Introduzca un valor predeterminado para el atributo en el campo Valor
predeterminado.
Si crea un atributo tomando como base una plantilla, tendr que configurar el valor:
En el caso de los valores de constantes, aada el valor al atributo directamente. Consulte
Definicin de valores de atributos de constante.
En el caso de las referencias de datos, necesita crear la instancia de la referencia de datos.
Para ello, pulse con el botn secundario sobre el elemento y seleccione Crear o actualizar
referencia de datos. Para obtener ms informacin, consulte Crear o actualizar referencias
de datos.
Nota:
La configuracin del atributo puede en algunos casos limitar cmo se vern los datos en
las aplicaciones cliente, como PI ProcessBook o PI Coresight. Consulte Restricciones de
visualizacin de los datos de serie temporal para obtener ms informacin.

Aadir un atributo a un elemento

En algunas ocasiones, es posible que desee aadir otro atributo a un elemento existente.
Si el elemento se basa en una plantilla que admite ampliaciones, podr definir atributos
adicionales en el propio elemento, independientemente de la plantilla. Si se basa en una
plantilla que no admite ampliaciones, no podr aadir atributos nuevos.
Procedimiento
1. Seleccione el elemento en el navegador y haga clic en la pestaa Atributos del visor.
2. Pulse con el botn secundario en el campo y seleccione Nuevo atributo en el men que
aparece.
3. Configure el tipo de valor que el atributo contendr:
Para atributos con valores de constante establezca el atributo Tipo de valor. Esta
configuracin determinar los valores que puede introducir en el campo Valor.
Los valores de atributos de constante pueden ser nmeros, cadenas, archivos, fechas-
horas, booleanos, URLs, matrices, etc.
Nota:
Aunque est admitido, no se recomienda utilizar el tipo de valor Cualquiera.
Tambin puede introducir un valor predeterminado para el atributo en el campo Valor
predeterminado.
En el caso de frmulas, valores de PI points, matrices de PI points y datos de tabla
(incluidos los datos de las bases de datos relacionales), haga clic en Ajustes para
configurar una referencia de datos.
Consulte Configuracin de referencias de datos para obtener informacin sobre la
configuracin de diferentes tipos de referencias de datos.
4. Defina los dems campos de configuracin, segn resulte necesario. Los campos incluyen
elementos de configuracin, elementos indexados, categoras y unidades de medida. Para
obtener ms informacin, consulte Atributos de configuracin, Atributos indexados,
Categoras y Unidades de medida (UOM).
Trabajo con conjuntos de enumeracin

Los conjuntos de enumeracin se utilizan normalmente para definir una lista de valores
predefinidos para una plantilla de atributos. Cuando configure atributos a partir de esa
plantilla, podr seleccionar el valor de la lista.
Por ejemplo, supongamos que dispone de una plantilla de atributos que almacena el nmero de
modelo de una pieza de equipo. Puede crear un conjunto de enumeracin que contenga todos
los nmeros del modelo correspondientes. Cuando cree un elemento con la plantilla,
simplemente seleccione en la lista el nmero de modelo correspondiente.

Crear un conjunto de enumeracin
Procedimiento
1. En el navegador, pulse con el botn secundario sobre la coleccin de conjuntos de
enumeracin y seleccione Nuevo conjunto de enumeracin. En el visor se mostrar la
pestaa de configuracin de propiedades General del conjunto de enumeracin.
2. Configure las siguientes propiedades:
En el campo Nombre, introduzca el nombre del conjunto.
En el campo Descripcin, introduzca una descripcin del conjunto (opcional).
Seleccione la casilla de verificacin Hexadecimal para los valores hexadecimales.
3. Introduzca valores y nombres y una descripcin opcional de cada miembro del conjunto de
enumeracin.
El nombre es una cadena exclusiva que describe la condicin o el estado representados. El
nombre es el procedimiento preferido para acceder a una enumeracin. El valor es un valor
numrico exclusivo que est tambin asociado con la enumeracin. Se utiliza para
proporcionar una representacin ms rpida y que requieremenos memoria de un valor de
la enumeracin.
Volver a numerar un conjunto de enumeracin
Procedimiento
1. Pulse con el botn secundario en cualquier lugar del campo y seleccione Renumerar valores
de enumeracin. Se mostrar el cuadro de dilogo Renumerar valores de enumeracin.
2. Introduzca el valor inicial y un incremento.

Nota:
Si selecciona una fila antes de la renumeracin, esta se iniciar en la fila seleccionada,

que tomar el valor inicial, y cada fila siguiente adoptar el siguiente valor de
incremento. Solo la fila seleccionada y las siguientes se modificarn durante una
accin de renumeracin. Si la renumeracin no se inicia en la fila que est ms arriba,
existe la posibilidad de que los valores generados sean idnticos a los que estn por
encima de la fila seleccionada. En este caso, se mostrar el siguiente mensaje de
error:Attempting to change the enumeration values would overlap
previous enumeration values prior to the selected row.
Definicin de valores de atributos de constante

Asigne valores de constante directamente en el atributo.
En la plantilla de atributos no se pueden definir valores de atributo, pero s valores
predeterminados. Para obtener ms informacin sobre cmo definir valores predeterminados,
consulte Crear una plantilla de atributos.
Procedimiento
1. En el visor, utilice la lista desplegable Tipo de valor para seleccionar el tipo de datos del
atributo. Existen cuatro grupos de tipos de valor:
Tipos bsicos
Tipos de matriz
Una matriz contiene cualquiera de los tipos bsicos como elementos.
Conjuntos de enumeracin
Un conjunto de enumeracin es una lista de valores de constante definidos por el usuario.
Los conjuntos de enumeracin se utilizan normalmente para definir una lista de valores
predefinidos para una plantilla de atributos. Cuando configure atributos basados en esa
plantilla, podr seleccionar el valor en la lista. La opcin de men Conjuntos de
enumeracin permite seleccionar cualquiera de los conjuntos de enumeracin que se han
creado en la base de datos de AF.
Objetos
Un objeto puede ser otro atributo o elemento de AF o un archivo de sistema operativo.
2. Haga clic en el campo Valor.
El formato del campo Valor vara segn el Tipo de valor.
3. Configure el valor del atributo como se describe en el procedimiento correspondiente al
tipo de atributo.
En esta seccin
Configurar un valor bsico
Configurar un valor de matriz
Configuracin de un valor de conjunto de enumeracin
Configurar un valor de objeto
Configurar un valor bsico

Una vez haya configurado Tipo de valor en uno de los tipos de datos bsicos, podr definir el
valor del atributo.

Procedimiento
1. Haga clic en el campo Valor. El formato del campo cambia segn el tipo de valor:
Tipo de valor Formato de valor de campo
Boolean Alternancia entre Verdadero y Falso
Byte Campo de entrada de enteros positivos
DateTime Selector de fecha y hora
Double Campo de entrada de numrico de coma flotante
Guid Mscara del GUID
Intnn Campo de entrada de enteros
Sencillo Campo de entrada de numrico de coma flotante
String Campo de entrada de texto
2. Introduzca el valor del atributo en el campo Valor. PI System Explorer resuelve los datos
que ha introducido al guardar los cambios y enva el valor resultante a PI AF. Por ejemplo,
para DateTime, enva la fecha y hora resultantes.
Ejemplo
Si el tipo de valor es DateTime, 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 vlidas:
*-5d
May 12, 2009
07 06 2010 10:00:00 AM
09 14 2008 14:00:00
Para crear un atributo con un vnculos como valor, seleccione el tipo de valor String e
introduzca la direccin URL como valor de atributo. Las cadenas reconocidas como direcciones
URL absolutas se mostrarn como un enlace. Por ejemplo, las cadenas que empiezan por
http://,ftp://,file:// y www. se reconocen como enlaces, en tanto que las cadenas que
empiezan por C:\ y abc.com no se reconocen como tales. En PI System Explorer, los vnculos
se muestran subrayados y con una informacin sobre herramientas asociada.
Configurar un valor de matriz

Una vez haya configurado Tipo de valor en uno de los tipos de datos de matriz, puede definir el
valor del atributo.
Procedimiento
1. Haga clic en el campo Valor. Se mostrar un botn en el extremo derecho del campo
Valor.
2. Haga clic en . En el cuadro de dilogo Matriz, defina la matriz. El campo Valor se
configurar con el formato correspondiente al tipo de datos que seleccione para los
elementos de matriz.
Boolean Alternancia entre Verdadero y Falso
Byte Campo de entrada de enteros positivos
DateTime Selector de fecha y hora
Double Campo de entrada de numrico de coma flotante
Guid Mscara del GUID

Intnn Campo de entrada de enteros

Sencillo Campo de entrada de numrico de coma flotante
Cadena Campo de entrada de texto
3. Haga clic en Aceptar. PI System Explorer resuelve los datos que ha introducido al guardar
los cambios y enva los valores de matriz resultantes a PI AF.
Configuracin de un valor de conjunto de enumeracin

Si selecciona un conjunto de enumeracin en Tipo de valor, elija el valor del atributo entre los
elementos de ese conjunto.
Procedimiento
1. Haga clic en el campo Valor. El campo Valor se convierte en una lista desplegable que
permite seleccionar valores de ese conjunto de enumeracin.
2. Seleccione el valor que desee. Cuando guarde los cambios, PI System Explorer enviar el
valor resultante a PI AF.
Configurar un valor de objeto

Una vez haya configurado Tipo de valor en uno de los tipos de datos de objeto, podr definir el
valor del atributo.
Procedimiento
1. Haga clic en el campo Valor. El botn de accin situado a la derecha cambia segn el tipo de
valor:
<Cualquiera> Aunque es un valor vlido, no se recomienda
utilizar el tipo de valor Cualquiera.
Atributo Un botn Explorar que abre Bsqueda de
atributos
Elemento Un botn Explorar que abre Navegador de
elementos
Archivo Una flecha que apunta hacia arriba
2. Seleccione el objeto que desea utilizar y haga clic en Aceptar. Cuando guarde los cambios, PI
System Explorer enviar el valor resultante a PI AF.
Preste atencin al cargar los archivos

Si especifica el Tipo de valor Archivo antes de cargar un archivo, ejecute un anlisis antivirus
para asegurarse de que el tamao del archivo no sobrepase el espacio de almacenamiento.
Algunos tipos de archivo pueden plantear problemas de seguridad. Aparecer un mensaje de
aviso preguntndole si 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.
Configuracin de referencias de datos

Puede configurar un atributo o una plantilla de atributos para obtener valores de orgenes
especificados. Esta configuracin se denomina referencia de datos y los atributos que
contienen estas referencias se denominan atributos de referencia de datos. Puede crear una
referencia de datos para los siguientes orgenes:

PI point
Puede configurar la referencia de datos para que utilice el valor del PI point o el valor de
resumen de otras operaciones en el valor de punto.
Matriz de PI point
Utilice una referencia de datos de matriz de PI point para generar un nico valor a partir de
una matriz de PI points.
Frmula
El valor de atributo es el resultado de un clculo. El clculo puede contener atributos e
incluso atributos de referencia de datos.
Bsqueda de tabla
La tabla se puede definir de forma interna, se puede importar desde una tabla externa (que
no es de PI) o se puede vincular a una tabla externa.
Generador de cadenas
Utilice parmetros de sustitucin y funciones para manipular los valores y generar una
cadena.
En esta seccin
Crear y hacer referencia a clculos
Referencias a datos de PI points
Referencias a matrices de PI points
Ejemplos de uso de la referencia de datos del generador de cadenas
Referenciar datos de tablas externas e internas en tablas de PI AF
Uso de parmetros en referencias de datos
Crear y hacer referencia a clculos

Utilice la referencia de datos de frmula para crear un clculo personalizado. Este clculo
puede ser una frmula o una secuencia de clculos. La referencia de datos de frmula puede
tener varios atributos de entrada.
En esta seccin
Configurar una referencia de datos de frmula
Definir parmetros
Definir la ecuacin
Unidades de medida en referencias de datos de frmula
Configurar una referencia de datos de frmula
Procedimiento
1. Seleccione el atributo en el visor.
2. En el men desplegable Referencia de datos, seleccione Frmula.
3. Haga clic en el botn Ajustes. Se mostrar la ventana de configuracin de referencias de
datos de frmula.

4. Si la ecuacin requiere un valor de atributo, haga clic en para aadirlo como parmetro
(Definir parmetros).
5. Seleccione la casilla Valores predeterminados admitidos para que PI AF pueda utilizar
valores predeterminados de atributo en el clculo. Los valores predeterminados se
especifican en la plantilla de atributos. Si anula la seleccin de la casilla de verificacin, el
clculo no se realizar si no estn disponibles los datos de uno o ms atributos.
6. Haga clic en para comenzar a definir la ecuacin (Definir la ecuacin).
7. En el campo Unidad de medida, especifique la unidad de medida del resultado de la frmula

o de la secuencia de clculo (Unidades de medida en referencias de datos de frmula).
8. En el campo Mnimo, introduzca un valor adecuado para el valor de devolucin mnimo. Si el
valor calculado es inferior a este mnimo, la referencia de datos devolver el valor mnimo
que especifique. Si no existe un valor mnimo para este clculo, deje el campo Mnimo en
blanco.
9. En el campo Mximo, introduzca un valor adecuado para el valor de devolucin mximo. Si
el valor calculado es superior a este mximo, la referencia de datos devolver el valor
mximo que especifique. Si no existe un valor mximo para este clculo, deje el campo
Mximo en blanco.
Nota:
Seleccione la casilla Escalonado para que el valor aparezca escalonado al trazarlo.

10. Haga clic en Evaluar para probar la referencia de datos. El valor devuelto por la secuencia de
clculo aparece en el campo adyacente. Cuando la referencia de datos de frmula se
configura con un atributo de plantilla, el clculo utiliza los valores predeterminados de los
atributos de plantilla. Cuando la configuracin se realiza con un atributo de elemento, se
utilizan los datos reales en el clculo.
12. Configure el resto de valores de atributo como lo hara con cualquier otro atributo.
Nota:
La referencia de datos de frmula no admite cadenas ni otros tipos de valor no

numrico.
Definir parmetros
Si la ecuacin requiere un valor de atributo, tendr que aadir ese atributo como parmetro en
el cuadro de dilogo Configuracin de frmula.
Procedimiento
1. Haga clic en junto al campo Parmetros. Aparecer la ventana Configuracin de
parmetros.
Nota:
Tambin, puede hacer clic en una fila vaca e introducir una variable (a -z).
2. Seleccione una variable en el men Variable. El nmero 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 men Atributo. En la lista se mostrarn todos los atributos

admitidos del mismo nivel.
Si el atributo que desea utilizar no est en el men, seleccione Otros. En la ventana se
mostrar un nuevo campo denominado Atributo. Haga clic en para seleccionar un
atributo del rbol. Tambin, 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. Esta unidad de medida NO es la
del atributo. Especifique la unidad de medida que la frmula requiere para esta entrada
(Unidades de medida en referencias de datos de frmula).
Por ejemplo, si el atributo de entrada tiene Celsius como unidad de medida pero la ecuacin
requiere Fahrenheit, deber seleccionar Fahrenheit en este campo.
Definir la ecuacin
Para definir la ecuacin en una referencia de datos de frmula:
Procedimiento
1. Haga clic en junto al campo Ecuaciones. Tambin puede hacer clic en el rea de texto y
escribir una ecuacin.

Se mostrar el botn .
2. Escriba la ecuacin o haga clic en para seleccionar variables, operadores y funciones de

un men. Los operadores vlidos y las funciones aparecen listados en Operadores de
referencias de datos de frmula y Funciones de referencia de datos de frmula.
Haga clic en para eliminar la ecuacin seleccionada de la secuencia de clculo.
Haga clic en para eliminar tiodas las ecuaciones de la secuencia de clculo.
Haga clic en o para subir o bajar una ecuacin en la secuencia de clculo.
En esta seccin
Operadores de referencias de datos de frmula
Funciones de referencia de datos de frmula
Operadores de referencias de datos de frmula

Los operadores vlidos ordenados jerrquicamente son:
Parenthesis
Unary Minus
^
* / mod
+ -
< > <= >= == <>
NOT
AND
OR
No se puede utilizar el operador de asignaciones = al comienzo de una frmula.

Nota:
Las sintaxis de referencia de datos de frmula utiliza == (dos signos de igual) para indicar
la igualdad y = (un solo signo de igual) para la asignacin. La sintaxis de anlisis (y la
ecuacin de rendimiento) utiliza = para indicar igualdad y := para la asignacin.
Puede seleccionar If-Then-Else, un operador compuesto con operandos utilizado del siguiente
modo:
If expr0 Then expr1 Else expr2
donde expr0,expr1 y expr2 son expresiones. Siexpr0 es verdadero, se devuelve el valor expr1; de
lo contrario, se devuelve el valor expr2.
Funciones de referencia de datos de frmula

Funcin Descripcin
abs(X) Valor absoluto de X.
acos(X) Arco coseno de X.
asin(X) Arcoseno de X.
atan(X) Arcotangente de X.
BadVal(x) Devuelve 1 si el valor tiene un estado incorrecto,
tiene un valor de punto flotante que no es de un
nmero (NaN) o no es un valor numrico; de lo
contrario, devuelve 0.
ceiling(X) Entero ms pequeo no inferior a X.
cos(X) Coseno de X.
cosh(X) Coseno hiperblico de X.
cot(X) Cotangente de X.
coth(X) Cotangente hiperblica de X.
csc(X) Cosecante de X.
csch(X) Cosecante hiperblica de X.
e() Valor del logaritmo base natural.
exp(X) Logaritmo base natural e elevado a la potencia de
X.
floor(X) Entero ms grande no superior a X.
ln(X) Logaritmo natural de X.
log(X) Logaritmos de X en base 10.
logbase(X,Y) Logaritmo de X en base Y.
max(X,Y) Mayor que X e Y.
min(X,Y) Menor que X e Y.
normalrnd(X,Y) Nmero aleatorio que asigna la curva de
distribucin normal. X es la media e Y es la
desviacin estndar.
pi() Valor de pi.
poisson(X) Valor aleatorio que asigna la distribucin de
Poisson. X es la media.
pow(X,Y) X elevado a la potencia de Y.
rand() Nmero aleatorio uniforme. Los valores pueden
estar entre 0 y menos de 1.0
rand(X,Y) Nmero aleatorio uniforme. Los valores pueden
estar entre X-Y/2 y menos de X+Y/2.

Funcin Descripcin
remainder(X,Y) Devuelve el resto de la divisin de X por Y.
round(X) X redondeado al valor entero ms cercano.
roundfrac(X,Y) X redondeado al nmero de dgitos fraccionarios
especificados por Y. Y es un nmero entero.
sec(X) Secante de X.
sech(X) Secante hiperblica 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 hiperblico de X.
sqrt(X) Raz cuadrada de X.
tan(X) Tangente X.
tanh(X) Tangente hiperblica de X.
Unidades de medida en referencias de datos de frmula

Cuando trabaje con frmulas y unidades de medida, tendr que configurar las entradas y
salidas de las ecuaciones con la unidad de medida correcta.
Para los atributos de la ecuacin, utilice la unidad de medida que la frmula espera (NO las
unidades en las que est el atributo).
Para el resultado del clculo, la unidad de medida en la que desea que aparezca el resultado.
Esta unidad de medida debe ser coherente con las unidades de medida de las entradas
(valores de atributo).
Por ejemplo, plantese la siguiente configuracin de frmula 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 frmula
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.
Referencias a datos de PI points

Una data reference de PI point es una referencia procedente de un atributo de AF a un PI point.
El valor del atributo de la referencia de datos podra ser igual que el valor de punto o el
resultado de un clculo sobre valores de punto. Puede crear referencias de datos de PI point
para:
un atributo de elemento o una plantilla de atributos

un atributo de transferencia o una plantilla de atributos
un atributo de marco de evento o una plantilla de atributos
Las referencias de PI point para las plantillas de atributos tienen algunas caractersticas extra.
Al crear una referencia de datos de PI point en una plantilla de atributos, podr:

Crear de forma automtica tags referenciados por atributos basados en esta plantilla.
Crear un esquema de nombre para los atributos basados en esta plantilla de forma que los
atributos creados a partir de ella tengan nombres exclusivos que sigan una estructura
coherente.
En esta seccin
Configuracin de los pasos bsicos de las referencias de datos de PI points
Especificacin del PI point
Configuracin de valores de atributo
Consideraciones relativas a las unidades de medida
Permitir que los atributos escriban en los valores de punto
Crear o actualizar referencias de datos
Indicador de atributo para ejecutar las opciones Crear o actualizar referencia de datos o
Crear o actualizar PI points
Configuracin de los pasos bsicos de las referencias de datos de PI points

Este procedimiento utiliza PI System Explorer para configurar una referencia de datos de PI
point en un atributo.
Nota:
Puede utilizar los resultados de Bsqueda de tags en la paleta para crear y configurar de
forma rpida nuevos atributos de referencia de datos de PI point. Para obtener ms
informacin, consulte Accin de arrastrar desde la Paleta para crear referencias de datos
de PI points.
Procedimiento
1. Seleccione el atributo en el visor.
2. En el men desplegable Referencia de datos, seleccione PI Point.
3. Haga clic en el botn Ajustes. Se mostrar la ventana de configuracin de Referencia de
datos de PI Point.
4. Configure la referencia de datos:
a. Seleccione el punto para hacer referencia a l directamente o mediante la referencia a
otro atributo. Consulte Especificacin del PI point
b. Especifique cmo obtendr su valor el atributo. Por ejemplo, el valor de atributo podra
ser igual que el valor de punto o el resultado de un clculo sobre el valor de punto. Vase
Configuracin de valores de atributo.
c. Especifique las unidades que utiliza el PI point referenciado (opcional). Vase
Consideraciones relativas a las unidades de medida.
d. Utilice la casilla de verificacin Solo lectura para especificar si desea que PI AF vuelve 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 verificacin Solo lectura est
seleccionada). Consulte Permitir que los atributos escriban en los valores de punto

Ubicacin de la casilla de verificacin Solo lectura en la esquina inferior izquierda
Accin de arrastrar desde la Paleta para crear referencias de datos de PI points

Puede arrastrar un tag desde los resultados de Bsqueda de tags en la Paleta para crear una
referencia de datos de PI point. Cuando cree un atributo arrstrelo al campo Ajustes para
configurar el atributo como una referencia de datos de PI point basada en el tag. Tambin,
puede arrastrarlo a la lista Atributos del visor para crear un atributo configurado como una
referencia de datos de PI point basada en el tag.
Procedimiento
1. Seleccione Elementos en el panel del navegador.
2. Seleccione un elemento en el rbol de navegacin y seleccione su pestaa Atributos en el
visor.
3. Seleccione Ver > Paleta > Bsqueda de tags y localice los tags que desea utilizar.
4. Realice una de las siguientes acciones:
Arrastre un tag desde los resultados de bsqueda a la lista Atributos. Se aadir a la lista
un nuevo atributo configurado como una referencia de datos de PI point basada en el tag.
Haga clic en Nuevo atributo en la barra de herramientas y arrastre el tag desde los
resultados de bsqueda al campo Ajustes para configurar el atributo como una referencia
de datos de PI point basada en el tag.
5. Haga clic en Ingresar para guardar la nueva referencia de datos.
Especificacin del PI point

Para hacer referencia al PI point, dispone de dos opciones:
Referencia directa
Especifique un PI Server y un nombre de punto.
Referencia indirecta
Haga referencia a otro atributo de referencia de datos de PI point.

En esta seccin
Crear una referencia a un PI Server y a un nombre de punto
Referencias de atributo (referencias indirectas)
Crear una referencia a travs de un atributo
Crear una referencia a un PI Server y a un nombre de punto

La forma ms frecuente de configurar una referencia de datos de PI point es especificar un
nombre de PI point y un PI Server.
Procedimiento
1. En la ventana Referencia de datos de PI Point, seleccione la opcin Nombre de tag.
2. Seleccione un PI Server en el men desplegable PI Server.
Nota:
Si el PI Server deseado no aparece en el men, haga clic en para abrir PI

Connection Manager. Utilice PI Connection Manager para aadir el PI Server. Para
obtener instrucciones, pulse el botn Ayuda situado en la parte superior del cuadro de
dilogo.
3. Escriba el nombre del punto en el campo Nombre de tag o haga clic en para buscar un
punto en el PI Server seleccionado.
Referencia directa a SINUSOID en MyPIServer
Uso de parmetros de sustitucin
En el caso de las plantillas de atributos, puede utilizar parmetros de sustitucin en los

campos PI Server y Nombre de tag. Vase Lista de parmetros de sustitucin de PI AF.

Referencias de atributo (referencias indirectas)

Puede configurar una referencia de datos de PI points para sealar 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 resultar til
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 mximo y mnimo del tanque. Si configura los tres
atributos para hacer referencia al atributo Level, podr cambiar posteriormente el atributo
Level para que haga referencia a otro punto y no tener que volver a configurar los atributos
secundarios.
Crear una referencia a travs de un atributo
Procedimiento
1. En la ventana Referencia de datos de PI Point, seleccione la opcin Atributo.
2. Escriba una ruta relativa al atributo o elija una del men desplegable.
El men muestra una lista de los atributos que tienen referencias de datos de PI Point.
Para escribir una ruta, utilice la sintaxis descrita en Referencia indirecta.

Nota:
No podr hacer referencia a un atributo que no haga referencia a un PI point.

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 tambin un contexto
de intervalo de tiempo (en la pantalla debe estar presente un smbolo de intervalo de tiempo,
como por ejemplo una tendencia, para permitir la recepcin de un intervalo de tiempo).
Configure, por lo general, la referencia de datos para que espere una hora o un intervalo de
tiempo. El valor de atributo ser entonces:
El valor del punto a una hora especfica. Vase Configurar la obtencin de valores por hora.
El resultado de un clculo de los valores del punto a lo largo de un intervalo de tiempo.
Vase Configurar la obtencin 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.
En esta seccin
Configurar la obtencin de valores por hora
Configurar la obtencin de valores por intervalo de tiempo
Configurar la obtencin de valores por hora

Las solicitudes de un valor de atributo por parte de las aplicaciones cliente incluyen una hora.
Especifique cmo debe interpretarse esa hora para obtener los valores del atributo.
Procedimiento
1. Seleccione una opcin en el men desplegable Por tiempo.

Despus
Devuelve el primer valor registrado despus de la hora solicitada por la aplicacin
cliente.
En o Antes
Seleccione esta opcin para devolver un valor registrado en la hora de la solicitud de la
aplicacin cliente. Si no existe ningn valor en la hora especificada, se devuelve el valor
registrado anterior.
En o Despus
Seleccione esta opcin para devolver un valor registrado en la hora de la solicitud de la
aplicacin cliente. Si no existe ningn valor a la hora especificada, se devuelve el
siguiente valor registrado.
Automtico
Seleccione esta opcin para que un punto continuo (atributo step = 0) se considere como
interpolado; un punto discreto (atributo step = 1) se considera como "En o Antes".
Antes
Devuelve el primer valor registrado antes de la hora de la solicitud de la aplicacin
cliente.
Hora exacta
Seleccione esta opcin para devolver un valor registrado justo en la hora de la solicitud
de la aplicacin cliente. Si no existe ningn valor registrado para esa hora, se devuelve un
error.
Interpolado
Seleccione esta opcin para devolver un valor interpolado para la hora de la solicitud de
la aplicacin cliente. Los puntos discretos (atributo step = 1) arrastran el valor anterior.
Nota:
No seleccione las opciones No admitido, Intervalo de tiempo o Anular intervalo de
tiempo. Estas opciones son para valores de atributo basados en clculos de intervalos
de tiempo.
2. Deje la casilla de verificacin Tiempo relativo sin seleccionar, excepto si desea Configurar un
retardo.
3. En el men desplegable Por intervalo tiempo, seleccione Hora de finalizacin.
Si la aplicacin cliente enva un intervalo de tiempo en lugar de una hora concreta, PI AF
devolver un mensaje de error como valor de atributo.
Configurar un retardo
Si se ha configurado el atributo para que devuelva el valor a una hora determinada, puede
configurar un retardo respecto de la hora solicitada. Esto puede resultarle til cuando cree
atributos con retardo de tiempo muerto.
Procedimiento
1. Configure el ajuste Recuperacin de valor paraConfigurar la obtencin de valores por hora.
2. En el recuadro Tiempo relativo, introduzca el tiempo relativo del retardo. Utilice una
expresin de tiempo relativa. Vase Tiempo relativo.

Nota:
Puede utilizar parmetros de sustitucin para leer el tiempo relativo a partir del valor
de otro atributo. Vase Referenciar un valor de atributo.
Configurar la obtencin de valores por intervalo de tiempo

Si desea que el valor de atributo sea el resultado de un clculo resumido a lo largo de un
perodo de tiempo, configure la obtencin de valores por intervalo de tiempo.
Procedimiento
1. Seleccione una de estas opciones en el men desplegable Por tiempo.
No admitido
Si la aplicacin cliente enva una hora en lugar de un intervalo de tiempo, PI AF devolver
un mensaje de error como valor de atributo.
Intervalo de tiempo
Cree un intervalo de tiempo predeterminado para utilizar si la aplicacin cliente enva
una hora, en lugar de un intervalo de tiempo. Si selecciona esta opcin, debe escribir una
expresin de tiempo relativa de PI en el campo Tiempo relativo. Consulte Creacin de un
intervalo de tiempo predeterminado para obtener ms detalles.
Anular intervalo de tiempo
Especifique el intervalo de tiempo que sustituir siempre al intervalo de tiempo
especificado por la aplicacin cliente. Puede especificar una duracin fija para el rango
(Crear un intervalo de duracin configurable) o calcular la duracin de forma dinmica
(Configurar clculos de intervalos de tiempo dinmicos).
2. Seleccione una de estas opciones en el men desplegable Por intervalo tiempo:
Promedio
El valor promedio a lo largo del intervalo de tiempo.
Recuento
Si establece Base de clculo en Ponderado a evento, el valor de Recuento representa el
recuento de eventos a lo largo del intervalo de tiempo. Si selecciona en Base de clculo
una de las opciones ponderadas en tiempo, el valor de Recuento representar la suma de
la duracin de los eventos a lo largo del intervalo de tiempo.
Delta
La diferencia entre el valor al final del intervalo de tiempo respecto al del principio.
Mximo
El valor mximo a lo largo del intervalo de tiempo.
Mnimo
El valor mnimo a lo largo del intervalo de tiempo.
Desviacin estndar de poblacin
Seleccione la desviacin estndar de la poblacin a lo largo del intervalo de tiempo.
Desviacin estndar
Seleccione la desviacin estndar a lo largo del intervalo de tiempo.

Hora de inicio

Devuelve el valor de la hora de inicio del intervalo de tiempo.

Nota:
Si selecciona Hora de inicio, no podr elegir la opcin No admitido en el men Por

tiempo. Si lo hace, obtendr el siguiente mensaje de error:The TimeMethod must
be supported to support the TimeRangeMethod of "Start Time".
Hora de finalizacin
Devuelve el valor del final del intervalo de tiempo.
Total
El total a lo largo del intervalo de tiempo.
3. Si el men desplegable Base de clculo est activo, seleccione una de estas opciones:

Ponderado a evento
Seleccione esta opcin para evaluar valores con una ponderacin equivalente para cada
evento. No se realiza ninguna interpolacin. Para que el clculo sea correcto, deben haber
como mnimo un evento dentro del intervalo de tiempo. Se necesitan dos eventos para
calcular la desviacin estndar.

Ponderado en tiempo
Seleccione esta opcin para ponderar los valores del clculo a lo largo del intervalo
durante el cual se aplican. La interpolacin se basa en el atributo step del punto. Los
eventos interpolados se generan en los lmites si es necesario.
Nota:
Si selecciona la opcin Ponderado en tiempo para un total, las unidades de origen

se convierten a un ndice. Seleccione una unidad de tiempo en el men desplegable
que aparece junto al campo Unidades origen.

Ponderado en tiempo continuo
Seleccione esta opcin para aplicar la ponderacin como en Ponderado en tiempo, pero
realizar todas las interpolaciones entre valores como si representaran datos continuos
(interpolacin estndar), independientemente del atributo step del punto.
Nota:
Si selecciona la opcin Ponderado en tiempo continuo para un total, las unidades

de origen se convierten a un ndice. Seleccione una unidad de tiempo en el men
desplegable que aparece junto al campo Unidades origen.

Ponderado en tiempo discreto
Seleccione esta opcin para aplicar la ponderacin como en Ponderado en tiempo, pero
realizar las interpolaciones entre valores como si representan valores discretos y no
relacionados (plot escalonado), independientemente del atributo step del punto.
Nota:
Si selecciona la opcin Ponderado en tiempo continuo para un total, las unidades

de origen se convierten a un ndice. Seleccione una unidad de tiempo en el men
desplegable que aparece junto al campo Unidades origen.

4. En el campo Mn porcent. correcto, introduzca un valor entre 0 y 100. Este porcentaje

representa el intervalo de tiempo mnimo durante el cual un valor debe ser correcto para
devolver un valor de resumen.
En esta seccin
Intervalos de tiempo para marcos de evento y transferencias
Crear un intervalo de duracin configurable
Configurar clculos de intervalos de tiempo dinmicos
Creacin de un intervalo de tiempo predeterminado
Intervalos de tiempo para marcos de evento y transferencias

Los marcos de evento y las transferencias, por su naturaleza, tienen un intervalo de tiempo
asociado. Cuando una aplicacin que realiza una llamada solicita un valor a un atributo, el valor
devuelto depender de la referencia de datos y de su configuracin:
Si la aplicacin que realiza la llamada no proporciona ningn contexto, PI AF calcular el

valor de atributo utilizando el intervalo de tiempo del marco de evento o transferencia. Por
ejemplo, si un atributo contiene un PI point configurado con una opcin de resumen de
intervalo de tiempo, el resumen se realizar a lo largo del intervalo de tiempo del marco de
evento o transferencia.
Si un atributo contiene un a PI point configurado con la opcin de tiempo predeterminada,
PI AF devuelve el valor del punto a la hora de finalizacin del marco de evento.
Si la aplicacin que realiza la llamada proporciona una marca de tiempo nica, PI AF
devuelve el valor a la hora especificada, aunque la hora est fuera del intervalo de tiempo
del marco de evento o la transferencia.
Si la aplicacin que realiza la llamada proporciona un intervalo de tiempo, PI AF utiliza la
interseccin del intervalo de tiempo proporcionado y el del marco de evento. Si no hay
ninguna interseccin, se devolver un evento de "Sin datos".
El rea sombreada de la ilustracin que figura a continuacin muestra la interseccin entre
el intervalo de tiempo de un marco de evento y un intervalo de tiempo solicitado. Para los
atributos que contienen un PI point configurado con una opcin de resumen de intervalo de
tiempo, el resumen se realizar a lo largo de esta interseccin. Si el atributo contiene un PI
point configurado solo con la opcin de tiempo predeterminada, el valor se devolver a la
hora de inicio de la interseccin.

Crear un intervalo de duracin configurable

Para garantizar que el intervalo de tiempo tenga siempre la misma duracin, puede configurar
una anulacin de intervalo de tiempo.
Por ejemplo, para crear una media acumulada de una hora, tendra que utilizar los siguientes
ajustes:
En el men desplegable Por tiempo, seleccione Anular intervalo de tiempo.

En el campo Tiempo relativo, escriba: -1h
Procedimiento
1. En el men desplegable Por tiempo, seleccione Anular intervalo de tiempo.
2. En el campo Tiempo relativo, escriba una expresin de tiempo relativa de PI (Tiempo
relativo).
AF crear un intervalo de tiempo en funcin de la hora de finalizacin suministrada por la
aplicacin cliente y el desplazamiento definido por el tiempo relativo,
Nota:
Puede utilizar parmetros de sustitucin para leer el tiempo relativo a partir del valor
de otro atributo. (Referenciar un valor de atributo). En este caso, PI AF evala el valor
del atributo referenciado en el momento de cada solicitud de datos.
Por ejemplo, para crear una media acumulada de una hora, tendra que utilizar los siguientes
ajustes:
En el men desplegable Por tiempo, seleccione Anular intervalo de tiempo

En el campo Tiempo relativo, escriba: -1h
En la lista Por intervalo de tiempo, seleccione Promedio.
Con esta configuracin, la referencia de datos siempre calcula una media de una hora, incluso
aunque la aplicacin cliente especifique un intervalo de tiempo diferente.

Configurar clculos de intervalos de tiempo dinmicos

Puede utilizar un atributo de AF para calcular el intervalo de tiempo en funcin de factores
variables Los valores de atributo deben ser tiempos relativos de PI vlidos (Tiempo relativo).
Puede utilizar posteriormente el valor de atributo para determinar el intervalo de tiempo de
forma dinmica.
Procedimiento
1. Configure un atributo para generar tiempos relativos de PI. El atributo puede hacer
referencia a un conjunto de enumeracin que contenga tiempos relativos de PI o puede
crear tiempos relativos de PI en funcin de un clculo.
2. Utilice la siguiente recuperacin de valores para configurar la referencia de datos de PI
points:
a. En el men desplegable 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 mtodo de clculo..
Resultados
Con esta configuracin, 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 finalizacin variable para ver un ejemplo paso a paso.
En esta seccin
Ejemplo de hora de finalizacin variable
Tiempo relativo
Ejemplo de hora de finalizacin variable

En este ejemplo, se crea una referencia de datos con una hora de finalizacin variable.
Procedimiento
1. Cree un conjunto de enumeracin, MyEnumSet, que contenga estos tres valores:
-30m
-1h
-2h

Nota:
Los valores deben ser expresiones de tiempo relativo de PI (Tiempo relativo).

2. Cree un atributo, denominado TimeRangeAttribute, que haga referencia a MyEnumSet. Para
ello, en la lista Tipo de valor, seleccione Conjuntos de enumeracin > MyEnumSet.
3. Cree otro atributo, denominado DataReferenceAttribute. Configure una referencia de datos
para el atributo del siguiente modo:
a. Para el PI point, seleccione cualquier punto que tenga un valor numrico. En este
ejemplo, utilizaremos el punto sinusoidal de un PI server denominado PISRV1.
b. En el men desplegable Por tiempo, seleccione Anular intervalo de tiempo.
c. En el campo Tiempo relativo, escriba:
%@TimeRangeAttribute%
d. En el men desplegable Por intervalo tiempo, seleccione Promedio.
Referencia de datos de PI points completada
Resultados
Ahora podr utilizar el atributo TimeRangeAttribute como men desplegable para seleccionar
el intervalo de tiempo del clculo.

Tiempo relativo
Las expresiones de tiempo relativo son expresiones que tienen un nmero de das (d), horas
(h), minutos (m) o segundos (s) especificado con un signo ms (+) o menos (-) delante. El punto
de inicio predeterminado del tiempo relativo es el tiempo actual. Por lo tanto, un tiempo
expresado como -8h significa ocho horas antes de la hora actual. Se admiten tiempos
fraccionarios. Por ejemplo, utilice -1.5d para indicar un da y medio. Todos estos son tiempos
relativos vlidos:
+1d
-24h
-3.25m
+24s
Las expresiones de tiempo relativo pueden incluir solo un operador: + o -. Por ejemplo, esta
expresin no es vlida:
-1d+1h
Creacin de un intervalo de tiempo predeterminado

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 aplicacin cliente
proporciona una hora concreta en lugar de un intervalo de tiempo. Los atributos de marcos de
evento y de transferencia funcionan de forma distinta. Consulte Intervalos de tiempo para
marcos de evento y transferencias para obtener ms informacin.
Para crear un intervalo de tiempo predeterminado, utilice la siguiente configuracin de
recuperacin de valores:
En el men desplegable Por tiempo, seleccione Intervalo de tiempo.

En el campo Tiempo relativo, escriba una expresin de tiempo relativo de PI (Tiempo
relativo). AF crear un intervalo de tiempo en funcin de la hora especificada por la
aplicacin cliente y el desplazamiento definido por el tiempo relativo.
Nota:
Puede utilizar parmetros de sustitucin para leer el tiempo relativo del valor de otro
atributo (Referenciar un valor de atributo).
Por ejemplo, una mtrica de totalizacin requiere un intervalo de tiempo para proporcionar un
valor total. Si la aplicacin cliente enva una hora concreta, tendr que crear un intervalo de
tiempo de una hora que finalice en la hora especificada. Para ello, configure los siguientes
valores:
En el men desplegable Por tiempo, seleccione Intervalo de tiempo.

En el campo Tiempo relativo, escriba:

-1h
En el men desplegable Por intervalo tiempo, seleccione Total.
Consideraciones relativas a las unidades de medida

Al definir una referencia de datos de PI point, puede opcionalmente especificar las unidades
que utilizar el PI point referenciado. Si es posible, PI AF cambiar de forma automtica el tipo
de atributo a un tipo de valor compatible con las unidades especificadas.
Sin embargo, si el atributo se ha definido mediante una plantilla de atributos, PI AF no podr
cambiar el tipo. En su lugar, PI AF intentar convertir el valor en el tipo de valor de la plantilla.
Si PI AF no puede convertir el valor, generar un error.
Permitir que los atributos escriban en los valores de punto

Los atributos con referencias de datos de PI points pueden escribir valores en los PI points. En
el cuadro de dilogo de configuracin Referencia de datos de PI Point, la casilla de verificacin
Solo lectura determina si el atributo puede escribir datos en el PI point referenciado. La casilla
est seleccionada de forma predeterminada (Read only = True). Esto significa que el atributo
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
de punto. Por ejemplo, si el valor de atributo es el resultado de un clculo o de un anlisis,
podr actualizar el PI point con el resultado de ese anlisis. En este caso, debe anular la
seleccin de la casilla Solo lectura para permitir que el atributo escriba su valor en el punto.
Crear o actualizar referencias de datos

Cuando se crea un atributo basado en una plantilla con una referencia de datos, PI AF no crea
de forma automtica las referencias de datos de PI points asociadas con ese elemento. Para
crear las referencias de datos, pulse con el botn secundario sobre el elemento en el navegador
y seleccione Crear o actualizar referencia de datos en el men que se muestra. PI AF sustituye
entonces todos los parmetros de sustitucin por los valores correspondientes en ese
momento. PI AF crea y bloquea la referencia de datos. Cuando se bloquea una referencia de
datos:
Todos los cambios posteriores en una plantilla de atributos no se propagarn a los

elementos basados en esa plantilla.
PI AF no vuelve a evaluar los parmetros de sustitucin excepto si se actualiza la referencia
de datos.
Nota:
La nica excepcin es una referencia de valor de atributo en el campo Tiempo relativo.

Tras el bloqueo, puede pulsar con el botn secundario sobre el atributo del elemento y
seleccionar Restablecer a plantilla, seguido de la opcin Crear o actualizar referencia de datos
para restablecer el elemento a las propiedades de la plantilla. Esto resulta til si ha creado
elementos y plantillas en un entorno de prueba y desea transferir su trabajo a un entorno
operativo.
Indicador de atributo para ejecutar las opciones Crear o actualizar referencia de datos
o Crear o actualizar PI points
PI System Explorer utiliza distintos indicadores visuales para los atributos compatibles con la
opcin Crear o actualizar referencia de datos. Tambin se muestra un indicador visual cuando

la configuracin de un atributo deja de ser correcta; por ejemplo, despus de cambiar un

nombre de servidor o de tag.
Los siguientes indicadores visuales estn disponibles para la opcin Crear o actualizar
referencia de datos:
Icono Descripcin
El atributo se asocia con una plantilla que contiene reglas de creacin de puntos.
Utilice la opcin Crear o actualizar PI points para crear la configuracin de tags en
funcin de la plantilla. Asimismo, se resuelven el nombre y el ID del punto.
La configuracin de la referencia de datos del atributo no coincide con la que se
encuentra almacenada en la base de datos de AF. Esto se puede producir si se
cambia el nombre a un punto o se sustituye el PI Server subyacente. Utilice la
opcin Crear o actualizar PI points para actualizar la configuracin.
El atributo es un elemento de configuracin. Consulte Atributos de configuracin
para obtener ms informacin.
Nota:
La opcin Crear o actualizar referencia de datos no es aplicable a los
atributos de configuracin.
Cuando revise los atributos de elemento en la pestaa Atributos, la primera entrada de la

columna a la izquierda del nombre de un atributo de referencia de datos indica si puede
ejecutar la opcin Crear o actualizar referencia de datos . Inicie la opcin Crear o actualizar
referencia de datos haciendo clic con el botn derecho del ratn sobre un elemento o un
atributo y seleccionando Crear o actualizar referencia de datos.
La operacin 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 parmetros de sustitucin
se resuelven y los ID de servidor y de punto se actualizan. Si el PI point no existe todava, y la
configuracin contiene una opcin de creacin de punto, se crea.
Ejemplo de actualizacin de atributo

Cuando el indicador se muestre con un atributo, podr actualizar su configuracin pulsando
con el botn derecho del ratn y seleccionando la opcin Crear o actualizar PI points.
Nota:
El icono no determina por anticipado si se producir algn cambio en el tag o en su
configuracin.
Indicador de atributo con informacin sobre herramientas
Como indica la informacin sobre herramientas de ms arriba, cuando actualice la

configuracin, las reglas de sustitucin del nombre de punto se resolvern y el point ID se
almacenar en los metadatos del atributo. Esto permite una inicializacin posterior ms rpida.
Referencias a matrices de PI points

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 especificado se

corresponder con una entrada de la matriz. Configure la matriz de PI point como si fuera una
referencia de datos de PI point, salvo el campo Nombres de tag del cuadro de dilogo de
configuracin de referencias de datos. La referencia de datos de matriz de PI point le permite
seleccionar varios PI points. Haga clic en para buscar y seleccionar varios puntos en el PI
Server seleccionado o escrbalos directamente en el campo Nombres de tag. Los nombres de
punto deben estar separados por el smbolo de barra vertical (|). Por ejemplo:
CDM158|CDT158|SINUSOID
Ejemplos de uso de la referencia de datos del generador de cadenas

La referencia de datos Generador de cadenas permite aplicar funciones de manipulacin de
cadenas, como la concatenacin, con los valores de un atributo y generar una cadena con un
nuevo formato.
Nota:
Cuando se utiliza una referencia de datos Generador de cadenas en una plantilla, el valor
de sustitucin tiene lugar en tiempo de ejecucin.
Para crear una referencia de datos Generador de cadenas, siga estos pasos:
1. En la pestaa Atributos de un elemento, haga clic en Nuevo atributo.
2. En la lista desplegable, Referencia de datos, seleccione Generador de cadenas.
3. Haga clic en Ajustes. Se abrir la ventana Referencia de datos del generador de cadenas.
4. Haga clic en la fila resaltada y, a continuacin, en el botn de tringulo al final de la fila.
Dispone de un men de parmetros de sustitucin, valores de atributo y funciones de
cadena.
5. Seleccione una serie de elementos para generar la cadena de salida que necesite, como
muestran los ejemplos de este tema. Puede modificar la cadena de expresin segn vaya
crendola (cambiar los valores de parmetro predeterminados de una funcin, por
ejemplo).
A medida que vaya creando la expresin de cadena, el resultado se mostrar en el campo Valor
(en la parte inferior de la ventana Referencia de datos del generador de cadenas).
Puede construir una expresin en una nica lnea separando sus trminos con punto y coma.
Tambin puede colocar cada trmino en su propia lnea y eliminar el punto y coma, lo que hace
que la estructura de la expresin sea ms clara. Los primeros dos ejemplos de concatenacin
de valores ilustran estas tcnicas.
Nota:
A diferencia de otras funciones de cadena, la sintaxis de Format(DateTime, ... ) sigue la
sintaxis de C#.
Concatenacin de valores
Puede utilizar los parmetros de sustitucin para crear una cadena; por ejemplo un nombre de
ruta. Por ejemplo:
"%Database%";"\";"%Element%";"|";"%Attribute%";
Esta referencia de datos puede producir un resultado similar a: DB26\WX12000|pressure.

Nota:
Por lo general, deber incluir los parmetros de sustitucin entre comillas dobles para
que su resultado se considere como una cadena literal. De lo contrario, su resultado se
considerar como una ruta de atributo.

Un segundo ejemplo ilustra cmo crear una cadena para mostrar la duracin de un evento.
Despus de hacer clic en Ajustes y una vez abierta la ventana Referencia de datos del generador
de cadenas:
1. Pulse el icono de tringulo al final de la fila y en Parmetros de sustitucin, seleccione
%StartTime%.
2. Pulse el botn de nueva fila de frmula para aadir una fila nueva .
3. Escriba los caracteres: " to "

4. Pulse el botn de nueva fila de frmula para aadir una fila nueva .
5. Pulse el icono de tringulo y en Parmetros de sustitucin, seleccione %EndTime%.

6. Haga clic en Aceptar para guardar la nueva referencia de datos.
El campo Valor muestra un intervalo de fecha y hora; por ejemplo, 10/25/2013 14:31:06
to 10/25/2013 14:31:10.
Un tercer ejemplo de concatenacin obtiene la fecha y la hora actuales y anexa ms caracteres:
Format("%Time%","yyyy-MM-dd HH:mm:ss");" PM";
El resultado de la expresin es:2013-10-11 11:12:38 PM.
Extraccin de texto y manipulacin de maysculas y minsculas

Puede utilizar funciones para manipular las maysculas y minsculas de una cadena y extraer
determinadas secciones. Por ejemplo, para un atributo denominado GasPressure, la siguiente
expresin devuelve:GASPR:
Mid(UCase("%Attribute%"), 1, 5);
Para crear esta expresin, despus de hacer clic en Ajustes y con la ventana Referencia de datos
del generador de cadenas abierta:
1. Pulse el icono de tringulo al final de la fila y en Parmetros de sustitucin, seleccione
%Attribute%.
2. Haga clic en el tringulo y en Funciones, seleccione UCase(string)
3. Haga clic en el tringulo y en Funciones, seleccione Mid(string, start, length)
Otro ejemplo. Para un atributo denominado GasPressure, la siguiente expresin
devuelve:pressure:
Mid(LCase("%Attribute%"), 4, 8);
Limitacin del nmero de posiciones decimales

En el siguiente ejemplo, el valor se lee en el atributo denominado Attribute1, que est asignado
a un PI point denominado cdt158 y produce como resultado un valor de cadena que muestra
dos posiciones decimales:
Format('Attribute1', "%3.2f");
Por ejemplo, si cdt158 tiene el valor 66.67538, esta referencia de datos devuelve 66.68.
Nota:
Compruebe que el tipo de datos que especifique coincida con el tipo de datos de atributo.
Se produciran errores si, por ejemplo, especifica "%3.2f" para un valor de atributo de
tipo entero o "%3d" para un valor de atributo de coma flotante.

Referenciar datos de tablas externas e internas en tablas de PI AF

Puede configurar un atributo para que lea su valor de una tabla de PI AF. La tabla de PI AF
puede estar definida en su totalidad en PI AF o puede ser una tabla vinculada o importada de
una fuente de datos externa a PI System (por ejemplo, una tabla de Microsoft SQL o una hoja de
clculo de Microsoft Excel).
1. Crear una tabla de PI AF.

2. Defina y rellene los datos de la tabla de dos formas distintas:
Imprtelos de una tabla externa (no de PI System) o vinclelos a ella. Vase Importar o
vincular datos de Microsoft Access o Excel.
Defina y rellene de forma manual una tabla de PI AF. Vase Definicin y relleno manual
de una tabla de PI AF.
3. Configurar una referencia de datos de bsqueda de tabla.
En esta seccin
Crear una tabla de PI AF
Definicin y relleno manual de una tabla de PI AF
Referencias a datos desde fuera del PI System
Configurar una referencia de datos de bsqueda de tabla
Uso de parmetros en una consulta de tabla vinculada
Crear una tabla de PI AF
Procedimiento
1. En PI System Explorer, vaya a la biblioteca de la base de datos actual haciendo clic en
Biblioteca en el navegador.
2. Pulse con el botn secundario sobre la coleccin Tablas y seleccione Nueva tabla.
3. Haga clic en la pestaa General.
4. Seleccione la zona horaria de la tabla en el men desplegable del campo Zona horaria.
El campo Zona horaria indica la zona horaria de los valores DateTime dentro de la tabla.
5. Seleccione o deje sin marcar la casilla de verificacin Convertir a local.
Cuando el cliente consulte la tabla, la zona horaria en la que se muestran los valores
DateTime depender de si se ha seleccionado o no la casilla de verificacin Convertir a local.
En general:
Para convertir los valores DateTime a la hora local, seleccione la casilla Convertir a local.
Para que los valores DateTime se muestren siempre en la zona horaria del campo Zona
horaria, anule la seleccin de la casilla Convertir a local. Las horas de la tabla de PI AF se
mostrarn en la zona horaria especificada en el campo Convertir a local.
Nota:
El clculo de la zona horaria incluye varios factores. Para obtener informacin
detallada sobre los valores de conversin de la zona horaria, consulte Ajustes de
conversin de zonas horarias.
6. En el campo Intervalo de cach, introduzca el intervalo de tiempo que debe transcurrir para
que los datos almacenados en la memoria cach de la tabla se actualicen de forma

automtica. En el men desplegable, seleccione si el valor son segundos, minutos, horas o

das. El valor predeterminado es cero, lo cual indica que la funcin de actualizacin
automtica est desactivada.
Nota:
La actualizacin automtica se desactiva si la tabla tiene cambios que no se han
guardado en el servidor.
Nota:
Los campos Conexin y Consulta son de solo lectura. PI AF rellena estos campos al
vincular o importar una tabla externa.
8. Defina y rellene la tabla utilizando uno de estos tres procedimientos:
Importe una tabla externa fuera del servidor de PI AF.
Vincule una tabla externa fuera del servidor de PI AF.
Defina y rellene de forma manual la tabla en PI System Explorer.
Ajustes de conversin de zonas horarias

El clculo de conversin de la hora exacta depende de:
El valor que se haya seleccionado en la columna Zona horaria. Las opciones exactas que
aparecen en el men Zona horaria dependern del sistema operativo utilizado. Las horas
llevan el prefijo <UTC>, <GMT> o <TZ>. El men tambin incluye la opcin <Ninguna>.
Si ha seleccionado o no la casilla Convertir a local.
Si se trata de una tabla interna (importada o definida en PI AF) o externa (vinculada).
En la tabla siguiente se explica cmo se determinan las horas mostradas para cada
combinacin posible.
Zona horaria* Convertir a local Interna/Externa Comportamiento
<Ninguna> S Interna Los campos DateTime se
ajustan
automticamente en el
caso de diferencias de
zona horaria y estn en
las horas locales del
cliente.
<Ninguna> No Interna Los campos DateTime
no se convierten. Es til
para guardar campos de
fecha en los que no se
desea ninguna
conversin, por ejemplo,
las fechas de
cumpleaos.
<UTC> o <GMT> S Interna Los campos DateTime se
ajustan a las horas
locales en el cliente.
<UTC> o <GMT> No Interna Los campos DateTime se
representan siempre
como UTC.


<TZ> S Interna Los campos DateTime se
ajustan en el caso de
diferencias de zona
horaria y estn en la
hora local del cliente.
Esta combinacin no se
necesita, por lo general,
salvo durante la
importacin de datos
externos desde PI
System Explorer.
<TZ> No Interna Los campos DateTime se
dejan en la zona horaria
especificada. La
referencia de datos de
bsqueda de tabla se
ajustar como
corresponda; sin
embargo, puede que no
otras aplicaciones.
<Ninguna> S Externa Los campos DateTime se
suponen dentro de la
zona horaria del
servidor de AF y se
ajustan a la hora local
del cliente.
<Ninguna> No Externa Los campos DateTime
no se convierten. Es til
para los campos de
fecha en los que no se
desea ninguna
conversin, por ejemplo,
las fechas de
cumpleaos.
<UTC> o <GMT> S Externa Los campos DateTime se
guardan externamente
como UTC, pero se
ajustan a la hora local
del cliente.
<UTC> o <GMT> No Externa Los campos DateTime se
guardan externamente
como UTC y se dejan
como UTC en el cliente.
<TZ> S Externa Los campos DateTime se
ajustan en el caso de
diferencias de zona
horaria y se ajustan a la
hora local del cliente.


<TZ> No Externa Los campos DateTime se
dejan en la zona horaria
original especificada. La
referencia de datos de
bsqueda de tabla se
ajustar como
corresponda; sin
embargo, otras
aplicaciones puede que
no.
Las opciones exactas que aparecen en el men Zona horaria dependen del sistema operativo
utilizado.
Definicin y relleno manual de una tabla de PI AF
En esta seccin
Crear de forma manual una definicin de tabla
Rellenar una tabla de forma manual
Crear de forma manual una definicin de tabla

Rellene los valores del campo Definir tabla.
Procedimiento
1. En el campo Nombre, introduzca un nombre para la columna de tabla.
2. En la lista Tipo de valor, seleccione tipos de datos para las columnas de tabla.
3. En la lista Zona horaria, seleccione zonas horarias para las columnas de tabla.
4. En la lista Unidad de medida, seleccione unidades de medida para las columnas de tabla.
5. En la lista Usar imagen, seleccione una imagen para representar la columna.
Si una celda contiene una matriz de bytes, PI System Exploresr intenta mostrar la matriz
como una imagen.
Rellenar una tabla de forma manual

Rellene los valores de la pestaa Tabla.
Procedimiento
1. En funcin de las columnas de tabla que haya creado en la pestaa Definir tabla, introduzca
la informacin correspondiente en las filas de cada columna.
2. Opcional: Puede cortar y pegar filas enteras de una hoja de clculo Excel o en ella. Despus
de copiar varas filas de la hoja de clculo, pulse con el botn secundario en una nueva fila o
rango de filas de la tabla y seleccione Pegar.
Referencias a datos desde fuera del PI System

Utilice 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 o en otras fuentes de datos OLEDB/ODBC.
Puede importar la tabla o establecer un vnculo a ella.

1. Crear una tabla de PI AF.

2. Vincule o importe la tabla externa. Los pasos dependen del tipo de origen de datos al que
desee acceder:
Importar o vincular datos de Microsoft Access o Excel.
Importar o vincular datos de SQL Server.
3. Configurar una referencia de datos de bsqueda de tabla.
En esta seccin
Tablas importadas y vinculadas
Crear una conexin de tabla reutilizable
Autenticacin de tablas vinculadas
Importar o vincular datos de Microsoft Access o Excel
Importar o vincular datos de SQL Server
Configuracin de seguridad de las tablas vinculadas
Tablas importadas y vinculadas

Existen dos formas de acceder a los datos de tablas que no sean de PI System:
Importar la tabla.
Despus de la importacin inicial, no existir ninguna relacin posterior entre la tabla
externa y la tabla de PI AF. Las tablas de PI AF con datos importados se denominan tablas
importadas. Las tablas importadas son tablas de lectura/escritura. Tienen un tamao
limitado, pero son ms 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 despus de la importacin inicial. 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 estn diseadas para almacenar bases de datos muy grandes. Si necesita
acceder a muchos datos de tablas de PI AF, utilice tablas externas, que no presentan estos
lmites de almacenamiento. Tambin, puede dividir la tabla en distintas tablas al importar.
Vincularlos a la tabla.
Los datos de tabla no estn almacenados en la base de datos de PI AF. Las tablas vinculadas
se denominan en algunas ocasiones tablas externas porque el mantenimiento de los datos
de origen no se realiza en PI AF. Las tablas externas no se pueden editar desde PI AF. Las
tablas vinculadas poseen en algunas ocasiones configuracin de seguridad adicional, porque
es necesario configurar la forma en que PI AF se conecta con la fuente de datos externos.
Crear una conexin de tabla reutilizable

Cree una conexin OLE DB y vuelva a utilizarla para configurar tablas vinculadas desde el
mismo origen de datos.
Antes de empezar
Utilice PI System Explorer de 64 bits para configurar conexiones a tablas vinculadas. Incluye
controladores OLEDB de 64 bits, que son obligatorios en los servidores de PI AF de 64 bits.

Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Biblioteca y compruebe que
Conexiones de tabla aparece en el panel del navegador.
2. Seleccione Conexiones de tabla y haga clic en Nueva conexin de tabla en el men
principal. (Tambin puede hacer clic con el botn secundario en Conexiones de tabla y
seleccionar Nueva conexin de tabla en el men contextual.) El visor muestra las
propiedades de la conexin de tabla, como Nombre y Descripcin.
3. Opcional: Edite el nombre predeterminado y aada una descripcin de la conexin de tabla.
4. En Conexin, haga clic en Construir para configurar la conexin con Propiedades de vnculo
de datos. (Tambin puede introducir o modificar una cadena de conexin directamente en el
cuadro de texto Conexin.)
5. En la pestaa Proveedor de Propiedades de vnculo de datos, seleccione un proveedor OLEDB
y siga las instrucciones que aparecen en la pantalla para configurar la conexin. Para
obtener ayuda especfica, haga clic en Ayuda en cualquier pestaa.
6. En el visor, seleccione una opcin en el campo Seguridad. (Puede que algunas opciones no
estn disponibles. Consulte Autenticacin de tablas vinculadas para obtener ms
informacin.)
Simular cliente (recomendado)
Seleccione Proporcionar contrasea e introduzca una contrasea para la conexin de
tabla.
No hay contexto de seguridad adicional
7. Haga clic en Ingresar en el men principal para ingresar y guardar la conexin de tabla.
Puede abrir Conexiones de tabla en el panel del navegador para ver la conexin de tabla
creada recientemente.
Autenticacin de tablas vinculadas

Cuando una aplicacin cliente solicita datos externos, el servidor de PI AF consulta la fuente de
datos externos 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 configurar una
conexin de tabla externa en PI System Explorer, por ejemplo, tendra que utilizar un servidor
de PI AF con el mismo valor de bits (por lo general, 64 bits).
Cuando configure la tabla vinculada, se le solicitar que especifique las credenciales que el
servidor de PI AF utilizar para conectarse con la base de datos. Las opciones de autenticacin
son:
Simular cliente
Si la base de datos de origen admite autenticacin Windows, utilice la identidad Windows
del cliente que solicite los datos. Se trata de una conexin suplantada. Es el mtodo ms
seguro de autenticacin; utilcelo siempre que sea posible.
Proporcionar contrasea
Si la base de datos de origen no admite la autenticacin Windows, o si la base de datos y el
servidor de PI AF estn en diferentes dominios y no son de confianza, especifique un
nombre de usuario y una contrasea con el permiso de acceso a la base de datos de recursos
necesario. PI AF utiliza esta cuenta de codificacin fija para leer los datos en el origen de
datos externo. Por ejemplo, la base de datos MySQL no admite autenticacin Windows; por

lo tanto, tendr que utilizar el nombre de usuario y la contrasea de una cuenta de la base
de datos de MySQL.
No hay contexto de seguridad adicional
Esta opcin se aplica normalmente cuando se utilizan Excel u otros orgenes de datos
basados en archivos; de lo contrario, sera necesario otorgar a cada usuario acceso de
lectura al archivo del servidor. Con esta opcin, se podr acceder a la tabla externa con la
identidad del servidor de PI AF. En este caso, no necesita especificar un nombre de usuario o
contrasea al configurar la tabla vinculada ni tampoco es necesario configurar Kerberos. No
obstante, encrguese de configurar la seguridad de SQL de tal forma que la identidad del
servidor de AF no tenga ms privilegios de los necesarios para obtener los datos. Solo los
administradores de PI AF pueden configurar tablas externas por motivos de seguridad. Por
eso, el privilegio de administrador de PI AF se debe otorgar a un conjunto reducido de
usuarios cuando se establezca este modo de conexin.
En esta seccin
Restricciones respecto a las conexiones no suplantadas
Riesgos del uso de conexiones no suplantadas
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:
Exija tener privilegios administrativos en el servidor de PI AF y privilegios de escritura en la
tabla de PI AF.
Impida la creacin de tablas de PI AF vinculadas con conexiones no suplantadas.
Impida la creacin de tablas vinculadas.
Si tiene problemas con las tablas vinculadas, pngase en contacto con su administrador del
sistema para consultarle la configuracin de las tablas externas del servidor de PI AF.
Riesgos del uso de conexiones no suplantadas

En funcin de la configuracin del SQL Server, un usuario con privilegios de administrador de
PI AF puede crear ataques al SQL Server y hacerse con el control total del sistema si se da
alguna de estas circunstancias:
Se ha configurado una tabla de PI AF que utiliza la identidad del servidor de PI AF para

vincularse con una base de datos externa.
Las tablas vinculadas (externas) no suplantadas estn habilitadas en el servidor de PI AF.
Sin embargo, las tablas vinculadas no suplantadas estn inhabilitadas de forma
predeterminada en el servidor de PI AF. Para que un usuario pudiera ejecutar un ataque,
tendra que activar las tablas externas no suplantadas.
La cuenta del servidor de PI AF tiene derechos administrativos sobre un SQL Server.
El servidor de AF se ejecuta, de forma predeterminada, con la cuenta de NetworkService,
que no tiene derechos administrativos sobre el SQL Server configurado de forma local ni
acceso a las bases de datos del sistema remotas. Sin derechos de administrador a la base de
datos remota, se reduce la posibilidad de tener privilegios de ataque.

PRECAUCIN:
Por motivos de seguridad, no otorgue privilegios administrativos al servidor de PI AF en
el equipo o el SQL Server cuando se ejecuten con consultas no suplantadas.
Importar o vincular 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 ltima actualizacin sea
posterior al ajuste del intervalo de cach de la tabla. Los datos importados se cargan en la tabla
de PI AF solo una vez. Para actualizar la tabla con datos importados, pulse con el botn
secundario sobre su entrada en el nodo Tablas del panel Biblioteca y seleccione Volver a
importar tabla.
Procedimiento
Para vincular o importar datos desde una tabla de Microsoft Access o un libro de trabajo de
Microsoft Excel, especifique lo siguiente:
la base de datos de origen o el libro de trabajo
una consulta que devuelva los datos deseados
las credenciales de inicio de sesin necesarias para acceder a la base de datos o al libro
de trabajo
Las instrucciones exactas dependen de la configuracin de hardware y de lo que intente
hacer:
En los servidores de PI AF de 32 bits: siga las instrucciones incluidas en Vincular o
importar datos.
Con los servidores de PI AF de 64 bits: para realizar importaciones, consulte Vincular o
importar datos; para realizar vinculaciones, consulte Vincular datos en un servidor de PI
AF de 64 bits.
En esta seccin
Vincular o importar datos
Vincular datos en un servidor de PI AF de 64 bits
Vincular o importar datos

En estas instrucciones se describe cmo importar datos en un servidor AF de 32 bits o 64 bits y
cmo vincular datos en un servidor de PI AF de 32 bits nicamente. 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 una
tabla 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 mostrarn en el panel derecho.
3. Haga clic en Vincular o Importar.
Se abrir la ventana correspondiente.
4. Solo para vinculaciones: Si va a vincular la tabla, active la opcin Suplantar cliente (no se
muestra en el caso de la importacin).

5. Haga clic en Crear.

Se abrir la ventana Propiedades de vnculo de datos.
6. En la pestaa Proveedor, seleccione el proveedor segn la versin de Microsoft Office que
est 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 pestaa Conexin, especifique lo siguiente y haga clic en Aceptar.
Origen de datos
La ubicacin 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 vinculacin, la ruta al archivo debe ser
relativa al servidor AF.
Nombre de usuario
Credenciales de inicio de sesin 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 contrasea con la informacin de conexin, marque la casilla de
verificacin Permitir guardar contrasea. La contrasea se almacena como texto sin
formato (sin cifrar).
8. En la pestaa Avanzadas, en la lista Permisos de acceso, seleccione Share Deny None.
9. Solo en Excel: En la pestaa Todo, seleccione el valor Propiedades extendidas y haga clic en
Editar valor.
Se abrir la ventana Modificar valor de la propiedad.
Introduzca el valor de propiedad segn la versin de Microsoft Excel que est utilizando y, a
continuacin, 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 base de datos, vuelva a la pestaa Conexin y
haga clic en Probar conexin.
Si los ajustes son vlidos, se mostrar 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 devolvern en la hoja de clculo, 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 pestaa Tabla. Si la consulta se ha especificado de forma
correcta, la pestaa contendr una tabla con los resultados.
14. Para guardar los cambios, pulse con el botn secundario sobre la 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 una
tabla 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 mostrarn en el panel derecho.
3. Haga clic en Vincular.
Se abrir la ventana correspondiente.
4. Active la opcin Suplantar cliente.
5. En el campo Conexin, introduzca una cadena de conexin vlida 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 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";
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 devolvern en la hoja de clculo, 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 pestaa Tabla. Si la consulta se ha especificado de forma
correcta, la pestaa contendr una tabla con los resultados.
8. Para guardar los cambios, pulse con el botn secundario sobre la tabla y haga clic en
Ingresar.
Importar o vincular datos de SQL Server

Cuando importe datos de una tabla de Microsoft SQL Server o los vincule a ella, debe definir
informacin de conexin vlida. Los pasos de vinculacin o importacin dependen el mtodo
de conexin que elija. Vase Autenticacin de tablas vinculadas.
En estos procedimientos, se utliza la base de datos de SQL Server, AdventureWorks.
En esta seccin
Uso de la conexin de seguridad suplantada de Windows
Utilizar la seguridad no suplantada de Windows
Utilizacin de la seguridad de SQL Server
Vincular o importar la tabla de destino

Uso de la conexin de seguridad suplantada de Windows

Vincular o importar datos de una tabla de SQL Server con la opcin Simular cliente. Consulte
Recomendaciones relativas al acceso a los datos para las tablas vinculadas.
Nota:
Si se va a realizar una vinculacin a un SQL Server que no est en el mismo equipo que el
servidor de AF, puede que sea necesario configurar Kerberos para permitir que la
identidad del cliente se reenve desde el servidor de AF al SQL Server.
Procedimiento
1. Crear un grupo local de usuarios en el servidor de datos.
2. Configuracin de la seguridad en la base de datos de la tabla de destino.
3. Vincular o importar la tabla de destino.
En esta seccin
Crear un grupo local de usuarios en el servidor de datos
Configuracin de la seguridad en la base de datos de la tabla de destino

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 AF (PIFD), utilice este procedimiento para garantizar el
acceso a la tabla.
Procedimiento
1. En el equipo donde reside la instancia de SQL Server, haga clic en Inicio > Herramientas
administrativas > Administracin de equipos.
Se abrir la aplicacin Administracin de equipos.
2. Expanda Usuarios y grupos locales.
3. Haga clic con el botn secundario sobre Grupos y seleccione Nuevo grupo.
Se abrir la ventana Nuevo grupo.
4. Cree un grupo local para los usuarios que necesiten acceder a la tabla de bases de datos.
5. Aada a este grupo las cuentas de todos los usuarios que podran suplantarse.
6. Haga clic en Aceptar para aadir los usuarios seleccionados y, a continuacin, en Cerrar para
salir de la ventana Nuevo grupo.
7. Cierre la aplicacin Administracin de equipos.
Configuracin 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 conctese a la instancia de SQL Server que
contiene la tabla de destino.
2. En la instancia de SQL Server, expanda la carpeta Seguridad y despus la carpeta Inicios de
sesin.
3. Haga clic con el botn secundario en la carpeta Inicios de sesin y seleccione Nuevo inicio de
sesin.

4. Utilice el botn Buscar para localizar el grupo creado en la seccin anterior y elegir ese
grupo como nombre de inicio de sesin.
5. Seleccione la opcin Autenticacin de Windows y la base de datos que contiene la tabla de
destino como la Default database.
6. Seleccione la pgina Asignacin de usuarios.
7. Seleccione la fila de la base de datos que contiene la tabla de destino.
8. Marque la casilla de verificacin Asignar de la base de datos seleccionada.
9. Expanda la carpeta Bases de datos y despus la carpeta de la base de datos de destino y
otorgue los permisos necesarios para ejecutar la consulta que se utilizar para el inicio de
sesin que acaba de crear.
Por ejemplo, si la consulta que se utilizar es una clusula SELECT que especifica una tabla
nica, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y,
continuacin, haga clic con el botn secundario en la tabla a la que se refiera la consulta y
seleccione Propiedades.
10. En la ventana Propiedades de la tabla, seleccione la pgina Permisos, busque y seleccione
Inicio de sesin, despus Otorgar al inicio de sesin el permiso seleccionado y pulse Aceptar
para cerrar la ventana Propiedades de la tabla.
11. Cierre Microsoft SQL Server Management Studio.
Utilizar la seguridad no suplantada de Windows

Vincule o importe datos de una tabla de SQL Server con la opcin de contexto no additional
security .
Procedimiento
1. Crear un grupo local de usuarios en el servidor de datos
2. Configuracin de la seguridad en la base de datos de la tabla de destino
3. Vincular o importar la tabla de destino

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 AF (PIFD), lleve a cabo los siguientes pasos para
garantizar el acceso a la tabla.
Procedimiento
1. En el equipo donde reside la instancia de SQL Server, haga clic en Inicio > Herramientas
administrativas > Administracin de equipos.
Se abrir la aplicacin Administracin de equipos.
2. Expanda Usuarios y grupos locales.
3. Haga clic con el botn secundario sobre Grupos y seleccione Nuevo grupo.
Se abrir la ventana Nuevo grupo.
4. Cree el grupo local de usuarios que incluir la identidad del servicio AF.
5. Aada la cuenta del usuario asociado con el servicio AF al nuevo grupo. Si el servicio AF se
ejecuta con la cuenta NT AUTHORITY\NetworkService, aada la cuenta de equipo del
servidor de AF a este grupo.

Nota:
Si el servicio AF se ejecuta con la cuenta de sistema local o de servicio local,
probablemente necesitar utilizar la autenticacin de SQL Server (modo de
autenticacin de SQL Server y Windows) en lugar de la seguridad integrada.
6. Haga clic en Aceptar para aadir el usuario seleccionado.
7. Cierre la aplicacin Administracin de equipos.
Utilizacin de la seguridad de SQL Server

Vincule o importe datos de una tabla de SQL Server utilizando la autenticacin de SQL Server.
Procedimiento
1. Creacin de un usuario de SQL Server.
2. Configuracin de la seguridad en la base de datos de la tabla de destino.
3. Vincular o importar la tabla de destino.
Nota:
Si va a conectarse con una instancia remota de SQL Server, asegrese de que SQL
Server se ha configurado para aceptar conexiones remotas.
Si va a utilizar una cuenta de SQL Server, asegrese de que la instancia de SQL Server
se ha configurado para permitir autenticacin de modo mixto.
Creacin 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 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 conctese a la instancia de SQL Server que
contiene la tabla de destino.
2. En la instancia de SQL Server, expanda la carpeta Seguridad y despus la carpeta Inicios de
sesin.
3. Cree un inicio de sesin e introduzca un nombre en el campo Nombre de inicio de sesin.
4. Seleccione una opcin en Autenticacin de SQL Server.
5. Introduzca la contrasea en los campos Contrasea y Confirmar contrasea.
6. En la lista Base de datos predeterminada, seleccione la base de datos que contiene la tabla
de destino.
8. Seleccione la fila de la base de datos que contiene la tabla de destino.
9. Marque la casilla de verificacin Asignar de la base de datos seleccionada.
10. Pulse Aceptar para cerrar la ventana Inicio de sesin - Nuevo y guarde el inicio de sesin.
11. Expanda la carpeta Bases de datos y, a continuacin, la carpeta de la base de datos de
destino y otorgue los permisos necesarios para ejecutar la consulta que se utilizar para el
inicio de sesin que acaba de crear.
Por ejemplo, si la consulta que se utilizar es una clusula SELECT que especifica una tabla
nica, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y,
continuacin, haga clic con el botn secundario en la tabla a la que se refiera la consulta y
seleccione Propiedades.

12. En la ventana Propiedades de la tabla, seleccione la pgina Permisos, despus, Inicio de

sesin y Otorgar al inicio de sesin el permiso seleccionado. Haga clic en Aceptar para
cerrar la ventana Propiedades de la tabla.
13. Cierre Microsoft SQL Server Management Studio.
Vincular o importar la tabla de destino

Tanto si va a vincular datos a una tabla de Microsoft SQL Server como a importarlos de ella, el
proceso es bsicamente el mismo. Las siguientes instrucciones se refieren a cmo vincular una
tabla de 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 mostrarn en el panel derecho.
2. Haga clic en Vincular.
Se abrir la ventana Vnculo de tabla.
3. Haga clic en Crear.
Se abrir la ventana Propiedades de vnculo de datos.
4. En la pestaa Proveedor, seleccione SQL Server Native Client.
5. En la pestaa Conexin, configure la instancia de SQL Server que contiene la base de datos
con la que desea conectarse.
6. Configure la autenticacin:
Para una seguridad integrada, seleccione la opcin Use Windows NT Integrated

Security.
Para una seguridad de SQL Server, seleccione la opcin Use a Specific User Name
and Password. A continuacin, introduzca el nombre de inicio de sesin de SQL Server
en el campo Nombre de usuario y una contrasea en el campo Contrasea.
7. Seleccione la opcin 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 configuracin funcionan, haga clic en Probar conexin. Si
los ajustes son correctos, PI System Explorer mostrar un mensaje indicando que son
correctos.
Nota:
La prueba de conexin verifica que la cuenta con la que se est ejecutando PI System
Explorer tiene acceso a la base de datos especificada. Sin embargo, si opta por la
seguridad integrada en la definicin de tabla y selecciona la opcin no additional
security context para la tabla de seguridad, se utilizar la cuenta asociada con el
servicio AF para conectarse cuando un usuario muestre los datos abriendo la pestaa
Tabla.
10. En el campo Consulta, especifique la consulta SQL que devolver los datos deseados y haga
clic en Aceptar.
11. Para mostrar los datos obtenidos por la consulta, abra la pestaa Tabla.

Configuracin de seguridad de las tablas vinculadas
En esta seccin
Recomendaciones relativas al acceso a los datos para las tablas vinculadas
Cambiar los valores de seguridad de las tablas vinculadas
Recomendaciones relativas al acceso a los datos para las tablas vinculadas

Si no es necesario acceder a tablas vinculadas, desactive el acceso.
No otorgue privilegios administrativos de cuenta de servicio de aplicacin de PI AF en el
servidor de PI AF o en SQL Server cuando ejecute consultas no suplantadas.
Para poder configurar una tabla vinculada que ejecute consultas no suplantadas, debe tener
privilegios de administrador en el servidor de PI AF.
Consulte las instrucciones en Cambiar los valores de seguridad de las tablas vinculadas.
Cambiar los valores de seguridad de las tablas vinculadas

PI AF Diagnostics es una utilidad de lnea de comandos que sirve para activar o desactivar
caractersticas del servidor de PI AF y ejecutar otras funciones administrativas. La utilidad
establece una conexin directa con la base de datos de SQL Server asociada y requiere el rol
sysadmin o db_afadmin de SQL Server.
El nombre de la utilidad es afdiag y se encuentra ubicada en la carpeta \PIPC\AF.
Utilice la utilidad AF Diagnostics para ajustar los valores de seguridad de las tablas externas.
Tarea Comando Valor predeterminado
Activar la afdiag /DT activado
compatibilidad con
las tablas de PI AF
externas
Desactivar la afdiag /DT
compatibilidad con
las tablas de PI AF
externas
Activar la afdiag /DTImp desactivado
compatibilidad con
las tablas de PI AF
externas para
usuarios no
suplantados
Desactivar la afdiag /DTImp-
compatibilidad con
las tablas de PI AF
externas para
usuarios no
suplantados
Cambiar los En PI System Explorer, haga clic con el La configuracin de tabla requiere, de
valores de botn secundario sobre la tabla en el forma predeterminada, privilegios
seguridad de una navegador y seleccione Seguridad en el administrativos en el servidor de PI AF.
tabla de PI AF men que aparece.
especificada

Tarea Comando Valor predeterminado

Modificar los En PI System Explorer, pulse con el La configuracin de tabla requiere, de
valores de botn secundario sobre Tablas en el forma predeterminada, privilegios
seguridad de las navegador y seleccione Seguridad en el administrativos en el servidor de PI AF.
tablas vinculadas. men que aparece.
Configurar una referencia de datos de bsqueda de tabla
Procedimiento
2. En el navegador, seleccione el elemento o la plantilla de elementos que desee utilizar.
3. En el visor, seleccione el atributo o la plantilla de atributos que desea que posean un valor
de bsqueda de tabla.
4. En en el men del campo Referencia de datos de la Paleta, seleccione Bsqueda de tabla.
5. Haga clic en Ajustes.
Se abrir la ventana Referencia de datos de bsqueda de tabla.
6. En la lista Tabla, seleccione la tabla que desee utilizar.
Utilice los tres botones situados a la derecha del campo Tabla para gestionar y seleccionar
tablas. Pase el ratn sobre un botn para ver el nombre.
Haga clic en Administrar tablas para abrir una lista de tablas en las que podr realizar
bsquedas o aplicar filtros. Para seleccionar una tabla, resltela en la lista y haga clic en
Aceptar.
Haga clic en Propiedades de tabla para ver o editar las propiedades de la tabla actual.
Haga clic en Crear tabla para abrir la ventana Propiedades de tabla para una nueva tabla.
7. 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 configuracin, no hay interpolacin entre los valores de la
tabla.
8. En la lista Unidad de medida, seleccione la unidad de medida en la que se encuentran
almacenados los datos de la columna de resultados.
9. Elija una opcin en Zona horaria.
10. En la lista Regla, seleccione una opcin:
Select first row matching criteria
Utilice la lista Ordenar por para especificar el orden que se utilizar. Este orden sirve
para seleccionar una fila cuando ms de una coincida con los criterios.
Summarize all rows matching criteria
Seleccione una operacin de resumen en la lista Resumen para realizar la operacin
elegida en la columna seleccionada en un rango de filas coincidentes con los criterios.
Consulte Operaciones de resumen compatibles para ver descripciones de los operadores.
Table provided time series data

Seleccione esta opcin 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 fecha y hora que desea
utilizar. En el men solo aparecern las columnas que tengan el tipo de valor DateTime.
Si selecciona esta opcin, la clusula WHERE no es necesaria.
11. Utilice los mens y los botones del panel Donde para elaborar la consulta de tabla.
Nota:
Tambin puede escribir la clusula entera en el campo de texto Clusula DONDE
completa. Consulte Sintaxis de la clusula DONDE para obtener ms informacin.
En la lista Columna, seleccione la columna de la tabla que se utilizar en la consulta.

En la lista Operador, seleccione el operador relacional para utilizar en la consulta.
ConsulteInterpolacin para obtener una explicacin del operador Interpolate.
En la lista Atributo o valor, seleccione un atributo o un valor literal para utilizar en la
consulta.
Haga clic en Aadir And o Aadir Or para escribir la clusula WHERE en el campo
Clusula DONDE completa con un operador AND / OR.
Edite la clusula en le campo Clusula DONDE completa si es necesario.
Nota:
Los botones Aadir And o Aadir Or generarn, siempre que resulte posible, de forma
automtica la sintaxis, la unidad de medida y la zona horaria necesarias.
12. Opcional: Edite los valores de los parmetros de tabla.
Los parmetros de tabla solo se aplican a las tablas vinculadas. Para obtener ms
informacin, consulte Uso de parmetros en una consulta de tabla vinculada.
13. Opcional: En Valores de sustitucin, seleccione los atributos o los valores literales que se
devolvern cuando la consulta de tabla detecte filas perdidas o valores nulos en los datos.
En esta seccin
Operaciones de resumen compatibles
Interpolacin
Sintaxis de la clusula DONDE
Operaciones de resumen compatibles

Operacin Descripcin
Sum Suma
Avg Promedio
Min Mnimo
Max Mximo
Count Recuento
StDev Desviacin estadstica estndar
Var Varianza estadstica

Operacin Descripcin
Ninguna Si el atributo de resultado no es una matriz, se
devolver el valor de la columna seleccionada
en la primera fila que coincida con la clusula
WHERE.
Si el atributo de resultado es una matriz, se
devolver una matriz con un valor de cada
columna de todas las filas que coincidan con la
clusula WHERE.
Interpolacin
Utilice el operador Interpolate para interpolar un valor de la columna de resultados basado en
una interpolacin de la columna de entrada especificada.
Por ejemplo, si una tabla de calibracin del tanque inclua dos columnas, Nivel y Volumen, la
siguiente cadena de configuracin interpolar el volumen en funcin de la lectura de nivel:
SELECT Volume FROM MyTable WHERE INTERPOLATE(Level, @MyLevelReading)
Supongamos que la tabla tiene las siguientes filas:

Ejemplo de tabla
Nivel Volumen
1 0.0
2 20.0
3 30.0
4 40.0
5 60.0
6 70.0
Una lectura de nivel de 2.2 produce como resultado el volumen 22.0.

Solo se puede utilizar un operador Interpolate en una nica clusula DONDE.
Sintaxis de la clusula DONDE

Puede utilizar los mens del cuadro de dilogo Referencia de datos de bsqueda de tabla para
construir la clusula DONDE de su consulta o puede escribir la clusula directamente en el
campo Clusula DONDE completa. Tenga en cuenta las siguientes pautas:
Los atributos AF, que se distinguen porque su nombre va precedido del smbolo @, se
sustituyen por su valor durante la bsqueda de tablas.
Los nombres de columna y atributo que contengan smbolos alfanumricos deben ir entre
corchetes: [height] >= @[Level Gauge].
Si se necesita una conversin de unidades de medida o de zonas horarias, aada una
clusula UOM o TZ dentro de los corchetes: [height] >= @[Level Gauge;UOM=m].
Uso de parmetros en una consulta de tabla vinculada

La consulta de una tabla vinculada determina qu datos procedentes de un origen externo se
incluirn en la tabla. Puede incluir parmetros en la consulta y, al configurar una referencia de
datos de consulta de tabla que utilice la tabla vinculada, podr especificar valores de
parmetro. Esto le permitir utilizar una nica tabla vinculada para obtener distintos
resultados en cada referencia de datos de bsqueda de tabla que la utilice.

El uso de parmetros en una consulta de tabla vinculada es til, por ejemplo, para limitar el
nmero de filas que devuelve una tabla externa muy grande. Puede aadir condiciones y
parmetros para devolver resultados ms concretos, por ejemplo, todas las filas que incluyan
un ID de dispositivo o fabricante, especficos de cada referencia de datos de bsqueda de tabla.
Al configurar una tabla vinculada en la ventana Vnculo de tabla, podr aadir parmetros de
tabla a su consulta y definir valores predeterminados para ellos. Despus, en la ventana
Referencia de datos de bsqueda de tabla, cuando defina una referencia de datos utilizando la
tabla vinculada, podr introducir parmetros de tabla especficos de esa referencia de datos.
Tambin puede definir valores de parmetro mediante programacin con el AF SDK. Los
valores de parmetro pueden ser valores especficos o proceder de otros valores de atributo o
de variables de sustitucin predefinidas, como %Element%.
Aadir parmetros de tabla a una consulta de tabla vinculada

Cuando defina una tabla vinculada en la ventana Vnculo de tabla, podr aadir parmetros a la
consulta de tabla y establecer valores predeterminados para ellos.
Procedimiento
1. Edite el texto del campo Consulta para incluir el nuevo parmetro o parmetros. Los
nombres de parmetro deben comenzar por el carcter @.
2. Haga clic dentro de la tabla Parmetros para mostrar los nuevos parmetros de la consulta.
3. Especifique valores predeterminados para cada parmetro a fin de determinar los
resultados predeterminados de la consulta y haga clic en Aceptar. Una vez aadidos los
parmetros a la consulta, podr especificar valores para ellos cuando configure una
referencia de datos de bsqueda de tabla que utilice la tabla vinculada.
Ejemplo
Plantese la siguiente consulta para una tabla vinculada llamada MyTable. La clusula WHERE
limita la seleccin de una tabla externa (BigTable) a aquellas filas con un determinado RowID:
SELECT * FROM BigTable WHERE RowID = 101
Sustituya el valor fijo 101 por un parmetro de consulta de tabla @id (observe que los nombres
de parmetro de consulta deben comenzar por el carcter @):
SELECT * FROM BigTable WHERE RowID = @id
Ahora, para cada referencia de datos de bsqueda de tabla que utilice MyTable, podr
proporcionar distintos valores de parmetro de tabla para que @id obtenga diferentes
resultados de la consulta.
Por ejemplo, en la ventana Referencia de datos de bsqueda de tabla, cuando configure una
referencia de datos, introduzca @AssetID para el valor de @id en la lista Parmetros de tabla.
De esta forma, @id adoptar el valor actual del atributo AssetID. La consulta correspondiente
sera:
SELECT Result FROM MyTable; @id=@AssetId
Esta consulta devuelve filas cuyo RowID coincide con el valor actual de AssetID.
Uso de parmetros en referencias de datos

Los parmetros de sustitucin son variables que se colocan en las plantillas de atributos para
las referencias de datos de PI points y de matriz de PI point. PI AF resuelve los parmetros de
sustitucin al crear las referencias de datos de un atributo basado en esa plantilla. Por ejemplo,
puede utilizar parmetros de sustitucin:

Para configurar una plantilla de referencias de datos de PI points que utilice nombres para
los tags basados en los nombres de elemento creados a partir de esa plantilla.
Para utilizar el valor de otro atributo al configurar el valor de propiedad de un PI Point.
En esta seccin
Sustituciones de nombre
Referenciar un valor de atributo
Lista de parmetros de sustitucin de PI AF
PI AF interpreta muchos parmetros de sustitucin.
Sustituciones de nombre
Cuando se utiliza una sustitucin de nombre, PI AF sustituye directamente por el parmetro de
sustitucin aquello que representa ese parmetro concreto.
La tabla de Lista de parmetros de sustitucin de PI AF enumera los parmetros de sustitucin
disponibles y aquello que representan. Por ejemplo, %Element% es un parmetro de
sustitucin que representa el nombre del elemento. Despus de crear un elemento basado en
esa plantilla, indique a PI AF que cree la referencia de datos (Crear o actualizar referencias de
datos). Cuando PI AF cree la referencia, sustituir el nombre del elemento actual en cualquier
ubicacin donde figure %Element% e la configuracin.
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 apuntar a un PI point denominado:
Tank1_TT
Referenciar un valor de atributo

Al configurar un atributo de referencia de datos de PI points, puede utilizar parmetros de
sustitucin 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 configuracin de
atributo de punto para los PI points generados de forma automtica.La sintaxis es:
%@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 un hermano
del atributo actual, utilice la sintaxis descrita en Referencia indirecta para definir la ruta al
atributo deseado.
PI AF no actualiza el valor de atributo a lo largo del tiempo. Utiliza el valor del atributo en el
momento exacto de la creacin o actualizacin de la referencia de datos (Crear o actualizar
referencias de datos). El valor es una constante. PI AF no vuelve a evaluar ese atributo, salvo si
se actualiza la referencia de datos.
Nota:
La excepcin a esta regla son las sustituciones de valor de Tiempo relativo, que se
evalan con cada llamada de valor a la referencia de datos de PI points (Crear un
intervalo de duracin configurable).

Lista de parmetros de sustitucin de PI AF

En la tabla siguiente se incluyen los parmetros de sustitucin admitidos por PI AF:
Nombre del parmetro Sustitucin
%Analysis% Nombre del anlisis, si se puede recuperar del contexto.
%Attribute% Nombre del atributo que contiene esta referencia de datos.
%AttributeId% ID del atributo que contiene esta referencia de datos.
%Database% Nombre de la base de datos de PI AF en la que reside el atributo.
%Description% Descripcin del atributo que contiene esta referencia de datos.
%Element% Nombre del elemento en el que reside el atributo. En el caso de los
marcos de evento, se refiere al nombre de elemento con referencias
primarias.
%..\Element% Nombre del elemento primario en el que reside el atributo. Para
recuperar ms antecesores, utilice la notacin ..\; por ejemplo, %..
\..\Element%.
%\Element% Nombre del elemento raz en el que reside el atributo.
%ElementDescription% Descripcin del elemento en el que reside el atributo.
%ElementId% ID del elemento en el que reside el atributo. En el caso de los marcos
de evento, se refiere al ID del elemento con referencias primarias.
%EndTime% Hora de finalizacin local, si se puede recuperar del contexto
temporal.
%EventFrame% Nombre del marco de evento en el que reside el atributo.
%<Environment Variable>% Valor de la variable de entorno del sistema coincidente. Por ejemplo,
%COMPUTERNAME% se sustituye con el nombre del equipo en el que se
est ejecutando la referencia de datos.
%..\EventFrame% Nombre del marco de evento principal del marco de evento en el que
reside el atributo. Para recuperar ms antecesores, utilice las
notaciones ..\; por ejemplo, %..\..\EventFrame%.
%EventFrame% Nombre del marco de evento raz en el que reside el atributo.
%EventFrame% ID del marco de evento en el que reside el atributo.
%Model% Nombre del modelo, si se puede recuperar del contexto.
%Server% Nombre del PI Server predeterminado del equipo en el se crea el
atributo. Cuando se crea el atributo en PI System Explorer, es el PI
Server predeterminado del equipo en el que se ejecuta PI System
Explorer.
Nota:
El parmetro %Server% no se resuelve en el equipo en el que
reside la base de datos de PI AF. El parmetro %Server% se
puede resolver en un PI Server diferente, en funcin del valor
predeterminado en PI AF Client.
%Source% Nombre del elemento origen de la transferencia en el que reside el

atributo.
%StartTime% Hora de inicio local, si se puede recuperar del contexto temporal.
%System% Nombre del servidor de PI AF o colectivo en el que reside el atributo.
%Template% Nombre de la plantilla en la que se basa el elemento. Por ejemplo, si
ha creado el elemento Valve101 a partir de una plantilla
denominada Valve, el texto de sustitucin sera Valve.
%Time% Hora local, si se puede recuperar del contexto temporal.
%Transfer% Nombre de la transferencia en la que reside el atributo.

Nombre del parmetro Sustitucin

%TransferId% ID de la transferencia en la que reside el atributo.
%UtcEndTime% Hora de finalizacin universal coordinada (UTC) si se puede
recuperar del contexto temporal.
%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.
Localizar el PI Server predeterminado

El parmetro de sustitucin %Server% se resuelve en el nombre del PI Server predeterminado
para el equipo en el que se crea el atributo. Si va a crear el atributo en PSE, es el PI Server
predeterminado para el equipo en el que se est ejecutando PSE.
Nota:
%Server% no se resuelve en el equipo en el que reside la base de datos de PI AF.
Procedimiento
1. Abra la utilidad PI SDK en el equipo en el que se est ejecutando PI System Explorer. . Con
los valores de instalacin predeterminados de PI Server, seleccione Inicio Todos los
programas > PI System > Acerca de PI-SDK
Aparecer el cuadro de dilogo Utilidad PI SDK.
2. Seleccione Archivo > Conexiones. Se mostrar PI Connection Manager.
3. Seleccione Conexiones > Opciones. Aparecer el cuadro de dilogo Opciones de conexin. El
servidor predeterminado estar incluido en Ajustes de servidor predeterminado.
Trabajo con unidades de medida

En esta seccin
Unidades de medida de PI AF
Clases base y clases derivadas
Crear una unidad de medida
Crear una clase de unidad de medida
Clases base de unidades de medida
Algunas clases derivadas de unidades de medida comunes
Unidades de medida de PI AF
La funcin de unidades de medida (UOM) permite realizar conversiones automticas de
unidades en las aplicaciones cliente. Por ejemplo, supongamos que un atributo de AF tiene
metros como unidad de medida. Un usuario de PI ProcessBook que est consultando ese valor
de atributo puede optar por ver el valor en distintas unidades, por ejemplo, en pies. PI AF
convierte de forma automtica los datos de metros a pies.
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 unidad
cannica. Es la unidad base que AF utiliza como base para convertir valores a otras unidades

cuando es necesario. Por ejemplo, la unidad cannica de la clase longitud es el metro (m). La
implementacin de unidades de medida en PI System Explorer se basa en el Sistema
Internacional de Unidades (SI).
Nota:
Las unidades de medida se utilizan en todas las bases de datos de PI AF. No debe tener
distintas unidades de medida definidas para diferentes bases de datos.
Clases base y clases derivadas

PI AF tiene un conjunto pequeo predefinido de clases base y un conjunto ms 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,
las clases de rea y de volumen se derivan ambas de la clase longitud. Tericamente, puede
definir todas las unidades de medida como un grupo reducido de clases base de unidades de
medida.
PI AF utiliza la unidad cannica de la clase base para determinar las unidades cannicas de
todas las clases derivadas de esa clase base. Las unidades cannicas de las clases derivadas no
se pueden modificar. Por ejemplo, dado que la clase de rea se basa en la de longitud, la unidad
cannica de la clase rea ser el metro cuadrado (m).
PI AF incluye muchas unidades de medida estndar, clases de unidades de medida y factores de
conversin, pero siempre puede aadir otros nuevos. Por lo general, no resulta necesario crear
clases base, aunque es posible que ocasionalmente desee aadir una para las mediciones que
no sean fsicas. Por ejemplo, puede aadir una clase denominada "bytes" que incluya bytes, KB,
MB, GB, etc. como unidades de medida.
Crear una unidad de medida

Procedimiento
1. En PI System Explorer, pulse el botn Unidad de medida en el panel del navegador. Todas
las clases de unidades de medida definidas aparecern en el navegador.
2. Haga clic para seleccionar la clase a la que desea aadir una unidad de medida nueva. Por
ejemplo, si desea aadir una unidad de longitud, haga clic y seleccione la clase Longitud.
Todas las unidades de medida definidas para la clase seleccionada aparecern en el visor.
3. Pulse con el botn secundario sobre la clase deseada y seleccione Nueva unidad de medida
en el men que aparece. Se mostrar la ventana Propiedades de unidad de medida.
4. Rellene los campos de la pestaa Propiedades de unidad de medida (Propiedades de
unidades de medida).
En esta seccin
Propiedades de unidades de medida
El campo de frmula
Propiedades de unidades de medida

Campo/Botn Descripcin
Nombre Introduzca un nombre. Las unidades de medida
pueden tener el mismo nombre, pero abreviaturas
diferentes.

Campo/Botn Descripcin
Abreviatura Introduzca la abreviatura. Las unidades de medida
deben tener abreviaturas distintas.
Descripcin Opcional. Introduzca una descripcin de la unidad
de medida.
UOM cannica El campo de solo lectura muestra la unidad
cannica de la clase.
UOM de referencia Seleccione una clase de unidad de referencia que
se utilizar como base para convertir la nueva
unidad.
Tipo - Simple Seleccione esta opcin para las conversiones que
requieran un factor de escala y un desplazamiento
base.
Tipo - Frmula Seleccione esta opcin con los clculos de
conversiones complejas. Consulte El campo de
frmula para obtener ms informacin.
Factor El factor de conversin de la unidad de medida de
referencia para esta unidad de medida. Por
ejemplo, un kilmetro tiene un factor de 1000
relativo a un metro.
Desplazamiento El desplazamiento de conversin de la unidad de
medida de referencia. Por ejemplo, los grados C
tienen un desplazamiento de 273,15 respecto a los
grados Kelvin.
El campo de frmula
Al crear una unidad de medida, debe definir el mtodo de conversin. Dispone de la opcin de
utilizar una frmula para la conversin. PI AF utiliza C# para evaluar frmulas de unidades de
medida. Siga estas pautas:
Escriba todas las unidades de medida en los trminos de la abreviatura de la unidad de

medida. Si una abreviatura no es un nombre de variable C# vlido, inclyala entre
corchetes.
Respete las reglas de evaluacin de C#.
Opcionalmente, puede invocar mtodos estticos .NET estndar, como Math.Log10(), para
realizar el clculo (estar limitado a los mtodos disponibles en el ensamblado del sistema).
La frmula utiliza la clase CompilerResults para evaluar la frmula en relacin con los
resultados.
Por ejemplo, vatios (w) es la unidad de medida cannica de la clase Potencia. Para crear la
unidad de medida dBM en la clase Potencia, la frmula podra ser:
Por ejemplo, vatios (w) es la unidad de medida cannica de la clase Potencia. Para crear la
unidad de medida dBM en la clase Potencia, la frmula podra ser:
dBm = Math.Log10( w ) + 30
Crear una clase de unidad de medida

Procedimiento
1. En PI System Explorer, pulse el botn Unidad de medida en el panel del navegador.

Todas las clases de unidades de medida definidas aparecern en el navegador.

2. Pulse con el botn secundario en cualquier lugar y seleccione Nueva clase Unit-of-Measure.
Aparecer el cuadro de dilogo Propiedades de la clase Unit-of-Measure.
3. Rellene las propiedades de la pestaa General:
Nombre
Introduzca un nombre para la clase. Consulte Limitaciones respecto a los nombres de
objetos de AF, si es necesario.
Descripcin
Opcional. Introduzca una descripcin de la clase.
UOM cannica
Escriba el nombre de la unidad de medida cannica para esta clase. Si la UOM no existe,
PI AF la crear al mismo tiempo que la nueva clase.
Abreviatura de UOM cannica
Introduzca la abreviatura. Las clases de unidades de medida deben tener abreviaturas
diferentes.
Unidades de medida base
Introduzca un clculo para la unidad de medida. Si desea definir una nueva clase base,
deje este campo en blanco.
5. La pestaa Unidades de medida mostrar todas las unidades de medida definidas para esta
clase. Para aadir unidades de medida nuevas, pulse con el botn secundario en la lista y
seleccione Nueva unidad de medida. Podr aadir unidades de medida nuevas siempre que
lo desee.
Clases base de unidades de medida

Clase Unidad cannica
Corriente elctrica Amperio (amp)
Longitud metro (m)
Masa kilogramo (kg)
Moles (Cantidad de sustancia) mol (mol)
ngulo plano radin (rad)
Cantidad total
Relacin porcentaje (%)
Temperatura kelvin (K)
Tiempo segundos (s)
Algunas clases derivadas de unidades de medida comunes

Clase Basada en Unidad cannica
Velocidad angular ngulo plano * Tiempo-1 radin por segundo (rad/s)
rea Longitud2 metro cuadrado (m2)
Densidad Masa * Longitud-3 kilogramo por metro cbico (kg/m3)

Clase Basada en Unidad cannica

Carga elctrica Corriente elctrica * Tiempo culombio (C)
Potencial elctrico Corriente elctrica-1 * Length2 * Masa voltio (V)
* Tiempo-3
Energa Longitud2 * Masa * Tiempo-2 julio (J)
Frecuencia Tiempo-1 hercio (Hz)
Fuerza Masa * Longitud * Tiempo-2 newton (N)
Caudal msico Masa * Tiempo-1 kilogramo por segundo (kg/s)
Potencia Masa * Longitud2 * Tiempo-3 vatio (W)
Presin Masa * Longitud-1 * Tiempo-2 pascal (Pa)
Energa especfica, Longitud2 * Tiempo-2 julios por gramo (J/g)
entalpa especfica
Velocidad Longitud * Tiempo-1 metro por segundo (m/s)
Volumen Longitud3 metro cbico (m3)
Caudal volumtrico Longitud3 * Tiempo-1 metro cbico por segundo (m3/s)

Asset-Based Analytics para PI Server
Asset-Based Analytics es una funcin integral de PI Asset Framework (PI AF) que permite crear
y gestionar anlisis. Utilice la funcin Asset-Based Analytics en PI System Explorer cuando
trabaje con elementos y plantillas de elementos.
Un anlisis es un clculo planificado que obtiene valores de entrada de atributos de una
jerarqua de AF e introduce los resultados en otros atributos de AF. El uso de atributos de AF
como referencias de datos de PI points permite a los anlisis recibir entradas y guardar las
salidas en PI points.
Nota:
Se recomienda especialmente guardar las salidas de anlisis en PI points para poder
elaborar historiales de datos e incluirlos en las tendencias creadas con las herramientas
cliente. El almacenamiento de salidas de anlisis en PI points mejora tambin el
rendimiento de PI AF.
En esta seccin
Acerca de los anlisis
Anlisis de expresiones
Anlisis de resumen
Anlisis de generacin de marcos de evento
Gestin de los anlisis de un elemento
Anlisis de ejemplo
Gestin de anlisis en la base de datos de AF
Gestin de PI Analysis Service
Referencia de funciones de expresin
Funciones del vapor para expresiones de anlisis
Acerca de los anlisis

Un anlisis consta de una expresin que realiza un clculo y una programacin de esa
ejecucin. Toma los valores existentes como entradas para generar resultados nuevos: valores
o marcos de eventos nuevos calculados. Puede especificar atributos de cualquier parte de la
jerarqua de AF como entradas de un anlisis.
Todos los anlisis estn asociados con un elemento o, preferiblemente, con una plantilla de
elementos. Puede guardar salidas de anlisis asignndolas a atributos de ese elemento o
plantilla de elementos.
Nota:
Si asigna una salida de anlisis a un atributo de AF configurado como una referencia de
datos de PI point, la salida se guardar en un PI point. Se recomienda guardar las salidas
de anlisis en PI points para poder elaborar historiales de datos e incluirlos en las
tendencias creadas con las herramientas cliente. El almacenamiento de salidas de anlisis
en PI points mejora tambin el rendimiento de PI AF.
Existen tres tipos de anlisis:

Expresin
Calcula uno o ms valores de salida a partir de las funciones, operadores y valores de
entrada especificados.
Resumen
Calcula funciones estadsticas estndar para un grupo de atributos seleccionados. Este
grupo se selecciona a partir de los atributos de un elemento o del conjunto de todos los
atributos de sus subelementos.
Generacin de marcos de eventos

Especifica condiciones de inicio y finalizacin de marcos de eventos.
En esta seccin
Uso de plantillas de anlisis
Programacin de anlisis
Actualizacin de anlisis y de plantillas de anlisis
Expresiones
Uso de plantillas de anlisis

Para aplicar un anlisis a un elemento, especifique el elemento directamente al crear el anlisis.
Para aplicar un anlisis a un grupo de elementos, sin embargo, es mucho ms eficaz utilizar una
plantlila de anlisis que aplicar el anlisis de forma individual a cada elemento.
Las plantillas de anlisis definen el formato de un anlisis. Los anlisis derivados de ellas sern
similares, pero tendrn atributos de entrada y de salida especficos. Las plantillas de anlisis
permiten aprovechar las ventajas de la jerarqua de AF. Todos los elementos derivados de una
plantilla de elementos adquieren automticamente los anlisis de sus plantillas de anlisis.
Cree una plantilla de anlisis en una plantilla de elementos siguiendo el mismo procedimiento
que cuando se crea un anlisis en un elemento. Cuando aada o modifique una plantilla de
anlisis en una plantilla de elementos, esos cambios se propagarn a todos los elementos
derivados de la plantilla de elementos. Si se elimina una plantilla de anlisis, se eliminarn
todos los anlisis derivados de ella, salvo los anlisis vinculados a Notifications.
Nota:
Los anlisis derivados de las plantillas de anlisis no se pueden eliminar directamente de
un elemento.
Programacin de anlisis
La programacin especifica cundo evaluar un anlisis. Existen dos tipos de programacin:
Peridica
La programacin peridica se basa en el reloj. Cuando se selecciona la opcin Peridica en
Programacin, se muestra el perodo actual. Haga clic en Configurar para configurar el
perodo de programacin.
Activado por evento

Este tipo de programacin se activa mediante eventos. Si selecciona la opcin Activada por
evento en Programacin, podr seleccionar uno o varios atributos de entrada para activar
la evaluacin del anlisis siempre que se produzca un cambio en el valor de uno de los
atributos seleccionados.

Actualizacin de anlisis y de plantillas de anlisis

Tan pronto como se inserta un anlisis, se activa de forma automtica y est disponible para
ejecutarse. Cualquier cambio que se inserte es captado de forma inmediata por todos los
anlisis a los que afecta, incluso cuando se estn ejecutando. Los cambios que pueden afectar a
un anlisis son:
Ediciones realizadas directamente en el anlisis

Cambios en un elemento que afectan a sus anlisis, incluida la adicin o supresin de un
anlisis
Cambios en una plantilla de elementos, que se propagan a todos los elementos que
proceden de la plantilla, incluida la adicin y la supresin de una plantilla de anlisis
Cambios en una plantilla de anlisis, que se propagan a todos los anlisis que provienen de
esa plantilla
Cambios en una plantilla de marcos de evento utilizados por un anlisis; los nuevos marcos
de evento se basan en la plantilla actualizada
Expresiones
Todos los anlisis, excepto los resmenes, incluyen expresiones, que se muestran en una o
varias filas. Una expresin simple puede ocupar una sola fila.
Nombre Expresin Valor
Variable1 PrevVal('Att1') - 100
El siguiente ejemplo muestra una expresin compleja refactorizada en expresiones ms breves

en varias filas. Las dos primeras filas asignan los nombres V1 y V2 a expresiones ms simples
que se utilizan como variables en la ltima fila.
V1 'Att1'/2
V2 'Att2' - 'Att3'
Resultado V1 + 3*V2
Observe que:
El nombre de una fila puede ser una variable en cualquier fila inferior.
La evaluacin de las filas se realiza del siguiente modo: primero, la primera fila; despus, la
siguiente debajo de ella y as sucesivamente. Dado que las filas inferiores pueden depender
de las ms altas, puede reordenarlas para evaluarlas en el orden correcto.
Haga clic en Aadir expresin nueva para aadir una fila y en el icono (X) para eliminarla.
En cualquier expresin, haga clic en Evaluar para evaluar las filas (en funcin de los datos
actuales) y mostrar los valores de cada una de ellas en la columna Valor.
En todos los anlisis de expresiones, es necesario asignar como mnimo una fila a un atributo
de salida. Para expresiones con varias filas, puede asignar el valor de cualquier fila a un
atributo de salida.
En esta seccin
Introduccin de expresiones
Simplificacin de una expresin con la refactorizacin

Introduccin de expresiones
Para crear una expresin, haga clic en la columna Expresin de una fila y especifique atributos
de entrada, funciones o variables para incluirlos en l.
Utilice los paneles Atributos y Funciones a la derecha de la expresin para seleccionar e

insertar atributos y funciones en la expresin.
Puede introducir el texto directamente en la expresin. A medida que escriba, las funciones,
atributos y variables que coincidan con el texto que haya escrito aparecern en una lista de
seleccin en el punto donde est el cursor y podr seleccionar el elemento que desee
insertar.
Simplificacin de una expresin con la refactorizacin

En las aplicaciones del mundo real, la expresin de un anlisis puede ser extremadamente
compleja y los nombres de atributo largos pueden contribuir a aumentarla. Para simplificar
una expresin complicada, refactorcela como un grupo de expresiones ms pequeas
asignadas a variables.
La refactorizacin de un anlisis permite comprender mejor cmo funciona cada una de sus
partes. Tambin contribuye a probar y depurar las expresiones, ya que permite evaluar de
forma simultnea las expresiones ms pequeas para aislar un error.
Puede refactorizar un anlisis aadiendo nuevas filas de expresin e introduciendo texto en los
campos Nombre y Expresin directamente.
Tambin, puede resaltar un trmino en una expresin, pulsar con el botn secundario y
seleccionar Asignar a variable. De esta forma, se insertar una fila en la parte superior que
asignar el trmino a un nombre de variable nuevo. El trmino se sustituir en la expresin
original por el nombre de variable nuevo.
Podr editar el nombre de cualquier fila si lo desea. Si cambia el nombre de una fila de
expresin que se utilice como variable en otras expresiones, romper la conexin entre ellas.
Ejemplo
Una expresin compleja puede ocupar una sola fila:
Variable1 2*'LongAttributeName' + Avg('Att2', 'Att3', 'Att4')
La expresin se puede refactorizar en las siguientes tres filas de expresiones ms sencillas.

Observe que un nombre en una fila se puede utilizar como variable en cualquier fila inferior:
Variable1 'LongAttributeName'
Variable2 Avg('Att2', 'Att3', 'Att4')
Variable3 2*Variable1 + Variable2
Anlisis de expresiones
El tipo de anlisis ms directo es el anlisis de expresin. Contiene una o varias expresiones e
informacin relativa a la programacin.

En esta seccin
Crear una plantilla de anlisis de expresiones

Cree una plantilla de anlisis de expresiones para una plantilla de elementos seleccionada.
Para guardar valores de salida, asgnelos a los atributos disponibles de la plantilla de
elementos. Puede crear un atributo de salida al configurar un anlisis.
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 el clculo.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Biblioteca y en el rbol de
navegacin, seleccione el elemento donde desee crear la plantilla de anlisis.
2. Haga clic en la pestaa Plantillas de anlisis. La pestaa Plantillas de anlisis de la plantilla
de elementos se abrir en el panel del visor. Si no existe ninguna plantilla de anlisis, haga
clic en Crear plantilla de anlisis para crear la primera. Si existen plantillas, haga clic en el
icono del botn Plantilla de anlisis nueva de la barra de herramientas situado encima
de la tabla de anlisis para crear otra.
3. Rellene los campos Nombre y, opcionalmente, Descripcin.
4. Opcional: Haga clic en la lista desplegable Categoras para mostrar las categoras
disponibles que puede asignar al anlisis.
Marque las categoras que desee asignar y haga clic en Seleccionar.
Para crear una categora, haga clic en Nuevo. Introduzca un nombre y una descripcin
para la nueva categora y haga clic en Aceptar.
5. En Tipo de anlisis, haga clic en Expresin.
6. Opcional: Haga clic en Seleccionar un elemento de ejemplo y elija un elemento en funcin
de la plantilla de elementos actual para poder utilizar sus valores en la evaluacin de la
plantilla de anlisis. Las plantillas no tienen datos concretos asociados con sus atributos. Es
imposible evaluar una expresin en una plantilla de anlisis, excepto tomando prestados
atributos de valor de un determinado elemento para ello. El elemento que seleccione se
mostrar en Elemento de ejemplo.
7. Introduzca la expresin en una o varias lneas.
8. Determine qu filas desea asignar a atributos de salida. Asegrese de asignar una fila como
mnimo a un atributo de salida.
9. Seleccione una opcin en Programa y configure una programacin.
10. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la
marca de verificacin de color verde de la barra de herramientas).
11. Haga clic en Ingresar para guardar la plantilla de anlisis y crear una instancia de ella para
todos los elementos secundarios de la plantilla de elementos.


Antes de crear un anlisis de expresin, determine los valores de salida que desee calcular y
guardar. Identifique las funciones, operadores y atributos de entrada necesarios para el
clculo.
Para guardar valores de salida, asgnelos a atributos del elemento. Puede crear un atributo de
salida al configurar un anlisis.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Elementos y, en el rbol de
navegacin, seleccione el elemento donde desee crear el anlisis.
2. Haga clic en la pestaa Anlisis. La pestaa Anlisis del elemento se abrir en el visor. Si no
existe ningn anlisis, haga clic en Crear anlisis para crear el primero. Si existen anlisis,
haga clic en el icono del botn Nuevo anlisis de la barra de herramientas situado
encima de la tabla de anlisis para crear otro.
5. En Tipo de anlisis,, haga clic en Expresin.
6. Introduzca la expresin en una o varias lneas.
7. Asegrese de asignar como mnimo un atributo de salida.
8. (Opcional) Haga clic en Evaluar para comprobar que los valores de salida son como se
esperaban.
9. Seleccione una opcin en Programa para configurar una programacin.
10. (Opcional) Para verificar el anlisis, puede examinar los resultados que genera utilizando
datos histricos.
a. En la lista de anlisis, pulse con el botn secundario sobre el nombre del anlisis y
seleccione Vista previa de resultados.
b. Introduzca una hora de inicio y finalizacin que no sean posteriores a la hora actual y
pulse Generar resultados para ver una lista de resultados.
marca de verificacin de color verde de la barra de herramientas). Esta accin no ejecuta el
anlisis.
12. Para guardar el anlisis, haga clic en Ingresar en la barra de herramientas. De esta forma, el
anlisis se guardar e insertar y podr ejecutarse.
Anlisis de resumen
Los anlisis de resumen calculan valores estadsticos, como el total y el promedio de una serie
de atributos asociados con un elemento. Por ejemplo, un anlisis de resumen de un elemento
de Fbrica podra utilizar el atributo Temperatura con todas las bombas de la fbrica para
calcular el promedio de temperatura.

Los atributos para incluir en un anlisis de resumen se pueden seleccionar de:

Los propios atributos del elemento. 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 tambin como agregacin.
Atributos de los elementos secundarios del elemento. Por ejemplo, es posible que necesite
calcular el promedio de consumo de energa de un grupo de bombas en una refinera. Para
ello, tendr que crear un anlisis de resumen en el elemento principal (la refinera) que
calcule el promedio de atributos de consumo de energa a partir de sus elementos
secundarios (bombas).
En la lista de atributos disponibles, introduzca uno o varios criterios para seleccionar aquellos
que desee incluir en el resumen:
Puede introducir el nombre entero del atributo o una parte para seleccionar los atributos
que coincidan con el texto que introduzca. Una marca de verificacin junto a un atributo de
la lista indica que se encuentra incluido en el resumen.
Tambin puede seleccionar las categoras Atributo y Elemento para elegir elementos de
esas categoras.
Puede elegir una plantilla de elementos para seleccionar atributos asociados con ella.
Una vez seleccionados los atributos que desea incluir, elija las funciones estadsticas que desea
que calcule el resumen. En todas estas funciones, asigne su salida a una salida de atributo.
Dado que un resumen identifica atributos de entrada cada vez que se ejecuta, incluir de forma
automtica los nuevos atributos que cumplan sus criterios de bsqueda. Podr aadir o
eliminar elementos o atributos de la jerarqua sin tener que actualizar el resumen.
En esta seccin
Crear una plantilla de anlisis de resumen
Crear un anlisis de resumen

Cree una plantilla de anlisis de resumen para una plantilla de elementos. Seleccione los
valores de entrada del resumen de los propios atributos de la plantilla de elementos o de los
atributos de un elemento secundario (cuyo elemento principal se 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 anlisis de resumen.
Antes de empezar
Antes de comenzar, identifique las funciones estadsticas que desee calcular en el resumen y
dnde guardar los resultados. Cuando configure una plantilla de anlisis, puede asignar los
resultados de una funcin a uno de los atributos de la plantilla de elementos o crear un atributo
de salida.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Biblioteca y seleccione la
plantilla de elementos donde desee crear la plantilla de anlisis.
de elementos se abrir en el panel del navegador. Si no existe ninguna plantilla de anlisis,
haga clic en Crear plantilla de anlisis para crear la primera. Si existen plantillas, haga clic en

el icono del botn Plantilla de anlisis nueva de la barra de herramientas situado encima
5. En Tipo de anlisis, haga clic en Resumen.
6. Seleccione una opcin en Atributos de resumen de para mostrar una lista de los posibles
atributos del resumen:
Si selecciona Elementos secundarios de <elemento>, debe seleccionar un elemento de
ejemplo para proporcionar posibles atributos. Haga clic en el enlace Seleccionar un
elemento de ejemplo para seleccionar un elemento secundario de <elemento> como
ejemplo.
Seleccione Este elemento para utilizar los atributos de la plantilla de elementos actual.
7. Introduzca uno o varios criterios de seleccin para incluir atributos en el resumen. Una
marca de verificacin junto a un atributo de la lista indica que est incluido en el resumen.
En Nombre de atributo, introduzca el nombre entero del atributo o una parte para
seleccionar los atributos que coincidan con el texto que introduzca.
Seleccione una categora en Categora de atributo para elegir atributos de esa categora.
(Si se ha seleccionado Elementos secundarios de) Seleccione una opcin en Categora de
elemento y Plantilla de elemento.
8. Seleccione las funciones estadsticas que desee que calcule el resumen.
9. Pulse Asignar para asignar las salidas de las funciones incluidas a atributos de salida.
Tambin puede crear un atributo para una salida.
12. Para guardar la plantilla de anlisis, haga clic en Ingresar en la barra de herramientas. Se
crear una instancia del anlisis para todos los elementos asociados.
Crear un anlisis de resumen

Cree un anlisis de resumen para un elemento seleccionado. Puede seleccionar atributos de
entrada para el resumen desde los propios atributos del elemento o desde los atributos de sus
elementos secundarios.
Antes de comenzar, identifique las funciones estadsticas que desee que calcule el resumen.
Para guardar los valores calculados, asigne su salida a atributos procedentes del elemento.
Tambin puede crear un atributo de salida al configurar el anlisis.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Elementos y, en el rbol de
2. Haga clic en la pestaa Anlisis. La pestaa Anlisis del elemento se abrir en el visor. Si no
existe ningn anlisis, haga clic en Crear anlisis para crear el primero. Si existen anlisis,

haga clic en el icono del botn Nuevo anlisis de la barra de herramientas situado
encima de la tabla de anlisis para crear otro.
5. En Tipo de anlisis, haga clic en Resumen.
6. En Atributos de resumen de, seleccione si desea utilizar los atributos procedentes de los
elementos secundarios del elemento o los propios atributos del elemento.
7. Introduzca uno o varios criterios de seleccin para incluir atributos en el resumen. Una
marca de verificacin junto a un atributo de la lista indica que est incluido en el resumen.
Introduzca el nombre entero del atributo o una parte para seleccionar los atributos que
coincidan con el texto que introduzca.
Seleccione una categora en Categora de atributo para elegir atributos de esa categora.
(Si se ha seleccionado Elementos secundarios de) Seleccione una opcin en Categora de
elemento y Plantilla de elemento.
8. Seleccione las funciones estadsticas que desee que calcule el resumen.
9. Pulse Asignar para asignar las salidas de las funciones seleccionadas a atributos de salida.
Tambin puede crear un atributo para una salida.
10. (Opcional) Haga clic en Evaluar para comprobar que los valores de salida son como se
esperaban.
12. (Opcional) Para verificar el anlisis, puede examinar los resultados que genera utilizando
datos histricos.
a. En la lista de anlisis, pulse con el botn secundario sobre el nombre del anlisis y
b. Introduzca una hora de inicio y finalizacin que no sean posteriores a la hora actual y
pulse Generar resultados para ver una lista de resultados.
marca de verificacin de color verde de la barra de herramientas). Esta accin no ejecuta el
anlisis.
14. Para guardar el anlisis, haga clic en Ingresar en la barra de herramientas. El anlisis se
guarda e inserta y puede ejecutarse.
Anlisis de generacin de marcos de evento

Un anlisis de generacin de marcos de evento especifica las condiciones de inicio y
finalizacin de los marcos de evento.
Este tipo de anlisis incluye una o dos expresiones. Cuando una condicin nica activa el inicio
y la finalizacin de un marco de evento, solo se necesita la expresin StartTrigger. Por ejemplo,
el aumento de un valor de temperatura por encima de un umbral puede iniciar un marco de
evento y finalizarlo al volver a situarse por debajo del umbral. Cuando las condiciones de inicio
y finalizacin sean distintas, se necesitar tambin una expresin EndTrigger.

Dado que prueban las condiciones de inicio y finalizacin, las expresiones de los anlisis de
generacin de marcos de evento deben dar como resultado verdadero o falso.
Un pico en los datos de entrada puede activar el inicio de un marco de evento 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. Especifique el intervalo de tiempo en StartTrigger
verdadero para.
Los anlisis de marcos de evento se basan en las plantillas de marcos de evento, que
especifican los atributos de marcos de evento que se generan. Antes de crear un anlisis de
generacin de marcos de evento, asegrese de que la plantilla de marcos de evento est
disponible.
Los marcos de evento incluyen, por lo general, un elemento de referencia. El elemento asociado
con un anlisis de generacin de marcos de evento se convierte en el elemento de referencia
para sus marcos de evento generados.
En algunos eventos, como los cierres forzados, es posible que desee evaluar las condiciones
que conducen a ese evento. Para ello, puede generar marcos de evento de causa raz. Para
todos los marcos de evento, se genera un marco de evento de causa raz secundario que
captura los atributos durante un intervalo de tiempo especfico justo antes del inicio del marco
de evento.
En esta seccin
Crear una plantilla de anlisis de generacin de marcos de evento
Crear anlisis de generacin de marcos de evento
Especificar durante cunto tiempo debe ser verdadero un activador de inicio
Crear una plantilla de anlisis de generacin de marcos de evento

Antes de crear una plantilla de anlisis de generacin de marcos de evento, asegrese de que la
plantilla de marcos de evento est disponible.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Biblioteca y en el rbol de
navegacin, seleccione el elemento donde desee crear la plantilla de anlisis.
de elementos se abrir en el panel del visor. Si no existe ninguna plantilla de anlisis, haga
clic en Crear plantilla de anlisis para crear la primera. Si existen plantillas, haga clic en el
icono del botn Plantilla de anlisis nueva de la barra de herramientas situado encima
5. En Tipo de anlisis, haga clic en Generacin de marco de evento.
6. Opcional: Haga clic en Seleccionar un elemento de ejemplo y elija un elemento en funcin
de la plantilla de elementos actual para poder utilizar sus valores en la evaluacin de la
plantilla de anlisis. Las plantillas no tienen datos concretos asociados con sus atributos. Es

imposible evaluar una expresin en una plantilla de anlisis, excepto tomando prestados
atributos de valor de un determinado elemento para ello. El elemento que seleccione se
mostrar en Elemento de ejemplo.
7. Seleccione una opcin en Plantilla de marco de evento. La plantilla determina la clase de
marco de evento que se generar.
8. Introduzca una expresin en StartTrigger. Representa la condicin booleana que inicia un
marco de evento.
9. Opcional: Si una condicin diferente finaliza el marco de evento, introduzca la expresin en
el campo EndTrigger.
10. Opcional: introduzca un intervalo de tiempo en StartTrigger verdadero para. Este intervalo
indica durante cunto tiempo debe ser verdadera la condicin StartTrigger para poder
iniciar un marco de evento. La configuracin de este intervalo de tiempo reduce la aparicin
de marcos de evento no deseados debido a una fluctuacin momentnea de los datos de
entrada.
11. Opcional: Seleccione Generar marco de evento de causa principal antes del inicio del marco
de evento principal y especifique una duracin para generar un marco de evento de causa
raz para cada marco de evento. Un marco de evento de causa raz captura datos de activo
durante el intervalo de tiempo indicado, lo que permite analizar las condiciones justo antes
de que se inicie un marco de evento.
14. Haga clic en Ingresar para guardar la plantilla de anlisis y crear una instancia del anlisis
para todos los elementos secundarios de la plantilla de elementos.
Crear anlisis de generacin de marcos de evento

Antes de crear un anlisis de generacin de marcos de evento, asegrese de que la plantilla de
marcos de evento est disponible.
Procedimiento
1. En el panel de navegacin de PI System Explorer, haga clic en Elemento y en el rbol de
2. Haga clic en la pestaa Anlisis. Si el elemento no tiene ningn anlisis, haga clic en Crear
anlisis; si tiene alguno, haga clic en el icono Nuevo anlisis en la barra de herramientas
encima de la tabla de anlisis.
5. En Tipo de anlisis, haga clic en Generacin de marco de evento.
6. Seleccione una opcin en Plantilla de marco de evento. La plantilla determina la clase de
marco de evento que se generar.
7. Introduzca una expresin en StartTrigger. Representa la condicin booleana que inicia un
marco de evento.

8. Opcional: Si una condicin diferente finaliza el marco de evento, introduzca la expresin en

el campo EndTrigger.
9. Opcional: introduzca un intervalo de tiempo en StartTrigger verdadero durante. Este
intervalo indica durante cunto tiempo debe ser verdadera la condicin StartTrigger para
poder iniciar un marco de evento. La configuracin de este intervalo de tiempo reduce la
aparicin de marcos de evento no deseados debido a un pico momentneo en los datos de
entrada.
12. Pulse Ingresar para guardar el anlisis e insertarlo para que pueda utilizarse.
Especificar durante cunto tiempo debe ser verdadero un activador de inicio

Un anlisis de generacin de marcos de evento inicia un marco de evento cuando la condicin
del activador de inicio es verdadera. Dado que el pico aleatorio de un valor de entrada puede
convertir a esa condicin en verdadera, estos datos ruidosos pueden generar muchos marcos
de evento no deseados.
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. Introduzca un valor en el campo StartTrigger verdadero
durante para especificar ese intervalo de tiempo.
Cuando una condicin de activador de inicio pase a ser verdadera, el valor StartTrigger
verdadero durante determina cunto tiempo es necesario esperar para volver a evaluarla, si
sigue siendo verdadera y si se ha iniciado un marco de evento. La hora de inicio del marco de
evento es la hora a la que el activador de inicio ha sido verdadero.
El valor de StartTrigger verdadero durante no afecta a la hora de finalizacin del marco de
evento.
Gestin de los anlisis de un elemento

Cuando se crea un anlisis, se aade a una tabla de anlisis encima de la expresin. Podr ver el
estado actual de cada anlisis de la tabla, si est asociado o no con una plantilla, su tipo de
anlisis, nombre y estado de reposicin. Pase el puntero del ratn sobre los elementos o los
iconos de la lista para ver su informacin sobre herramientas.
Para ver la expresin y planificacin de un anlisis, seleccinelo en la lista de anlisis.
En la tabla de anlisis, podr realizar las siguientes operaciones:
Crear un anlisis
Haga clic en el icono Nuevo anlisis en la parte superior de la tabla.
Ejecutar o detener un anlisis seleccionado

Seleccione un anlisis y haga clic en el icono Ejecutar o Detener en la parte superior de la
tabla, o haga clic con el botn secundario en cualquier lugar de la tabla y seleccione Nuevo.
Vista previa de resultados

Puede obtener una vista previa de los resultados de un anlisis para ver cmo funciona a lo
largo de un intervalo de tiempo. Pulse con el botn secundario sobre un anlisis y seleccione

Vista previa de los resultados. Puede exportar la tabla de resultados a una hoja de clculo o
copiar filas seleccionadas de la tabla de resultados en otras aplicaciones.
Seleccionar columnas para mostrar

Pulse con el botn secundario sobre cualquier encabezado de columna de la tabla de anlisis
y seleccione encabezados para mostrar.
Reponer datos para un anlisis

Haga clic con el botn secundario sobre un anlisis y seleccione Reponer.
Ir a la plantilla
Un anlisis incluido en la lista con el icono de plantilla se basa en un anlisis de
plantilla. Para abrir la plantilla directamente desde el anlisis, pulse con el botn secundario
sobre el anlisis y seleccione Ir a plantilla.
Restablecer a plantilla
Solo puede realizar cambios de programacin en un anlisis que se base en una plantilla de
anlisis. Para volver a sincronizar la programacin de un elemento con la programacin de
su plantilla, pulse con el botn secundario sobre el anlisis y seleccione Restablecer a
plantilla.
Convertir a plantilla
Si el elemento de un anlisis se deriva de una plantilla de elementos, podr convertir el
anlisis en una plantilla de anlisis en esa plantilla de elementos. Pulse con el botn
secundario sobre el anlisis y seleccione Convertir a plantilla. Esta funcin permite crear y
depurar un anlisis en relacin con un elemento especfico antes de generalizarlo como
plantilla.
Nota:
Si alguna de las salidas de anlisis escribe en un PI point especfico, se le solicitar que
elija cmo especificar el PI point en la plantilla de anlisis para garantizar que las
salidas de los anlisis derivados escriban en PI points nicos.
En esta seccin
Reponer datos de un anlisis
Gestin de la seguridad de los anlisis y las plantillas de anlisis
Reponer datos de un anlisis

Un anlisis genera nuevos datos para sus atributos de salida, que normalmente estn
mapeados a PI points para guardar los datos y elaborar historiales de ellos.
Puede ejecutar un anlisis a lo largo de un perodo anterior para reponer los datos de los PI
points mapeados a sus atributos de salida. En el caso de un PI point que ya contenga datos para
el perodo de tiempo, deber eliminar esos datos antes de utilizar la reposicin.
Procedimiento
1. En la lista de anlisis de la pestaa Plantilla de anlisis, haga clic con el botn secundario
sobre el anlisis en ejecucin que desee utilizar para reponer datos.
2. Seleccione Reposicin en el men emergente.
3. Especifique el perodo de tiempo para el que desea reponer datos.

4. Haga clic en Aceptar para iniciar la reposicin. La columna Estado del anlisis muestra un
indicador de progreso hasta que finaliza la reposicin.
5. Opcional: Para consultar el estado de la reposicin o cancelarla, haga clic con el botn
secundario en el anlisis y haga clic en Estado de reposicin.
Gestin de la seguridad de los anlisis y las plantillas de anlisis

Puede consultar o gestionar permisos para limitar el acceso a los anlisis y las plantillas de
anlisis en dos niveles:
Para un nico anlisis o plantilla de anlisis:
1. En la lista de la pestaa Anlisis (o Plantillas de anlisis), pulse con el botn secundario

sobre el anlisis (o la plantilla de anlisis) y seleccione Seguridad.
2. En la ventana Permisos, consulte o modifique los grupos y permisos y, a continuacin, haga
clic en Aceptar.
Para todos los anlisis o plantillas de anlisis en una base de datos de AF:
1. Haga clic en Base de datos en la barra de herramientas de la ventana de PI System Explorer

para abrir la ventana Seleccionar base de datos.
2. Pulse con el botn secundario sobre una base de datos y seleccione Seguridad > Anlisis o
Seguridad > Plantillas de anlisis.
3. En la ventana Permisos, consulte o cambie los grupos y permisos y, a continuacin, haga clic
en Aceptar.
Anlisis de ejemplo
Los anlisis de ejemplo incluidos en esta seccin realizan los siguientes clculos en la misma
base de datos de AF:
1. Utiliza un anlisis de tipos de una expresin para realizar un seguimiento de la desviacin
de la eficiencia por parte del activo y los procesos representados por el elemento, Etileno.
2. Crea una plantilla para generar un conjunto de anlisis de resumen que sumen la energa
total extrada por todos los procesos de una refinera. La plantilla de elementos a partir de la
cual se ha creado el elemento de cada refinera se denomina Refinera.
3. Crea marcos de evento para capturar datos siempre que el promedio de eficiencia de
ejecucin de 15 minutos del elemento, Etileno, descienda por debajo del 90%.
Crear un anlisis de expresin

En este ejemplo se muestra cmo crear un anlisis de tipos de expresin. El anlisis realiza un
seguimiento de la desviacin de la eficiencia respecto de la eficiencia meta.
En primer lugar, calcularemos el promedio de eficiencia por horas y despus determinaremos
el grado de desviacin respecto a la eficiencia meta.
En este ejemplo, se utiliza un PI point existente para almacenar los datos de los resultados (la
desviacin respecto de la eficiencia meta, a medida que vara a lo largo del tiempo). Cuando
cree sus propios anlisis, OSIsoft le recomienda crear los PI points que necesite para los datos
de resultados antes de crear el anlisis.

Procedimiento
1. En Elementos, vaya al elemento para el que desea realizar el anlisis, Etileno.
2. Seleccione la pestaa Anlisis.

3. Cree un anlisis.
Para ello, haga clic en Crear nuevo anlisis o en el botn correspondiente a los anlisis
nuevos .
4. En Tipo de anlisis, especifique Expresin.

El tipo de anlisis de expresin es el ms simple; solo contiene una o varias expresiones e
informacin sobre la programacin. Para obtener ms informacin, consulte Anlisis de
expresiones.
5. Escriba un nombre para el anlisis en el campo Nombre; por ejemplo, ClcEficiencia.
6. Cree una variable que incluir el valor de constante de la eficiencia meta.
a. En la tabla de expresiones, escriba el nombre Meta para la nueva variable en la columna
Nombre.
b. Introduzca 90 en la columna Expresin. Indica que el valor de constante de la variable

es .
7. Cree una segunda variable para calcular el promedio de eficiencia por hora.
a. Haga clic en Aadir nueva expresin.
b. Asigne a la variable el nombre EficienciaPorHora.
c. Introduzca la siguiente sintaxis de ecuacin de rendimiento en la columna Expresin:
TagAvg('Efficiency', '*-1h', '*')

Esta expresin calcula el promedio del atributo denominado Eficiencia a lo largo de la

ltima hora.
8. Cree una tercera variable para calcular en qu grado la eficiencia por hora se desva de la
eficiencia meta, 90.
a. Haga clic en Aadir nueva expresin.
b. Asigne a la variable el nombre Desviacin.
c. Introduzca la siguiente expresin en la columna Expresin:
HourlyEfficiency - Target
9. Guarde el resultado de la variable, Desvo, en un PI point.
a. Haga clic en Hacer clic para asignar en la columna Atributo de salida.
b. Cree otro atributo de AF y denomnelo, por ejemplo, DiferenciaEficiencia.
Defina el atributo como una referencia de datos de PI point a un PI point existente para
almacenar estos datos de resultados.
10. En Programacin, especifique Peridico.

11. Haga clic en Configurar y especifique un perodo de 30 segundos. El clculo se ejecutar
cada 30 segundos.
12. Para comprobar si los datos son vlidos, haga clic con el botn secundario sobre el anlisis y
a. El intervalo de tiempo predeterminado de la vista previa va desde el momento actual
hasta la medianoche anterior, pero puede especificar otra hora de inicio o de finalizacin
si lo prefiere.
b. Haga clic en Generar resultados.
13. Cuando est satisfecho con el nuevo anlisis, guarde su trabajo.

14. Busque el crculo de color verde en la columna de estado de la tabla de anlisis, para
comprobar que el servicio est ejecutando el anlisis.
15. Tambin, puede reponer los datos a lo largo de un perodo de tiempo, si ese intervalo de
tiempo no contiene datos todava.
Los resultados se repondrn en el atributo de salida que haya asignado a una referencia de
datos de PI point en el Paso 9. Si lo desea, puede eliminar los datos existentes con
anterioridad y, a continuacin, reponer ese intervalo de tiempo.
a. Haga clic con el botn secundario sobre el anlisis en la lista de anlisis y seleccione
Reponer.
b. Especifique una hora de inicio y de finalizacin para la reposicin.
c. Haga clic en Iniciar.

En este ejemplo se muestra cmo crear una plantilla para generar un conjunto de anlisis de
resumen. La plantilla de anlisis suma la energa total extrada de todos los procesos de una
refinera.
Procedimiento
1. En Biblioteca, seleccione la plantilla de elementos para el activo que desea analizar.
En este ejemplo, la plantilla de anlisis se denomina Refinera. Es la plantilla a partir de la
cual se crear el elemento de cada refinera.
2. Seleccione la pestaa Plantillas de anlisis.
3. Haga clic en Crear plantilla de anlisis o en el botn para las plantillas de anlisis nuevas
.
4. En Tipo de anlisis, especifique Resumen.

Los anlisis de resumen calculan datos estadsticos para los atributos especificados, como el
total o el promedio. Para obtener ms informacin, consulte Anlisis de resumen.
Al final de este procedimiento se muestra un ejemplo de la configuracin del cuadro de
dilogo Plantillas de anlisis.
5. Escriba un nombre para el anlisis en el campo Nombre; por ejemplo, ResumenEnerga.
6. Haga clic en Seleccionar un elemento de ejemplo para especificar el elemento que PI System
Explorer utilizar como orientacin para definir la plantilla de anlisis. Por ejemplo, en la
lista de elementos derivados de la plantilla Refinera, seleccione Refinera de
Rotterdam y haga clic en Aceptar.
7. En Atributos de resumen de, seleccione Elementos secundarios de Refinera de Rotterdam
para incluir la informacin de todos los elementos secundarios de la refinera.
8. Configure los atributos para resumir.
a. Introduzca el nombre del atributo en Nombre de atributo.
Puede utilizar un carcter comodn para recopilar informacin sobre atributos con
nombres similares. Por ejemplo, introduzca la cadena Power* para especificar todos los
atributos que empiecen por Power. Los atributos encontrados se mostrarn en la tabla
Atributos.
b. Seleccione la categora del atributo en el campo Categora de atributo.

c. En Seleccione la funcin o funciones para escribir en un atributo, seleccione la funcin

para sumar los datos. En este caso, seleccione Total.
d. Pulse Asignaren la columna Salida(s) y seleccione Nueva plantilla de atributos.
El resultado de esta suma se guardar en este atributo, que debe definir como una
referencia de datos de PI point.
e. Utilice los parmetros de sustitucin predeterminados para los campos PI Server y
Nombre de tag.
f. Haga clic en Ajustes.
g. Seleccione Creacin de tag para crear un tag.
h. Haga clic en el botn de examinar del tipo de punto y establezca Clase del punto en
classic y haga clic en Aceptar.
i. Deje los valores predeterminados en los dems campos y pulse Aceptar para cerrar la
ventana Referencia de datos de PI Point.
j. Haga clic en Aceptar para cerrar la ventana Propiedades de plantilla de atributos.
9. Pulse Evaluar y compruebe si el resultado devuelto en la columna Valor es vlido.
10. En Programacin, especifique Activado por evento.
11. Para ver los resultados de los datos recientes, haga clic con el botn secundario sobre el
anlisis y seleccione Vista previa de resultados.
a. El intervalo de tiempo predeterminado de la vista previa va desde el momento actual
hasta la medianoche anterior, pero puede especificar otra hora de inicio o de finalizacin.
b. Haga clic en Generar resultados.
12. Cuando est satisfecho con la nueva plantilla de anlisis, guarde su trabajo.
13. Para crear la referencia de datos de PI point que utilizar este anlisis con todas las
refineras creadas a partir de esta plantilla, en Elementos, vaya a Petrolux Corporation
\Downstream\Refineries.
a. Pulse con el botn secundario del ratn sobre el elemento Refineras y seleccione
Crear o actualizar referencia de datos para crear la referencia de datos de PI point para
cada refinera.
b. Guarde su trabajo.

Ejemplo
Crear de forma automtica marcos de evento para realizar un seguimiento

de los datos
En el ejemplo, Crear un anlisis de expresin, hemos creado un anlisis de muestra para
realizar un seguimiento de la desviacin de la eficiencia de un proceso respecto a la eficiencia
meta. En este ejemplo, crearemos marcos de evento para capturar datos siempre que el
promedio de eficiencia de ejecucin de 15 minutos descienda por debajo del 90%.
Procedimiento
1. En la biblioteca, abra Plantillas.
2. Cree una plantilla de marcos de evento.
Haga clic con el botn secundario sobre Plantillas de marcos de evento y seleccione
Nueva plantilla.
O seleccione Nueva plantilla en la barra de mens.
3. Asigne a la plantilla el nombre AnomalaEficiencia.
4. En el campo Patrn de nombres, seleccione %ELEMENT% y, a continuacin,
%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.
El campo Patrn de nombres permite crear una variable para el nombre de los marcos de
evento generados a partir de la plantilla, de forma que cada uno de esos marcos de evento
tenga un nombre exclusivo e identificable. Puede utilizar la lista desplegable para incluir
cadenas de sustitucin que se resolvern en el momento de la creacin. Por ejemplo, el
patrn de nombres "EF%ELEMENT%_%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%.

La cadena de sustitucin STARTTIME incluye el patrn de formato fecha-hora que se

utilizar.
5. Haga clic en la pestaa Grupos de PI.

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. Denomnela Eficiencia.
c. Haga clic en Ajustes e introduzca la siguiente cadena de configuracin en Nombre de
tag:.\Elements[.]|Efficiency; uom=%.
Esta plantilla crear una referencia de datos de PI point denominada Eficiencia, para
cada elemento.
d. En el campo UOM predeterminada, especifique porcentaje.
7. Navegue dentro de Elementos hasta el elemento, Etileno, para el que desea crear un
anlisis, en Crear un anlisis de expresin.
El elemento se encuentra ubicado en Petrolux Corporation\Petrochemicals\Maua
\Ethylene.
8. Seleccione la pestaa Anlisis.
9. Pulse el botn Nuevo anlisis.
10. Asigne al anlisis el nombre EventoAnomalaEficiencia.
11. Defina el campo Tipo de anlisis como Generacin de marcos de evento.
12. En Plantilla de marco de evento, especifique AnomalaEficiencia. Esta es la plantilla de
marcos de evento que acaba de crear en los pasos anteriores.

13. En StartTrigger, introduzca la expresin:TagAvg('Efficiency', '*-15m', '*') <90

Crear un marco de evento siempre que el promedio de eficiencia de 15 minutos disminuya
por debajo del 90%.
14. En EndTrigger, introduzca la expresin:TagAvg('Efficiency', '*-15m', '*') >92
Finalizar el marco de evento siempre que el promedio de eficiencia de 15 minutos se
recupere y supere el 92%.
15. Al hacer clic en Evaluar, la columna Valor se rellenar con Verdadero o Falso para cada
una de las condiciones.
16. Seleccione Peridico para la programacin y haga clic en Configurar para que el anlisis se
ejecute cada minuto.
Gestin de anlisis en la base de datos de AF

(Esta funcin est disponible si su instalacin de PI System Explorer incluye el plug-in de
gestin de anlisis.)
Haga clic en Anlisis en el panel del navegador para ver y gestionar los anlisis de la base de
datos de AF actual. En el panel del navegador podr especificar criterios de filtro para mostrar
una tabla de anlisis en el visor. Las columnas de tabla son:

Status
(Tipo de anlisis)
Elemento
Nombre de anlisis
Plantilla
Estado de reposicin
Puede llevar a cabo diferentes acciones en los anlisis de la tabla:
Filtrar
En la lista desplegable Seleccionar filtro, seleccione un filtro (por ejemplo, Status). Los
grupos de cada valor de filtro (por ejemplo, En ejecucin o Detenido) se mostrarn debajo
del filtro con un recuento que muestra el nmero de anlisis en cada grupo. Seleccione un
grupo para mostrar los anlisis que coinciden con l en la tabla.
Operaciones
Aplique las operaciones de iniciar, detener y reponer a todos los anlisis seleccionados de la
tabla.
Detalles de anlisis
Haga clic en el botn de alternancia de Detalles de anlisis para ver los detalles de los
anlisis seleccionados actualmente en la tabla.
Para ver un resumen de la configuracin y el estado del anlisis, haga clic en la pestaa
Informacin general.
Para ver detalles de los errores, haga clic en la pestaa Errores y avisos.
Para ver o editar los anlisis seleccionados, haga clic en Configuracin de anlisis para ir
a la pestaa Anlisis de su elemento asociado.
Gestin de PI Analysis Service

(Estas opciones estn disponibles si su instalacin de PI System Explorer incluye el mdulo
Analysis Management y ha iniciado sesin con una cuenta de usuario con permisos para
configurar PI Analysis Service.)
PI Analysis Service ejecuta todos los anlisis en el servidor de PI AF actual. Dos de sus
caractersticas le ayudarn a gestionar el servicio de anlisis:
La ventana Estadsticas de Analysis Service le permite explorar estadsticas sobre el servicio

para supervisar sus operaciones. Estas estadsticas son especialmente importantes para
diagnosticar problemas de rendimiento en una solucin. Puede guardar estas estadsticas
en un archivo de texto, que puede ofrecer un snapshot completo de su servicio de anlisis
para compartir con el personal del servicio de soporte que le ayude a resolver un problema.
La ventana Configuracin le permitir ver o modificar los valores de las propiedades del
servicio de anlisis para ajustar el rendimiento.

Ver estadsticas del servicio de anlisis

Procedimiento
1. En el panel de navegacin, haga clic en Anlisis para ver el rea de gestin de anlisis.
2. Pulse con el botn derecho del ratn en cualquier lugar del panel Operaciones y seleccione
Ver estadsticas de servicio. La ventana Estadsticas de Analysis Service muestra grupos de
estadsticas que puede utilizar para supervisar las operaciones del servicio de anlisis o
diagnosticar problemas de rendimiento e identificar una solucin.
3. Opcional: Haga clic en Actualizar para actualizar las estadsticas con datos actuales.
4. Opcional: Haga clic en Guardar para guardar las estadsticas actuales como un archivo de
texto. De esta forma, podr compartir un snapshot del estado actual de su servicio de anlisi
con el personal del servicio de soporte tcnico al cliente.
Ver o modificar el servicio de anlisis

Nota:
La modificacin de estos parmetros puede afectar muy negativamente al rendimiento
del sistema. Si tiene alguna duda sobre cmo cambiar los parmetros predeterminados,
solcite ayuda al personal del servicio de soporte tcnico al cliente.
Procedimiento
1. En el panel de navegacin, haga clic en Anlisis para ver el rea de gestin de anlisis.
2. Pulse con el botn derecho del ratn en cualquier lugar del panel Operaciones y seleccione
Ver estadsticas de servicio. En la ventana Configuracin se muestran los parmetros de las
propiedades del servicio de anlisis. Consulte el apartado Configuracin del servicio de
anlisis para conocer ms detalles sobre estos parmetros.
3. Para modificar una propiedad, edite su valor en la columna Configuracin.
4. Haga clic en Aceptar para aplicar los cambios y cerrar la ventana.
Configuracin del servicio de anlisis

En la ventana Configuracin puede modificar estos parmetros.
AutoBackfillingEnabled
Esta propiedad rellena de forma automtica las lagunas en los datos que se producen como
consecuencia de perodos en los que el servicio de anlisis no est activo. La reposicin
automtica est activada por defecto. En algunos casos, puede que no sea necesaria (por
ejemplo, en un entorno de prueba). Introduzca Falso para desactivar esta propiedad.
CacheTimeSpanInMinutes
Esta propiedad determina el intervalo de tiempo de los datos que el servicio de anlisis
almacenar en cach para los atributos utilizados como entradas de los clculos. El servicio
de anlisis recortar los datos con una antigedad de ms de 5 minutos antes de la hora de
evaluacin pendiente ms antigua. Un perodo de tiempo mayor garantiza que los datos de
entrada necesarios para los clculos estarn disponibles en la cach de los datos, pero
utiliza ms recursos de sistema. Para los clculos que requieran datos anteriores (por
ejemplo, una hora antes), puede especificar un perodo ms largo en esta opcin a fin de
conservar los datos almacenados en la cach y, de esta manera, evitar las llamadas a PI Data
Archive. Tenga en cuenta que el parmetro MaxCacheEventsPerAttributes prevalece sobre
esta opcin, por lo que ambas opciones se deben ajustar simultneamente.

CalculationsWaitTimeInSeconds
En lugar de evaluar de forma inmediata los clculos activados por eventos, puede
especificar un perodo de tiempo de espera antes de llevar a cabo la evaluacin. Este tiempo
de espera se puede utilizar para compensar las entradas que llegan ms tarde. Por ejemplo,
si un clculo depende de una interfaz con una latencia conocida de ms de 30 segundos,
podra ajustar este parmetro a 30 segundos como mnimo para asegurarse de que se
obtendr el evento ms reciente de la interfaz. Un parmetro ms largo reducir las
posibilidades de perder entradas de clculo causadas por la latencia, pero aumentar el
tiempo que tardarn en obtenerse los resultados. Tenga en cuenta que los clculos utilizan
los valores de entrada de la marca de tiempo de activacin cuando se evalan. El valor
predeterminado de esta propiedad es 5 segundos.
EvaluationPartitionSize
Los clculos se agrupan para obtener evaluaciones eficaces. Los anlisis basados en una
plantilla de anlisis con una programacin peridica, por ejemplo, se evalan juntos como
un solo grupo de clculo. Para agilizar la evaluacin, los grupos de clculo muy grandes se
dividen en subgrupos con el parmetro EvaluationPartitionSize; ahora los subgrupos se
podrn evaluar en paralelo. El valor predeterminado de esta propiedad es 10.000. Para un
grupo de anlisis con tiempos de evaluacin individual largos, es posible que desee
especificar un tamao de particin ms pequeo. La evaluacin de un grupo de 100 anlisis,
cada uno de los cuales realiza clculos de resumen de los datos de un da, puede realizarse
con ms rapidez que 4 subgrupos con un tamao de particin de 25, en funcin de los
recursos disponibles en la mquina.
EvaluationsToQueueBeforeSkipping
Si se tarda demasiado en ejecutar un grupo de clculos, la cola de los clculos en espera
puede ser imposible de manejar. Este parmetro determina cundo omitir los clculos para
evitar quedarse sin recursos. En la configuracin por defecto, si se encuentran ms de 50
evaluaciones, el servicio de anlisis empieza a omitir las evaluaciones ms antiguas para
intentar recobrar su proceso normal.
IsLoadSheddingEnabled
En algunas aplicaciones, la precisin y la integridad son esenciales y no se puede omitir
ningn clculo al margen del tiempo que tarden en realizarse. Para desactivar la omisin de
clculos, introduzca Falso en este parmetro.
IsTelemetryAllowed
Introduzca Falso para detener el envo de los datos de uso desde el servicio de anlisis al
programa de mejora de la experiencia de los usuarios. (Esto no afectar al parmetro
correspondiente de la particin en el programa, que puede configurar en PI System
Explorer.)
MaxCacheEventsPerAttribute
Cuando se alcanza este lmite, se elimina los eventos ms antiguos de la cach de datos.
Tenga en cuenta que este parmetro prevalece sobre CacheTimeSpanInMinutes.
MinCacheEventsPerAttribute
El valor por defecto 1 garantiza que al menos un evento por atributo permanecer en la
cach de datos.
NumberParallelDataPipes
Los atributos reciben actualizaciones de las fuentes de datos, como PI Data Archive, a travs
de las canalizaciones de datos. El uso de una nica canalizacin de datos para actualizar un
gran nmero de atributos puede tardar un tiempo inasumible. Para reducir el tiempo de

actualizacin, puede aumentar el nmero de canalizaciones de datos que pueden funcionar

de forma simultnea. Esto puede resultar especialmente til en el caso de clculos con datos
que presentan una alta frecuencia. Tenga presente que al aumentar el nmero de
canalizaciones de datos, aumentar la carga de trabajo de PI Data Archive.
Valor predeterminado de creacin automtica de PI Points para la plantilla

Cuando se selecciona esta opcin, el servicio de anlisis crea de forma automtica PI Points
para los atributos de salida en los anlisis derivados de las plantillas de anlisis.
Nombre de PI Point recomendado

Puede modificar aqu el patrn de nombres con cualquiera de los parmetros que se
muestran en Lista de parmetros de sustitucin de PI AF. Sin embargo, tenga en cuenta que
puede que algunos parmetros no tengan significado en el contexto de un nombre de PI
point.
Referencia de funciones de expresin

Se muestran en orden alfabtico las funciones disponibles para utilizar con expresiones de
anlisis.
Abs
Devuelve el valor absoluto de un nmero entero o real.
Sintaxis
Abs(x)
Argumentos
x
Debe ser un nmero entero o real.
Devuelve
El valor absoluto de x.
Excepciones
Si x no es un nmero entero o real, devuelve un error.
Ejemplo
Abs(1)
Abs(-2.2)
Abs('tag1')
Abs('tag1'- 'tag2')
Acos
Devuelve el coseno inverso o (arcocoseno) de un nmero entero o real. El coseno inverso de x
es el ngulo en radianes cuyo coseno equivale a x.
Sintaxis
Acos(x)

Argumentos
x
Debe ser un nmero real entre -1.0 y 1.0, inclusive.
Devuelve
El coseno inverso de x, en radianes.
Excepciones
Si x no es un nmero, o es menor que-1.0 o mayor que 1.0, devuelve un error.
Ejemplo
If 'tag1' < 1 and 'tag1' > -1 then Acos('tag1') else 0
Acos(-.5)
Acos(.75)
AND
Operador de conjuncin lgica de dos expresiones. Devuelve True si ambas expresiones son
verdaderas; devuelve False en caso contrario.
Sintaxis
expression1 AND expression2
Argumentos
expression1, expression2
Cualquier expresin que da como resultado verdadero o falso.
Devuelve
True cuando ambas expresiones son verdaderas (distintas de cero) y, en caso contrario, False
(cero).
Excepciones
Ninguna.
Ejemplo
('tag1' > 50) AND ("overlimit" = "good")
Ascii
Devuelve el cdigo de carcter ASCII del primer carcter de una cadena.
Sintaxis
Ascii(s)
Argumentos
s
Cualquier expresin que se evale en una cadena.

Devuelve
El cdigo del primer carcter de la cadena.
Excepciones
Si el argumento no es una cadena, se devuelve un error.
Ejemplo
Ascii( "D" ) = 68
Ascii( string('cdm158' ) )
Asin
Devuelve el seno inverso (arcoseno) de un nmero. El seno inverso de x es el ngulo en
radianes cuyo seno equivale a x.
Sintaxis
Asin(x)
Argumentos
x
Debe ser un nmero real entre -1.0 y 1.0, inclusive.
Devuelve
El seno inverso de x, en radianes.
Excepciones
Si x no es un nmero, o es menor que-1.0 o mayor que 1.0, devuelve un error.
Ejemplo
Asin(TagVal('tag1','y'))
Asin(-0.5)
Asin('tag1')
Atn
Devuelve la tangente inversa o (arcotangente) de un nmero entero o real. La tangente inversa
de x es el ngulo en radianes cuya tangente equivale a x.
Sintaxis
Atn(x)
Argumentos
x
Devuelve
La tangente inversa de x, en radianes.

Excepciones
Ejemplo
Atn(1)
Atn(-2.2)
Atn('tag1')
Atn('tag1'- 'tag2')
Atn2
Devuelve la tangente inversa (arcotangente) de un valor de tangente a/b. La tangente inversa
es el ngulo medido en radianes desde el eje x positivo hasta una lnea cuyos puntos finales son
el origen y las coordenadas cartesianas (b,a).
Sintaxis
Atn2(a,b)
Argumentos
a
Un nmero entero o real
b
Un nmero entero o real distinto de cero.
Devuelve
La tangente inversa en radianes del valor de tangente a/b.
Excepciones
Si a o b no representan un nmero entero o real, se devuelve un error.
Ejemplo
Atn2('tag1', 'tag2')
Atn2(1,1)
Atn2(TagVal('tag1','y'),TagVal('tag1', 'y'))
Avg
Devuelve el promedio de todos los argumentos.
Sintaxis
Avg (x1,[...])
Argumentos
x1, [...]
Pueden ser nmeros, horas o perodos, pero todos deben ser del mismo tipo.

Devuelve
El promedio de los argumentos. El resultado es el mismo tipo de datos que los operandos.
Excepciones
Los argumentos cuyos valores de tiempo de ejecucin 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.
Ejemplo
Avg(TagVal('tag1','y'),TagVal('tag2', 'y'),1,2)
El promedio del valor de tag1 a la hora y, tag2 a la hora y, y los valores 1 y 2.
Avg('y', 't', '14-Dec-97', '14 8:00')
El promedio de cuatro valores de hora diferentes.
Avg('tag1', 'tag2')
El promedio de los valores actuales de tag1 y tag2.
Badval
Pruebe un valor para ver si es incorrecto. En el caso de los puntos reales y enteros, un estado
digital es un estado incorrecto. Con los puntos digitales, un valor fuera del conjunto de estados
digitales del punto es un valor incorrecto.
Sintaxis
Badval(x)
Argumentos
x
Un valor para probar.
Devuelve
1 si el valor es incorrecto y
0 si el valor no es incorrecto
Excepciones
Devuelve 1 para los puntos blob. Devuelve0 para cadenas de caracteres.
Ejemplo
BadVal('tag1')
BadVal('digitaltag')
BadVal(TagVal('stringtag', '14-Dec-97 8:00:00'))
Bod
Obtiene la marca de tiempo de la medianoche al comienzo de un da.
Sintaxis
Bod(t1)

Argumentos
t1
Expresin de tiempo, incluida entre comillas simples.
Devuelve
La marca de tiempo del comienzo del da.
Excepciones
Ninguna.
Notas
Esta funcin es til para establecer una hora de reloj nica independiente de la duracin de
das concretos.
Ejemplo
Bod('*')
Bod('y')
Bod(FindEq('tag1', '14-Dec-06', '+17d',50))
Bom
Obtiene la marca de tiempo de la medianoche al comienzo del mes.
Sintaxis
Bom(t1)
Argumentos
t1
Una expresin de tiempo.
Devuelve
La marca de tiempo del comienzo del mes.
Excepciones
Ninguna.
Notas
das concretos.
Ejemplo
Bom('*')
Bom(PrevEvent('tag', '*'))
Bom(FindEq('tag1', '14-Dec-97', '+17d',50))
Bonm
Obtiene la marca de tiempo de la medianoche al comienzo del mes siguiente.

Sintaxis
Bonm(t1)
Argumentos
t1
Devuelve
La marca de tiempo del comienzo del mes siguiente.
Excepciones
Ninguna.
Notas
das concretos.
Ejemplo
Bonm('*')
Bonm('y')
Bonm(FindEq('tag1', '14-Dec-97', '+17d',50))
Ceiling
Devuelve el entero ms pequeo no menor que x.
Sintaxis
Ceiling(x)
Argumentos
x
Cualquier valor numrico.
Devuelve
El entero ms pequeo no menor que x.
Excepciones
Ninguna.
Ejemplo
Ceiling('tag1')
Ceiling (TagVal('tag2','14-Dec-97'))
Char
Genera una cadena a partir de cdigos de carcter ASCII.
Sintaxis
Char( x1 [, ... xn] )

Argumentos
x1, xn
Nmeros o expresiones.
Devuelve
Una cadena generada a partir de cdigos de carcter.
Excepciones
Si un argumento no es un nmero, devuelve un error.
Ejemplo
Char(80, 73) = "PI"
Char(65) = "A"
Char(6 * 9) = "6"
Compare
Comparar dos cadenas utilizando caracteres comodn ("*" y "?").
Sintaxis
Compare(s1, s2 [,caseSensitive])
Argumentos
s1, s2
Cadenas (s2 puede incluir caracteres comodn)
caseSensitive
Indicador opcional que seala si la comparacin distingue entre maysculas y minsculas.
Si es False (el valor predeterminado), la comparacin no distingue entre maysculas y
minsculas. Si es True (el valor predeterminado), la comparacin distingue entre
maysculas y minsculas.
Devuelve
1 si s1 = s2
0 de lo contrario
Excepciones
Los caracteres comodn en s1 se tratan de forma literal y no como comodines.
Ejemplo
compare("What","what",True) = 0
compare("b","a") = 0
compare("What","wha?") = 1
compare("What","wh") = 0

Concat
Concatenacin de dos o ms cadenas.
Sintaxis
Concat(s1, s2[, ... sn])
Argumentos
s1, s2, sn
Deben ser cadenas de caracteres o expresiones que produzcan cadenas de caracteres.
Devuelve
Las cadenas de caracteres, concatenadas. Esta funcin no inserta espacios en blanco entre los
argumentos. Para incluir un espacio en la cadena concatenada, aada un argumento que conste
de una cadena que sea un nico espacio incluido entre comillas dobles.
Nota:
Plantese utilizar Text, que en muchos casos es ms general y preciso que Concat.
Ejemplo
Concat("shut", "down") = "shutdown"
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 expresin que se resuelve en un valor numrico, incluido el nombre de un
atributo numrico incluido entre comillas simples, un nombre de variable o una constante.
toUnit
La UOM de salida incluida entre comillas dobles.
Devuelve
El valor numrico convertido en la UOM especificada.
Excepciones
Devuelve un error si toUnit y la UOM inicial dex no estn en la misma clase de UOM.
Ejemplo
Convert('MetricWeight', "lb")
Convert('Ambient Temperature', "C")

Cos
Devuelve el coseno trigonomtrico de un nmero entero o real.
Sintaxis
Cos(x)
Argumentos
x
Debe ser un nmero entero o real, que representa un ngulo en radianes.
Devuelve
El coseno de x.
Excepciones
Ejemplo
Cos('tag1')
Cos(1)
Cos(1.1)
Cosh
Devuelve el coseno hiperblico de un nmero entero o real.
Sintaxis
Cosh(x)
Argumentos
x
Devuelve
El coseno hiperblico de x.
Excepciones
Ejemplo
Cosh('tag1')
Cosh(.9)
Cosh(1)
Cot
Devuelve la cotangente trigonomtrica de un nmero.

Sintaxis
Cot(x)
Argumentos
x
Devuelve
La cotangente de x.
Excepciones
Si x no es un nmero, devuelve un error.
Ejemplo
Cot('tag1')
Cot(1)
Cot(1.1)
Coth
Devuelve la cotangente hiperblica de un nmero.
Sintaxis
Coth(x)
Argumentos
x
Devuelve
La cotangente hiperblica de x.
Excepciones
Ejemplo
Coth('tag1')
Coth(1)
Coth(1.1)
Csc
Devuelve la cosecante trigonomtrica de un nmero.
Sintaxis
Csc(x)
Argumentos

x
Devuelve
La cosecante de x.
Excepciones
Ejemplo
Csc('tag1')
Csc(1)
Csc(1.1)
Csch
Devuelve la cosecante hiperblica de un nmero.
Sintaxis
Csch(x)
Argumentos
x
Devuelve
La cosecante hiperblica de x.
Excepciones
Ejemplo
Csch('tag1')
Csch(1)
Csch(1.1)
Curve
Devuelve el valor y de una curva dado el valorx.
Sintaxis
Curve( x, (x1,y1) (x2,y2) (xn,yn) )
Argumentos
x
Expresin que se evala en relacin con un nmero.

x1, y1
El primer punto de la curva. Los valores xi' e yi son constantes numricas que se evalan
durante el tiempo de compilacin. Los valores definidos para xi deben ordenarse en sentido
ascendente.
Devuelve
Devuelve el valor y de la curva que corresponde al valor x. La interpolacin lineal se utiliza
entre los puntos que definen la curva. Si el valor dex es menor que x1, se devuelve y1; si es
mayor que xn,yn es el valor devuelto. Se presupone que los puntos estn ordenados en el
sentido x del ms pequeo al ms grande.
Excepciones
Si el valor x no es un nmero entero o real, se devuelve un error.
Ejemplo
curve('tag1', (0,100) (100,0) ) //inverter
curve('tag3', (25,25) (75,75) ) //limiter
Day
Extrae el da del mes a partir de una expresin de tiempo.
Sintaxis
Day(t1)
Argumentos
t1
Devuelve
El da del mes, en el rango 1-31.
Excepciones
Ninguna.
Ejemplo
Day('*')
Day('t')
Day(FindGt('tag1', '*-30d', '*',50))
DaySec
Extrae el nmero de segundos desde la medianoche a partir de una expresin de tiempo.
Sintaxis
DaySec(t1)
Argumentos
t1

Devuelve
El nmero de segundos desde la medianoche, en el rango 0-86399.
Excepciones
Ninguna.
Notas
Esta funcin es la misma que la funcin Time del paquete Performance Equation ds PI 2.x. Por
ejemplo, si la hora actual son las 8:30 A.M.,DaySec('*') devuelve 30600.
Ejemplo
DaySec('*')
DaySec('t')
DaySec(FindGt('tag1', '*-30d', '*',50))
DigState
Traduce una cadena de caracteres que representa un estado digital a su estado digital
correspondiente.
Sintaxis
DigState(s1 [, x])
Argumentos
s1
Una cadena de caracteres que representa un estado digital.
x
(Opcional) Un punto digital en el que la cadena de caracteres representa un estado digital. Si
se omite, se buscarn todos los conjuntos de estados digitales, empezando por el conjunto
digital del sistema, para la cadena proporcionada.
Devuelve
Un valor de enumeracin. En el caso de los clculos de PE de PI, se devuelve un estado digital.)
Excepciones
Si la cadena de caracteres no representa un estado digital en el conjunto de estados digitales en
el punto digital especificado, la funcin devuelve Calc Failed. Si se omite el punto digital y la
cadena de caracteres no representa un estado digital en alguno de los conjuntos digitales, se
devuelve Calc Failed.
Ejemplo
DigState("digitalstring", 'digitaltag')
StateNo(DigState("digitalstring", 'digitaltag'))
DigText
Obtiene el texto que corresponde al estado digital.

Sintaxis
DigText(digstate)
Argumentos
digstate
Un argumento que se resuelve en un estado digital.
Devuelve
El texto para el estado digital.
Excepciones
Si el argumento no es un estado digital, se devuelve una condicin de error.
Ejemplo
DigText('digitaltag')
DigText(TagVal('digitaltag','y') )
DigText('nondigitaltag') would fail with an error message
E
Devuelve el valor de e (la base del logaritmo natural).
Sintaxis
E()
Argumentos
Ninguno.
Devuelve
El valor de e (la base del logaritmo natural).
Excepciones
Ninguna.
Ejemplo
E()
ELSE
Devuelve el segundo de dos valores especificados cuando una expresin condicional IF-THEN-
ELSE es False.
Sintaxis
IF (expression) THEN (x) ELSE (y)
Argumentos
expression
Cualquier expresin que se evale como True o False.

x , y
Una expresin que devuelve un valor de salida.
Devuelve
La salida x, cuando la expresin condicional es True (distinta de cero), y la salida y, cuando la
expresin es False (cero).
Excepciones
Ninguna.
Ejemplo
IF ('tag1' > 50) THEN ('tag2') ELSE ('tag3')
EventCount
Encuentra los diferentes eventos de PI Data Archive para un punto a lo largo del intervalo de
tiempo especificado.
Sintaxis
EventCount(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
Nombre de tag, incluido entre comillas simples. Este punto debe representar una variable
continua.
starttime
Una expresin de tiempo que representa el comienzo del intervalo de tiempo objeto de
bsqueda.
endtime
Una expresin de tiempo posterior a starttime; el final del intervalo de tiempo objeto de
bsqueda.
PRECAUCIN:
Evite utilizar un tiempo futuro para endtime. Un intervalo de tiempo que contenga
eventos futuros sin archivar puede producir resultados errneos en cuanto al
recuento de eventos.
pctgood
Opcional. Porcentaje de tiempo mnimo por encima del intervalo de tiempo proporcionado
en que los valores archivados del punto son correctos
Devuelve
Diferentes eventos de PI Data Archive para el punto dentro del intervalo especificado.
Excepciones
Si el punto no tiene valores correctos o no se alcanza el mnimo de pctgood para el intervalo de
tiempo proporcionado, se devuelve un error.

Ejemplo
EventCount('tag1', 'y', '*')
EventCount('tag1', '14-Dec-97', '+1d',70)
EventCount('tag1', '14-Dec-97', '15-Dec-97')
Exp
Devuelve el exponencial de un nmero entero o real. Representa el nmero ex, donde e =
2.7182818...
Sintaxis
Exp(x)
Argumentos
x
Devuelve
El exponencial de x.
Excepciones
Ejemplo
Exp('tag1')
Exp(TagVal('tag1','14-Dec-97'))
Exp(11)
FindEq
Encuentra la primera vez, dentro de un intervalo, en que un punto es igual a un valor
proporcionado.
Sintaxis
FindEq(tagname, starttime, endtime, value)
Argumentos
tagname
El nombre de un atributo incluido entre comillas simples.
starttime
Una expresin de tiempo que representa el comienzo del intervalo para buscar. Las horas
relativas lo son respecto a la hora de finalizacin si esta no es en s misma una hora relativa.
endtime
Una expresin de tiempo que representa el final del intervalo de tiempo para buscar. Las
horas relativas lo son respecto a la hora de inicio si esta no es en s misma una expresin

relativa. Si la hora de finalizacin es anterior a la hora de inicio, se busca hacia atrs en el

intervalo.
value
Debe ser un nmero entero o real o un estado digital (cadena de caracteres), el valor para
buscar.
Devuelve
La marca de tiempo ms cercana a la hora de inicio, dentro del intervalo proporcionado, en la
que el punto fue igual al valor proporcionado.
Excepciones
Si el punto no ha sido nunca igual al valor proporcionado, FindEq devuelve un error.
Notas
FindEq se interpola entre eventos de archivado, si es necesario, para encontrar el valor que
est buscando.
Ejemplo
FindEq('tag1', 't', '*',40.0)
FindEq('digitaltag', '-1d', '*', TagVal('digitaltag', '14-Dec-97'))
FindEq('digitaltag', '14-Dec-97', '*', "On")
FindGE
Encuentra la primera vez, dentro de un intervalo, en que un punto es mayor o igual que un
valor proporcionado.
Sintaxis
FindGE(tagname, starttime, endtime, value)
Argumentos
tagname
El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas
simples.
starttime
Una expresin de tiempo que representa el comienzo del intervalo de tiempo para buscar o
una hora relativa a la hora de finalizacin si esta es una hora.
endtime
Una expresin de tiempo que representa el final del intervalo de tiempo o un tiempo (en
segundos) relativo a la hora de inicio si esta es una hora. Si la hora de finalizacin es
anterior a la hora de inicio, se busca hacia atrs en el intervalo.
value
buscar.

Devuelve
que el punto fue mayor o igual que el valor proporcionado.
Excepciones
Si el punto ha sido siempre menor que el valor proporcionado, FindGE devuelve un error.
Notas
FindGE se interpola entre los eventos de archivado, si es necesario, para encontrar el valor que
est buscando.
Ejemplo
FindGE('tag1', 't', '*',40.0)
FindGE('digitaltag', '-1d', '*', TagVal('digitaltag', '14-Dec-97'))
FindGE('tag1', '-1d', '*','tag2')
FindGT
Encuentra la primera vez, dentro de un intervalo, en que un punto es mayor que un valor
proporcionado.
Sintaxis
FindGT(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
Una expresin de tiempo que representa el comienzo del intervalo de tiempo para buscar.
Puede ser una hora relativa a la hora de finalizacin si esta es una hora.
endtime
Final del intervalo de tiempo para buscar, la expresin de tiempo o el tiempo (en segundos)
relativo a la hora de inicio si esta es una hora. Si esta hora es anterior a la hora de inicio, se
busca hacia atrs en el intervalo.
value
buscar.
Devuelve
que el punto fue mayor que el valor proporcionado.
Excepciones
Si el punto no ha sido nunca mayor que el valor proporcionado, FindGT devuelve un error.

Notas
FindGT se interpola entre los eventos de archivado, si es necesario, para encontrar el valor que
est buscando.
Ejemplo
FindGT('tag1', 't', '*',40.0)
FindGT('tag1', '-1d', '*',40.0)
FindGT('digitaltag', '-1d', '*', TagVal('digitaltag', 'y'))
FindLE
Encuentra la primera vez, dentro de un intervalo, en que un punto es menor o igual que un
Sintaxis
FindLE(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
El comienzo del intervalo de tiempo para buscar; expresin de tiempo o tiempo relativo a la
hora de finalizacin si esta es una marca de tiempo.
endtime
El final del intervalo de tiempo para buscar; expresin de tiempo o tiempo (en segundos)
value
buscar.
Devuelve
que el punto fue menor o igual que el valor proporcionado.
Excepciones
Si el punto ha sido siempre mayor que el valor proporcionado, FindLE devuelve un error.
Notas
FindLE se interpola entre los eventos de archivado, si es necesario, para encontrar el valor que
est buscando.

Ejemplo
FindLE('tag1', 't', '*',40.0)
FindLE('tag1', -3600, '*',40.0)
FindLE('tag1', 'Saturday', '*',40.0)
FindLT
Encuentra la primera vez, dentro de un intervalo, en que un punto es menor que un valor
proporcionado.
Sintaxis
FindLT(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
endtime
value
buscar.
Devuelve
que el punto fue menor que el valor proporcionado.
Excepciones
Si el punto no ha sido nunca menor que el valor proporcionado, FindNE devuelve un error.
Notas
FindLT se interpola entre eventos de archivado, si es necesario, para encontrar el valor que
est buscando.
Ejemplo
FindLT('tag1', 't', 3600,40.0)
FindLT('tag1', -1h, '*',40.0)
FindLT('tag1', '14-Dec-97 01:00:00.0001, '*',40.0)

FindNE
Encuentra la primera vez, dentro de un intervalo, en que un punto no es igual a un valor
proporcionado.
Sintaxis
FindNE(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
endtime
value
buscar.
Devuelve
que el punto no fue igual al valor proporcionado.
Excepciones
Si el punto ha sido siempre igual al valor proporcionado, FindNE devuelve un error.
Ejemplo
FindNE('tag1', 'y', '*',40.0)
FindNE('tag1', '14-Dec-97', '*',40.0)
FindNE('tag1', '14-Dec-97', 'Monday',40.0)
Float
Convertir una cadena en un nmero.
Sintaxis
Float(x)
Argumentos
x
Una cadena o un nmero.

Devuelve
Un nmero para una cadena numrica y Calc Failed para una cadena no numrica. Si x ya es un
nmero, se devuelve x.
Ejemplo
Float(12.3) = 12.3
Float('sinusoid')
Float("-12.3") = -12.3
Floor
Devuelve el entero ms grande no mayor quex.
Sintaxis
Floor(x)
Argumentos
x
Devuelve
El entero ms grande no mayor que x.
Excepciones
Ninguna.
Ejemplo
Floor('tag1')
Floor (TagVal('tag2','14-Dec-97'))
Formato
Convierte un nmero en una cadena en funcin de una expresin de formato.
Sintaxis
Format(x, format [,numType ])
Argumentos
x
Un valor numrico (real o entero).
format
Cadena de control de formato. Es la misma que se utiliza en la funcin de lenguaje C.Sprintf.
numType
Opcional. Carcter que indica el tipo de nmero: R (real) o I (entero). El valor
predeterminado es R.

Devuelve
Una cadena con formato.
Ejemplo
Format('sinusoid', "%3.3f", "R") = "66.890"
Format(45, "%3.3d") = "045"
Format(45, "%3.3d", "I") = "045"
Format(45, "%3.3d", "R") = "000" (Don't do this!)
Frac
Devuelve la parte fraccionaria de un nmero real. Devuelve 0 en el caso de los enteros.
Sintaxis
Frac(x)
Argumentos
x
Devuelve
La parte fraccionaria de x.
Excepciones
Notas
Por definicin: Int(x) + Frac(x) = x.
Ejemplo
Frac('tag1')
Frac(1.1)
Frac(TagVal('tag1', '14-Dec97'))
Hour
Extrae la hora de una expresin de tiempo.
Sintaxis
Hour(t1)
Argumentos
t1
Devuelve
La hora de la expresin de tiempo, en el rango 0-23.

Excepciones
Ninguna.
Ejemplo
Hour('*')
Hour('Saturday')
Hour('t')
IF
Introduce la condicin de una expresin IF-THEN-ELSE. Este tipo de expresin devuelve el
primero de dos valores especificados cuando una condicin es True y el segundo, cuando es
False.
Sintaxis
Argumentos
expression
Cualquier expresin que se evale como True o False.
x , y
Devuelve
Excepciones
Ninguna.
Ejemplo
InStr
Determina la ubicacin dentro de una cadena en la que se encuentra por primera vez una
subcadena.
Sintaxis
InStr([start,] s1, s2 [,caseSensitive])
Argumentos
start
Opcional. Un entero que especifica el carcter en s1 por el que se comenzar la comparacin.
Debe ser mayor o igual que 1.
s1, s2
Dos cadenas o puntos con tipos de punto de cadena para comparar.

caseSensitive
Indicador opcional que seala que la comparacin distingue entre maysculas y minsculas.
Si es 0 (el valor predeterminado), la comparacin distingue entre maysculas y minsculas;
si es 1, no distingue entre ellas.
Devuelve
0 si s2 no es una subcadena des1 que comienza por la posicin inicial; de lo contrario, la
ubicacin del carcter dondes2 coincide por primera vez con los caracteres des1 a partir de la
posicin inicial.
Excepciones
Los caracteres comodn no se tratan como comodines.
Ejemplo
InStr("What", "At") = 3
InStr("What What What", "What") = 1
InStr("what", "At", 1) = 0
InStr(4,"what","At") = 0
InStr('StringTag', "Error") = 1 (if the tag value for 'stringtag' is "Error")
InStr('StringTag',"StringTag") = 0 (if the tag value for 'stringtag' is
"Error")
IN
El operador In devuelve True si un valor est incluido en un conjunto o rango de valores; de lo
contrario, devuelve False.
Sintaxis
value In (x, y)
value In .. x1, x2, x3...xn
Argumentos
value
Cualquier valor numrico, cadena, hora, o intervalo de tiempo
x
Valor numrico u hora que indica el inicio de un rango.
y
Valor numrico u hora que indica el final de un rango.
x1, x2, x3, ... xn

Un conjunto de valores numricos, horas o intervalos de tiempo.
Devuelve
True cuando value est dentro del rango o conjunto de otros valores. De lo contrario, devuelve
False.

Excepciones
Ninguna.
Ejemplo
('tag1') In ("1", "10")
'+1h' In ('+1d', '+1s')
Int
Devuelve la parte entera de un nmero entero o real.
Sintaxis
Int(x)
Argumentos
x
Un nmero o una cadena.
Devuelve
La parte entera de x. Six es una cadena, se convierte primero en un nmero.
Excepciones
Si x no es un nmero o una cadena numrica, devuelve Calc Failed.
Ejemplo
Int('tag1')
Int(1)
Int(2.1)
Int("2.1")
IsSet
Determina si un valor de PI se ha anotado, sustituido o dudoso.
Sintaxis
IsSet(x, select)
Argumentos
x
Cualquier valor. Puede ser un nmero entero o real, un estado digital o una cadena de
caracteres.
select
Una cadena, pero solo se considera el primer carcter. "a" para anotado; "s" para sustituido
y "q" para dudoso. No distingue entre maysculas y minsculas.
Devuelve
1 si es verdadero y 0 en caso contrario.

Excepciones
Ninguna.
Ejemplo
IsSet('sinusoid', "a")
IsSet('sinusoid', "annotated")
IsSet('sinusoid', "annotatted is mispelled")
IsSet('stringtag',"annotatiiion is mispelled but it does not matter.")
IsSet('stringtag',"A")
IsSet('alarmtag1',"q")
IsSet('stringtag',"s")
LCase
Convierte en minsculas una cadena.
Sintaxis
LCase(s)
Argumentos
s
Debe ser una cadena.
Devuelve
Una cadena que se ha convertido en minsculas.
Excepciones
Si el argumento no es una cadena, devuelve un error.
Ejemplo
LCase("Stringtag") = "stringtag"
LCase('Stringtag') = "error" if the Snapshot value for the stringtag equals
"Error"
Left
Determina un nmero especfico de caracteres de una cadena empezando por la izquierda.
Sintaxis
Left(s, len)
Argumentos
s
Una cadena.
len
Un entero.

Devuelve
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("Stringtag", 3) = "Str"
Left('Stringtag', 3) = "Err" if the Snapshot value for the stringtag equals
"Error"
Len
Determina la longitud de una cadena.
Sintaxis
Len(s)
Argumentos
s
Una cadena.
Devuelve
La longitud de una cadena.
Excepciones
Ejemplo
Len("Stringtag") = 9
Len('Stringtag') = 5 if the Snapshot value for the stringtag equals "Error"
Log
Devuelve el logaritmo natural (base-e = 2.7182818...) de un nmero entero o real.
Sintaxis
Log(x)
Argumentos
x
Debe ser un nmero entero o real mayor que cero.
Devuelve
El logaritmo natural de x.
Excepciones
Si x es cero o un nmero negativo, o no es un nmero, devuelve un error.

Ejemplo
Log('*')
Log(14)
Log(TagVal('tag1', '14-Dec-97'))
Log10
Devuelve el logaritmo en base 10 de un nmero entero o real.
Sintaxis
Log10(x)
Argumentos
x
Devuelve
El logaritmo en base 10 de x.
Excepciones/Errores
Ejemplo
Log10('*')
Log10(14)
Log10(TagVal('tag1', '14-Dec-97'))
Logbase
Devuelve el logaritmo de un valor numrico positivo (x) en una determinada base (y).
Sintaxis
Logbase(x,y)
Argumentos
x
y
Un enterno positivo que indica la base del logaritmo.
Devuelve
El logaritmo de x en basey.
Excepciones

Ejemplo
Logbase(272, 2)
Logbase(1000,16)
Logbase(TagVal('tag1', '14-Dec-97'),16)
LTrim
Eliminar los espacios en blanco al comienzo de una cadena.
Sintaxis
LTrim(s)
Argumentos
s
Una cadena.
Devuelve
Una cadena con los espacios en blanco al comienzo eliminados.
Excepciones
Si s no es una cadena, se devuelve un error.
Ejemplo
LTrim(" Stringtag") = "Stringtag"
LTrim("Stringtag ") = "Stringtag "
LTrim('Stringtag') = "Error" if the Snapshot value for the stringtag equals "
Error"
Max
Devuelve el valor mximo de un conjunto de valores.
Sintaxis
Max(x1, x2, ..., xn)
Argumentos
x1...xn
Pueden ser nmeros, horas o perodos, pero todos deben ser iguales.
Devuelve
El valor mximo de los argumentos. El resultado tiene el mismo tipo de datos que los
argumentos.
Excepciones
No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecucin son estados
digitales. Si todos los valores son estados digitales, Max devuelve un error.

Ejemplo
Max('*', 'y', 'Saturday')
Max(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
Max('*'-'*-h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Median
Devuelve el valor medio (mediana) de un conjunto de tres o ms valores.
Sintaxis
Median(x1, x2, x3, [... xn])
Argumentos
x1, x2, x3, [... xn]
Todos los argumentos deben ser del mismo tipo. Introduzca como mnimo tres argumentos,
todos del mismo tipo (nmeros enteros y reales, horas o perodos de tiempo)
Devuelve
El valor medio de los argumentos de entrada. Si el nmero de argumentos es par, se devuelve
el promedio de dos valores medios.
Excepciones
digitales. La funcin debe tener ms de dos argumentos que se evalen respecto a estados no
digitales; de lo contrario, Median devuelve un error.
Notas
Median permite combinar enteros y tipos de datos reales. Median sigue el tipo de datos del
primer argumento. Por lo tanto, si el primer argumento es un punto que se evala respecto a
un entero, todas las dems entradas se convertirn a enteros por truncamiento (no por
redondeo).
Ejemplo
Median('*', 'y', 'Saturday')
Encuentra la mediana de estas marcas de tiempo: ahora, 12:00 am de ayer y 12:00 am del
sbado anterior.
Median(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
Encuentra la mediana de estos valores: 14, el valor actual de tag1, 14.5 y el valor de tag2 en
la medianoche del 14 de diciembre de 1997.
Median('*'-'*-1h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Encuentra la mediana de estas duraciones de tiempo: desde hace 1 hasta ahora, desde las
12:00 am de ayer a las 12:00 am de hoy y el tiempo total del tag1 fue equivalente a 50 entre
las 12:00 am de ayer y las 12:00 am de hoy.
Mid
Devuelve una subcadena dentro de una cadena.

Sintaxis
Mid(s, start [,len])
Argumentos
s
Una cadena.
start
Un entero que especifica la posicin del primer carcter dentro de la cadena. El primer
carcter de la cadena es el nmero 1.
len
Opcional. La longitud mxima de la cadena devuelta. El valor predeterminado es la longitud
de la cadena.
Devuelve
Los caracteres len de la cadena a la derecha (e inclusive) del primer carcter cuya posicin est
especificada por el comienzo.
Excepciones
Si los argumentos no son del tipo requerido, devuelve un error. El nmero mximo de
caracteres devueltos es 999.
Ejemplo
Mid("Stringtag", 3) = "ringtag"
Mid("Stringtag", 3, 2) = "ri"
Mid('Stringtag', 1, 1) = "E" if the Snapshot value for the stringtag equals
"Error"
Min
Devuelve el valor mnimo de un conjunto de valores.
Sintaxis
Min(x1, ..., xn)
Argumentos
x1...xn
Pueden ser nmeros, horas o perodos de tiempo, pero todos deben ser del mismo tipo.
Devuelve
El mnimo de los argumentos. El resultado tiene el mismo tipo de datos que los argumentos.
Excepciones
digitales. Si todos los valores son estados digitales, Min devuelve un error.

Ejemplo
Min('*', 'y', 'Saturday')
Min(14, 'tag1', 14.5, TagVal('tag2','14-Dec-97'))
Min('*'-'*-1h', 't'-'y', TimeEq('tag1', 'y', 't',50))
Minute
Extrae el minuto de una expresin de tiempo.
Sintaxis
Minute(t1)
Argumentos
t1
Devuelve
El minuto de la expresin de tiempo, en el rango 0-59.
Excepciones
Ninguna.
Ejemplo
Minute('*')
Minute('1')
Minute('*-1h')
Mod
El operador de mdulo (mod) devuelve el resto del cociente de dos valores numricos. En el
caso de A mod B, es el resto de A/B.
Sintaxis
x mod y
Argumentos

Devuelve
Excepciones
Ninguna.
Ejemplo
'att1' mod 7

Month
Extrae el mes de una expresin de tiempo.
Sintaxis
Month(t1)
Argumentos
t1
Devuelve
El mes de la expresin de tiempo, en el rango 1-12.
Excepciones
Ninguna.
Ejemplo
Month('*')
Month('1')
Month('*-1h')
NextEvent
Encuentra la hora del siguiente evento que ha sido archivado de un punto despus de una hora
determinada.
Sintaxis
NextEvent(tagname, time)
Argumentos
tagname
simples.
time
Devuelve
La marca de tiempo del siguiente evento que ha sido archivado para el tagname posterior a la
hora indicada.
Excepciones
Si el punto no tiene datos en el archivo despus de la hora especificada, devuelve un error.
Ejemplo
NextEvent('tag1','*')
NextEvent('digitaltag', '*')

NextVal
Encuentra el valor del siguiente evento que ha sido archivado de un punto despus de una hora
determinada.
Sintaxis
NextVal(tagname, time)
Argumentos
tagname
simples.
time
Devuelve
El valor del siguiente evento que ha sido archivado para el tagname posterior a la hora
indicada.
Excepciones
Si el punto no tiene datos en el archivo despus de la hora especificada, devuelve un error.
Ejemplo
NextVal('tag1','*-1h')
NextVal('digitaltag', '14-Dec-97')
Noon
Devuelve la marca de tiempo correspondiente a las doce del medioda de una expresin de
tiempo dada.
Sintaxis
Noon(t1)
Argumentos
t1
Expresin de tiempo incluida entre comillas.
Devuelve
Una marca de tiempo correspondiente a las doce del medioda de una expresin de tiempo
dada.
Excepciones
Ninguna.
Notas
das concretos.

Ejemplo
Noon('*')
Noon('14-Dec-97')
NoOutput
No escribe el resultado del clculo actual.
Sintaxis
NoOutput()
Argumentos
Ninguno.
Notas
Es importante incluir los parntesis despus de esta funcin (utilice NoOutput() en lugar
deNoOutput porqueNoOutput es una sintaxis no vlida). Esta funcin solo se aplica al clculo
actual. La salida de esta funcin en pipetest.exe es "NoOutput() Called".
Ejemplo
If 'PITag' < 100 or 'PItag' > 0 then 'PITag' else NoOutput()
Normalrnd
Devuelve un nmero aleatorio que correlaciona la curva de distribucin normal utilizando un
promedio y una desviacin estndar determinados.
Sintaxis
Normalrnd(x, y)
Argumentos
x
Un nmero real que especifica el promedio de la curva de distribucin normal.
y
Un nmero real que especifica la desviacin estndar de la curva de distribucin normal.
Devuelve
Un nmero aleatorio que correlaciona la curva de distribucin normal con un promedio y una
desviacin estndar determinados.
Excepciones
Ninguna.
Ejemplo
Normalrnd(300, 2.5)

NOT
El operador NOT devuelve la negacin de una expresin. True para una expresin falsa y False
para una expresin verdadera.
Sintaxis
NOT expression
Argumentos
expression
Devuelve
True cuando expression es falsa y False cuando expression es verdadera.
Excepciones
Ninguna.
Ejemplo
NOT ('tag1') In ("1", "10")
OR
Operador de disyuncin lgica 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 expression2
Devuelve
True cuando la expression1 o la expression2 son verdaderas (distintas de cero); devuelve False
(cero) si las dos son falsas.
Excepciones
Ninguna.
Ejemplo
('tag1' > 50) OR ("overlimit" = "good")
ParseTime
Traduce una expresin de tiempo de PI en una marca de tiempo.
Sintaxis
ParseTime(s1)

Argumentos
s1
Deb ser una cadena de caracteres en formato de tiempo de PI, incluida entre comillas
dobles.
Devuelve
La marca de tiempo correspondiente a s1.
Excepciones
Si s1 no es una cadena de caracteres, o existe un error de sintaxis, devuelve un error.
Notas
No hay ninguna diferencia entre ParseTime("14-Nov-92") y la expresin de tiempo '14-
Nov-92', excepto que la llamada a ParseTime tarda ms. Esto se debe a que la expresin de
tiempo (incluida entre comillas simples) se evala durante la compilacin y no en tiempo de
ejecucin.
Si escribe ParseTime('14-Nov-92') (utilizando comillas simples y no dobles), el analizador
detecta un error, porque la expresin entre comillas simples ya se ha traducido en una marca
de tiempo durante la compliacin.
La expresin ParseTime(":12:00:00") no es igual que la expresin de tiempo ':
12:00:00'. La expresin de ParseTime se evala en tiempo de ejecucin y se traduce
utilizando '*' como base temporal relativa, en tanto que la expresin de tiempo se evala en
tiempo de compilacin y utiliza la hora que la expresin ha analizado como base temporal
relativa.
Ejemplo
ParseTime("14-Dec-97")
ParseTime("t")
PctGood
Encuentra el porcentaje de tiempo, a lo largo de un intervalo determinado, durante el cual los
valores archivados del punto son correctos.
Sintaxis
PctGood(tagname, starttime, endtime)
Argumentos
tagname
Un nombre de tag.
starttime
El comienzo del intervalo de tiempo objeto de la bsqueda debe ser una expresin de
tiempo.
endtime
El final del intervalo de tiempo objeto de la bsqueda debe ser una expresin de tiempo
posterior a la hora de inicio.

Devuelve
Un nmero entero o real de 0,0 a 100,0: el porcentaje del tiempo proporcionado durante el cual
los valores del punto son correctos.
Ejemplo
PctGood('tag1', 'y','*')
PctGood('tag1', '-1h', '*')
Pi
Devuelve el valor de pi.
Sintaxis
Pi()
Argumentos

Devuelve
El valor de pi
Excepciones
Ninguna.
Ejemplo
Pi()
Poly
Evala el polinomio c0 + c1x + c2x2 + +cnxn.
Sintaxis
Poly(x, c0, ..., cn)
Argumentos
x
La variable. Debe ser un nmero entero o real.
c0...cn
Los coeficientes. Debe haber como mnimo un coeficiente. Todos deben ser nmeros
Devuelve
El valor de un polinomio.
Excepciones
Si x o cualquier coeficiente no es un nmero entero o real, Poly devuelve un error.
Ejemplo
Poly('tag1',1,1)

Pow
Devuelve el valor x elevado a la potencia de y.
Sintaxis
Pow(x,y)
Argumentos
x
Cualquier valor numrico
y
Cualquier valor numrico
Devuelve
El valor de x elevado a la potencia de y.
Excepciones
Ninguna
Ejemplo
Pow(400, 2)
Pow(100.15,16)
Pow(TagVal('tag1', '*'),8)
PrevEvent
Encuentra la hora del evento que ha sido archivado de un punto anterior a una hora
determinada.
Sintaxis
PrevEvent(tagname, time)
Argumentos
tagname
simples.
time
Devuelve
La marca de tiempo del evento que ha sido archivado para el tagname anterior a la hora
indicada.
Excepciones
Si el punto no tiene datos en el archivo anteriores a la hora especificada, devuelve un error.

Ejemplo
PrevEvent('tag1', '*')
PrevEvent('tag1','14-Dec-97')
PrevVal
Encuentra el valor del evento que ha sido archivado de un punto anterior a una hora
determinada.
Sintaxis
PrevVal(tagname, time)
Argumentos
tagname
simples.
time
Devuelve
El valor del evento que ha sido archivado para el tagname anterior a la hora indicada.
Excepciones
Si el punto no tiene datos en el archivo anteriores a la hora especificada, devuelve un error.
Ejemplo
PrevVal('tag1', '*')
PrevVal('tag1','14-Dec-97')
PStDev
Devuelve la desviacin estndar de la muestra: la desviacin estndar de un conjunto de dos o
ms valores que constituyen la poblacin entera. La desviacin estndar de una poblacin
x1...xn es
donde es la media de los argumentos; es decir,
Sintaxis
PStDev(x1, x2, ..., xn)

Argumentos
x1...xn
Pueden ser nmeros o expresiones de tiempo, pero todos deben ser iguales.
Devuelve
La desviacin estndar de los argumentos. Si los argumentos son nmeros, el resultado es un
nmero; si los argumentos son horas o perodos de tiempo, el resultado es un perodo de
tiempo.
Excepciones
digitales. Si todos los valores son estados digitales, PStDev devuelve un error.
Notas
En la mayora de los casos, debe utilizar Sstdev en lugar de PstDev. Sstdev calcula la
desviacin estndar de una muestra.
Ejemplo
PStDev('tag1', 'tag2')
PStDev('*','14-Dec-97', 'y')
PStDev('*'-'y','14-Dec-97'-'*', '-1h')
Rand
Devuelve un nmero aleatorio entre 0 y 1.0. Para los valores x e y especificados, devuelve un
nmero aleatorio entre x - y/2 y x + y/2.
Sintaxis
Rand(x, y)
Argumentos
x
Un nmero real que especifica el punto central del rango.
y
Un nmero real que especifica el tamao del rango.
Si no se especifica ningn argumento, el rango predeterminado va de 0 a 1.0.
Devuelve
Un nmero aleatorio entre 0 y 1.0. Para los valores x e y especificados, devuelve un nmero
aleatorio entre x - y/2 y x + y/2.
Excepciones
Ninguna.
Ejemplo
Rand()
Rand(500, 250)

Range
Encuentra la diferencia entre los valores mximo y mnimo de un punto durante un intervalo
de tiempo determinado, segn los valores almacenados en PI Archive.
Sintaxis
Range(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
Un nombre de tag. Este punto debe representar una variable continua.
starttime
El comienzo del intervalo de tiempo objeto de la bsqueda debe ser una expresin de
tiempo.
endtime
El final del intervalo de tiempo objeto de la bsqueda debe ser una expresin de tiempo
posterior a la hora de inicio.
pctgood
Opcional. Porcentaje de tiempo mnimo a lo largo del intervalo de tiempo proporcionado en
que los valores archivados del punto deben ser correctos.
Devuelve
La diferencia entre los valores mximo y mnimo de un punto durante un intervalo de tiempo
determinado.
Excepciones
Notas
PRECAUCIN:
Los estados digitales OverRangeStat y UnderRangeStat no se tienen en cuenta cuando se
calcula este valor.
Ejemplo
Range('tag1', 'y', '*')
Range('tag1','-1h', 'y')
Range('tag1','y', '+1h',70)
Remainder
Devuelve el resto que resulta de la divisin de x por y utilizando el mtodo IEEERemainder.
Este resto equivale a x - (y Q), donde Q es el cociente de x / y redondeado al entero ms
prximo (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 nmero).

Sintaxis
Remainder(x, y)
Argumentos
x
Cualquier valor numrico distinto de cero.
y
Devuelve
El resto que resulta de la divisin de x por y utilizando el mtodo IEEERemainder.
Nota:
No es el mismo que el resto que devuelve el operador Mod (mdulo).
Excepciones
Ninguna
Ejemplo
Remainder(11,3)
Devuelve -1
Remainder(10,3)
Devuelve +1
Right
Determina un nmero especfico de caracteres de una cadena empezando por la derecha.
Sintaxis
Right(str, len)
Argumentos
s
Una cadena.
len
Un entero.
Devuelve
Los caracteres len de la cadena empezando por la derecha.
Excepciones
Si los argumentos no son del tipo requerido, devuelve un error.

Ejemplo
Right("Stringtag", 3) = "tag"
Right('Stringtag', 4) = "rror" if the Snapshot value for the stringtag equals
"Error"
Right("Stringtag", 20) = "Stringtag"
Round
Redondea un nmero o una hora a la unidad ms prxima.
Sintaxis
Round(x [, unit])
Argumentos
x
Debe ser un nmero entero o real o una expresin de tiempo.
unit
Opcional. El tamao al que se redondear la unidad. Si x es un nmero, la unidad debe ser un
nmero. Six es una expresin de tiempo o un perodo, la unidad debe ser un perodo de
tiempo. Si se omite la unidad, Round redondea al entero ms prximo (en el caso de los
nmeros) o al segundo (en el caso de los perodos de tiempo).
Devuelve
El valor ms prximo a x que sea un nmero entero mltiplo de una unidad. Devuelve el mismo
tipo de datos quex. Para obtener ms informacin, consulte los siguientes ejemplos.
Excepciones
Si x es una cadena, o la unidad tiene un tipo de datos incorrecto, devuelve un error.
Notas
Si x es una hora y la unidad se omite, esta rutina no se aplicar: las horas se ajustarn con un
margen de precisin de solo 1 segundo.
Ejemplo
Round(12.499)
Se redondea al entero ms prximo (12,0)
Round(12.5)
La media unidad se redondea (13,0)
Round(12.8, 10)
Se redondea a la decena ms prxima (10,0)
Round('14-Dec-97 11:47, '+1h')
La marca de tiempo se redondea a la hora ms prxima (14-Dec-97 12:00)
Round('18:47' -'15:00','+1h')
El perodo medido en segundos se redondea a la hora ms prxima (10800)

Nota:
El
redondeo al da ms prximo produce una marca de tiempo del da ms prximo en la
hora UTC y no en la hora local.
Roundfrac
Redondea un valor numrico x a y posiciones decimales.
Sintaxis
Roundfrac(x, y)
Argumentos
x
Debe ser un nmero entero o real o una expresin de tiempo.
y
Entero que especifica el nmero de posiciones decimales al que se redondear x.
Devuelve
El valor de x redondeado a y posiciones decimales. Devuelve el mismo tipo de datos que x. Para
obtener ms informacin, consulte los siguientes ejemplos.
Excepciones
Si x es una cadena, o la unidad tiene un tipo de datos incorrecto, devuelve un error.
Notas
Si x es una hora y la unidad se omite, esta rutina no se aplicar: las horas se ajustarn con un
margen de precisin de solo 1 segundo.
Ejemplo
Roundfrac (Pi(), 4)
Devuelve 3,1416
Roundfrac (TagVal('tag1'), 2)
Devuelve el valor de tag1 redondeado a dos posiciones decimales
RTrim
Elimina los espacios en blanco finales de una cadena.
Sintaxis
RTrim(s)
Argumentos
s
Una cadena.

Devuelve
La cadena de origen con los espacios en blanco al final eliminados.
Excepciones
Ejemplo
RTrim("Stringtag ") = "Stringtag"
RTrim(" Stringtag") = " Stringtag"
RTrim('Stringtag') = "Error" if the Snapshot value for the stringtag equals
"Error "
Sec
Devuelve la secante trigonomtrica de un nmero.
Sintaxis
Sec(x)
Argumentos
x
Devuelve
La secante de x.
Excepciones
Ejemplo
Sec('tag1')
Sec(1)
Sec(1.1)
Sech
Devuelve la secante hiperblica de un nmero.
Sintaxis
Sech(x)
Argumentos
x
Devuelve
La secante hiperblica de x.

Excepciones
Ejemplo
Sech('tag1')
Sech(1)
Sech(1.1)
Second
Extrae el segundo de una expresin de tiempo.
Sintaxis
Second(t1)
Argumentos
t1
Devuelve
El segundo de la expresin de tiempo, en el rango 0-59.
Excepciones
Ninguna.
Ejemplo
Second('*')
Second('y')
Second('*-1h')
Sgn
Devuelve un indicador del signo numrico de un nmero.
Sintaxis
Sgn(x)
Argumentos
x
Devuelve
-1 si x < 0,0 si x = 0,1 si x > 0.
Excepciones

Ejemplo
Sgn('tag1')
Sgn(1)
Sgn(0)
Sin
Devuelve el seno trigonomtrico de un nmero.
Sintaxis
Sin(x)
Argumentos
x
Devuelve
El seno de x.
Excepciones
Ejemplo
Sin('tag1')
Sin(1)
Sin(1.1)
Sinh
Devuelve el seno hiperblico de un nmero.
Sintaxis
Sinh(x)
Argumentos
x
Devuelve
El seno hiperblico de x.
Excepciones
Ejemplo
Sinh('tag1')
Sinh(1)
Sinh(0.9)

Sqr
Devuelve la raz cuadrada de un nmero.
Sintaxis
Sqr(x)
Argumentos
x
Debe ser un nmero entero o ral mayor o igual que cero.
Devuelve
La raz cuadrada de x.
Excepciones
Si x es un valor negativo, o no es un nmero, devuelve un error.
Ejemplo
Sqr('tag1')
Sqr(2)
Sqr(2.1)
StateNo
Traduce un estado digital a su correspondiente nmero de estado.
Sintaxis
StateNo(digstate)
Argumentos
digstate
Un valor de enumeracin.
Devuelve
El desplazamiento dentro del conjunto de estados digitales correspondiente a digstate.
Excepciones
Si un punto se transfiere como un digstate que no es un punto digital, devuelve un error.
Notas
Un estado digital puede aparecer varias veces en la tabla de estados digitales. En este caso, el
valor que StateNo devuelve puede variar. Si digstate es el valor de un punto digital, StateNo
devuelve un nmero de cdigo adecuado para ese punto.
Ejemplo
StateNo('digitaltag')
StateNo(TagVal('digitaltag', '*-1h'))

SStDev
Devuelve la desviacin estndar de muestra: la desviacin estndar de dos o ms argumentos
que son una muestra de una poblacin mayor. La desviacin estndar de una muestra x1...xn es
igual a
Donde es la media de muestra; es decir:
Sintaxis
SStDev(x1, x2, ..., xn)
Argumentos
x1...xn
Pueden ser nmeros o expresiones de tiempo, pero todos deben ser iguales.
Devuelve
La desviacin estndar de muestra de los argumentos. Si los argumentos son nmeros, el
resultado es un nmero; si los argumentos son horas o perodos de tiempo, el resultado es un
perodo de tiempo (nmero de segundos).
Excepciones
digitales. Si no hay como mnimo dos valores numricos, SStDev devuelve cero.
Notas
En el caso poco frecuente de que tenga la poblacin entera, y no una muestra, puede utilizar la
funcin PstDev en lugar de SStDev.
Ejemplo
SStDev('tag1', 'tag2', TagVal('tag1', 'y'))
SStDev('y', 't', '14-Dec-97')
SStDev(1, 2, 1.1)
StDev
Encuentra la desviacin estndar ponderada en tiempo de un punto durante un intervalo de
tiempo determinado, segn los valores almacenados en PI Archive.
Sintaxis
StDev(tagname, starttime, endtime [, pctgood])

Argumentos
tagname
starttime
Debe ser una expresin de tiempo que represente el comienzo del intervalo de tiempo
objeto de la bsqueda.
endtime
Debe ser una expresin de tiempo, posterior a la hora de inicio, que represente el final del
intervalo de tiempo objeto de la bsqueda.
pctgood
Devuelve
La desviacin estndar ponderada en tiempo de un punto durante un intervalo de tiempo
determinado.
Excepciones
Si el punto no tiene valores correctos o no se alcanza el mnimo de PctGood para el intervalo
de tiempo proporcionado, se devuelve un error.
Notas
PRECAUCIN:
Si el punto tiene pocos valores de archivado correctos durante el perodo de tiempo, es
posible que esta funcin no resulte muy fiable. Utilice la funcin PctGood para averiguar
qu porcentaje de los valores es correcto.
Ejemplo
StDev('tag1', 'y', '*')
StDev('tag1', '14-Dec-97', '+1d',85)
StDev('tag1', '14-Dec-97', '15-Dec-97')
String
Convierte cualquier valor en una cadena.
Sintaxis
String(x)
Argumentos
x
Cualquier expresin. Puede ser de cualquiera de los tipos de datos de PI System normales.
Devuelve
La cadena que representa el argumento de valor.

Excepciones
Ninguna.
Ejemplo
String(12.23) = "12.23"
String('sinusoid')
String('pidigital')
String('*')
String("Hello, PI user!") = "Hello, PI user!"
TagAvg
Encuentra el valor ponderado en tiempo de un punto durante un intervalo de tiempo
determinado, segn los valores almacenados en PI Archive.
Sintaxis
TagAvg(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
starttime
endtime
pctgood
Devuelve
El valor ponderado en tiempo de un punto a lo largo de un intervalo de tiempo especificado.
Excepciones
Notas
PRECAUCIN:

Ejemplo
TagAvg('tag1', 'y', '*')
TagAvg('tag1', '14-Dec-97', '+1d',70)
TagAvg('tag1', '14-Dec-97', '15-Dec-97')
TagBad
Comprueba si un punto tiene un estado anmalo en un momento dado. Si el tipo del punto es R
o I, cualquier estado digital ser anmalo. Si el tipo del punto es D, los estados definidos para
ese punto sern normales y el resto, anmalos.
Sintaxis
Tagbad(tagname [, time])
Argumentos
tagname
Un nombre de tag.
time
Opcional. Una expresin de tiempo. Si se omite, se utiliza la hora actual (*).
Devuelve
0 si el estado del punto en ese momento es normal y1 si es anmalo.
Excepciones
Si el punto no existe o no tiene datos de archivado anteriores en el instante especificado,
devuelve un error.
Notas
Badval puede comprobar cualquier valor o expresin; TagBad solo puede comprobar un punto.
Ejemplo
TagBad('tag1', '*')
TagBad('digitaltag', '14-Dec-97')
TagBad('tag1', 'y')
TagDesc
Obtiene el descriptor de un punto de Point Database.
Sintaxis
TagDesc(tagname)
Argumentos
tagname
simples.

Devuelve
El descriptor de un punto.
Excepciones
Si el punto no existe, devuelve un error.
Ejemplo
TagDesc('tag1')
TagDesc('digitaltag')
TagEU
Obtiene la cadena de unidad de ingeniera de un punto de Point Database.
Sintaxis
TagEU(tagname)
Argumentos
tagname
simples.
Devuelve
Las unidades de ingeniera de un punto.
Excepciones
Ejemplo
TagEU('tag1')
TagExDesc
Obtiene el descriptor ampliado de un punto de Point Database.
Sintaxis
TagExDesc(tagname)
Argumentos
tagname
simples.
Devuelve
El descriptor ampliado de un punto.
Excepciones

Ejemplo
TagExDesc('tag1')
TagMax
Encuentra el valor mximo de un punto durante un intervalo de tiempo determinado, segn los
valores almacenados en PI Archive.
Sintaxis
TagMax(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
Un nombre de tag.
starttime
Una expresin de tiempo que indica el comienzo del intervalo de tiempo objeto de la
bsqueda. Las horas relativas lo son respecto a la hora de finalizacin si esta no es en s
misma una hora relativa.
endtime
Final del intervalo de tiempo objeto de la bsqueda. Las horas relativas lo son respecto a la
hora de inicio si esta no es en s misma una hora relativa. Esta hora debe ser posterior a la
hora de inicio.
pctgood
Devuelve
El valor mximo de un punto a lo largo de un intervalo de tiempo especificado.
Excepciones
Notas
PRECAUCIN:
El estado digital OverRange no se tiene en cuenta al calcular este valor.
TagMax('tag1', 'y', '*')

TagMax('tag1', '-1h', '*',95)
En este caso, la hora de inicio es una hora antes que la hora final, que ahora es ('*'). Durante
el intervalo de tiempo, al menos un 95% de los valores deben ser correctos.
TagMax('tag1', '-1h', '*',95)
TagMax('tag1', '14-Dec-97', '+1h')

TagMean
Encuentra el valor promedio de un punto durante un intervalo de tiempo determinado, segn
los valores almacenados en PI Archive.
Sintaxis
TagMean(tagname, starttime, endtime [, pctgood])
Devuelve
El valor promedio de un punto a lo largo de un intervalo de tiempo especificado. Tenga en
cuenta que el promedio no est ponderado en el tiempo.
Argumentos
tagname
starttime
endtime
pctgood
Excepciones
tiempo proporcionado, se devuelve un error. A diferencia de otras funciones de resumen,
TagMean no interpola ningn valor en el lmite. Por lo tanto, si no hay ningn evento de
archivado entre el intervalo especificado, se devuelve un error.
Notas
PRECAUCIN:
Ejemplo
TagMean('tag1', 'y', '*')
TagMean('tag1', '14-Dec-97', '+1d',70)
TagMean('tag1', '14-Dec-97', '15-Dec-97')
TagMin
Encuentra el valor mnimo de un punto durante un intervalo de tiempo determinado, segn los
valores almacenados en PI Archive.

Sintaxis
TagMin(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
starttime
Comienzo del intervalo de tiempo objeto de la bsqueda. Las horas relativas lo son respecto
a la hora de finalizacin si esta no es en s misma una hora relativa.
endtime
Las horas relativas lo son respecto a la hora de inicio si esta no es en s misma una expresin
relativa. Esta hora debe ser posterior a la hora de inicio.
pctgood
Devuelve
El valor mnimo de un punto a lo largo de un intervalo de tiempo especificado.
Excepciones
Notas
PRECAUCIN:
El estado digital UnderRange no se tiene en cuenta al calcular este valor.
Ejemplo
TagMin('tag1', 'y', '*')
TagMin('tag1', '-1h', '*',90)
TagMin('tag1', '14-Dec-97', '+1h')
TagName
Obtiene el nombre de un punto de Point Database.
Sintaxis
TagName(tag)
Argumentos
tagname
simples.
Devuelve
El nombre de un punto.

Excepciones
Ejemplo
TagName('tag1')
TagNum
Obtiene el nmero de un punto de Point Database.
Sintaxis
TagNum(string)
Argumentos
string
dobles.
Devuelve
El nmero de un punto.
Excepciones
Ejemplo
TagNum("tag1")
TagSource
Obtiene la cadena de origen de punto de un punto de Point Database.
Sintaxis
TagSource(tagname)
Devuelve
La cadena de origen de punto de un punto.
Argumentos
tagname
simples.
Excepciones
Ejemplo
TagSource('tag1')

TagSpan
Obtiene el valor de intervalo de un punto de Point Database.
Sintaxis
TagSpan(tagname)
Argumentos
tagname
simples.
Devuelve
El intervalo de un punto. Si el tipo del punto es Digital, se trata de un entero cuyo valor es el
nmero de estados digitales definidos para el punto.
Ejemplo
TagSpan('tag1')
TagSpan('digitaltag')
TagTot
Encuentra el valor total (integral de tiempo) de un punto durante un intervalo de tiempo
determinado, segn los valores almacenados en PI Archive.
Sintaxis
TagTot(tagname, starttime, endtime [, pctgood])
Argumentos
tagname
Un nombre de tag. Este punto debe representar un flujo de proceso continuo.
starttime
a la hora de finalizacin si esta no es una hora relativa.
endtime
hora de inicio si esta no es una expresin relativa.
pctgood
Opcional. Porcentaje de tiempo mnimo a lo largo del intervalo de tiempo proporcionado
durante el cual los valores archivados del punto deben ser correctos.
Devuelve
El valor total de un punto a lo largo del intervalo de tiempo especificado.
Excepciones
Si el punto no tiene valores correctos o no se alcanza el mnimo de PctGood para el intervalo
de tiempo proporcionado, se devuelve un error.

PRECAUCIN:
qu porcentaje del valor es correcto.
Notas
El sistema elige un factor de escala para que la integral solo sea correcta si el flujo se
expresa en unidades por da. Si el flujo se expresa en unidades por hora, o segn otra unidad
de tiempo, este resultado se debe multiplicar por un factor de conversin. El factor de
conversin equivale al nmero de unidades de tiempo de flujo real en un da.
Por ejemplo, si calcula el total de un punto medido en galones por minutos, multiplique el
resultado de TagTot por 1440 para obtener la respuesta en galones. Este factor de
conversin no est relacionado con el perodo de tiempo durante el cual se realiza la
totalizacin; es estrictamente una funcin de las unidades de ingeniera del punto.
Algunos sitios de PI tienen configurado de forma predeterminada el perodo total por hora
en lugar de por da. Si est en uno de estos sitios, el factor de conversin variar.
Cuando el porcentaje de datos correctos es inferior al 100%, TagTot determina el total en
base a los datos correctos y divide la fraccin de datos correctos en el intervalo.
Ejemplo
TagTot('tag1', 'y', '*')
TagTot('tag1', '-1h', '*',85)
TagTot('tag1', '14-Dec-97', '+1h')
TagType
Obtiene el carcter de tipo del punto (I, R o D) de Point Database.
Sintaxis
TagType(tagname)
Argumentos
tagname
simples.
Devuelve
El carcter de tipo de un punto.
Excepciones
Ejemplo
TagType('tag1')
TagType('digitaltag')

TagVal
Encuentra el valor que ha sido archivado de un punto en un momento determinado.
Sintaxis
TagVal(tagname [, time])
Argumentos
tagname
simples.
time
Opcional. Una expresin de tiempo. Si omite este argumento, se utiliza '*'.
Devuelve
El valor archivado del nombre del tag en un momento determinado. Este valor se interpola
salvo que el punto tenga el atributo Step 1 (o el cdigo de resolucin 4 para PI2).
Excepciones
Si el punto no existe o no tiene datos en el archivo anteriores en el instante especificado,
devuelve un error.
Ejemplo
TagVal('tag1')
TagVal('digitaltag')
TagVal('tag1','*')
TagZero
Obtiene el valor cero de un punto de Point Database.
Sintaxis
TagZero(tagname)
Argumentos
tagname
simples.
Devuelve
El valor cero de un punto. Si el tipo del punto es R o I, es un nmero; si el tipo es D, se trata de
un estado digital (cadena de caracteres).
Excepciones
Ejemplo
TagZero('tag1')
TagZero('digitaltag')

Tan
Devuelve la tangente trigonomtrica de un nmero.
Sintaxis
Tan(x)
Argumentos
x
Devuelve
La tangente de x.
Excepciones
Ejemplo
Tan('tag1')
Tan(1)
Tan(1.1)
Tanh
Devuelve la tangente hiperblica de un nmero.
Sintaxis
Tanh(x)
Argumentos
x
Devuelve
La tangente hiperblica de x.
Excepciones
Ejemplo
Tanh('tag1')
Tanh(1)
Tanh(1.1)
Text
Concatena cadenas que representan valores de argumento.

Sintaxis
Text(val1 [, val2, ])
Argumentos
val1, val2,
Cualquier expresin. Puede ser de cualquiera de los tipos de datos de PI System normales.
Devuelve
Una cadena que es la concatenacin de cadenas que representan valores de argumento.
Ejemplo
Text('sinusoid')
Text("The value for tag sinusoid is at ", '*', " is ", 'sinusoid') = "The
value for tag sinusoid at 1-Jun-00 17:07:18 is 89.09"
THEN
Devuelve el primero de dos valores especificados cuando una expresin condicional IF-THEN-
ELSE es True.
Sintaxis
Argumentos
expression
Cualquier expresin condicional que se evale como True o False.
x , y
Devuelve
Excepciones
Ninguna.
Ejemplo
TimeEq
Averigua el tiempo total, dentro de un intervalo, en que un punto es igual a un valor
proporcionado.
Sintaxis
TimeEq(tagname, starttime, endtime, value)
Argumentos

tagname
simples.
starttime
endtime
hora de inicio si esta no es en s misma una hora relativa. Debe ser posterior a la hora de
inicio.
value
Debe ser un nmero entero o real o un estado digital (cadena de caracteres); el valor para
buscar.
Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto fue idntico al
Ejemplo
TimeEq('tag1', 't', '*',40.0)
TimeEq('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeEq('digitaltag', '14-Dec-97', '*', "On")
TimeGE
Averigua el tiempo total, dentro de un intervalo, en el que un punto es mayor o igual que un
Sintaxis
TimeGE(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
endtime
inicio.
value
buscar.

Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto fue mayor o igual
que el valor proporcionado.
Excepciones
Ninguna.
Notas
TimeGE se interpola entre eventos de archivado, si es necesario, para averiguar el nmero de
veces que el punto ha sobrepasado el valor indicado.
Ejemplo
TimeGE('tag1', 't', '*',40.0)
TimeGE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeGE('digitaltag', '14-Dec-97', '*', "On")
TimeGT
Averigua el tiempo total, dentro de un intervalo, en el que un punto es mayor que un valor
proporcionado.
Sintaxis
TimeGT(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
endtime
inicio.
value
buscar.
Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto fue mayor que el
Excepciones
Ninguna.

Notas
TimeGT se interpola entre eventos de archivado, si es necesario, para averiguar el nmero de
Ejemplo
TimeGT('tag1', 't', '*',40.0)
TimeGT('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeGT('digitaltag', '14-Dec-97', '*', "On")
TimeLE
Averigua el tiempo total, dentro de un intervalo, en el que un punto es menor o igual que un
Sintaxis
TimeLE(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
a endtime, siendtime no es una hora relativa.
endtime
Final del intervalo de tiempo objeto de la bsqueda. Las horas relativas lo son respecto a
starttime, sistarttime no es una hora relativa. Esta hora debe ser posterior astarttime.
value
Debe ser un nmero entero o real o un estado digital (cadena de caracteres); el valor objeto
de bsqueda.
Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto fue menor o igual
que el valor proporcionado.
Excepciones/Errores
Ninguno.
Notas
TimeLE se interpola entre eventos de archivado, si es necesario, para averiguar el nmero de
Ejemplos
TimeLE('tag1', 't', '*',40.0)
TimeLE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeLE('digitaltag', '14-Dec-97', '*', "On")

TimeLT
Averigua el tiempo total, dentro de un intervalo, en que un punto es menor que un valor
proporcionado.
Sintaxis
TimeLT(tagname, starttime, endtime, value)
Argumentos
tagname
simples.
starttime
endtime
inicio.
value
buscar.
Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto fue menor que el
Excepciones
Ninguna.
Notas
TimeLT se interpola entre eventos de archivado, si es necesario, para averiguar el nmero de
Ejemplo
TimeLT('tag1', 't', '*',40.0)
TimeLT('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeLT'digitaltag', '14-Dec-97', '*', "On")
TimeNE
Averigua el tiempo total, dentro de un intervalo, en que un punto no es igual a un valor
proporcionado.
Sintaxis
TimeNE(tagname, starttime, endtime, value)

Argumentos
tagname
simples.
starttime
endtime
inicio.
value
buscar.
Devuelve
El perodo de tiempo dentro del intervalo proporcionado en el que el punto no fue igual al
Excepciones
Ninguna.
Ejemplo
TimeNE('tag1', 't', '*',40.0)
TimeNE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97'))
TimeNE('digitaltag', '14-Dec-97', '*', "On")
Timestamp
Devuelve la marca de tiempo de un valor con marca de tiempo nico.
Sintaxis
TimeStamp(x)
Argumentos
x
Un valor con marca de tiempo (evento PI).
Devuelve
La marca de tiempo del valor con marca de tiempo especificado.
Excepciones
Si el valor de x es No Data, se devuelve Calc Failed.
Ejemplo
TimeStamp(PrevVal('sinusoid', '*"))

Devuelve la marca de tiempo del evento de archivado de PI para la sinusoide.
Total
Devuelve la suma de dos o ms valores.
Sintaxis
Total(x1, x2, ..., xn)
Argumentos
x1...xn
Pueden ser nmeros o perodos de tiempo, pero todos deben ser iguales.
Devuelve
El total de los argumentos. El resultado tiene el mismo tipo de datos que los argumentos.
Excepciones
Los argumentos cuyos valores de tiempo de ejecucin sean estados digitales no se incluyen en
el total. Si todos los valores son estados digitales, Total devuelve un error.
Ejemplo
Total('tag1', 'tag2', TagVal('tag1', 'y'),40.0)
Total('t'-'y', '+1h')
Trim
Elimina los espacios en blanco a ambos lados de una cadena.
Sintaxis
Trim(s)
Argumentos
s
Una cadena.
Devuelve
La cadena de origen con los espacios en blanco al principio y al final eliminados.
Excepciones
Ejemplo
Trim(" Stringtag ") = "Stringtag"
Trim(" Stringtag is a string tag. ") = "Stringtag is a string tag."
Trunc
Trunca un nmero o una hora a la siguiente unidad ms baja.

Sintaxis
Trunc(x [, unit])
Argumentos
x
Debe ser un nmero entero o real, una expresin de tiempo o un perodo de tiempo.
unit
Opcional. El tamao al que se truncar la unidad; x se truncar a un mltiplo deunit. Six es
un nmero,unit debe ser un nmero. Six es una expresin de tiempo o un perodo,unit debe
ser un perodo de tiempo. Si se omite unit, Trunc realiza el truncamiento al siguiente entero
inferior (en el caso de los nmeros) o al segundo (en el caso de los perodos de tiempo).
Devuelve
Trunc devuelve el mltiplo de unidad ms grande que sea inferior a x. Para un valorx negativo,
devuelve el mltiplo ms bajo de unit que sea mayor quex.) El resultado es el mismo tipo de
datos quex.
Excepciones
Si x es una cadena, o la unidad tiene un tipo de datos incorrecto, se devuelve un error.
Notas
Si x es una hora y la unidad se omite, esta rutina no se aplicar, porque las horas se ajustarn
con un margen de precisin de solo 1 segundo.
Cuando |x| < |unit|, se devuelve 0.
Ejemplo
Trunc(12.999)
Truncar al siguiente mltiplo inferior (12.0)
Trunc(28.75, 10)
Truncar al siguiente mltiplo inferior de 10 (20.0)
Trunc('14-Dec-97 11:47','+1h')
Truncar a la siguiente hora inferior (14-Dic-97 11:00 )
Trunc('18:47' -'15:00','+1h')
Truncar perodo a la siguiente hora inferior. (3:00:00)
Nota:
El truncamiento al siguiente da inferior produce una marca del siguiente da inferior en
la hora UTC y no en la hora local.
UCase
Convierte en maysculas una cadena.
Sintaxis
UCase(s)
Argumentos

s
Debe ser una cadena.
Devuelve
Una cadena en maysculas.
Excepciones
Ejemplo
UCase("Stringtag") = "STRINGTAG"
UCase('Stringtag') = "ERROR" if the Snapshot value for the stringtag equals
"Error"
Yearday
Extrae el da del ao a partir de una expresin de tiempo. El da del ao (tambin conocido
como da juliano) es un entero que va de 1 a 366, donde 1 representa el 1 de enero.
Sintaxis
Yearday(t1)
Argumentos
t1
Devuelve
El da del ao, en el rango 1-366, donde 1 representa el 1 de enero.
Excepciones
Ninguna.
Ejemplo
Yearday('*')
Yearday('t')
Year
Extrae el ao de una expresin de tiempo.
Sintaxis
Year(t1)
Argumentos
t1
Devuelve
El ao de la expresin de tiempo, en el rango de 1970 hasta el presente.

Excepciones
Ninguna.
Ejemplo
Year('*')
Year('t')
Weekday
Extrae el da de la semana a partir de una expresin de tiempo.
Sintaxis
Weekday(t1)
Argumentos
t1
Devuelve
El da de la semana, en el rango 1-7, donde 1 representa el domingo.
Excepciones
Ninguna.
Ejemplo
Weekday('*')
Weekday('t')
Funciones del vapor para expresiones de anlisis

Puede incluir funciones del vapor en expresiones de anlisis para calcular las propiedades
termodinmicas del vapor. Estas funciones se basan en la formulacin industrial IAPWS 1997.
La implementacin se basa fundamentalmente en la combinacin de ecuaciones hacia atrs y
hacia adelante para todas las regiones aplicables.
Nota:
No confunda estas funciones del vapor con el conjunto similar de funciones del vapor que
se utiliza en PI Performance Equations. Los nombres de estas funciones empiezan por
"StmSI_" o "StmEng_". Los nombres de las funciones del vapor que se utilizan con
expresiones de anlisis empiezan por "Steam_".
La tabla siguiente muestra las funciones compatibles y sus descripciones. Los rangos y las
unidades de medida de las propiedades de la funcin del vapor se detallan en Rangos de las
entradas de la funcin de vapor. Los estados de referencia relacionados con el vapor se
enumeran en Estados de referencia de la propiedad del vapor.
Descripciones de las funciones del vapor
Funcin Descripcin
Steam_TsatP Temperatura de saturacin como funcin de la presin.
Steam_HsatP Entalpa de saturacin como funcin de la presin.
Steam_SsatP Entropa de saturacin como funcin de la presin.

Funcin Descripcin
Steam_VsatP Volumen especfico del vapor de saturacin como funcin de la presin.
Steam_PsatT Presin de saturacin como funcin de la temperatura.
Steam_HsatT Entalpa de saturacin como funcin de la temperatura.
Steam_SsatT Entropa de saturacin como funcin de la temperatura.
Steam_VsatT Volumen especfico del vapor de saturacin como funcin de la temperatura.
Steam_VPT Volumen especfico del vapor como funcin de la presin y la temperatura. (Para
el vapor saturado y sobrecalentado.)
Steam_VPTL Volumen especfico del agua como funcin de la presin y la temperatura.
Steam_VPH Volumen especfico del vapor como funcin de la presin y la entalpa. (Para el
vapor mojado y seco.)
Steam_VPS Volumen especfico del vapor como funcin de la presin y la entropa. (Para el
Steam_HPT Entalpa especfica del vapor como funcin de la presin y la temperatura. (Para
Steam_HPTL Entalpa especfica del lquido como funcin de la presin y la temperatura.
(Para el agua.)
Steam_HPS Entalpa especfica del vapor como funcin de la presin y la entropa. (Para el
Steam_SPT Entropa especfica del vapor como funcin de la presin y la temperatura. (Para
Steam_SPTL Entropa especfica del lquido como funcin de la presin y la temperatura.
(Para el agua.)
Steam_SPH Entropa especfica del vapor como funcin de la presin y la entalpa. (Para el
Steam_TPH Temperatura como funcin de la entalpa y la presin. (Para el vapor mojado y
seco.)
Steam_TPS Temperatura como funcin de la entropa y la presin. (Para el vapor mojado y
seco.)
Steam_XHP Calidad del vapor (fraccin de vapor) como funcin de la entalpa y la presin.
(Para el vapor mojado.)
Steam_XPS Calidad del vapor (fraccin de vapor) como funcin de la entropa y la presin.
Steam_HPX Entalpa especfica como funcin de la presin y la calidad del vapor. (Para el
vapor mojado.)
Steam_SPX Entropa especfica del vapor como funcin de la presin y la calidad del vapor.
Rangos de las entradas de la funcin de vapor

La tabla siguiente muestra los rangos y unidades de medida predeterminadas de cada una de
las cinco propiedades relacionadas con los clculos de la funcin de vapor.
Las unidades de medida predeterminadas son unidades SI. Para obtener ms informacin
sobre el uso de las funciones de vapor con otras unidades de medida, consulte Conversin de
unidades de medida para funciones de vapor.

La presin afecta al estado del vapor. En Algunas consideraciones relativas a las funciones de
vapor que tienen como entrada la presin se describen varias cuestiones que es necesario
tener en cuenta en las funciones con la presin como entrada.
Rango de entradas para las propiedades de la funcin de vapor
Funcin Temp (C) Presin (kPa) Entalpa J/g) Entropa (J/(g Calidad
K))
Steam_TsatP 0,611212678 a
22064
Steam_HsatP 0,611212678 a
22064
Steam_SsatP 0,611212678 a
22064
Steam_VsatP 0,611212678 a
22064
Steam_PsatT 0,0 a 373,946
Steam_HsatT 0,0 a 373,946
Steam_SsatT 0,0 a 373,946
Steam_VsatT 0,0 a 373,946
Steam_VPT 0 a 800 0,611212678 a
100000
Steam_VPT 800 a 2000 0,611212678 a
(presin y 500000
temperatura
altas)
Steam_VPTL 0 a 800 0,611212678 a
100000
Steam_VPH 0,611212678 a -0,04159 a
100000 4160.7
Steam_VPS 0,611212678 a -0,000155 a
100000 11.921
Steam_HPT 0 a 800 0,611212678 a
100000
Steam_HPT 800 a 2000 0,611212678 a
(temperatura y 500000
presin altas)
Steam_HPTL 0 a 800 0,611212678 to
100000
Steam_HPS 0,611212678 a -0,000155 a
100000 11,921
Steam_HPX 0,611212678 a 0a1
22064
Steam_SPT 0 a 800 0,611212678 a
100000
Steam_SPT 800 a 2000 0,611212678 a
(temperatura y 500000
presin altas)
Steam_SPTL 0 a 800 0,611212678 a
100000
Steam_SPH 0,611212678 a -0,04159 a
100000 4160,7

Funcin Temp (C) Presin (kPa) Entalpa J/g) Entropa (J/(g Calidad
K))
Steam_SPX 0,611212678 a 0a1
22064
Steam_TPH 0,611212678 a -0,04159 a
100000 4160,7
Steam_TPS 0,611212678 a -0,000155 a
100000 11.921
Steam_XPH 0,611212678 a -0.04159 a
22064 4160,7
Steam_XPS 0,611212678 a -0,000155 a
22064 11,921
Algunas consideraciones relativas a las funciones de vapor que tienen

como entrada la presin
Dado que la presin afecta al estado del vapor, tenga en cuenta estas consideraciones sobre las
funciones que tienen como entrada la presin.
Funciones con la presin y la temperatura como entrada

Steam_HPT,Steam_SPT y Steam_VPT se pueden utilizar con vapor saturado seco o
sobrecalentado. Para la temperatura y presin de entrada en la curva saturada, la entropa,
entalpa o volumen calculados son una propiedad de vapor saturado. En el caso de una
temperatura de entrada inferior a la temperatura saturada para la presin de entrada, se
devuelve un error.
Estas tres funciones tambin pueden aceptar temperaturas de entrada altas (de 800 a 2000 C)
con presiones entre 0,611212678 y 50000 kPa.
Funciones con la presin y le entalpa o la entropa como entrada

Steam_VPH,Steam_VPS,Steam_HPS,Steam_SPH,Steam_TPH y Steam_TPS se pueden utilizar
con vapor mojado o sobrecalentado. En estas funciones, el rango de la entalpa (H) va
de-0,04159 a 4160,7 J/g y el de la entropa (S), de -0,000155 a 11.921 J/(g K). Sin embargo,
incluso en los valores dentro del rango, algunas combinaciones de presin y entalpa o entropa
corresponden al agua comprimida y no al vapor y producen como resultado un error de estado:
Con Steam_HPS y Steam_SPH en la regin del vapor mojado, se comprueban los lmites de
la regin del agua comprimida y el vapor sobrecalentado. Si la entalpa o entropa de
entrada no estn dentro de la regin del vapor mojado, se devuelve un error de clculo.
Con Steam_TPH y Steam_TPS en la regin del vapor mojado, se comprueba el lmite entre la
regin del vapor mojado y la del agua comprimida. Si la combinacin de presin de entrada
y entropa o entalpa est dentro de la regin del agua comprimida, se devuelve un error de
clculo.
Del mismo modo, en el caso de Steam_XPH y Steam_XPS, si la entalpa o entropa de entrada
son mayores que las propiedades del vapor saturado o menores que las propiedades de lquido
saturado, se devuelve un error.
Las siguientes funciones son eficaces con una presin elevada y temperaturas altas.
Steam_VPH,Steam_VPS,Steam_HPS,Steam_SPH,Steam_TPH ySteam TPS calculan resultados
vlidos para los estados cuya presin est por encima del punto crtico (22064 kPa) y cuya
temperatura es superior a los 350 C, pero inferior a la temperatura crtica (373,946 C),
aunque esos estados se consideren agua comprimida en lugar de vapor.

Conversin de unidades de medida para funciones de vapor

Las unidades de medida (UOM) predeterminadas de las funciones de vapor son unidades SI.
Todas las entradas de las funciones de vapor definidas en unidades britnicas se convertirn
de forma automtica a sus correspondientes unidades SI. Del mismo modo, si una funcin de
vapor se configura con un atributo de salida, su resultado se convertir automticamente a la
unidad de medida configurada para ese atributo.
Nota:
La conversin automtica exige que todas las unidades de medida se hayan definido
correctamente en la base de datos de unidades de medida. Si en la base de datos de
unidades de medida falta la definicin de la conversin de una unidad de medida a otra
del mismo tipo, la conversin producir un error.
En el editor de expresiones, cuando evale una expresin de funcin de vapor, los resultados se
mostrarn en las unidades SI predeterminadas. Para mostrar los resultados en otra unidad de
medida, puede utilizar la funcin Convert.
Las siguientes expresiones de ejemplo utilizan valores numricos, variables y atributos para
mostrar el tratamiento por parte de las funciones de vapor de la unidad de medida de las
cantidades de entrada y de salida.
Valores de entrada numricos

Los valores de entrada numricos se reconocen como cantidades en la unidad de medida
predeterminada. En el siguiente ejemplo de Steam_VPT, las entradas numricas se reconocen
como 300 kPa y 200 C, y el valor de salida est en cm3/g, la unidad de medida predeterminada
de volumen especfico.
Nombre Expresin Valor Atributo de salida
Variable1 Steam_VPT(300, 200) 716.44 cm3/g Click to map
Atributos de entrada y de salida

En la siguiente expresin, Steam_VsatT adopta como nica entrada el atributo 'TempSat', cuyo
valor actual es 300 F. La temperatura se convierte automticamente a C para evaluar la
expresin y el resultado se muestra en la unidad de medida SI predeterminada de
Steam_VsatT.
Variable1 Steam_VsatT('TempSat') 403.7 cm3/g OutputVolume
El resultado se asigna tambin al atributo de salida 'OutputVolume'. Este atributo est

configurado en una unidad de medida britnica (ft3/lb), por lo que el resultado se convierte de
forma automtica a esa unidad de medida. (En la pestaa Atributos de PI System Explorer,
'OutputVolume' se incluira en la lista con el valor 6.466627 ft3/lb.)
Variables y la funcin Convert

En este ejemplo se utilizan variables y la funcin Convert para especificar cantidades en una
unidad de medida britnica como entradas de la funcin de vapor.
1. En las filas P y T de la expresin que figura ms abajo, Convert asigna valores numricos a
la unidad de medida britnica de presin y temperatura.
2. En la fila B, las variables P y T se convierten automticamente a unidades SI para el clculo
de Steam_VPT y el resultado se muestra en la unidad de medida SI predeterminada. El
resultado se asigna tambin al atributo de salida OutputVolume'. Ese atributo est

configurado en una unidad de medida britnica (ft3/lb), por lo tanto, el resultado se

convierte de forma automtica a esa unidad de medida.
3. En la ltima fila, Convert se utiliza para convertir el resultado (B) a la unidad de medida
britnica y mostrarlo en la expresin.
P Convert(2000, "psia") 2000 psia Click to map
T Convert(800, "F") 800 F Click to map
B Steam_VPT(P, T) 19.206 cm3/g OutputVolume
Volume Convert(B, "ft3/lb") 0.30762 ft3/lb DisplayedVolume
Estados de referencia de la propiedad del vapor

El organismo American Society of Mechanical Engineers (ASME) establece los siguientes
estados de referencia:
punto triple
El punto triple del agua es 273.16 K o 0,01 C o 32,018 F.
escala Celsius
La temperatura Celsius es exactamente Tk - 273,15.
punto crtico
El punto crtico del vapor es 647,096 K y 22,064 kPa o 705,103 F y 3200,1 psia.
estado de referencia
La energa interna especfica y la entropa especfica de la fase lquida se han fijado en cero
en el punto triple del agua.
Referencia de funciones del vapor
Steam_HPS
Calcula la entalpa especfica de vaporizacin como una funcin de presin (P en kPa) y la
entropa (S, en J/(g K)). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de
entrada y los valores devueltos estn, de forma predeterminada, en unidades SI. Puede cambiar
las unidades de medida, por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_HPS(P, S)
Argumentos
P
Presin del vapor. P puede estar en el rango de 0,611212678 a 22064 kPa.
S
Entropa especfica del vapor. S puede estar en el rango de -0,000155 a 11,921J/(g K).

Devuelve
Entalpa especfica del vapor calculada en J/g.
Ejemplo
Steam_HPS(2500, 7.5956)
Devuelve 3684,9 J/g
Steam_HPT
Calcula la entalpa especfica de vaporizacin como una funcin de presin (P en kPa) y la
temperatura (T, en C). Solo se utiliza con el vapor sobrecalentado o el vapor saturado seco.
Para cualquier valor T inferior a la temperatura de saturacin de P, la funcin devuelve un
error de fuera de rango. La funcin acepta, sin embargo, cualquier valor T dentro del rango de
temperaturas cuando P es mayor que la presin crtica. Los argumentos de entrada y los
valores devueltos estn, de forma predeterminada, en unidades SI. Puede cambiar las unidades
de medida, por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_HPT(P, T)
Argumentos
P
T
Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C.
Devuelve
Entalpa especfica del vapor calculada en J/g.
Ejemplo
Steam_HPT(40000, 600)
Devuelve 3350,4 J/g
Steam_HPTL
Calcula la entalpa especfica de lquido como una funcin de presin (P en kPa) y la
temperatura (T, en C). Se utiliza solo con el agua comprimida. Para cualquier valor T mayor
que la temperatura de saturacin de P, la funcin de vuelve un error de fuera de rango. La
funcin acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es
mayor que la presin crtica. Los argumentos de entrada y los valores devueltos estn, de
forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo,
utilizando la funcin Convert.
Sintaxis
Steam_HPTL(P, T)
Argumentos
P

T
Devuelve
Entalpa especfica de lquido calculada en J/g.
Ejemplo
Steam_HPTL(40000, 100)
Devuelve 449,27 J/g
Steam_HPX
Calcula la entalpa especfica como una funcin de presin (P en kPa) y calidad (fraccin de
vapor). Se utiliza solo con el vapor hmedo. Los argumentos de entrada y los valores devueltos
estn, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por
ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_HPX(P, X)
Argumentos
P
X
Calidad del vapor (fraccin de vapor). X puede estar en el rango de 0,0 a 1,0.
Devuelve
Entalpa especfica calculada en J/g.
Ejemplo
Steam_HPX(10000, 0.9)
Devuelve 2593,7 J/g
Steam_HsatP
Calcula la entalpa especfica del vapor saturado como una funcin de presin (P en kPa). Los
argumentos de entrada y los valores devueltos estn, de forma predeterminada, en unidades SI.
Puede cambiar las unidades de medida, por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_HsatP(P)
Argumentos
P
Devuelve
Entalpa especfica del vapor saturado calculada en J/g.

Ejemplo
Steam_HsatP(10000)
Devuelve 2725,5 J/g
Steam_HsatT
Calcula la entalpa especfica del vapor saturado como una funcin de temperatura (T en C).
Los argumentos de entrada y los valores devueltos estn, de forma predeterminada, en
unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la funcin
Convert.
Sintaxis
Steam_HsatT(T)
Argumentos
T
Temperatura del vapor. T puede estar en el rango de 0,0 a 373,946 C.
Devuelve
Entalpa especfica del vapor saturado calculada en J/g.
Ejemplo
Steam_HsatT(250)
Devuelve 2801 J/g
Steam_PsatT
Calcula la presin de saturacin como una funcin de temperatura (T en C). Los argumentos
de entrada y los valores devueltos estn, de forma predeterminada, en unidades SI. Puede
cambiar las unidades de medida, por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_PsatT(T)
Argumentos
T
Devuelve
Presin de saturacin del vapor calculada en kPa.
Ejemplo
Steam_PsatT(250)
Devuelve 3975,9 kPa

Steam_SPH
Calcula la entropa especfica de vaporizacin como una funcin de presin (P en kPa) y la
entalpa (H, en J/g). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de
Sintaxis
Steam_SPH(P, H)
Argumentos
P
H
Entalpa del vapor. H puede estar en el rango de -0,04159 a 4160,7 J/g.
Devuelve
Entropa especfica del vapor calculada en J/(g K).
Ejemplo
Steam_SPH(10000, 3500)
Devuelve 6,756 J/(g K)
Steam_SPT
Calcula la entropa especfica de vaporizacin como una funcin de presin (P en kPa) y la
temperatura (T, en C). Solo se utiliza con el vapor sobrecalentado o el vapor saturado seco.
Para cualquier valor T inferior a la temperatura de saturacin de P, la funcin devuelve un
error de fuera de rango. La funcin acepta, sin embargo, cualquier valor T dentro del rango de
temperaturas cuando P es mayor que la presin crtica. Los argumentos de entrada y los
Sintaxis
Steam_SPT(P, T)
Argumentos
P
T
Devuelve
Entropa especfica del vapor calculada en J/(g K).
Ejemplo
Steam_SPT(40000, 600)

Steam_SPTL
Calcula la entropa especfica de lquido como una funcin de presin (P en kPa) y la
temperatura (T, en C). Se utiliza solo con el agua comprimida. Para cualquier valor T superior
a la temperatura de saturacin de P, la funcin devuelve un error de fuera de rango. La funcin
acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor
que la presin crtica. Los argumentos de entrada y los valores devueltos estn, de forma
predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo,
utilizando la funcin Convert.
Sintaxis
Steam_SPTL(P, T)
Argumentos
P
T
Devuelve
Entropa especfica de lquido calculada en J/(g K).
Ejemplo
Steam_SPTL(30000, 500)
Steam_SPX
Calcula la entropa especfica de vaporizacin como una funcin de presin (P en kPa) y calidad
(fraccin de vapor). Se utiliza solo con el vapor hmedo. Los argumentos de entrada y los
Sintaxis
Steam_SPX(P, X)
Argumentos
P
X
Calidad del vapor (fraccin de vapor). X puede estar en el rango de 0,0 a 1,0.
Devuelve
Entropa especfica de la vaporizacin calculada en J/(g K).
Ejemplo
Steam_SPX(15000, 0.7)

Steam_SsatP
Calcula la entropa especfica del vapor como una funcin de presin (P en kPa). Los
Sintaxis
Steam_SsatP(P)
Argumentos
P
Devuelve
Entropa especfica del vapor saturado calculada en J/(g K).
Ejemplo
Steam_SsatP(10000)
Steam_SsatT
Calcula la entropa especfica del vapor saturado como una funcin de temperatura (T en C).
Convert.
Sintaxis
Steam_SsatT(T)
Argumentos
T
Devuelve
Entropa especfica del vapor saturado calculada en J/(g K).
Ejemplo
Steam_SsatT(250)
Steam_TPH
Calcula la temperatura del vapor como una funcin de presin (P en kPa) y la entalpa (H, en
J/g). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de entrada y los valores
devueltos estn, de forma predeterminada, en unidades SI. Puede cambiar las unidades de
medida, por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_TPH(P, H)

Argumentos
P
H
Devuelve
Temperatura del vapor calculada en C.
Ejemplo
Steam_TPH(40000, 3500)
Devuelve 643,48 C
Steam_TPS
Calcula la temperatura del vapor como una funcin de presin (P en kPa) y la entropa (S, en
J/(g K)). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de entrada y los
Sintaxis
Steam_TPS(P, S)
Argumentos
P
S
Devuelve
Temperatura del vapor calculada en C.
Ejemplo
Steam_TPS(40000, 6)
Devuelve 595,93 C
Steam_TsatP
Calcula la entropa de saturacin como una funcin de presin (P en kPa). Los argumentos de
Sintaxis
Steam_TsatP(P)
Argumentos

P
Devuelve
Temperatura de saturacin calculada en C.
Ejemplo
Steam_TsatP(10000)
Devuelve 311 C
Steam_VPH
Calcula el volumen especfico de vapor como una funcin de presin (P en kPa) y la entalpa (S,
en J/g). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de entrada y los
Sintaxis
Steam_VPH(P, H)
Argumentos
P
H
Devuelve
Volumen especfico de vapor calculado en cm3/g.
Ejemplo
Steam_VPH(25000, 3500)
Devuelve 14,197 cm3/g
Steam_VPS
Calcula el volumen especfico de vapor como una funcin de presin (P en kPa) y la entropa (S,
en J/(g K)). Se utiliza con el vapor sobrecalentado y hmedo. Los argumentos de entrada y los
Sintaxis
Steam_VPS(P, S)
Argumentos
P
S

Devuelve
Ejemplo
Steam_VPS(40000, 6)
Steam_VPT
Calcula el volumen especfico de vapor como una funcin de presin (P en kPa) y la
temperatura (T, en C). Solo se utiliza con el vapor sobrecalentado o saturado seco. Para
cualquier valor T inferior a la temperatura de saturacin de P, la funcin devuelve un error de
fuera de rango. La funcin acepta, sin embargo, cualquier valor T dentro del rango de
temperaturas cuando P es mayor que la presin crtica. Puede cambiar las unidades de medida,
por ejemplo, utilizando la funcin Convert.
Sintaxis
Steam_VPT(P, T)
Argumentos
P
T
Devuelve
Ejemplo
Steam_VPT(50000, 500)
Steam_VPTL
Calcula el volumen especfico de lquido como una funcin de presin (P en kPa) y la
temperatura (T, en C). Para cualquier valor T superior a la temperatura de saturacin de P, la
funcin devuelve un error de fuera de rango. La funcin acepta, sin embargo, cualquier valor T
dentro del rango de temperaturas cuando P es mayor que la temperatura crtica. Los
Sintaxis
Steam_VPTL(P, T)
Argumentos
P

T
Devuelve
Volumen especfico de lquido calculado en cm3/g.
Ejemplo
Steam_VPTL(75000, 500)
Steam_VsatP
Calcula el volumen especfico de vapor como una funcin de presin (P en kPa). Los
Sintaxis
Steam_VsatP(P)
Argumentos
P
Devuelve
Ejemplo
Steam_VsatP(10000)
Steam_VsatT
Calcula el volumen especfico de vapor saturado como una funcin de temperatura (T en C).
Convert.
Sintaxis
Steam_VsatT(T)
Argumentos
T
Devuelve
Volumen especfico de vapor saturado calculado en cm3/g.
Ejemplo
Steam_VsatT(250)

Steam_XPH
Calcula la calidad del vapor (fraccin de vapor) como una funcin de presin (P en kPa) y la
entalpa (H, en J/g). Se utiliza solo con el vapor hmedo. Los argumentos de entrada y los
Sintaxis
Steam_XPH(P, H)
Argumentos
P
H
Devuelve
Calidad del vapor (fraccin de vapor) calculada.
Ejemplo
Steam_XPH(10000, 2500)
Devuelve 0,82888
Steam_XPS
Calcula la calidad del vapor (fraccin de vapor) como una funcin de presin (P en kPa) y la
entropa (S, en J/(g K)). Se utiliza solo con el vapor hmedo. Los argumentos de entrada y los
Sintaxis
Steam_XPS(P, S)
Argumentos
P
S
Devuelve
Calidad del vapor (fraccin de vapor) calculada.
Ejemplo
Steam_XPS(10000, 5)
Devuelve 0,72695

Uso de marcos de evento para capturar eventos de
proceso
La captura de eventos importantes del proceso y la recopilacin 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 perodo 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 recopilacin de datos a lo largo de perodos 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 anlisis.
Al igual que los elementos permiten recopilar y almacenar datos sobre activos, los marcos de
evento permiten recopilar y almacenar datos sobre eventos. OSIsoft recomienda utilizar
anlisis basados en activos en PI Server 2014 para realizar un seguimiento de los eventos
mediante marcos de evento. PI Datalink, PI Coresight y PI WebParts son herramientas cliente
que permiten visualizar marcos de evento.
Un marco de evento sintetiza el perodo de tiempo del evento con datos de activo completos y
pertinentes:
Datos de evento de ejemplo
En esta seccin
Marcos de evento
Mtodos de creacin de marcos de evento
Plantillas de marcos de evento
Visualizacin de marcos de evento con herramientas cliente
Representacin de eventos en PI Asset Framework
Marcos de evento
Un marco de evento es una funcin de PI System que permite capturar, realizar un
seguimiento, comparar o analizar procesos o eventos empresariales importantes y sus datos
relacionados durante perodos de tiempo repetidos. Los marcos de evento representan
repeticiones del proceso que los usuarios desean conocer; por ejemplo, perodos de inactividad

Uso de marcos de evento para capturar eventos de proceso
de los activos, desviaciones del proceso, inicio y cierre de los equipos, desviaciones
medioambientales, batches de seguimiento de productos, ejecuciones de productos, calidad del
papel o cambios de operador. Al igual que los elementos permiten recopilar y almacenar datos
sobre activos, los marcos de evento permiten recopilar y almacenar datos sobre eventos.
Cada uno de los marcos de evento posee un nombre, una hora de inicio, una hora de
finalizacin, uno o varios atributos y uno o ms elementos de AF referenciados. Al igual que con
los elementos, debe crear plantillas de marcos de evento para estandarizar y gestionar los
atributos de distintos tipos de evento.
PI Event Frames permite realizar bsquedas de los propios eventos en PI System de forma
sencilla, en lugar de buscar eventos por hora. Puede configurar los marcos de evento para que
devuelvan de forma automtica 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. Los marcos de evento se pueden configurar para que recuperen
datos histricos.
Nota:
PI Event Frames se incluye con PI Server 2010 R3 y versiones posteriores. Si tiene otro
paquete de PI Server, como Enterprise Server, consulte a su director de cuenta sobre la
actualizacin al paquete completo de PI Server ms reciente.
Cundo utilizar marcos de evento

Existen dos categoras de eventos de los que se puede realizar seguimiento que encajan en el
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
rpidamente si se producen, como cierres inesperados o desviaciones. Se trata de eventos
de los que el usuario desea realizar un seguimiento e informar de manera global a lo largo
del tiempo.
Estas son algunas de las preguntas que puede hacerse para identificar eventos o condiciones de
los que es necesario realizar un seguimiento:
A qu 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 nico en el tiempo?
Cules son los datos asociados para el perodo de tiempo concreto en que se produjo un
problema o podra producirse en el futuro?
Cules son los eventos de proceso esenciales que es necesario notificar a alguien?
Existe algn estado digital para los tags de PI System que sea significativo cuando se
modifica y deba iniciar alguna otra accin?
En esta seccin
Ejemplos de marcos de evento
Ventajas de PI Event Frames
PI Event Frames o PI Batch?

Ejemplos de marcos de evento

Ejemplo de marcos de evento en una empresa de generacin de energa elica
Tomemos como ejemplo una empresa de generacin de energa elica 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 bsicos 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 energa elica desee obtener contratos de garanta
favorables demostrando que las aspas estn funcionando de forma segura. O es posible que el
operador necesite supervisar parmetros, como la presin del aceite lubricante, el voltaje
mximo, el factor de potencia o el funcionamiento correcto de los servofrenos mecnicos y
electrnicos en las actas antes de que se produzcan desviaciones de proceso. En todos estos
casos, se pueden asociar marcos de evento con atributos de marcos de evento especficos.
El molino de ejemplo de Asset Framework puede incluir estos atributos de activos y atributos
de marcos de evento asociados:
Atributo de activo Atributo de marco de evento
RPM Velocidades instantnea y mxima
Voltaje Voltaje mximo
Potencia Potencia en el momento actual
Giro Giro en el momento actual
Paso Paso en el momento actual
Presin del aceite lubricante Presin mxima del aceite lubricante
Puesto que todos los tipos de turbina comparten atributos idnticos, puede crear solo una
plantilla de marcos de evento 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 notacin especial ".\Elements[.]|RPM" en la plantilla, podr utilizar la
plantilla en cualquier molino y acceder al atributo del elemento concreto referenciado.
Ejemplo de marcos de evento utilizando PI Asset-Based Analytics

Para ver un ejemplo de creacin de marcos de evento utilizando anlisis basados en activos en
PI Server 2014, consulte Crear de forma automtica marcos de evento para realizar un
seguimiento de los datos.
Ventajas de PI Event Frames

PI Event Frames ofrece las siguientes ventajas:
Flexibilidad
Marcos de evento:
Hacen referencia a varios elementos dentro del mismo evento.
Admiten varios eventos de superposicin en un elemento de PI AF.
Capturan cualquier evento; un "batch" es solo un tipo de evento capturable.
Opciones de bsqueda sencillas

Se pueden especificar bsquedas con cualquier nmero de atributos de marco de evento
configurables; la especificacin de un intervalo de tiempo es opcional. Por ejemplo, puede
realizar bsquedas introduciendo simplemente el nombre del marco de evento. Los

atributos de marco de evento buscados con ms frecuencia se pueden configurar como

atributos indexados mediante plantillas de marcos de evento; esto agiliza las bsquedas de
los usuarios finales.
Escalabilidad
PI Event Frames admite un alto grado de escalamiento si bien el rendimiento disminuye con
un gran nmero de batches (decenas de miles).
PI Event Frames o PI Batch?

PI Batch proporciona un procedimiento para generar datos de eventos de batch en funcin de
PI tags. PI Event Frames proporciona un mtodo para realizar un seguimiento y analizar datos
de proceso y empresariales relacionados con eventos definidos en atributos de PI AF.
Las diferentes empresas y usuarios provienen de distintos niveles de implementacin de PI
System y uso de funciones de PI; por lo tanto, recomendar PI Batch o PI Event Frames resulta
bastante subjetivo. Seleccione PI Batch o PI Event Frames en funcin de sus necesidades de
proceso o empresariales, como:
Es usuario de PI Batch y utiliza tendencias de superposicin o RtReports.
Debe continuar utilizando PI Batch. Los casos de uso tpicos de PI Batch incluyen
ejecuciones de calidad del papel, operaciones de proceso de batches qumicos, etc.
No utiliza actualmente PI Batch, pero tiene casos de uso de batches, necesita tendencias de
superposicin o debe utilizar RtReports.
Debe utilizar PI Batch. OSIsoft ofrecer una ruta de migracin en el futuro cuando PI System
sea compatible con estas funciones.
No utiliza PI Batch y no tiene casos de uso de batches.
Debe utilizar PI Event Frames. Los casos de uso tpicos de PI Event Frame incluyen tiempos
de inactividad y cortes de suministro en el sector de la electricidad, desviaciones en el
sector del suministro de agua, etc.
Nota:
OSIsoft no recomienda ejecutar instancias dobles o en paralelo de interfaces de marcos
de evento y batches en la produccin porque aumentan la complejidad de la migracin.
Funciones de PI System no compatibles con PI Event Frames
Tendencia de superposicin (sustitucin en PI BatchView) - Este marco de evento no puede

verse actualmente en PI Coresight pero puede complementarse con productos de terceros.
RtReports - PI AF y los marcos de evento no son compatibles con RtReports; sin embargo,
puede utilizar productos de acceso de PI System, como PI OLEDB Enterprise, para escribir
consultas SQL para soluciones de elaboracin de informes de terceros.
Mtodos de creacin de marcos de evento

Los marcos de evento se pueden crear de diferentes maneras utilizando distintos productos de
OSIsoft compatibles. OSIsoft recomienda utilizar la compatibilidad con los anlisis basados en
activos de PI Server 2014 para crear marcos de evento.

Mediante anlisis basados en activos en PI AF

PI Server 2014 permite crear eventos de una sola capa y activar expresiones que abran o
cierren marcos de evento.
Mediante PI Event Frame Generator (PI EFGen)

PI EFGen utiliza el PI SDK y el AF SDK para crear una jerarqua 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 detalladas sobre la creacin de
eventos con PI EFGen, vea el vdeo How to Create PI EF Events, EF Attributes, and EF
Templates del OSIsoft Learning Channel.
Mediante PI interfaces para sistemas de ejecucin por lotes y de fabricacin

PIBatch Framework 3.x y versiones posteriores pueden crear marcos de evento en una base
de datos de PI AF u objetos de PI Batch en una base de datos de PI Batch. Para obtener ms
informacin sobre la creacin de marcos de evento y el uso de PI interfaces para rellenar la
base de datos de PI AF con datos basados en eventos, consulte el tema PI interfaces for
batch and manufacturing execution systems de la PI Live Library.
Mediante interfaces programables

Puede crear su propio programa personalizado utilizando AF SDK y PI ACE para crear y
supervisar eventos.
Mediante creacin manual de marcos de evento

OSIsoft no recomienda en absoluto la creacin y la administracin de marcos de evento de
forma manual y recomienda utilizar PI Server 2014 junto con Asset-Based Analytics o PI
Batch, en funcin de las necesidades del proceso. Consulte PI Event Frames o PI Batch?
Plantillas de marcos de evento

Mediante plantillas de marcos de evento, puede definir y estandarizar los datos relacionados
(atributos de marcos de evento) asociados con distintos tipos de evento. Puede utilizar
atributos de marco de evento para proporcionar un contexto adicional en torno al evento que
resulta til en las bsquedas. Por ejemplo, los eventos de inactividad tienen con frecuencia un
cdigo de motivo que es posible que los usuarios deseen buscar o filtrar durante el anlisis de
sus eventos de inactividad.
Tambin puede configurar atributos de marco de evento para que hagan referencia a datos de
proceso en el contexto del evento. Por ejemplo, un evento de desviacin de la temperatura es
probable que tenga un atributo para la temperatura mxima. PI Event Frames calcular de
forma automtica estos valores. Asimismo, con cada tipo de evento, puede configurar un ndice
para los atributos que se buscan con ms frecuencia. Esto permite realizar bsquedas de
manera ms rpida y sencilla con PI System cuando se realiza un seguimiento de varios tipos
de suceso o millones de sucesos.
Cree plantillas de marcos de suceso en PI System Explorer en la pestaa Biblioteca en el panel
izquierdo pulsando con el botn secundario sobre Plantillas de marcos de evento y
seleccionando Nueva plantilla.
Los parmetros de sustitucin de una plantilla de marcos de evento con el formato .
\Elements[.]|Attribute indican al marco de evento que seleccione el atributo del
elemento de referencia principal. Esta notacin simple tiene muchos usos prcticos y hace no
sea necesario disponer de distintas plantillas para cada activo asociado con un marco de
evento. Por ejemplo,.\Elements[.]|Temperature dirige al servidor al elemento de
referencia principal y recupera su atributo Temperature.

Visualizacin de marcos de evento con herramientas cliente

PI Datalink, PI Coresight y PI WebParts son herramientas cliente que permiten visualizar
marcos de evento. Asimismo puede utilizar PI OLEDB Enterprise, PI JDBC Driver o PI Web
Services para integrar datos de PI Event Frame en otras herramientas de elaboracin de
informes de terceros.
Nota:
PI Process Book, PI BatchView y PI Manual Logger no permiten actualmente visualizar
marcos de evento.
PI Datalink
La compatibilidad de PI Datalink con los marcos de evento incluye la exploracin y la
comparacin de eventos jerrquicos.
PI Coresight
PI Coresight permite ver y analizar datos de PI System durante el intervalo de tiempo de un
determinado evento. Por ejemplo, es posible que desee examinar el rendimiento de un
activo durante un cambio de operador o comparar los datos de varios activos durante un
perodo de inactividad.
PI Coresight permite ver marcos de evento con el visor "Eventos relacionados". Para
obtener ms informacin, consulte el tema Discovering and analyzing events de la biblioteca
PI Live Library.
Nota:
PI Coresight no admite tendencias de superposicin. Para obtener ms informacin
sobre la eleccin entre PI Batch y PI Event Frames, consulte
PI WebParts
PI WebParts no incluye caractersticas especficas relacionadas con la visualizacin de
marcos de evento. Sin embargo, puede crear un conjunto de datos en funcin de un origen
de datos relacional que obtenga marcos de evento mediante PI OLEDB Enterprise. Los datos
de este marco de evento se pueden mostrar en un elemento web de PI Table, por ejemplo, y
utilizarlos para proporcionar un contexto, como las horas de inicio y finalizacin, a los
dems elementos web de la pgina.
Representacin de eventos en PI Asset Framework

En esta seccin
Trabajo con marcos de evento
Trabajo con transferencias
Captura de valores para marcos de evento y transferencias
Bloquear un marco de evento o una transferencia
Trabajo con marcos de evento

Utilice PI System Explorer para trabajar con marcos de evento.
En esta seccin
Crear un marco de evento

Cambiar plantillas o aadir una plantilla
Crear un marco de evento

Procedimiento
1. En PI System Explorer, haga clic en Marcos de evento en el panel del navegador.
2. En el navegador, haga clic con el botn secundario en la coleccin Bsquedas de marcos de
evento y seleccione Nuevo marco de evento.
Aparecer la ventana Seleccionar plantilla de marco de evento.
3. En el campo de la parte inferior de la ventana Seleccionar plantilla de marco de evento,
seleccione una plantilla de marcos de evento. Si no desea basar el marco de evento en una
plantilla seleccione Ninguno y haga clic en Aceptar.
El nuevo marco de evento aparecer en el visor con cuatro pestaas para poder
configurarlo. La pestaa General contiene las propiedades bsicas de marco de evento. Los
campos son:
Plantilla: Muestra la plantilla que se ha seleccionado al crear el marco de evento. Para

examinar la plantilla, haga clic en . Para cambiar la plantilla, pulse con el botn
secundario sobre el marco de evento en el navegador y haga clic en Convertir > Cambiar
plantilla.
Atributo predeterminado: De solo lectura para elementos basados en plantillas. Consulte
Atributo predeterminado para obtener ms informacin. Este campo es de solo lectura si
el marco de evento se basa en una plantilla.
Nota:
Las propiedades ampliadas son propiedades que otras aplicaciones definen en objetos
de PI AF. Por ejemplo, PI WebParts almacena Icono y URL en las propiedades
ampliadas de los elementos de PI AF. Las aplicaciones acceden, por lo general, a la
informacin almacenada en Propiedades ampliadas mediante programacin con el PI
AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta
caracterstica avanzada.
4. Modifique las pestaas restantes, segn sea necesario. Para obtener ms informacin,
consulte Crear atributos en marcos de evento y Configurar el elemento referenciado
primario.
En esta seccin
Configurar el elemento referenciado primario
Bsqueda de marcos de evento
Crear atributos en marcos de evento
Configurar el elemento referenciado primario

Cada marco de evento hace referencia a uno o varios elementos. La pestaa Elementos
referenciados del marco de evento muestra una lista con todos los elementos a los que accede
el marco de evento. El elemento principal referenciado por el marco de evento se denomina
elemento referenciado primario y se indica con una marca de verificacin en el icono de
elemento
primer elemento referenciado aadido se establece, de forma predeterminada, como elemento
referenciado primario.

1. Pulse con el botn secundario sobre el elemento que desee establecer como elemento
referenciado primario.
2. Seleccione Establecer como referencia de elemento primario en el men que aparece.
Nota:
Si elimina la referencia al elemento primario, PI System Explorer no establecer de forma
automtica un nuevo elemento primario referenciado. Tendr que repetir estos pasos
para crear un elemento primario referenciado de forma manual.
Bsqueda de marcos de evento
Procedimiento
transferencias.
Nota:
una transferencia, se mostrar la coleccin Transferencias recientes en el navegador.
2. Pulse con el botn secundario sobre la coleccin Bsquedas de marcos de evento y
seleccione Nueva bsqueda en el men que se muestra.
Se abrir la ventana Criterios de bsqueda de marcos de evento.
3. Introduzca criterios de bsqueda de marcos de evento. Observe el tringulo situado al final
del campo Buscar; le permitir alternar entre distintos operadores, como: Contiene y
Empieza por.
Marque la casilla de verificacin En curso si desea que en los resultados se muestren solo
marcos de evento sin una Hora de finalizacin concreta.
En el campo Nombre, puede introducir caracteres especiales para encontrar coincidencias
de una parte del nombre. Para obtener ms informacin, consulte Caracteres especiales en
bsquedas de nombres.
Para aadir campos que permitan especificar criterios adicionales, haga clic en Aadir
criterios y seleccione un parmetro de la lista.
Puede utilizar el criterio Raz de bsqueda de marco de evento para indicar que en los
resultados de bsqueda solo se incluyan los marcos de evento que sean secundarios del
marco de evento especificado.
Puede aadir dos criterios en el campo Duracin, si es necesario. Por ejemplo, si desea
buscar un marco de evento cuya duracin haya sido de una hora como mnimo, pero no
superior a tres, defina los dos campos de duracin en consecuencia:
a. Seleccione el operador mayor que o igual a (>=) e introduzca 1h en el campo
b. Seleccione el operador menor que o igual a (<=) e introduzca 3h en el campo
4. Una vez definidos los criterios de bsqueda, haga clic en Buscar.
Los resultados de la bsqueda aparecern en el rea Resultados de bsqueda de la ventana
Criterios de bsqueda de marcos de evento.
5. Para filtrar an ms la bsqueda, escriba en el campo de texto situado en la parte superior
del rea Resultados de bsqueda. A medida que escriba, se irn filtrando los resultados.

Crear atributos en marcos de evento
Procedimiento
1. Localice y seleccione el marco de evento principal en el navegador.
2. Haga clic en la pestaa Atributos del visor.
3. Pulse con el botn secundario en el campo de atributo y seleccione Nuevo atributo en el
men que aparece.
Nota:
Si el marco de evento se basa en una plantilla, no podr aadir un atributo a menos

que la plantilla admita extensiones.
4. En el campo Nombre, introduzca un nombre para el atributo.
5. En el campo Descripcin, introduzca una descripcin para el atributo.
6. Seleccione la casilla de verificacin Elemento de configuracin de los atributos si un cambio
en un valor producir una modificacin del elemento. Anule la seleccin de la casilla para
los atributos con valores que se modificarn con el proceso.
7. Puede organizar los objetos agrupndolos en categoras. Para examinar las categoras
disponibles, haga clic en . Es opcional.
8. En el campo UOM predeterminada, seleccione la unidad de medida del atributo.
9. En el campo Tipo de valor, seleccione el tipo de datos del atributo.
10. En el campo Valor, introduzca una valor esttico para el atributo. Se trata de un campo de
solo lectura cuando el valor viene determinado por una referencia de datos.
11. Si desea utilizar una referencia de datos para determinar el valor del atributo, seleccinela
en el campo Referencia de datos.
12. Si selecciona una referencia de datos, haga clic en Ajustes para configurar la referencia de
datos. Para obtener ms informacin sobre la configuracin de las referencias de datos,
consulte Referencias de datos.
Cambiar plantillas o aadir una plantilla

Puede cambiar la plantilla en la que se basa un marco de evento existente o aadir una plantilla
a un marco de evento que no base en una plantilla.
Procedimiento
1. En PI System Explorer, haga clic con el botn secundario en Marcos de evento en el panel
del navegador.
2. En el navegador, haga clic con el botn secundario en la coleccin Bsquedas de marcos de
evento y seleccione Nueva bsqueda en el men que aparece.
3. Localice el marco de evento que desea modificar.
La coleccin de resultados de bsqueda aparecer en el navegador.
4. Haga clic con el botn secundario sobre el marco de evento adecuado y pulse Convertir >
Cambiar plantilla.
Se abrir la ventana Seleccionar plantilla de marco de evento.
5. Seleccione la plantilla que desee en la lista y haga clic en Aceptar.

Trabajo con transferencias

En este captulo se describe cmo definir, configurar y trabajar con transferencias en PI System
Explorer.
En esta seccin
Transferencias
Crear una transferencia
Transferencias
Las transferencias son un tipo de marco de evento. Determinan el movimiento de materiales en
cantidades discretas. Tienen una hora de inicio y finalizacin. 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.
Crear una transferencia

Procedimiento
transferencias.
Nota:

una transferencia, se mostrar la coleccin Transferencias recientes.
2. Pulse con el botn secundario sobre la coleccin Bsquedas de transferencias y seleccione
Nueva transferencia en el men que se muestra.
Aparecer la ventana Seleccione plantilla de transferencia.
3. Seleccione una plantilla existente para la nueva transferencia o elija la opcin <Ninguna>.
5. Utilice las opciones de la paleta para configurar la transferencia.
Transferir propiedades - Pestaa General
Transferir propiedades - Pestaa Atributos
Transferir propiedades - Pestaa Puertos
En esta seccin


La pestaa General ofrece las siguientes opciones:
Nombre: introduzca un nombre para la transferencia.

Descripcin: introduzca una descripcin para la transferencia (opcional).
Plantilla: de solo lectura. Muestra la plantilla seleccionada al crear el elemento, si hay
alguna. Para examinar las propiedades de la plantilla, haga clic en .
Categoras: De solo lectura para transferencias basadas en plantillas. Puede organizar los
objetos agrupndolos en categoras (opcional). Para examinar las categoras disponibles,
haga clic en . Consulte Categoras para obtener ms informacin.
En los campos Hora de inicio/finalizacin, introduzca las horas de inicio y finalizacin en que
tendr lugar la transferencia. Para examinar un fecha, haga clic en . PI System Explorer
admite la finalizacin automtica de este campo.
En los campos Origen/Puerto, seleccione el elemento y el puerto que proporcionan el
material de la transferencia. PI System Explorer admite la finalizacin automtica de este
campo.
En los campos Destino/Puerto, seleccione el elemento y el puerto que reciben la
transferencia.
Para asignar un atributo predeterminado, haga clic en junto al campo Atributo
predeterminado para mostrar una lista de los atributos disponibles. A continuacin,
seleccione un atributo. Tenga en cuenta que para que aparezcan en la lista, deber aadir
primero los atributos en la pestaa Atributos. Este campo es de solo lectura si la
transferencia se basa en una plantilla. El campo muestra el atributo especificado en la
plantilla.
Nota:
Las propiedades ampliadas son propiedades que otras aplicaciones definen en objetos de
PI AF. Por ejemplo, PI WebParts almacena Icono y URL en las propiedades ampliadas de
los elementos de PI AF. Las aplicaciones acceden, por lo general, a la informacin
almacenada en Propiedades ampliadas mediante programacin con el PI AF SDK. En
general, los usuarios de PI System Explorer no necesitan utilizar esta caracterstica
avanzada.

La pestaa Atributos ofrece las siguientes opciones:
Nombre
Introduzca un nombre para el atributo.
Descripcin
Introduzca una descripcin para el atributo (opcional).
Elemento de configuracin
Mrquela si un cambio de valor producir una modificacin del elemento. Anule la seleccin
de esta casilla para los atributos con valores que se modificarn con el proceso.
Categoras

De solo lectura para atributos basados en plantillas. Puede organizar los objetos
agrupndolos en categoras (opcional). Para examinar las categoras disponibles, haga clic
en . Consulte Categoras para obtener ms informacin.
UOM
La unidad de medida del atributo. Puede cambiar la unidad de medida que se muestra para
el atributo en PI System Explorer; si embargo, la unidad de medida definida en la plantilla
no se modificar.
Tipo de valor
Seleccione el tipo de datos del atributo.
Valor
Introduzca un valor para el atributo. De solo lectura cuando una referencia de datos
determina el valor.
Referencia de datos
Seleccione un tipo de referencia de datos o seleccione ninguno si no es un atributo de
referencia de datos. Si es un atributo de referencia de datos, haga clic en Ajustes para
configurar la referencia de datos (Asociacin de datos con activos).

La pestaa Puertos ofrece las siguientes opciones. Puede editar los valores en las columnas o
hacer clic con el botn secundario sobre el puerto nuevo, seleccionar Propiedades y rellenar el
cuadro de dilogo Propiedades de puerto.
Nota:
Para especificar este puerto como predeterminado, debe abrir el cuadro de dilogo
Propiedades.
En el campo Nombre, introduzca un nombre para el puerto.

En el campo Descripcin, escriba una descripcin del puerto. La descripcin es opcional.
En el campo Tipo de puerto, seleccione el tipo de puerto: Entrada, Salida o No dirigido (para
metros, por ejemplo).
En el campo Categoras permitidas, seleccione las categoras a las que puede pertenecer el
puerto.
En el campo Conexiones mximas, especifique el nmero mximo de conexiones que se
pueden realizar en el puerto. Introduzca cero para un nmero ilimitado de conexiones.
En el campo Tipo de conexin, seleccione los tipos de elemento a los que se puede conectar
el puerto; por ejemplo, Nodo, Lmite, Medicin, etc.
En el campo Plantillas permitidas, seleccione el tipo de elementos que tienen permiso para
conectarse al puerto. Elija solo elementos que se hayan creado a partir de la plantilla
seleccionada.
Captura de valores para marcos de evento y transferencias

Para mostrar los valores de un marco de evento o transferencia, AF ejecuta referencias de
datos para obtener los valores de atributo asociados para el perodo de tiempo indicado. No
obstante, puede utilizar Capturar valores para guardar esos valores en AF. Es posible que esta
accin mejore el rendimiento, puesto que resulta ms rpido mostrar los valores guardados
que obtenerlos.

Tambin puede utilizar Capturar valores para asegurarse de que los valores de atributo
mostrados para los marcos de evento sern igual en el futuro que en el momento en que fueron
capturados. Asimismo, el mtodo Capturar valores permite conservar valores que es posible
que no estn disponibles posteriormente, como la transferencia de datos en streaming, que no
se mantiene a largo plazo.
Al aplicar Capturar valores a un grupo, como una coleccin Bsqueda de marcos de evento o un
marco de evento que contenga marcos de evento secundarios, afecta a todos los marcos de
evento dentro de ese grupo.
Capturar valores
Utilice Capturar valores para guardar valores de marco de evento o de atributos de
transferencia en AF. De esta forma, el rendimiento mejorar, ya que resulta ms rpido
recuperar y mostrar los valores guardados que ejecutar las referencias de datos para
recuperarlos.
Procedimiento
1. En PI System Explorer, haga clic en Marcos de evento en el panel del navegador.
2. En el navegador, haga clic con el botn secundario en un marco de evento o transferencia o
en una coleccin (por ejemplo, Bsqueda de marcos de evento) y seleccione Capturar
valores. (En las capturas de valores posteriores, la opcin se denominar Volver a capturar
valores.)
Cuando aplique Capturar valores a un grupo, como una coleccin de bsqueda de marcos de
evento o un marco de evento que contenga marcos de evento secundarios, la accin se
aplicar a todos los marcos de evento de ese grupo.
Bloquear un marco de evento o una transferencia

Despus de finalizada la accin de un marco de evento o transferencia (por ejemplo, tras
finalizar un batch), el marco de evento o la transferencia seguirn abiertos y podrn continuar
recibiendo datos. No obstante, los marcos de evento o las transferencias se pueden bloquear
para evitar cambios posteriores en ellos.
Para desbloquear un marco de evento o una transferencia, se necesita disponer de permiso de
administrador. Solo los usuarios con este tipo de permiso sobre un objeto podrn
desbloquearlo.
Procedimiento
1. En PI System Explorer, haga clic con el botn secundario en Marcos de evento en el panel
del navegador.
2. En el navegador, abra la coleccin Bsquedas de marcos de evento (o Bsquedas de
transferencias) que contenga el objeto que desea bloquear.
3. Haga clic con el botn secundario sobre el objeto y seleccione Bloquear en el men
contextual.
Junto al objeto bloqueado, se mostrar un icono de candado.


Temas avanzados
En esta seccin se ofrece informacin de referencia, informacin sobre las utilidades de PI AF e
instrucciones para crear tipos de referencia personalizados, administrar mdulos, etc.
En esta seccin
Cadenas de configuracin de atributos
Actualizaciones masivas de cadenas de configuracin
Sintaxis de referencia de atributo
Utilidades de PI AF
Persistencia
Limitaciones respecto a los nombres de objetos de AF
Introduccin de valores para tipos de valor
Creacin de tipos de referencia personalizados
Copiar rutas
Almacenar informacin especfica de aplicaciones
Gestin de mdulos
Modelado de un proceso
Cadenas de configuracin de atributos

La cadena de configuracin de atributo define la totalidad del atributo de referencia de datos.
La sintaxis de una cadena de configuracin depende del tipo de referencia de datos. Para ver la
cadena de configuracin de atributo en PI System Explorer, seleccione el atributo de AF en la
pestaa Atributos. La cadena de configuracin se muestra en el campo situado debajo del
botn Ajustes. Puede seleccionar y copiar la cadena o editarla para modificar la referencia de
datos.
En PI System Explorer, si selecciona un atributo con una referencia de datos, la cadena de
configuracin se mostrar en el cuadro de texto situado debajo del botn Ajustes. Podr
modificar las cadenas de configuracin directamente en el cuadro de texto.
En la siguiente tabla se incluyen ejemplos de cadenas de configuracin de distintos tipos de
referencias de datos:
Tipo de referencia de Cadena de configuracin de ejemplo
datos
Frmula D=Density;V=Volume;[D*V]
A=Attribute3;[A*3];UOM=cm
PI Point \\My_PI_Server\sinusoid
\\192.168.0.255\ChocMilkMeter;TimeMethod=TimeRange;
RelativeTime=-1h;TimeRangeMethod=Total;ReadOnly=False
Matriz de PI Point \\My_PI_Server\Point.1|Point.2|Point.3
Generador de cadenas "%Attribute% value is";'Attribute1';
Bsqueda de tabla SELECT Density FROM [Material Specifications] WHERE
MaterialID = @Product

Temas avanzados
En esta seccin
Cadenas de configuracin para referencias de datos de PI points
Especificacin de PI points
Cadenas de configuracin para creacin automtica de puntos
Cadenas de configuracin para referencias de datos de PI points

En esta seccin se explica la sintaxis de las cadenas de configuracin de las referencias de datos
de PI points. La cadena de configuracin de atributo para las referencias de datos de PI points
incluye la ruta al punto (por ejemplo, \\My_PI_Server\sinusoid). Asimismo, contiene algunas
opciones de configuracin, separadas por punto y coma. Entre las opciones de configuracin
estn:
referencia de PI point (obligatorio, siempre al comienzo de la cadena)

configuracin de obtencin de valor de atributo (opcional)
unidades de medida (opcional)
parmetros de sustitucin (opcional)
especificaciones de creacin de punto: solo vlido para las plantillas de atributos (opcional)
Ejemplos: referencias de datos de PI points

A continuacin, se muestran algunos ejemplos:
Referencia simple a un punto en un PI Server denominado MyPIServer:

\\MyPIServer\sinusoid
Cadena de configuracin que hace referencia al mismo punto, pero con una recuperacin del
tiempo especfica y unidades de medida concretas:
\\MyPIServer\sinusoid;TimeMethod=ExactTime;UOM=C
Cadena de configuracin que hace referencia al mismo punto, pero devuelve un total de
valores de punto durante un intervalo de tiempo ():
\\MyPIServer
\sinusoid;TimeMethod=NotSupported;TimeRangeMethod=Total;RateConversion=day
Cadena de configuracin procedente de una plantilla de atributos que utiliza parmetros de
sustitucin:
\\%Server%\%Element%.%Attribute%
La misma cadena de configuracin, pero con creacin de etiquetas activada y especificacin
de configuracin de punto:
\\%Server%\%Element%.%Attribute
%;ptclassname=classic;pointtype=Float32;engunits=m3/
s;location1=1;location2=30;location4=1;location5=1;pointsource=R
Especificacin de PI points
Para hacer referencia a un PI point, puede utlizar una referencia directa o indirecta. Consulte
Especificacin del PI point para obtener ms informacin.
En esta seccin
Referencia de PI point directa

Temas avanzados
Referencia de PI point directa

En la cadena de configuracin, las referencias de punto directas utilizan dos barras diagonales
inversas para hacer referencia a un PI point en un PI Server. Por ejemplo, para hacer referencia
al punto sinusoid en un PI Server denominado MyPIServer:
\\MyPIServer\sinusoid
En el caso de las plantillas de atributos, puede utilizar tambin parmetros de sustitucin en la

referencia. Por ejemplo, para hacer referencia al punto sinusoid en el PI Server predeterminado
de la base de datos AF del atributo:
\\%Server%\sinusoid
Para hacer referencia a otro atributo, la cadena de configuracin utiliza una ruta relativa. La
ruta relativa identifica un atributo de referencia de datos en funcin de su nombre y del lugar
que ocupa en la jerarqua de elementos y atributos. En el caso de la referencia de datos de PI
Point, la ruta debe incluir una designacin de ruta de atributo (| o ..) en la cadena de
configuracin para que puede diferenciarse de una referencia de PI Point.
En la siguiente tabla, se muestran las configuraciones tpicas de las referencias indirectas:
Objeto Sintaxis de ejemplo
Atributo de nivel superior del mismo elemento |topLevelAttribute
Atributo principal ..
Atributo secundario .|childAttribute
Atributo del mismo nivel (si no hay un atributo de ..|siblingAttribute
nivel superior)
De marco de evento a elemento primario .\Elements[.]|attribute
Ruta completa \\myServer\myDatabase\myElement|
myAttribute
Consulte Sintaxis de referencia de atributo para obtener ms informacin sobre la sintaxis de

ruta relativa.
Nota:
En la referencias indirectas a PI points, el atributo referenciado debe ser un atributo de
referencia de datos de PI point.

Si utiliza la configuracin predeterminada, la cadena de configuracin no incluir la
configuracin del valor de atributo. En PI System Explorer, el valor predeterminado significa
que el campo Por Tiempo se configura como Automtico. Sin embargo, si establece el campo
Por Tiempo en un valor distinto, la cadena de configuracin incluir esos ajustes. Por ejemplo,
si selecciona Hora exacta, la cadena de configuracin muestra:
TimeMethod=ExactTime
En el siguiente ejemplo, TimeMethod,RelativeTime, yTimeRangeMethod son todas opciones

de cadenas de configuracin.
\\MyPIServer\BA:CONC.
1;TimeMethod=TimeRangeOverride;RelativeTime=-1h;TimeRangeMethod=Total;RateConversi
on=day

Temas avanzados
Los ajustes de recuperacin de valor utilizan la hora predeterminada de PI System Explorer

para determinar la hora o el intervalo de tiempo de los valores de atributo mostrados. Para
mostrar valores de atributo para una hora o un intervalo de tiempo diferentes, puede utilizar
Establecer contexto temporal para sustituir los ajustes de tiempo predeterminados. Consulte
Establecer el contexto temporal de los valores de atributo mostrados.
Opciones de las cadenas de configuracin de valor

En la siguiente tabla se incluyen las opciones disponibles para las cadenas de configuracin de
valores:
Opciones Sintaxis Valores Ejemplo
opcin de tiempo TimeMethod=<mtodo donde el mtodo de TimeMethod=Automatic
de tiempo> clculo del tiempo es
uno de los siguientes:
After|AtOrAfter|Before|
AtOrBefore|Automatic|
ExactTime|Interpolated|
NotSupported|
TimeRange|
TimeRangeOverride
opcin de tiempo RelativeTime=[*] +|- donde la unidad de RelativeTime=-1h
relativo <entero><unidad de tiempo es uno de estos
tiempo> valores: y|M|d|h|m|s
opciones de intervalo de TimeRangeMethod=<m donde el mtodo del TimeRangeMethod=Tot
tiempo todo de intervalo de intervalo de tiempo es al
tiempo> uno de los siguientes:
Maximum|Minimum|
PopulationStandardDevi
ation|Range|
StandardDeviation|
StartTime|Total
porcentaje mnimo TimeRangeMinPercentG
correcto del intervalo de ood=<porcentaje>
tiempo1
opcin de base de CalculationBasis=<base donde la base del
clculo del intervalo de del clculo> clculo es una de estas
tiempo1 opciones
EventWeighted|
EventWeightedExcludeE
arliestEvent|
EventWeightedExclude
MostRecentEvent|
EventWeightedIncludeB
othEnds|TimeWeighted|
TimeWeightedContinou
s|
TimeWeightedDiscrete
opcin de conversin de RateConversion=<uom> donde uom es una RateConversion=minute
velocidad2 unidad de medida
definida
opcin de caso case option=Case donde el mtodo del Case Method=EndTime
Method=<mtodo del caso es uno de los
caso> siguientes mtodos:
StartTime|EndTime|
TimeRange|Automatic

Temas avanzados
Opciones Sintaxis Valores Ejemplo

opcin de unidad de UOM=<uom> donde uom es una UOM=C
medida unidad de medida
definida
opcin de solo lectura ReadOnly=<booleano> donde booleano es uno ReadOnly=false
de estos valores: true|
false
1se utiliza al especificar una opcin de intervalo de tiempo
2se utiliza solo cuando TimeRangeMethod=Total
Cadenas de configuracin para creacin automtica de puntos

Si va a configurar una plantilla de atributos, puede utilizar la opcin Creacin de tag para crear
de forma automtica PI points para cualquier atributo que se base en esa plantilla. La cadena
de configuracin debe especificar, como mnimo, el tipo de punto:
\\%Server%\%Element%.%Attribute%;pointtype=Float64
La cadena anterior especifica que los tags son del tipo Float64 y que el resto de la configuracin
del punto utiliza los ajustes predeterminados. Cualquier cambio que realice en los valores
predeterminados de configuracin se incluirn en la cadena de configuracin. Observe, por
ejemplo, esta cadena de configuracin:
\\%Server%\%Element%.%Attribute
%;ptclassname=classic;pointtype=Float32;location4=1;location5=2;pointsource=R;span
=200;zero=1100
La cadena de configuracin anterior especifica los siguientes valores de creacin de tags:

Nombre Ajuste
ptclassname classic
pointtype Float32
pointsource R
location4 1
location5 2
span 200
zero 1100
Actualizaciones masivas de cadenas de configuracin

La herramienta de lnea de comandos afupdatepluginconfigurations permite actualizar varias
cadenas de configuracin de atributos con un nico comando.
Cuando ejecute la herramienta:
1. Utilice el parmetro -root para especificar en qu PI System y, opcionalmente, para qu
base de datos de AF se realizarn las actualizaciones.
2. Seleccione uno de los modos de actualizacin que se describen a continuacin especificando
una de estas tres opciones de actualizacin: -CreateConfig,-Repair o-
ReplacePIServer.

Temas avanzados
3. (Opcional): Ejecute, en primer lugar, el comando con la opcin -list. En lugar de realizar
actualizaciones, la herramienta incluir en una lista todos los atributos con los que se
trabajar.
4. Despus de ejecutar la herramienta, haga clic en Actualizar en PI System Explorer para ver
los cambios ( ).
Opcin -CreateConfig
La opcin -CreateConfig realiza de forma masiva la misma operacin que cuando se hace clic
con el botn secundario en una referencia de datos de PI point y se selecciona Crear o
actualizar PI points. Esta operacin crea el PI point si no existe todava o lo actualiza con los
cambios que se hayan producido. Por ejemplo, si crea un atributo que es una referencia de
datos de PI point, pero no existe todava el PI point, en PI System Explorer haga clic,
simplemente, sobre el nuevo atributo de AF y seleccione Crear o actualizar PI point para crear
el punto.
Para ejecutar la operacin CreateConfig de forma masiva, por ejemplo, en todos los atributos
de una determinada base de datos de AF, escriba el siguiente comando:
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase" -CreateConfig
Para ejecutar la operacin CreateConfig en todos los atributos de un determinado PI System,

utilice el siguiente comando:
afupdatepluginconfigurations "-root:\\MyPISystem" -CreateConfig
Opcin -Repair
La opcin -Repair permite corregir los atributos de referencia de datos de PI point cuya
cadena de configuracin almacenada ha dejado de estar sincronizada con el PI Server. Por
ejemplo, porque se ha eliminado el PI point al que seala la referencia de datos o se le ha
cambiado el nombre.
PI points eliminados
Si ha eliminado un PI point, y ha vuelto a crearlo con el mismo nombre, el ID del nuevo
punto no coincidir con el ID de la cadena de configuracin almacenada. La operacin -
Repair actualiza la cadena de configuracin almacenada con el nuevo point ID.
PI points con otro nombre asignado
Si ha asignado otro nombre a un PI point, la cadena de configuracin almacenada sigue
utilizando el nombre anterior del PI point. La operacin -Repair actualiza la cadena de
configuracin almacenada con el nuevo nombre del PI point.
Atributos que no se han resuelto todava
Si no ha creado todava el PI point al que seala la referencia de datos, la cadena de
configuracin almacenada no incluir el point ID. Despus de crear el PI point, puede
utilizar la operacin -Repair para actualizar la cadena de configuracin almacenada con el
nuevo point ID.
El siguiente ejemplo repara las cadenas de configuracin almacenadas en la base de datos de
AF especificada para que puedan asignarse correctamente a los PI points del PI Server:
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase" -Repair
Opcin -ReplacePIServer
La opcin -ReplacePIServer permite actualizar de forma masiva el nombre del PI Server en
la cadena de configuracin de varios atributos.
El siguiente comando actualiza todos los atributos de una base de datos de AF especificada a un
nuevo PI Server:

Temas avanzados
afupdatepluginconfigurations "-root:\\MyPISystem\MyAFDatabase"
-ReplacePIServer:OldPIServerName;NewPIServerName
Nota:
Utilice dos puntos (:) delante del nombre existente del PI Server. Separe el nombre
existente del PI Server del nombre nuevo del PI Server con un punto y coma (;).
Sintaxis de referencia de atributo

Para hacer referencia a un atributo, puede utilizar una ruta que ubique el atributo en el
servidor, la base de datos y el elemento en el que reside. Una ruta absoluta especifica el
servidor, la base de datos y el elemento en los que se encuentra ubicado el atributo. Una ruta
relativa identifica un atributo en funcin de su nombre y su posicin en la jerarqua de
elementos y atributos.
Mediante filtros, ndices y comodines, puede crear una expresin para representar una ruta
que encuentre un nico atributo o varias rutas que obtengan una coleccin de atributos.
Sintaxis de las especificaciones de ruta

Puede utilizar una ruta, como \\MyPISystem\MyAFDatabase\MyElement|Attribute1, para
hacer referencia a un atributo.
Utilice filtros, ndices y caracteres comodn para crear una expresin que represente una ruta
que devuelva un solo atributo o una coleccin de atributos.
Componentes de una ruta

Los elementos de la ruta deben separarse con una barra diagonal inversa (\), con las siguientes
excepciones:
Los atributos de AF y las plantillas de atributos de AF deben ir precedidos del carcter de
barra vertical (|).
El PI System o PI Server deben ir precedidos de dos barras diagonales inversas (\\).
Para especificar los PI Servers y las bases de datos puede utilizar un nombre o un identificador
nico global (GUID). Un GUID es un nmero exclusivo de 128 bits generado por Windows que
sirve para identificar un componente, aplicacin, 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, seprelos con un punto y coma (;). El primero que se
especifique tendr prioridad en la bsqueda. As pues, en el siguiente ejemplo, el GUID tendr
prioridad:
\\{5c64c379-c182-4f35-8d30-78d8c2f84502};MySystem\{5c64c379-
c182-4f35-8d30-78d8c2f84503};MyDatabase
Al especificar una ruta, puede incluir las siguientes entidades:

El tipo de coleccin en el que est incluido un objeto
Uno o varios filtros de coleccin
ndices, para obtener un miembro concreto de una coleccin
El carcter comodn de asterisco (*), en los nombres de los objetos
Especificacin del PI Server

Las rutas completas deben ir precedidas de dos barras diagonales invertidas (\\) seguidas del
PI System o PI Server.

Temas avanzados
Para indicar el sistema actual, coloque al principio de la ruta relativa dos barras diagonales
invertidas seguidas de un punto (\\.). Por ejemplo, \\.\Database2 hace referencia a la base
de datos denominada Database2 en el sistema actual.
Para especificar una coleccin de PI Servers, utilice el siguiente formato: \
\PIServers[MyPIServerName].
Especificacin de base de datos de AF

La base de datos de AF sigue la especificacin del PI System.
Escriba al principio una barra diagonal invertida simple (\) para indicar la base de datos actual.
Por ejemplo, las rutas\Element2 y \Tables[MyTable] hacen referencia a objetos de la base
de datos actual.
Nota:
Puede acceder a objetos externos que no sean de la base de datos en PI System. Debe
identificar la coleccin como se muestra en el siguiente ejemplo: \\MySystem
\Contacts[JSmith].
Uso de parmetros relativos

Utilice un doble signo de punto (..) para indicar el objeto principal. El siguiente ejemplo hace
referencia al Attribute1 deElement2 que se encuentra en la base de datos actual:..
\Element2|Attribute1. No se puede hacer referencia a un objeto en ms de un nivel por
encima del objeto actual.
Un nico signo de punto (.) representa al objeto actual. Utilcelo para crear una ruta relativa
desde el objeto actual.
Cuando el objeto actual es un atributo de AF, el signo de punto nico seguido de una barra
diagonal invertida (.\) representa el elemento de AF propietario.
Por ejemplo: .\|Attribute1. Un nico signo de punto seguido de una barra vertical (.|)
hace referencia a un atributo AF secundario; por ejemplo, .|Attribute1|Attribute2.
Cuando el objeto actual es un elemento de AF, se crea una ruta relativa desde la base de
datos.
Por ejemplo: \Element1\Element2|Attribute1.
Tambin se admiten rutas a objetos dinmicos. Por ejemplo, PI Point Array.\
\piserver2\sinusoid|sinusoidu crea un atributo de matriz de PI point con dos valores:
Sinusoid y Sinusoidu.
Si es una ruta a un PI Point, se crea un atributo dinmico. Por ejemplo, \
\piserver2\sinusoid crea un atributo con la referencia de datos configurada para leer
valores del PI Point Sinusoid.
Colecciones
Cada objeto principal tiene un tipo de coleccin predeterminado. Por ejemplo, un PI System
tiene una coleccin de bases de datos predeterminada y una base de datos de AF tiene una
coleccin predeterminada de elementos.
Utilice un nico signo de punto 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

Temas avanzados
Filtros
Un filtro de coleccin empieza por el signo (@) seguido del nombre del filtro. Los filtros
admitidos son:
@Name,@Index,@Template,@Category,@ReferenceType,@Description,@Type,@UOM.
Debe incluir la especificacin del filtro entre corchetes ([ y ]). El siguiente ejemplo devuelve el
atributo Volumede todos los elementos en la categora,Tutorial, que pertenecen a la base de
datos denominada MyDatabase:
\\MySystem\Databases[MyDatabase]\Elements[@Category=Tutorial]|Volume
El siguiente ejemplo devuelve los atributos de Element1 que son de tipo Int32:
\Element1|Attributes[@Type=System.Int32]
El siguiente ejemplo devuelve los atributos de Element1 que tienen medidores como unidad
de medida:
\Element1|Attributes[@UOM=meter]
Puede especificar varios filtros, los cuales se evaluarn en el orden especificado. Por ejemplo:
\\MySystem\MyDatabase\Elements[@Template=Tank][@Category=Tutorial]|
Attributes[@Category=Tutorial]
El filtro de ndice
Utilice el filtro de ndice [@Index=int] o[int] para especificar la posicin del objeto
coincidente para devolver (el primer elemento est en la posicin de ndice 1). El filtro de
ndice debe ser el ltimo ndice especificado. El siguiente ejemplo devuelve la tercera base de
datos en la coleccin de bases de datos de AF en el sistema actual:
\\Systems[MySystem]\Databases[@Index=3]
El nombre del filtro de ndice es opcional si se especifica otro filtro delante del filtro de ndice.
Por ejemplo:
\Element#1\Elements[@Name=Tank*][3]
El carcter comodn
Puede colocar el carcter comodn de asterisco (*) en el nombre de cualquier objeto para que
coincida con cero o ms caracteres.
\\MySystem\MyDatabase\[@Name=E*]
\\MySystem\MyDatabase\Elements[@Name=E*][@Index=3]
Nota:
Para encontrar las coincidencias con un asterisco literal, coloque delante de l una barra
diagonal invertida ( \*).
Ejemplos de cmo referenciar 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. Consulte Ruta

completa del antecesor de nivel superior.
Identificar el atributo relativo al atributo actual (el atributo para el que se va a configurar la
referencia de datos): Consulte Especificar el hermano de un atributo de referencia,
Especificar un antecesor de un atributo de referencia y Especificar un descendiente de un
atributo de referencia.

Temas avanzados
Los ejemplos que figuran a continuacin se refieren al dibujo de arriba.

Tipo de referencia Para hacer referencia Desde este atributo Tipo:
a este atributo
Atributo principal Nivel Promedio |Level
o
..
Atributo primario principal Nivel Intervalo |Level
o
..|..
Atributo principal Promedio Intervalo |Level|Average
o
..
Atributo del mismo nivel Promedio Mnimo |Level|Average
o
Average
Atributo secundario Promedio Nivel |Level|Average
o
.|Average
Atributo descendiente del secundario Intervalo Nivel |Level|Average|
Interval
o
.|Average|
Interval
Atributo de nivel superior Temperatura cualquier atributo |Temperature
En esta seccin
Ruta completa del antecesor de nivel superior
Especificar el hermano de un atributo de referencia
Especificar un antecesor de un atributo de referencia
Especificar un descendiente de un atributo de referencia
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. Coloque al principio de la
ruta el smbolo de barra vertical (|) y utilcelo para separar niveles de atributo.
Por ejemplo, la siguiente ilustracin muestra los atributos de un elemento denominado
Reactor1:

Temas avanzados
El antecesor de nivel superior del atributo Intervalo es Nivel. Para hacer referencia al atributo
Intervalo 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 smbolo de barra vertical seguido del nombre de atributo. Por
ejemplo, para hacer referencia al atributo Nivel desde cualquier lugar, escriba:
|Level
Por ejemplo, para hacer referencia al atributo Temperatura desde cualquier lugar, escriba:
|Temperature
Especificar el hermano de un atributo de referencia

Para especificar un hermano, simplemente utilice el nombre del atributo hermano. No se
necesita ningn otro tipo de notacin; sin embargo, la referencia de datos de PI Point requiere
algunos caracteres de ruta de atributo para diferenciarla de una referencia de PI Point. En estos
casos, utilice la ruta de atributo completa del elemento.
En el ejemplo que se muestra ms arriba, los atributos Maximum y Minimum son hermanos.
Para hacer referencia al atributo Maximum al configurar el atributo Minimum, escriba:
Maximum
Especificar un antecesor de un atributo de referencia

Puede utilizar un doble signo de punto (..) para ascender en la jerarqua de atributos. Por
ejemplo, para especificar el atributo principal puede utilizar:
..
Puede utilizar esta notacin para mover hacia arriba los elementos antecesores del atributo.
Por ejemplo, para hacer referencia al atributo primario principal, utilice:
..|..
En la siguiente ilustracin se muestran los atributos de un elemento denominado Reactor1:

Temas avanzados
Para hacer referencia al atributo Level desde el atributo Average, escriba:

..
Dado que Level es el atributo principal de nivel superior, otra posibilidad sera escribir:
|Level
Nota:
No puede utilizar esta notacin para hacer referencia al atributo Temperature desde el
atributo Average, porque este no es un descendiente del atributo Temperature.
Asimismo, no podr utilizar esta notacin para hacer referencia al atributo Average desde
el atributo Interval, porque Average no est en el nivel superior de la jerarqua de
atributos.
Para hacer referencia al atributo Level desde el atributo Interval, escriba:
..|..
No puede utilizar esta notacin para hacer referencia al atributo Maximum desde el atributo
Interval, porque este no es un descendiente del atributo Maximum. En este caso, tendr que
utilizar una ruta completa:
|Level|Maximum
Del mismo modo, para hacer referencia al atributo Temperature desde el atributo Interval,
utilice
|Temperature
Especificar un descendiente de un atributo de referencia

Puede utilizar un punto (.), que indica "este atributo" seguido de una ruta para hacer referencia
a un atributo secundario.
En la siguiente ilustracin se muestran los atributos de un elemento denominado Reactor1:
Para hacer referencia al atributo Average desde el atributo Level, escriba:

.|Average
Para hacer referencia al atributo Interval desde el atributo Level, utilice

.|Average|Interval

Temas avanzados
No puede utilizar esta notacin para hacer referencia al atributo Interval desde el atributo
Temperature, porque este no es un descendiente del atributo Temperature. En este caso,
tendr que utilizar una ruta completa:
|Level|Average|Interval
Ejemplos de cmo referenciar atributos de distintos elementos

Puede referenciar atributos que pertenezcan a distintos elementos del siguiente modo:
Directamente desde el nivel mximo de la jerarqua de elementos en la base de datos

(Atributo relativo a la base de datos)
Mediante la especificacin del elemento principal del atributo de destino con una ruta
relativa (Atributo relativo al elemento contenedor).
En esta seccin
Atributo relativo a la base de datos
Atributo relativo al elemento contenedor
Atributo relativo a la base de datos

Para hacer referencia a un atributo en funcin de una va de acceso relativa a la raz de la base
de datos de AF, especifique el elemento entero y la ruta de los atributos de la base de datos.
Escriba una barra diagonal inversa al principio de la ruta (\) y utilcela 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 jerarqua
de elementos. Puede utilizar siempre esta notacin para hacer referencia a un atributo relativo
al nivel superior de elementos de la base de datos.
Por ejemplo, supongamos que tiene una jerarqua de elementos similar a la que se muestra en
esta figura:
Supongamos que desea hacer referencia a un atributo denominado pressure (presin), que
pertenece al elemento NewTank. Puede escribir lo siguiente:
\Tanks\Tank1\NewTank|pressure
Si desea representar un atributo de presin secundario, denominado temp, la referencia es:

\Tanks\Tank1\NewTank|pressure|temp
Consulte Especificar un descendiente de un atributo de referencia para obtener ms detalles

sobre cmo referenciar atributos secundarios.
Atributo relativo al elemento contenedor

Puede hacer referencia a atributos relativos al elemento contenedor del atributo que va a
configurar. Utilice barras diagonales invertidas (/) para desplazarse hacia abajo en la jerarqua
de elementos y .. para moverse hacia arriba.

Temas avanzados
En esta ilustracin, lso elementos (Tank1, Tank2, Tank3 y NewTank) tiene cada uno de ellos un
atributo denominado presin:
Estos ejemplos demuestran el uso de la sintaxis:
Referencia a un elemento del mismo nivel:

Para referirse al atributo de presin del Tank2 desde el Tank1, escriba:
..\Tank2|pressure
Referencia a un elemento principal:
Para referirse al atributo de presin del Tank1 desde el NewTank, escriba:
..\|pressure
Referencia a un elemento secundario:
Para referirse al atributo de presin del NewTank desde el Tank1, escriba:
.\NewTank|pressure
Ejemplos de cmo referenciar atributos de un marco de evento con el

elemento referenciado principal
Dentro de un atributo de marco de evento, puede hacer referencia a atributos que
pertenezcanal elemento referenciado principal del marco de evento.
Empiece la referencia con .\Elements[.]| para indicar el elemento principal de la coleccin
Elementos del marco de evento. Por ejemplo:
.\Elements[.]|Temperature
Utilidades de PI AF
En esta seccin se describen las utilidades que se suministran con PI AF.
En esta seccin
Iniciar PSE con opciones de lnea de comandos
Exportar objetos de PI AF
Importar objetos de PI AF
AFDiag: Utilidad de diagnstico de PI AF
Configurar la utilidad del servidor de PI AF
Capturar salidas de trazos de eventos en AF SDK
Seguimiento de los cambios en AF con Pista de auditora
Iniciar PSE con opciones de lnea de comandos

PI System Explorer (PSE) se puede invocar con opciones de lnea de comandos que controlen
su seleccin inicial. La aplicacin PI System Explorer se denomina AFExplorer.exe y est
ubicada en la carpeta \PIPC\AF.

Temas avanzados
Procedimiento
1. Abra una ventana de comandos de Windows y cambie a la carpeta \PIPC\AF.
2. Escriba:
afexplorer parameter=paramValue
donde parameter es uno de estos tres parmetros:
/system
/database
/navigator
Consulte Parmetros de AFExplorer para obtener ms informacin.
Para mostrar una lista de los parmetros disponibles, escriba:
afexplorer /?
En esta seccin
Parmetros de AFExplorer
Valores de parmetros de navegador
Parmetros de AFExplorer
La utilidad afexplorer proporciona tres parmetros.
Parmetro Valor Ejemplo
/system Establezca el parmetro del afexplorer /
sistema en el nombre de host del system=MyAFServer
servidor de PI AF al que se
conectar PSE de forma
predeterminada.
/database Establezca el parmetro de la afexplorer /
base de datos en el nombre de la database=MyAFDatabase
base de datos de PI AF que PSE
debe abrir inicialmente.
/navigator Establezca el parmetro del afexplorer /
navegador en el mdulo de navigator=Elements
navegador que debe
seleccionarse inicialmente en
PSE. Los valores disponibles se
encuentran incluidos en Valores
de parmetros de navegador.
Valores de parmetros de navegador

Valor de parmetro Ejemplo
Elements afexplorer /Navigator=Elements
EventFrames afexplorer /Navigator=EventFrames
Library afexplorer /Navigator=Library
UnitOfMeasure afexplorer /Navigator=UnitOfMeasure
MyPI afexplorer /Navigator=MyPI
Notifications afexplorer /Navigator=Notifications

Temas avanzados
Valor de parmetro Ejemplo

AFContactNavigator afexplorer /
Navigator=AFContactNavigator
Exportar objetos de PI AF
La utilidad AF Export es una aplicacin de lnea de comandos que sirve para archivar bases de
datos de AF en un formato XML que puede restaurar posteriormente. Utilice esta utilidad para
archivar elementos, plantillas, marcos de evento, transferencias y otros objetos de una base de
datos de AF. Tambin puede exportar objetos de AF desde PI System Explorer. Consulte la
seccin Importacin y exportacin de bases de datos y objetos de base de datos.
El nombre de la utilidad es AFExport.exe y se encuentra ubicada en la siguiente carpeta:
\PIPC\AF
Para ejecutar la utilidad AF Export, abra una ventana de comandos y navegue hasta la carpeta
PIPC\AF. Utilice la siguiente sintaxis:AFExport.exe y seleccione uno de los parmetros
incluidos en Parmetros de utilidad de exportacin de AF. Para mostrar todos los parmetros,
escriba:
AFExport /?
En esta seccin
Parmetros de utilidad de exportacin de AF
Pautas para exportar colecciones
Ejemplo de rutas de exportacin
Parmetros de utilidad de exportacin de AF

Parmetro Descripcin
<Path>A esta tabla le siguen algunos detalles Ruta a un AFObject que se desea exportar. El
adicionales y ejemplos. formato habitual es: \\<pisystem>\<database>.
Utilice '.' para exportar la base de datos
predeterminada. Vase Ejemplo de rutas de
exportacin.
/File:<string> Especifica un archivo de salida. Si no se especifica
ninguno, la salida se transmite a la consola. (forma
corta /F)
/StartTime:<string> Especifica una hora de inicio para exportar los
marcos de evento, transferencias y casos que se
encuentren entre la hora de inicio y finalizacin
especificadas. (forma corta /T)
/EndTime:<string> Especifica una hora de finalizacin al exportar
marcos de evento, transferencias y casos. (forma
corta /E)
/AllReferences[-] Exporta cualquier objeto referenciado desde el
objeto de AF que se especifique. Esta opcin no se
puede utilizar con la de 'No References'. (forma
corta /A)
/NoReferences[-] No exporta ningn objeto referenciado, incluidos
los objetos secundarios. Esta opcin no se puede
utilizar con la de 'All References'. (forma corta /N)

Temas avanzados
Parmetro Descripcin
/DefaultValues[-] Si no se especifica esta opcin, las propiedades que
estn configuradas con los valores
predeterminados no se exportarn y el resultado
ser un archivo de exportacin considerablemente
ms pequeo. La importacin de un archivo sin
valores predeterminados sobre objetos existentes
puede producir como resultado valores que no se
restablecen a sus valores predeterminados. (forma
corta /D)
/Library[-] Exporta solo los objetos de biblioteca desde una
base de datos. Los objetos de biblioteca incluyen
todas las categoras, plantillas, conjuntos de
enumeracin, tipos de referencia y tablas. (forma
corta /L)
/Security[-] Exporta informacin de seguridad. La exportacin
de informacin de seguridad aumenta el tiempo de
exportacin y los tiempos de importacin
posteriores. (forma corta /Y)
/UniqueIDs[-] Exporta IDs exclusivos de todos los objetos. Esto
permite cambiar el nombre a los objetos cuando se
vuelven a importar a la misma base de datos. Esta
opcin aumenta el tamao del archivo de salida y
puede incrementar el tiempo necesario para la
importacin. (forma corta /U)
/Silent[-] Modo silencioso. Impide que se muestren los
mensajes informativos. Si no se especifica ningn
archivo de salida, se selecciona de forma
automtica esta opcin. (forma corta /S)
/Summary[-] Modo de resumen. Muestra solo la informacin
mnima en curso. Esta opcin no es vlida con el
modo 'Silent' o si no se especifica ningn archivo
de salida. (forma corta /M)
/User:<string> Utilice esta opcin para especificar una cuenta de
Windows diferente para conectarse al servidor de
PI AF. (forma corta /user)
/Password:<string> Si especifica un nombre de usuario, indique la
contrasea de las credenciales de red. (forma
corta /pw)
/Version Utilcelo para mostrar informacin sobre la
versin. Los dems parmetros se omiten. (forma
corta /V)
/Flat[-] Exporta objetos jerrquicos en formato plano. La
exportacin sin formato puede hacer que resulte
ms sencillo editar los objetos con algunas
herramientas. Los objetos jerrquicos que se
exportarn sin formato son: atributos, plantillas de
atributos, elementos y marcos de evento. (forma
corta /flat)
@<file> Lee el archivo de respuesta para obtener ms
opciones. El archivo de respuesta contiene un
nico parmetro por lnea. Las lneas de
comentarios comienzan por el carcter '#'.

Temas avanzados
Pautas para exportar colecciones

Especifique colecciones por el nombre de propiedad de su PI AF SDK, seguido de "[]".
Identifique miembros individuales de una coleccin escribiendo su nombre entre corchetes.
Si no se especifica ningn nombre de coleccin, se asume la coleccin secundaria
predeterminada para la ubicacin de la ruta.
La coleccin secundaria predeterminada de un servidor de PI AF es Bases de datos.
La coleccin secundaria predeterminada de una base de datos es Elementos.
La coleccin secundaria predeterminada de un elemento es Elementos.
La coleccin secundaria predeterminada una base de datos de unidades de medida es UOM.
Una barra vertical (|) indica una coleccin de atributos o de plantillas de atributos.
Ejemplo de rutas de exportacin

Para exportar... ...Utilice esta sintaxis
La base de datos predeterminada Utilice '.'
MyDatabase en el servidor de PI AF \\.\MyDatabase
predeterminado
El elemento MyElement de MyDatabase en \\MyPISystem\MyDatabase\MyElement
MyPISystem
Todas las plantillas de elementos de MyDatabase \\.\MyDatabase\ElementTemplates[]
La plantilla de elementos T1 de MyDatabase \\.\MyDatabase\ElementTemplates[T1]
Todos los conjuntos de enumeracin de la base de \\MyPISystem\.\EnumerationSets[]
datos predeterminada MyPISystem
Todos los atributos de MyChildElement en la base \\MyPISystem\MyElement\MyChildElement
de datos predeterminada \Attributes[]
La base de datos de unidades de medida \\.\UOMDatabase
(UOMDatabase distingue entre maysculas y
minsculas)
Todas las tablas de la base de datos \\MyPISystem\.\Tables[]
predeterminada MyPISystem
Importar objetos de PI AF
La utilidad de importacin de AF es una aplicacin de lnea de comandos que sirve para
restaurar objetos de AF en una base de datos. Tambin puede utilizar Importar desde archivo
en PI System Explorer para restaurar objetos de base de datos. Consulte Restaurar una base de
datos.
El nombre de la utilidad es AFImport.exe y se encuentra ubicada en la siguiente carpeta:
\PIPC\AF
Para ejecutar la utilidad AF Export, abra una ventana de comandos y navegue hasta la carpeta
PIPC\AF. Utilice la siguiente sintaxis:AFImport.exe y seleccione uno de los parmetros
incluidos en Parmetros de utilidad de importacin de AF. Para mostrar todos los parmetros,
escriba
AFImport /?

Temas avanzados
Parmetros de utilidad de importacin de AF

Parmetro Descripcin
<Path> Ruta al AFObject en el que se desea realizar la
importacin. El formato habitual es: \
\<pisystem>\<database>. Utilice '.' para
importar la base de datos predeterminada.
/File:<string> Especifica un archivo de entrada. Si no se
especifica ninguno, la operacin de importacin
realiza la lectura desde la entrada estndar. (forma
corta /F)
/AutoCheckIn[-] Incorpora automticamente los cambios durante
una operacin de importacin. Valor
predeterminado: 'True' (forma corta /A)
/Create[-] Permite a la operacin de importacin crear
objetos. Valor predeterminado: 'True' (forma
corta /C)
/Update[-] Permite actualizar a la operacin de importacin
objetos existentes. Valor predeterminado: 'True'
(forma corta /U)
/CreateUpdatePIPoints[-] Crea o actualiza la configuracin de PI Points para
los elementos creados recientemente. Tenga en
cuenta que esta opcin puede repercutir de
manera significativa en el rendimiento de la
importacin. (forma corta /P)
/DisableConfigStringValidation[-] Inhabilita la validacin de los valores de cadena de
configuracin para las referencias de datos y los
canales de entrada y, de esta forma, se puede
agilizar la operacin de importacin. Sin embargo,
se omitir la bsqueda de PI Points, que corrige o
aade IDs de servidor y Point IDs a las cadenas de
configuracin. (forma corta /D)
/GenerateUniqueNames[-] Genera nombres exclusivos para los objetos
cuando ya existe un objeto con el mismo nombre.
(forma corta /G)
/Paste[-] La operacin de pegar se comporta como un
proceso de copiar/pegar. En funcin de dnde se
importen los datos, determina si se generar un
nombre nuevo o no. (forma corta /Pa)
/ContinueOnError ContinueOnError especifica el comportamiento del
proceso de importacin 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 ejecucin silenciosa
en cuyo caso se cancelar de forma
predeterminada el proceso de importacin. (forma
corta /CE)
/Silent[-] Modo silencioso. Impide que se muestren los
mensajes informativos. (forma corta /S)
/Summary[-] Modo de resumen. Muestra solo la informacin
mnima en curso. (forma corta /M)
/User:<string> Utilice esta opcin para especificar una cuenta de
Windows diferente para conectarse al PI System.
(forma corta /user)

Temas avanzados
Parmetro Descripcin
/Password:<string> Si especifica un nombre de usuario, indique la
contrasea de las credenciales de red. (forma
corta /pw)
/Version Muestra informacin sobre la versin. Los dems
parmetros se omiten. (forma corta /V)
@<file> Lee el archivo de respuesta para obtener ms
opciones. El archivo de respuesta contiene un
nico parmetro por lnea. Las lneas de
comentarios comienzan por el carcter '#'.
AFDiag: Utilidad de diagnstico de PI AF

PI AF Diagnostics es una utilidad de lnea de comandos que sirve para activar o desactivar
caractersticas del servidor de PI AF y ejecutar otras funciones administrativas. La utilidad
establece una conexin directa con la base de datos de SQL Server asociada y requiere el rol
sysadmin o db_afadmin de SQL Server.
El nombre de la utilidad es afdiag y se encuentra ubicada en la carpeta \PIPC\AF.
En esta seccin
Otorgar permisos a la utilidad de diagnstico de AF
Ejecutar la utilidad AFDiag
Parmetros AFDiag
Activacin de Pista de auditora de AF
Utilizar la opcin AFDIAG EnableSQLTrace para recopilar informacin de perfil de SQL
Gestin de proveedores de mdulos de confianza
Cambiar el ID del servidor de AF
Otorgar permisos a la utilidad de diagnstico de AF

Para poder utilizar la utilidad PI AF Diagnostics, tiene que otorgar el rol db_AFAdmin al inicio
de sesin en SQL Server.
Procedimiento
1. En Microsoft SQL Server Management Studio, conctese a la instancia de SQL Server en la
que reside la base de datos de PIFD.
2. En la instancia de SQL Server, expanda la carpeta Seguridad; a continuacin, expanda la
carpeta Inicios de sesin.
3. Pulse con el botn secundario sobre el inicio de sesin del usuario de Windows
correspondiente y seleccione Propiedades.
5. Seleccione la fila de la base de datos de PIFD.
6. Marque la casilla de verificacin Asignar de la base de datos de PIFD.
7. Con la base de datos seleccionada, marque la casilla de verificacin del rol db_Admin, como
se muestra en el siguiente dibujo.

Temas avanzados
8. Haga clic en Aceptar para guardar los cambios y cerrar Microsoft SQL Server Management.
Ejecutar la utilidad AFDiag
Procedimiento
1. Abra una ventana de smbolo del sistema y cambie a la carpeta \PIPC\AF.
2. Tipo:
afdiag parameter
donde parameter es uno de los parmetros incluidos en Parmetros AFDiag.

3. Para mostrar una lista de los parmetros disponibles, escriba:
afdiag /?

Temas avanzados
Parmetros AFDiag
Parmetro Descripcin
/ActiveDirectory:<string> Prueba el acceso a Active
Directory con los ajustes
configurados actualmente en el
servidor de PI AF. Se puede
especificar una cuenta de usuario
opcional para probar otra cuenta.
Si especifica o configura una
cuenta en los ajustes del servidor
de PI AF, tendr que especificar
tambin la opcin Password.
(forma abreviada/AD)
/CertificateAdd Aade el certificado de cliente
especificado a la base de datos
del servidor de PI AF. Utilice la
opcin password para
especificar una contrasea para
el certificado, si es necesario.
(forma abreviada/CA)
/CertificateList Enumera los certificados de
cliente almacenados en la base
de datos del servidor de PI AF.
(forma abreviada /CL)
/CertificateRemove Elimina un certificado de cliente
de la base de datos del servidor
de PI AF especificando el nombre
del certificado. (forma
abreviada /CR)
/CertificateSet:<string> Establece el certificado de
servidor del archivo de
configuracin del servidor de PI
AF en el archivo especificado.
Utilice la opcin Password para
especificar una contrasea para
el certificado, si es necesario.
(forma abreviada/CS)
/ChangeID:<string> Cambie el ID del servidor de AF
al GUID especificado. (forma
abreviada /CID)
/ClearChangeTables Borra la tablas findChanges y
afdiag, que registran
informacin sobre cambios en el
sistema. (forma abreviada /CCT)
/DeleteCases Elimina casos de la base de datos
SQL con una hora de inicio
anterior a la fecha especificada
en la hora local (por ejemplo: /
ATT:"1/1/2008"). (forma
abreviada /DelC)
/DeleteEventFrames Elimina marcos de evento de la
base de datos SQL con una hora
de finalizacin anterior a la fecha
especificada en la hora local (por
ejemplo: /ATT:"1/1/2008").
(forma abreviada /DelEF)

Temas avanzados
Parmetro Descripcin
/DeleteTransfers Elimina transferencias de la base
de datos SQL con una hora de
finalizacin anterior a la fecha
especificada en la hora local (por
ejemplo: /ATT:"1/1/2008").
(forma abreviada /DelTR)
/EnableAuditTrail[-] Activa la funcin de detalles de
pista de auditora en el servidor
de PI AF. Cuando se activa,
permite a los usuarios realizar un
seguimiento de los cambios
realizados en un PI System.
(forma abreviada /AT) Si se
desactiva la funcin de detalles
de pista de auditora, se
eliminarn todos los datos de
cambios de AF 2.6 y las tablas
_CT.
/EnableSqlTrace[-] Recopila informacin sobre las
comunicaciones entre el servidor
de AF y SQL Server. (forma
abreviada /ST)
Consulte Utilizar la opcin
AFDIAG EnableSQLTrace para
recopilar informacin de perfil
de SQLpara obtener ms
informacin.
/EnableExternalDataTables[-] Habilita la compatibilidad con las

tablas de AF externas. (forma
abreviada /DT)
/EnableExternalDataTablesWithAF20[-] Habilita la compatibilidad con las
tablas de AF externas
procedentes de un cliente de AF
2.0. (forma abreviada /DT20)
/EnablePropagationOfTargetDeletion[-] Activa la compatibilidad de la
propagacin de la eliminacin de
destinos (Elementos) para los
anlisis y notificaciones de
referencia. (forma abreviada /
PTD)
/ExeFile:<string> La ruta al archivo ejecutable del
servidor de AF. El valor
predeterminado es
AFService.exe. (forma
abreviada/F)
/ExternalDataTablesAllowNonImpersonatedUsers[-] Habilita la compatibilidad con las
tablas de AF externas para
usuarios no suplantados. (forma
abreviada /DTImp)
@<file> Lee el archivo de respuesta para
obtener ms opciones. El archivo
de respuesta solo puede
contener un parmetro por lnea.
Las lneas de comentarios
comienzan por el carcter '#'.

Temas avanzados
Parmetro Descripcin
/NewID Genera un ID nuevo para el
servidor de PI AF. (forma
abreviada /NID)
/Password Especifica un contrasea de
certificado para las opciones
CertificateSet,Certificate
Add o ActiveDirectory. (forma
abreviada/PWD)
/PlugInVerifyLevel=<level> Configura el nivel de verificacin
necesario para que los mdulos
se ejecuten. Niveles vlidos:
None: Desactiva la validacin;
ejecuta todos los
mdulos.AllowUnsigned:
Ejecuta los mdulos sin firmar y
los mdulos con firmas
vlidas.RequireSigned: Ejecuta
solo los mdulos con firmas
vlidas.RequireSignedTrusted
Provider: Ejecuta solo los
mdulos con una firma vlida de
un proveedor de confianza.
/Port:<integer> Prueba el puerto especificado en
el servidor de AF. Se utiliza para
ejecutar una prueba bsica de
puertos para comprobar si el
puerto especificado en el equipo
utilizado por el servidor de AF se
puede abrir y si hay alguna
escucha en una conexin del
puerto. Los puertos estndar que
utiliza el servidor de AF son 5457
y 5459. Es similar a la ejecucin
de una prueba de puerto con
Telnet. Comprueba todas las
direcciones IP del equipo (las
direcciones IPv4 e IPv6). Por lo
general, debe comprobar los dos
puertos, 5457 y 5459. (forma
abreviada /P)
/PrintSqlTraceSummary:DateTime Imprime registros de resumen de
la tabla generada por la opcin /
EnableSqlTrace a partir de la
fecha que se especifique. (forma
abreviada /STP)
/Reindex Vuelve a generar por completo
todos los ndices de la base de
datos SQL del servidor de PI AF.
Resulta til despus de una
insercin masiva de datos para
mejorar de forma sustancial el
rendimiento. (forma
abreviada /RI)
/Silent[-] Modo silencioso. Evita que se
muestre el mensaje. (forma
abreviada /S)

Temas avanzados
Parmetro Descripcin
/TruncateSqlTrace:DateTime Elimina los registros creados con
anterioridad a la fecha
especificada de la tabla generada
por la opcin /EnableSqlTrace.
(forma abreviada /ST0)
/TrustedProviderAdd:<providername> Aade el proveedor especificado
a la lista de proveedores de
mdulos de confianza. Para
aadir proveedores, debe tener
el rol sysadmin o db_afadmin de
SQL Server.
/TrustedProviderList Muestra la lista de proveedores
de mdulos de confianza. Para
listar proveedores, debe tener el
rol sysadmin o db_afadmin de
SQL Server.
/TrustedProviderRemove:<providername> Elimina el proveedor
especificado de la lista de
proveedores de mdulos de
confianza. Para eliminar
proveedores, debe tener el rol
sysadmin o db_afadmin de SQL
Server.
/Version Muestra informacin de la
versin. (forma abreviada /V)
Activacin de Pista de auditora de AF

Utilice la opcin EnableAuditTrail (/AT) con la utilidad AFDiag para activar o desactivar la
funcin Pista de auditora.
Antes de activar la funcin Pista de auditora de AF, compruebe los siguientes requisitos:
Debe utilizar SQL Server 2008 Enterprise o posterior con su base de datos SQL de AF (SQL
Server 2008 Standard Edition no es compatible). Para los usuarios que trabajen solo en un
entorno de desarrollo, SQL Server 2008 Developer o posteriores son tambin compatibles.
El Agente SQL Server debe estar en ejecucin para poder activar la funcin Pista de
auditora.
Para activar o desactivar la funcin Pista de auditora, debe pertenecer al rol sysadmin en el
SQL Server que contenga la base de datos SQL de PI AF.
Nota:
Para los usuarios que hayan utilizado versiones anteriores de Pista de auditora de AF: No
podrn acceder con la nueva funcin Pista de auditora de AF 2.6. a los datos de pista de
auditora existentes. Podrn seguir accediendo a esos datos como antes. Despus de
actualizar el sistema PI AF a la versin 2.6, probablemente desee activar la funcin Pista
de auditora de AF para tener la seguridad de que captura todos los cambios a partir de
ese momento con la nueva funcin Pista de auditora de AF.
Compatibilidad de Pista de auditora con colectivos de PI AF

La funcin Pista de auditora no es compatible con los miembros secundarios de los colectivos
de PI AF. Si aade un servidor de PI AF con la funcin de Pista de auditora activada a un
colectivo de PI AF como miembro secundario, la funcin de Pista de auditora se desactivar en

Temas avanzados
ese miembro secundario. Los datos de Pista de auditora solo se almacenan en el miembro
primario de un colectivo de PI AF y no se duplican en ningn miembro secundario del
colectivo.
Nota:
Cuando disee los procedimientos de copia de seguridad de SQL Server para los datos de
PI AF, tenga en cuenta que si el miembro primario del colectivo de PI AF deja de estar
disponible, los datos de Pista de auditora tambin dejarn de estarlo. Si el miembro
primario de un colectivo de PI AF no se puede recuperar desde una copia de seguridad,
tampoco se podrn recuperar los datos de Pista de auditora.
Reactivacin de Pista de auditora de AF

Si aade un servidor de PI AF existente con Pista de auditora activada como miembro
secundario, pero posteriormente elimina ese servidor del colectivo, tendr que reactivar Pista
de auditora en ese servidor concreto. De lo contrario, la auditora permanecer desactivada.
Utilizar la opcin AFDIAG EnableSQLTrace para recopilar informacin de

perfil de SQL
Puede utilizar la opcin /EnableSQLTrace del mandato AFDiag para recopilar informacin
sobre las comunicaciones entre el servidor de AF y SQL Server. Es similar a la informacin
procedente de Analizador de SQL Server, una herramienta de diagnstico de Microsoft que
permite supervisar las comunicaciones con SQL Server. Aunque el Analizador de SQL Server
requiere el privilegio SysAdmin, no es necesario para ejecutar AFDiag /EnableSqlTrace.
Dado que la informacin se registra en una tabla de SQL Server, la ejecucin de AFDiag /
EnableSqlTrace afectar al rendimiento. Por lo general, no se debe ejecutar AFDiag /
EnableSqlTrace en un sistema de produccin de AF a menos que sea para supervisar o
resolver un problema.
En algunos casos, el volumen de datos registrados puede aumentar de forma considerable.
Puede utilizar la opcin /TruncateSqlTrace para eliminar registros de la tabla antes de la
fecha que especifique. Por ejemplo, el siguiente mandato eliminar de la tabla los registros
anteriores al 1 de enero de 2014:
AFDiag /ST0:"1/1/2014"
La opcin /PrintSqlTraceSummary imprime registros de resumen de la tabla a partir de la

fecha que se especifique. Por ejemplo, el siguiente mandato imprime registros a partir del 1 de
enero de 2014:
AFDiag /STP:"1/1/2014"
La salida de AFDiag /EnableSqlTrace incluye las siguientes columnas:

Nombre de columna Descripcin
Nombre de procedimiento almacenado Puede ser til a efectos de depuracin cuando se
trabaja con el servicio de soporte tcnico
Duracin SUM Resumen de la duracin de la llamada del
procedimiento almacenado a lo largo del perodo
de este informe de resumen (en milisegundos)
Duracin MIN Tiempo de ejecucin ms rpido de este
procedimiento almacenado durante el perodo de
este informe de resumen (en milisegundos).
Duracin MAX Tiempo de ejecucin ms lento de este

Temas avanzados
Nombre de columna Descripcin

Duracin AVG Promedio de tiempo de ejecucin de este
Recuento de llamadas Las veces que se ha llamado a este procedimiento
almacenado durante el perodo de este informe de
resumen.
Nota:
El uso de AFDiag /EnableSqlTrace no es compatible en un miembro secundario de un
colectivo de AF.

De forma predeterminada, puede ejecutar mdulos de PI AF de cualquier proveedor. Para
tener ms seguridad, puede configurar PI AF para que solo se puedan ejecutar los mdulos de
proveedores de confianza (servidor de PI AF 2.5 y posterior). Se recomienda a los proveedores
que firmen el cdigo de sus mdulos con la tecnologa Authenticode. Para controlar cmo se
aplicar la seguridad de los mdulos, puede configurar el verify level.
Para mostrar una lista de los proveedores de confianza, especifique el parmetro afdiag/
TrustedProviderList. Para obtener ms detalles, consulte Parmetros AFDiag. Para aadir
un proveedor, especifique el parmetro /TrustedProviderAdd:<providername>. Para
eliminar un proveedor, especifique el parmetro /
TrustedProviderRemove:<providername>.
1. Pulse con el botn secundario sobre el archivo dll del mdulo y seleccione Propiedades. Se
mostrar la ventana Propiedades.
2. Haga clic en la pestaa Firmas digitales. (Si el mdulo no est firmado, no aparecer esta
pestaa.)
3. Haga clic en el botn Detalles. Aparecer la ventana Firmas digitales.
4. Haga clic en Ver certificado. Se mostrar la ventana Certificado.
5. En la pestaa Detalles, desplcese al campo Asunto. En este campo se muestra el nombre
del proveedor de confianza, que debe utilizar como parmetro <providername> de los
parmetros /TrustedProviderAdd y /TrustedProviderRemove.
Para mostrar el nivel de verificacin utilizado al cargar los mdulos de ejecucin, emita el
mandato afdiag y omita cualquier parmetro. El nivel de verificacin se incluir en la seccin
Opciones de configuracin de la salida resultante.
Para establecer el nivel de verificacin, ejecute el comando afdiag, especificando el
parmetro /PlugInVerifyLevel. Los niveles vlidos son:
None: Desactiva la validacin; ejecuta todos los mdulos.

AllowUnsigned: Ejecuta los mdulos sin firmar y los mdulos con firmas vlidas.
RequireSigned: Ejecuta solo los mdulos con firmas vlidas.
RequireSignedTrustedProvider: Ejecuta solo los mdulos con una firma vlida de un
proveedor de confianza.

Temas avanzados
Cambiar el ID del servidor de AF

Utilice las funciones ChangeID o NewID para cambiar el identificador nico asociado con el
servidor de PI AF.
El valor devuelto 1 indica que el cambio de configuracin se retrasar. El valor devuelto 2
significa que debe reiniciar el servidor de PI AF. Un valor devuelto negativo indica que se ha
producido un error.
Configurar la utilidad del servidor de PI AF

La utilidad Set PI System (setpisystem) permite configurar servidores de PI AF
conocidos.setpisystem se encuentra ubicado en el directorio PIPC\AF. Los parmetros
disponibles de setpisystem se incluyen en la siguiente tabla.
Parmetro Descripcin
/Name:<string> Especifique el nombre del servidor de PI AF para
modificar o crear. Si no se especifica, se utilizar el
servidor de PI AF predeterminado. (Forma
abreviada /N)
/Host:<string> Especifique el nombre de host del servidor de PI AF.
(Forma abreviada /H)
/Protocol:<Tcp|NamedPipe> Especifica el protocolo del servidor de PI AF. (Forma
abreviada /C)
/Port:<integer> Especifica el puerto del servidor de PI AF. (Forma
abreviada /P)
/Timeout:<integer> Especifica el tiempo de espera del servidor de PI AF en
segundos. (Forma abreviada /T)
/AccountName:<string> Especifica el nombre de cuenta del servidor de PI AF.
(Forma abreviada /A)
/DefaultPISystem Establece el servidor de PI AF especificado como el
servidor de PI AF predeterminado. (Forma
abreviada /D)
/Remove Elimina el servidor de PI AF especificado de la lista de
servidores de PI AF conocidos. (Forma abreviada /R)
/Silent[-] Modo silencioso. Evita que se muestre el mensaje.
(Forma abreviada /S)
/List Enumera los servidores de PI AF conocidos actuales.
(Forma abreviada /L)
/AddAlias:<string> Aade el alias especificado al PISystem (servidor de
AF). (Forma abreviada /AA)
/RemoveAlias:<string> Elimina el alias especificado del PISystem (servidor de
AF). (Forma abreviada /RA)
Capturar salidas de trazos de eventos en AF SDK

Puede utilizar la utilidad AF Get Trace (afgettrace.exe) para capturar salidas de trazos de
eventos en AF SDK. Los trazos de eventos permiten depurar una aplicacin y ejecutar anlisis
de capacidad y rendimiento.

Temas avanzados
Procedimiento
1. Abra una ventana de comandos y vaya a la carpeta PIPC\AF.
2. Opcional: Para mostrar la sintaxis y los parmetros de esta utilidad, escriba:
afgettrace /?
3. Para ejecutar AF Get Trace, escriba: afgettrace en la ventana de comandos. De forma
predeterminada, las salidas se muestran en formato estndar y se pueden guardar en un
archivo de registro.
4. Para finalizar el trazado, escriba: Xen la ventana de comandos. Si sale de la ventana de
comandos sin cerrar afgettrace, se seguirn generando trazos de eventos, lo cual podra
ralentizar las aplicaciones de AF SDK.
Seguimiento de los cambios en AF con Pista de auditora

Si se ha activado Pista de auditora de AF en el sistema, puede abrir la ventana Pista de auditora
de AF para ver los cambios en los objetos de AF procedentes de todas las bases de datos de AF.
Consulte Activacin de Pista de auditora de AF para obtener ms detalles sobre cmo activar
esta funcin.
La ventana Pista de auditora de AF contiene una tabla; cada fila de la tabla contiene los datos
que identifican un cambio concreto en un objeto de AF. Haga doble clic en un fila para ver los
detalles sobre esa modificacin.
Podr copiar y pegar las filas de cualquiera de las ventanas en otro documento, como una hoja
de clculo, por ejemplo.
Ver cambios en la ventana Pista de auditora de AF

Antes de empezar
Debe ser administrador de PI System para poder abrir la ventana Pista de auditora de AF.
Procedimiento
1. Abra la ventana Pista de auditora de AF. En PI System Explorer, haga clic en Herramientas
> Pista de auditora de AF. La tabla en la ventana enumera los cambios en los objetos de AF.
Cada fila incluye:
Fecha
La fecha y la hora del cambio
Accin
El tipo de cambio (insertar, actualizar o eliminar)
Tipo
El tipo de objeto que ha cambiado
Base de datos
La base de datos de AF que contiene el objeto modificado
Ruta
La ruta jerrquica al objeto modificado (cuando el objeto es secundario de un objeto
principal, la ruta muestra el objeto principal)

Temas avanzados
Nombre
El nombre del objeto modificado
Usuario
El usuario que ha realizado el cambio, con el formato [dominio]\[usuario]
2. Opcional: Consulte los cambios de un perodo de tiempo posterior o anterior. Haga clic en
Adelante (botn de flecha derecha) para ver los cambios del siguiente perodo de tiempo;
haga clic en Atrs (botn de flecha izquierda) para mostrar los cambios del perodo de
tiempo anterior.
En los perodos de tiempo de 24 horas, por ejemplo, cada vez que haga clic, pasar al
perodo de 24 horas siguiente (o anterior).
3. Opcional: Modifique Hora de inicio y Hora de finalizacin para ajustar el perodo de tiempo.
Haga clic en el botn de calendario para elegir o introducir una hora nueva o cree una
expresin de tiempo relativa seleccionando una opcin en la lista del botn de tringulo.
Haga clic en Actualizar (o pulse la tecla Intro) para mostrar la tabla actualizada.
Cuando haya muchos cambios para el perodo actual, es posible que desee reducirlos. El
perodo de tiempo contiene menos cambios y, de esta forma, el nmero de filas con cambios
de la tabla resulta ms manejable.
4. Opcional: Cambie el valor del campo Recuento mx. para definir un lmite en cuanto al
nmero de filas con cambios que se devolvern para el perodo de tiempo actual. Haga clic
en Actualizar (o pulse la tecla Intro) para mostrar la tabla actualizada. Es posible que desee
ajustar el valor del campo Recuento mx. para controlar el tiempo de respuesta. Adems, si
el nmero de cambios de perodo actual supera el valor de Recuento mx., podr
aumentarlo para mostrarlos. (Tambin puede modificar el nmero de cambios mostrados
ajustando el perodo de tiempo.)
5. Opcional: Escriba texto en el campo Filtro para filtrar los resultados devueltos en la tabla.
Utilice la lista de la flecha abajo situada en el extremo derecho del campo Filtro para
seleccionar un tipo de filtro. Introduzca criterios de filtro en el campo Filtro y haga clic en el
botn Buscar.
En la tabla se mostrarn solo las filas que contengan los criterios del filtro.
6. Opcional: Para ver los detalles de una fila de la tabla, haga doble clic para abrir la ventana
Detalles de pista de auditora de AF. Se muestran los siguientes datos para los elementos
incluidos en la lista:
Accin
Tipo de cambio (insertar, actualizar o eliminar) y el sub-objeto del objeto de AF (por
ejemplo, un atributo o un valor de atributo)
Nombre
El sub-objeto de AF; puede estar en blanco.
Nombre de propiedad
El nombre de columna de la tabla SQL en la base de datos SQL de PI AF (PIFD) para el
sub-objeto modificado. Aunque el nombre no se entienda fcilmente, proporciona un
mtodo para incluir todos los datos en el registro que se ha modificado.
Valor anterior
El valor antes del cambio
Valor nuevo
El valor despus del cambio

Temas avanzados
Persistencia
El Directorio de datos acepta cualquier tipo de objeto en su SetValue, siempre y cuando pueda
convertirse al tipo de datos y unidad de medida configurados. Sin embargo, el Directorio de
datos puede guardar los siguientes tipos de valor:
Un tipo de valor .NET (tipos ms bsicos)

Una matriz de tipos de valor .NET
Un objeto serializable .NET
Un objeto compatible con la interfaz IPIPersist del PI SDK. Esta ltima compatibilidad
permite la interopoerabilidad con el PI SDK, dado que permite a los atributos almacenar
referencias a PI Points, mdulos, batches, etc. Todos los objetos de AF son tambin
compatibles con la interfaz IPIPersist, lo que significa que se pueden almacenar como
valores en atributos o en las PIProperties del PI SDK, segn se necesite.
Si un objeto no puede persistir, se emitir una excepcin al guardar el elemento contenedor.
Si un objeto no puede persistir, se emitir una excepcin al guardar el elemento contenedor.
Limitaciones respecto a los nombres de objetos de AF

Tipo de objeto Caracteres no permitidos
Otro que no sea contactos Caracteres de control ms: * ? ; { } [ ] | \ ` ' "
Contactos Caracteres de control ms: * ? ; [ ] | \ "
Para todos los tipos de objeto:
PI AF elimina de forma automtica los espacios iniciales y finales de los nombres.

La longitud mxima para los nombres es 259 caracteres.
No se permiten los nombres en blanco.
Introduccin de valores para tipos de valor

Puede introducir valores para:
valores de atributo (salvo atributos que tengan atributos de referencias de datos)

valores predeterminados de plantillas de atributos
valores de propiedad ampliada
Los formatos de los siguientes tipos de valor necesitan una breve explicacin.
DateTime: Si el tipo de valor es DateTime, 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 vlidas:
*-5d
May 12, 2009
07 06 2010 10:00:00 AM
09 14 2008 14:00:00

Temas avanzados
Nota:
PI System Explorer resolver la cadena cuando se introduzca y enviar la fecha y hora
resultantes a AF.
Para crear un atributo con un enlace como valor, seleccione la cadena de tipo de valor y
convierta el URL en el valor de atributo. Las cadenas reconocidas como direcciones URL
absolutas se mostrarn como un enlace.
Por ejemplo, las cadenas que empiezan por http://,ftp://,file:// y www. se reconocen
como enlaces, en tanto que las cadenas que empiezan por C:\,\\server\ y abc.com no se
reconocen como tales. En PI System Explorer, estos valores aparecern subrayados con una
sugerencia, Pulse CTRL+Clic para seguir el vnculo.
Anything: Aunque es vlido, no se recomienda utilizar el valor Anything.
Nota:
Consulte Limitaciones respecto a los nombres de objetos de AF para conocer los valores
de nombres de objeto.
Configurar el valor de atributo con el nombre de otro atributo

Los tipos de valor atributo y elemento permiten buscar y guardar un elemento de AF o un
atributo de AF (no un valor de atributo) respectivamente.
Nota:
Se trata de una caracterstica avanzada que se suministra para proporcionar
compatibilidad con versiones anteriores en determinados casos de uso. Es posible que no
est disponible en versiones futuras.
Creacin de tipos de referencia personalizados

Los tipos de referencia personalizados son fciles de crear. Cada tipo de referencia se debe
basar en uno de los tres tipos de referencia predefinidos. Mediante el uso de tipos de referencia
personalizados, puede crear reglas que permitan a AF ayudar a los usuarios cuando creen
elementos nuevos. Consulte Representacin de plantillas secundarias para obtener
informacin sobre la creacin de referencias de plantilla.
En esta seccin
Nivel de fortaleza de los tipos de referencia de elemento
Tipos de referencia predefinidos
Crear tipos de referencia personalizados
Nivel de fortaleza de los tipos de referencia de elemento

Los elementos se pueden relacionar entre s de varias formas a travs de un Tipo de referencia.
Los tipos de referencia son con nombre y se ajustan siempre a una jerarqua. Si opta por no
utilizar tipos de referencia, el sistema usar automticamente un tipo de referencia definido
por l que opera exactamente igual que Module Database en lo que respecta a la jerarqua.
Existen tres niveles de fortaleza de tipo de referencia:
Fuerte En ausencia de un principal de composicin, un elemento existe siempre y cuando

tenga uno o ms principales con una relacin fuerte. Es un comportamiento similar al de las
referencias en Module Database.

Temas avanzados
Un tipo de referencia que tenga fuerte como nivel de fortaleza, por ejemplo, el tipo de
referencia predeterminado principal-secundario, permite al elemento secundario tener
muchos principales. Si se elimina el ltimo elemento principal del secundario, el propio
elemento secundario se eliminar. Este era el nico tipo de referencia disponible en AF 1.x.
Utilice una referencia fuerte entre dos elementos cuando desee que el elemento secundario
exista siempre y cuando tenga una referencia fuerte con un principal como mnimo, pero no
desee que los elementos secundarios sean considerados como una unidad simple con el
elemento principal. Por ejemplo, el medidor pertenece a una empresa y se vincula a un
edificio. Tendra que utilizar una referencia fuerte entre el elemento de la empresa y el
elemento secundario del medidor y otra, entre el elemento del edificio y el elemento
secundario del medidor. Si el medidor se elimina del edificio, seguir existiendo porque
conservar una referencia fuerte con el elemento de la empresa. Si se elimina tambin de la
empresa, dejar de existir porque todas las referencias fuertes se habrn eliminado.
Dbil Las referencias dbiles deben utilizarse cuando no se desee que el principal
determine la duracin de un secundario.
El tipo de referencia ms simple es un tipo de referencia que tiene dbil como nivel de
fortaleza. Utilice una referencia dbil entre dos elementos cuando desee crear una relacin
entre dos elementos, pero no desee que esa relacin determine la duracin 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
automticamente de la agrupacin. En este caso, tendra que utilizar una referencia dbil
entre el elemento principal del grupo y el elemento secundario del medidor.
Composicin. Una referencia de composicin significa que el elemento principal define
nicamente al elemento secundario y es propietario de l. En este tipo de relacin, un
secundario solo puede estar contenido en un principal y si se elimina el principal, se
eliminar tambin el secundario.
Un tipo de referencia que tenga composicin como nivel de fortaleza significa que el
elemento secundario forma parte intrnseca del principal y no puede existir sin l. Si elimina
un elemento principal que tenga una referencia de composicin con un elemento
secundario, eliminar tambin este ltimo. Asimismo, un elemento secundario solo puede
tener una referencia de composicin con un principal.
Utilice una referencia de composicin cuando los dos objetos de la relacin se consideren
como un nico elemento. Por ejemplo, un medidor puede estar compuesto de dos sensores;
por lo tanto, tendra que utilizar una referencia de composicin entre el elemento del
medidor y cada uno de sus dos elementos secundarios de sensor. Si elimina el elemento del
medidor, eliminar tambin los elementos secundarios de sensor. Cuando extraiga uno de
los elementos de sensor para hacer un cambio, el otro elemento de sensor y el elemento de
medidor se extraern a la vez.
Los tipos de referencia definidos por el sistema son:
Child-Parent Define un tipo de referencia fuerte n..n, y se utiliza para crear referencias
de tipo de Module Database. Este es el tipo de referencia predeterminado si no se especifica
ninguno. Este tipo de referencia exige nombres exclusivos y referencias no circulares.
IsComposedOf-ComposedBy Define un tipo de referencia 0..n y se utiliza para crear
jerarquas de composicin de tipos de AF. Puede haber algunas diferencias en cuanto a los
comportamientos "Extraer" y "Creacin de versiones".
Referenced-Referenced By Define una referencia dbil n..n.
Los usuarios, o las aplicaciones, pueden definir tipos de referencia adicionales. De esta forma,
podr disponer de jerarquas especficas de aplicacin de elementos utilizando una relacin
ms especfica y permite a las aplicaciones, definir o sustituir detalles del comportamiento de
las relaciones.

Temas avanzados
Los tipos de referencia entre elementos se definen en el nivel de base de datos. Los tipos de
referencia tienen nombre, tienen un nombre de relacin inversa, exigen nombres nicos y
estn restringidos por plantilla.
Los tipos de referencia se definen en el nivel de base de datos porque, por lo general, abarcan
varias plantillas de elementos, como es el caso del tipo definido por el sistema Child-Parent.
Una instancia de un tipo de referencia, la relacin entre dos elementos concretos, se denomina
Referencia.
Tipos de referencia predefinidos

Tipo de referencia predeterminada de AF Fortaleza de la referencia
Composicin Composicin
Principal-secundario Fuerte
Dbil Dbil
Crear tipos de referencia personalizados

Para crear un tipo de referencia, pulse con el botn secundario sobre la coleccin de tipos de
referencia en el navegador y seleccione Nuevo tipo de referencia, como se muestra en la figura
ms arriba.
Procedimiento
1. En el campo Nombre, introduzca un nombre para el tipo de referencia y en Hijo y Nombre
del primario, introduzca los nombres del primario y el secundario.
2. En el campo Categoras, introduzca la categora o categoras de tipos de referencia,
separadas por dos puntos, a las que pertenece el tipo de referencia. Haga clic en para ver
las opciones.
3. En el campo Fortaleza de la referencia, seleccione Fuerte, Dbil o Composicin. Consulte la
seccin Crear una referencia de elemento para conocer las definiciones sobre los distintos
niveles de fuerza.
4. En los campos Plantilla hija permitida/Plantilla de elemento primario permitida, introduzca
la plantilla o plantillas, separadas por dos puntos, a las que pertenecen los elementos
primarios o secundarios. Haga clic en para ver las opciones.
Nota:
Puede crear tipos de referencia con ms rapidez en la coleccin de plantillas de

elementos si utiliza plantillas referenciadas (Crear una referencia de plantilla
secundaria).
Copiar rutas
La opcin Copiar ruta devuelve la ruta completa de cada objeto seleccionado. Esta ruta se
genera llamando al mtodo GetPath (AFObject.GetPath) para el objeto. Puede utilizar esta
cadena de ruta para ubicar el objeto en el AF SDK llamando al mtodo FindObject
(AFobject.FindObject) del objeto. Si se seleccionan varios objetos de AF, la opcin Copiar ruta
devuelve varias rutas separadas por un salto de lnea. Para obtener ms informacin sobre los
mtodos GetPath y FindObject consulte la documentacin del AF SDK relativa a AFobject.
Ejemplos

Temas avanzados
Supongamos que las dos filas estn seleccionadas, como se muestra en la siguiente figura:
Cuando seleccione la primera fila, pulse con el botn secundario y seleccione Copiar (o pulse
CTRL+C). En el portapapeles se copiar lo siguiente:
Is Not Configuration Item Good Cooling Fan Model LJ-459
Manufacturer Model
Cuando seleccione las dos filas, haga clic con el botn secundario y seleccione Copiar (o pulse
CTRL+C). En el portapapeles se copiar lo siguiente:
Is Not Configuration Item Good Cooling Fan Model LJ-459
Manufacturer Model
Is Not Configuration Item Good Cooling Fan Motor Amps
14.281286239624 A Motor Amps
Cuando seleccione la primera celda de la primera fila, haga clic con el botn secundario y
seleccione Copiar celda. En el portapapeles se copiar Manufacturer.
Cuando seleccione la primera fila, haga clic con el botn secundario y seleccione Copiar ruta. En
el portapapeles se copiar lo siguiente:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model
Cuando seleccione ambas filas, haga clic con el botn secundario y seleccione Copiar ruta. En el
portapapeles se copiar lo siguiente:
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Model
\\ABACUS-CURRENT\NuGreen\NuGreen\Houston\Cracking Process\Equipment\F-321|Motor
Amps
Nota:
Cuando arrastre y suelte, el portapapeles incluir siempre la informacin de ruta, que es
compatible con la funcin de arrastrar y soltar en ProcessBook.
Almacenar informacin especfica de aplicaciones

ExtendedProperties es una coleccin de valores con nombre que permite a los usuarios
almacenar informacin especfica de aplicaciones. Las aplicaciones cliente de OSIsoft no suelen
mostrar esta informacin.
Haga clic en el enlace Propiedades ampliadas en alguno de los cuadros de dilogo para
configurar una o varias propiedades adicionales para un objeto. En la ventana Propiedades
ampliadas que se muestra, haga clic en el campo Nombre y seleccione Nueva propiedad
ampliada. Especifique un nombre y un valor para la propiedad.

Temas avanzados
Gestin de mdulos
En esta seccin
Ver mdulos instalados actualmente
Registro de mdulos mediante la lnea de comandos
Crear un archivo de registro XML
Crear un script de registro SQL
Registrar un mdulo mediante el script SQL generado
Ver mdulos instalados actualmente

Procedimiento
1. Seleccione Archivo > Propiedades de servidor AF. Aparecer el cuadro de dilogo
Propiedades de servidor AF.
2. Seleccione la pestaa Mdulos.
Mueva el puntero sobre un mdulo para ver si est cargado y la versin que se ha
cargado.
Pulse con el botn secundario sobre un mdulo y seleccione Propiedades para ver
detalles, como el montaje, la versin, la versin cargada, los montajes de soporte, etc.
Nota:
La versin del mdulo cargado suele coincidir con la versin del servidor de PI AF. Sin
embargo, si la versin del servidor cambia, deber reiniciar PI System Explorer para
cargar la nueva versin del mdulo en el servidor.
Registro de mdulos mediante la lnea de comandos

En este tema se explica cmo registrar diferentes implementaciones de mdulos y montajes de
soporte en la lnea de comandos utilizando las utilidades RegPlugIn yRegPlugIn64.
Las utilidades de registro de mdulos se encuentran ubicadas en las carpetas de \PIPC\AF de
sus directoriosProgram Files correspondientes:
\Program Files\PIPC\AF\RegPlugIn64.exe
\Program Files (x86)\PIPC\AF\RegPlugIn.exe
En los siguientes ejemplos, MyPISystem es el servidor de PI AF donde se va a registrar el

mdulo, MyPlugIn.dll es el nombre del montaje de mdulo y Support.dll es el nombre del
montaje de soporte del mdulo.
Mdulo solo para .NET 3.5 destinado a cualquier CPU

La forma de registro ms simple. Esta implementacin funciona con cualquier arquitectura
de sistema operativo y las dos versiones de.NET Framework. No puede utilizar funciones
nuevas especficas de la versin .NET 4 del PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll
Mdulo solo para .NET 4 destinado a cualquier CPU
Esta implementacin funciona con cualquier arquitectura de sistema operativo y .NET 4
Framework. No funciona con la versin .NET 3.5 del PI AF SDK.

Temas avanzados
RegPlugIn /PISystem:MyPISystem PlugIns\4.0\MyPlugIn.dll

Mdulo para .NET 3.5 y .NET 4 destinado a cualquier CPU
Este mdulo tiene dos implementaciones. Una est destinada a .NET 3.5 Framework y
funciona con la versin.NET 3.5 del PI AF SDK, y la otra est destinada a .NET 4 Framework
y funciona con la versin .NET 4 del PI AF SDK. Las dos implementaciones se registran con
el siguiente mandato:
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\4.0\MyPlugIn.dll
Mdulo solo para .NET 3.5 destinado a plataformas de 32 y 64 bits
Este mdulo tiene dos implementaciones para .NET 3.5 Framework. Una implementacin
est dirigida a sistemas operativos de 32 bits y la otra, a sistemas operativos de 64 bits. Con
las dos implementaciones registradas, el mdulo funciona con cualquier arquitectura de
sistema operativo y las dos versiones de .NET Framework, pero no puede utilizar las nuevas
funciones que son especficas de la versin .NET 4 del PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll
RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll
Mdulo para .NET 3.5 y .NET 4 destinado a plataformas de 32 y 64 bits
Este mdulo tiene cuatro implementaciones. Dos implementaciones son para .NET 3.5
Framework: una para plataformas de 32 bits y otra para plataformas de 64 bits. Las otras
dos implementaciones son para .NET 4: una, para plataformas de 32 bits y otra, para
plataformas de 64 bits. Con todas las implementaciones registradas, funciona con cualquier
arquitectura de sistema operativo y ambas versiones de .NET Framework.
RegPlugIn /PISystem:MyPISystem PlugIns\x86\MyPlugIn.dll PlugIns
\4.0\x86\MyPlugIn.dll
RegPlugIn64 /PISystem:MyPISystem PlugIns\x64\MyPlugIn.dll PlugIns
\4.0\x64\MyPlugIn.dll
Mdulo solo para .NET 3.5 y montaje de soporte destinados a cualquier CPU
Esta implementacin, con su montaje de soporte, funciona con cualquier arquitectura de
sistema operativo y las dos versiones de .NET Framework. No puede utilizar las nuevas
funciones especficas de la versin .NET 4 del PI AF SDK.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll
Mdulo para .NET 3.5 y .NET 4 y montaje de soporte destinados a cualquier CPU
Este mdulo tiene dos implementaciones con dos implementaciones de su montaje de
soporte. La otra est destinada a .NET 4 Framework y funciona con la versin.NET 4 del PI
AF SDK. La otra est destinada a .NET 4 Framework y funciona con la versin.NET 4 del PI
AF SDK. Ambas implementaciones junto con sus montajes de soporte se registran con el
siguiente mandato.
RegPlugIn /PISystem:MyPISystem PlugIns\MyPlugIn.dll PlugIns\Support.dll PlugIns
\4.0\MyPlugIn.dll PlugIns\4.0\Support.dll
Parmetros RegPlugIn
Parmetro Descripcin
/PISystem:<string> (forma corta/P) Especifica el PISystem (servidor de PI AF) para
procesar. Si no se especifica, se utilizar el
PISystem (servidor de PI AF) predeterminado.
/OutputFile:<string> (forma corta/O) Especifica un archivo de salida. Si se especifica, se
generar un script SQL para crear mdulos. Utilice
el parmetro AppendFile para aadir un archivo
existente.

Temas avanzados
Parmetro Descripcin
/AppendFile[-] (forma corta/A) Se utiliza en combinacin con el parmetro
OutputFile para especificar si se aadir un
archivo de salida existente.
/List (forma corta/L) Enumera los montajes registrados en el PISystem
(servidor de PI AF) especificado.
/Recursive[-] (forma corta/R) Procesa subdirectorios. Procesa de forma
automtica montajes de soporte en subdirectorios
en funcin de los nombres de directorio y de
montaje. Utilice el parmetro RootDirectory
para especificar un directorio raz que no coincida
con el directorio de trabajo actual.
/Force[-] (forma corta/F) Fuerza el registro de montajes que son anteriores a
los montajes actuales registrados o fuerza la
anulacin del registro de montajes que no parecen
estar registrados.
/Silent[-] (forma corta/S) Modo silencioso. Impide que se muestren los
mensajes.
/Unregister (forma corta/U) Elimina el montaje y los mdulos del PISystem
(servidor de PI AF) especificado.
/RegFile:<string> (forma corta/RF) Crea un archivo XML de registro para el montaje
especificado que se puede utilizar para registrar
un montaje de mdulo y todos sus montajes de
soporte necesarios. Todos los archivos adicionales
que se especifiquen se considerarn como
montajes de soporte.
/Version (forma corta/V) Muestra informacin sobre la versin. Los dems
parmetros se omiten.
/User:<string> (forma corta/user) Utilice esta opcin para especificar una cuenta de
usuario de Windows diferente para conectarse al
PISystem (servidor de PI AF).
/Password:<string> (forma corta/PW) Se utiliza en combinacin con el parmetro User
para especificar la contrasea de una cuenta de
usuario de Windows diferente para conectarse al
PISystem (servidor de PI AF).
/Owner:<string> (forma corta/Own) Nombre de archivo propietario de todos los
montajes de soporte especificados. Se utiliza, por
lo general, con el parmetro Directory cuando se
registran montajes de soporte. De forma
predeterminada, el nombre del directorio se
determinar en relacin con el parmetro
RootDirectory o el directorio de trabajo actual si
no se especifica el directorio raz.
/Directory:<string> (forma corta/Dir) Nombre de directorio para todos los montajes de
soporte especificados. Se utiliza, por lo general, con
el parmetro Owner cuando se registran montajes
de soporte. De forma predeterminada, el nombre
del directorio se determinar en relacin con el
parmetro RootDirectory o el directorio de
trabajo actual si no se especifica el directorio raz.

Temas avanzados
Parmetro Descripcin
/RootDirectory:<string> (forma corta/ Todos los montajes se registrarn en relacin con
RootDir) el nombre de directorio raz especificado. Por lo
general, se utiliza con el parmetro Recursive
cuando se registran montajes en lugar de utilizar el
parmetroDirectory. Este parmetro se
establecer, de forma predeterminada, en el
directorio de trabajo actual.
/Exclude:<string> (forma corta/E) Especifica archivos de entrada o directorios para
excluir al buscar archivos en un directorio. Este
parmetro se puede especificar varias veces, pero
los valores deben ser nicos.
<Files> Archivos de montaje de entrada, archivos de
registro o directorios para procesar. Se permiten
los siguientes especificadores de carcter comodn
para filtrar archivos procesados en directorios: '*'
representa cero o ms caracteres, '?' representa
exactamente un carcter. El parmetro Exclude
tambin se puede utilizar para filtrar los archivos
procesados.
@<file> Utilice el archivo especificado para proporcionar
parmetros de entrada adicionales. El archivo de
respuesta contiene un nico parmetro por lnea.
Las lneas de comentario empiezan por el carcter
'#'.
/?,/help Muestra estas descripciones de opcin.
Crear un archivo de registro XML

En el caso de registros complejos o ejecutados con frecuencia, puede crear un archivo XML que
incluya todos los ajustes necesarios.
Procedimiento
Para crear el archivo XML, invoque la utilidad RegPlugin, especificando los ajustes
obligatorios y el nombre de archivo con el parmetro /RegFile: (/RF:).
Ejemplo
Para crear un archivo XML que registre una versin de .NET 3.5 y.NET 4.0 de MyPlugIn.dll,
ejecute el siguiente comando:
RegPlugIn /RF: PlugIns\MyPlugIn.dll PlugIns\4.0\MyPlugIn.dll
Podr editar el archivo de registro resultante para proporcionar toda la informacin adicional
necesaria para registrar el mdulo (que normalmente no se necesita). Con los mdulos de 64
bits, tendr que editar el archivo de registro para configurar LoadProperties como x64 y
asegrese de que Directory se haya configurado como x64:
<SupportAssembly>
<FilePath>x64\AFDRTest32Bit64Bit.dll</FilePath>
<ID>1e00000c-3228-366a-3809-737433324269</ID>
<Name>AFDRTest32Bit64Bit</Name>
<Description>AFDRTest32Bit64Bit.dll Support Assembly</Description>
<Directory>x64</Directory>
<LoadProperties>x64</LoadProperties>
</SupportAssembly>
Para registrar las dos implementaciones con el archivo de registro, ejecute el siguiente
comando:

Temas avanzados
RegPlugIn /PISystem:MyPISystem MyPlugIn.xml
Crear un script de registro SQL

Procedimiento
Para crear un script de registro SQL, invoque a la utilidad RegPlugIn, especificando los
detalles necesarios y el parmetro /OutputFile o /AppendFile. El script resultante se
puede cargar en la base de datos SQL mediante SQL Server Management Studio o ejecutarse
desde una lnea de comandos con la utilidad sqlcmd, que permite instalar mdulos en
mquinas donde no se encuentra instalado el PI AF SDK.
Nota:
Para los desarrolladores de mdulos: El script SQL debe generarse cada vez que
compile una nueva versin del mdulo.
Ejemplo
Por ejemplo, para crear un script que registre un Mdulo solo para .NET 3.5 destinado a
cualquier CPU, emita el siguiente mandato:
RegPlugIn /O:MyPlugIn.sql PlugIns\MyPlugIn.dll
Para crear un script de registro de SQL denominado MyPlugIn.sql que registre dos
implementaciones de MyPlugIn, un mdulo solo para .NET 3.5 destinado a plataformas de 32 y
64 bits, emita los siguientes comandos:
RegPlugIn /O:MyPlugIn.sql PlugIns\x86\MyPlugIn.dll
RegPlugIn64 /A:MyPlugIn.sql PlugIns\x64\MyPlugIn.dll
Para generar un script de registro SQL a partir de un archivo de registro XML previamente
creado, especifique el nombre del archivo XML en la lnea de comandos. Por ejemplo:
RegPlugIn /O:MyPlugIn.sql MyPlugIn.xml
Registrar un mdulo mediante el script SQL generado

Procedimiento
1. Inicie Microsoft SQL Server Management Studio.
2. Seleccione Archivo > Abrir > Archivo
3. Navegue hasta el script y crguelo.
4. Ejecute el script.
5. Para ejecutar el script desde la lnea de comandos, invoque la utilidad sqlcmd,
especificando la opcin -iinputfile con la ruta y el nombre del script SQL como inputfile y
los ajustes de conexin necesarios para conectarse al servidor de bases de datos.

De forma predeterminada, puede ejecutar mdulos de PI AF de cualquier proveedor. Para
tener ms seguridad, puede configurar PI AF para que solo se puedan ejecutar los mdulos de
proveedores de confianza (servidor de PI AF 2.5 y posterior). Se recomienda a los proveedores
que firmen el cdigo de sus mdulos con la tecnologa Authenticode. Para controlar cmo se
aplicar la seguridad de los mdulos, puede configurar el verify level.
Para mostrar una lista de los proveedores de confianza, especifique el parmetro afdiag/
TrustedProviderList. Para obtener ms detalles, consulte Parmetros AFDiag. Para aadir

Temas avanzados
un proveedor, especifique el parmetro /TrustedProviderAdd:<providername>. Para

eliminar un proveedor, especifique el parmetro /
TrustedProviderRemove:<providername>.
1. Pulse con el botn secundario sobre el archivo dll del mdulo y seleccione Propiedades. Se
mostrar la ventana Propiedades.
2. Haga clic en la pestaa Firmas digitales. (Si el mdulo no est firmado, no aparecer esta
pestaa.)
3. Haga clic en el botn Detalles. Aparecer la ventana Firmas digitales.
4. Haga clic en Ver certificado. Se mostrar la ventana Certificado.
5. En la pestaa Detalles, desplcese al campo Asunto. En este campo se muestra el nombre
del proveedor de confianza, que debe utilizar como parmetro <providername> de los
parmetros /TrustedProviderAdd y /TrustedProviderRemove.
Para mostrar el nivel de verificacin utilizado al cargar los mdulos de ejecucin, emita el
mandato afdiag y omita cualquier parmetro. El nivel de verificacin se incluir en la seccin
Opciones de configuracin de la salida resultante.
Para establecer el nivel de verificacin, ejecute el comando afdiag, especificando el
parmetro /PlugInVerifyLevel. Los niveles vlidos son:
None: Desactiva la validacin; ejecuta todos los mdulos.

AllowUnsigned: Ejecuta los mdulos sin firmar y los mdulos con firmas vlidas.
RequireSigned: Ejecuta solo los mdulos con firmas vlidas.
RequireSignedTrustedProvider: Ejecuta solo los mdulos con una firma vlida de un
proveedor de confianza.
Modelado de un proceso
En esta seccin
mbito del modelo
Pautas para configurar un modelo
Ver y editar modelos
Crear modelos
Puertos y conexiones
Capas
mbito del modelo

Aunque el nmero o variedad de elementos que comprende un modelo no cambia la forma en
que se almacena, s ayudan a la hora de planificar el diseo de modelo inicial y la informacin
necesaria para elaborar un modelo de anlisis que proporcione resultados significativos. Al
considerar el mbito de un modelo, recuerde que es necesario que sea lo suficientemente
pequeo para que las relaciones entre las propiedades estn bien definidas, pero lo
suficientemente grande para incluir algunos datos redundantes. Los datos redundantes se
pueden calcular a partir de otros datos del modelo.
Segn los distintos niveles de escala, o de mbito del modelo, los consumidores de la
informacin que proporcionan cambiarn. Por ejemplo, un ingeniero que supervise el
rendimiento del equipo de una seccin de la instalacin puede necesitar informacin ms

Temas avanzados
detallada que un individuo de planificacin de recursos encargado de realizar un seguimiento

de los materiales de una instalacin. El planificador necesita mediciones del modelo distintas a
las del ingeniero. Los elementos comunes a ambos modelos utilizan los mismos elementos de
recurso; esto ayuda a elaborar diferentes modelos utilizando la misma biblioteca de elementos.
A continuacin, se muestran tres niveles de creacin de modelos, en orden de menor a mayor
alcance:
Modelo de unidad
Este nivel de elaboracin de modelos incluye hasta los detalles ms mnimos dentro de
una unidad de proceso o rea. Este mbito resulta til para supervisar el rendimiento del
equipo y lo utilizan fundamentalmente los ingenieros de ese equipo. Es posible que los
circuitos auxiliares y sistemas de calefaccin que existen en este nivel de modelo no
tengan ninguna influencia fuera de esta rea y, por lo tanto, no estaran incluidos en la
siguiente escala.
Para realizar un anlisis significativo en un modelo de unidad, es necesario que existan
datos detallados sobre los materiales y cantidades dentro de la unidad. Si solo existe
informacin sobre el parmetro de la unidad (entradas y salidas), indica que el modelo
de datos se encuentra en su nivel de detalle s alto.
Modelo de varias unidades
Al considerar los modelos de tipo unidad-a-unidad, tenga en cuenta que los detalles
dentro de la unidad se resumen, por lo general, por las conexiones a y desde esa unidad.
Los materiales aadidos y enviados a las reas de almacenamiento (tanques, depsitos,
etc.) tambin se incluyen.
En los modelos de varias unidades, las mediciones dentro de la unidad que no afecten a
las cantidades de entrada y salida principales no se incluyen en el modelo.
Modelo de frontera (Instalacin y Unidad de negocio)
Resulta til para elaborar un anlisis de los materiales que entran y salen de la "frontera"
de la instalacin y resume an ms la informacin de unidad-a-unidad y la refiere solo a
las transacciones a y desde el proceso de los puntos de transferencia de materiales
(muelles de carga, bsculas, alimentadores de tanques o tuberas). Este nivel tambin
resulta til para analizar las transacciones entre unidades de negocio dentro de una
instalacin.
Pautas para configurar un modelo

Tenga en cuenta las siguientes reglas cuando configure un modelo de anlisis:
Utilice un procedimiento sistemtico para identificar la ubicacin y configuracin de

calibracin para cada instrumento dentro del modelo.
Asocie todos los instrumentos con el flujo correcto y asegrese de que la temperatura y
correcciones de gravedad especficas se aplican a las mediciones de flujo, si es necesario.
Compruebe si esta funcin de correccin se realizar mediante el sistema de control o
historiales.
Valide las propiedades de inverntario/tanque elaborando un modelo de un solo tanque, que
incluya envos y recepciones. Introduzca la lista de materiales con sus propiedades al mismo
tiempo.
Determine la tolerancia de calibracin de cada instrumento (puede utilizar la norma ISO
5167 con los medidores de orificios) o remtase a las fichas tcnicas de los medidores o a los
fabricantes.

Temas avanzados
Elabore y examine varios modelos de unidad antes de intentar conectarlos y ejecutar un

anlisis de varias unidades.
Una vez conectadas todas las unidades, examine el dibujo entero y ejecute un anlisis de
equilibrio para identificar los flujos y conexiones que no se pueden resolver.
Ver y editar modelos

Procedimiento
1. Pulse con el botn secundario sobre un modelo en el navegador.
2. Seleccione Conexiones de modelo en el men que aparece. Se mostrar el cuadro de dilogo
Conexiones. Muestra una representacin visual de los elementos del modelo y cmo estn
conectados.
3. Para editar el modelo:
Pulse con el botn secundario sobre el panel Conexiones para crear una conexin o para
ver o editar las propiedades del elemento.
Haga clic en un elemento para centrarlo en el panel Conexiones y mostrar cualquier otro
elemento conectado. Puede moverse por el flujo del modelo elemento por elemento.
Haga clic en una conexin para verla o editarla o aadir otro origen o destino.
Pulse con el botn secundario sobre una conexin para crear otra, ver las propiedades de
la conexin seleccionada o copiar y pegar las propiedades de la conexin.
Crear modelos
Procedimiento
1. En el panel del navegador, haga clic en el botn Elementos. La coleccin de elementos
aparecer en el navegador.
2. Pulse con el botn secundario en el campo y seleccione Nuevo modelo en el men que
aparece. Aparecer la ventana Seleccionar plantilla de modelo.
3. Seleccione una plantilla para basar en ella el modelo o elija la opcin Ninguno.
4. Haga clic en Aceptar. Las pestaas de configuracin del modelo aparecern en el visor.
5. Haga clic en la pestaa General. Configure el modelo:
En el campo Nombre, introduzca un nombre para el modelo.
En el campo Descripcin, introduzca una descripcin para el modelo. La descripcin es
opcional.
En los campos de solo lectura Plantilla y Tipo, se mostrar la plantilla y el tipo de
elemento seleccionados al crear el modelo. Para examinar las propiedades de la plantilla,
haga clic en . Los tipos de elemento se describen en Tipos de elementos de los
modelos.
Puede organizar los objetos agrupndolos en categoras. Para examinar las categoras
disponibles, haga clic en . Es opcional.
Para asignar un atributo predeterminado, haga clic en junto al campo Atributo
predeterminado y mostrar una lista de los atributos disponibles. A continuacin,
seleccione un atributo. Tenga en cuenta que para que aparezcan en la lista, deber aadir
primero los atributos en la pestaa Atributos. Este campo es de solo lectura si el modelo
se basa en una plantilla. El campo muestra el atributo especificado en la plantilla.

Temas avanzados
Haga clic en junto al campo Patrn de nombres para seleccionar parmetros de

sustitucin que definan un patrn de nombres para los elementos creados con esta
plantilla (opcional).
Haga clic en Propiedades ampliadas para configurar una o varias propiedades
adicionales para el modelo. En la ventana Propiedades ampliadas que se muestra, pulse
con el botn secundario sobre el campo Nombre y seleccione Nueva propiedad ampliada.
Especifique un nombre y un valor para la propiedad.
En esta seccin
Submodelos
Tipos de elementos de los modelos
Submodelos
Un modelo es tambin un elemento, es decir, un modelo se puede componer de otros modelos
denominados submodelos. Esto permite desarrollar un modelo de planta con un enfoque
descendente o ascendente. Los elementos de lmites de un modelo definen por lo general los
elementos con puertos que pueden utilizarse con conexiones fuera del modelo.
Tipos de elementos de los modelos

Se utilizan seis tipos de elemento principales para aplicar las reglas de conectividad entre los
elementos de un modelo.
Utilice Nodo para representar una entidad fsica del modelo, como un tanque, una vlvula o
una unidad de proceso.
Utilice Medicin para indicar que el elemento se utiliza para establecer dimensiones,
cantidades, capacidades, etc.
Utilice Flujo para indicar que el elemento transporta material de un elemento a otro.
Utilice Transferencia como un flujo temporal. La existencia de una transferencia solo est
disponible en un contexto temporal; por ejemplo, en un caso. Tambin se puede acceder a
las transferencias realizando bsquedas basadas en el tiempo de la base de datos.
Utilice Lmite para definir los puertos de entrada y salida del modelo.
Utilice Otros para representar una coleccion lgica de atributos, como una frmula.
Adems de estos seis tipos de elemento bsicos, se admiten dos tipos ms: Cualquiera y
Ninguno. Utilice los tipos de elemento Cualquiera y Ninguno cuando defina las reglas de
conectividad de un puerto.
Puertos y conexiones
Los elementos de un modelo se conectan a travs de puertos, que se definen mediante la
plantilla de elementos. Un puerto se puede definir como un puerto de entrada, un puerto de
salida o un puerto no direccionado. El puerto define el nmero de conexiones que se pueden
establecer y los tipos de elementos que se pueden conectar.
En los anlisis, los puertos direccionados (de entrada y de salida) representan el flujo de
material positivo y los utilizan las conexiones. Los puertos no direccionados los utilizan los
anexos de los medidores y los analizadores. El tipo de anexo ms frecuente de un modelo es
una medicin o un medidor anexados a un elemento del flujo.

Temas avanzados
Una conexin representa el enlace entre los puertos de dos elementos. Los puertos, que se
definen mediante la plantilla de elementos, se pueden definir como puertos de entrada, puertos
de salida o puertos no direccionados.
En esta seccin
Crear puertos
Crear conexiones
Crear puertos
Procedimiento
1. Seleccione el elemento en el navegador y haga clic en la pestaa Puertos del visor.
Nota:
Si el elemento se basa en una plantilla, no podr aadir un puerto salvo que la plantilla
admita extensiones.
2. Haga clic en Nuevo puerto y cree un puerto para el elemento. Pulse con el botn secundario
sobre un puerto existente para ver o editar sus propiedades.
3. Configure el puerto.
Tipo de puerto: Seleccione el tipo de puerto: Entrada, Salida o No dirigido (para los
medidores, por ejemplo).
Categoras permitidas: Seleccione las categoras a las que puede pertenecer el puerto.
Conexiones mximas: Especifique el nmero mximo de conexiones que se pueden
establecer para el puerto. Introduzca cero para un nmero ilimitado de conexiones.
Tipo de conexin: Seleccione el tipo de elemento al que se puede conectar el puerto; por
ejemplo, Nodo, Lmite, Medicin, etc.
Plantillas permitidas: Seleccione los elementos que pueden conectarse al puerto.
Seleccione solo elementos que se hayan creado a partir de la plantilla seleccionada.
Nota:
Para especificar este puerto como predeterminado, debe abrir la ventana Propiedades.
Crear conexiones
La pestaa Conexiones muestra las conexiones del modelo.
Procedimiento
1. Para crear un modelo en el navegador, pulse con el botn secundario en la coleccin de
elementos, como se describe en Crear modelos, y seleccione Nuevo modelo.
2. Lleve a cabo estos pasos para rellenar la pestaa Conexiones.
a. Pulse con el botn secundario sobre el campo y seleccione Nueva conexin. Se mostrar
la ventana Crear conexin.
b. Pulse con el botn secundario sobre una conexin existente para ver o editar sus
propiedades.

Temas avanzados
c. En el campo Origen, seleccione el origen de la conexin. Seleccione el puerto para el

origen en el campo Puerto correspondiente.
d. En el campo Destino, seleccione el destino de la conexin. Seleccione el puerto para el
destino en el campo Puerto correspondiente.
Para incluir elementos secundarios, marque la casilla Incluir elementos hijos.
Capas
Puede organizar los elementos de un modelo en capas. Las capas proporcionan un mecanismo
para incluir o excluir partes del modelo, segn se necesite para realizar el nalisis. Los
elementos de un modelo puede pertenecer a varias capas. Tambin puede utilizar la funcin
Capas con un herramienta grfica de elaboracin de modelos, como ProcessBook, para
proporcionar una funcionalidad de superposicin visual.
Crear capas
Procedimiento
1. En el navegador, pulse con el botn secundario sobre el modelo al que desea aadir la capa
y seleccione Nuevo modelo en el men que aparece.
2. Haga clic en la pestaa Capas del visor
3. Pulse con el botn secundario sobre cualquier lugar del campo y seleccione Nueva capa en
el men que aparece.
Se mostrar el cuadro de dilogo Propiedades de capa.
4. Asigne un nombre a la capa y, si lo desea, escriba una descripcin breve.

Trminos de PI AF
En esta seccin
Atributos
Plantillas base
Referencias de datos
Plantilla de elementos
Elementos
Marco de evento
Propiedades ampliadas
Datos externos
Fuente de datos externos
Tabla externa
Conexin suplantada
Tabla importada
Atributos indexados
Tabla externa
Tabla vinculada
Modelos
Conexin no suplantada
Servidor de PI AF
Base de datos SQL de PI AF
Tabla
PI Asset Framework (PI AF)
Referencia de datos de matriz de PI point
Referencia de datos de PI point
Fecha de consulta
Parmetros de sustitucin
Plantillas
Referencia de datos de bsqueda de tabla
Unidades de medida (UOM)

Trminos de PI AF
Atributos
Para asociar datos con un elemento, configure atributos de elemento. Cada elemento de PI AF
puede tener uno o varios atributos. Los atributos pueden incluir valores simples, que
representan informacin fija, como el dimetro de un tanque, por ejemplo. Un atributo puede
utilizar una referencia de datos para hacer referencia a un PI point, una matriz de PI point, una
frmula, un valor de una tabla externa (que no es de PI) o un valor procedente de una tabla
interna (una tabla definida en PI AF).
Las plantillas de atributos estn 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 configuracin 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 configuradas en la plantilla de atributos.
Plantillas base
Al crear una plantilla, puede especificar una existente como la plantilla base. La nueva plantilla
incluir automticamente todos los atributos y puertos que tenga la plantilla base. Podr
aadir ms atributos y puertos a la plantilla nueva, pero no podr eliminar ninguno de los
atributos heredados de la plantilla base. Utilice plantillas base cuando un objeto tenga un
subconjunto de atributos y puertos de otro.
Los atributos de configuracin representan las propiedades inherentes de un activo. Cualquier
atributo con un valor constante puede ser un elemento de configuracin. Dado que el valor de
atributo de un elemento de configuracin se presupone constante, PI System Explorer extrae
de forma automtica el atributo cuando se modifica el valor de atributo. Para confirmar el
cambio, tendr que insertarlo. En PI System Explorer, los atributos de configuracin estn
marcados con un icono de lapicero ( ).
Los atributos con valores que cambian, como las referencias de datos de PI points, no deben
eliegirse como atributos de configuracin. Cuando se modifica el valor de un atributo que no es
de configuracin, PI System Explorer no extrae el atributo. Por ejemplo, supongamos que tiene
un elemento que representa un tanque. El elemento tendr los siguientes atributos:
fabricante
foto (archivo)
nmero de serie
rango de temperatura mximo
volumen mximo
temperatura (referencia de datos de PI point)
volumen (referencia de datos de PI point)
Los primeros cinco atributos podran ser, por lo general, elementos de configuracin, puesto
que estos valores no cambian a menos que se cambie el equipo. Los dos ltimos atributos no
seran elementos de configuracin, porque los valores cambian con el tiempo.

Trminos de PI AF
Referencias de datos
Una referencia de datos es un mecanismo que le permite obtener un valor de atributo de los
datos externos. PI AF proporciona referencias de datos de PI points, operaciones de bsqueda
de tablas de bases de datos y clculos basados en frmulas.
Configure una referencia de datos directamente en un atributo de elemento de PI AF. Los
atributos con referencias de datos se denominan con frecuencia atributos de referencias de
datos. Por ejemplo, para obtener los valores de un PI point, configure una referencia de datos de
PI point.
El atributo predeterminado es un atributo que utilizan las aplicaciones cliente para representar
el elemento cuando no se ha especificado ningn atributo. El atributo debe estar en el nivel
superior de la jerarqua de atributos del elemento. No se puede anidar en otro atributo.
Seleccione el atributo que parezca el ms representativo del elemento. Por ejemplo, si un
usuario quisiera hacer referencia a un tanque, el mejor atributo individual para utilizar sera
nivel. En el caso de un medidor elctrico, los voltios de corriente.
Nota:
Algunas aplicaciones pueden utilizar el atributo predeterminado, pero muchas de ellas,

no.
Plantilla de elementos
Una plantilla de elementos es fundamentalmente un modelo de un tipo de activo. Las plantillas
de elementos hacen que crear pantallas, notificaciones, clculos y anlisis resulte mucho ms
fcil, porque los equipos con el mismo tipo pueden compartir la implementacin. Por lo
general, cree una plantilla de elementos que represente un tipo de equipo, como un tanque o
una bomba. Podr crear de forma sencilla elementos a partir de la plantilla porque la mayor
parte de la configuracin del elemento estar definida en la plantilla.
Elementos
Los Elementos son los componentes bsicos de PI AF. Los elementos pueden representar:
Objetos fsicos, como bombas o tanques. Los objetos fsicos son, por lo general, equipos.
Para asociar datos con un elemento, cree atributos en el elemento.
Objetos de bloque de creacin para organizar los datos. Cuando tenga muchos elementos
que representen objetos fsicos, tendr que configurar una estructura de rbol lgica para
organizarlos.
Por ejemplo, en la siguiente ilustracin el elemento Equipment List (Lista de equipos) y los
elementos Pumps (Bombas), Tanks (Tanques), Flow Meters (Medidores de flujo), Heat
Exchangers (Intercambiadores de calor) y Reactors (Reactores) son todos ellos elementos
estructurales. Pueden tener datos asociados o no, pero su finalidad principal es encontrar
elementos de equipo con ms facilidad y ofrecer una imagen general de la disponibilidad de los
activos.
Del mismo modo, los elementos SL Tank 001, SL Tank 002, y SL Tank 003 representan equipos
concretos.

Trminos de PI AF
Marco de evento
Un marco de evento es una funcin de PI System que permite capturar, realizar un
seguimiento, comparar o analizar procesos o eventos empresariales importantes y sus datos
relacionados durante perodos de tiempo repetidos. Los marcos de evento representan
repeticiones del proceso que los usuarios desean conocer; por ejemplo, perodos de inactividad
de los activos, desviaciones del proceso, inicio y cierre de los equipos, desviaciones
medioambientales, batches de seguimiento de productos, ejecuciones de productos, calidad del
papel o cambios de operador. Al igual que los elementos permiten recopilar y almacenar datos
sobre activos, los marcos de evento permiten recopilar y almacenar datos sobre eventos.
Propiedades ampliadas
Las propiedades ampliadas son propiedades que otras aplicaciones definen en objetos de PI
AF. Por ejemplo, PI WebParts almacena Icono y URL en las propiedades ampliadas de los
elementos de PI AF. Las aplicaciones acceden, por lo general, a la informacin almacenada en
Propiedades ampliadas mediante programacin con el PI AF SDK. En general, los usuarios de PI
System Explorer no necesitan utilizar esta caracterstica avanzada.
Datos externos
En PI Asset Framework, los datos externos son datos conservados en una base de datos o en un
archivo fuera de PI AF. Por ejemplo, los datos externos pueden ser una tabla de una base de
datos SQL o una tabla definida en una hoja de clculo de Excel. PI AF puede acceder a estos
datos externos a travs de una tabla de PI AF configurada especialmente.
Fuente de datos externos

Una base de datos o una aplicacin que contiene datos externos vinculados a una tabla de PI
AF.
Tabla externa
Una tabla externa (tambin denominada tabla vinculada) es una tabla de PI AF vinculada a una
tabla de una base de datos relacional que no es de PI o a una hoja de clculo. Los datos de la
tabla no se almacenan en la base de datos de PI AF. Las tablas externas no se pueden editar
desde PI AF. PI AF accede a los datos de tabla a travs de una referencia de datos de bsqueda
de tabla.

Trminos de PI AF
Conexin suplantada
Un tipo de conexin entre una tabla vinculada y una fuente de datos externos. Este tipo de
conexin utiliza la identidad Windows del cliente solicitante para conectarse a la fuente de
datos externos.
Tabla importada
Una tabla importada es una tabla de PI AF que se ha creado importando una tabla de una base
de datos relacional que no es de PI o de una hoja de clculo. Una vez importada, los datos de la
tabla se almacenarn en la base de datos de PI AF y dejarn de estar vinculados a la tabla de
origen que no es de PI. Las tablas importadas son tablas de lectura/escritura. Tienen un
tamao limitado, pero son ms seguras que las tablas vinculadas. PI AF accede a los datos de
tabla a travs de una referencia de datos de bsqueda de tabla.
Atributos indexados
Los atributos indexados son atributos optimizados para proporcionar resultados de bsqueda
y obtencin de valores con ms rapidez. Solo puede indexar atributos cuyos valores estn
almacenados en una base de datos de PI AF. Esto significa que no puede indexar atributos que
obtengan sus valores de referencias de datos de PI points o de referencias de tablas vinculadas.
Cuando se indexa un atributo, tanto el atributo como el valor de atributo se devuelven con ms
rapidez en las bsquedas. Sin embargo, los atributos indexados aumentan el tamao 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 .
Por lo general, indexe los atributos que considere que es probable que los usuarios utilicen con
frecuencia en las bsquedas. Por ejemplo, si desea localizar activos buscando por su nmero de
serie, debera indexar el atributo de nmero de serie.
Tabla externa
Una tabla interna es una tabla cuyo mantenimiento se realiza exclusivamente en PI AF. Las
tablas internas son tablas importadas (vase Tabla importada) o tablas que se definen y se
mantienen por completo en PI AF. Por el contrario, las tablas vinculadas son tablas externas,
porque los datos de la tabla residen fuera de PI AF. PI AF accede a los datos de tabla a travs de
una referencia de datos de bsqueda de tabla.
Tabla vinculada
Una tabla vinculada es una tabla de PI AF vinculada a una tabla de una base de datos relacional
que no es de PI o a una hoja de clculo. Los datos de la tabla no se almacenan en la base de
datos de PI AF. Las tablas externas no se pueden editar desde PI AF. PI AF accede a los datos de
tabla a travs de una referencia de datos de bsqueda de tabla. Las tablas vinculadas tambin
se denominan tablas externas (vase Tabla externa) porque los datos se almacenan fuera de PI
AF.

Trminos de PI AF
Modelos
Un modelo consta de elementos conectados que representan un modelo lgico de un proceso.
Un modelo es en s mismo un elemento, pero con dos propiedades de elemento adicionales:
capas y conexiones. Los elementos del modelo pueden representar entidades fsicas del
proceso, como tanques, tuberas y unidades de proceso, o entidades lgicas, como frmulas y
datos de resumen. El modelo se compone de elementos conectados.
Los modelos pueden ser simples, es decir, que contienen un nmero reducido de elementos, o
complejos, es decir, que contienen miles de elementos y mediciones. El tamao del modelo solo
est limitado por los datos disponibles para responder a las necesidades de informacin de un
anlisis del modelo.
Conexin no suplantada
Un tipo de conexin entre una tabla vinculada y una fuente de datos externos. Este tipo de
conexin no utiliza la identidad del cliente solicitante para conectarse a la fuente de datos
externos.
PI AF almacena objetos de Asset Framework (elementos, plantillas, etc.) en bases de datos de
PI AF. Aunque puede tener varias bases de datos de PI AF en PI AF, solo podr conectarse a una
de ellas al mismo tiempo. Por lo general, trabaje con bases de datos de PI AF en PI System
Explorer o en PI Builder. Al iniciar PI System Explorer, se conecta a la base de datos de PI AF
predeterminada. Si no se ha definido ninguna base de datos, PI System Explorer le solicitar
que cree una.
Nota:
Los clientes de PI AF utilizan la base de datos de configuracin para interactuar con PI AF.
No utilice esta base de datos con sus propios datos de aplicacin.
La biblioteca guardada de PI AF ofrece una coleccin de objetos de aplicacin o de dominio
especfico que se puede importar a una base de datos de PI AF. Las bibliotecas guardadas
incluyen, por lo general, categoras, plantillas de elementos, conjuntos de enumeracin, tipos
de referencia, tablas y la base de datos de unidades de medida. No obstante, al guardar una
biblioteca tendr la opcin de incluir otros objetos, como elementos y notificaciones. Aunque la
base de datos de unidades de medida no se muestra en la pestaa Biblioteca del panel del
navegador, se incluye siempre como parte de las bibliotecas guardadas.
Nota:
Las bibliotecas se almacenan como XML dentro de la base de datos SQL de AF. Esta
opcin no es igual que la de Exportar a archivo, que exporta una base de datos completa
como un archivo XML.

Trminos de PI AF
Servidor de PI AF
El servidor de PI AF consta del servicio de aplicacin de PI AF y la base de datos SQL de PI AF.
El servicio de aplicacin de PI AF se ejecuta como un servicio en el sistema en el que est
instalado.
Base de datos SQL de PI AF

PI AF utiliza Microsoft SQL Server para almacenar sus datos. La base de datos SQL de PI AF es la
base de datos de SQL Server que contiene informacin de configuracin de PI AF y todas las
bases de datos de PI AF definidas por usuario. La base de datos SQL de PI AF se denomina PIFD
en la base de datos de SQL.
Tabla
Las tablas de PI AF almacenan datos que se representan mejor en formato de tabla, como
sucede con las bases de datos relacionales. Las tablas de PI AF se han optimizado para
almacenar datos estadsticos relativos, como cdigos de producto, listas de materiales o tablas
de calibracin.
Puede crear sus propias tablas o utilizar las de PI AF para acceder a los datos procedentes de
tablas externas a PI AF, como Microsoft Access, Microsoft Excel o Microsoft SQL Server, por
ejemplo. Existen tres formas bsicas de generar tablas.
Importar una tabla externa a PI AF. Los datos se importarn en la base de datos de PI AF y
se almacenarn como una tabla de PI AF de lectura/escritura interna.
Vincular una tabla externa (no de PI). El servidor de AF lee las tablas externas cuando lo
requiere el cliente. Ningn dato de la tabla externa se duplica en la base de datos de AF.
Crear y rellenar una tabla de forma manual en PI System Explorer.
Para extraer un valor de una tabla, cree una referencia de datos de bsqueda de tablas en un
atributo.
Para extraer un valor de una tabla, cree una referencia de datos de bsqueda de tablas en un
atributo.
Nota:
Dado que las tablas de PI AF se cargan por completo en la memoria del cliente, existe un
lmite en cuanto al tamao de las tablas admitido.
PI Asset Framework (PI AF)

PI Asset Framework (PI AF) es el producto de OSIsoft que organiza y ofrece acceso a los datos
dentro del contexto de su entorno. Por ejemplo, los operadores de planta pueden ver datos
asociados con activos fsicos, como equipos, dispositivos y unidades de proceso. PI Asset
Framework consta del servidor de PI AF, PI AF Builder y PI System Explorer.
La instalacin predeterminada de PI AF incluye el servicio de aplicacin de PI AF y la base de
datos SQL de PI AF. Servidor de PI AF es el trmino que se utiliza para referirse conjuntamente
al servicio de aplicacin y la base de datos. Puede instalar estos componentes en un solo
ordenador o en varios. PI AF admite diferentes configuraciones de instalacin, como la
instalacin del servicio de aplicacin de AF y la base de datos SQL de AF en distintos

Trminos de PI AF
ordenadores, la instalacin de la base de datos de PI AF en un SQL Server duplicado o la

implementacin de funciones de alta disponibilidad con colectivos de PI AF Server.
Referencia 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 especificado se
corresponde con una entrada de la matriz. Este tipo de referencia de datos le permite incluir
los datos procedentes de diferentes PI points en un solo valor, que puede ser una funcin de
resumen, como un promedio.
Referencia de datos de PI point

Una data reference de PI point es una referencia procedente de un atributo de AF a un PI point.
El valor del atributo de la referencia de datos podra ser igual que el valor de punto o el
resultado de un clculo sobre valores de punto. Puede crear referencias de datos de PI point
para:
un atributo de elemento o una plantilla de atributos

un atributo de transferencia o una plantilla de atributos
un atributo de marco de evento o una plantilla de atributos
Las referencias de PI point para las plantillas de atributos tienen algunas caractersticas extra.
Al crear una referencia de datos de PI point en una plantilla de atributos, podr:
Crear de forma automtica tags referenciados por atributos basados en esta plantilla.
Crear un esquema de nombre para los atributos basados en esta plantilla de forma que los
atributos creados a partir de ella tengan nombres exclusivos que sigan una estructura
coherente.
Fecha de consulta
Fecha de consulta determina los valores de tiempo que PI System Explorer utiliza para
buscar y mostrar valores de atributo

identificar versiones actuales de objetos para mostrar e incluir en los resultados de
bsqueda
Para obtener una descripcin detallada de Fecha de consulta, vase Fecha de consulta y tiempo
en PI System Explorer.
Parmetros de sustitucin
Los parmetros de sustitucin son variables que se colocan en las plantillas de atributos para
las referencias de datos de PI points y de matriz de PI point. PI AF resuelve los parmetros de
sustitucin al crear las referencias de datos de un atributo basado en esa plantilla. Por ejemplo,
puede utilizar parmetros de sustitucin:
Para configurar una plantilla de referencias de datos de PI points que utilice nombres para
los tags basados en los nombres de elemento creados a partir de esa plantilla.
Para utilizar el valor de otro atributo al configurar el valor de propiedad de un PI Point.

Trminos de PI AF
Plantillas
Una plantilla de elementos define un conjunto bsico de atributos y puertos. Cuando cree
elementos basados en una plantilla, el elemento heredar la configuracin de los atributos y
puertos. Esto le permitir crear muchos elementos de forma rpida. Cree la plantilla una vez y,
despus, cree tantos elementos como necesite basndose en la plantilla. Por ejemplo, al
cambiar una plantilla de elementos, los cambios se propagarn a todos los elementos basados
en esa plantilla. Las plantillas de elementos pueden ahorrar tiempo y garantizar la coherencia
entre todos los elementos.
Puede crear plantillas para:
Elementos
Marcos de evento
Transferencias
Modelos
Notificaciones (solo si tiene licencia de PI Notifications)
Referencia de datos de bsqueda de tabla

Las referencias de datos de bsqueda de tabla ofrecen una forma sencilla de buscar datos en
una de las tablas de PI AF. Cree sentencias Select de SQL para definir la consulta. La referencia
de datos devuelve, por lo general, el valor de columna especificado en el campo Columna de
resultado que coincide con la primera fila encontrada utilizando la clusula DONDE.
Sin embargo, si el tipo de datos del atributo es un tipo de matriz, y el valor del campo Columna
de resultado no es un tipo de matriz, la referencia de datos devolver una matriz, donde cada
elemento de la matriz se corresponder con una fila que cumpla la condicin de la clusula
DONDE. Del mismo modo, si no se encuentra ninguna fila coincidente, se devolver una matriz
vaca.
Unidades de medida (UOM)

Una clase de unidad de medida se define por las dimensiones fundamentales de su medicin.
Algunos ejemplos de clases de unidades de medida son la masa, el volumen y la densidad. PI AF
ofrece un tratamiento automtico de las conversiones simples entre unidades de medida para
los atributos con la misma clase de unidad de medida.
PI AF se suministra con muchas clases de unidades de medida estndar y factores de
conversin. Puede ampliar estas clases aadiendo unidades de medida nuevas, as como
nuevas clases de medidas. La implementacin de las unidades de medida se basa en el Sistema
internacional de unidades (SI).

Trminos de PI AF

Soporte tcnico y otros recursos
Para obtener asistencia tcnica, pngase en contacto con el soporte tcnico de OSIsoft
llamando al +1 510-297-5828 o visitando la pgina Contact Us del Soporte Tcnico OSIsoft
(https://techsupport.osisoft.com/Contact-Us/). El sitio web ofrece ms opciones de contacto
para clientes fuera de los Estados Unidos.
Cuando se ponga en contacto con el soporte tcnico de OSIsoft, tenga a mano la siguiente
informacin:
Nombre del producto, versin y nmeros de versin
Detalles sobre la plataforma del equipo (tipo de CPU, sistema operativo y nmero de
versin)
Hora a la que se inici el problema
Archivos de registro en ese instante concreto
Detalles sobre cualquier cambio en el entorno antes de que se produjera el problema
Resumen del problema, incluidos los archivos de registro pertinentes durante el intervalo
de tiempo en que se produjo el problema
El sitio web de OSIsoft Virtual Campus (vCampus) (https://vcampus.osisoft.com) ofrece
recursos basados en suscripcin para ayudarle en todo lo relativo a la programacin e
integracin de productos de OSIsoft.

Soporte tcnico y otros recursos

PI System Explorer 2014 R2 User Guide ES

Caricato da

Informazioni sul documento

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

PI System Explorer 2014 R2 User Guide ES

Caricato da

Copyright:

Formati disponibili

PI System Explorer

Gua del usuario

Para PI Asset Framework 2.6.1 incluido con PI Server 2014 R2

PI System Explorer Gua del usuario

Uso de PI System Explorer..................................................................................... 3

Conexin a servidores y bases de datos................................................................. 17

Localizar y consultar informacin de activos.......................................................... 31

PI System Explorer Gua del usuario iii

Buscar atributos en marcos de evento................................................................................................. 43

Diseo e implementacin de modelos de activos de PI AF.......................................57

Asset-Based Analytics para PI Server...................................................................133

iv PI System Explorer Gua del usuario

Gestin de los anlisis de un elemento.................................................................................................. 144

PI System Explorer Gua del usuario v

vi PI System Explorer Gua del usuario

Uso de marcos de evento para capturar eventos de proceso.................................. 247

Temas avanzados.............................................................................................. 261

PI System Explorer Gua del usuario vii

Ejemplos de cmo referenciar atributos del mismo elemento .......................................................... 269

Trminos de PI AF.............................................................................................. 307

viii PI System Explorer Gua del usuario

Conexin no suplantada........................................................................................................................ 312

Soporte tcnico y otros recursos......................................................................... 317

PI System Explorer Gua del usuario ix

x PI System Explorer Gua del usuario

Compatibilidad con marcos de eventos

Anlisis basados en activos

Cmo se representan los activos en PI AF

PI System Explorer Gua del usuario 1

Herramientas para trabajar con PI AF

2 PI System Explorer Gua del usuario

Componentes de la interfaz de usuario de PI System Explorer

PI System Explorer Gua del usuario 3

Trabajo con el contenido del visor

4 PI System Explorer Gua del usuario

Control del nmero de objetos en el visor

Configuracin de las columnas mostradas

Seleccin de varios objetos para las operaciones

Mostrar valores de atributo en unidad de medida de origen

PI System Explorer Gua del usuario 5

Cambiar la unidad de medida de un valor de atributo

Copiar objetos del visor

Copiar copia una fila entera.

Una fila seleccionada, el elemento MixTruck, en el tutorial Chocolate Milk

Mostrar atributos como columnas

6 PI System Explorer Gua del usuario

En el campo de texto Otros, introduzca nombres de atributos separados por un punto y

Seleccionar atributos de una plantilla

2. Seleccione Aadir atributos desde la plantilla.

4. Seleccione un atributo en la plantilla y haga clic en para aadir el atributo a la lista de

PI System Explorer Gua del usuario 7

6. Si lo desea, cambie el orden de aparicin de los atributos en la lista.

Seleccionar atributos de un elemento

Seleccionar atributos por nombre

Ajustar configuracin de idioma

Ingresar y extraer trabajo

8 PI System Explorer Gua del usuario

Si opta por no guardar los cambios, utilice la opcin Deshacer extraccin.

PI System Explorer Gua del usuario 9

Mtodos abreviados de teclado

10 PI System Explorer Gua del usuario

Acceso directo Accin

Importacin y exportacin de bases de datos y objetos de

Importar y exportar una base de datos