PI System Explorer. Guía del usuario. Para PI Asset Framework incluido con PI Server 2014 R2

Transcripción

1 PI System Explorer Guía del usuario Para PI Asset Framework incluido con PI Server 2014 R2

2 OSIsoft, LLC 777 Davis St., Suite 250 San Leandro, CA USA Tel: (01) Fax: (01) Web: PI System Explorer Guía del usuario by OSIsoft, LLC. Reservados todos los derechos. Ninguna parte de esta publicación puede ser reproducida, almacenada en un sistema de recuperación o transmitida, de ninguna forma ni por ningún medio, mecánico, 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 demás marcas y nombres comerciales aquí utilizados son propiedad de sus respectivos propietarios. EE. UU. DERECHOS DEL GOBIERNO Su uso, réplica o difusión 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 , DFARS , FAR , FAR , según proceda. OSIsoft, LLC. Versión: Publicación: Julio de 2014

3 Contenido Introducción a PI Asset Framework...1 Cómo 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 configuración de idioma...8 Ingresar y extraer trabajo... 8 Métodos abreviados de teclado...10 Cambiar el idioma Importación y exportación de bases de datos y objetos de base de datos Importar y exportar una base de datos...11 Exportar objetos de biblioteca a otra base de datos...14 Conexión a servidores y bases de datos Gestionar preferencias de conexión para PI System Explorer Conexión a servidores de PI AF...18 Conexión a un servidor de PI AF...18 Añadir un servidor de PI AF a la lista de conexiones Cambiar miembros colectivos Cambiar a un miembro colectivo concreto...23 Conexión a PI Servers Conexión a un PI Server Añadir un PI Server a la lista de conexiones Ver el estado de búfer de un PI Server Conexión a bases de datos de PI AF 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...28 Acerca de la eliminación de bases de datos Configurar permisos de seguridad para una base de datos Configurar permisos de seguridad para todas las bases de datos...29 Localizar y consultar información de activos Exploración de activos Elementos mostrados por el navegador...31 Exploración de elementos...31 Exploración de otros objetos Configurar el tamaño de la página del navegador Abrir ventanas adicionales del navegador Buscar activos y datos de activo Búsqueda rápida...34 Paginación de resultados de búsqueda Búsqueda en una fecha concreta Búsqueda de PI points Buscar elementos Búsqueda de atributos en elementos Buscar marcos de evento PI System Explorer Guía del usuario iii

4 Contenido Buscar atributos en marcos de evento Buscar una transferencia Búsqueda de atributos en transferencias Crear una tendencia en PI System Explorer Gestionar cambios de equipos y procesos Crear una versión de un elemento o un modelo Crear una versión de tabla Visualización de diferentes versiones de objeto y objetos obsoletos...48 Ver datos de series temporales...51 Estadísticas Ponderación Expresión de filtro Tipo de límite Restricciones de visualización de los datos de serie temporal Abreviaturas de configuración de atributos Diseño e implementación de modelos de activos de PI AF...57 Organización de modelos de activos Estructuración del modelo de activos Cómo tomar decisiones sobre jerarquías Crear vistas múltiples de activos...59 Uso de categorías para facilitar la localización de objetos...62 Representación de activos en PI Asset Framework Uso de elementos para modelar activos Uso de elementos para representar activos Seguridad de objetos en PI AF Configurar permisos para objetos Configurar permisos para colecciones Asociación de datos con activos Crear una plantilla de atributos...79 Trabajo con conjuntos de enumeración Definición de valores de atributos de constante Configuración de referencias de datos...84 Trabajo con unidades de medida 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 Asset-Based Analytics para PI Server Acerca de los análisis Uso de plantillas de análisis Programación de análisis Actualización de análisis y de plantillas de análisis Expresiones Análisis de expresiones Crear una plantilla de análisis de expresiones Crear una plantilla de análisis de expresiones Análisis de resumen Crear una plantilla de análisis de resumen Crear un análisis de resumen Análisis de generación de marcos de evento Crear una plantilla de análisis de generación de marcos de evento Crear análisis de generación de marcos de evento Especificar durante cuánto tiempo debe ser verdadero un activador de inicio iv PI System Explorer Guía del usuario

5 Contenido Gestión de los análisis de un elemento Reponer datos de un análisis Gestión de la seguridad de los análisis y las plantillas de análisis Análisis de ejemplo Crear un análisis de expresión Crear una plantilla de análisis de resumen Crear de forma automática marcos de evento para realizar un seguimiento de los datos Gestión de análisis en la base de datos de AF Gestión de PI Analysis Service Ver estadísticas del servicio de análisis Ver o modificar el servicio de análisis Configuración del servicio de análisis Referencia de funciones de expresión Abs Acos AND Ascii Asin Atn Atn Avg Badval Bod Bom Bonm Ceiling Char Compare Concat Convert Cos Cosh Cot Coth Csc Csch Curve Day DaySec DigState DigText E ELSE EventCount Exp FindEq FindGE FindGT FindLE FindLT FindNE Float Floor Formato Frac Hour IF PI System Explorer Guía del usuario v

6 Contenido InStr IN Int IsSet LCase Left Len Log Log Logbase LTrim Max Median Mid Min Minute Mod Month NextEvent NextVal Noon NoOutput Normalrnd NOT OR ParseTime PctGood Pi Poly Pow PrevEvent PrevVal PStDev Rand Range Remainder Right Round Roundfrac RTrim Sec Sech Second Sgn Sin Sinh Sqr StateNo SStDev StDev String TagAvg TagBad TagDesc TagEU TagExDesc TagMax vi PI System Explorer Guía del usuario

7 Contenido TagMean TagMin TagName TagNum TagSource TagSpan TagTot TagType TagVal TagZero Tan Tanh Text THEN TimeEq TimeGE TimeGT TimeLE TimeLT TimeNE Timestamp Total Trim Trunc UCase Yearday Year Weekday Funciones del vapor para expresiones de análisis Rangos de las entradas de la función de vapor Conversión de unidades de medida para funciones de vapor Estados de referencia de la propiedad del vapor Referencia de funciones del vapor Uso de marcos de evento para capturar eventos de proceso Marcos de evento Ejemplos de marcos de evento Ventajas de PI Event Frames PI Event Frames o PI Batch? Métodos de creación de marcos de evento Plantillas de marcos de evento Visualización de marcos de evento con herramientas cliente Representación de eventos en PI Asset Framework 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 Temas avanzados Cadenas de configuración de atributos Cadenas de configuración para referencias de datos de PI points Especificación de PI points Configuración de valores de atributo Cadenas de configuración para creación automática de puntos Actualizaciones masivas de cadenas de configuración Sintaxis de referencia de atributo Sintaxis de las especificaciones de ruta PI System Explorer Guía del usuario vii

8 Contenido Ejemplos de cómo referenciar atributos del mismo elemento Ejemplos de cómo referenciar atributos de distintos elementos Ejemplos de cómo referenciar atributos de un marco de evento con el elemento referenciado principal Utilidades de PI AF Iniciar PSE con opciones de línea de comandos Exportar objetos de PI AF Importar objetos de PI AF AFDiag: Utilidad de diagnóstico 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 auditoría Persistencia Limitaciones respecto a los nombres de objetos de AF Introducción de valores para tipos de valor Configurar el valor de atributo con el nombre de otro atributo Creación de tipos de referencia personalizados Nivel de fortaleza de los tipos de referencia de elemento Tipos de referencia predefinidos Crear tipos de referencia personalizados Copiar rutas Almacenar información específica de aplicaciones Gestión de módulos Ver módulos instalados actualmente Registro de módulos mediante la línea de comandos Crear un archivo de registro XML Crear un script de registro SQL Registrar un módulo mediante el script SQL generado Gestión de proveedores de módulos de confianza Modelado de un proceso Ámbito del modelo Pautas para configurar un modelo Ver y editar modelos Crear modelos Puertos y conexiones Capas Términos de PI AF Atributos Plantillas de atributos Plantillas base Atributos de configuración Referencias de datos Atributo predeterminado Plantilla de elementos Elementos Marco de evento Propiedades ampliadas Datos externos Fuente de datos externos Tabla externa Conexión suplantada Tabla importada Atributos indexados Tabla externa Tabla vinculada Modelos viii PI System Explorer Guía del usuario

9 Contenido Conexión no suplantada Bases de datos de PI AF Biblioteca guardada de PI AF 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 Parámetros de sustitución Plantillas Referencia de datos de búsqueda de tabla Unidades de medida (UOM) Soporte técnico y otros recursos PI System Explorer Guía del usuario ix

10 Contenido x PI System Explorer Guía del usuario

11 Introducción a PI Asset Framework PI Asset Framework permite representar activos y procesos como objetos de PI AF y estructurarlos para que ofrezcan valor a su empresa. PI System Explorer y PI Builder son las principales herramientas utilizadas en la creación y gestión de objetos de PI AF. Las dos funcionalidades más 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 descripción general de los marcos de evento. Análisis basados en activos Integrados en PI System Explorer, los análisis basados en activos permiten crear cálculos y configurar declaraciones condicionales relacionadas con valores de activo. Consulte Asset- Based Analytics para PI Server para obtener más información. En esta sección Cómo se representan los activos en PI AF Herramientas para trabajar con PI AF Cómo se representan los activos en PI AF PI Asset Framework (PI AF) le permite crear una representación del equipo y los procesos, proporcionándole de este modo una excelente visión general de los datos. En PI AF, el equipo y los procesos objeto de supervisión se denominan activos. La representación 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 información 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 información fija, como el diámetro de un tanque, por ejemplo. Un atributo puede hacer referencia también a un PI point, una fórmula, un valor de una base de datos relacional, un archivo, una fotografía, etc. Todos los datos pertinentes sobre un activo se vinculan al elemento que representa ese activo. Por ejemplo, supongamos que tiene una bomba con tres datos asociados: la presión (leída de un PI point), la temperatura de entrada y la temperatura de salida. Para establecer un modelo de estos datos en AF, puede crear un elemento que represente la bomba y a continuación los tres atributos que representen los datos asociados. En la siguiente ilustración, se muestra la forma en que aparecen los datos en PI AF. Aunque todos los valores son PI points, el usuario no necesita conocer en ningún momento los nombres de los PI points. Todos los datos están disponibles directamente en el elemento. PI System Explorer Guía del usuario 1

12 Introducción 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 gráfica 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 demás 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 más información sobre PI Builder, consulte la PI Builder User Guide. Además, todas las aplicaciones cliente de PI permiten a los usuarios ver elementos y atributos de PI AF. 2 PI System Explorer Guía del usuario

13 Uso de PI System Explorer PI System Explorer permite a los usuarios encontrar información sobre equipos y procesos: Encontrar los datos de un elemento concreto del equipo. Por ejemplo: Datos de PI points, resultados de cálculos, información de mantenimiento, etc. Por ejemplo, puede utilizar PI System Explorer para encontrar información 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 también de muchas funciones para modelar los equipos y procesos. En esta sección Componentes de la interfaz de usuario de PI System Explorer Ingresar y extraer trabajo Métodos abreviados de teclado Cambiar el idioma Importación y exportación de bases de datos y objetos de base de datos Componentes de la interfaz de usuario de PI System Explorer En la siguiente ilustración se muestran los principales componentes de PI System Explorer. PI System Explorer Guía del usuario 3

14 Uso de PI System Explorer 1. Barra de menús 2. Barra de herramientas 3. Navegador 4. Panel de navegación 5. Barra de estado 6. Paleta 7. Visor En esta sección Trabajo con el contenido del visor Ajustar configuración de idioma Trabajo con el contenido del visor En las siguientes secciones se explica cómo configurar la visualización de elementos en el visor y cómo trabajar con los contenidos. En esta sección Control del número de objetos en el visor Configuración de las columnas mostradas Selección 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 4 PI System Explorer Guía del usuario

15 Uso de PI System Explorer Control del número de objetos en el visor Para controlar el número de objetos que aparecen en el visor, especifique el tamaño máximo de las consultas en la ventana Opciones (haga clic en Herramientas > Opciones). Si el número de objetos supera el límite, la colección se pagina y solo se puede ordenar por nombre. En la siguiente ilustración, se muestra la primera de las dos páginas de objetos disponibles. Haga clic en 2 o Siguiente para ver la segunda página. Haga clic en para abrir la ventana Seleccionar número de página. Configuración de las columnas mostradas Algunas de las pestañas del visor muestran columnas de datos. Puede seleccionar las columnas que se mostrarán. Las columnas disponibles dependen de la pestaña del visor que se seleccione y del objeto seleccionado en el navegador. Para especificar las columnas que se mostrarán, haga clic en y seleccione las columnas que desee. Selección 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 ratón y las combinaciones de teclado estándar 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 Mayús 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 selección de algún 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 botón secundario y seleccione la operación 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 pestaña General, seleccione Utilizar unidad de medida origen para visualizar atributo. 3. Haga clic en Aplicar. 4. Haga clic en Aceptar para cerrar el diálogo. PI System Explorer Guía del usuario 5

16 Uso de PI System Explorer 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 botón derecho del ratón 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 información de esos objetos en una hoja de cálculo en un formato separado por tabulaciones. Utilice el menú contextual (seleccione y haga clic con el botón 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 botón Elementos en el panel del navegador. 2. En la parte superior del navegador, seleccione el contenedor de elementos. 6 PI System Explorer Guía del usuario

17 Uso de PI System Explorer 3. En el extremo derecho del visor, haga clic en y elija Seleccionar atributos en el menú emergente. Se abre el cuadro de diálogo Seleccionar atributos. 4. Seleccione los atributos que desea mostrar en el visor: Seleccione el botón de opción Añadir atributos desde la plantilla o Añadir atributos desde el elemento. Los atributos disponibles aparecerán en la lista de selección Atributos, en el cuadro de diálogo a la izquierda. Haga clic en para mover todos los atributos a la lista de atributos mostrados (en el lado derecho del cuadro de diálogo) o en añadir solo el atributo seleccionado. Nota: para Las plantillas comparten con frecuencia atributos que tienen el mismo nombre. Los nombres deben añadirse de uno en uno. Por ejemplo, si la lista ya contiene el atributo Volume, no podrá añadirlo 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 continuación, haga clic en el botón Añadir para añadir los atributos a la lista de atributos mostrados. 5. Si lo desea, cambie el orden de aparición de los atributos en la lista. 6. Haga clic en Aceptar para finalizar la selección de atributos. Los atributos seleccionados aparecerán como columnas en el visor. Qué hacer a continuación Si desea eliminar o incluir atributos adicionales, abra el cuadro de diálogo Seleccionar atributos y repita el proceso. En esta sección 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 Añadir atributos desde la plantilla. 3. Haga clic en para elegir una plantilla. 4. Seleccione un atributo en la plantilla y haga clic en para añadir el atributo a la lista de atributos mostrados. 5. Si desea añadir más 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 añadirse de uno en uno. Por ejemplo, si la lista ya contiene el atributo Volume, no podrá volver a añadirlo. PI System Explorer Guía del usuario 7

18 Uso de PI System Explorer 6. Si lo desea, cambie el orden de aparición de los atributos en la lista. 7. Haga clic en Aceptar para finalizar la selección de atributos. Los atributos seleccionados aparecerán 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 Añadir 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 añadir el atributo a la lista de atributos mostrados. 5. Si lo desea, cambie el orden de aparición de los atributos en la lista. 6. Haga clic en Aceptar para finalizar la selección de atributos. Los atributos seleccionados aparecerán 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 diálogo 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 Añadir para añadir los atributos a la lista de atributos mostrados. 5. Si lo desea, cambie el orden de aparición de los atributos en la lista. 6. Haga clic en Aceptar para finalizar la selección de atributos. 7. Los atributos seleccionados aparecerán como columnas en el visor. Ajustar configuración de idioma Si tiene varios paquetes de idiomas instalados, la opción Configuración de idioma se mostrará en el menú Ver. Seleccione esta opción y cambie el idioma predeterminado en la ventana de herramientas de configuración 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 verificación de color rojo. Los cambios que se han aplicado, pero no se han guardado en la base de datos, se indican con un icono de marca de verificación de color rojo oscuro. 8 PI System Explorer Guía del usuario

19 Uso de PI System Explorer Dispone de las siguientes opciones para guardar los cambios mientras trabaja: Haga clic en Archivo > Ingresar. En la barra de herramientas, pulse el botón Ingresar. En el navegador, haga clic con el botón 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 diálogo Ingresar con los objetos que se han modificado. Puede ingresarlos todos o seleccionar solo algunos y dejar el resto fuera. Pulse el botón Sesión en el cuadro de diálogo para seleccionar los objetos modificados solo en la sesión actual. Seguirá teniendo la posibilidad de ingresar los objetos modificados en otras sesiones. La tercera opción, 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 opción Deshacer extracción. PI System Explorer Guía del usuario 9

20 Uso de PI System Explorer Puede realizar cambios en un objeto y aplicarlos sin ingresarlos en la base de datos. Haga clic en Aplicar cambios, como se muestra más abajo. Métodos abreviados de teclado PI System Explorer proporciona métodos abreviados de teclado para navegar y realizar otras tareas que necesitan un ratón u otro dispositivo señalador. Acceso directo CTRL+A CTRL+C CTRL+ALT+C CTRL+V CTRL+X SUPR MAYÚS+SUPR INSERT INICIO FIN CTRL+INICIO CTRL+FIN ALT+INICIO ALT+FIN CTRL+RE PÁG CTRL+AV PÁG CTRL+ENTER ALT+ENTER BARRA ESPACIADORA o ENTER Flechas izquierda, derecha, arriba y abajo F2 Acción Selecciona todos los objetos del visor. Copia el objeto seleccionado en el portapapeles. Copia la ruta del objeto seleccionado en el portapapeles. pega el objeto en el portapapeles del visor. Corta (elimina) el objeto seleccionado y lo copia en el portapapeles. Elimina el objeto seleccionado. Igual que CTRL+X Añade un objeto nuevo al visor o al navegador. Selecciona la primera fila del visor; por ejemplo, la primera fila de una tabla de atributos. Selecciona la última fila del visor. Selecciona la primera celda de la página actual del visor. Selecciona la última celda de la página actual del visor. Selecciona la primera página de objetos del visor. Selecciona la última página de objetos del visor. Selecciona la página de objetos anterior del visor. Selecciona la página de objetos siguiente del visor. Si el visor contiene varias páginas de objetos, muestra la ventana Seleccionar número de página. En el navegador, muestra las propiedades del objeto seleccionado. Pulsa el botón seleccionado en ese momento. Navegue por los objetos del visor o del navegador. Edita el objeto seleccionado en el visor. En el caso de los objetos completos, muestra la ventana de edición del objeto. 10 PI System Explorer Guía del usuario

21 Uso de PI System Explorer Acceso directo F4 o ALT+flecha arriba o ALT+fecha abajo Acción Muestra las opciones del cuadro de lista seleccionado. En el caso de las listas con capas, muestra la jerarquía completa de las opciones. Cambiar el idioma Podrá cambiar el idioma de la aplicación instalada en su equipo si dispone de un paquete de idioma y tiene instalados los recursos del idioma deseado. La configuración de idioma se corresponde con la configuración regional del usuario. Por lo tanto, si otros usuarios desean utilizar la aplicación en el mismo equipo iniciando sesión con otra cuenta, podrán utilizar otros recursos de idioma, si están disponibles. 1. Ejecute el paquete de idioma y seleccione los recursos de idioma que desee instalar, si no están aún disponibles. 2. Haga clic en Ver > Configuración de idioma. Se mostrará el diálogo de la herramienta de configuración de idioma. 3. Seleccione el idioma de destino y haga clic en Aceptar. 4. Salga y reinicie la aplicación. La aplicación se mostrará en el idioma especificado. Tenga en cuenta que los usuarios que inicien sesión con la misma cuenta verán el mismo idioma, pero cambiará para los que inicien sesión en el equipo con otras cuentas. Importación y exportación de bases de datos y objetos de base de datos En esta sección 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 después a partir del archivo XML importándolo 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 sección Exportar una base de datos a XML Restaurar una base de datos PI System Explorer Guía del usuario 11

22 Uso de PI System Explorer Exportar una base de datos a XML Este procedimiento archiva bases de datos AF en un archivo XML que se puede restaurar posteriormente. Nota: También puede exportar objetos de PI AF desde una utilidad de línea de comandos. Véase Exportar objetos de PI AF. Procedimiento 1. Haga clic en Archivo > Exportar a archivo. Se mostrará el cuadro de diálogo Exportar a archivo. 2. Seleccione las opciones de exportación que desee (Opciones de exportación a XML). 3. Haga clic en Aceptar. PI System Explorer exportará la base de datos actual a un archivo XML. En esta sección Opciones de exportación a XML Formato de archivo de exportación y restauración Opciones de exportación a XML Casilla de verificación Incluir todos los objetos referenciados Incluir ajustes de seguridad Incluir valores predeterminados Incluir IDs únicos Resultado Esta opción origina la exportación de las referencias dependientes. Por ejemplo, si exporta un elemento, se exportarán también la plantilla de elementos, las categorías utilizadas, etc. Utilice esta opción para facilitar el movimiento de objetos entre diferentes bases de datos de PI AF. Esta opción origina la exportación de los ajustes de seguridad de objetos individuales. Aumenta el tiempo necesario para realizar la exportación y las subsiguientes operaciones de importación. Debe tener privilegios de administrador para importar objetos que tengan especificada la opción de ajustes de seguridad. Seleccione esta casilla de verificación para incluir los valores predeterminados asignados a los objetos. Sin esta opción, en la salida no se incluirán 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. Esta opción incluye el ID exclusivo de cada objeto de la exportación. Si incluye esta opción, podrá renombrar los elementos existentes durante una importación a la misma base de datos. A menos que sea necesario renombrar los elementos, resulta más eficaz dejar esta opción sin activar. 12 PI System Explorer Guía del usuario

23 Uso de PI System Explorer Casilla de verificación XML plano Solo objetos de la Biblioteca Simplificar cadenas de configuración Resultado Seleccione esta casilla de verificación para exportar objetos jerárquicos en formato plano. La exportación sin formato puede hacer que la edición en algunas herramientas resulte más sencilla. Los objetos jerárquicos que se exportarán sin formato son: atributos, plantillas de atributos, elementos y marcos de evento. Si selecciona esta casilla, se desactivarán las opciones de marcos de evento, transferencias y casos. Si selecciona esta casilla, se eliminarán el PI Server y los identificadores de tag de las cadenas de configuración para las referencias de datos de PI points. Asimismo, se resolverán los parámetros de sustitución. Nota: La selección de esta opción ralentiza el proceso de exportación porque requiere la evaluación de las cadenas de configuración guardadas. Incluir marcos de eventos, transferencias y casos Seleccione esta casilla para exportar marcos de evento, transferencias y casos. Formato de archivo de exportación y restauración El formato XML de importación/exportación se describe en el archivo de esquema ubicado en el directorio de instalación PIPC\AF,OSIsoft.AF.xsd. Muchos de los objetos AF admiten un atributo de operación en el XML que permite la eliminación. Del mismo modo, puede ejecutar la opción de configuración automática del punto de forma selectiva en los elementos utilizando la misma técnica. 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. También puede importar objetos de PI AF desde una utilidad de línea de comandos. Véase 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 PI System Explorer Guía del usuario 13

24 Uso de PI System Explorer Esta opción permite crear objetos. Si el propósito de la operación es actualizar los elementos existentes, desmarque esta opción para evitar la creación accidental de objetos. Permitir actualizar Esta opción permite actualizar los objetos existentes. Si la finalidad de la operación es simplemente añadir elementos nuevos, desmarque esta opción para evitar que se sobrescriban objetos de forma accidental. Ingreso automático Esta opción permite a la operación de importación ingresar objetos de forma automática a medida que se realiza dicha operación. De esta forma, se reducen los requisitos de máximo de memoria de la operación. Utilice esta opción cuando vaya a importar un número considerable de objetos. Crear o actualizar PI Points Esta opción actualiza los atributos con una configuración de PI Point especificada en el archivo XML si ya existen o los crea si no existen. Esta opción invoca la opción CreateConfig de Referencia de datos correcta, que crea o actualiza PI points, además de resolver también los parámetros de sustitución y configurar el servidor y los point ID. Cuando se selecciona esta opción, el rendimiento de la operación de importación se ve afectado. Nota: El PI point no se crea si no se selecciona la casilla de verificación Creación 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, fórmulas, unidades de medida, etc.) de una base de datos a otra. En esta sección 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 Biblioteca guardada de PI AF La biblioteca guardada de PI AF ofrece una colección de objetos de aplicación o de dominio específico que se puede importar a una base de datos de PI AF. Las bibliotecas guardadas incluyen, por lo general, categorías, plantillas de elementos, conjuntos de enumeración, tipos de referencia, tablas y la base de datos de unidades de medida. No obstante, al guardar una biblioteca tendrá la opción de incluir otros objetos, como elementos y notificaciones. Aunque la base de datos de unidades de medida no se muestra en la pestaña 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 opción no es igual que la de Exportar a archivo, que exporta una base de datos completa como un archivo XML. 14 PI System Explorer Guía del usuario

25 Uso de PI System Explorer Ver las bibliotecas instaladas actualmente Procedimiento 1. Seleccione Archivo > Propiedades de servidor AF. Se mostrará la ventana Propiedades de servidor AF. 2. Seleccione la pestaña Bibliotecas. Las bibliotecas instaladas actualmente se incluirán en esta pestaña. Nota: Pulse con el botón 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 descripción. 3. Seleccione la opción Remplazar la biblioteca existente sin preguntar para permitir que se sustituya una biblioteca con el mismo nombre. 4. Seleccione la opción Incluir objetos ajenos a la biblioteca para incluir objetos, como elementos y notificaciones, en la biblioteca. 5. Haga clic en Aceptar. 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 pestaña Bibliotecas, pulse con el botón secundario sobre la biblioteca y seleccione Propiedades. 3. Realice los cambios en la ventana Propiedades de biblioteca cuando aparezca. PI System Explorer Guía del usuario 15

26 Uso de PI System Explorer 16 PI System Explorer Guía del usuario

27 Conexión a servidores y bases de datos En esta sección Gestionar preferencias de conexión para PI System Explorer Conexión a servidores de PI AF Conexión a PI Servers Conexión a bases de datos de PI AF Gestionar preferencias de conexión para PI System Explorer Utilice la ventana Opciones de servidor para definir cómo se debe conectar PI System Explorer a un colectivo de AF o un PI collective, si se permitirán solicitudes de inicio de sesión y si desea que los servidores se añadan de forma automática 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 Preferencia de conexión al servidor AF Descripción Esta preferencia se utiliza para influir en la selección de un miembro colectivo cuando se realiza una conexión 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 selección de la conexión 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 conexión falla. Cualquiera Permitir solicitud de inicio de sesión en el servidor AF Añadir automáticamente servidores AF 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 selección de la conexión del servidor. Seleccione esta opción si desea que se muestre una solicitud de inicio de sesión cuando falle una conexión con el servidor debido a una excepción de seguridad. Seleccione esta opción para añadir de forma automática un 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 válido y PI System Explorer encuentra el nombre de equipo del servidor en la red, el servidor se añadirá de forma automática a la tabla de servidores conocidos. 3. Defina los Ajustes de PI Server: PI System Explorer Guía del usuario 17

28 Conexión a servidores y bases de datos Ajuste Preferencia de conexión a PI Server Descripción Esta preferencia se utiliza para influir en la selección de un miembro colectivo cuando se realiza una conexión 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 selección de la conexión 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 conexión falla. Cualquiera Permitir solicitud de inicio de sesión en el PI Server Añadir automáticamente servidores AF 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 selección de la conexión del servidor. Seleccione esta opción si desea que se muestre una solicitud de inicio de sesión cuando falle una conexión con el servidor debido a una excepción de seguridad. Seleccione esta opción para añadir de forma automática un 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 válido y PI System Explorer encuentra el nombre de equipo del servidor en la red, el servidor se añadirá de forma automática a la tabla de servidores conocidos. 4. Haga clic en Aceptar. Conexión a servidores de PI AF En esta sección Conexión a un servidor de PI AF Añadir un servidor de PI AF a la lista de conexiones Cambiar miembros colectivos Cambiar a un miembro colectivo concreto Conexión 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 conexión. Los servidores conectados actualmente se indicarán con un círculo de color verde. 18 PI System Explorer Guía del usuario

29 Los PI Server de las versiones y se indican con un triángulo 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 versión Para conectarse a un servidor de PI AF diferente, pulse con el botón secundario sobre el nombre del servidor y seleccione Conectar. Nota: En esta sección Si no se muestra el servidor que necesita, podrá añadirlo como se describe en Añadir 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 Descripción. 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 número 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 pestaña Recuentos. Conexión a servidores y bases de datos Ver el ID del servidor de AF, el puerto y otras propiedades Podrá ver información 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 Número de versión 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 diálogo Propiedades de servidor AF. 2. Haga clic en la pestaña General. Nota: La pestaña General incluye también el botón Configurar Active Directory. Consulte Configuración de acceso a Active Directory para los contactos para obtener más información. Añadir un servidor de PI AF a la lista de conexiones PI System Explorer Guía del usuario 19

30 Conexión a servidores y bases de datos 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 conexión. Los servidores conectados en ese momento se indicarán con un círculo de color verde. El PI Server y el servidor de PI AF predeterminados se indicarán con una marca de verificación Los PI Server de las versiones y se indican con un triángulo 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 versión Haga clic en Añadir 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 dirección IP. Las direcciones IPv6 deben incluirse entre paréntesis [ ]. Deje el campo Cuenta en blanco. El valor predeterminado de Tiempo límite de 300 segundos es válido en la mayoría de los casos. Si experimenta errores de tiempo de espera excedido cuando trabaje con PI System Explorer, incremente el valor del campo Tiempo límite. (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 función del administrador del sistema de PI AF. 4. Haga clic en Aceptar. En esta sección Nota: Si aparece un mensaje de error indicando que no puede conectarse al servidor de PI AF, tendrá que rellenar el campo Cuenta. Rellenar el campo Cuenta Configuración de acceso a Active Directory para los contactos Configuración de la seguridad de un servidor de AF Rellenar el campo Cuenta Cuando se añade una nueva conexión 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 podría 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. 20 PI System Explorer Guía del usuario

31 Conexión a servidores y bases de datos 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 resolución de problemas en la guía de instalación y actualización de PI AF. Configuración de acceso a Active Directory para los contactos Cuando utilice PI Notifications con el servidor de PI AF, es posible que necesite especificar cómo 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 aplicación 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 conéctese 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 vínculo 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 obtendrán 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 aplicación 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 más extensos, los contactos se pueden organizar en subcarpetas. El uso de subcarpetas puede agilizar la obtención de una lista de contactos de Active Directory. Utilice esta estructura con la subcarpeta: DomainUserFolder/SubDomainUserFolder/Sub SubDomainUserFolder 5. Seleccione una opción en Cuenta de acceso a Active Directory: Utilizar la cuenta con la que se ejecuta el servidor de AF como Esta es la opción por defecto. Seleccione esta opción para acceder a Active Directory con la cuenta con la que se ejecuta el servicio de aplicación 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á ningún 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 opción más simple. Utilizar la cuenta con la que se ejecuta el cliente de AF como PI System Explorer Guía del usuario 21

32 Conexión a servidores y bases de datos Seleccione esta opción para utilizar las credenciales de la cuenta de usuario con la que se ejecuta la aplicación 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 opción. Cuando la cuenta de usuario con la que se ejecuta la aplicación 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 función 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 opción, es posible que sea necesario configurar Kerberos en el supuesto de que una aplicación de AF SDK utilice la suplantación en un nivel intermedio, como un servicio web. Utilizar la cuenta especificada Esta opción permite especificar una cuenta para leer el Active Directory. Puede resultar útil cuando el servidor de Active Directory y PI AF están 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 catálogo global almacenado en caché local de Active Directory para utilizar el catálogo global en las búsquedas del controlador de dominio de Active Directory. En caso contrario, las búsquedas deben destinarse al controlador de dominio propietario. Active Directory almacena la información en un repositorio de datos distribuido denominado catálogo 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 catálogo global de las que es responsable para que no sea necesario hacer referencia a las búsquedas de Active Directory en el controlador de dominio. Esto mejora el rendimiento de las consultas que, de otra forma, tendrían 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 selección de esta casilla para devolver solo usuarios. Configuración 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 botón 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 22 PI System Explorer Guía del usuario

33 Conexión a servidores y bases de datos 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 automática al miembro colectivo con la prioridad más alta (número más bajo). Este procedimiento cambia la conexión 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 botón 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á también de forma automática al miembro colectivo con la prioridad más alta (número más bajo). Puede cambiar a un miembro concreto del colectivo. Procedimiento 1. En PI System Explorer, seleccione Conexiones. 2. Pulse con el botón secundario sobre el colectivo y seleccione Conectar con miembro colectivo. Aparecerá el cuadro de diálogo 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. Conexión a PI Servers En esta sección Conexión a un PI Server Añadir un PI Server a la lista de conexiones Ver el estado de búfer de un PI Server Conexión a un PI Server Procedimiento 1. Haga clic en Archivo > Conexiones. Se mostrará el cuadro de diálogo Servidores. El cuadro de diálogo muestra una lista de todos los PI Servers y servidores de PI AF para los que se ha configurado una conexión. Los PI Servers y servidores de PI AF conectados en ese momento se indican mediante un círculo de color verde. Los PI Servers que ejecutan versiones anteriores a la no son compatibles y se marcan con un triángulo 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 botón secundario sobre el nombre del servidor y seleccione Conectar. Si no se muestra el servidor que necesita, podrá añadirlo como se describe en Añadir un PI Server a la lista de conexiones. PI System Explorer Guía del usuario 23

34 Conexión a servidores y bases de datos En esta sección Problemas de conexión con PI Server Configuración de clientes para permitir solicitudes de inicio de sesión explícitas Problemas de conexión con PI Server La autenticación de Windows solo utiliza mapeos de identidad y no emplea los trusts de autenticación definidos con credenciales de Windows ni ningún 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 ningún mapeo de PI y existe alguna de estas condiciones: Utiliza un nombre de usuario y contraseña de PI para iniciar sesión en el PI Server. Utiliza el nombre de usuario con una contraseña en blanco para iniciar sesión en el PI Server. Estos errores se producen porque en PI AF 2012 y versiones posteriores, los ajustes de seguridad son más estrictos que en las versiones anteriores. Los clientes que se conectan con los PI Servers a través de PI AF 2012 y versiones posteriores deben respetar estos comportamientos: El comportamiento predeterminado de las conexiones es no solicitar al usuario un inicio de sesión explícito excepto si se ha configurado la opción Permitir solicitud de inicio de sesión. Este ajuste controla lo que sucede cuando falla la autenticación en PI Server. Si se ha marcado la opción Permitir solicitud de inicio de sesión, se mostrará un cuadro de diálogo solicitando al usuario que proporcione un nombre de usuario y una contraseña. Si no se ha marcado esta opción, se mostrará un mensaje de error. Este ajuste es específico 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 guía del usuario PI Server Security para obtener instrucciones. Mensajes de error de conexión con PI Server Mensaje de error No tiene privilegios suficientes para acceder al PI Server. Sin acceso: objeto seguro Las conexiones de usuario predeterminadas al PI Server están activadas actualmente para este cliente, pero han dejado de ser compatibles con PI AF. No tiene privilegios suficientes para acceder al PI Server. No hay activado ningún método de autentificación compatible. Condiciones del error de conexión Las conexiones de usuario predeterminadas se han activado en PISDK. Las conexiones de usuario predeterminadas son el único método de autenticación activado en PISDK. Sin acceso: objeto seguro Las conexiones de usuario predeterminadas al PI Server están activadas actualmente para este cliente, pero han dejado de ser compatibles con PI AF. 24 PI System Explorer Guía del usuario

35 Conexión a servidores y bases de datos Mensaje de error No tiene privilegios suficientes para acceder al PI Server. Sin acceso: objeto seguro La solicitud explícita de inicio de sesión no está configurada en este ordenador y por lo tanto no está permitida. Condiciones del error de conexión La opción de inicio de sesión explícito no se ha configurado en el registro. Configuración de clientes para permitir solicitudes de inicio de sesión explícitas Procedimiento 1. Abra PISDKUtility desde el menú Inicio de Windows. 2. Seleccione Conexiones > Opciones. Se mostrará la ventana Opciones de conexión. 3. Seleccione la casilla de verificación Solicitar inicio de sesión (si fallan protocolos configurados). 4. Haga clic en Aceptar. Añadir un PI Server a la lista de conexiones Procedimiento 1. Abra PI System Explorer y seleccione Archivo > Conexiones. Se mostrará el cuadro de diálogo Servidores. El cuadro de diálogo muestra una lista de todos los PI Servers y servidores de PI AF para los que se ha configurado una conexión. Los servidores conectados en ese momento se indican con un círculo de color verde. Los PI Servers y servidores de PI AF predeterminados se indican con una marca de verificación. (Los PI Servers de la versión y anteriores se indican con un triángulo amarillo en lugar del círculo de color verde. Puede conectarse a estas versiones anteriores del servidor, pero tal vez no pueda utilizar todas las funciones.) 2. Haga clic en Añadir PI Server. Aparecerá el cuadro de diálogo 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 dirección IP. 5. Salvo que su aplicación 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 conexión y Tiempo de esperade datos son válidos en la mayoría de los casos. Si experimenta excesos de tiempo de espera de conexión al conectar al PI Server desde PI System Explorer, aumente el tiempo en el campo Tiempo de esperade conexión. Si experimenta errores de excesos de tiempo de PI System Explorer Guía del usuario 25

36 Conexión a servidores y bases de datos 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 Versión no se pueden editar.ides el ID del PI Server, Zona horaria es la zona horaria local del PI Server y Versión es la versión del PI Server. 9. Haga clic en Aceptar. Ver el estado de búfer de un PI Server Antes de empezar Se necesita PI Buffer Subsystem 4.3 o posterior para ver el estado de búfer, así como para utilizar Buffering Manager. PI Buffer Subsystem debe estar en ejecución 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 conexión. Estado del búfer indica el estado del búfer de cada PI Server. Nota: Las versiones y anteriores de PI Buffer Subsystem muestran el estado Desconocido. 2. Para ver más detalles y gestionar el almacenamiento en búfer de un PI Server, haga clic en Buffering Manager para abrir la herramienta Buffering Manager. Nota: También puede abrir Buffering Manager desde el menú Herramientas de PI System Explorer. Qué hacer a continuación Para obtener más información sobre Buffering Manager, consulte la ayuda correspondiente. Conexión a bases de datos de PI AF En esta sección 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 26 PI System Explorer Guía del usuario

37 Conexión a servidores y bases de datos Actualizar la lista de bases de datos Acerca de la eliminación de bases de datos Configurar permisos de seguridad para una base de datos Configurar permisos de seguridad para todas las bases de datos Bases de datos de PI AF PI AF almacena objetos de Asset Framework (elementos, plantillas, etc.) en bases de datos de PI AF. Aunque puede tener varias bases de datos 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 configuración para interactuar con PI AF. No utilice esta base de datos con sus propios datos de aplicación. Crear una base de datos Procedimiento 1. En la barra de herramientas de PI System Explorer, pulse el botón 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 botón Nueva base de datos. Se mostrará la ventana Propiedades de base de datos. 4. Introduzca un nombre y una descripción opcional. 5. Para cargar una biblioteca existente en la nueva base de datos, selecciónela en el menú Cargar biblioteca. Este menú no aparece si no existe ninguna biblioteca. Para obtener más información, consulte Biblioteca guardada de PI AF. Ver o editar las propiedades de una base de datos Procedimiento 1. En PI System Explorer, pulse el botón Base de datos para abrir la ventana Seleccionar base de datos. 2. Pulse con el botón secundario y seleccione Propiedades para acceder a la ventana Propiedades de base de datos de la base de datos seleccionada. 3. Utilice las siguientes pestañas para consultar o modificar las propiedades disponibles: General Muestra el nombre, la descripción, 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. PI System Explorer Guía del usuario 27

38 Conexión a servidores y bases 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 botón Base de datos. Se mostrará el cuadro de diálogo Seleccionar base de datos. 2. Haga clic con el botón 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 botón Base de datos. Aparecerá la ventana Seleccionar base de datos. 2. Pulse con el botón secundario sobre una base de datos y seleccione Renombrar. Buscar una base de datos Procedimiento 1. En la barra de herramientas de PI System Explorer, pulse el botón Base de datos. Aparecerá la ventana Seleccionar base de datos. 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 filtrarán según el número 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 añadan bases de datos al servidor y que las bases de datos añadidas recientemente no se muestren. Procedimiento 1. En la barra de herramientas de PI System Explorer, pulse el botón Base de datos. Aparecerá la ventana Seleccionar base de datos. 2. Pulse con el botón secundario sobre el recuadro Bases de datos y seleccione Actualizar. Acerca de la eliminación de bases de datos Al eliminar una base de datos, se elimina también toda la información contenida en ella. La operación de eliminación no se puede deshacer. Compruebe que ha seleccionado la base de 28 PI System Explorer Guía del usuario

39 Conexión a servidores y bases de datos 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 1. En la barra de herramientas de PI System Explorer, pulse el botón Base de datos. Aparecerá la ventana Seleccionar base de datos. 2. Haga clic con el botón secundario sobre la base de datos y seleccione Seguridad > Base de datos. Se mostrarán las propiedades de los permisos para la base de datos seleccionada. 3. Seleccione usuarios y configure permisos según necesite. Para obtener más información sobre la configuración 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 botón Base de datos. Aparecerá la ventana Seleccionar base de datos. 2. Haga clic en. Se mostrarán las propiedades de los permisos para la base de datos seleccionada. 3. Seleccione usuarios y configure permisos según necesite. Para obtener más información sobre la configuración de permisos, consulte Configurar permisos para objetos. PI System Explorer Guía del usuario 29

40 Conexión a servidores y bases de datos 30 PI System Explorer Guía del usuario

41 Localizar y consultar información de activos En esta sección Exploración 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 Exploración de activos En esta sección Elementos mostrados por el navegador Exploración de elementos Exploración de otros objetos Configurar el tamaño de la página del navegador Abrir ventanas adicionales del navegador Elementos mostrados por el navegador El contenido del navegador de PI System Explorer depende del botón 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 aparecerán también en el panel del navegador: Notificaciones, Contactos y MyPI. Exploración de elementos Los elementos se muestran en el navegador en forma de árbol. La estructura del árbol de elementos varía según cada organización. El diseñador de modelos de activos elige la estructura más pertinente para los usuarios de la organización. En la imagen que figura a continuación, los elementos están organizados por ubicación de planta. Si es el responsable de todos los equipos de una determinada planta, este modelo puede resultarle útil. Para alguien que tenga otra función, sería más útil otro modelo. PI System Explorer Guía del usuario 31

42 Localizar y consultar información de activos El árbol de elementos puede incluir otros subárboles que ofrecen un contexto diferente para los mismos activos. Esto permite a los usuarios localizar elementos en el contexto que les resulte más útil para la tarea que tienen entre manos. Por ejemplo, además de la organización por ubicación de planta que se muestra más arriba, puede tener también una organización por fabricante de equipos, como se muestra en la siguiente imagen. Los elementos que representan las bombas aparecen en las jerarquías Manufacturers (Fabricantes) y Plant Location (Ubicación de planta). En la jerarquía Manufacturer, los elementos de bomba no son elementos nuevos independientes, sino que son referencias a los elementos que ya existían en el árbol de Plant Location. Para indicar que son referencias de elementos, se representan mediante el icono del elemento referenciado. Exploración de otros objetos Puede explorar objetos que no sean elementos. Haga clic en el botón correspondiente del panel del navegador para ver objetos con el tipo: Unidades de medida (UOMs): Al pulsar el botón Unidad de medida del panel del navegador, todas las clases de unidades de medida aparecerán en el navegador. Al seleccionar una clase, las unidades de medida que pertenecen a ella aparecerán en el visor. Objetos de biblioteca: Al pulsar el botón Biblioteca del panel del navegador, las siguientes colecciones de objetos en el navegador: categorías, plantillas, conjuntos de enumeración, tipos de referencia y tablas. Para ver todos los objetos de un determinado tipo, expanda la colección 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 jerarquía del navegador. En su lugar, cada uno de ellos tiene una colección de búsquedas. Pulse con el botón secundario sobre la colección de búsquedas para iniciar una búsqueda nueva. Las búsquedas recientes se incluyen en la colección de búsquedas. 32 PI System Explorer Guía del usuario

43 Localizar y consultar información de activos Configurar el tamaño de la página del navegador El panel de PI System Explorer Browser está paginado. Esto significa que muestra varios objetos al mismo tiempo. Si existen más objetos, PI System Explorer los muestra en otra página. En este caso, los controles Siguiente y Anterior se muestran en el navegador. El número máximo de objetos que pueden mostrarse en el navegador es, de forma predeterminada, Puede modificar ese número si lo desea. Procedimiento 1. En PI System Explorer, seleccione Herramientas > Opciones. 2. En el campo Tamaño máximo de página de rama de árbol, introduzca el número máximo de objetos que se pueden mostrar en el navegador. Abrir ventanas adicionales del navegador Procedimiento 1. Pulse con el botón 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 cálculos, información de mantenimiento, etc. Por ejemplo, puede utilizar PI System Explorer para encontrar información 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 sección Búsqueda rápida Paginación de resultados de búsqueda Búsqueda en una fecha concreta PI System Explorer Guía del usuario 33

44 Localizar y consultar información de activos Búsqueda de PI points Buscar elementos Búsqueda de atributos en elementos Buscar marcos de evento Buscar atributos en marcos de evento Buscar una transferencia Búsqueda de atributos en transferencias Búsqueda rápida Puede utilizar el cuadro de búsqueda rápida 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 selección en el panel del navegador para establecer el contexto de la búsqueda rápida. Por ejemplo, seleccione Marcos de evento en el panel del navegador para definir la búsqueda rápida para los marcos de evento. 2. En el cuadro de búsqueda rápida, seleccione un límite de búsqueda en Acciones, introduzca criterios de búsqueda y pulse la tecla Intro. Los resultados de búsqueda aparecerán en el visor y en el navegador. Nota: Los resultados de búsqueda que aparecen en el navegador permanecerán allí para que pueda acceder fácilmente a ellos en caso de que los necesite. Puede hacer clic con el botón secundario y eliminarlos del navegador; también se eliminarán al salir de PI System Explorer. Puede hacer clic con el botón secundario y guárdelos para conservarlos hasta que los elimine. Paginación de resultados de búsqueda Cuando busque un número considerable de elementos o marcos de evento, puede utilizar la opción Ajustar tamaño máximo de consulta para devolver resultados de búsquedas rápidas en fragmentos más manejables. Esto se conoce como paginación. Cambie el valor de Ajustar tamaño máximo de consulta al número de objetos que desea buscar y véalos todos a la vez en los resultados de la búsqueda. Si la búsqueda devuelve un número de objetos mayor que el especificado por el valor de Ajustar tamaño máximo de consulta, los resultados se paginarán. Tenga en cuenta que: Solo se paginarán los resultados de búsqueda para elementos, transferencias y marcos de evento. La opción Ajustar tamaño máximo de consulta solo se aplica a las búsquedas rápidas de elementos, transferencias o marcos de evento. Si busca otros objetos, la búsqueda no tendrá en cuenta el valor indicado en Ajustar tamaño máximo de consulta. Si realiza una búsqueda avanzada, el valor de Recuento máximo del cuadro de diálogo Búsqueda de elemento sustituirá al valor del campo Ajustar tamaño máximo de consulta. Por ejemplo, si el valor de Ajustar tamaño máximo de consulta es el servidor de SQL intenta encontrar 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 34 PI System Explorer Guía del usuario

45 Localizar y consultar información de activos verlas en una única página de resultados de búsqueda. Si cambia el valor de Ajustar tamaño máximo de consulta a 100, el servidor de SQL enviará los resultados después de encontrar 100 coincidencias y podrá ver los 100 objetos a la vez en los resultados de búsqueda. Definir el tamaño máximo de la consulta Utilice uno de estos dos métodos: Defina la opción Tamaño máximo 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. máx. en una ventana de búsqueda. De esta forma, se establecerá el tamaño máximo de la consulta para la búsqueda avanzada. El valor del campo Cont. máx. sustituye al valor del campo Tamaño máximo de consulta. Búsqueda en una fecha concreta Para realizar una búsqueda en PI System Explorer en una fecha y hora concretas, introdúzcalas en el campo Fecha de consulta. PI System Explorer mostrará también las versiones del objeto para esa fecha. Consulte Fecha de consulta y tiempo en PI System Explorer para obtener más información sobre los objetos a los que afecta la Fecha de consulta. Además, 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. Véase Establecer el contexto temporal de los valores de atributo mostrados. Búsqueda de PI points Compruebe que Elementos esté seleccionado en el panel del navegador. Procedimiento 1. En la barra de menús de PI System Explorer, seleccione Editar > Búsqueda de tags. (También puede elegir Ver > Paleta > Búsqueda de tags para ejecutar búsquedas de tags en la Paleta.) Se abrirá la ventana Búsqueda de tags. 2. Seleccione los PI Servers en los que desea realizar búsquedas. Puede seleccionar varios en la lista desplegable o hacer clic en el botón Examinar para localizar y añadir más PI Servers. 3. Comience por escribir una cadena de búsqueda en el cuadro de texto de búsqueda situado junto al botón Buscar. De forma predeterminada, PI AF buscará los nombres de punto que comiencen con su cadena de búsqueda. Para buscar nombres que finalicen, incluyan o coincidan exactamente con la cadena de búsqueda, haga clic en y seleccione la opción correspondiente. Para buscar en función de la descripción del punto además del nombre, haga clic en seleccione Incluir descripción en la búsqueda. Para buscar en función de determinados atributos de punto, haga clic en. Podrá buscar en función del nombre, del origen del punto, del tipo de datos y de la clase de punto. (Haga clic en Añadir criterios para añadir unidades de ingeniería o una descripción.) y PI System Explorer Guía del usuario 35

46 Localizar y consultar información de activos 4. Haga clic en Buscar para ver los resultados de la búsqueda. Para seleccionar las columnas que se mostrarán en los resultados de búsqueda, haga clic en el icono de selección 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 búsquedas de tags En el campo Búsqueda de tags puede utilizar los siguientes caracteres especiales en la cadena de búsqueda. Nota: Los resultados de los ejemplos que figuran a continuación asumen que utiliza la opción de búsqueda predeterminada, que busca los nombres de los PI point que empiezan por su cadena de búsqueda. Carácter especial Descripción Ejemplo * Sustituye cualquier número de caracteres sin especificar. sin* Devuelve todos los PI points cuyos nombres empiecen por sin; por ejemplo, sinusoid y sinusoidu.? Sustituye un único carácter sin especificar. : Cuando se realizan búsquedas de todos los PI points con un valor de atributo concreto (distinto a nombre) separará el atributo y el valor que esté buscando. Consejo: Al buscar el nombre de un PI point que incluya dos 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 valor numérico especificado CD?158 Devuelve todos los PI points cuyos nombres empiecen por CD, seguido de cualquier carácter único, seguido de 158 (por ejemplo, CD1158, CDA158, etc.). pointsource:r Devuelve todos los PI points que tengan R como pointsource. "ba:temp.1"ba\:temp.1 Cualquiera de los dos ejemplos anteriores devuelve el PI point denominado ba:temp.1. span:<=100 Devuelve los PI points que tienen un valor de atributo span inferior o igual a PI System Explorer Guía del usuario

47 Localizar y consultar información de activos Carácter especial Descripción Ejemplo ' ' o " " Delimitadores de las cadenas de búsqueda que contienen espacios o caracteres especiales '*Owner Change*' u "*Owner Change*" Devuelve todos los PI points con nombres que contengan Owner Change. "ba:temp.?" Devuelve todos los PI points cuyos nombres comiencen por ba:temp. y terminen con cualquier carácter 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 > Búsqueda de elemento. Aparecerá la ventana Búsqueda de elemento. 2. Configure la ventana Búsqueda 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 función del tipo de filtro. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Consulte Caracteres especiales en búsquedas de nombres. Plantilla Seleccione la plantilla en la que deben basarse los elementos obtenidos. Después de seleccionar una plantilla, puede añadir criterios para buscar elementos por valor de atributo. Categoría Seleccione la categoría con la que deben coincidir los elementos obtenidos. Valor de atributo Disponible si especifica una plantilla. Especifique una condición de atributo-valor: un nombre de atributo, un operador y un valor de atributo; por ejemplo, Temperature >= 98. Para recuperar más detalles, consulte Configurar una condición de valoratributo. c. Si lo desea, haga clic en Añadir Criterios y seleccione campos adicionales para insertar en la ventana; a continuación, configure estos campos para limitar los elementos recuperados: PI System Explorer Guía del usuario 37

48 Localizar y consultar información de activos Valor de atributo Disponible si especifica una plantilla. Puede especificar un máximo de tres condiciones de atributo-valor. Para cada condición, 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. Raíz de búsqueda de elementos Introduzca el elemento que desea utilizar como raíz o nivel base de la búsqueda de elementos. Escriba el nombre exacto o haga clic en Explorar para abrir la ventana Navegador de elementos, donde podrá consultar la jerarquía de elementos y seleccionar un elemento. No puede incluir caracteres comodín en el nombre que introduzca. Si no especifica un elemento, establezca el nivel principal de la jerarquía de elementos como la raíz. En función de su jerarquía de PI AF, la especificación de un elemento en el campo Raíz de búsqueda de elementos puede mejorar el rendimiento de las búsquedas. Todos los descendientes Seleccione Verdadero para recuperar cualquier subelemento de la jerarquía que coincida con los criterios especificados. Seleccione Falso para recuperar sólo los elementos de nivel raíz que coincidan con los criterios especificados. Resultados por página Introduzca el número máximo de elementos para mostrar en una sola página de los resultados de búsqueda. Si especifica valores para varios ajustes, la búsqueda devolverá sólo 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 selección 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 búsqueda de elementos seleccionada se mostrarán en el visor y el navegador. En el navegador, pulse con el botón secundario para guardar o asignar otro nombre a los resultados de búsqueda y conservarlos hasta que los elimine. También puede hacer clic con el botón secundario para eliminarlos o permitir que se eliminen al salir de PI System Explorer. En esta sección Configurar una condición de valor-atributo Utilice el campo Valor de atributo en una ventana de búsqueda para configurar una condición de valor-atributo. Caracteres especiales en búsquedas de nombres de elemento Configurar una condición de valor-atributo Puede restringir la búsqueda en función del valor de un atributo. Una vez especificada una plantilla, utilice el campo Valor de atributo para configurar una condición con la que debe coincidir la búsqueda en relación con un valor de atributo. 38 PI System Explorer Guía del usuario

49 Localizar y consultar información de activos Procedimiento 1. Haga clic en Muestra la selección de atributos y seleccione un atributo. El menú agrupa atributos en las siguientes categorías: Atributos indexados Atributos indexados, incluidos los atributos de configuración. Atributos de configuración Los atributos de configuración que no están indexados. Otros atributos Los atributos que no son de configuración que no están indexados. Nota: La evaluación de los atributos sin indexar puede tardar bastante tiempo, especialmente si están 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 botón de operador y seleccione un operador matemático. 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 búsqueda sólo utiliza los primeros 40 caracteres del valor introducido. Caracteres especiales en búsquedas de nombres de elemento Puede utilizar caracteres especiales en el campo Nombre es de una búsqueda de elementos: Carácter especial Finalidad * Sustituir cualquier número de caracteres sin especificar.. Sustituir un solo carácter sin especificar. [xyz] [!xyz] Especificar un conjunto de caracteres (x, y o z) para coincidir. Especificar un conjunto de caracteres (x, y o z) para impedir una coincidencia. PI System Explorer Guía del usuario 39

50 Localizar y consultar información de activos Carácter especial Finalidad \ Ignorar el carácter especial siguiente e interpretarlo como su carácter 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 Carácter \ 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] También, para recuperar ElementA yelementb, puede escribir: Element[!CDE] Búsqueda de atributos en elementos Puede buscar un atributo o un grupo de atributos. Tal vez desee localizar un determinado atributo, por ejemplo, para configurar una referencia de datos de fórmula 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 búsqueda de elementos.) Procedimiento 1. En el panel del navegador, haga clic en el botón Elementos. De esta forma, se establecerá el contexto correcto para el menú Buscar. Para buscar atributos de marco de evento o de transferencia, tendría que hacer clic en el botón Marcos de evento. 2. Pulse Editar > Búsqueda de atributos. Se abrirá la ventana Búsqueda de atributos. 3. Configure la ventana Búsqueda 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: 40 PI System Explorer Guía del usuario

51 Localizar y consultar información de activos Nombre de atributo Introduzca el nombre del atributo que desea recuperar. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Categoría de atributo Seleccione la categoría con la que deben coincidir los atributos recuperados. Tipo de valor de atributo Seleccione el tipo de valor que deben almacenar los atributos recuperados. Recuento máximo Introduzca el número máximo de atributos coincidentes para recuperar. b. En el área Criterios de elemento, configure los campos para limitar los elementos en los que se buscarán atributos coincidentes: Raíz de búsqueda Introduzca el elemento que desee utilizar como la raíz o el nivel base de la búsqueda de atributos. Escriba el nombre exacto o haga clic en Explorar para abrir la ventana Navegador de elementos, donde podrá consultar la jerarquía de elementos y seleccionar un elemento. No puede incluir caracteres comodín en el nombre que introduzca. Si no especifica un elemento, establezca el nivel principal de la jerarquía de elementos como la raíz. En función de la jerarquía de PI AF, la especificación de un elemento en el campo Raíz de búsqueda puede mejorar el rendimiento de las búsquedas. Seleccione la casilla de verificación Buscar subelementos para buscar la raíz introducida y los subelementos. Desmarque esta casilla para buscar sólo en la raíz introducida. Nombre Introduzca el nombre de los elementos en los que desee buscar atributos. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Categoría Seleccione la categoría de los elementos en los que desea buscar atributos. Plantilla Seleccione la plantilla de los elementos en los que se buscarán los atributos. Tipo Seleccione el tipo de los elementos en los que desea buscar atributos. Si especifica valores para varios ajustes, la búsqueda devolverá sólo 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 búsqueda. También, puede utilizar el árbol de elementos debajo de Resultados de búsqueda para buscar de forma manual los atributos bajo determinados elementos y, a continuación, seleccionar los atributos para añadirlos a la tabla Resultados de búsqueda. 5. Seleccione elementos en la lista de resultados de búsqueda y haga clic en Aceptar para mostrar los elementos seleccionados en el visor y el navegador. En el navegador, pulse con PI System Explorer Guía del usuario 41

52 Localizar y consultar información de activos el botón secundario para guardar o asignar otro nombre a los resultados de búsqueda y conservarlos hasta que los elimine. También puede hacer clic con el botón secundario para eliminarlos o permitir que se eliminen al salir de PI System Explorer. Caracteres especiales en búsquedas de nombres Al buscar objetos por nombre, como nombres de elemento o nombres de atributo, puede utilizar caracteres especiales: Carácter especial Finalidad * Sustituir cualquier número de caracteres sin especificar.? Sustituir un único carácter sin especificar. [xyz] [!xyz] Especificar un conjunto de caracteres (x,y oz) para coincidir. Especificar un conjunto de caracteres (x,y oz) para excluir una coincidencia. \ Ignorar el caracter especial siguiente e interpretarlo como su carácter real. Buscar marcos de evento Procedimiento 1. En el panel del navegador, haga clic en el botón Marcos de evento. 2. Haga clic en Editar > Búsqueda de marcos de eventos. (Otra posibilidad es pulsar con el botón secundario en el navegador sobre Búsquedas de marcos de evento y seleccionar Nueva búsqueda.) 3. Introduzca criterios de búsqueda de marcos de evento. Observe el triángulo situado al final del campo Buscar; le permitirá alternar entre distintos operadores, como: Contiene y Empieza por. Marque la casilla de verificación En curso si desea que en los resultados se muestren solo marcos de evento sin una Hora de finalización concreta. En el campo Nombre, puede introducir caracteres especiales para encontrar coincidencias de una parte del nombre. Para obtener más información, consulte Caracteres especiales en búsquedas de nombres. Para añadir campos que permitan especificar criterios adicionales, haga clic en Añadir criterios y seleccione un parámetro de la lista. Puede utilizar el criterio Raíz de búsqueda de marco de evento para indicar que en los resultados de búsqueda solo se incluyan los marcos de evento que sean secundarios del marco de evento especificado. Puede añadir dos criterios en el campo Duración, si es necesario. Por ejemplo, si desea buscar un marco de evento cuya duración haya sido de una hora como mínimo, pero no superior a tres, defina los dos campos de duración 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 aparecerán 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 mostrarán los resultados de la búsqueda 42 PI System Explorer Guía del usuario

53 Localizar y consultar información de activos en el navegador. Pulse con el botón secundario sobre una de las búsquedas de la lista, seleccione Ordenar pory elija una opción. Pulse con el botón secundario para guardar o asignar otro nombre a los resultados de búsqueda y conservarlos hasta que los elimine. También puede hacer clic con el botón 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 menús de búsqueda. 2. En el menú principal de PI System Explorer, seleccione Editar > Búsqueda de atributos de marcos de eventos. Se abrirá la ventana Búsqueda de atributos de marcos de eventos. 3. Configure la ventana Búsqueda de atributos de marcos de eventos para localizar los atributos que desee en la base de datos de PI AF: a. En Donde, defina los campos para limitar los atributos recuperados: Nombre de atributo Introduzca el nombre del atributo que desea recuperar. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Categoría de atributo Seleccione la categoría con la que deben coincidir los atributos recuperados. Tipo de valor de atributo Seleccione el tipo de valor que deben almacenar los atributos recuperados. Recuento máximo Introduzca el número máximo de atributos coincidentes para recuperar. b. En el área Criterios de marco de evento, configure los campos para limitar la búsqueda a los atributos que coincidan: Buscar Seleccione criterios para buscar las transferencias que estén dentro del período especificado por Inicio de búsqueda y Final de búsqueda. Inicio de búsqueda/final de búsqueda Seleccione o introduzca las horas de inicio y finalización del período de búsqueda. Raíz de búsqueda Introduzca el marco de evento para utilizar como raíz o nivel básico de la búsqueda de atributos. Escriba el nombre exacto o haga clic en Explorar para abrir la ventana Explorador de marcos de evento, donde podrá consultar la jerarquía de marcos de evento y seleccionar uno. No puede incluir caracteres comodín en el nombre que introduzca. Si no especifica un marco de evento, la raíz se establecerá en el nivel principal de la jerarquía. En función de la complejidad de su jerarquía de PI AF, la especificación de una raíz de búsqueda puede mejorar el rendimiento de la búsqueda. Seleccione la casilla de verificación Buscar marcos de subeventos para buscar la raíz introducida y sus elementos secundarios. Desmarque esta casilla para buscar sólo en la raíz introducida. PI System Explorer Guía del usuario 43

54 Localizar y consultar información de activos Nombre Introduzca el nombre de los marcos de evento cuyos atributos desee buscar. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Duración Introduzca valores de duración máximos y mínimos para limitar la búsqueda de atributos a marcos de evento cuya duración se encuentre dentro de estos límites. Categoría Seleccione la categoría 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. Si especifica valores para varios ajustes, la búsqueda devolverá sólo 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 búsqueda. Puede limitar los resultados aún más para mostrar únicamente los atributos que coincidan con el texto introducido en el campo Resultados de búsqueda. 5. Seleccione elementos en la lista de resultados de búsqueda y haga clic en Aceptar para mostrar los elementos seleccionados en el visor y el navegador. En el navegador, pulse con el botón secundario para guardar o asignar otro nombre a los resultados de búsqueda para conservarlos hasta que los elimine. También puede hacer clic con el botón 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: Búsquedas de marcos de evento y Búsquedas de transferencias. Nota: Si ha creado recientemente un marco de evento, también se mostrará en el navegador la colección Marcos de evento recientes. Del mismo modo, si ha creado recientemente una transferencia, se mostrará la colección Transferencias recientes en el navegador. 2. Pulse con el botón secundario sobre Búsquedas de transferencias y seleccione Nueva búsqueda. Aparecerá el cuadro de diálogo Criterios de búsqueda de transferencias. 3. Introduzca criterios de búsqueda 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 más información, consulte Caracteres especiales en búsquedas de nombres. Los campos Origen y Destino permiten especificar elementos como origen y destino de una transferencia. El campo Cont. máx. limita el número de resultados de búsqueda devueltos. 44 PI System Explorer Guía del usuario

55 Localizar y consultar información de activos 4. Una vez definidos los criterios de búsqueda, haga clic en Buscar. Los resultados de la búsqueda aparecerán en el área Resultados de búsqueda de la ventana Criterios de búsqueda de transferencias. 5. Para filtrar aún más la búsqueda, escriba en el campo de texto situado en la parte superior de los resultados de búsqueda. A medida que escriba, se irán filtrando los resultados. Búsqueda de atributos en transferencias Procedimiento 1. En el panel del navegador, seleccione Marcos de evento para establecer el contexto de los menús de búsqueda. 2. En el menú principal de PI System Explorer, seleccione Editar > Búsqueda de atributo de transferencia. Se abrirá la ventana Búsqueda de atributo de transferencia. 3. Configure la ventana Búsqueda de atributo de transferencia para localizar los atributos que desee en la base de datos de PI AF: a. En Donde, defina los campos para limitar los atributos recuperados: Nombre de atributo Introduzca el nombre del atributo que desea recuperar. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Categoría de atributo Seleccione la categoría con la que deben coincidir los atributos recuperados. Tipo de valor de atributo Seleccione el tipo de valor que deben almacenar los atributos recuperados. Recuento máximo Introduzca el número máximo de atributos coincidentes para recuperar. b. En el área Criterio de transferencia, configure los campos para limitar la búsqueda de atributos a las transferencias que cumplan los criterios especificados: Buscar Seleccione criterios para buscar las transferencias que estén dentro del período especificado por Inicio de búsqueda y Final de búsqueda. Inicio de búsqueda/final de búsqueda Seleccione o introduzca las horas de inicio y finalización del período de búsqueda. Nombre Introduzca el nombre de las transferencias cuyos atributos desee buscar. Puede introducir caracteres especiales para buscar coincidencias de una parte de un nombre. Véase Caracteres especiales en búsquedas de nombres. Origen Introduzca o examine y seleccione el elemento de origen de las transferencias cuyos atributos desee incluir en la búsqueda. PI System Explorer Guía del usuario 45

56 Localizar y consultar información de activos Destino Introduzca o examine y seleccione el elemento de destino de las transferencias cuyos atributos desee incluir en la búsqueda. Plantilla Seleccione la plantilla de las transferencias cuyos atributos desea buscar. Categoría Seleccione la categoría de las transferencias cuyos atributos desea buscar. Si especifica valores para varios ajustes, la búsqueda devolverá sólo 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 búsqueda. Puede limitar los resultados aún más para mostrar únicamente los atributos que coincidan con el texto introducido en el campo Resultados de búsqueda. Los resultados de búsquedas de atributos anteriores se mostrarán 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 fácil tendencias sencillas para poder verificar las fórmulas, los cálculos y otras métricas que cree en PI AF. Mientras diseña una fórmula de AF, es posible que desee comprobar cuáles serán los resultados de las últimas horas. Si va a crear atributos de PI point que incluyan resúmenes, podría ser útil ver cómo serán para las horas más recientes. Puede añadir los atributos de AF o los PI points que le interesen a una tendencia. Una forma de hacerlo es arrastrándolos y soltándolos en ella. Después, podrá explorar los datos ajustando la duración y las horas de inicio y finalización de la tendencia. Una vez creada la tendencia, se mostrará en la ventana Tendencia aunque esté utilizando otras funciones en PI System Explorer. Podrá añadir 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. También podrá ver la tendencia de un atributo cuando consulte sus datos de serie temporal (para ver los datos de serie temporal, pulse con el botón secundario sobre un atributo y seleccione Datos de serie temporal). La tendencia se muestra de forma automática en la parte inferior de la ventana Datos de serie temporal. Nota: OSIsoft recomienda utilizar herramientas de visualización, como PI Coresight, PI ProcessBook y PI Webparts, para crear y guardar cualquier tendencia que tenga previsto utilizar en más de una ocasión. Procedimiento 1. Seleccione Mostrar tendencia en el menú Ver. Se abrirá la ventana Tendencia. 2. Para añadir un atributo de AF a la tendencia, haga clic en Añadir atributos. Se abrirá la ventana Búsqueda de atributos. a. Si es necesario, especifique parámetros de búsqueda en Nombre de atributo, Categoría de atributo y otros campos para localizar el atributo que le interese. b. Expanda la jerarquía de elementos en el área Resultados de búsqueda y seleccione el atributo. 46 PI System Explorer Guía del usuario

57 Localizar y consultar información de activos c. Haga clic en Aceptar. La ventana Tendencia muestra una tendencia que indica cómo ha variado el atributo a lo largo de la última hora (1 hora es la duración predeterminada). d. Puede ajustar la duración especificando tiempos en los campos Hora de inicio y Hora de finalización. 3. Para añadir un PI point a la tendencia, haga clic en Añadir PI points. Se abrirá la ventana Búsqueda de tags. a. Localice el PI point que desea consultar y selecciónelo en los resultados. b. Haga clic en Aceptar. El PI point se añadirá a la tendencia. 4. Añada cualquier otro atributo de AF o PI point cuyos datos desee consultar. Los trazos en la ventana Tendencia se mantendrán hasta que la cierre. En cualquier momento que desee, podrá arrastrar atributos y PI points desde otros resultados de búsqueda y soltarlos en la tendencia para añadirlos. También puede pulsar con el botón secundario sobre un atributo y seleccionar Añadir a tendencia. 5. Para ajustar los trazos que se verán en la tendencia, pulse Trazos y anule la selección 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 características, 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 versión 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 calibración de los tanques se actualizan de forma periódica para ajustarse a las cambiantes características físicas del tanque. Si versiona la tabla, podrá utilizarla con la misma configuración que tenía en el momento de la recopilación de datos. PI System Explorer permite crear varias versiones de elementos, modelos y tablas. También, 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 sección Crear una versión de un elemento o un modelo Crear una versión de tabla Visualización de diferentes versiones de objeto y objetos obsoletos PI System Explorer Guía del usuario 47

58 Localizar y consultar información de activos Crear una versión 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 pestaña Versión del panel del visor y pulse Nueva versión. (También puede pulsar con el botón secundario sobre el elemento o modelo en el navegador y seleccionar Crear versión.) Se mostrará la ventana Crear versión. 3. Introduzca una Fecha efectiva para la versión o haga clic en para elegir una y haga clic en Aceptar. PI System Explorer crea una versión. Nota: La creación de una versión producirá un ingreso del elemento o del modelo. Crear una versión 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 botón secundario sobre la colección Tablas y seleccione Nueva tabla. 3. Haga clic en la pestaña Versión del panel del visor y pulse Nueva versión. (También puede pulsar con el botón secundario sobre el elemento o modelo en el navegador y seleccionar Crear versión.) Se mostrará la ventana Crear versión. 4. Introduzca una Fecha efectiva para la versión o haga clic en para elegir una y haga clic en Aceptar. PI System Explorer crea una versión. Nota: La creación de una versión producirá un ingreso en la tabla. Visualización de diferentes versiones de objeto y objetos obsoletos De forma predeterminada, PI System Explorer muestra las versiones más 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 versión de un objeto, si configura en Fecha de consulta una fecha fija en la que el objeto o la versión 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 sección 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 48 PI System Explorer Guía del usuario

59 Localizar y consultar información de activos 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 búsqueda El valor predeterminado de Fecha de consulta, Ajustar a más reciente, determina que PI System Explorer busque y muestre los datos más 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. Véase Establecer el contexto temporal de los valores de atributo mostrados.) Ajustar a más reciente también hace que PI System Explorer utilice las versiones más 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 miércoles Fecha de consulta se establecerá en lunes. Cómo afecta la fecha de consulta a PI System Explorer Qué se ve afectado Todos los objetos de PI System Explorer Elemento, modelo y versiones de tabla en la búsqueda Tiempo relativo en las búsquedas Datos PI La fecha de consulta es Ajustar a más reciente PI System Explorer utiliza las versiones más recientes aunque sean versiones futuras; excluye cualquier objeto con una fecha obsoleta, aunque sea una fecha futura. PI System Explorer devuelve las versiones más recientes, aunque sean futuras. PI System Explorer define el tiempo actual (*) como el momento de la búsqueda. Se devuelve el valor de instantánea más reciente de los datos PI. La fecha de consulta es una fecha y hora fijas PI System Explorer utiliza las versiones de objetos que están vigentes en ese momento. PI System Explorer devuelve las versiones que están vigentes en ese momento. PI System Explorer define el tiempo actual (*) como el tiempo especificado en Fecha de consulta. Los datos PI devueltos representan 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 día y hora concretos, ese día y hora se mantendrán constantes hasta que la modifique. Procedimiento 1. En la barra de herramientas de PI System Explorer, pulse el botón Fecha de consulta. PI System Explorer Guía del usuario 49

60 Localizar y consultar información de activos Aparecerá el selector de fecha y hora. 2. Seleccione la fecha y hora que desee. Si desea definir la fecha de consulta como el día y la hora actuales, pulse el botón Ajustar a ahora. Nota: Al seleccionar Ajustar a ahora como fecha de consulta, la fecha de consulta se define como un día y hora concretos; esto es, como un valor constante. No es lo mismo que definir la fecha de consulta como siempre en la hora actual. En ese caso, seleccione la opción Ajustar a más reciente. 3. Haga clic en Aceptar. 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 están determinados por el valor indicado en Establecer contexto temporal. PI System Explorer muestra los valores más recientes de los atributos en función de la hora actual. El valor de Fecha de consulta refleja la configuración temporal de PI System Explorer (consulte Fecha de consulta y tiempo en PI System Explorer). Sin embargo, puede ver valores de atributo para una hora distinta si especifica la nueva hora en 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 configuración 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á aplicándose a todos los demás objetos de PI System Explorer. Procedimiento 1. En la barra de herramientas de PI System Explorer, pulse el botón Establecer contexto temporal para abrir la ventana Establecer contexto temporal. También puede hacer clic en Herramientas > Opciones y seleccionar la pestaña Contexto temporal. 2. Seleccione una de las siguientes opciones. Introduzca valores temporales para una opción directamente o haga clic en el botón del selector de fecha y hora para seleccionarlos. También puede utilizar el botón de menú en cascada para crear una expresión temporal. Opción Hora y fecha de la consulta Hora alternativa Intervalo de tiempo Descripción El cuadro de texto muestra la configuración actual de Fecha de consulta. Puede seleccionar otra configuración temporal. Introduzca una nueva hora para utilizar con los valores de atributo mostrados. Introduzca las horas de inicio y finalización 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 configuración 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 Más reciente disponible. 4. Haga clic en Aplicar para ver los cambios y en Aceptar para guardarlos. 50 PI System Explorer Guía del usuario

61 Localizar y consultar información de activos 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 pestaña Versión. 2. Haga clic en Mostrar historial. Se abrirá la ventana Mostrar historial. Todas las versiones existentes se mostrarán 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 versión anterior y no está en la más reciente. El color verde significa que el elemento está presente en la versión más 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 cómo funcionarán 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 visualización de los datos de serie temporal Procedimiento 1. Pulse con el botón secundario sobre el atributo en el visor y seleccione la opción Datos de serie temporal en el menú que aparece. Se mostrará la ventana Datos de serie temporal. 2. Seleccione la pestaña 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 límite y Expresión de filtro. Muestreado Devuelve valores interpolados y repartidos de manera uniforme a lo largo de un intervalo regular. Puede incluir una Expresión de filtro. Plot Obtiene valores a lo largo del intervalo de tiempo especificado que sirven para trazar el número de intervalos especificados. Por lo general, los intervalos representan píxeles y esta función puede utilizarse para representar el ancho de la pantalla disponible para el plot. Resumen Muestra Estadísticas estadísticas que resumen los valores de atributo que admiten esta característica. Puede especificar Ponderación. PI System Explorer Guía del usuario 51

62 Localizar y consultar información de activos En esta sección Estadísticas Ponderación Expresión de filtro Tipo de límite Restricciones de visualización de los datos de serie temporal Abreviaturas de configuración de atributos Estadísticas La pestaña Resumen proporciona las siguientes estadísticas de los atributos que admiten esas estadísticas: Porcentaje correcto Muestra el porcentaje de tiempo para el que se devuelven valores correctos en relación con el intervalo de tiempo total. Los valores correctos son valores de evento que se han determinado como válidos y no tienen el estado de error. Promedio Calcula el promedio de los valores durante el intervalo. Mínimo Devuelve el valor mínimo durante el intervalo. Máximo Devuelve el valor máximo durante el intervalo. Intervalo Calcula el valor máximo menos el valor mínimo durante el intervalo. Desviación estándar Calcula la desviación estándar de los valores durante el intervalo. Desviación estándar de población Calcula la desviación estándar de población de los valores durante el intervalo. Recuento Devuelve el total de valores almacenados durante el intervalo. Ponderación La pestaña Resumen permite seleccionar la ponderación de los cálculos estadísticos: Ponderado en tiempo Valor predeterminado Pondera cada valor de evento en función del intervalo de tiempo durante el que se aplica. Ponderado en tiempo continuo Pondera los valores en función del tiempo, pero realiza la interpolación entre los valores como si estos representaran datos continuos (interpolación estándar), independientemente de si el atributo es escalonado. 52 PI System Explorer Guía del usuario

63 Localizar y consultar información de activos Ponderado en tiempo discreto Pondera los valores en función del tiempo, pero realiza la interpolación 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 método requiere como mínimo un evento en un intervalo de tiempo (dos eventos para los cálculos de desviación estándar). De forma predeterminada, los eventos que se encuentran en el límite del cálculo se gestionan del siguiente modo: utilizar eventos en ambos límites cuando hay solo un intervalo de cálculo incluir eventos a la hora de inicio en varios intervalos y ordenar estos de menos a más reciente incluir eventos a la hora de finalización en varios intervalos y ordenar estos de más a menos reciente Ponderado a evento - Excluir evento más temprano Ponderado a evento, salvo que el evento a la hora de inicio (hora más temprana) de un intervalo no se utiliza en ese intervalo. Ponderado a evento - Excluir evento más reciente: Ponderado a evento, salvo que el evento a la hora de finalización (hora más reciente) de un intervalo no se utiliza en ese intervalo. Ponderado a evento incluye ambos extremos: Los eventos de los dos extremos de los límites del intervalo se incluyen en el cálculo ponderado a evento. Expresión de filtro Añada una expresión de filtro para filtrar valores de evento mediante una expresión matemática y eliminar los datos para los que la expresión dé como resultado falso. Por ejemplo, la expresión de filtro simple:. < 70 eliminará todos los valores del cálculo superiores a 70. Asimismo, en la expresión de filtro puede utilizar cualquier ecuación de rendimiento de PI válida para elaborar expresiones más complejas que eliminen los picos atípicos de los valores de datos, por ejemplo. Las variables de expresión están limitadas a los atributos o PI Points originados desde un único PI Server. Los atributos que se resolverían en un valor estático (sin ninguna referencia de datos configurada) son también válidos. Consulte Referencia indirecta para obtener una descripción completa de una posible sintaxis de referencia. Ejemplos de variables de atributo Expresión de filtro Acción. Hace referencia al atributo que se está consultando Level Hace referencia al atributo Level en el mismo nivel de jerarquía de atributos del elemento o marco de evento... Hace referencia al atributo principal del atributo que se está consultando. Solo es válido para los atributos secundarios anidados.. HighLimit Hace referencia al atributo secundario HighLimit del atributo que se está consultando. PI System Explorer Guía del usuario 53

64 Localizar y consultar información de activos Expresión de filtro Temperature \\MyPIServer\sinusoid \\myafserver\mydatabase\myelement myatttribute \myrootelement myatttribute Acción Hace referencia al atributo Temperature en el nivel de jerarquía superior del elemento o marco de evento actuales. Ruta absoluta a un PI Point. Debe estar en el mismo PI Server que el atributo actual consultado. Ruta absoluta a un atributo AF. Ruta relativa de base de datos a un atributo AF Ejemplos de variable de PI Point Expresión de filtro Acción. Hace referencia al PI Point que se está consultando sinusoid Hace referencia al PI Point sinusoid en el mismo PI Server. Tipo de límite Especifique un tipo de límite para determinar cómo se gestionarán las búsquedas de valores de datos cuando se encuentren cerca de las horas de inicio y finalización del rango de valores: Dentro (valor predeterminado) Devuelve valores a las horas de inicio y finalización, si existen, o los valores más próximos dentro del rango. Fuera Devuelve los valores más próximos que están inmediatamente fuera del rango. Interpolado Devuelve valores interpolados a las horas de inicio y finalización. Restricciones de visualización de los datos de serie temporal 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 también se aplican en otras herramientas cliente, como PI DataLink, PI Coresight, PI ProcessBook y PI WebParts. Para obtener una descripción de las abreviaturas de configuración de atributos en el encabezado de tabla y las definiciones de cada tipo de configuración, consulte Abreviaturas de configuración de atributos. Función PI PI-Arc PI-Rel PI-TR PI-TR- Rel Interpol atedvalu e Interpol atedvalu es Interpol atedvalu esattim es NO-DR F CC CTS SÍ SÍ SÍ NO SÍ SÍ SÍ Opcional Código SÍ SÍ SÍ NO SÍ SÍ SÍ Opcional Código SÍ SÍ SÍ NO SÍ SÍ SÍ Opcional Código 54 PI System Explorer Guía del usuario

65 Localizar y consultar información de activos Función PI PI-Arc PI-Rel PI-TR PI-TR- Rel Recorde dvalue Recorde dvalues Recorde dvalues ByCount PlotValu es Summar y Summar ies Filtered Summar ies UpdateV alue UpdateV alues Annotati ons NO-DR F CC CTS SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO SÍ NO NO SÍ SÍ Opcional Código SÍ NO NO NO NO NO NO NO Código SÍ NO SÍ NO NO SÍ NO NO Código SÍ NO SÍ NO NO SÍ NO NO Código v SÍ SÍ NO NO NO NO NO Código Filters SÍ NO NO NO NO NO NO NO Código Abreviaturas de configuración de atributos En la siguiente tabla se definen las abreviaturas de configuración de atributos que se utilizan en Restricciones de visualización de los datos de serie temporal. Abreviatura Significado Descripción PI PI-Arc PI Point configurado de forma simple PI Point especificado para recuperación de archivos Ninguna configuración adicional Time Method es Automatic, Interpolated o AtOrBefore Time Method es Before, Exact, 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-TR-Rel PI Point solo para intervalo de tiempo Intervalo de tiempo con tiempo relativo No es compatible con TimeMethod. TimeMethod se establece en TimeRange o TImeRangeOverride. No-DR Sin referencias de datos Sin referencias de datos F CC Referencia de datos basada en un cálculo con las entradas de series temporales como fórmula. Referencia de datos personalizada basada en cálculos Si no hay entradas, se comportará básicamente como No-DR. PI System Explorer Guía del usuario 55

66 Localizar y consultar información de activos Abreviatura Significado Descripción CTS Referencia de datos personalizada que genera sus propios datos de series temporales 56 PI System Explorer Guía del usuario

67 Diseño e implementación de modelos de activos de PI AF En esta sección Organización de modelos de activos Representación de activos en PI Asset Framework Seguridad de objetos en PI AF Asociación de datos con activos Trabajo con unidades de medida Organización de modelos de activos El objetivo de la organización de los modelos de activos es hacer que a los usuarios les resulte fácil encontrar los activos. El método de organización 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 jerarquía de elementos. Véase Estructuración del modelo de activos. Puede realizar la organización también por categorías para agilizar y simplificar la exploración y la búsqueda de información. Considere las categorías como etiquetas que se pueden aplicar a objetos de PI AF. Cada objeto puede tener varias categorías. Véase Uso de categorías para facilitar la localización de objetos. Nota: También puede organizar activos dentro de un proceso. Véase Modelado de un proceso. En esta sección Estructuración del modelo de activos Cómo tomar decisiones sobre jerarquías Crear vistas múltiples de activos Uso de categorías para facilitar la localización de objetos Estructuración 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 organización de elementos en jerarquías hace más fácil navegar por ellos y ofrece información sobre cómo se relacionan los elementos entre sí. Al crear un modelo de activos, tendrá que decidir qué estructura hará más fácil a los usuarios encontrar los diferentes activos. Tenga en cuenta quiénes 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 información de mantenimiento. Para este grupo, es posible que desee agrupar activos por tipo de equipo. PI System Explorer Guía del usuario 57

68 Diseño e implementación 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 continuación, colocar todos los elementos de bombas en él. Si tuviera dos elementos que representaran tanques, podría colocarlos en el elemento Tanques. Modelo de activos organizados por tipo de equipo Por otro lado, si tiene varias plantas en diferentes ubicaciones, es posible que ese mismo ingeniero de mantenimiento prefiera ver todos los equipos ubicados en su propia planta. La siguiente ilustración muestra los mismos elementos organizados por planta. Modelo de activos organizados por ubicación No esta limitado a una única estrategia de organización. 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 también. En la siguiente ilustración, la jerarquía incluye el árbol geográfico y el árbol de equipos uno junto al otro. Modelo de activos mixto También, puede anidar la organización por equipos en la organización por zonas geográficas. Cómo tomar decisiones sobre jerarquías El objetivo es crear una jerarquía 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 jerarquía para un subconjunto de sus activos. Por ejemplo, puede comenzar por crear un modelo para los tanques o bien para el equipo en una sola planta o el equipo de un solo fabricante. Otro planteamiento sería crear una jerarquía para un determinado tipo de usuario. Reúna información: 58 PI System Explorer Guía del usuario

69 Diseño e implementación de modelos de activos de PI AF Qué activos se incluirán en el árbol? En otras palabras, qué tipo de equipo desea incluir en el modelo? Quién 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 información necesitan? Plantéese preguntar a un número reducido de usuarios representativos de cada tipo a qué datos necesitan acceder y cómo. Esto le proporcionará información sobre la estrategia organizativa. Una vez más, empiece a pequeña 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 cómo desean acceder a la información del equipo. Probablemente, con frecuencia buscarán activos por tipo de equipo, pero en algunas ocasiones necesitarán 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. También, puede crear el árbol por tipo de equipo y utilizar categorías para etiquetar cada activo por fabricante. Una vez creada la jerarquía para un tipo de usuario, puede pedirles a algunos de ellos que la prueben durante un cierto tiempo y pedirles que le proporcionen comentarios para mejorar la jerarquía. Las jerarquías pueden modificarse siempre que se desee. Nota: Cuando piense en los usuarios, recuerde que la jerarquía de elementos puede mostrarse también en determinadas aplicaciones cliente de PI. Tenga en cuenta también 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 múltiples de activos Puede utilizar referencias de elementos para añadir el mismo elemento varias veces a la jerarquía de elementos, como se describe en Estructuración del modelo de activos. Cuando se crea una referencia a un elemento existente, se crea fundamentalmente un marcador en la jerarquía que vuelve a señalar 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 sección Tipos de referencia Crear una referencia de elemento Crear varias referencias de elemento Localizar otras referencias al mismo elemento PI System Explorer Guía del usuario 59

70 Diseño e implementación de modelos de activos de PI AF Tipos de referencia Al añadir una referencia de elemento a una jerarquía de elementos, la relación exacta entre el elemento referenciado y el elemento al que se añade depende del tipo de referencia. PI AF proporciona tres tipos de referencia de forma predeterminada: Tipo de referencia principal-secundario Tipo de referencia de composición Tipo de referencia débil También puede crear sus propios tipos de referencia personalizados con la Representación de plantillas secundarias. En esta sección Tipo de referencia principal-secundario Tipo de referencia de composición Tipo de referencia débil Tipo de referencia principal-secundario 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. Tendría 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 también de la empresa, dejará de existir porque se habrán eliminado todas las referencias principal-secundario. Tipo de referencia de composición Un tipo de referencia con la fuerza de composición 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 composición, eliminará también el elemento secundario. Utilice una referencia de composición cuando los dos objetos de la relación se consideren un solo elemento. Por ejemplo, un medidor puede estar compuesto de dos sensores; por lo tanto, tendría que utilizar una referencia de composición entre el elemento del medidor y cada uno de sus dos elementos secundarios de sensor. Si elimina el elemento del medidor, eliminará también 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 extraerán también. Tipo de referencia débil Utilice una referencia débil entre dos elementos cuando desee crear una relación entre dos elementos, pero no desee que la relación determine la duración del elemento secundario. Por ejemplo, si desea organizar los medidores por grupos, pero se han eliminado todas las referencias fuertes al medidor, es probable que desee que se elimine automáticamente de la 60 PI System Explorer Guía del usuario

71 Diseño e implementación de modelos de activos de PI AF agrupación. En este caso, tendría que utilizar una referencia débil 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 arrástrelo 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 más información. 3. Haga clic en Aceptar. Los elementos referenciados aparecerán 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 botón secundario sobre un elemento, seleccione Nuevo y, a continuación, Añadir referencia de elemento. Observe que también puede seleccionar un elemento y arrastrarlo al principal. Aparecerá la ventana Añadir elementos. 2. Pulse el botón Buscar múltiples elementos. Aparecerá la ventana Búsqueda de elemento. 3. Seleccione criterios de búsqueda para localizar el elemento deseado y pulse el botón Buscar. El campo de resultados de la búsqueda mostrará los resultados de su búsqueda. 4. Seleccione los elementos a los que desee hacer referencia y haga clic en Aceptar. Aparecerá la ventana Añadir 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 más información. 6. Haga clic en Aceptar. Los elementos referenciados aparecerán 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 jerarquía. Podrá localizar todos los elementos dentro de la jerarquía que contienen el elemento o una referencia al elemento. PI System Explorer Guía del usuario 61

72 Diseño e implementación de modelos de activos de PI AF Procedimiento 1. Seleccione el elemento en el navegador. 2. En la hoja de propiedades, haga clic en la pestaña General. 3. Haga clic en el vínculo Primarios. Se mostrarán los primarios del elemento. Uso de categorías para facilitar la localización de objetos En esta sección Categorías Crear una categoría Ver categorías Añadir un objeto a una categoría Categorías PI System Explorer permite organizar objetos en categorías. Las categorías son básicamente grupos de objetos definidos por los usuarios. Su finalidad es ayudar a encontrar objetos con más facilidad. Cuando busque un objeto, puede utilizar la categoría como filtro para reducir la lista de resultados. Defina tantas categorías como desee. Los objetos pueden pertenecer a varias categorías. Por ejemplo, supongamos que tiene un conjunto de elementos que representan tanques. La mitad de los tanques están fabricados por la empresa ACME y la otra, por la empresa EMCA. Para ubicar los tanques por fabricante, cree dos categorías: ACME y EMCA. Cada tipo de objeto tendrá sus propias categorías. No podrá aplicar las categorías de un tipo de objeto a un objeto de otro tipo. Por ejemplo, no podrá aplicar una categoría de elemento a una tabla. PI AF admite los siguientes tipos de categoría: Análisis Atributo Elemento Tipo de referencia Tabla Crear una categoría Este procedimiento utiliza PI System Explorer para crear una categoría. También puede utilizar PI Builder para crear distintas categorías a partir de una hoja de cálculo Excel. Procedimiento 1. Abra PI System Explorer. 2. Haga clic en la pestaña Biblioteca del panel del navegador. 3. En el navegador, en Categorías, pulse con el botón secundario sobre el tipo de objeto de categoría y seleccione Nueva categoría en el menú que aparece. Se mostrará el cuadro de diálogo Propiedades de categoría. 62 PI System Explorer Guía del usuario

73 Diseño e implementación de modelos de activos de PI AF 4. Asigne un nombre a la categoría y, si lo desea, escriba una descripción. 5. Haga clic en Aceptar. La categoría aparecerá en el visor. 6. Guarde su trabajo. Ver categorías Procedimiento 1. Abra PI System Explorer. 2. Haga clic en la pestaña Biblioteca del panel del navegador. 3. En el navegador, en Categorías, haga clic en un tipo de objeto de categoría. Las categorías definidas para ese objeto aparecerán en el visor. Añadir un objeto a una categoría Procedimiento 1. En el visor, haga clic con el botón secundario sobre el objeto o los objetos que desee incluir en la categoría 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 categoría o categorías que desea aplicar a los objetos seleccionados. Nota: Si la categoría que necesita no aparece en la lista, haga clic en el botón Nueva categoría para crearla. Representación de activos en PI Asset Framework Todos los objetos físicos que incluya en el modelo estarán representados por un elemento de PI AF. Los objetos físicos 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 información fija, como el diámetro de un tanque, por ejemplo. Un atributo puede también hacer referencia a un PI point, una fórmula, 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 sección Uso de elementos para modelar activos Uso de elementos para representar activos PI System Explorer Guía del usuario 63

74 Diseño e implementación de modelos de activos de PI AF 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, después, podrá crear tantos elementos como necesite basándose en la plantilla. Si realiza un cambio en una plantilla, este cambio se reflejará automáticamente 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 después basar todas las demás bombas en esa plantilla. Los atributos de la plantilla se crearán de forma automática 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 automática 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 estén actualizados. Otra ventaja es que las herramientas de visualización pueden ofrecer características especiales para los objetos basados en plantillas. Por ejemplo, supongamos que crea una tendencia para una bomba basada en una plantilla. Una herramienta de visualización podría permitirle intercambiar o añadir 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 sección Estrategia de plantillas Plantillas de elementos Definición de plantillas para otros objetos Representación de plantillas secundarias Estrategia de plantillas Prácticamente 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 función de esa plantilla. Todos los cambios que realice en una plantilla de elementos se propagarán a todos los elementos basados en esa plantilla. Una única modificación 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, cálculos 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 específico. Una plantilla puede definir un tipo específico de dispositivo de medición, como un instrumento de una marca concreta, o puede ser una plantilla de uso amplio que especifica una determinada función, como medidor 64 PI System Explorer Guía del usuario

75 Diseño e implementación de modelos de activos de PI AF de masa líquida. En función de la amplitud con la que defina la plantilla, puede encontrarse con que la lista de atributos es ligeramente diferente para distintos subconjuntos de activos. En esta situación, plantéese utilizar una plantilla base (Plantillas base). La alternativa es utilizar una plantilla diferente para cada subconjunto de activos. También puede permitir que los elementos incluyan atributos que no estén definidos ni mantenidos por la plantilla (Extensiones). De esta forma, podrá añadir atributos simples y específicos de activos sin necesidad de añadirlos 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, cálculos y análisis resulte mucho más fácil, porque los equipos con el mismo tipo pueden compartir la implementación. 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 configuración del elemento estará definida en la plantilla. Cuando modifique una plantilla de elementos, los cambios se propagarán a todos los elementos derivados de ella. La supresión de una plantilla de elementos eliminará todas las notificaciones o plantillas de análisis que se refieran a ella. Tenga en cuenta que: Un elemento derivado de una plantilla obtiene su definición de las categorías, atributos y puertos de la plantilla. Si la plantilla admite ampliaciones, un elemento derivado podrá contener categorías, 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 jerarquía. En esta sección Crear una plantilla de elementos Cree y configure una plantilla de elementos. Configurar la generación automática de puntos Configure una referencia de datos de PI point para que cree automáticamente PI points por usted. Localizar dónde se encuentra referenciada una plantilla Consultar referencias de plantillas. Crear una plantilla de elementos Procedimiento 1. En el navegador, pulse con el botón secundario sobre la colección de plantillas de elementos y seleccione Nueva plantilla. 2. Ajuste valores en las pestañas 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 PI System Explorer Guía del usuario 65

76 Diseño e implementación de modelos de activos de PI AF Puede basar la plantilla en una plantilla existente. Seleccione la plantilla existente (base) en el campo. Tipo Elemento, límite, nodo, etc. Categorías Puede organizar objetos agrupándolos en categorías (opcional). Para examinar las categorías disponibles, haga clic en Categorías. Atributo predeterminado Haga clic en Atributo predeterminado Patrón de nombres Opcional: Haga clic en para seleccionar un atributo predeterminado (opcional). Consulte para seleccionar parámetros de sustitución y definir un patrón de nombres para que cada elemento derivado de la plantilla tenga un nombre único e identificable. (Es posible que algunos parámetros de sustitución no se apliquen cuando se crea un elemento derivado. Para asegurarse de que el nombre de un elemento derivado refleja plenamente el patrón de nombres, pulse con el botón secundario sobre el elemento y haga clic en Reevaluar el patrón de nombres.) Permitir extensiones Casilla de verificación para permitir realizar cambios en los elementos en función de esta plantillla; por ejemplo, añadir atributos. Véase 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 información almacenada en Propiedades ampliadas mediante programación con el PI AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta característica avanzada. 3. Utilice la pestaña Plantillas de atributos para crear una plantilla de atributos para cada propiedad o elemento de datos de la plantilla. Véase Asociación de datos con activos. 4. Utilice la pestaña Puertos para especificar puertos, que definen los puntos finales de las conexiones entre elementos dentro de un modelo. Véase Modelado de un proceso. 5. Guarde su trabajo. En esta sección Atributo predeterminado Plantillas base Extensiones Atributo predeterminado El atributo predeterminado es un atributo que utilizan las aplicaciones cliente para representar el elemento cuando no se ha especificado ningún atributo. El atributo debe estar en el nivel superior de la jerarquía de atributos del elemento. No se puede anidar en otro atributo. Seleccione el atributo que parezca el más representativo del elemento. Por ejemplo, si un 66 PI System Explorer Guía del usuario

77 Diseño e implementación de modelos de activos de PI AF usuario quisiera hacer referencia a un tanque, el mejor atributo individual para utilizar sería nivel. En el caso de un medidor eléctrico, 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, plantéese 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 válvulas y otros de una sola, puede crear una plantilla de elementos para los modelos de una sola válvula y utilizarla como plantilla base para los modelos de dos. Cuando cree objetos que se basen en el modelo de dos válvulas, tendrán todos los atributos del modelo de una sola válvula, además de cualquier atributo adicional que se haya definido en el modelo de dos válvulas. Extensiones Puede permitir que algunos atributos estén 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 mantendrán, pero no podrá añadir otras nuevas. La extensión ofrece flexibilidad en aquellos casos en los que los activos son similares en muchas áreas, pero hay muchas variaciones pequeñas. Por ejemplo, supongamos que crea una plantilla para un modelo de coche concreto. Todos los coches de este modelo tienen el mismo conjunto básico de características: cuatro ruedas, un volante, etc. Sin embargo, puede que un coche tenga un alerón donde otro no lo tiene. Uno puede tener aire acondicionado y otro, no. Las extensiones permiten tener en cuenta este tipo de variaciones. Las extensiones le permiten basar todos los elementos en una plantilla, al tiempo que añade información adicional para cada elemento. Si tiene muchos elementos que son similares a la definición de plantilla, pero todos necesitan los mismos atributos adicionales, tal vez resulte más útil una plantilla base que las ampliaciones. Nota: Si tiene una plantilla que admite extensiones y la modifica para no admitirlas, no se podrán añadir nuevos atributos de elemento extendidos a los elementos basados en esa plantilla. Sin embargo, todos los atributos de elemento extendidos se mantedrán. Configurar la generación automática de puntos Puede configurar una referencia de datos de PI point en una plantilla de atributos para que cree automáticamente PI points por usted. Procedimiento 1. Cree una plantilla de elementos en PI System Explorer. 2. Añada una plantilla de atributos nueva a la plantilla de elementos. 3. En el menú desplegable Referencia de datos, seleccione PI Point. PI System Explorer Guía del usuario 67

78 Diseño e implementación de modelos de activos de PI AF 4. Haga clic en Ajustes. Se mostrará el cuadro de diálogo 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 parámetros de sustitución para que PI AF cree automáticamente los nombres de punto para los puntos que genere. 6. Marque la casilla Creación de tag. 7. Haga clic en. Se abrirá la ventana Ajustes de creación 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 botón Importar para importar los valores de atributo de PI point de un punto existente. Se abrirá la ventana Búsqueda de tags. Puede utilizar parámetros de sustitución (por ejemplo, %Element%) con muchos valores de atributo. 8. Guarde su trabajo. 9. Cree un elemento a partir de su plantilla de elementos y haga clic en la pestaña Atributos. 10. Pulse con el botón 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 crearán 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 opción de creación 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 aparecerán como Pt. Created. Localizar dónde se encuentra referenciada una plantilla Seleccione la plantilla y haga clic en la pestaña General. Utilice los enlaces en la parte inferior de la pestaña: Haga clic en Plantillas derivadas para incluir todas las plantillas que tengan esta plantilla de elementos como plantilla base. La lista también incluye plantillas de elementos que se derivan indirectamente de esta plantilla, a través 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 específicamente con esta plantilla de elementos como primaria a través 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 específicamente a esta plantilla de elementos como secundarias mediante un tipo de referencia. La lista de plantillas incluye aquellas que se han vinculado indirectamente a través de una plantilla heredada. 68 PI System Explorer Guía del usuario

79 Diseño e implementación de modelos de activos de PI AF Definición de plantillas para otros objetos Además 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 basándolas 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 botón secundario sobre la colección de objetos y seleccione Nueva plantilla. 4. La nueva plantilla mostrará las siguientes pestañas: General Plantillas de atributos Puertos (no disponible para plantillas de marcos de evento) Plantillas de análisis (solo plantillas de elementos) Rellene estas pestañas igual que una plantilla de elementos. Véase Crear una plantilla de elementos. 5. Guarde su trabajo. Representación 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 cigüeñal. Desea que la plantilla del cigüeñal 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á también un tipo de referencia en la colección Tipos de referencia. Ahora, supongamos que desea crear un elemento basado en la plantilla Motor. PI System Explorer no crea de forma automática el elemento secundario, Cigüeñal. Sin embargo, cuando cree de forma manual un elemento secundario en el elemento motor, el tipo de referencia Motor-Cigüeñal de motor aparecerá en la lista de tipos de referencia y la plantilla Cigüeñal aparecerá en la lista Plantilla de elementos. PI System Explorer Guía del usuario 69

80 Diseño e implementación de modelos de activos de PI AF Crear una referencia de plantilla secundaria Procedimiento 1. En PI System Explorer, pulse el botón Biblioteca del panel del navegador. 2. Pulse con el botón secundario sobre la plantilla a la que desee añadir la referencia de plantilla secundaria y haga clic en Nueva plantilla referenciada. Se mostrará el cuadro de diálogo 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 colección Plantillas y un nuevo tipo de referencia en la colección Tipos de referencia. Uso de elementos para representar activos En el modelo de activos, los elementos representan objetos físicos, como las bombas o los tanques. Cada elemento tiene asociados atributos que almacenan propiedades y datos de ese elemento. Por lo general, base los elementos en plantillas. Por ejemplo, base cada elemento de bomba en una plantilla de bomba. En esta sección Crear un elemento a partir de una plantilla Crear un elemento sin tomar como base una plantilla Eliminación de elementos Restablecer las propiedades de plantilla para un elemento Cambiar elementos de plantilla o añadir una plantilla Crear un elemento a partir de una plantilla Procedimiento 1. En el navegador, haga clic con el botón secundario sobre la colección 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. 4. Haga clic en Aceptar. Las pestañas de propiedad de elemento aparecerán en el visor. Dado que el elemento se basa en una plantilla, la mayoría de los archivos de la pestaña General serán de solo lectura (atenuados o con almohadillas). Haga clic en el botón Atributos para ver los atributos definidos por la plantilla. No podrá añadir atributos nuevos salvo que la plantilla admita ampliaciones. 5. Escriba el nombre del elemento. 6. Guarde su trabajo. 70 PI System Explorer Guía del usuario

81 Diseño e implementación de modelos de activos de PI AF Localizar dónde se utiliza un elemento En el caso de los elementos seleccionados en el panel del navegador, los vínculos de la parte inferior de la pestaña General muestran información acerca de dónde y cómo 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 función de las aplicaciones complementarias que haya instalado, es posible que se muestren otros vínculos, 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 botón secundario sobre la colección 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 diálogo 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: principalsecundario. 4. Haga clic en Aceptar. Las pestañas de propiedad de elemento aparecen en el visor. Utilice la pestaña General para realizar la configuración básica del elemento. Utilice la pestaña Atributo para crear un atributo para cada propiedad o elemento de datos de la plantilla. Utilice la pestaña Puertos únicamente para modelar un proceso. La pestaña Elementos secundarios se utiliza fundamentalmente para ver los elementos secundarios de un elemento existente. También puede crear elementos secundarios directamente desde esta pestaña. PI System Explorer Guía del usuario 71

82 Diseño e implementación de modelos de activos de PI AF 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 información almacenada en Propiedades ampliadas mediante programación con el PI AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta característica avanzada. 5. Guarde su trabajo. Eliminación de elementos En PI AF 2.4 y posteriores, al eliminar un elemento, PI AF elimina de forma automática las notificaciones y los análisis que tienen como destino ese elemento. Si desea reasignar una notificación vinculada a un elemento que tiene previsto eliminar, hágalo antes de eliminar el elemento. También, puede cambiar el comportamiento predeterminado para que PI AF no elimine de forma automática las notificaciones y análisis cuando elimine el elemento de destino. Para realizar este cambio, utilice afdiag el programa de utilidad de línea de comandos con el parámetro /EnablePropagationOfTargetDeletion: afdiag /EnablePropagationOfTargetDeletion- Sin embargo, la desactivación del ajuste puede originar algunos problemas, como: Las notificaciones quedan abiertas (permanecen activas) No se crean notificaciones nuevas No se envían los correos electrónicos previstos Restablecer las propiedades de plantilla para un elemento Haga clic con el botón secundario sobre el atributo del elemento, seleccione Restablecer a plantilla y, a continuación, la opción 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 producción. Por ejemplo, supongamos que configura un atributo de PI AF para que utilice el nombre del PI Server como parte de la configuración 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 producción. Cambiar elementos de plantilla o añadir una plantilla Para cambiar la plantilla en la que se basa un marco de evento existente o para añadir una plantilla a un marco de evento que no base en una plantilla: Procedimiento 1. En PI System Explorer, pulse el botón Elementos en el panel del navegador. 2. En el navegador, haga clic con el botón 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. 72 PI System Explorer Guía del usuario

83 Diseño e implementación de modelos de activos de PI AF 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 otorgarán 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 específicos sobre objetos individuales. En esta sección Configurar permisos para objetos Configurar permisos para colecciones Configurar permisos para objetos Algunos objetos de PI AF tienen un conjunto de información de control de acceso asociado a ellos. Esta información 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 automática al crear el objeto AF. En el caso de los elementos secundarios, la seguridad del elemento principal se utiliza como seguridad predeterminada. En los demás objetos, la seguridad predeterminada es la seguridad de la colección. Nota: Los objetos de biblioteca incluyen categorías, plantillas, conjuntos de enumeración, 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 protección los siguientes objetos AF de nivel superior: PISystem AFContact AFCategory AFDatabase AFAnalysis AFAnalyisTemplate AFElement AFElementTemplate AFEnumerationSet AFReferenceType AFTable AFNotification AFNotificationContactTemplate UOMDatabase En esta sección Cómo 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 Configuración de permisos de acceso a objetos de AF Cuándo utilizar la opción Deny PI System Explorer Guía del usuario 73

84 Diseño e implementación de modelos de activos de PI AF Cómo 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 botón secundario sobre el objeto y seleccione Seguridad en el menú que aparece. Se mostrará el cuadro de diálogo de propiedades de los permisos para el objeto seleccionado. 2. Seleccione usuarios y configure permisos según necesite. Los permisos se definen en Configuración 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 también. El comportamiento depende del tipo de referencia. Tipo de referencia Débil Composición Principal-secundario Descripción Los permisos de acceso no se heredan nunca. 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 automáticamente 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 automáticamente para coincidir con los permisos del principal. Estos cambios se aplican en cascada en sentido descendente (y ascendente) en la totalidad de la jerarquía. 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 fácilmente reconocibles: tienen referencias fuertes a su elemento principal y son propiedad del elemento principal. Muestran el icono de elemento estándar en la jerarquía. Los elementos secundarios que tienen una referencia fuerte al elemento principal, pero son propiedad de otro elemento, no están en la ruta principal. Estos elementos secundarios tienen una flecha de referencia en el icono de elemento estándar, que deja claro que no están 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 vínculo Primarios en PI System Explorer. El objeto principal primario tiene una marca de verificación en su icono. 74 PI System Explorer Guía del usuario

85 Diseño e implementación de modelos de activos de PI AF Procedimiento 1. En el navegador, pulse con el botón secundario sobre el objeto cuyos permisos heredados desee modificar y seleccione la opción Seguridad en el menú. 2. En la ventana Permisos de <Objeto>, haga clic en Opciones avanzadas. 3. En la ventana Configuración 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 Configuración 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 más antiguo, la frase de esta casilla puede ser algo distinta, pero el efecto es el mismo. 5. Haga clic en Aceptar. 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 creación, 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 basarán en el elemento de seguridad del marco de evento asociado con la base de datos de PI AF actual. Cuando se añade un marco de evento secundario a un marco de evento existente, los permisos de acceso del marco de evento secundario se asignan en función 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 fácilmente 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 estándar en la jerarquía. Los marcos de evento secundarios que tienen una referencia fuerte al marco de evento principal, pero son propiedad de otro marco de evento, no están en la ruta principal. Estos marcos de evento PI System Explorer Guía del usuario 75

86 Diseño e implementación de modelos de activos de PI AF secundarios tienen una flecha de referencia en el icono de marco de evento estándar, que deja claro que no están en la ruta principal. Transferencia Cuando se crea una transferencia, sus permisos de acceso se asignan en función 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 función del elemento de seguridad de transferencia asociado con la base de datos de PI AF actual. Modificación 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 parámetro applytochildren enafsecurity.setaccesscontrol Method en un objeto de marco de evento. En PI System Explorer Browser, pulse con el botón 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 botón 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 configuración de seguridad. Seguridad de objetos de base de datos El permiso de escritura de una base de datos de AF se aplica automáticamente a cada objeto de la base de datos. Esto proporciona un mecanismo más 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. 76 PI System Explorer Guía del usuario

87 Diseño e implementación de modelos de activos de PI AF Configuración de permisos de acceso a objetos de AF Permiso Leer Escribir Eliminar Admin Leer datos Escribir datos Ejecutar Suscribir Suscibir a otros Definición Capacidad de leer o consultar el objeto. Sin este permiso, no es posible obtener el objeto. Capacidad de crear y modificar un objeto. La excepción 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 análisis en el que están contenidos. Asimismo, si los usuarios no tienen el permiso Escribir en la base de datos de AF, no podrán modificar ningún objeto en la base de datos, independientemente del permiso específico que tengan para ese objeto. Capacidad para eliminar un objeto. Capacidad para modificar los valores de seguridad, o el propietario, de un objeto. Capacidad para leer valores que no son de configuración 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 análisis específico. Capacidad para escribir valores que no son de configuración 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 análisis específico. Capacidad para ejecutar casos de análisis. Capacidad para suscribirse uno mismo a notificaciones o anular la suscripción. Capacidad para suscribir a otros a notificaciones o anular la suscripción. Cuándo utilizar la opción Deny Seleccione la opción 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 opción Deny. Si utiliza PI MDB y PI AF, evite la opción Deny para evitar problemas de sincronización. PI System Explorer Guía del usuario 77

88 Diseño e implementación de modelos de activos de PI AF Configurar permisos para colecciones Puede asignar permisos de acceso predeterminados para cada tipo de colección 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 colección: Controlan si un usuario dispone de permiso para crear objetos en la colección Se utilizan como permisos de acceso predeterminados para los objetos creados en la colección. Procedimiento 1. Abra PI System Explorer y pulse el botón Biblioteca en el panel del navegador. 2. Pulse con el botón secundario en la base de datos de PI AF (el objeto raíz del navegador), seleccione Seguridad y, a continuación, el tipo de colección deseado. Se mostrará la ventana Permisos. 3. Configure los permisos correspondientes a la colección. 4. Para configurar los permisos de los miembros existentes de una colección, haga clic en Avanzado. Se mostrará la ventana Configuración 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 descripción se encuentra en Configurar permisos para objetos. Asociación 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 información fija, como el diámetro de un tanque. También pueden incluir valores procedentes de PI Points, derivarse de fórmulas 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 continuación, cuando cree elementos basados en esa plantilla, PI AF creará automáticamente 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 enumeración. Un conjunto de enumeración 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 sección Crear una plantilla de atributos Trabajo con conjuntos de enumeración Definición de valores de atributos de constante Configuración de referencias de datos 78 PI System Explorer Guía del usuario

89 Diseño e implementación de modelos de activos de PI AF Crear una plantilla de atributos Procedimiento 1. Seleccione la plantilla de elementos en el navegador y haga clic en la pestaña Plantillas de atributos del visor. 2. Pulse con el botón 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 configuración, según resulte necesario. Los campos incluyen elementos de configuración, elementos indexados, categorías y unidades de medida. Para obtener más información, consulte Atributos de configuración, Atributos indexados, Categorías 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 números, cadenas, archivos, fechashoras, booleanos, URLs, matrices, etc. Nota: Aunque es un valor válido, no se recomienda utilizar el tipo de valor Cualquiera. En el caso de fórmulas, 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 Configuración de referencias de datos para obtener información sobre la configuración de diferentes tipos de referencias de datos. 6. (Opcional) Introduzca un valor predeterminado para el atributo en el campo Valor predeterminado. 7. Guarde su trabajo. Qué hacer a continuación Si crea un atributo tomando como base una plantilla, tendrá que configurar el valor: En el caso de los valores de constantes, añada el valor al atributo directamente. Consulte Definición 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 botón secundario sobre el elemento y seleccione Crear o actualizar referencia de datos. Para obtener más información, consulte Crear o actualizar referencias de datos. Nota: La configuración del atributo puede en algunos casos limitar cómo se verán los datos en las aplicaciones cliente, como PI ProcessBook o PI Coresight. Consulte Restricciones de visualización de los datos de serie temporal para obtener más información. PI System Explorer Guía del usuario 79

90 Diseño e implementación de modelos de activos de PI AF Añadir un atributo a un elemento En algunas ocasiones, es posible que desee añadir 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á añadir atributos nuevos. Procedimiento 1. Seleccione el elemento en el navegador y haga clic en la pestaña Atributos del visor. 2. Pulse con el botón 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 configuración determinará los valores que puede introducir en el campo Valor. Los valores de atributos de constante pueden ser números, cadenas, archivos, fechashoras, booleanos, URLs, matrices, etc. Nota: Aunque está admitido, no se recomienda utilizar el tipo de valor Cualquiera. También puede introducir un valor predeterminado para el atributo en el campo Valor predeterminado. En el caso de fórmulas, 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 Configuración de referencias de datos para obtener información sobre la configuración de diferentes tipos de referencias de datos. 4. Defina los demás campos de configuración, según resulte necesario. Los campos incluyen elementos de configuración, elementos indexados, categorías y unidades de medida. Para obtener más información, consulte Atributos de configuración, Atributos indexados, Categorías y Unidades de medida (UOM). 5. Guarde su trabajo. Trabajo con conjuntos de enumeración Los conjuntos de enumeración 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 número de modelo de una pieza de equipo. Puede crear un conjunto de enumeración que contenga todos los números del modelo correspondientes. Cuando cree un elemento con la plantilla, simplemente seleccione en la lista el número de modelo correspondiente. 80 PI System Explorer Guía del usuario

91 Diseño e implementación de modelos de activos de PI AF Crear un conjunto de enumeración Procedimiento 1. En el navegador, pulse con el botón secundario sobre la colección de conjuntos de enumeración y seleccione Nuevo conjunto de enumeración. En el visor se mostrará la pestaña de configuración de propiedades General del conjunto de enumeración. 2. Configure las siguientes propiedades: En el campo Nombre, introduzca el nombre del conjunto. En el campo Descripción, introduzca una descripción del conjunto (opcional). Seleccione la casilla de verificación Hexadecimal para los valores hexadecimales. 3. Introduzca valores y nombres y una descripción opcional de cada miembro del conjunto de enumeración. El nombre es una cadena exclusiva que describe la condición o el estado representados. El nombre es el procedimiento preferido para acceder a una enumeración. El valor es un valor numérico exclusivo que está también asociado con la enumeración. Se utiliza para proporcionar una representación más rápida y que requieremenos memoria de un valor de la enumeración. Volver a numerar un conjunto de enumeración Procedimiento 1. Pulse con el botón secundario en cualquier lugar del campo y seleccione Renumerar valores de enumeración. Se mostrará el cuadro de diálogo Renumerar valores de enumeración. 2. Introduzca el valor inicial y un incremento. PI System Explorer Guía del usuario 81

92 Diseño e implementación de modelos de activos de PI AF Nota: Si selecciona una fila antes de la renumeración, 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 modificarán durante una acción de renumeración. Si la renumeración no se inicia en la fila que está más arriba, existe la posibilidad de que los valores generados sean idénticos a los que están 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. Definición 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 más información sobre cómo 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 básicos Tipos de matriz Una matriz contiene cualquiera de los tipos básicos como elementos. Conjuntos de enumeración Un conjunto de enumeración es una lista de valores de constante definidos por el usuario. Los conjuntos de enumeración 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 opción de menú Conjuntos de enumeración permite seleccionar cualquiera de los conjuntos de enumeración 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 varía según el Tipo de valor. 3. Configure el valor del atributo como se describe en el procedimiento correspondiente al tipo de atributo. En esta sección Configurar un valor básico Configurar un valor de matriz Configuración de un valor de conjunto de enumeración Configurar un valor de objeto Configurar un valor básico Una vez haya configurado Tipo de valor en uno de los tipos de datos básicos, podrá definir el valor del atributo. 82 PI System Explorer Guía del usuario

93 Diseño e implementación de modelos de activos de PI AF Procedimiento 1. Haga clic en el campo Valor. El formato del campo cambia según el tipo de valor: Tipo de valor Boolean Byte DateTime Double Guid Intnn Sencillo String Formato de valor de campo Alternancia entre Verdadero y Falso Campo de entrada de enteros positivos Selector de fecha y hora Campo de entrada de numérico de coma flotante Máscara del GUID Campo de entrada de enteros Campo de entrada de numérico de coma flotante 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 envía el valor resultante a PI AF. Por ejemplo, para DateTime, envía 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 válidas: *-5d May 12, :00:00 AM :00:00 Para crear un atributo con un vínculos como valor, seleccione el tipo de valor String e introduzca la dirección URL como valor de atributo. Las cadenas reconocidas como direcciones URL absolutas se mostrarán como un enlace. Por ejemplo, las cadenas que empiezan por 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 vínculos se muestran subrayados y con una información 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 botón en el extremo derecho del campo Valor. 2. Haga clic en. En el cuadro de diálogo Matriz, defina la matriz. El campo Valor se configurará con el formato correspondiente al tipo de datos que seleccione para los elementos de matriz. Tipo de valor Boolean Byte DateTime Double Guid Formato de valor de campo Alternancia entre Verdadero y Falso Campo de entrada de enteros positivos Selector de fecha y hora Campo de entrada de numérico de coma flotante Máscara del GUID PI System Explorer Guía del usuario 83

94 Diseño e implementación de modelos de activos de PI AF Intnn Sencillo Cadena Campo de entrada de enteros Campo de entrada de numérico de coma flotante Campo de entrada de texto 3. Haga clic en Aceptar. PI System Explorer resuelve los datos que ha introducido al guardar los cambios y envía los valores de matriz resultantes a PI AF. Configuración de un valor de conjunto de enumeración Si selecciona un conjunto de enumeración 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 enumeración. 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 botón de acción situado a la derecha cambia según el tipo de valor: Tipo de valor <Cualquiera> Atributo Elemento Archivo Formato de valor de campo Aunque es un valor válido, no se recomienda utilizar el tipo de valor Cualquiera. Un botón Explorar que abre Búsqueda de atributos Un botón Explorar que abre Navegador de elementos 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 atención al cargar los archivos Si especifica el Tipo de valor Archivo antes de cargar un archivo, ejecute un análisis antivirus para asegurarse de que el tamaño del archivo no sobrepase el espacio de almacenamiento. Algunos tipos de archivo pueden plantear problemas de seguridad. Aparecerá un mensaje de aviso preguntándole 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. Configuración de referencias de datos Puede configurar un atributo o una plantilla de atributos para obtener valores de orígenes especificados. Esta configuración 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 orígenes: 84 PI System Explorer Guía del usuario

95 Diseño e implementación de modelos de activos de PI AF 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. Fórmula El valor de atributo es el resultado de un cálculo. El cálculo puede contener atributos e incluso atributos de referencia de datos. Búsqueda 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 parámetros de sustitución y funciones para manipular los valores y generar una cadena. En esta sección Crear y hacer referencia a cálculos 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 parámetros en referencias de datos Crear y hacer referencia a cálculos Utilice la referencia de datos de fórmula para crear un cálculo personalizado. Este cálculo puede ser una fórmula o una secuencia de cálculos. La referencia de datos de fórmula puede tener varios atributos de entrada. En esta sección Configurar una referencia de datos de fórmula Definir parámetros Definir la ecuación Unidades de medida en referencias de datos de fórmula Configurar una referencia de datos de fórmula Procedimiento 1. Seleccione el atributo en el visor. 2. En el menú desplegable Referencia de datos, seleccione Fórmula. 3. Haga clic en el botón Ajustes. Se mostrará la ventana de configuración de referencias de datos de fórmula. PI System Explorer Guía del usuario 85

96 Diseño e implementación de modelos de activos de PI AF 4. Si la ecuación requiere un valor de atributo, haga clic en para añadirlo como parámetro (Definir parámetros). 5. Seleccione la casilla Valores predeterminados admitidos para que PI AF pueda utilizar valores predeterminados de atributo en el cálculo. Los valores predeterminados se especifican en la plantilla de atributos. Si anula la selección de la casilla de verificación, el cálculo no se realizará si no están disponibles los datos de uno o más atributos. 6. Haga clic en para comenzar a definir la ecuación (Definir la ecuación). 7. En el campo Unidad de medida, especifique la unidad de medida del resultado de la fórmula o de la secuencia de cálculo (Unidades de medida en referencias de datos de fórmula). 8. En el campo Mínimo, introduzca un valor adecuado para el valor de devolución mínimo. Si el valor calculado es inferior a este mínimo, la referencia de datos devolverá el valor mínimo que especifique. Si no existe un valor mínimo para este cálculo, deje el campo Mínimo en blanco. 9. En el campo Máximo, introduzca un valor adecuado para el valor de devolución máximo. Si el valor calculado es superior a este máximo, la referencia de datos devolverá el valor máximo que especifique. Si no existe un valor máximo para este cálculo, deje el campo Máximo 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 cálculo aparece en el campo adyacente. Cuando la referencia de datos de fórmula se configura con un atributo de plantilla, el cálculo utiliza los valores predeterminados de los atributos de plantilla. Cuando la configuración se realiza con un atributo de elemento, se utilizan los datos reales en el cálculo. 11. Haga clic en Aceptar. 12. Configure el resto de valores de atributo como lo haría con cualquier otro atributo. Nota: La referencia de datos de fórmula no admite cadenas ni otros tipos de valor no numérico. Definir parámetros Si la ecuación requiere un valor de atributo, tendrá que añadir ese atributo como parámetro en el cuadro de diálogo Configuración de fórmula. Procedimiento 1. Haga clic en junto al campo Parámetros. Aparecerá la ventana Configuración de parámetros. Nota: También, puede hacer clic en una fila vacía e introducir una variable (a -z). 2. Seleccione una variable en el menú Variable. El número de variables disponible se limita a 26 caracteres (de la A a la Z). 3. Seleccione el atributo que la variable representa. 86 PI System Explorer Guía del usuario

97 Diseño e implementación de modelos de activos de PI AF Seleccione el atributo en el menú Atributo. En la lista se mostrarán 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. También, 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 fórmula requiere para esta entrada (Unidades de medida en referencias de datos de fórmula). Por ejemplo, si el atributo de entrada tiene Celsius como unidad de medida pero la ecuación requiere Fahrenheit, deberá seleccionar Fahrenheit en este campo. Definir la ecuación Para definir la ecuación en una referencia de datos de fórmula: Procedimiento 1. Haga clic en junto al campo Ecuaciones. También puede hacer clic en el área de texto y escribir una ecuación. Se mostrará el botón. 2. Escriba la ecuación o haga clic en para seleccionar variables, operadores y funciones de un menú. Los operadores válidos y las funciones aparecen listados en Operadores de referencias de datos de fórmula y Funciones de referencia de datos de fórmula. Haga clic en para eliminar la ecuación seleccionada de la secuencia de cálculo. Haga clic en para eliminar tiodas las ecuaciones de la secuencia de cálculo. Haga clic en o para subir o bajar una ecuación en la secuencia de cálculo. En esta sección Operadores de referencias de datos de fórmula Funciones de referencia de datos de fórmula Operadores de referencias de datos de fórmula Los operadores válidos ordenados jerárquicamente son: Parenthesis Unary Minus ^ * / mod + - < > <= >= == <> NOT AND OR No se puede utilizar el operador de asignaciones = al comienzo de una fórmula. PI System Explorer Guía del usuario 87

98 Diseño e implementación de modelos de activos de PI AF Nota: Las sintaxis de referencia de datos de fórmula utiliza == (dos signos de igual) para indicar la igualdad y = (un solo signo de igual) para la asignación. La sintaxis de análisis (y la ecuación de rendimiento) utiliza = para indicar igualdad y := para la asignación. 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 fórmula Función Descripción 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 número (NaN) o no es un valor numérico; de lo contrario, devuelve 0. ceiling(x) Entero más pequeño no inferior a X. cos(x) Coseno de X. cosh(x) Coseno hiperbólico de X. cot(x) Cotangente de X. coth(x) Cotangente hiperbólica de X. csc(x) Cosecante de X. csch(x) Cosecante hiperbólica de X. e() exp(x) Valor del logaritmo base natural. Logaritmo base natural e elevado a la potencia de X. floor(x) Entero más 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) pi() poisson(x) Número aleatorio que asigna la curva de distribución normal. X es la media e Y es la desviación estándar. Valor de pi. Valor aleatorio que asigna la distribución de Poisson. X es la media. pow(x,y) X elevado a la potencia de Y. rand() rand(x,y) Número aleatorio uniforme. Los valores pueden estar entre 0 y menos de 1.0 Número aleatorio uniforme. Los valores pueden estar entre X-Y/2 y menos de X+Y/2. 88 PI System Explorer Guía del usuario

99 Diseño e implementación de modelos de activos de PI AF Función Descripción remainder(x,y) Devuelve el resto de la división de X por Y. round(x) roundfrac(x,y) sec(x) Secante de X. X redondeado al valor entero más cercano. X redondeado al número de dígitos fraccionarios especificados por Y. Y es un número entero. sech(x) Secante hiperbólica de X. sign(x) sin(x) Seno de X. sinh(x) Seno hiperbólico de X. sqrt(x) Raíz cuadrada de X. tan(x) Tangente X. Devuelve 1 si X es mayor que cero y -1 si X es menor que cero. tanh(x) Tangente hiperbólica de X. Unidades de medida en referencias de datos de fórmula Cuando trabaje con fórmulas y unidades de medida, tendrá que configurar las entradas y salidas de las ecuaciones con la unidad de medida correcta. Para los atributos de la ecuación, utilice la unidad de medida que la fórmula espera (NO las unidades en las que está el atributo). Para el resultado del cálculo, 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, plantéese la siguiente configuración de fórmula para convertir el volumen y la densidad en masa: V=Volume;UOM=L;D=Density;UOM=kg/L;[V*D];UOM=kg Las unidades de medida de las entradas y salidas son coherentes. (L*kg/L = kg). Esta fórmula funciona con cualquier atributo de entrada y de salida, independientemente de la unidad de medida del atributo, siempre y cuando tengan especificada una unidad de medida de la clase correcta. 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 podría ser igual que el valor de punto o el resultado de un cálculo 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 características extra. Al crear una referencia de datos de PI point en una plantilla de atributos, podrá: PI System Explorer Guía del usuario 89

100 Diseño e implementación de modelos de activos de PI AF Crear de forma automática 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 sección Configuración de los pasos básicos de las referencias de datos de PI points Especificación del PI point Configuración 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 Configuración de los pasos básicos 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 Búsqueda de tags en la paleta para crear y configurar de forma rápida nuevos atributos de referencia de datos de PI point. Para obtener más información, consulte Acción 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 botón Ajustes. Se mostrará la ventana de configuración 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 Especificación del PI point b. Especifique cómo obtendrá su valor el atributo. Por ejemplo, el valor de atributo podría ser igual que el valor de punto o el resultado de un cálculo sobre el valor de punto. Véase Configuración de valores de atributo. c. Especifique las unidades que utiliza el PI point referenciado (opcional). Véase Consideraciones relativas a las unidades de medida. d. Utilice la casilla de verificación 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 verificación Solo lectura está seleccionada). Consulte Permitir que los atributos escriban en los valores de punto 90 PI System Explorer Guía del usuario

101 Diseño e implementación de modelos de activos de PI AF Ubicación de la casilla de verificación Solo lectura en la esquina inferior izquierda Acción de arrastrar desde la Paleta para crear referencias de datos de PI points Puede arrastrar un tag desde los resultados de Búsqueda de tags en la Paleta para crear una referencia de datos de PI point. Cuando cree un atributo arrástrelo al campo Ajustes para configurar el atributo como una referencia de datos de PI point basada en el tag. También, 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 navegación y seleccione su pestaña Atributos en el visor. 3. Seleccione Ver > Paleta > Búsqueda de tags y localice los tags que desea utilizar. 4. Realice una de las siguientes acciones: Arrastre un tag desde los resultados de búsqueda a la lista Atributos. Se añadirá 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 búsqueda 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. Especificación 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. PI System Explorer Guía del usuario 91

102 Diseño e implementación de modelos de activos de PI AF En esta sección Crear una referencia a un PI Server y a un nombre de punto Referencias de atributo (referencias indirectas) Crear una referencia a través de un atributo Crear una referencia a un PI Server y a un nombre de punto La forma más 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 opción 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 añadir el PI Server. Para obtener instrucciones, pulse el botón Ayuda situado en la parte superior del cuadro de diálogo. 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 parámetros de sustitución En el caso de las plantillas de atributos, puede utilizar parámetros de sustitución en los campos PI Server y Nombre de tag. Véase Lista de parámetros de sustitución de PI AF. 92 PI System Explorer Guía del usuario

103 Diseño e implementación de modelos de activos de PI AF Referencias de atributo (referencias indirectas) Puede configurar una referencia de datos de PI points para señalar 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 máximo y mínimo 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 través de un atributo Procedimiento 1. En la ventana Referencia de datos de PI Point, seleccione la opción 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. PI System Explorer Guía del usuario 93

104 Diseño e implementación de modelos de activos de PI AF Nota: No podrá hacer referencia a un atributo que no haga referencia a un PI point. Configuración de valores de atributo Las aplicaciones cliente solicitan valores de atributo para una hora concreta o un intervalo de tiempo. Por ejemplo, en PI ProcessBook, la pantalla puede proporcionar también un contexto de intervalo de tiempo (en la pantalla debe estar presente un símbolo de intervalo de tiempo, como por ejemplo una tendencia, para permitir la recepción 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 específica. Véase Configurar la obtención de valores por hora. El resultado de un cálculo de los valores del punto a lo largo de un intervalo de tiempo. Véase Configurar la obtención de valores por intervalo de tiempo. Por ejemplo, el valor de atributo puede ser el promedio de los valores de punto a lo largo de una hora. En esta sección Configurar la obtención de valores por hora Configurar la obtención de valores por intervalo de tiempo Configurar la obtención de valores por hora Las solicitudes de un valor de atributo por parte de las aplicaciones cliente incluyen una hora. Especifique cómo debe interpretarse esa hora para obtener los valores del atributo. Procedimiento 1. Seleccione una opción en el menú desplegable Por tiempo. 94 PI System Explorer Guía del usuario

105 Diseño e implementación de modelos de activos de PI AF Después Devuelve el primer valor registrado después de la hora solicitada por la aplicación cliente. En o Antes Seleccione esta opción para devolver un valor registrado en la hora de la solicitud de la aplicación cliente. Si no existe ningún valor en la hora especificada, se devuelve el valor registrado anterior. En o Después Seleccione esta opción para devolver un valor registrado en la hora de la solicitud de la aplicación cliente. Si no existe ningún valor a la hora especificada, se devuelve el siguiente valor registrado. Automático Seleccione esta opción 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 aplicación cliente. Hora exacta Seleccione esta opción para devolver un valor registrado justo en la hora de la solicitud de la aplicación cliente. Si no existe ningún valor registrado para esa hora, se devuelve un error. Interpolado Seleccione esta opción para devolver un valor interpolado para la hora de la solicitud de la aplicación 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 cálculos de intervalos de tiempo. 2. Deje la casilla de verificación Tiempo relativo sin seleccionar, excepto si desea Configurar un retardo. 3. En el menú desplegable Por intervalo tiempo, seleccione Hora de finalización. Si la aplicación cliente envía un intervalo de tiempo en lugar de una hora concreta, PI AF devolverá un mensaje de error como valor de atributo. 4. Haga clic en Aceptar. 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 Recuperación de valor paraconfigurar la obtención de valores por hora. 2. En el recuadro Tiempo relativo, introduzca el tiempo relativo del retardo. Utilice una expresión de tiempo relativa. Véase Tiempo relativo. PI System Explorer Guía del usuario 95

106 Diseño e implementación de modelos de activos de PI AF Nota: Puede utilizar parámetros de sustitución para leer el tiempo relativo a partir del valor de otro atributo. Véase Referenciar un valor de atributo. 3. Haga clic en Aceptar. Configurar la obtención de valores por intervalo de tiempo Si desea que el valor de atributo sea el resultado de un cálculo resumido a lo largo de un período de tiempo, configure la obtención de valores por intervalo de tiempo. Procedimiento 1. Seleccione una de estas opciones en el menú desplegable Por tiempo. No admitido Si la aplicación cliente envía 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 aplicación cliente envía una hora, en lugar de un intervalo de tiempo. Si selecciona esta opción, debe escribir una expresión de tiempo relativa de PI en el campo Tiempo relativo. Consulte Creación de un intervalo de tiempo predeterminado para obtener más detalles. Anular intervalo de tiempo Especifique el intervalo de tiempo que sustituirá siempre al intervalo de tiempo especificado por la aplicación cliente. Puede especificar una duración fija para el rango (Crear un intervalo de duración configurable) o calcular la duración de forma dinámica (Configurar cálculos de intervalos de tiempo dinámicos). 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 cálculo 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 cálculo una de las opciones ponderadas en tiempo, el valor de Recuento representará la suma de la duración 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. Máximo El valor máximo a lo largo del intervalo de tiempo. Mínimo El valor mínimo a lo largo del intervalo de tiempo. Desviación estándar de población Seleccione la desviación estándar de la población a lo largo del intervalo de tiempo. Desviación estándar Seleccione la desviación estándar a lo largo del intervalo de tiempo. Hora de inicio 96 PI System Explorer Guía del usuario

107 Devuelve el valor de la hora de inicio del intervalo de tiempo. Nota: Si selecciona Hora de inicio, no podrá elegir la opción 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 finalización 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 cálculo está activo, seleccione una de estas opciones: Ponderado a evento Seleccione esta opción para evaluar valores con una ponderación equivalente para cada evento. No se realiza ninguna interpolación. Para que el cálculo sea correcto, deben haber como mínimo un evento dentro del intervalo de tiempo. Se necesitan dos eventos para calcular la desviación estándar. Ponderado en tiempo Seleccione esta opción para ponderar los valores del cálculo a lo largo del intervalo durante el cual se aplican. La interpolación se basa en el atributo step del punto. Los eventos interpolados se generan en los límites si es necesario. Nota: Si selecciona la opción 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 opción para aplicar la ponderación como en Ponderado en tiempo, pero realizar todas las interpolaciones entre valores como si representaran datos continuos (interpolación estándar), independientemente del atributo step del punto. Nota: Si selecciona la opción 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 opción para aplicar la ponderación 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: Diseño e implementación de modelos de activos de PI AF Si selecciona la opción 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. PI System Explorer Guía del usuario 97

108 Diseño e implementación de modelos de activos de PI AF 4. En el campo Mín porcent. correcto, introduzca un valor entre 0 y 100. Este porcentaje representa el intervalo de tiempo mínimo durante el cual un valor debe ser correcto para devolver un valor de resumen. 5. Haga clic en Aceptar. En esta sección Intervalos de tiempo para marcos de evento y transferencias Crear un intervalo de duración configurable Configurar cálculos de intervalos de tiempo dinámicos Creación 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 aplicación que realiza una llamada solicita un valor a un atributo, el valor devuelto dependerá de la referencia de datos y de su configuración: Si la aplicación que realiza la llamada no proporciona ningún 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 opción 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 opción de tiempo predeterminada, PI AF devuelve el valor del punto a la hora de finalización del marco de evento. Si la aplicación 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 aplicación que realiza la llamada proporciona un intervalo de tiempo, PI AF utiliza la intersección del intervalo de tiempo proporcionado y el del marco de evento. Si no hay ninguna intersección, se devolverá un evento de "Sin datos". El área sombreada de la ilustración que figura a continuación muestra la intersección 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 opción de resumen de intervalo de tiempo, el resumen se realizará a lo largo de esta intersección. Si el atributo contiene un PI point configurado solo con la opción de tiempo predeterminada, el valor se devolverá a la hora de inicio de la intersección. 98 PI System Explorer Guía del usuario

109 Diseño e implementación de modelos de activos de PI AF Crear un intervalo de duración configurable Para garantizar que el intervalo de tiempo tenga siempre la misma duración, puede configurar una anulación de intervalo de tiempo. Por ejemplo, para crear una media acumulada de una hora, tendría 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 expresión de tiempo relativa de PI (Tiempo relativo). AF creará un intervalo de tiempo en función de la hora de finalización suministrada por la aplicación cliente y el desplazamiento definido por el tiempo relativo, Nota: Puede utilizar parámetros de sustitución para leer el tiempo relativo a partir del valor de otro atributo. (Referenciar un valor de atributo). En este caso, PI AF evalúa el valor del atributo referenciado en el momento de cada solicitud de datos. Por ejemplo, para crear una media acumulada de una hora, tendría 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 configuración, la referencia de datos siempre calcula una media de una hora, incluso aunque la aplicación cliente especifique un intervalo de tiempo diferente. PI System Explorer Guía del usuario 99

110 Diseño e implementación de modelos de activos de PI AF Configurar cálculos de intervalos de tiempo dinámicos Puede utilizar un atributo de AF para calcular el intervalo de tiempo en función de factores variables Los valores de atributo deben ser tiempos relativos de PI válidos (Tiempo relativo). Puede utilizar posteriormente el valor de atributo para determinar el intervalo de tiempo de forma dinámica. Procedimiento 1. Configure un atributo para generar tiempos relativos de PI. El atributo puede hacer referencia a un conjunto de enumeración que contenga tiempos relativos de PI o puede crear tiempos relativos de PI en función de un cálculo. 2. Utilice la siguiente recuperación 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 método de cálculo.. Resultados Con esta configuración, la referencia de datos utiliza el tiempo relativo calculado como un desplazamiento de tiempo que determina el intervalo de tiempo. Consulte Ejemplo de hora de finalización variable para ver un ejemplo paso a paso. En esta sección Ejemplo de hora de finalización variable Tiempo relativo Ejemplo de hora de finalización variable En este ejemplo, se crea una referencia de datos con una hora de finalización variable. Procedimiento 1. Cree un conjunto de enumeración, MyEnumSet, que contenga estos tres valores: -30m -1h -2h 100 PI System Explorer Guía del usuario

111 Diseño e implementación de modelos de activos de PI AF 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 enumeración > 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 numérico. 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 cálculo. PI System Explorer Guía del usuario 101

112 Diseño e implementación de modelos de activos de PI AF Tiempo relativo Las expresiones de tiempo relativo son expresiones que tienen un número de días (d), horas (h), minutos (m) o segundos (s) especificado con un signo más (+) 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 día y medio. Todos estos son tiempos relativos válidos: +1d -24h -3.25m +24s Las expresiones de tiempo relativo pueden incluir solo un operador: + o -. Por ejemplo, esta expresión no es válida: -1d+1h Creación 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 aplicación 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 más información. Para crear un intervalo de tiempo predeterminado, utilice la siguiente configuración de recuperación de valores: En el menú desplegable Por tiempo, seleccione Intervalo de tiempo. En el campo Tiempo relativo, escriba una expresión de tiempo relativo de PI (Tiempo relativo). AF creará un intervalo de tiempo en función de la hora especificada por la aplicación cliente y el desplazamiento definido por el tiempo relativo. Nota: Puede utilizar parámetros de sustitución para leer el tiempo relativo del valor de otro atributo (Referenciar un valor de atributo). Por ejemplo, una métrica de totalización requiere un intervalo de tiempo para proporcionar un valor total. Si la aplicación cliente envía 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: 102 PI System Explorer Guía del usuario

113 -1h En el menú desplegable Por intervalo tiempo, seleccione Total. Diseño e implementación de modelos de activos de PI AF 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 automática 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 diálogo de configuración Referencia de datos de PI Point, la casilla de verificación Solo lectura determina si el atributo puede escribir datos en el PI point referenciado. La casilla 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 cálculo o de un análisis, podrá actualizar el PI point con el resultado de ese análisis. En este caso, debe anular la selección 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 automática las referencias de datos de PI points asociadas con ese elemento. Para crear las referencias de datos, pulse con el botón 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 parámetros de sustitución 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 propagarán a los elementos basados en esa plantilla. PI AF no vuelve a evaluar los parámetros de sustitución excepto si se actualiza la referencia de datos. Nota: La única excepción es una referencia de valor de atributo en el campo Tiempo relativo. Tras el bloqueo, puede pulsar con el botón secundario sobre el atributo del elemento y seleccionar Restablecer a plantilla, seguido de la opción 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 opción Crear o actualizar referencia de datos. También se muestra un indicador visual cuando PI System Explorer Guía del usuario 103

114 Diseño e implementación de modelos de activos de PI AF la configuración de un atributo deja de ser correcta; por ejemplo, después de cambiar un nombre de servidor o de tag. Los siguientes indicadores visuales están disponibles para la opción Crear o actualizar referencia de datos: Icono Descripción El atributo se asocia con una plantilla que contiene reglas de creación de puntos. Utilice la opción Crear o actualizar PI points para crear la configuración de tags en función de la plantilla. Asimismo, se resuelven el nombre y el ID del punto. La configuración 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 opción Crear o actualizar PI points para actualizar la configuración. El atributo es un elemento de configuración. Consulte Atributos de configuración para obtener más información. Nota: La opción Crear o actualizar referencia de datos no es aplicable a los atributos de configuración. Cuando revise los atributos de elemento en la pestaña Atributos, la primera entrada de la columna a la izquierda del nombre de un atributo de referencia de datos indica si puede ejecutar la opción Crear o actualizar referencia de datos. Inicie la opción Crear o actualizar referencia de datos haciendo clic con el botón derecho del ratón sobre un elemento o un atributo y seleccionando Crear o actualizar referencia de datos. La operación Crear o actualizar referencia de datos actualiza una referencia de datos de PI point con cualquier cambio que se haya producido en el PI point; los parámetros de sustitución se resuelven y los ID de servidor y de punto se actualizan. Si el PI point no existe todavía, y la configuración contiene una opción de creación de punto, se crea. Ejemplo de actualización de atributo Cuando el indicador se muestre con un atributo, podrá actualizar su configuración pulsando con el botón derecho del ratón y seleccionando la opción Crear o actualizar PI points. Nota: El icono no determina por anticipado si se producirá algún cambio en el tag o en su configuración. Indicador de atributo con información sobre herramientas Como indica la información sobre herramientas de más arriba, cuando actualice la configuración, las reglas de sustitución del nombre de punto se resolverán y el point ID se almacenará en los metadatos del atributo. Esto permite una inicialización posterior más rápida. 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 104 PI System Explorer Guía del usuario

115 Diseño e implementación de modelos de activos de PI AF 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 diálogo de configuración 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 escríbalos directamente en el campo Nombres de tag. Los nombres de punto deben estar separados por el símbolo 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 manipulación de cadenas, como la concatenación, 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 sustitución tiene lugar en tiempo de ejecución. Para crear una referencia de datos Generador de cadenas, siga estos pasos: 1. En la pestaña 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 continuación, en el botón de triángulo al final de la fila. Dispone de un menú de parámetros de sustitución, 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 expresión según vaya creándola (cambiar los valores de parámetro predeterminados de una función, por ejemplo). A medida que vaya creando la expresión 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 expresión en una única línea separando sus términos con punto y coma. También puede colocar cada término en su propia línea y eliminar el punto y coma, lo que hace que la estructura de la expresión sea más clara. Los primeros dos ejemplos de concatenación de valores ilustran estas técnicas. Nota: A diferencia de otras funciones de cadena, la sintaxis de Format(DateTime,... ) sigue la sintaxis de C #. Concatenación de valores Puede utilizar los parámetros de sustitución 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 parámetros de sustitución 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. PI System Explorer Guía del usuario 105

116 Diseño e implementación de modelos de activos de PI AF Un segundo ejemplo ilustra cómo crear una cadena para mostrar la duración de un evento. Después de hacer clic en Ajustes y una vez abierta la ventana Referencia de datos del generador de cadenas: 1. Pulse el icono de triángulo al final de la fila y en Parámetros de sustitución, seleccione %StartTime%. 2. Pulse el botón de nueva fila de fórmula para añadir una fila nueva. 3. Escriba los caracteres: " to " 4. Pulse el botón de nueva fila de fórmula para añadir una fila nueva. 5. Pulse el icono de triángulo y en Parámetros de sustitución, 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/ :31:06 to 10/25/ :31:10. Un tercer ejemplo de concatenación obtiene la fecha y la hora actuales y anexa más caracteres: Format("%Time%","yyyy-MM-dd HH:mm:ss");" PM"; El resultado de la expresión es: :12:38 PM. Extracción de texto y manipulación de mayúsculas y minúsculas Puede utilizar funciones para manipular las mayúsculas y minúsculas de una cadena y extraer determinadas secciones. Por ejemplo, para un atributo denominado GasPressure, la siguiente expresión devuelve:gaspr: Mid(UCase("%Attribute%"), 1, 5); Para crear esta expresión, después de hacer clic en Ajustes y con la ventana Referencia de datos del generador de cadenas abierta: 1. Pulse el icono de triángulo al final de la fila y en Parámetros de sustitución, seleccione %Attribute%. 2. Haga clic en el triángulo y en Funciones, seleccione UCase(string) 3. Haga clic en el triángulo y en Funciones, seleccione Mid(string, start, length) Otro ejemplo. Para un atributo denominado GasPressure, la siguiente expresión devuelve:pressure: Mid(LCase("%Attribute%"), 4, 8); Limitación del número 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 , esta referencia de datos devuelve Nota: Compruebe que el tipo de datos que especifique coincida con el tipo de datos de atributo. Se producirían 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. 106 PI System Explorer Guía del usuario

117 Diseño e implementación de modelos de activos de PI AF 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 cálculo de Microsoft Excel). 1. Crear una tabla de PI AF. 2. Defina y rellene los datos de la tabla de dos formas distintas: Impórtelos de una tabla externa (no de PI System) o vincúlelos a ella. Véase Importar o vincular datos de Microsoft Access o Excel. Defina y rellene de forma manual una tabla de PI AF. Véase Definición y relleno manual de una tabla de PI AF. 3. Configurar una referencia de datos de búsqueda de tabla. En esta sección Crear una tabla de PI AF Definición y relleno manual de una tabla de PI AF Referencias a datos desde fuera del PI System Configurar una referencia de datos de búsqueda de tabla Uso de parámetros 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 botón secundario sobre la colección Tablas y seleccione Nueva tabla. 3. Haga clic en la pestaña 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 verificación 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 verificación 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 selección de la casilla Convertir a local. Las horas de la tabla de PI AF se mostrarán en la zona horaria especificada en el campo Convertir a local. Nota: El cálculo de la zona horaria incluye varios factores. Para obtener información detallada sobre los valores de conversión de la zona horaria, consulte Ajustes de conversión 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 PI System Explorer Guía del usuario 107

118 Diseño e implementación de modelos de activos de PI AF automática. En el menú desplegable, seleccione si el valor son segundos, minutos, horas o días. El valor predeterminado es cero, lo cual indica que la función de actualización automática está desactivada. Nota: La actualización automática se desactiva si la tabla tiene cambios que no se han guardado en el servidor. 7. Guarde su trabajo. Nota: Los campos Conexión y Consulta son de solo lectura. PI AF rellena estos campos al vincular o importar una tabla externa. 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 conversión de zonas horarias El cálculo de conversión 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 dependerán del sistema operativo utilizado. Las horas llevan el prefijo <UTC>, <GMT> o <TZ>. El menú también incluye la opción <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 cómo se determinan las horas mostradas para cada combinación posible. Zona horaria* Convertir a local Interna/Externa Comportamiento <Ninguna> Sí Interna Los campos DateTime se ajustan automáticamente en el caso de diferencias de zona horaria y están 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 conversión, por ejemplo, las fechas de cumpleaños. <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. 108 PI System Explorer Guía del usuario

119 Diseño e implementación de modelos de activos de PI AF Zona horaria* Convertir a local Interna/Externa Comportamiento <TZ> Sí Interna Los campos DateTime se ajustan en el caso de diferencias de zona horaria y están en la hora local del cliente. Esta combinación no se necesita, por lo general, salvo durante la importación 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 búsqueda 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 conversión, por ejemplo, las fechas de cumpleaños. <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. PI System Explorer Guía del usuario 109

120 Diseño e implementación de modelos de activos de PI AF Zona horaria* Convertir a local Interna/Externa Comportamiento <TZ> No Externa Los campos DateTime se dejan en la zona horaria original especificada. La referencia de datos de búsqueda 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. Definición y relleno manual de una tabla de PI AF En esta sección Crear de forma manual una definición de tabla Rellenar una tabla de forma manual Crear de forma manual una definición 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 pestaña Tabla. Procedimiento 1. En función de las columnas de tabla que haya creado en la pestaña Definir tabla, introduzca la información correspondiente en las filas de cada columna. 2. Opcional: Puede cortar y pegar filas enteras de una hoja de cálculo Excel o en ella. Después de copiar varas filas de la hoja de cálculo, pulse con el botón 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 vínculo a ella. 110 PI System Explorer Guía del usuario

121 Diseño e implementación de modelos de activos de PI AF 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 búsqueda de tabla. En esta sección Tablas importadas y vinculadas Crear una conexión de tabla reutilizable Autenticación de tablas vinculadas Importar o vincular datos de Microsoft Access o Excel Importar o vincular datos de SQL Server Configuración 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. Después de la importación inicial, no existirá ninguna relación 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 tamaño limitado, pero son más 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 después de la importación inicial. Puede editar los datos directamente en PI AF. Se recomienda limitar las tablas importadas a filas de datos o menos. Las tablas importadas no están diseñadas 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 límites de almacenamiento. También, puede dividir la tabla en distintas tablas al importar. Vincularlos a la tabla. Los datos de tabla no están 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 configuración de seguridad adicional, porque es necesario configurar la forma en que PI AF se conecta con la fuente de datos externos. Crear una conexión de tabla reutilizable Cree una conexión 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. PI System Explorer Guía del usuario 111

122 Diseño e implementación de modelos de activos de PI AF Procedimiento 1. En el panel de navegación 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 conexión de tabla en el menú principal. (También puede hacer clic con el botón secundario en Conexiones de tabla y seleccionar Nueva conexión de tabla en el menú contextual.) El visor muestra las propiedades de la conexión de tabla, como Nombre y Descripción. 3. Opcional: Edite el nombre predeterminado y añada una descripción de la conexión de tabla. 4. En Conexión, haga clic en Construir para configurar la conexión con Propiedades de vínculo de datos. (También puede introducir o modificar una cadena de conexión directamente en el cuadro de texto Conexión.) 5. En la pestaña Proveedor de Propiedades de vínculo de datos, seleccione un proveedor OLEDB y siga las instrucciones que aparecen en la pantalla para configurar la conexión. Para obtener ayuda específica, haga clic en Ayuda en cualquier pestaña. 6. En el visor, seleccione una opción en el campo Seguridad. (Puede que algunas opciones no estén disponibles. Consulte Autenticación de tablas vinculadas para obtener más información.) Simular cliente (recomendado) Seleccione Proporcionar contraseña e introduzca una contraseña para la conexión de tabla. No hay contexto de seguridad adicional 7. Haga clic en Ingresar en el menú principal para ingresar y guardar la conexión de tabla. Puede abrir Conexiones de tabla en el panel del navegador para ver la conexión de tabla creada recientemente. Autenticación de tablas vinculadas Cuando una aplicación 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 conexión de tabla externa en PI System Explorer, por ejemplo, tendría 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 autenticación son: Simular cliente Si la base de datos de origen admite autenticación Windows, utilice la identidad Windows del cliente que solicite los datos. Se trata de una conexión suplantada. Es el método más seguro de autenticación; utilícelo siempre que sea posible. Proporcionar contraseña Si la base de datos de origen no admite la autenticación Windows, o si la base de datos y el servidor de PI AF están en diferentes dominios y no son de confianza, especifique un nombre de usuario y una contraseña con el permiso de acceso a la base de datos de recursos necesario. PI AF utiliza esta cuenta de codificación fija para leer los datos en el origen de datos externo. Por ejemplo, la base de datos MySQL no admite autenticación Windows; por 112 PI System Explorer Guía del usuario

123 Diseño e implementación de modelos de activos de PI AF lo tanto, tendrá que utilizar el nombre de usuario y la contraseña de una cuenta de la base de datos de MySQL. No hay contexto de seguridad adicional Esta opción se aplica normalmente cuando se utilizan Excel u otros orígenes de datos basados en archivos; de lo contrario, sería necesario otorgar a cada usuario acceso de lectura al archivo del servidor. Con esta opción, 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 contraseña al configurar la tabla vinculada ni tampoco es necesario configurar Kerberos. No obstante, encárguese de configurar la seguridad de SQL de tal forma que la identidad del servidor de AF no tenga más 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 conexión. En esta sección 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 creación de tablas de PI AF vinculadas con conexiones no suplantadas. Impida la creación de tablas vinculadas. Si tiene problemas con las tablas vinculadas, póngase en contacto con su administrador del sistema para consultarle la configuración de las tablas externas del servidor de PI AF. Riesgos del uso de conexiones no suplantadas En función de la configuración 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 están habilitadas en el servidor de PI AF. Sin embargo, las tablas vinculadas no suplantadas están inhabilitadas de forma predeterminada en el servidor de PI AF. Para que un usuario pudiera ejecutar un ataque, tendría 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. PI System Explorer Guía del usuario 113

124 Diseño e implementación de modelos de activos de PI AF PRECAUCIÓN: 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 actualización 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 botón 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 sesión necesarias para acceder a la base de datos o al libro de trabajo Las instrucciones exactas dependen de la configuración 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 sección Vincular o importar datos Vincular datos en un servidor de PI AF de 64 bits Vincular o importar datos En estas instrucciones se describe cómo importar datos en un servidor AF de 32 bits o 64 bits y cómo 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 mostrarán 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 opción Suplantar cliente (no se muestra en el caso de la importación). 114 PI System Explorer Guía del usuario

125 Diseño e implementación de modelos de activos de PI AF 5. Haga clic en Crear. Se abrirá la ventana Propiedades de vínculo de datos. 6. En la pestaña Proveedor, seleccione el proveedor según la versión de Microsoft Office que esté utilizando y haga clic en Siguiente. En Office : 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 En la pestaña Conexión, especifique lo siguiente y haga clic en Aceptar. Origen de datos La ubicación y el nombre de archivo de la base de datos o el libro de trabajo (por ejemplo, C:\AFTestData.xls). Si va a realizar una vinculación, la ruta al archivo debe ser relativa al servidor AF. Nombre de usuario Credenciales de inicio de sesión de un usuario al que se ha otorgado acceso de lectura a la base de datos o al libro de trabajo. Nota: Para almacenar la contraseña con la información de conexión, marque la casilla de verificación Permitir guardar contraseña. La contraseña se almacena como texto sin formato (sin cifrar). 8. En la pestaña Avanzadas, en la lista Permisos de acceso, seleccione Share Deny None. 9. Solo en Excel: En la pestaña 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 según la versión de Microsoft Excel que esté utilizando y, a continuación, haga clic en Aceptar. En Excel : Excel 8.0 En Excel 2007 y posteriores: Excel Para comprobar que se puede acceder a la base de datos, vuelva a la pestaña Conexión y haga clic en Probar conexión. Si los ajustes son válidos, 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 devolverán en la hoja de cálculo, 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 pestaña Tabla. Si la consulta se ha especificado de forma correcta, la pestaña contendrá una tabla con los resultados. 14. Para guardar los cambios, pulse con el botón secundario sobre la tabla y haga clic en Ingresar. PI System Explorer Guía del usuario 115

126 Diseño e implementación de modelos de activos de PI AF 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 mostrarán en el panel derecho. 3. Haga clic en Vincular. Se abrirá la ventana correspondiente. 4. Active la opción Suplantar cliente. 5. En el campo Conexión, introduzca una cadena de conexión válida 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 devolverán en la hoja de cálculo, 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 pestaña Tabla. Si la consulta se ha especificado de forma correcta, la pestaña contendrá una tabla con los resultados. 8. Para guardar los cambios, pulse con el botón 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 información de conexión válida. Los pasos de vinculación o importación dependen el método de conexión que elija. Véase Autenticación de tablas vinculadas. En estos procedimientos, se utliza la base de datos de SQL Server, AdventureWorks. En esta sección Uso de la conexión de seguridad suplantada de Windows Utilizar la seguridad no suplantada de Windows Utilización de la seguridad de SQL Server Vincular o importar la tabla de destino 116 PI System Explorer Guía del usuario

127 Diseño e implementación de modelos de activos de PI AF Uso de la conexión de seguridad suplantada de Windows Vincular o importar datos de una tabla de SQL Server con la opción Simular cliente. Consulte Recomendaciones relativas al acceso a los datos para las tablas vinculadas. Nota: Si se va a realizar una vinculación 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 reenvíe desde el servidor de AF al SQL Server. Procedimiento 1. Crear un grupo local de usuarios en el servidor de datos. 2. Configuración de la seguridad en la base de datos de la tabla de destino. 3. Vincular o importar la tabla de destino. En esta sección Crear un grupo local de usuarios en el servidor de datos Configuración de la seguridad en la base de datos de la tabla de destino Crear un grupo local de usuarios en el servidor de datos 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 > Administración de equipos. Se abrirá la aplicación Administración de equipos. 2. Expanda Usuarios y grupos locales. 3. Haga clic con el botón 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. Añada a este grupo las cuentas de todos los usuarios que podrían suplantarse. 6. Haga clic en Aceptar para añadir los usuarios seleccionados y, a continuación, en Cerrar para salir de la ventana Nuevo grupo. 7. Cierre la aplicación Administración de equipos. Configuración de la seguridad en la base de datos de la tabla de destino Es necesario otorgar a todas las cuentas con la que se puede ejecutar la consulta especificada permiso para ejecutar esa consulta. Procedimiento 1. Abra Microsoft SQL Server Management Studio y conéctese a la instancia de SQL Server que contiene la tabla de destino. 2. En la instancia de SQL Server, expanda la carpeta Seguridad y después la carpeta Inicios de sesión. 3. Haga clic con el botón secundario en la carpeta Inicios de sesión y seleccione Nuevo inicio de sesión. PI System Explorer Guía del usuario 117

128 Diseño e implementación de modelos de activos de PI AF 4. Utilice el botón Buscar para localizar el grupo creado en la sección anterior y elegir ese grupo como nombre de inicio de sesión. 5. Seleccione la opción Autenticación de Windows y la base de datos que contiene la tabla de destino como la Default database. 6. Seleccione la página Asignación de usuarios. 7. Seleccione la fila de la base de datos que contiene la tabla de destino. 8. Marque la casilla de verificación Asignar de la base de datos seleccionada. 9. Expanda la carpeta Bases de datos y después 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 sesión que acaba de crear. Por ejemplo, si la consulta que se utilizará es una cláusula SELECT que especifica una tabla única, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y, continuación, haga clic con el botón secundario en la tabla a la que se refiera la consulta y seleccione Propiedades. 10. En la ventana Propiedades de la tabla, seleccione la página Permisos, busque y seleccione Inicio de sesión, después Otorgar al inicio de sesión el permiso seleccionado y pulse Aceptar para cerrar la ventana Propiedades de la tabla. 11. Cierre Microsoft SQL Server Management Studio. Utilizar la seguridad no suplantada de Windows Vincule o importe datos de una tabla de SQL Server con la opción de contexto no additional security. Procedimiento 1. Crear un grupo local de usuarios en el servidor de datos 2. Configuración de la seguridad en la base de datos de la tabla de destino 3. Vincular o importar la tabla de destino Crear un grupo local de usuarios en el servidor de datos 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 > Administración de equipos. Se abrirá la aplicación Administración de equipos. 2. Expanda Usuarios y grupos locales. 3. Haga clic con el botón 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. Añada la cuenta del usuario asociado con el servicio AF al nuevo grupo. Si el servicio AF se ejecuta con la cuenta NT AUTHORITY\NetworkService, añada la cuenta de equipo del servidor de AF a este grupo. 118 PI System Explorer Guía del usuario

129 Nota: Si el servicio AF se ejecuta con la cuenta de sistema local o de servicio local, probablemente necesitará utilizar la autenticación de SQL Server (modo de autenticación de SQL Server y Windows) en lugar de la seguridad integrada. 6. Haga clic en Aceptar para añadir el usuario seleccionado. 7. Cierre la aplicación Administración de equipos. Utilización de la seguridad de SQL Server Vincule o importe datos de una tabla de SQL Server utilizando la autenticación de SQL Server. Procedimiento 1. Creación de un usuario de SQL Server. 2. Configuración 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, asegúrese de que SQL Server se ha configurado para aceptar conexiones remotas. Si va a utilizar una cuenta de SQL Server, asegúrese de que la instancia de SQL Server se ha configurado para permitir autenticación de modo mixto. Creación de un usuario de SQL Server Si la tabla de destino (la tabla a la que desea conectarse) reside en una instancia de SQL Server distinta de aquella donde reside la base de datos de 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 conéctese a la instancia de SQL Server que contiene la tabla de destino. 2. En la instancia de SQL Server, expanda la carpeta Seguridad y después la carpeta Inicios de sesión. 3. Cree un inicio de sesión e introduzca un nombre en el campo Nombre de inicio de sesión. 4. Seleccione una opción en Autenticación de SQL Server. 5. Introduzca la contraseña en los campos Contraseña y Confirmar contraseña. 6. En la lista Base de datos predeterminada, seleccione la base de datos que contiene la tabla de destino. 7. Seleccione la página Asignación de usuarios. Diseño e implementación de modelos de activos de PI AF 8. Seleccione la fila de la base de datos que contiene la tabla de destino. 9. Marque la casilla de verificación Asignar de la base de datos seleccionada. 10. Pulse Aceptar para cerrar la ventana Inicio de sesión - Nuevo y guarde el inicio de sesión. 11. Expanda la carpeta Bases de datos y, a continuación, 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 sesión que acaba de crear. Por ejemplo, si la consulta que se utilizará es una cláusula SELECT que especifica una tabla única, expanda la carpeta Tablas de la base de datos de destino, expanda la carpeta Tablas y, continuación, haga clic con el botón secundario en la tabla a la que se refiera la consulta y seleccione Propiedades. PI System Explorer Guía del usuario 119

130 Diseño e implementación de modelos de activos de PI AF 12. En la ventana Propiedades de la tabla, seleccione la página Permisos, después, Inicio de sesión y Otorgar al inicio de sesión 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 básicamente el mismo. Las siguientes instrucciones se refieren a cómo 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 mostrarán en el panel derecho. 2. Haga clic en Vincular. Se abrirá la ventana Vínculo de tabla. 3. Haga clic en Crear. Se abrirá la ventana Propiedades de vínculo de datos. 4. En la pestaña Proveedor, seleccione SQL Server Native Client. 5. En la pestaña Conexión, configure la instancia de SQL Server que contiene la base de datos con la que desea conectarse. 6. Configure la autenticación: Para una seguridad integrada, seleccione la opción Use Windows NT Integrated Security. Para una seguridad de SQL Server, seleccione la opción Use a Specific User Name and Password. A continuación, introduzca el nombre de inicio de sesión de SQL Server en el campo Nombre de usuario y una contraseña en el campo Contraseña. 7. Seleccione la opción 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 configuración funcionan, haga clic en Probar conexión. Si los ajustes son correctos, PI System Explorer mostrará un mensaje indicando que son correctos. Nota: La prueba de conexión 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 definición de tabla y selecciona la opción 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 pestaña Tabla. 9. Haga clic en Aceptar. 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 pestaña Tabla. 120 PI System Explorer Guía del usuario

131 Diseño e implementación de modelos de activos de PI AF Configuración de seguridad de las tablas vinculadas En esta sección 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 aplicación 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 línea de comandos que sirve para activar o desactivar características del servidor de PI AF y ejecutar otras funciones administrativas. La utilidad establece una conexión 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 compatibilidad con las tablas de PI AF externas Desactivar la compatibilidad con las tablas de PI AF externas Activar la compatibilidad con las tablas de PI AF externas para usuarios no suplantados Desactivar la compatibilidad con las tablas de PI AF externas para usuarios no suplantados Cambiar los valores de seguridad de una tabla de PI AF especificada afdiag /DT afdiag /DT afdiag /DTImp afdiag /DTImp- En PI System Explorer, haga clic con el botón secundario sobre la tabla en el navegador y seleccione Seguridad en el menú que aparece. activado desactivado La configuración de tabla requiere, de forma predeterminada, privilegios administrativos en el servidor de PI AF. PI System Explorer Guía del usuario 121

132 Diseño e implementación de modelos de activos de PI AF Tarea Comando Valor predeterminado Modificar los valores de seguridad de las tablas vinculadas. En PI System Explorer, pulse con el botón secundario sobre Tablas en el navegador y seleccione Seguridad en el menú que aparece. La configuración de tabla requiere, de forma predeterminada, privilegios administrativos en el servidor de PI AF. Configurar una referencia de datos de búsqueda de tabla Procedimiento 1. Abra PI System Explorer. 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 búsqueda de tabla. 4. En en el menú del campo Referencia de datos de la Paleta, seleccione Búsqueda de tabla. 5. Haga clic en Ajustes. Se abrirá la ventana Referencia de datos de búsqueda 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 ratón sobre un botón para ver el nombre. Haga clic en Administrar tablas para abrir una lista de tablas en las que podrá realizar búsquedas o aplicar filtros. Para seleccionar una tabla, resáltela 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 configuración, no hay interpolación 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 opción en Zona horaria. 10. En la lista Regla, seleccione una opción: 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 más de una coincida con los criterios. Summarize all rows matching criteria Seleccione una operación de resumen en la lista Resumen para realizar la operación 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 122 PI System Explorer Guía del usuario

133 Seleccione esta opción si la tabla tiene valores con marcas de fecha y hora asociadas y desea considerar estos valores como datos de series temporales. En la lista Columna de hora, seleccione la columna de tabla que contenga las marcas de fecha y hora que desea utilizar. En el menú solo aparecerán las columnas que tengan el tipo de valor DateTime. Si selecciona esta opción, la cláusula WHERE no es necesaria. 11. Utilice los menús y los botones del panel Donde para elaborar la consulta de tabla. Nota: También puede escribir la cláusula entera en el campo de texto Cláusula DONDE completa. Consulte Sintaxis de la cláusula DONDE para obtener más información. 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. ConsulteInterpolación para obtener una explicación del operador Interpolate. En la lista Atributo o valor, seleccione un atributo o un valor literal para utilizar en la consulta. Haga clic en Añadir And o Añadir Or para escribir la cláusula WHERE en el campo Cláusula DONDE completa con un operador AND / OR. Edite la cláusula en le campo Cláusula DONDE completa si es necesario. Nota: Los botones Añadir And o Añadir Or generarán, siempre que resulte posible, de forma automática la sintaxis, la unidad de medida y la zona horaria necesarias. 12. Opcional: Edite los valores de los parámetros de tabla. Los parámetros de tabla solo se aplican a las tablas vinculadas. Para obtener más información, consulte Uso de parámetros en una consulta de tabla vinculada. 13. Opcional: En Valores de sustitución, seleccione los atributos o los valores literales que se devolverán cuando la consulta de tabla detecte filas perdidas o valores nulos en los datos. En esta sección Operaciones de resumen compatibles Interpolación Sintaxis de la cláusula DONDE Operaciones de resumen compatibles Diseño e implementación de modelos de activos de PI AF Operación Sum Avg Min Max Count StDev Var Descripción Suma Promedio Mínimo Máximo Recuento Desviación estadística estándar Varianza estadística PI System Explorer Guía del usuario 123

134 Diseño e implementación de modelos de activos de PI AF Operación Descripción 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 cláusula 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 cláusula WHERE. Ejemplo de tabla Nivel Interpolación Utilice el operador Interpolate para interpolar un valor de la columna de resultados basado en una interpolación de la columna de entrada especificada. Por ejemplo, si una tabla de calibración del tanque incluía dos columnas, Nivel y Volumen, la siguiente cadena de configuración interpolará el volumen en función de la lectura de nivel: SELECT Volume FROM MyTable WHERE Supongamos que la tabla tiene las siguientes filas: Volumen Una lectura de nivel de 2.2 produce como resultado el volumen Solo se puede utilizar un operador Interpolate en una única cláusula DONDE. Sintaxis de la cláusula DONDE Puede utilizar los menús del cuadro de diálogo Referencia de datos de búsqueda de tabla para construir la cláusula DONDE de su consulta o puede escribir la cláusula directamente en el campo Cláusula DONDE completa. Tenga en cuenta las siguientes pautas: Los atributos AF, que se distinguen porque su nombre va precedido del se sustituyen por su valor durante la búsqueda de tablas. Los nombres de columna y atributo que contengan símbolos alfanuméricos deben ir entre corchetes: [height] Gauge]. Si se necesita una conversión de unidades de medida o de zonas horarias, añada una cláusula UOM o TZ dentro de los corchetes: [height] Gauge;UOM=m]. Uso de parámetros en una consulta de tabla vinculada La consulta de una tabla vinculada determina qué datos procedentes de un origen externo se incluirán en la tabla. Puede incluir parámetros en la consulta y, al configurar una referencia de datos de consulta de tabla que utilice la tabla vinculada, podrá especificar valores de parámetro. Esto le permitirá utilizar una única tabla vinculada para obtener distintos resultados en cada referencia de datos de búsqueda de tabla que la utilice. 124 PI System Explorer Guía del usuario

135 Diseño e implementación de modelos de activos de PI AF El uso de parámetros en una consulta de tabla vinculada es útil, por ejemplo, para limitar el número de filas que devuelve una tabla externa muy grande. Puede añadir condiciones y parámetros para devolver resultados más concretos, por ejemplo, todas las filas que incluyan un ID de dispositivo o fabricante, específicos de cada referencia de datos de búsqueda de tabla. Al configurar una tabla vinculada en la ventana Vínculo de tabla, podrá añadir parámetros de tabla a su consulta y definir valores predeterminados para ellos. Después, en la ventana Referencia de datos de búsqueda de tabla, cuando defina una referencia de datos utilizando la tabla vinculada, podrá introducir parámetros de tabla específicos de esa referencia de datos. También puede definir valores de parámetro mediante programación con el AF SDK. Los valores de parámetro pueden ser valores específicos o proceder de otros valores de atributo o de variables de sustitución predefinidas, como %Element%. Añadir parámetros de tabla a una consulta de tabla vinculada Cuando defina una tabla vinculada en la ventana Vínculo de tabla, podrá añadir parámetros a la consulta de tabla y establecer valores predeterminados para ellos. Procedimiento 1. Edite el texto del campo Consulta para incluir el nuevo parámetro o parámetros. Los nombres de parámetro deben comenzar por el 2. Haga clic dentro de la tabla Parámetros para mostrar los nuevos parámetros de la consulta. 3. Especifique valores predeterminados para cada parámetro a fin de determinar los resultados predeterminados de la consulta y haga clic en Aceptar. Una vez añadidos los parámetros a la consulta, podrá especificar valores para ellos cuando configure una referencia de datos de búsqueda de tabla que utilice la tabla vinculada. Ejemplo Plantéese la siguiente consulta para una tabla vinculada llamada MyTable. La cláusula WHERE limita la selección 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 parámetro de consulta de (observe que los nombres de parámetro de consulta deben comenzar por el SELECT * FROM BigTable WHERE RowID Ahora, para cada referencia de datos de búsqueda de tabla que utilice MyTable, podrá proporcionar distintos valores de parámetro de tabla para obtenga diferentes resultados de la consulta. Por ejemplo, en la ventana Referencia de datos de búsqueda de tabla, cuando configure una referencia de datos, para el valor en la lista Parámetros de tabla. De esta adoptará el valor actual del atributo AssetID. La consulta correspondiente sería: SELECT Result FROM Esta consulta devuelve filas cuyo RowID coincide con el valor actual de AssetID. Uso de parámetros en referencias de datos Los parámetros de sustitución 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 parámetros de sustitución al crear las referencias de datos de un atributo basado en esa plantilla. Por ejemplo, puede utilizar parámetros de sustitución: PI System Explorer Guía del usuario 125

136 Diseño e implementación de modelos de activos de PI AF 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 sección Sustituciones de nombre Referenciar un valor de atributo Lista de parámetros de sustitución de PI AF PI AF interpreta muchos parámetros de sustitución. Sustituciones de nombre Cuando se utiliza una sustitución de nombre, PI AF sustituye directamente por el parámetro de sustitución aquello que representa ese parámetro concreto. La tabla de Lista de parámetros de sustitución de PI AF enumera los parámetros de sustitución disponibles y aquello que representan. Por ejemplo, %Element% es un parámetro de sustitución que representa el nombre del elemento. Después 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 ubicación donde figure %Element% e la configuración. Supongamos que tiene una plantilla de referencia de datos que hace referencia al nombre de un PI point: %Element%_TT Cree un elemento denominado Tank1 que se base en esa plantilla. La referencia de datos de atributo 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 parámetros de sustitución para hacer referencia al valor de otro atributo. Puede utilizar referencias de valor de atributo para especificar un valor en el campo Tiempo relativo o en la configuración de atributo de punto para los PI points generados de forma automática.la sintaxis es: %@AttributeName% donde AttributeName es el nombre del atributo. 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 creación o actualización 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 excepción a esta regla son las sustituciones de valor de Tiempo relativo, que se evalúan con cada llamada de valor a la referencia de datos de PI points (Crear un intervalo de duración configurable). 126 PI System Explorer Guía del usuario

137 Diseño e implementación de modelos de activos de PI AF Lista de parámetros de sustitución de PI AF En la tabla siguiente se incluyen los parámetros de sustitución admitidos por PI AF: Nombre del parámetro %Analysis% %Attribute% %AttributeId% %Database% %Description% %Element% %..\Element% %\Element% %ElementDescription% %ElementId% %EndTime% %EventFrame% %<Environment Variable>% %..\EventFrame% %EventFrame% %EventFrame% %Model% %Server% %Source% %StartTime% %System% %Template% %Time% %Transfer% Sustitución Nombre del análisis, si se puede recuperar del contexto. Nombre del atributo que contiene esta referencia de datos. ID del atributo que contiene esta referencia de datos. Nombre de la base de datos de PI AF en la que reside el atributo. Descripción del atributo que contiene esta referencia de datos. 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. Nombre del elemento primario en el que reside el atributo. Para recuperar más antecesores, utilice la notación..\; por ejemplo, %.. \..\Element%. Nombre del elemento raíz en el que reside el atributo. Descripción del elemento en el que reside el atributo. 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. Hora de finalización local, si se puede recuperar del contexto temporal. Nombre del marco de evento en el que reside el atributo. 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. Nombre del marco de evento principal del marco de evento en el que reside el atributo. Para recuperar más antecesores, utilice las notaciones..\; por ejemplo, %..\..\EventFrame%. Nombre del marco de evento raíz en el que reside el atributo. ID del marco de evento en el que reside el atributo. Nombre del modelo, si se puede recuperar del contexto. 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 parámetro %Server% no se resuelve en el equipo en el que reside la base de datos de PI AF. El parámetro %Server% se puede resolver en un PI Server diferente, en función del valor predeterminado en PI AF Client. Nombre del elemento origen de la transferencia en el que reside el atributo. Hora de inicio local, si se puede recuperar del contexto temporal. Nombre del servidor de PI AF o colectivo en el que reside el atributo. 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 sustitución sería Valve. Hora local, si se puede recuperar del contexto temporal. Nombre de la transferencia en la que reside el atributo. PI System Explorer Guía del usuario 127

138 Diseño e implementación de modelos de activos de PI AF Nombre del parámetro %TransferId% %UtcEndTime% %UtcStartTime% %UtcTime% Sustitución ID de la transferencia en la que reside el atributo. Hora de finalización universal coordinada (UTC) si se puede recuperar del contexto temporal. Hora de inicio universal coordinada (UTC) si se puede recuperar del contexto temporal. Hora universal coordinada (UTC) si se puede recuperar del contexto temporal. Localizar el PI Server predeterminado El parámetro de sustitución %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 instalación predeterminados de PI Server, seleccione Inicio Todos los programas > PI System > Acerca de PI-SDK Aparecerá el cuadro de diálogo Utilidad PI SDK. 2. Seleccione Archivo > Conexiones. Se mostrará PI Connection Manager. 3. Seleccione Conexiones > Opciones. Aparecerá el cuadro de diálogo Opciones de conexión. El servidor predeterminado estará incluido en Ajustes de servidor predeterminado. Trabajo con unidades de medida En esta sección 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 función de unidades de medida (UOM) permite realizar conversiones automáticas 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 automática 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 canónica. Es la unidad base que AF utiliza como base para convertir valores a otras unidades 128 PI System Explorer Guía del usuario

139 Diseño e implementación de modelos de activos de PI AF cuando es necesario. Por ejemplo, la unidad canónica de la clase longitud es el metro (m). La implementación 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 pequeño predefinido de clases base y un conjunto más 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. Teóricamente, puede definir todas las unidades de medida como un grupo reducido de clases base de unidades de medida. PI AF utiliza la unidad canónica de la clase base para determinar las unidades canónicas de todas las clases derivadas de esa clase base. Las unidades canónicas de las clases derivadas no se pueden modificar. Por ejemplo, dado que la clase de área se basa en la de longitud, la unidad canónica de la clase área será el metro cuadrado (m²). PI AF incluye muchas unidades de medida estándar, clases de unidades de medida y factores de conversión, pero siempre puede añadir otros nuevos. Por lo general, no resulta necesario crear clases base, aunque es posible que ocasionalmente desee añadir una para las mediciones que no sean físicas. Por ejemplo, puede añadir 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 botón Unidad de medida en el panel del navegador. Todas las clases de unidades de medida definidas aparecerán en el navegador. 2. Haga clic para seleccionar la clase a la que desea añadir una unidad de medida nueva. Por ejemplo, si desea añadir una unidad de longitud, haga clic y seleccione la clase Longitud. Todas las unidades de medida definidas para la clase seleccionada aparecerán en el visor. 3. Pulse con el botón 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 pestaña Propiedades de unidad de medida (Propiedades de unidades de medida). En esta sección Propiedades de unidades de medida El campo de fórmula Propiedades de unidades de medida Campo/Botón Nombre Descripción Introduzca un nombre. Las unidades de medida pueden tener el mismo nombre, pero abreviaturas diferentes. PI System Explorer Guía del usuario 129

140 Diseño e implementación de modelos de activos de PI AF Campo/Botón Abreviatura Descripción UOM canónica UOM de referencia Tipo - Simple Tipo - Fórmula Factor Desplazamiento Descripción Introduzca la abreviatura. Las unidades de medida deben tener abreviaturas distintas. Opcional. Introduzca una descripción de la unidad de medida. El campo de solo lectura muestra la unidad canónica de la clase. Seleccione una clase de unidad de referencia que se utilizará como base para convertir la nueva unidad. Seleccione esta opción para las conversiones que requieran un factor de escala y un desplazamiento base. Seleccione esta opción con los cálculos de conversiones complejas. Consulte El campo de fórmula para obtener más información. El factor de conversión de la unidad de medida de referencia para esta unidad de medida. Por ejemplo, un kilómetro tiene un factor de 1000 relativo a un metro. El desplazamiento de conversión 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 fórmula Al crear una unidad de medida, debe definir el método de conversión. Dispone de la opción de utilizar una fórmula para la conversión. PI AF utiliza C# para evaluar fórmulas de unidades de medida. Siga estas pautas: Escriba todas las unidades de medida en los términos de la abreviatura de la unidad de medida. Si una abreviatura no es un nombre de variable C# válido, inclúyala entre corchetes. Respete las reglas de evaluación de C#. Opcionalmente, puede invocar métodos estáticos.net estándar, como Math.Log10(), para realizar el cálculo (estará limitado a los métodos disponibles en el ensamblado del sistema). La fórmula utiliza la clase CompilerResults para evaluar la fórmula en relación con los resultados. Por ejemplo, vatios (w) es la unidad de medida canónica de la clase Potencia. Para crear la unidad de medida dbm en la clase Potencia, la fórmula podría ser: Por ejemplo, vatios (w) es la unidad de medida canónica de la clase Potencia. Para crear la unidad de medida dbm en la clase Potencia, la fórmula podría ser: dbm = Math.Log10( w ) + 30 Crear una clase de unidad de medida Procedimiento 1. En PI System Explorer, pulse el botón Unidad de medida en el panel del navegador. 130 PI System Explorer Guía del usuario

141 Todas las clases de unidades de medida definidas aparecerán en el navegador. 2. Pulse con el botón secundario en cualquier lugar y seleccione Nueva clase Unit-of-Measure. Aparecerá el cuadro de diálogo Propiedades de la clase Unit-of-Measure. 3. Rellene las propiedades de la pestaña General: Nombre Introduzca un nombre para la clase. Consulte Limitaciones respecto a los nombres de objetos de AF, si es necesario. Descripción Opcional. Introduzca una descripción de la clase. UOM canónica Escriba el nombre de la unidad de medida canónica para esta clase. Si la UOM no existe, PI AF la creará al mismo tiempo que la nueva clase. Abreviatura de UOM canónica Introduzca la abreviatura. Las clases de unidades de medida deben tener abreviaturas diferentes. Unidades de medida base Introduzca un cálculo para la unidad de medida. Si desea definir una nueva clase base, deje este campo en blanco. 4. Haga clic en Aceptar. 5. La pestaña Unidades de medida mostrará todas las unidades de medida definidas para esta clase. Para añadir unidades de medida nuevas, pulse con el botón secundario en la lista y seleccione Nueva unidad de medida. Podrá añadir unidades de medida nuevas siempre que lo desee. Clases base de unidades de medida Clase Corriente eléctrica Longitud Masa Moles (Cantidad de sustancia) Ángulo plano Cantidad Unidad canónica Amperio (amp) metro (m) kilogramo (kg) mol (mol) radián (rad) total Relación porcentaje (%) Temperatura Tiempo Diseño e implementación de modelos de activos de PI AF kelvin (K) segundos (s) Algunas clases derivadas de unidades de medida comunes Clase Basada en Unidad canónica Velocidad angular Ángulo plano * Tiempo -1 radián por segundo (rad/s) Área Longitud 2 metro cuadrado (m 2 ) Densidad Masa * Longitud -3 kilogramo por metro cúbico (kg/m 3 ) PI System Explorer Guía del usuario 131

142 Diseño e implementación de modelos de activos de PI AF Clase Basada en Unidad canónica Carga eléctrica Corriente eléctrica * Tiempo culombio (C) Potencial eléctrico Corriente eléctrica -1 * Length 2 * Masa voltio (V) * Tiempo -3 Energía Longitud 2 * Masa * Tiempo -2 julio (J) Frecuencia Tiempo -1 hercio (Hz) Fuerza Masa * Longitud * Tiempo -2 newton (N) Caudal másico Masa * Tiempo -1 kilogramo por segundo (kg/s) Potencia Masa * Longitud 2 * Tiempo -3 vatio (W) Presión Masa * Longitud -1 * Tiempo -2 pascal (Pa) Energía específica, entalpía específica Longitud 2 * Tiempo -2 julios por gramo (J/g) Velocidad Longitud * Tiempo -1 metro por segundo (m/s) Volumen Longitud 3 metro cúbico (m 3 ) Caudal volumétrico Longitud 3 * Tiempo -1 metro cúbico por segundo (m 3 /s) 132 PI System Explorer Guía del usuario

143 Asset-Based Analytics para PI Server Asset-Based Analytics es una función integral de PI Asset Framework (PI AF) que permite crear y gestionar análisis. Utilice la función Asset-Based Analytics en PI System Explorer cuando trabaje con elementos y plantillas de elementos. Un análisis es un cálculo planificado que obtiene valores de entrada de atributos de una jerarquía 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 análisis recibir entradas y guardar las salidas en PI points. Nota: Se recomienda especialmente guardar las salidas de análisis en PI points para poder elaborar historiales de datos e incluirlos en las tendencias creadas con las herramientas cliente. El almacenamiento de salidas de análisis en PI points mejora también el rendimiento de PI AF. En esta sección Acerca de los análisis Análisis de expresiones Análisis de resumen Análisis de generación de marcos de evento Gestión de los análisis de un elemento Análisis de ejemplo Gestión de análisis en la base de datos de AF Gestión de PI Analysis Service Referencia de funciones de expresión Funciones del vapor para expresiones de análisis Acerca de los análisis Un análisis consta de una expresión que realiza un cálculo y una programación de esa ejecución. 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 jerarquía de AF como entradas de un análisis. Todos los análisis están asociados con un elemento o, preferiblemente, con una plantilla de elementos. Puede guardar salidas de análisis asignándolas a atributos de ese elemento o plantilla de elementos. Nota: Si asigna una salida de análisis 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 análisis en PI points para poder elaborar historiales de datos e incluirlos en las tendencias creadas con las herramientas cliente. El almacenamiento de salidas de análisis en PI points mejora también el rendimiento de PI AF. Existen tres tipos de análisis: PI System Explorer Guía del usuario 133

144 Asset-Based Analytics para PI Server Expresión Calcula uno o más valores de salida a partir de las funciones, operadores y valores de entrada especificados. Resumen Calcula funciones estadísticas estándar 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. Generación de marcos de eventos Especifica condiciones de inicio y finalización de marcos de eventos. En esta sección Uso de plantillas de análisis Programación de análisis Actualización de análisis y de plantillas de análisis Expresiones Uso de plantillas de análisis Para aplicar un análisis a un elemento, especifique el elemento directamente al crear el análisis. Para aplicar un análisis a un grupo de elementos, sin embargo, es mucho más eficaz utilizar una plantlila de análisis que aplicar el análisis de forma individual a cada elemento. Las plantillas de análisis definen el formato de un análisis. Los análisis derivados de ellas serán similares, pero tendrán atributos de entrada y de salida específicos. Las plantillas de análisis permiten aprovechar las ventajas de la jerarquía de AF. Todos los elementos derivados de una plantilla de elementos adquieren automáticamente los análisis de sus plantillas de análisis. Cree una plantilla de análisis en una plantilla de elementos siguiendo el mismo procedimiento que cuando se crea un análisis en un elemento. Cuando añada o modifique una plantilla de análisis en una plantilla de elementos, esos cambios se propagarán a todos los elementos derivados de la plantilla de elementos. Si se elimina una plantilla de análisis, se eliminarán todos los análisis derivados de ella, salvo los análisis vinculados a Notifications. Nota: Los análisis derivados de las plantillas de análisis no se pueden eliminar directamente de un elemento. Programación de análisis La programación especifica cuándo evaluar un análisis. Existen dos tipos de programación: Periódica La programación periódica se basa en el reloj. Cuando se selecciona la opción Periódica en Programación, se muestra el período actual. Haga clic en Configurar para configurar el período de programación. Activado por evento Este tipo de programación se activa mediante eventos. Si selecciona la opción Activada por evento en Programación, podrá seleccionar uno o varios atributos de entrada para activar la evaluación del análisis siempre que se produzca un cambio en el valor de uno de los atributos seleccionados. 134 PI System Explorer Guía del usuario

145 Asset-Based Analytics para PI Server Actualización de análisis y de plantillas de análisis Tan pronto como se inserta un análisis, se activa de forma automática y está disponible para ejecutarse. Cualquier cambio que se inserte es captado de forma inmediata por todos los análisis a los que afecta, incluso cuando se están ejecutando. Los cambios que pueden afectar a un análisis son: Ediciones realizadas directamente en el análisis Cambios en un elemento que afectan a sus análisis, incluida la adición o supresión de un análisis Cambios en una plantilla de elementos, que se propagan a todos los elementos que proceden de la plantilla, incluida la adición y la supresión de una plantilla de análisis Cambios en una plantilla de análisis, que se propagan a todos los análisis que provienen de esa plantilla Cambios en una plantilla de marcos de evento utilizados por un análisis; los nuevos marcos de evento se basan en la plantilla actualizada Expresiones Todos los análisis, excepto los resúmenes, incluyen expresiones, que se muestran en una o varias filas. Una expresión simple puede ocupar una sola fila. Nombre Expresión Valor Variable1 PrevVal('Att1') El siguiente ejemplo muestra una expresión compleja refactorizada en expresiones más breves en varias filas. Las dos primeras filas asignan los nombres V1 y V2 a expresiones más simples que se utilizan como variables en la última fila. Nombre Expresión Valor 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 evaluación de las filas se realiza del siguiente modo: primero, la primera fila; después, la siguiente debajo de ella y así sucesivamente. Dado que las filas inferiores pueden depender de las más altas, puede reordenarlas para evaluarlas en el orden correcto. Haga clic en Añadir expresión nueva para añadir una fila y en el icono (X) para eliminarla. En cualquier expresión, haga clic en Evaluar para evaluar las filas (en función de los datos actuales) y mostrar los valores de cada una de ellas en la columna Valor. En todos los análisis de expresiones, es necesario asignar como mínimo 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 sección Introducción de expresiones Simplificación de una expresión con la refactorización PI System Explorer Guía del usuario 135

146 Asset-Based Analytics para PI Server Introducción de expresiones Para crear una expresión, haga clic en la columna Expresión 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 expresión para seleccionar e insertar atributos y funciones en la expresión. Puede introducir el texto directamente en la expresión. A medida que escriba, las funciones, atributos y variables que coincidan con el texto que haya escrito aparecerán en una lista de selección en el punto donde esté el cursor y podrá seleccionar el elemento que desee insertar. Simplificación de una expresión con la refactorización En las aplicaciones del mundo real, la expresión de un análisis puede ser extremadamente compleja y los nombres de atributo largos pueden contribuir a aumentarla. Para simplificar una expresión complicada, refactorícela como un grupo de expresiones más pequeñas asignadas a variables. La refactorización de un análisis permite comprender mejor cómo funciona cada una de sus partes. También contribuye a probar y depurar las expresiones, ya que permite evaluar de forma simultánea las expresiones más pequeñas para aislar un error. Puede refactorizar un análisis añadiendo nuevas filas de expresión e introduciendo texto en los campos Nombre y Expresión directamente. También, puede resaltar un término en una expresión, pulsar con el botón secundario y seleccionar Asignar a variable. De esta forma, se insertará una fila en la parte superior que asignará el término a un nombre de variable nuevo. El término se sustituirá en la expresión 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 expresión que se utilice como variable en otras expresiones, romperá la conexión entre ellas. Ejemplo Una expresión compleja puede ocupar una sola fila: Nombre Expresión Valor Variable1 2*'LongAttributeName' + Avg('Att2', 'Att3', 'Att4') La expresión se puede refactorizar en las siguientes tres filas de expresiones más sencillas. Observe que un nombre en una fila se puede utilizar como variable en cualquier fila inferior: Nombre Expresión Valor Variable1 'LongAttributeName' Variable2 Avg('Att2', 'Att3', 'Att4') Variable3 2*Variable1 + Variable2 Análisis de expresiones El tipo de análisis más directo es el análisis de expresión. Contiene una o varias expresiones e información relativa a la programación. 136 PI System Explorer Guía del usuario

147 Asset-Based Analytics para PI Server En esta sección Crear una plantilla de análisis de expresiones Crear una plantilla de análisis de expresiones Crear una plantilla de análisis de expresiones Cree una plantilla de análisis de expresiones para una plantilla de elementos seleccionada. Para guardar valores de salida, asígnelos a los atributos disponibles de la plantilla de elementos. Puede crear un atributo de salida al configurar un análisis. 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 cálculo. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Biblioteca y en el árbol de navegación, seleccione el elemento donde desee crear la plantilla de análisis. 2. Haga clic en la pestaña Plantillas de análisis. La pestaña Plantillas de análisis de la plantilla de elementos se abrirá en el panel del visor. Si no existe ninguna plantilla de análisis, haga clic en Crear plantilla de análisis para crear la primera. Si existen plantillas, haga clic en el icono del botón Plantilla de análisis nueva de la barra de herramientas situado encima de la tabla de análisis para crear otra. 3. Rellene los campos Nombre y, opcionalmente, Descripción. 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis, haga clic en Expresión. 6. Opcional: Haga clic en Seleccionar un elemento de ejemplo y elija un elemento en función de la plantilla de elementos actual para poder utilizar sus valores en la evaluación de la plantilla de análisis. Las plantillas no tienen datos concretos asociados con sus atributos. Es imposible evaluar una expresión en una plantilla de análisis, 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 expresión en una o varias líneas. 8. Determine qué filas desea asignar a atributos de salida. Asegúrese de asignar una fila como mínimo a un atributo de salida. 9. Seleccione una opción en Programa y configure una programación. 10. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). 11. Haga clic en Ingresar para guardar la plantilla de análisis y crear una instancia de ella para todos los elementos secundarios de la plantilla de elementos. PI System Explorer Guía del usuario 137

148 Asset-Based Analytics para PI Server Crear una plantilla de análisis de expresiones Antes de crear un análisis de expresión, determine los valores de salida que desee calcular y guardar. Identifique las funciones, operadores y atributos de entrada necesarios para el cálculo. Para guardar valores de salida, asígnelos a atributos del elemento. Puede crear un atributo de salida al configurar un análisis. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Elementos y, en el árbol de navegación, seleccione el elemento donde desee crear el análisis. 2. Haga clic en la pestaña Análisis. La pestaña Análisis del elemento se abrirá en el visor. Si no existe ningún análisis, haga clic en Crear análisis para crear el primero. Si existen análisis, haga clic en el icono del botón Nuevo análisis de la barra de herramientas situado encima de la tabla de análisis para crear otro. 3. Rellene los campos Nombre y, opcionalmente, Descripción. 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis,, haga clic en Expresión. 6. Introduzca la expresión en una o varias líneas. 7. Asegúrese de asignar como mínimo un atributo de salida. 8. (Opcional) Haga clic en Evaluar para comprobar que los valores de salida son como se esperaban. 9. Seleccione una opción en Programa para configurar una programación. 10. (Opcional) Para verificar el análisis, puede examinar los resultados que genera utilizando datos históricos. a. En la lista de análisis, pulse con el botón secundario sobre el nombre del análisis y seleccione Vista previa de resultados. b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y pulse Generar resultados para ver una lista de resultados. 11. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). Esta acción no ejecuta el análisis. 12. Para guardar el análisis, haga clic en Ingresar en la barra de herramientas. De esta forma, el análisis se guardará e insertará y podrá ejecutarse. Análisis de resumen Los análisis de resumen calculan valores estadísticos, como el total y el promedio de una serie de atributos asociados con un elemento. Por ejemplo, un análisis de resumen de un elemento de Fábrica podría utilizar el atributo Temperatura con todas las bombas de la fábrica para calcular el promedio de temperatura. 138 PI System Explorer Guía del usuario

149 Asset-Based Analytics para PI Server Los atributos para incluir en un análisis 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 también como agregación. Atributos de los elementos secundarios del elemento. Por ejemplo, es posible que necesite calcular el promedio de consumo de energía de un grupo de bombas en una refinería. Para ello, tendrá que crear un análisis de resumen en el elemento principal (la refinería) que calcule el promedio de atributos de consumo de energía a partir de sus elementos secundarios (bombas). 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 verificación junto a un atributo de la lista indica que se encuentra incluido en el resumen. También puede seleccionar las categorías Atributo y Elemento para elegir elementos de esas categorías. Puede elegir una plantilla de elementos para seleccionar atributos asociados con ella. Una vez seleccionados los atributos que desea incluir, elija las funciones estadísticas 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 automática los nuevos atributos que cumplan sus criterios de búsqueda. Podrá añadir o eliminar elementos o atributos de la jerarquía sin tener que actualizar el resumen. En esta sección Crear una plantilla de análisis de resumen Crear un análisis de resumen Crear una plantilla de análisis de resumen Cree una plantilla de análisis 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 análisis de resumen. Antes de empezar Antes de comenzar, identifique las funciones estadísticas que desee calcular en el resumen y dónde guardar los resultados. Cuando configure una plantilla de análisis, puede asignar los resultados de una función a uno de los atributos de la plantilla de elementos o crear un atributo de salida. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Biblioteca y seleccione la plantilla de elementos donde desee crear la plantilla de análisis. 2. Haga clic en la pestaña Plantillas de análisis. La pestaña Plantillas de análisis de la plantilla de elementos se abrirá en el panel del navegador. Si no existe ninguna plantilla de análisis, haga clic en Crear plantilla de análisis para crear la primera. Si existen plantillas, haga clic en PI System Explorer Guía del usuario 139

150 Asset-Based Analytics para PI Server el icono del botón Plantilla de análisis nueva de la tabla de análisis para crear otra. 3. Rellene los campos Nombre y, opcionalmente, Descripción. de la barra de herramientas situado encima 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis, haga clic en Resumen. 6. Seleccione una opción 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 selección para incluir atributos en el resumen. Una marca de verificación 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 categoría en Categoría de atributo para elegir atributos de esa categoría. (Si se ha seleccionado Elementos secundarios de) Seleccione una opción en Categoría de elemento y Plantilla de elemento. 8. Seleccione las funciones estadísticas que desee que calcule el resumen. 9. Pulse Asignar para asignar las salidas de las funciones incluidas a atributos de salida. También puede crear un atributo para una salida. 10. Seleccione una opción en Programa para configurar una programación. 11. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). 12. Para guardar la plantilla de análisis, haga clic en Ingresar en la barra de herramientas. Se creará una instancia del análisis para todos los elementos asociados. Crear un análisis de resumen Cree un análisis 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 estadísticas que desee que calcule el resumen. Para guardar los valores calculados, asigne su salida a atributos procedentes del elemento. También puede crear un atributo de salida al configurar el análisis. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Elementos y, en el árbol de navegación, seleccione el elemento donde desee crear el análisis. 2. Haga clic en la pestaña Análisis. La pestaña Análisis del elemento se abrirá en el visor. Si no existe ningún análisis, haga clic en Crear análisis para crear el primero. Si existen análisis, 140 PI System Explorer Guía del usuario

151 haga clic en el icono del botón Nuevo análisis encima de la tabla de análisis para crear otro. 3. Rellene los campos Nombre y, opcionalmente, Descripción. de la barra de herramientas situado 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis, 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 selección para incluir atributos en el resumen. Una marca de verificación 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 categoría en Categoría de atributo para elegir atributos de esa categoría. (Si se ha seleccionado Elementos secundarios de) Seleccione una opción en Categoría de elemento y Plantilla de elemento. 8. Seleccione las funciones estadísticas que desee que calcule el resumen. 9. Pulse Asignar para asignar las salidas de las funciones seleccionadas a atributos de salida. También puede crear un atributo para una salida. 10. (Opcional) Haga clic en Evaluar para comprobar que los valores de salida son como se esperaban. 11. Seleccione una opción en Programa para configurar una programación. 12. (Opcional) Para verificar el análisis, puede examinar los resultados que genera utilizando datos históricos. a. En la lista de análisis, pulse con el botón secundario sobre el nombre del análisis y seleccione Vista previa de resultados. b. Introduzca una hora de inicio y finalización que no sean posteriores a la hora actual y pulse Generar resultados para ver una lista de resultados. 13. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). Esta acción no ejecuta el análisis. 14. Para guardar el análisis, haga clic en Ingresar en la barra de herramientas. El análisis se guarda e inserta y puede ejecutarse. Análisis de generación de marcos de evento Asset-Based Analytics para PI Server Un análisis de generación de marcos de evento especifica las condiciones de inicio y finalización de los marcos de evento. Este tipo de análisis incluye una o dos expresiones. Cuando una condición única activa el inicio y la finalización de un marco de evento, solo se necesita la expresión 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 finalización sean distintas, se necesitará también una expresión EndTrigger. PI System Explorer Guía del usuario 141

152 Asset-Based Analytics para PI Server Dado que prueban las condiciones de inicio y finalización, las expresiones de los análisis de generación 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 análisis 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 análisis de generación de marcos de evento, asegúrese 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 análisis de generación 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 raíz. Para todos los marcos de evento, se genera un marco de evento de causa raíz secundario que captura los atributos durante un intervalo de tiempo específico justo antes del inicio del marco de evento. En esta sección Crear una plantilla de análisis de generación de marcos de evento Crear análisis de generación de marcos de evento Especificar durante cuánto tiempo debe ser verdadero un activador de inicio Crear una plantilla de análisis de generación de marcos de evento Antes de crear una plantilla de análisis de generación de marcos de evento, asegúrese de que la plantilla de marcos de evento esté disponible. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Biblioteca y en el árbol de navegación, seleccione el elemento donde desee crear la plantilla de análisis. 2. Haga clic en la pestaña Plantillas de análisis. La pestaña Plantillas de análisis de la plantilla de elementos se abrirá en el panel del visor. Si no existe ninguna plantilla de análisis, haga clic en Crear plantilla de análisis para crear la primera. Si existen plantillas, haga clic en el icono del botón Plantilla de análisis nueva de la barra de herramientas situado encima de la tabla de análisis para crear otra. 3. Rellene los campos Nombre y, opcionalmente, Descripción. 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis, haga clic en Generación de marco de evento. 6. Opcional: Haga clic en Seleccionar un elemento de ejemplo y elija un elemento en función de la plantilla de elementos actual para poder utilizar sus valores en la evaluación de la plantilla de análisis. Las plantillas no tienen datos concretos asociados con sus atributos. Es 142 PI System Explorer Guía del usuario

153 imposible evaluar una expresión en una plantilla de análisis, 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 opción en Plantilla de marco de evento. La plantilla determina la clase de marco de evento que se generará. 8. Introduzca una expresión en StartTrigger. Representa la condición booleana que inicia un marco de evento. 9. Opcional: Si una condición diferente finaliza el marco de evento, introduzca la expresión en el campo EndTrigger. 10. Opcional: introduzca un intervalo de tiempo en StartTrigger verdadero para. Este intervalo indica durante cuánto tiempo debe ser verdadera la condición StartTrigger para poder iniciar un marco de evento. La configuración de este intervalo de tiempo reduce la aparición de marcos de evento no deseados debido a una fluctuación momentánea 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 duración para generar un marco de evento de causa raíz para cada marco de evento. Un marco de evento de causa raíz 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. 12. Seleccione una opción en Programa y configure una programación. 13. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). 14. Haga clic en Ingresar para guardar la plantilla de análisis y crear una instancia del análisis para todos los elementos secundarios de la plantilla de elementos. Crear análisis de generación de marcos de evento Antes de crear un análisis de generación de marcos de evento, asegúrese de que la plantilla de marcos de evento esté disponible. Procedimiento 1. En el panel de navegación de PI System Explorer, haga clic en Elemento y en el árbol de navegación, seleccione el elemento donde desee crear el análisis. 2. Haga clic en la pestaña Análisis. Si el elemento no tiene ningún análisis, haga clic en Crear análisis; si tiene alguno, haga clic en el icono Nuevo análisis en la barra de herramientas encima de la tabla de análisis. 3. Rellene los campos Nombre y, opcionalmente, Descripción. 4. Opcional: Haga clic en la lista desplegable Categorías para mostrar las categorías disponibles que puede asignar al análisis. Marque las categorías que desee asignar y haga clic en Seleccionar. Para crear una categoría, haga clic en Nuevo. Introduzca un nombre y una descripción para la nueva categoría y haga clic en Aceptar. 5. En Tipo de análisis, haga clic en Generación de marco de evento. Asset-Based Analytics para PI Server 6. Seleccione una opción en Plantilla de marco de evento. La plantilla determina la clase de marco de evento que se generará. 7. Introduzca una expresión en StartTrigger. Representa la condición booleana que inicia un marco de evento. PI System Explorer Guía del usuario 143

154 Asset-Based Analytics para PI Server 8. Opcional: Si una condición diferente finaliza el marco de evento, introduzca la expresión en el campo EndTrigger. 9. Opcional: introduzca un intervalo de tiempo en StartTrigger verdadero durante. Este intervalo indica durante cuánto tiempo debe ser verdadera la condición StartTrigger para poder iniciar un marco de evento. La configuración de este intervalo de tiempo reduce la aparición de marcos de evento no deseados debido a un pico momentáneo en los datos de entrada. 10. Seleccione una opción en Programa y configure una programación. 11. Para aplicar los cambios y guardar el trabajo de forma local, haga clic en Aplicar cambios (la marca de verificación de color verde de la barra de herramientas). 12. Pulse Ingresar para guardar el análisis e insertarlo para que pueda utilizarse. Especificar durante cuánto tiempo debe ser verdadero un activador de inicio Un análisis de generación de marcos de evento inicia un marco de evento cuando la condición del activador de inicio es verdadera. Dado que el pico aleatorio de un valor de entrada puede convertir a esa condición 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 condición de activador de inicio pase a ser verdadera, el valor StartTrigger verdadero durante determina cuánto 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 finalización del marco de evento. Gestión de los análisis de un elemento Cuando se crea un análisis, se añade a una tabla de análisis encima de la expresión. Podrá ver el estado actual de cada análisis de la tabla, si está asociado o no con una plantilla, su tipo de análisis, nombre y estado de reposición. Pase el puntero del ratón sobre los elementos o los iconos de la lista para ver su información sobre herramientas. Para ver la expresión y planificación de un análisis, selecciónelo en la lista de análisis. En la tabla de análisis, podrá realizar las siguientes operaciones: Crear un análisis Haga clic en el icono Nuevo análisis en la parte superior de la tabla. Ejecutar o detener un análisis seleccionado Seleccione un análisis y haga clic en el icono Ejecutar o Detener en la parte superior de la tabla, o haga clic con el botón secundario en cualquier lugar de la tabla y seleccione Nuevo. Vista previa de resultados Puede obtener una vista previa de los resultados de un análisis para ver cómo funciona a lo largo de un intervalo de tiempo. Pulse con el botón secundario sobre un análisis y seleccione 144 PI System Explorer Guía del usuario

155 Vista previa de los resultados. Puede exportar la tabla de resultados a una hoja de cálculo o copiar filas seleccionadas de la tabla de resultados en otras aplicaciones. Seleccionar columnas para mostrar Pulse con el botón secundario sobre cualquier encabezado de columna de la tabla de análisis y seleccione encabezados para mostrar. Reponer datos para un análisis Haga clic con el botón secundario sobre un análisis y seleccione Reponer. Ir a la plantilla Un análisis incluido en la lista con el icono de plantilla se basa en un análisis de plantilla. Para abrir la plantilla directamente desde el análisis, pulse con el botón secundario sobre el análisis y seleccione Ir a plantilla. Restablecer a plantilla Solo puede realizar cambios de programación en un análisis que se base en una plantilla de análisis. Para volver a sincronizar la programación de un elemento con la programación de su plantilla, pulse con el botón secundario sobre el análisis y seleccione Restablecer a plantilla. Convertir a plantilla Si el elemento de un análisis se deriva de una plantilla de elementos, podrá convertir el análisis en una plantilla de análisis en esa plantilla de elementos. Pulse con el botón secundario sobre el análisis y seleccione Convertir a plantilla. Esta función permite crear y depurar un análisis en relación con un elemento específico antes de generalizarlo como plantilla. En esta sección Nota: Si alguna de las salidas de análisis escribe en un PI point específico, se le solicitará que elija cómo especificar el PI point en la plantilla de análisis para garantizar que las salidas de los análisis derivados escriban en PI points únicos. Reponer datos de un análisis Gestión de la seguridad de los análisis y las plantillas de análisis Asset-Based Analytics para PI Server Reponer datos de un análisis Un análisis genera nuevos datos para sus atributos de salida, que normalmente están mapeados a PI points para guardar los datos y elaborar historiales de ellos. Puede ejecutar un análisis a lo largo de un período 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 período de tiempo, deberá eliminar esos datos antes de utilizar la reposición. Procedimiento 1. En la lista de análisis de la pestaña Plantilla de análisis, haga clic con el botón secundario sobre el análisis en ejecución que desee utilizar para reponer datos. 2. Seleccione Reposición en el menú emergente. 3. Especifique el período de tiempo para el que desea reponer datos. PI System Explorer Guía del usuario 145

156 Asset-Based Analytics para PI Server 4. Haga clic en Aceptar para iniciar la reposición. La columna Estado del análisis muestra un indicador de progreso hasta que finaliza la reposición. 5. Opcional: Para consultar el estado de la reposición o cancelarla, haga clic con el botón secundario en el análisis y haga clic en Estado de reposición. Gestión de la seguridad de los análisis y las plantillas de análisis Puede consultar o gestionar permisos para limitar el acceso a los análisis y las plantillas de análisis en dos niveles: Para un único análisis o plantilla de análisis: 1. En la lista de la pestaña Análisis (o Plantillas de análisis), pulse con el botón secundario sobre el análisis (o la plantilla de análisis) y seleccione Seguridad. 2. En la ventana Permisos, consulte o modifique los grupos y permisos y, a continuación, haga clic en Aceptar. Para todos los análisis o plantillas de análisis 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 botón secundario sobre una base de datos y seleccione Seguridad > Análisis o Seguridad > Plantillas de análisis. 3. En la ventana Permisos, consulte o cambie los grupos y permisos y, a continuación, haga clic en Aceptar. Análisis de ejemplo Los análisis de ejemplo incluidos en esta sección realizan los siguientes cálculos en la misma base de datos de AF: 1. Utiliza un análisis de tipos de una expresión para realizar un seguimiento de la desviación de la eficiencia por parte del activo y los procesos representados por el elemento, Etileno. 2. Crea una plantilla para generar un conjunto de análisis de resumen que sumen la energía total extraída por todos los procesos de una refinería. La plantilla de elementos a partir de la cual se ha creado el elemento de cada refinería se denomina Refinería. 3. Crea marcos de evento para capturar datos siempre que el promedio de eficiencia de ejecución de 15 minutos del elemento, Etileno, descienda por debajo del 90%. Crear un análisis de expresión En este ejemplo se muestra cómo crear un análisis de tipos de expresión. El análisis realiza un seguimiento de la desviación de la eficiencia respecto de la eficiencia meta. En primer lugar, calcularemos el promedio de eficiencia por horas y después determinaremos el grado de desviación respecto a la eficiencia meta. En este ejemplo, se utiliza un PI point existente para almacenar los datos de los resultados (la desviación respecto de la eficiencia meta, a medida que varía a lo largo del tiempo). Cuando cree sus propios análisis, OSIsoft le recomienda crear los PI points que necesite para los datos de resultados antes de crear el análisis. 146 PI System Explorer Guía del usuario

157 Asset-Based Analytics para PI Server Procedimiento 1. En Elementos, vaya al elemento para el que desea realizar el análisis, Etileno. 2. Seleccione la pestaña Análisis. 3. Cree un análisis. Para ello, haga clic en Crear nuevo análisis o en el botón correspondiente a los análisis nuevos. 4. En Tipo de análisis, especifique Expresión. El tipo de análisis de expresión es el más simple; solo contiene una o varias expresiones e información sobre la programación. Para obtener más información, consulte Análisis de expresiones. 5. Escriba un nombre para el análisis en el campo Nombre; por ejemplo, CálcEficiencia. 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 Expresión. 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 Añadir nueva expresión. b. Asigne a la variable el nombre EficienciaPorHora. c. Introduzca la siguiente sintaxis de ecuación de rendimiento en la columna Expresión: TagAvg('Efficiency', '*-1h', '*') PI System Explorer Guía del usuario 147

158 Asset-Based Analytics para PI Server Esta expresión 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 desvía de la eficiencia meta, 90. a. Haga clic en Añadir nueva expresión. b. Asigne a la variable el nombre Desviación. c. Introduzca la siguiente expresión en la columna Expresión: HourlyEfficiency - Target 9. Guarde el resultado de la variable, Desvío, 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 denomínelo, 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 Programación, especifique Periódico. 11. Haga clic en Configurar y especifique un período de 30 segundos. El cálculo se ejecutará cada 30 segundos. 12. Para comprobar si los datos son válidos, haga clic con el botón secundario sobre el análisis 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 finalización si lo prefiere. b. Haga clic en Generar resultados. 13. Cuando esté satisfecho con el nuevo análisis, guarde su trabajo. 148 PI System Explorer Guía del usuario

159 Asset-Based Analytics para PI Server 14. Busque el círculo de color verde en la columna de estado de la tabla de análisis, para comprobar que el servicio está ejecutando el análisis. 15. También, puede reponer los datos a lo largo de un período de tiempo, si ese intervalo de tiempo no contiene datos todavía. Los resultados se repondrán 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 continuación, reponer ese intervalo de tiempo. a. Haga clic con el botón secundario sobre el análisis en la lista de análisis y seleccione Reponer. b. Especifique una hora de inicio y de finalización para la reposición. c. Haga clic en Iniciar. Crear una plantilla de análisis de resumen En este ejemplo se muestra cómo crear una plantilla para generar un conjunto de análisis de resumen. La plantilla de análisis suma la energía total extraída de todos los procesos de una refinería. Procedimiento 1. En Biblioteca, seleccione la plantilla de elementos para el activo que desea analizar. En este ejemplo, la plantilla de análisis se denomina Refinería. Es la plantilla a partir de la cual se creará el elemento de cada refinería. 2. Seleccione la pestaña Plantillas de análisis. 3. Haga clic en Crear plantilla de análisis o en el botón para las plantillas de análisis nuevas. 4. En Tipo de análisis, especifique Resumen. Los análisis de resumen calculan datos estadísticos para los atributos especificados, como el total o el promedio. Para obtener más información, consulte Análisis de resumen. Al final de este procedimiento se muestra un ejemplo de la configuración del cuadro de diálogo Plantillas de análisis. 5. Escriba un nombre para el análisis en el campo Nombre; por ejemplo, ResumenEnergía. 6. Haga clic en Seleccionar un elemento de ejemplo para especificar el elemento que PI System Explorer utilizará como orientación para definir la plantilla de análisis. Por ejemplo, en la lista de elementos derivados de la plantilla Refinería, seleccione Refinería de Rotterdam y haga clic en Aceptar. 7. En Atributos de resumen de, seleccione Elementos secundarios de Refinería de Rotterdam para incluir la información de todos los elementos secundarios de la refinería. 8. Configure los atributos para resumir. a. Introduzca el nombre del atributo en Nombre de atributo. Puede utilizar un carácter comodín para recopilar información sobre atributos con nombres similares. Por ejemplo, introduzca la cadena Power* para especificar todos los atributos que empiecen por Power. Los atributos encontrados se mostrarán en la tabla Atributos. b. Seleccione la categoría del atributo en el campo Categoría de atributo. PI System Explorer Guía del usuario 149

160 Asset-Based Analytics para PI Server c. En Seleccione la función o funciones para escribir en un atributo, seleccione la función 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 parámetros de sustitución predeterminados para los campos PI Server y Nombre de tag. f. Haga clic en Ajustes. g. Seleccione Creación de tag para crear un tag. h. Haga clic en el botón 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 demás 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 válido. 10. En Programación, especifique Activado por evento. 11. Para ver los resultados de los datos recientes, haga clic con el botón secundario sobre el análisis 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 finalización. b. Haga clic en Generar resultados. 12. Cuando esté satisfecho con la nueva plantilla de análisis, guarde su trabajo. 13. Para crear la referencia de datos de PI point que utilizará este análisis con todas las refinerías creadas a partir de esta plantilla, en Elementos, vaya a Petrolux Corporation \Downstream\Refineries. a. Pulse con el botón secundario del ratón sobre el elemento Refinerías y seleccione Crear o actualizar referencia de datos para crear la referencia de datos de PI point para cada refinería. b. Guarde su trabajo. 150 PI System Explorer Guía del usuario

161 Asset-Based Analytics para PI Server Ejemplo Crear de forma automática marcos de evento para realizar un seguimiento de los datos En el ejemplo, Crear un análisis de expresión, hemos creado un análisis de muestra para realizar un seguimiento de la desviación 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 ejecución 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 botón secundario sobre Plantillas de marcos de evento y seleccione Nueva plantilla. O seleccione Nueva plantilla en la barra de menús. 3. Asigne a la plantilla el nombre AnomalíaEficiencia. 4. En el campo Patrón de nombres, seleccione %ELEMENT% y, a continuación, %STARTTIME:yyyy-MM-dd HH:mm:ss.fff%. El campo Patrón 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 sustitución que se resolverán en el momento de la creación. Por ejemplo, el patrón de nombres "EF%ELEMENT%_%STARTTIME:yyyy-MM-dd HH:mm:ss.fff%. PI System Explorer Guía del usuario 151

162 Asset-Based Analytics para PI Server La cadena de sustitución STARTTIME incluye el patrón de formato fecha-hora que se utilizará. 5. Haga clic en la pestaña 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. Denomínela Eficiencia. c. Haga clic en Ajustes e introduzca la siguiente cadena de configuración 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 análisis, en Crear un análisis de expresión. El elemento se encuentra ubicado en Petrolux Corporation\Petrochemicals\Maua \Ethylene. 8. Seleccione la pestaña Análisis. 9. Pulse el botón Nuevo análisis. 10. Asigne al análisis el nombre EventoAnomalíaEficiencia. 11. Defina el campo Tipo de análisis como Generación de marcos de evento. 12. En Plantilla de marco de evento, especifique AnomalíaEficiencia. Esta es la plantilla de marcos de evento que acaba de crear en los pasos anteriores. 152 PI System Explorer Guía del usuario

163 Asset-Based Analytics para PI Server 13. En StartTrigger, introduzca la expresión: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 expresión: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 Periódico para la programación y haga clic en Configurar para que el análisis se ejecute cada minuto. 17. Guarde su trabajo. Gestión de análisis en la base de datos de AF (Esta función está disponible si su instalación de PI System Explorer incluye el plug-in de gestión de análisis.) Haga clic en Análisis en el panel del navegador para ver y gestionar los análisis de la base de datos de AF actual. En el panel del navegador podrá especificar criterios de filtro para mostrar una tabla de análisis en el visor. Las columnas de tabla son: PI System Explorer Guía del usuario 153

164 Asset-Based Analytics para PI Server Status (Tipo de análisis) Elemento Nombre de análisis Plantilla Estado de reposición Puede llevar a cabo diferentes acciones en los análisis 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 ejecución o Detenido) se mostrarán debajo del filtro con un recuento que muestra el número de análisis en cada grupo. Seleccione un grupo para mostrar los análisis que coinciden con él en la tabla. Operaciones Aplique las operaciones de iniciar, detener y reponer a todos los análisis seleccionados de la tabla. Detalles de análisis Haga clic en el botón de alternancia de Detalles de análisis para ver los detalles de los análisis seleccionados actualmente en la tabla. Para ver un resumen de la configuración y el estado del análisis, haga clic en la pestaña Información general. Para ver detalles de los errores, haga clic en la pestaña Errores y avisos. Para ver o editar los análisis seleccionados, haga clic en Configuración de análisis para ir a la pestaña Análisis de su elemento asociado. Gestión de PI Analysis Service (Estas opciones están disponibles si su instalación de PI System Explorer incluye el módulo Analysis Management y ha iniciado sesión con una cuenta de usuario con permisos para configurar PI Analysis Service.) PI Analysis Service ejecuta todos los análisis en el servidor de PI AF actual. Dos de sus características le ayudarán a gestionar el servicio de análisis: La ventana Estadísticas de Analysis Service le permite explorar estadísticas sobre el servicio para supervisar sus operaciones. Estas estadísticas son especialmente importantes para diagnosticar problemas de rendimiento en una solución. Puede guardar estas estadísticas en un archivo de texto, que puede ofrecer un snapshot completo de su servicio de análisis para compartir con el personal del servicio de soporte que le ayude a resolver un problema. La ventana Configuración le permitirá ver o modificar los valores de las propiedades del servicio de análisis para ajustar el rendimiento. 154 PI System Explorer Guía del usuario

165 Asset-Based Analytics para PI Server Ver estadísticas del servicio de análisis Procedimiento 1. En el panel de navegación, haga clic en Análisis para ver el área de gestión de análisis. 2. Pulse con el botón derecho del ratón en cualquier lugar del panel Operaciones y seleccione Ver estadísticas de servicio. La ventana Estadísticas de Analysis Service muestra grupos de estadísticas que puede utilizar para supervisar las operaciones del servicio de análisis o diagnosticar problemas de rendimiento e identificar una solución. 3. Opcional: Haga clic en Actualizar para actualizar las estadísticas con datos actuales. 4. Opcional: Haga clic en Guardar para guardar las estadísticas actuales como un archivo de texto. De esta forma, podrá compartir un snapshot del estado actual de su servicio de análisi con el personal del servicio de soporte técnico al cliente. Ver o modificar el servicio de análisis Nota: La modificación de estos parámetros puede afectar muy negativamente al rendimiento del sistema. Si tiene alguna duda sobre cómo cambiar los parámetros predeterminados, solcite ayuda al personal del servicio de soporte técnico al cliente. Procedimiento 1. En el panel de navegación, haga clic en Análisis para ver el área de gestión de análisis. 2. Pulse con el botón derecho del ratón en cualquier lugar del panel Operaciones y seleccione Ver estadísticas de servicio. En la ventana Configuración se muestran los parámetros de las propiedades del servicio de análisis. Consulte el apartado Configuración del servicio de análisis para conocer más detalles sobre estos parámetros. 3. Para modificar una propiedad, edite su valor en la columna Configuración. 4. Haga clic en Aceptar para aplicar los cambios y cerrar la ventana. Configuración del servicio de análisis En la ventana Configuración puede modificar estos parámetros. AutoBackfillingEnabled Esta propiedad rellena de forma automática las lagunas en los datos que se producen como consecuencia de períodos en los que el servicio de análisis no está activo. La reposición automática 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 análisis almacenará en caché para los atributos utilizados como entradas de los cálculos. El servicio de análisis recortará los datos con una antigüedad de más de 5 minutos antes de la hora de evaluación pendiente más antigua. Un período de tiempo mayor garantiza que los datos de entrada necesarios para los cálculos estarán disponibles en la caché de los datos, pero utiliza más recursos de sistema. Para los cálculos que requieran datos anteriores (por ejemplo, una hora antes), puede especificar un período más largo en esta opción 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 parámetro MaxCacheEventsPerAttributes prevalece sobre esta opción, por lo que ambas opciones se deben ajustar simultáneamente. PI System Explorer Guía del usuario 155

166 Asset-Based Analytics para PI Server CalculationsWaitTimeInSeconds En lugar de evaluar de forma inmediata los cálculos activados por eventos, puede especificar un período de tiempo de espera antes de llevar a cabo la evaluación. Este tiempo de espera se puede utilizar para compensar las entradas que llegan más tarde. Por ejemplo, si un cálculo depende de una interfaz con una latencia conocida de más de 30 segundos, podría ajustar este parámetro a 30 segundos como mínimo para asegurarse de que se obtendrá el evento más reciente de la interfaz. Un parámetro más largo reducirá las posibilidades de perder entradas de cálculo causadas por la latencia, pero aumentará el tiempo que tardarán en obtenerse los resultados. Tenga en cuenta que los cálculos utilizan los valores de entrada de la marca de tiempo de activación cuando se evalúan. El valor predeterminado de esta propiedad es 5 segundos. EvaluationPartitionSize Los cálculos se agrupan para obtener evaluaciones eficaces. Los análisis basados en una plantilla de análisis con una programación periódica, por ejemplo, se evalúan juntos como un solo grupo de cálculo. Para agilizar la evaluación, los grupos de cálculo muy grandes se dividen en subgrupos con el parámetro EvaluationPartitionSize; ahora los subgrupos se podrán evaluar en paralelo. El valor predeterminado de esta propiedad es Para un grupo de análisis con tiempos de evaluación individual largos, es posible que desee especificar un tamaño de partición más pequeño. La evaluación de un grupo de 100 análisis, cada uno de los cuales realiza cálculos de resumen de los datos de un día, puede realizarse con más rapidez que 4 subgrupos con un tamaño de partición de 25, en función de los recursos disponibles en la máquina. EvaluationsToQueueBeforeSkipping Si se tarda demasiado en ejecutar un grupo de cálculos, la cola de los cálculos en espera puede ser imposible de manejar. Este parámetro determina cuándo omitir los cálculos para evitar quedarse sin recursos. En la configuración por defecto, si se encuentran más de 50 evaluaciones, el servicio de análisis empieza a omitir las evaluaciones más antiguas para intentar recobrar su proceso normal. IsLoadSheddingEnabled En algunas aplicaciones, la precisión y la integridad son esenciales y no se puede omitir ningún cálculo al margen del tiempo que tarden en realizarse. Para desactivar la omisión de cálculos, introduzca Falso en este parámetro. IsTelemetryAllowed Introduzca Falso para detener el envío de los datos de uso desde el servicio de análisis al programa de mejora de la experiencia de los usuarios. (Esto no afectará al parámetro correspondiente de la partición en el programa, que puede configurar en PI System Explorer.) MaxCacheEventsPerAttribute Cuando se alcanza este límite, se elimina los eventos más antiguos de la caché de datos. Tenga en cuenta que este parámetro 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 través de las canalizaciones de datos. El uso de una única canalización de datos para actualizar un gran número de atributos puede tardar un tiempo inasumible. Para reducir el tiempo de 156 PI System Explorer Guía del usuario

167 actualización, puede aumentar el número de canalizaciones de datos que pueden funcionar de forma simultánea. Esto puede resultar especialmente útil en el caso de cálculos con datos que presentan una alta frecuencia. Tenga presente que al aumentar el número de canalizaciones de datos, aumentará la carga de trabajo de PI Data Archive. Valor predeterminado de creación automática de PI Points para la plantilla Cuando se selecciona esta opción, el servicio de análisis crea de forma automática PI Points para los atributos de salida en los análisis derivados de las plantillas de análisis. Nombre de PI Point recomendado Asset-Based Analytics para PI Server Puede modificar aquí el patrón de nombres con cualquiera de los parámetros que se muestran en Lista de parámetros de sustitución de PI AF. Sin embargo, tenga en cuenta que puede que algunos parámetros no tengan significado en el contexto de un nombre de PI point. Referencia de funciones de expresión Se muestran en orden alfabético las funciones disponibles para utilizar con expresiones de análisis. Abs Devuelve el valor absoluto de un número entero o real. Sintaxis Abs(x) Argumentos x Debe ser un número entero o real. Devuelve El valor absoluto de x. Excepciones Si x no es un número 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 número entero o real. El coseno inverso de x es el ángulo en radianes cuyo coseno equivale a x. Sintaxis Acos(x) PI System Explorer Guía del usuario 157

168 Asset-Based Analytics para PI Server Argumentos x Debe ser un número real entre -1.0 y 1.0, inclusive. Devuelve El coseno inverso de x, en radianes. Excepciones Si x no es un número, 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 conjunción lógica de dos expresiones. Devuelve True si ambas expresiones son verdaderas; devuelve False en caso contrario. Sintaxis expression1 AND expression2 Argumentos expression1, expression2 Cualquier expresión 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 código de carácter ASCII del primer carácter de una cadena. Sintaxis Ascii(s) Argumentos s Cualquier expresión que se evalúe en una cadena. 158 PI System Explorer Guía del usuario

169 Asset-Based Analytics para PI Server Devuelve El código del primer carácter 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 número. El seno inverso de x es el ángulo en radianes cuyo seno equivale a x. Sintaxis Asin(x) Argumentos x Debe ser un número real entre -1.0 y 1.0, inclusive. Devuelve El seno inverso de x, en radianes. Excepciones Si x no es un número, 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 número entero o real. La tangente inversa de x es el ángulo en radianes cuya tangente equivale a x. Sintaxis Atn(x) Argumentos x Debe ser un número entero o real. Devuelve La tangente inversa de x, en radianes. PI System Explorer Guía del usuario 159

170 Asset-Based Analytics para PI Server Excepciones Si x no es un número entero o real, devuelve un error. 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 línea cuyos puntos finales son el origen y las coordenadas cartesianas (b,a). Sintaxis Atn2(a,b) Argumentos a b Un número entero o real Un número 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 número 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 números, horas o períodos, pero todos deben ser del mismo tipo. 160 PI System Explorer Guía del usuario

171 Asset-Based Analytics para PI Server 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 ejecución sean cadenas de caracteres o estados digitales no se incluyen en el promedio. Si todos los valores son cadenas de caracteres o estados digitales, Avg devuelve un error. 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 día. Sintaxis Bod(t1) PI System Explorer Guía del usuario 161

172 Asset-Based Analytics para PI Server Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve La marca de tiempo del comienzo del día. Excepciones Ninguna. Notas Esta función es útil para establecer una hora de reloj única independiente de la duración de días 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 expresión de tiempo. Devuelve La marca de tiempo del comienzo del mes. Excepciones Ninguna. Notas Esta función es útil para establecer una hora de reloj única independiente de la duración de días 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. 162 PI System Explorer Guía del usuario

173 Asset-Based Analytics para PI Server Sintaxis Bonm(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve La marca de tiempo del comienzo del mes siguiente. Excepciones Ninguna. Notas Esta función es útil para establecer una hora de reloj única independiente de la duración de días concretos. Ejemplo Bonm('*') Bonm('y') Bonm(FindEq('tag1', '14-Dec-97', '+17d',50)) Ceiling Devuelve el entero más pequeño no menor que x. Sintaxis Ceiling(x) Argumentos x Cualquier valor numérico. Devuelve El entero más pequeño no menor que x. Excepciones Ninguna. Ejemplo Ceiling('tag1') Ceiling (TagVal('tag2','14-Dec-97')) Char Genera una cadena a partir de códigos de carácter ASCII. Sintaxis Char( x1 [,... xn] ) PI System Explorer Guía del usuario 163

174 Asset-Based Analytics para PI Server Argumentos x1, xn Números o expresiones. Devuelve Una cadena generada a partir de códigos de carácter. Excepciones Si un argumento no es un número, devuelve un error. Ejemplo Char(80, 73) = "PI" Char(65) = "A" Char(6 * 9) = "6" Compare Comparar dos cadenas utilizando caracteres comodín ("*" y "?"). Sintaxis Compare(s1, s2 [,casesensitive]) Argumentos s1, s2 Cadenas (s2 puede incluir caracteres comodín) casesensitive Indicador opcional que señala si la comparación distingue entre mayúsculas y minúsculas. Si es False (el valor predeterminado), la comparación no distingue entre mayúsculas y minúsculas. Si es True (el valor predeterminado), la comparación distingue entre mayúsculas y minúsculas. Devuelve 1 si s1 = s2 0 de lo contrario Excepciones Los caracteres comodín 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") = PI System Explorer Guía del usuario

175 Asset-Based Analytics para PI Server Concat Concatenación de dos o más 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 función no inserta espacios en blanco entre los argumentos. Para incluir un espacio en la cadena concatenada, añada un argumento que conste de una cadena que sea un único espacio incluido entre comillas dobles. Nota: Ejemplo Plantéese utilizar Text, que en muchos casos es más general y preciso que Concat. 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 expresión que se resuelve en un valor numérico, incluido el nombre de un atributo numérico incluido entre comillas simples, un nombre de variable o una constante. tounit La UOM de salida incluida entre comillas dobles. Devuelve El valor numérico convertido en la UOM especificada. Excepciones Devuelve un error si tounit y la UOM inicial dex no están en la misma clase de UOM. Ejemplo Convert('MetricWeight', "lb") Convert('Ambient Temperature', "C") PI System Explorer Guía del usuario 165

176 Asset-Based Analytics para PI Server Cos Devuelve el coseno trigonométrico de un número entero o real. Sintaxis Cos(x) Argumentos x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve El coseno de x. Excepciones Si x no es un número entero o real, devuelve un error. Ejemplo Cos('tag1') Cos(1) Cos(1.1) Cosh Devuelve el coseno hiperbólico de un número entero o real. Sintaxis Cosh(x) Argumentos x Debe ser un número entero o real. Devuelve El coseno hiperbólico de x. Excepciones Si x no es un número entero o real, devuelve un error. Ejemplo Cosh('tag1') Cosh(.9) Cosh(1) Cot Devuelve la cotangente trigonométrica de un número. 166 PI System Explorer Guía del usuario

177 Asset-Based Analytics para PI Server Sintaxis Cot(x) Argumentos x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve La cotangente de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Cot('tag1') Cot(1) Cot(1.1) Coth Devuelve la cotangente hiperbólica de un número. Sintaxis Coth(x) Argumentos x Debe ser un número entero o real. Devuelve La cotangente hiperbólica de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Coth('tag1') Coth(1) Coth(1.1) Csc Devuelve la cosecante trigonométrica de un número. Sintaxis Csc(x) Argumentos PI System Explorer Guía del usuario 167

178 Asset-Based Analytics para PI Server x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve La cosecante de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Csc('tag1') Csc(1) Csc(1.1) Csch Devuelve la cosecante hiperbólica de un número. Sintaxis Csch(x) Argumentos x Debe ser un número entero o real. Devuelve La cosecante hiperbólica de x. Excepciones Si x no es un número, devuelve un error. 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 Expresión que se evalúa en relación con un número. 168 PI System Explorer Guía del usuario

179 x1, y1 El primer punto de la curva. Los valores xi' e yi son constantes numéricas que se evalúan durante el tiempo de compilación. Los valores definidos para xi deben ordenarse en sentido ascendente. Devuelve Devuelve el valor y de la curva que corresponde al valor x. La interpolación 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 están ordenados en el sentido x del más pequeño al más grande. Excepciones Si el valor x no es un número entero o real, se devuelve un error. Ejemplo curve('tag1', (0,100) (100,0) ) //inverter curve('tag3', (25,25) (75,75) ) //limiter Asset-Based Analytics para PI Server Day Extrae el día del mes a partir de una expresión de tiempo. Sintaxis Day(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El día del mes, en el rango Excepciones Ninguna. Ejemplo Day('*') Day('t') Day(FindGt('tag1', '*-30d', '*',50)) DaySec Extrae el número de segundos desde la medianoche a partir de una expresión de tiempo. Sintaxis DaySec(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. PI System Explorer Guía del usuario 169

180 Asset-Based Analytics para PI Server Devuelve El número de segundos desde la medianoche, en el rango Excepciones Ninguna. Notas Esta función es la misma que la función Time del paquete Performance Equation ds PI 2.x. Por ejemplo, si la hora actual son las 8:30 A.M.,DaySec('*') devuelve 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 x Una cadena de caracteres que representa un estado digital. (Opcional) Un punto digital en el que la cadena de caracteres representa un estado digital. Si se omite, se buscarán todos los conjuntos de estados digitales, empezando por el conjunto digital del sistema, para la cadena proporcionada. Devuelve Un valor de enumeración. En el caso de los cálculos 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 función 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. 170 PI System Explorer Guía del usuario

181 Asset-Based Analytics para PI Server 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 condición 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 expresión condicional IF-THEN- ELSE es False. Sintaxis IF (expression) THEN (x) ELSE (y) Argumentos expression Cualquier expresión que se evalúe como True o False. PI System Explorer Guía del usuario 171

182 Asset-Based Analytics para PI Server x, y Una expresión que devuelve un valor de salida. Devuelve La salida x, cuando la expresión condicional es True (distinta de cero), y la salida y, cuando la expresión 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 expresión de tiempo que representa el comienzo del intervalo de tiempo objeto de búsqueda. endtime Una expresión de tiempo posterior a starttime; el final del intervalo de tiempo objeto de búsqueda. PRECAUCIÓN: Evite utilizar un tiempo futuro para endtime. Un intervalo de tiempo que contenga eventos futuros sin archivar puede producir resultados erróneos en cuanto al recuento de eventos. pctgood Opcional. Porcentaje de tiempo mínimo 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 mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. 172 PI System Explorer Guía del usuario

183 Asset-Based Analytics para PI Server 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 número entero o real. Representa el número e x, donde e = Sintaxis Exp(x) Argumentos x Debe ser un número entero o real. Devuelve El exponencial de x. Excepciones Si x no es un número entero o real, devuelve un error. 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 expresión de tiempo que representa el comienzo del intervalo para buscar. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Una expresión 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 expresión PI System Explorer Guía del usuario 173

184 Asset-Based Analytics para PI Server relativa. Si la hora de finalización es anterior a la hora de inicio, se busca hacia atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. Devuelve La marca de tiempo más 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 expresión de tiempo que representa el comienzo del intervalo de tiempo para buscar o una hora relativa a la hora de finalización si esta es una hora. endtime Una expresión 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 finalización es anterior a la hora de inicio, se busca hacia atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. 174 PI System Explorer Guía del usuario

185 Asset-Based Analytics para PI Server Devuelve La marca de tiempo más cercana a la hora de inicio, dentro del intervalo proporcionado, en la 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Una expresión de tiempo que representa el comienzo del intervalo de tiempo para buscar. Puede ser una hora relativa a la hora de finalización si esta es una hora. endtime Final del intervalo de tiempo para buscar, la expresión 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 atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. Devuelve La marca de tiempo más cercana a la hora de inicio, dentro del intervalo proporcionado, en la 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. PI System Explorer Guía del usuario 175

186 Asset-Based Analytics para PI Server 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 valor proporcionado. Sintaxis FindLE(tagname, starttime, endtime, value) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime El comienzo del intervalo de tiempo para buscar; expresión de tiempo o tiempo relativo a la hora de finalización si esta es una marca de tiempo. endtime El final del intervalo de tiempo para buscar; expresión de tiempo o 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 atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. Devuelve La marca de tiempo más cercana a la hora de inicio, dentro del intervalo proporcionado, en la 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. 176 PI System Explorer Guía del usuario

187 Asset-Based Analytics para PI Server 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime El comienzo del intervalo de tiempo para buscar; expresión de tiempo o tiempo relativo a la hora de finalización si esta es una marca de tiempo. endtime El final del intervalo de tiempo para buscar; expresión de tiempo o 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 atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. Devuelve La marca de tiempo más cercana a la hora de inicio, dentro del intervalo proporcionado, en la 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: , '*',40.0) PI System Explorer Guía del usuario 177

188 Asset-Based Analytics para PI Server 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime El comienzo del intervalo de tiempo para buscar; expresión de tiempo o tiempo relativo a la hora de finalización si esta es una marca de tiempo. endtime El final del intervalo de tiempo para buscar; expresión de tiempo o 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 atrás en el intervalo. value Debe ser un número entero o real o un estado digital (cadena de caracteres), el valor para buscar. Devuelve La marca de tiempo más cercana a la hora de inicio, dentro del intervalo proporcionado, en la 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 número. Sintaxis Float(x) Argumentos x Una cadena o un número. 178 PI System Explorer Guía del usuario

189 Asset-Based Analytics para PI Server Devuelve Un número para una cadena numérica y Calc Failed para una cadena no numérica. Si x ya es un número, se devuelve x. Ejemplo Float(12.3) = 12.3 Float('sinusoid') Float("-12.3") = Floor Devuelve el entero más grande no mayor quex. Sintaxis Floor(x) Argumentos x Cualquier valor numérico. Devuelve El entero más grande no mayor que x. Excepciones Ninguna. Ejemplo Floor('tag1') Floor (TagVal('tag2','14-Dec-97')) Formato Convierte un número en una cadena en función de una expresión de formato. Sintaxis Format(x, format [,numtype ]) Argumentos x Un valor numérico (real o entero). format Cadena de control de formato. Es la misma que se utiliza en la función de lenguaje C.Sprintf. numtype Opcional. Carácter que indica el tipo de número: R (real) o I (entero). El valor predeterminado es R. PI System Explorer Guía del usuario 179

190 Asset-Based Analytics para PI Server 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 número real. Devuelve 0 en el caso de los enteros. Sintaxis Frac(x) Argumentos x Debe ser un número entero o real. Devuelve La parte fraccionaria de x. Excepciones Si x no es un número entero o real, devuelve un error. Notas Por definición: Int(x) + Frac(x) = x. Ejemplo Frac('tag1') Frac(1.1) Frac(TagVal('tag1', '14-Dec97')) Hour Extrae la hora de una expresión de tiempo. Sintaxis Hour(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve La hora de la expresión de tiempo, en el rango PI System Explorer Guía del usuario

191 Asset-Based Analytics para PI Server Excepciones Ninguna. Ejemplo Hour('*') Hour('Saturday') Hour('t') IF Introduce la condición de una expresión IF-THEN-ELSE. Este tipo de expresión devuelve el primero de dos valores especificados cuando una condición es True y el segundo, cuando es False. Sintaxis IF (expression) THEN (x) ELSE (y) Argumentos expression Cualquier expresión que se evalúe como True o False. x, y Una expresión que devuelve un valor de salida. Devuelve La salida x, cuando la expresión condicional es True (distinta de cero), y la salida y, cuando la expresión es False (cero). Excepciones Ninguna. Ejemplo IF ('tag1' > 50) THEN ('tag2') ELSE ('tag3') InStr Determina la ubicación 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 carácter en s1 por el que se comenzará la comparación. Debe ser mayor o igual que 1. s1, s2 Dos cadenas o puntos con tipos de punto de cadena para comparar. PI System Explorer Guía del usuario 181

192 Asset-Based Analytics para PI Server casesensitive Indicador opcional que señala que la comparación distingue entre mayúsculas y minúsculas. Si es 0 (el valor predeterminado), la comparación distingue entre mayúsculas y minúsculas; si es 1, no distingue entre ellas. Devuelve 0 si s2 no es una subcadena des1 que comienza por la posición inicial; de lo contrario, la ubicación del carácter dondes2 coincide por primera vez con los caracteres des1 a partir de la posición inicial. Excepciones Los caracteres comodín 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 x y Cualquier valor numérico, cadena, hora, o intervalo de tiempo Valor numérico u hora que indica el inicio de un rango. Valor numérico u hora que indica el final de un rango. x1, x2, x3,... xn Un conjunto de valores numéricos, horas o intervalos de tiempo. Devuelve True cuando value está dentro del rango o conjunto de otros valores. De lo contrario, devuelve False. 182 PI System Explorer Guía del usuario

193 Asset-Based Analytics para PI Server Excepciones Ninguna. Ejemplo ('tag1') In ("1", "10") '+1h' In ('+1d', '+1s') Int Devuelve la parte entera de un número entero o real. Sintaxis Int(x) Argumentos x Un número o una cadena. Devuelve La parte entera de x. Six es una cadena, se convierte primero en un número. Excepciones Si x no es un número o una cadena numérica, 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 número entero o real, un estado digital o una cadena de caracteres. select Una cadena, pero solo se considera el primer carácter. "a" para anotado; "s" para sustituido y "q" para dudoso. No distingue entre mayúsculas y minúsculas. Devuelve 1 si es verdadero y 0 en caso contrario. PI System Explorer Guía del usuario 183

194 Asset-Based Analytics para PI Server 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 minúsculas una cadena. Sintaxis LCase(s) Argumentos s Debe ser una cadena. Devuelve Una cadena que se ha convertido en minúsculas. 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 número específico de caracteres de una cadena empezando por la izquierda. Sintaxis Left(s, len) Argumentos s Una cadena. len Un entero. 184 PI System Explorer Guía del usuario

195 Asset-Based Analytics para PI Server 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 Si el argumento no es una cadena, devuelve un error. Ejemplo Len("Stringtag") = 9 Len('Stringtag') = 5 if the Snapshot value for the stringtag equals "Error" Log Devuelve el logaritmo natural (base-e = ) de un número entero o real. Sintaxis Log(x) Argumentos x Debe ser un número entero o real mayor que cero. Devuelve El logaritmo natural de x. Excepciones Si x es cero o un número negativo, o no es un número, devuelve un error. PI System Explorer Guía del usuario 185

196 Asset-Based Analytics para PI Server Ejemplo Log('*') Log(14) Log(TagVal('tag1', '14-Dec-97')) Log10 Devuelve el logaritmo en base 10 de un número entero o real. Sintaxis Log10(x) Argumentos x Debe ser un número entero o real mayor que cero. Devuelve El logaritmo en base 10 de x. Excepciones/Errores Si x es cero o un número negativo, o no es un número, devuelve un error. Ejemplo Log10('*') Log10(14) Log10(TagVal('tag1', '14-Dec-97')) Logbase Devuelve el logaritmo de un valor numérico positivo (x) en una determinada base (y). Sintaxis Logbase(x,y) Argumentos x y Debe ser un número entero o real mayor que cero. Un enterno positivo que indica la base del logaritmo. Devuelve El logaritmo de x en basey. Excepciones Si x es cero o un número negativo, o no es un número, devuelve un error. 186 PI System Explorer Guía del usuario

197 Asset-Based Analytics para PI Server 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 máximo de un conjunto de valores. Sintaxis Max(x1, x2,..., xn) Argumentos x1...xn Pueden ser números, horas o períodos, pero todos deben ser iguales. Devuelve El valor máximo 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 ejecución son estados digitales. Si todos los valores son estados digitales, Max devuelve un error. PI System Explorer Guía del usuario 187

198 Asset-Based Analytics para PI Server 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 más valores. Sintaxis Median(x1, x2, x3, [... xn]) Argumentos x1, x2, x3, [... xn] Todos los argumentos deben ser del mismo tipo. Introduzca como mínimo tres argumentos, todos del mismo tipo (números enteros y reales, horas o períodos de tiempo) Devuelve El valor medio de los argumentos de entrada. Si el número de argumentos es par, se devuelve el promedio de dos valores medios. Excepciones No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados digitales. La función debe tener más de dos argumentos que se evalúen 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 evalúa respecto a un entero, todas las demás entradas se convertirán 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 sábado 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 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. 188 PI System Explorer Guía del usuario

199 Asset-Based Analytics para PI Server Sintaxis Mid(s, start [,len]) Argumentos s Una cadena. start Un entero que especifica la posición del primer carácter dentro de la cadena. El primer carácter de la cadena es el número 1. len Opcional. La longitud máxima 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 carácter cuya posición esté especificada por el comienzo. Excepciones Si los argumentos no son del tipo requerido, devuelve un error. El número máximo 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 mínimo de un conjunto de valores. Sintaxis Min(x1,..., xn) Argumentos x1...xn Pueden ser números, horas o períodos de tiempo, pero todos deben ser del mismo tipo. Devuelve El mínimo 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 ejecución son estados digitales. Si todos los valores son estados digitales, Min devuelve un error. PI System Explorer Guía del usuario 189

200 Asset-Based Analytics para PI Server 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 expresión de tiempo. Sintaxis Minute(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El minuto de la expresión de tiempo, en el rango Excepciones Ninguna. Ejemplo Minute('*') Minute('1') Minute('*-1h') Mod El operador de módulo (mod) devuelve el resto del cociente de dos valores numéricos. En el caso de A mod B, es el resto de A/B. Sintaxis x mod y Argumentos Devuelve Excepciones Ninguna. Ejemplo 'att1' mod PI System Explorer Guía del usuario

201 Asset-Based Analytics para PI Server Month Extrae el mes de una expresión de tiempo. Sintaxis Month(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El mes de la expresión de tiempo, en el rango Excepciones Ninguna. Ejemplo Month('*') Month('1') Month('*-1h') NextEvent Encuentra la hora del siguiente evento que ha sido archivado de un punto después de una hora determinada. Sintaxis NextEvent(tagname, time) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. time Una expresión de tiempo. 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 después de la hora especificada, devuelve un error. Ejemplo NextEvent('tag1','*') NextEvent('digitaltag', '*') PI System Explorer Guía del usuario 191

202 Asset-Based Analytics para PI Server NextVal Encuentra el valor del siguiente evento que ha sido archivado de un punto después de una hora determinada. Sintaxis NextVal(tagname, time) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. time Una expresión de tiempo. 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 después 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 mediodía de una expresión de tiempo dada. Sintaxis Noon(t1) Argumentos t1 Expresión de tiempo incluida entre comillas. Devuelve Una marca de tiempo correspondiente a las doce del mediodía de una expresión de tiempo dada. Excepciones Ninguna. Notas Esta función es útil para establecer una hora de reloj única independiente de la duración de días concretos. 192 PI System Explorer Guía del usuario

203 Asset-Based Analytics para PI Server Ejemplo Noon('*') Noon('14-Dec-97') NoOutput No escribe el resultado del cálculo actual. Sintaxis NoOutput() Argumentos Ninguno. Notas Es importante incluir los paréntesis después de esta función (utilice NoOutput() en lugar denooutput porquenooutput es una sintaxis no válida). Esta función solo se aplica al cálculo actual. La salida de esta función en pipetest.exe es "NoOutput() Called". Ejemplo If 'PITag' < 100 or 'PItag' > 0 then 'PITag' else NoOutput() Normalrnd Devuelve un número aleatorio que correlaciona la curva de distribución normal utilizando un promedio y una desviación estándar determinados. Sintaxis Normalrnd(x, y) Argumentos x y Un número real que especifica el promedio de la curva de distribución normal. Un número real que especifica la desviación estándar de la curva de distribución normal. Devuelve Un número aleatorio que correlaciona la curva de distribución normal con un promedio y una desviación estándar determinados. Excepciones Ninguna. Ejemplo Normalrnd(300, 2.5) PI System Explorer Guía del usuario 193

204 Asset-Based Analytics para PI Server NOT El operador NOT devuelve la negación de una expresión. True para una expresión falsa y False para una expresión verdadera. Sintaxis NOT expression Argumentos expression Cualquier expresión que da como resultado verdadero o falso. Devuelve True cuando expression es falsa y False cuando expression es verdadera. Excepciones Ninguna. Ejemplo NOT ('tag1') In ("1", "10") OR Operador de disyunción lógica de dos expresiones que devuelve True si una de las expresiones es verdadera y False si ambas son falsas. Sintaxis expression1 OR expression2 Argumentos expression1 expression2 Cualquier expresión que da como resultado verdadero o falso. 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 expresión de tiempo de PI en una marca de tiempo. Sintaxis ParseTime(s1) 194 PI System Explorer Guía del usuario

205 Asset-Based Analytics para PI Server 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 expresión de tiempo '14- Nov-92', excepto que la llamada a ParseTime tarda más. Esto se debe a que la expresión de tiempo (incluida entre comillas simples) se evalúa durante la compilación y no en tiempo de ejecución. Si escribe ParseTime('14-Nov-92') (utilizando comillas simples y no dobles), el analizador detecta un error, porque la expresión entre comillas simples ya se ha traducido en una marca de tiempo durante la compliación. La expresión ParseTime(":12:00:00") no es igual que la expresión de tiempo ': 12:00:00'. La expresión de ParseTime se evalúa en tiempo de ejecución y se traduce utilizando '*' como base temporal relativa, en tanto que la expresión de tiempo se evalúa en tiempo de compilación y utiliza la hora que la expresión 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 búsqueda debe ser una expresión de tiempo. endtime El final del intervalo de tiempo objeto de la búsqueda debe ser una expresión de tiempo posterior a la hora de inicio. PI System Explorer Guía del usuario 195

206 Asset-Based Analytics para PI Server Devuelve Un número 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 Evalúa el polinomio c0 + c1x + c2x 2 + +cnx n. Sintaxis Poly(x, c0,..., cn) Argumentos x La variable. Debe ser un número entero o real. c0...cn Los coeficientes. Debe haber como mínimo un coeficiente. Todos deben ser números Devuelve El valor de un polinomio. Excepciones Si x o cualquier coeficiente no es un número entero o real, Poly devuelve un error. Ejemplo Poly('tag1',1,1) 196 PI System Explorer Guía del usuario

207 Asset-Based Analytics para PI Server Pow Devuelve el valor x elevado a la potencia de y. Sintaxis Pow(x,y) Argumentos x y Cualquier valor numérico Cualquier valor numérico 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. time Una expresión de tiempo. 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. PI System Explorer Guía del usuario 197

208 Asset-Based Analytics para PI Server 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. time Una expresión de tiempo. 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 desviación estándar de la muestra: la desviación estándar de un conjunto de dos o más valores que constituyen la población entera. La desviación estándar de una población x1...xn es donde es la media de los argumentos; es decir, Sintaxis PStDev(x1, x2,..., xn) 198 PI System Explorer Guía del usuario

209 Asset-Based Analytics para PI Server Argumentos x1...xn Pueden ser números o expresiones de tiempo, pero todos deben ser iguales. Devuelve La desviación estándar de los argumentos. Si los argumentos son números, el resultado es un número; si los argumentos son horas o períodos de tiempo, el resultado es un período de tiempo. Excepciones No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados digitales. Si todos los valores son estados digitales, PStDev devuelve un error. Notas En la mayoría de los casos, debe utilizar Sstdev en lugar de PstDev. Sstdev calcula la desviación estándar de una muestra. Ejemplo PStDev('tag1', 'tag2') PStDev('*','14-Dec-97', 'y') PStDev('*'-'y','14-Dec-97'-'*', '-1h') Rand Devuelve un número aleatorio entre 0 y 1.0. Para los valores x e y especificados, devuelve un número aleatorio entre x - y/2 y x + y/2. Sintaxis Rand(x, y) Argumentos x y Un número real que especifica el punto central del rango. Un número real que especifica el tamaño del rango. Si no se especifica ningún argumento, el rango predeterminado va de 0 a 1.0. Devuelve Un número aleatorio entre 0 y 1.0. Para los valores x e y especificados, devuelve un número aleatorio entre x - y/2 y x + y/2. Excepciones Ninguna. Ejemplo Rand() Rand(500, 250) PI System Explorer Guía del usuario 199

210 Asset-Based Analytics para PI Server Range Encuentra la diferencia entre los valores máximo y mínimo de un punto durante un intervalo de tiempo determinado, según 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 búsqueda debe ser una expresión de tiempo. endtime El final del intervalo de tiempo objeto de la búsqueda debe ser una expresión de tiempo posterior a la hora de inicio. pctgood Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Devuelve La diferencia entre los valores máximo y mínimo de un punto durante un intervalo de tiempo determinado. Excepciones Si el punto no tiene valores correctos o no se alcanza el mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. Notas Ejemplo PRECAUCIÓN: Los estados digitales OverRangeStat y UnderRangeStat no se tienen en cuenta cuando se calcula este valor. Range('tag1', 'y', '*') Range('tag1','-1h', 'y') Range('tag1','y', '+1h',70) Remainder Devuelve el resto que resulta de la división de x por y utilizando el método IEEERemainder. Este resto equivale a x - (y Q), donde Q es el cociente de x / y redondeado al entero más próximo (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 número). 200 PI System Explorer Guía del usuario

211 Asset-Based Analytics para PI Server Sintaxis Remainder(x, y) Argumentos x y Cualquier valor numérico distinto de cero. Cualquier valor numérico. Devuelve El resto que resulta de la división de x por y utilizando el método IEEERemainder. Nota: No es el mismo que el resto que devuelve el operador Mod (módulo). Excepciones Ninguna Ejemplo Remainder(11,3) Devuelve -1 Remainder(10,3) Devuelve +1 Right Determina un número específico 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. PI System Explorer Guía del usuario 201

212 Asset-Based Analytics para PI Server 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 número o una hora a la unidad más próxima. Sintaxis Round(x [, unit]) Argumentos x Debe ser un número entero o real o una expresión de tiempo. unit Opcional. El tamaño al que se redondeará la unidad. Si x es un número, la unidad debe ser un número. Six es una expresión de tiempo o un período, la unidad debe ser un período de tiempo. Si se omite la unidad, Round redondea al entero más próximo (en el caso de los números) o al segundo (en el caso de los períodos de tiempo). Devuelve El valor más próximo a x que sea un número entero múltiplo de una unidad. Devuelve el mismo tipo de datos quex. Para obtener más información, 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 ajustarán con un margen de precisión de solo 1 segundo. Ejemplo Round(12.499) Se redondea al entero más próximo (12,0) Round(12.5) La media unidad se redondea (13,0) Round(12.8, 10) Se redondea a la decena más próxima (10,0) Round('14-Dec-97 11:47, '+1h') La marca de tiempo se redondea a la hora más próxima (14-Dec-97 12:00) Round('18:47' -'15:00','+1h') El período medido en segundos se redondea a la hora más próxima (10800) 202 PI System Explorer Guía del usuario

213 Asset-Based Analytics para PI Server Nota: El redondeo al día más próximo produce una marca de tiempo del día más próximo en la hora UTC y no en la hora local. Roundfrac Redondea un valor numérico x a y posiciones decimales. Sintaxis Roundfrac(x, y) Argumentos x y Debe ser un número entero o real o una expresión de tiempo. Entero que especifica el número 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 más información, 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 ajustarán con un margen de precisión 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. PI System Explorer Guía del usuario 203

214 Asset-Based Analytics para PI Server Devuelve La cadena de origen con los espacios en blanco al final eliminados. Excepciones Si s no es una cadena, se devuelve un error. Ejemplo RTrim("Stringtag ") = "Stringtag" RTrim(" Stringtag") = " Stringtag" RTrim('Stringtag') = "Error" if the Snapshot value for the stringtag equals "Error " Sec Devuelve la secante trigonométrica de un número. Sintaxis Sec(x) Argumentos x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve La secante de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Sec('tag1') Sec(1) Sec(1.1) Sech Devuelve la secante hiperbólica de un número. Sintaxis Sech(x) Argumentos x Debe ser un número entero o real. Devuelve La secante hiperbólica de x. 204 PI System Explorer Guía del usuario

215 Asset-Based Analytics para PI Server Excepciones Si x no es un número, devuelve un error. Ejemplo Sech('tag1') Sech(1) Sech(1.1) Second Extrae el segundo de una expresión de tiempo. Sintaxis Second(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El segundo de la expresión de tiempo, en el rango Excepciones Ninguna. Ejemplo Second('*') Second('y') Second('*-1h') Sgn Devuelve un indicador del signo numérico de un número. Sintaxis Sgn(x) Argumentos x Debe ser un número entero o real. Devuelve -1 si x < 0,0 si x = 0,1 si x > 0. Excepciones Si x no es un número entero o real, devuelve un error. PI System Explorer Guía del usuario 205

216 Asset-Based Analytics para PI Server Ejemplo Sgn('tag1') Sgn(1) Sgn(0) Sin Devuelve el seno trigonométrico de un número. Sintaxis Sin(x) Argumentos x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve El seno de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Sin('tag1') Sin(1) Sin(1.1) Sinh Devuelve el seno hiperbólico de un número. Sintaxis Sinh(x) Argumentos x Debe ser un número entero o real. Devuelve El seno hiperbólico de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Sinh('tag1') Sinh(1) Sinh(0.9) 206 PI System Explorer Guía del usuario

217 Asset-Based Analytics para PI Server Sqr Devuelve la raíz cuadrada de un número. Sintaxis Sqr(x) Argumentos x Debe ser un número entero o ral mayor o igual que cero. Devuelve La raíz cuadrada de x. Excepciones Si x es un valor negativo, o no es un número, devuelve un error. Ejemplo Sqr('tag1') Sqr(2) Sqr(2.1) StateNo Traduce un estado digital a su correspondiente número de estado. Sintaxis StateNo(digstate) Argumentos digstate Un valor de enumeración. 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 número de código adecuado para ese punto. Ejemplo StateNo('digitaltag') StateNo(TagVal('digitaltag', '*-1h')) PI System Explorer Guía del usuario 207

218 Asset-Based Analytics para PI Server SStDev Devuelve la desviación estándar de muestra: la desviación estándar de dos o más argumentos que son una muestra de una población mayor. La desviación estándar 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 números o expresiones de tiempo, pero todos deben ser iguales. Devuelve La desviación estándar de muestra de los argumentos. Si los argumentos son números, el resultado es un número; si los argumentos son horas o períodos de tiempo, el resultado es un período de tiempo (número de segundos). Excepciones No se tienen en cuenta los argumentos cuyos valores de tiempo de ejecución son estados digitales. Si no hay como mínimo dos valores numéricos, SStDev devuelve cero. Notas En el caso poco frecuente de que tenga la población entera, y no una muestra, puede utilizar la función 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 desviación estándar ponderada en tiempo de un punto durante un intervalo de tiempo determinado, según los valores almacenados en PI Archive. Sintaxis StDev(tagname, starttime, endtime [, pctgood]) 208 PI System Explorer Guía del usuario

219 Asset-Based Analytics para PI Server Argumentos tagname Un nombre de tag. Este punto debe representar una variable continua. starttime Debe ser una expresión de tiempo que represente el comienzo del intervalo de tiempo objeto de la búsqueda. endtime Debe ser una expresión de tiempo, posterior a la hora de inicio, que represente el final del intervalo de tiempo objeto de la búsqueda. pctgood Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Devuelve La desviación estándar 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 mínimo de PctGood para el intervalo de tiempo proporcionado, se devuelve un error. Notas Ejemplo PRECAUCIÓN: Si el punto tiene pocos valores de archivado correctos durante el período de tiempo, es posible que esta función no resulte muy fiable. Utilice la función PctGood para averiguar qué porcentaje de los valores es correcto. 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 expresión. Puede ser de cualquiera de los tipos de datos de PI System normales. Devuelve La cadena que representa el argumento de valor. PI System Explorer Guía del usuario 209

220 Asset-Based Analytics para PI Server 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, según los valores almacenados en PI Archive. Sintaxis TagAvg(tagname, starttime, endtime [, pctgood]) Argumentos tagname Un nombre de tag. Este punto debe representar una variable continua. starttime Debe ser una expresión de tiempo que represente el comienzo del intervalo de tiempo objeto de la búsqueda. endtime Debe ser una expresión de tiempo, posterior a la hora de inicio, que represente el final del intervalo de tiempo objeto de la búsqueda. pctgood Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Devuelve El valor ponderado en tiempo de un punto a lo largo de un intervalo de tiempo especificado. Excepciones Si el punto no tiene valores correctos o no se alcanza el mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. Notas PRECAUCIÓN: Si el punto tiene pocos valores de archivado correctos durante el período de tiempo, es posible que esta función no resulte muy fiable. Utilice la función PctGood para averiguar qué porcentaje de los valores es correcto. 210 PI System Explorer Guía del usuario

221 Asset-Based Analytics para PI Server 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 anómalo en un momento dado. Si el tipo del punto es R o I, cualquier estado digital será anómalo. Si el tipo del punto es D, los estados definidos para ese punto serán normales y el resto, anómalos. Sintaxis Tagbad(tagname [, time]) Argumentos tagname Un nombre de tag. time Opcional. Una expresión 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 anómalo. 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 expresión; 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. PI System Explorer Guía del usuario 211

222 Asset-Based Analytics para PI Server 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 ingeniería de un punto de Point Database. Sintaxis TagEU(tagname) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve Las unidades de ingeniería de un punto. Excepciones Si el punto no existe, devuelve un error. Ejemplo TagEU('tag1') TagExDesc Obtiene el descriptor ampliado de un punto de Point Database. Sintaxis TagExDesc(tagname) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve El descriptor ampliado de un punto. Excepciones Si el punto no existe, devuelve un error. 212 PI System Explorer Guía del usuario

223 Asset-Based Analytics para PI Server Ejemplo TagExDesc('tag1') TagMax Encuentra el valor máximo de un punto durante un intervalo de tiempo determinado, según los valores almacenados en PI Archive. Sintaxis TagMax(tagname, starttime, endtime [, pctgood]) Argumentos tagname Un nombre de tag. starttime Una expresión de tiempo que indica el comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. 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 Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Devuelve El valor máximo de un punto a lo largo de un intervalo de tiempo especificado. Excepciones Si el punto no tiene valores correctos o no se alcanza el mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. Notas PRECAUCIÓN: 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') PI System Explorer Guía del usuario 213

224 Asset-Based Analytics para PI Server TagMean Encuentra el valor promedio de un punto durante un intervalo de tiempo determinado, según 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 Un nombre de tag. Este punto debe representar una variable continua. starttime Debe ser una expresión de tiempo que represente el comienzo del intervalo de tiempo objeto de la búsqueda. endtime Debe ser una expresión de tiempo, posterior a la hora de inicio, que represente el final del intervalo de tiempo objeto de la búsqueda. pctgood Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Excepciones Si el punto no tiene valores correctos o no se alcanza el mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. A diferencia de otras funciones de resumen, TagMean no interpola ningún valor en el límite. Por lo tanto, si no hay ningún evento de archivado entre el intervalo especificado, se devuelve un error. Notas Ejemplo PRECAUCIÓN: Si el punto tiene pocos valores de archivado correctos durante el período de tiempo, es posible que esta función no resulte muy fiable. Utilice la función PctGood para averiguar qué porcentaje de los valores es correcto. TagMean('tag1', 'y', '*') TagMean('tag1', '14-Dec-97', '+1d',70) TagMean('tag1', '14-Dec-97', '15-Dec-97') TagMin Encuentra el valor mínimo de un punto durante un intervalo de tiempo determinado, según los valores almacenados en PI Archive. 214 PI System Explorer Guía del usuario

225 Asset-Based Analytics para PI Server Sintaxis TagMin(tagname, starttime, endtime [, pctgood]) Argumentos tagname Un nombre de tag. Este punto debe representar una variable continua. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización 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 expresión relativa. Esta hora debe ser posterior a la hora de inicio. pctgood Opcional. Porcentaje de tiempo mínimo a lo largo del intervalo de tiempo proporcionado en que los valores archivados del punto deben ser correctos. Devuelve El valor mínimo de un punto a lo largo de un intervalo de tiempo especificado. Excepciones Si el punto no tiene valores correctos o no se alcanza el mínimo de pctgood para el intervalo de tiempo proporcionado, se devuelve un error. Notas Ejemplo PRECAUCIÓN: El estado digital UnderRange no se tiene en cuenta al calcular este valor. 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve El nombre de un punto. PI System Explorer Guía del usuario 215

226 Asset-Based Analytics para PI Server Excepciones Si el punto no existe, devuelve un error. Ejemplo TagName('tag1') TagNum Obtiene el número de un punto de Point Database. Sintaxis TagNum(string) Argumentos string El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas dobles. Devuelve El número de un punto. Excepciones Si el punto no existe, devuelve un error. 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Excepciones Si el punto no existe, devuelve un error. Ejemplo TagSource('tag1') 216 PI System Explorer Guía del usuario

227 Asset-Based Analytics para PI Server TagSpan Obtiene el valor de intervalo de un punto de Point Database. Sintaxis TagSpan(tagname) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve El intervalo de un punto. Si el tipo del punto es Digital, se trata de un entero cuyo valor es el número 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, según 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 Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de inicio si esta no es una expresión relativa. pctgood Opcional. Porcentaje de tiempo mínimo 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 mínimo de PctGood para el intervalo de tiempo proporcionado, se devuelve un error. PI System Explorer Guía del usuario 217

228 Asset-Based Analytics para PI Server Notas PRECAUCIÓN: Si el punto tiene pocos valores de archivado correctos durante el período de tiempo, es posible que esta función no resulte muy fiable. Utilice la función PctGood para averiguar qué porcentaje del valor es correcto. El sistema elige un factor de escala para que la integral solo sea correcta si el flujo se expresa en unidades por día. Si el flujo se expresa en unidades por hora, o según otra unidad de tiempo, este resultado se debe multiplicar por un factor de conversión. El factor de conversión equivale al número de unidades de tiempo de flujo real en un día. 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 conversión no está relacionado con el período de tiempo durante el cual se realiza la totalización; es estrictamente una función de las unidades de ingeniería del punto. Algunos sitios de PI tienen configurado de forma predeterminada el período total por hora en lugar de por día. Si está en uno de estos sitios, el factor de conversión variará. Cuando el porcentaje de datos correctos es inferior al 100%, TagTot determina el total en base a los datos correctos y divide la fracción de datos correctos en el intervalo. Ejemplo TagTot('tag1', 'y', '*') TagTot('tag1', '-1h', '*',85) TagTot('tag1', '14-Dec-97', '+1h') TagType Obtiene el carácter de tipo del punto (I, R o D) de Point Database. Sintaxis TagType(tagname) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve El carácter de tipo de un punto. Excepciones Si el punto no existe, devuelve un error. Ejemplo TagType('tag1') TagType('digitaltag') 218 PI System Explorer Guía del usuario

229 Asset-Based Analytics para PI Server TagVal Encuentra el valor que ha sido archivado de un punto en un momento determinado. Sintaxis TagVal(tagname [, time]) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. time Opcional. Una expresión 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 código de resolución 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. Devuelve El valor cero de un punto. Si el tipo del punto es R o I, es un número; si el tipo es D, se trata de un estado digital (cadena de caracteres). Excepciones Si el punto no existe, devuelve un error. Ejemplo TagZero('tag1') TagZero('digitaltag') PI System Explorer Guía del usuario 219

230 Asset-Based Analytics para PI Server Tan Devuelve la tangente trigonométrica de un número. Sintaxis Tan(x) Argumentos x Debe ser un número entero o real, que representa un ángulo en radianes. Devuelve La tangente de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Tan('tag1') Tan(1) Tan(1.1) Tanh Devuelve la tangente hiperbólica de un número. Sintaxis Tanh(x) Argumentos x Debe ser un número entero o real. Devuelve La tangente hiperbólica de x. Excepciones Si x no es un número, devuelve un error. Ejemplo Tanh('tag1') Tanh(1) Tanh(1.1) Text Concatena cadenas que representan valores de argumento. 220 PI System Explorer Guía del usuario

231 Asset-Based Analytics para PI Server Sintaxis Text(val1 [, val2, ]) Argumentos val1, val2, Cualquier expresión. Puede ser de cualquiera de los tipos de datos de PI System normales. Devuelve Una cadena que es la concatenación 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 expresión condicional IF-THEN- ELSE es True. Sintaxis IF (expression) THEN (x) ELSE (y) Argumentos expression Cualquier expresión condicional que se evalúe como True o False. x, y Una expresión que devuelve un valor de salida. Devuelve La salida x, cuando la expresión condicional es True (distinta de cero), y la salida y, cuando la expresión es False (cero). Excepciones Ninguna. Ejemplo IF ('tag1' > 50) THEN ('tag2') ELSE ('tag3') 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 PI System Explorer Guía del usuario 221

232 Asset-Based Analytics para PI Server tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la 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 número entero o real o un estado digital (cadena de caracteres); el valor para buscar. Devuelve El período de tiempo dentro del intervalo proporcionado en el que el punto fue idéntico al valor proporcionado. 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 valor proporcionado. Sintaxis TimeGE(tagname, starttime, endtime, value) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la 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 número entero o real o un estado digital (cadena de caracteres); el valor para buscar. 222 PI System Explorer Guía del usuario

233 Asset-Based Analytics para PI Server Devuelve El período 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 número 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la 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 número entero o real o un estado digital (cadena de caracteres); el valor para buscar. Devuelve El período de tiempo dentro del intervalo proporcionado en el que el punto fue mayor que el valor proporcionado. Excepciones Ninguna. PI System Explorer Guía del usuario 223

234 Asset-Based Analytics para PI Server Notas TimeGT se interpola entre eventos de archivado, si es necesario, para averiguar el número de veces que el punto ha sobrepasado el valor indicado. 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 valor proporcionado. Sintaxis TimeLE(tagname, starttime, endtime, value) Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a endtime, siendtime no es una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a starttime, sistarttime no es una hora relativa. Esta hora debe ser posterior astarttime. value Debe ser un número entero o real o un estado digital (cadena de caracteres); el valor objeto de búsqueda. Devuelve El período 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 número de veces que el punto ha sobrepasado el valor indicado. Ejemplos TimeLE('tag1', 't', '*',40.0) TimeLE('digitaltag', '-1d', '*',TagVal('digitaltag', '14-Dec-97')) TimeLE('digitaltag', '14-Dec-97', '*', "On") 224 PI System Explorer Guía del usuario

235 Asset-Based Analytics para PI Server 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 El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la 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 número entero o real o un estado digital (cadena de caracteres); el valor para buscar. Devuelve El período de tiempo dentro del intervalo proporcionado en el que el punto fue menor que el valor proporcionado. Excepciones Ninguna. Notas TimeLT se interpola entre eventos de archivado, si es necesario, para averiguar el número de veces que el punto ha sobrepasado el valor indicado. 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) PI System Explorer Guía del usuario 225

236 Asset-Based Analytics para PI Server Argumentos tagname El nombre de un atributo con una referencia de datos de PI point, incluido entre comillas simples. starttime Comienzo del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la hora de finalización si esta no es en sí misma una hora relativa. endtime Final del intervalo de tiempo objeto de la búsqueda. Las horas relativas lo son respecto a la 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 número entero o real o un estado digital (cadena de caracteres); el valor para buscar. Devuelve El período de tiempo dentro del intervalo proporcionado en el que el punto no fue igual al valor proporcionado. 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', '*")) 226 PI System Explorer Guía del usuario

237 Asset-Based Analytics para PI Server Devuelve la marca de tiempo del evento de archivado de PI para la sinusoide. Total Devuelve la suma de dos o más valores. Sintaxis Total(x1, x2,..., xn) Argumentos x1...xn Pueden ser números o períodos 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 ejecución 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 Si s no es una cadena, se devuelve un error. Ejemplo Trim(" Stringtag ") = "Stringtag" Trim(" Stringtag is a string tag. ") = "Stringtag is a string tag." Trunc Trunca un número o una hora a la siguiente unidad más baja. PI System Explorer Guía del usuario 227

238 Asset-Based Analytics para PI Server Sintaxis Trunc(x [, unit]) Argumentos x Debe ser un número entero o real, una expresión de tiempo o un período de tiempo. unit Opcional. El tamaño al que se truncará la unidad; x se truncará a un múltiplo deunit. Six es un número,unit debe ser un número. Six es una expresión de tiempo o un período,unit debe ser un período de tiempo. Si se omite unit, Trunc realiza el truncamiento al siguiente entero inferior (en el caso de los números) o al segundo (en el caso de los períodos de tiempo). Devuelve Trunc devuelve el múltiplo de unidad más grande que sea inferior a x. Para un valorx negativo, devuelve el múltiplo más 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 ajustarán con un margen de precisión de solo 1 segundo. Cuando x < unit, se devuelve 0. Ejemplo Trunc(12.999) Truncar al siguiente múltiplo inferior (12.0) Trunc(28.75, 10) Truncar al siguiente múltiplo 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 período a la siguiente hora inferior. (3:00:00) Nota: El truncamiento al siguiente día inferior produce una marca del siguiente día inferior en la hora UTC y no en la hora local. UCase Convierte en mayúsculas una cadena. Sintaxis UCase(s) Argumentos 228 PI System Explorer Guía del usuario

239 Asset-Based Analytics para PI Server s Debe ser una cadena. Devuelve Una cadena en mayúsculas. Excepciones Si el argumento no es una cadena, devuelve un error. Ejemplo UCase("Stringtag") = "STRINGTAG" UCase('Stringtag') = "ERROR" if the Snapshot value for the stringtag equals "Error" Yearday Extrae el día del año a partir de una expresión de tiempo. El día del año (también conocido como día juliano) es un entero que va de 1 a 366, donde 1 representa el 1 de enero. Sintaxis Yearday(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El día del año, en el rango 1-366, donde 1 representa el 1 de enero. Excepciones Ninguna. Ejemplo Yearday('*') Yearday('t') Year Extrae el año de una expresión de tiempo. Sintaxis Year(t1) Argumentos t1 Expresión de tiempo, incluida entre comillas simples. Devuelve El año de la expresión de tiempo, en el rango de 1970 hasta el presente. PI System Explorer Guía del usuario 229

240 Asset-Based Analytics para PI Server Excepciones Ninguna. Ejemplo Year('*') Year('t') Weekday Extrae el día de la semana a partir de una expresión de tiempo. Sintaxis Weekday(t1) Argumentos t1 Una expresión de tiempo. Devuelve El día 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 análisis Puede incluir funciones del vapor en expresiones de análisis para calcular las propiedades termodinámicas del vapor. Estas funciones se basan en la formulación industrial IAPWS La implementación se basa fundamentalmente en la combinación de ecuaciones hacia atrás 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 análisis 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 función del vapor se detallan en Rangos de las entradas de la función 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 Función Steam_TsatP Steam_HsatP Steam_SsatP Descripción Temperatura de saturación como función de la presión. Entalpía de saturación como función de la presión. Entropía de saturación como función de la presión. 230 PI System Explorer Guía del usuario

241 Asset-Based Analytics para PI Server Función Steam_VsatP Steam_PsatT Steam_HsatT Steam_SsatT Steam_VsatT Steam_VPT Steam_VPTL Steam_VPH Steam_VPS Steam_HPT Steam_HPTL Steam_HPS Steam_SPT Steam_SPTL Steam_SPH Steam_TPH Steam_TPS Steam_XHP Steam_XPS Steam_HPX Steam_SPX Descripción Volumen específico del vapor de saturación como función de la presión. Presión de saturación como función de la temperatura. Entalpía de saturación como función de la temperatura. Entropía de saturación como función de la temperatura. Volumen específico del vapor de saturación como función de la temperatura. Volumen específico del vapor como función de la presión y la temperatura. (Para el vapor saturado y sobrecalentado.) Volumen específico del agua como función de la presión y la temperatura. Volumen específico del vapor como función de la presión y la entalpía. (Para el vapor mojado y seco.) Volumen específico del vapor como función de la presión y la entropía. (Para el vapor mojado y seco.) Entalpía específica del vapor como función de la presión y la temperatura. (Para el vapor saturado y sobrecalentado.) Entalpía específica del líquido como función de la presión y la temperatura. (Para el agua.) Entalpía específica del vapor como función de la presión y la entropía. (Para el vapor mojado y seco.) Entropía específica del vapor como función de la presión y la temperatura. (Para el vapor saturado y sobrecalentado.) Entropía específica del líquido como función de la presión y la temperatura. (Para el agua.) Entropía específica del vapor como función de la presión y la entalpía. (Para el vapor mojado y seco.) Temperatura como función de la entalpía y la presión. (Para el vapor mojado y seco.) Temperatura como función de la entropía y la presión. (Para el vapor mojado y seco.) Calidad del vapor (fracción de vapor) como función de la entalpía y la presión. (Para el vapor mojado.) Calidad del vapor (fracción de vapor) como función de la entropía y la presión. (Para el vapor mojado.) Entalpía específica como función de la presión y la calidad del vapor. (Para el vapor mojado.) Entropía específica del vapor como función de la presión y la calidad del vapor. (Para el vapor mojado.) Rangos de las entradas de la función de vapor La tabla siguiente muestra los rangos y unidades de medida predeterminadas de cada una de las cinco propiedades relacionadas con los cálculos de la función de vapor. Las unidades de medida predeterminadas son unidades SI. Para obtener más información sobre el uso de las funciones de vapor con otras unidades de medida, consulte Conversión de unidades de medida para funciones de vapor. PI System Explorer Guía del usuario 231

242 Asset-Based Analytics para PI Server La presión afecta al estado del vapor. En Algunas consideraciones relativas a las funciones de vapor que tienen como entrada la presión se describen varias cuestiones que es necesario tener en cuenta en las funciones con la presión como entrada. Rango de entradas para las propiedades de la función de vapor Función Temp ( C) Presión (kpa) Entalpía J/g) Entropía (J/(g K)) Steam_TsatP 0, a Steam_HsatP 0, a Steam_SsatP 0, a Steam_VsatP 0, a 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, a Steam_VPT (presión y temperatura altas) 800 a , a Steam_VPTL 0 a 800 0, a Steam_VPH 0, a Steam_VPS 0, a Steam_HPT 0 a 800 0, a Steam_HPT (temperatura y presión altas) 800 a , a Steam_HPTL 0 a 800 0, to Steam_HPS 0, a Steam_HPX 0, a Steam_SPT 0 a 800 0, a Steam_SPT (temperatura y presión altas) 800 a , a Steam_SPTL 0 a 800 0, a Steam_SPH 0, a ,04159 a ,04159 a 4160,7-0, a , a 11,921 Calidad 0 a PI System Explorer Guía del usuario

243 Asset-Based Analytics para PI Server Función Temp ( C) Presión (kpa) Entalpía J/g) Entropía (J/(g K)) Steam_SPX 0, a Steam_TPH 0, a Steam_TPS 0, a Steam_XPH 0, a Steam_XPS 0, a ,04159 a 4160, a 4160,7-0, a , a 11,921 Calidad 0 a 1 Algunas consideraciones relativas a las funciones de vapor que tienen como entrada la presión Dado que la presión afecta al estado del vapor, tenga en cuenta estas consideraciones sobre las funciones que tienen como entrada la presión. Funciones con la presión 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 presión de entrada en la curva saturada, la entropía, entalpía o volumen calculados son una propiedad de vapor saturado. En el caso de una temperatura de entrada inferior a la temperatura saturada para la presión de entrada, se devuelve un error. Estas tres funciones también pueden aceptar temperaturas de entrada altas (de 800 a 2000 ºC) con presiones entre 0, y kpa. Funciones con la presión y le entalpía o la entropía 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 entalpía (H) va de-0,04159 a 4160,7 J/g y el de la entropía (S), de -0, a J/(g K). Sin embargo, incluso en los valores dentro del rango, algunas combinaciones de presión y entalpía o entropía corresponden al agua comprimida y no al vapor y producen como resultado un error de estado: Con Steam_HPS y Steam_SPH en la región del vapor mojado, se comprueban los límites de la región del agua comprimida y el vapor sobrecalentado. Si la entalpía o entropía de entrada no están dentro de la región del vapor mojado, se devuelve un error de cálculo. Con Steam_TPH y Steam_TPS en la región del vapor mojado, se comprueba el límite entre la región del vapor mojado y la del agua comprimida. Si la combinación de presión de entrada y entropía o entalpía está dentro de la región del agua comprimida, se devuelve un error de cálculo. Del mismo modo, en el caso de Steam_XPH y Steam_XPS, si la entalpía o entropía de entrada son mayores que las propiedades del vapor saturado o menores que las propiedades de líquido saturado, se devuelve un error. Las siguientes funciones son eficaces con una presión elevada y temperaturas altas. Steam_VPH,Steam_VPS,Steam_HPS,Steam_SPH,Steam_TPH ysteam TPS calculan resultados válidos para los estados cuya presión está por encima del punto crítico (22064 kpa) y cuya temperatura es superior a los 350 C, pero inferior a la temperatura crítica (373,946 C), aunque esos estados se consideren agua comprimida en lugar de vapor. PI System Explorer Guía del usuario 233

244 Asset-Based Analytics para PI Server Conversión 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 británicas se convertirán de forma automática a sus correspondientes unidades SI. Del mismo modo, si una función de vapor se configura con un atributo de salida, su resultado se convertirá automáticamente a la unidad de medida configurada para ese atributo. Nota: La conversión automática 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 definición de la conversión de una unidad de medida a otra del mismo tipo, la conversión producirá un error. En el editor de expresiones, cuando evalúe una expresión de función de vapor, los resultados se mostrarán en las unidades SI predeterminadas. Para mostrar los resultados en otra unidad de medida, puede utilizar la función Convert. Las siguientes expresiones de ejemplo utilizan valores numéricos, 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 numéricos Los valores de entrada numéricos se reconocen como cantidades en la unidad de medida predeterminada. En el siguiente ejemplo de Steam_VPT, las entradas numéricas se reconocen como 300 kpa y 200 C, y el valor de salida está en cm 3 /g, la unidad de medida predeterminada de volumen específico. Nombre Expresión Valor Atributo de salida Variable1 Steam_VPT(300, 200) cm3/g Click to map Atributos de entrada y de salida En la siguiente expresión, Steam_VsatT adopta como única entrada el atributo 'TempSat', cuyo valor actual es 300 F. La temperatura se convierte automáticamente a C para evaluar la expresión y el resultado se muestra en la unidad de medida SI predeterminada de Steam_VsatT. Nombre Expresión Valor Atributo de salida Variable1 Steam_VsatT('TempSat') cm3/g OutputVolume El resultado se asigna también al atributo de salida 'OutputVolume'. Este atributo está configurado en una unidad de medida británica (ft 3 /lb), por lo que el resultado se convierte de forma automática a esa unidad de medida. (En la pestaña Atributos de PI System Explorer, 'OutputVolume' se incluiría en la lista con el valor ft 3 /lb.) Variables y la función Convert En este ejemplo se utilizan variables y la función Convert para especificar cantidades en una unidad de medida británica como entradas de la función de vapor. 1. En las filas P y T de la expresión que figura más abajo, Convert asigna valores numéricos a la unidad de medida británica de presión y temperatura. 2. En la fila B, las variables P y T se convierten automáticamente a unidades SI para el cálculo de Steam_VPT y el resultado se muestra en la unidad de medida SI predeterminada. El resultado se asigna también al atributo de salida OutputVolume'. Ese atributo está 234 PI System Explorer Guía del usuario

245 Asset-Based Analytics para PI Server configurado en una unidad de medida británica (ft 3 /lb), por lo tanto, el resultado se convierte de forma automática a esa unidad de medida. 3. En la última fila, Convert se utiliza para convertir el resultado (B) a la unidad de medida británica y mostrarlo en la expresión. Nombre Expresión Valor Atributo de salida P Convert(2000, "psia") 2000 psia Click to map T Convert(800, " F") 800 F Click to map B Steam_VPT(P, T) cm3/g OutputVolume Volume Convert(B, "ft3/lb") 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 K o 0,01 C o 32,018 F. escala Celsius La temperatura Celsius es exactamente T k - 273,15. punto crítico El punto crítico del vapor es 647,096 K y 22,064 kpa o 705,103 F y 3200,1 psia. estado de referencia La energía interna específica y la entropía específica de la fase líquida se han fijado en cero en el punto triple del agua. Referencia de funciones del vapor Steam_HPS Calcula la entalpía específica de vaporización como una función de presión (P en kpa) y la entropía (S, en J/(g K)). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HPS(P, S) Argumentos P S Presión del vapor. P puede estar en el rango de 0, a kpa. Entropía específica del vapor. S puede estar en el rango de -0, a 11,921J/(g K). PI System Explorer Guía del usuario 235

246 Asset-Based Analytics para PI Server Devuelve Entalpía específica del vapor calculada en J/g. Ejemplo Steam_HPS(2500, ) Devuelve 3684,9 J/g Steam_HPT Calcula la entalpía específica de vaporización como una función de presión (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 saturación de P, la función devuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la presión crítica. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HPT(P, T) Argumentos P T Presión del vapor. P puede estar en el rango de 0, a kpa. Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Entalpía específica del vapor calculada en J/g. Ejemplo Steam_HPT(40000, 600) Devuelve 3350,4 J/g Steam_HPTL Calcula la entalpía específica de líquido como una función de presión (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 saturación de P, la función de vuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la presión crítica. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HPTL(P, T) Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. 236 PI System Explorer Guía del usuario

247 Asset-Based Analytics para PI Server T Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Entalpía específica de líquido calculada en J/g. Ejemplo Steam_HPTL(40000, 100) Devuelve 449,27 J/g Steam_HPX Calcula la entalpía específica como una función de presión (P en kpa) y calidad (fracción de vapor). Se utiliza solo con el vapor húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HPX(P, X) Argumentos P X Presión del vapor. P puede estar en el rango de 0, a kpa. Calidad del vapor (fracción de vapor). X puede estar en el rango de 0,0 a 1,0. Devuelve Entalpía específica calculada en J/g. Ejemplo Steam_HPX(10000, 0.9) Devuelve 2593,7 J/g Steam_HsatP Calcula la entalpía específica del vapor saturado como una función de presión (P en kpa). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HsatP(P) Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. Devuelve Entalpía específica del vapor saturado calculada en J/g. PI System Explorer Guía del usuario 237

248 Asset-Based Analytics para PI Server Ejemplo Steam_HsatP(10000) Devuelve 2725,5 J/g Steam_HsatT Calcula la entalpía específica del vapor saturado como una función de temperatura (T en C). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_HsatT(T) Argumentos T Temperatura del vapor. T puede estar en el rango de 0,0 a 373,946 C. Devuelve Entalpía específica del vapor saturado calculada en J/g. Ejemplo Steam_HsatT(250) Devuelve 2801 J/g Steam_PsatT Calcula la presión de saturación como una función de temperatura (T en C). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_PsatT(T) Argumentos T Temperatura del vapor. T puede estar en el rango de 0,0 a 373,946 C. Devuelve Presión de saturación del vapor calculada en kpa. Ejemplo Steam_PsatT(250) Devuelve 3975,9 kpa 238 PI System Explorer Guía del usuario

249 Asset-Based Analytics para PI Server Steam_SPH Calcula la entropía específica de vaporización como una función de presión (P en kpa) y la entalpía (H, en J/g). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SPH(P, H) Argumentos P H Presión del vapor. P puede estar en el rango de 0, a kpa. Entalpía del vapor. H puede estar en el rango de -0,04159 a 4160,7 J/g. Devuelve Entropía específica del vapor calculada en J/(g K). Ejemplo Steam_SPH(10000, 3500) Devuelve 6,756 J/(g K) Steam_SPT Calcula la entropía específica de vaporización como una función de presión (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 saturación de P, la función devuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la presión crítica. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SPT(P, T) Argumentos P T Presión del vapor. P puede estar en el rango de 0, a kpa. Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Entropía específica del vapor calculada en J/(g K). Ejemplo Steam_SPT(40000, 600) Devuelve 6,017 J/(g K) PI System Explorer Guía del usuario 239

250 Asset-Based Analytics para PI Server Steam_SPTL Calcula la entropía específica de líquido como una función de presión (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 saturación de P, la función devuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la presión crítica. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SPTL(P, T) Argumentos P T Presión del vapor. P puede estar en el rango de 0, a kpa. Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Entropía específica de líquido calculada en J/(g K). Ejemplo Steam_SPTL(30000, 500) Devuelve 5,7956 J/(g K) Steam_SPX Calcula la entropía específica de vaporización como una función de presión (P en kpa) y calidad (fracción de vapor). Se utiliza solo con el vapor húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SPX(P, X) Argumentos P X Presión del vapor. P puede estar en el rango de 0, a kpa. Calidad del vapor (fracción de vapor). X puede estar en el rango de 0,0 a 1,0. Devuelve Entropía específica de la vaporización calculada en J/(g K). Ejemplo Steam_SPX(15000, 0.7) Devuelve 4,8229 J/(g K) 240 PI System Explorer Guía del usuario

251 Asset-Based Analytics para PI Server Steam_SsatP Calcula la entropía específica del vapor como una función de presión (P en kpa). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SsatP(P) Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. Devuelve Entropía específica del vapor saturado calculada en J/(g K). Ejemplo Steam_SsatP(10000) Devuelve 5,6159 J/(g K) Steam_SsatT Calcula la entropía específica del vapor saturado como una función de temperatura (T en C). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_SsatT(T) Argumentos T Temperatura del vapor. T puede estar en el rango de 0,0 a 373,946 C. Devuelve Entropía específica del vapor saturado calculada en J/(g K). Ejemplo Steam_SsatT(250) Devuelve 6,0722 J/(g K) Steam_TPH Calcula la temperatura del vapor como una función de presión (P en kpa) y la entalpía (H, en J/g). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_TPH(P, H) PI System Explorer Guía del usuario 241

252 Asset-Based Analytics para PI Server Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. H Entalpía del vapor. H puede estar en el rango de -0,04159 a 4160,7 J/g. 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 función de presión (P en kpa) y la entropía (S, en J/(g K)). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_TPS(P, S) Argumentos P S Presión del vapor. P puede estar en el rango de 0, a kpa. Entropía específica del vapor. S puede estar en el rango de -0, a 11,921J/(g K). Devuelve Temperatura del vapor calculada en C. Ejemplo Steam_TPS(40000, 6) Devuelve 595,93 C Steam_TsatP Calcula la entropía de saturación como una función de presión (P en kpa). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_TsatP(P) Argumentos 242 PI System Explorer Guía del usuario

253 Asset-Based Analytics para PI Server P Presión del vapor. P puede estar en el rango de 0, a kpa. Devuelve Temperatura de saturación calculada en C. Ejemplo Steam_TsatP(10000) Devuelve 311 C Steam_VPH Calcula el volumen específico de vapor como una función de presión (P en kpa) y la entalpía (S, en J/g). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VPH(P, H) Argumentos P H Presión del vapor. P puede estar en el rango de 0, a kpa. Entalpía del vapor. H puede estar en el rango de -0,04159 a 4160,7 J/g. Devuelve Volumen específico de vapor calculado en cm 3 /g. Ejemplo Steam_VPH(25000, 3500) Devuelve 14,197 cm 3 /g Steam_VPS Calcula el volumen específico de vapor como una función de presión (P en kpa) y la entropía (S, en J/(g K)). Se utiliza con el vapor sobrecalentado y húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VPS(P, S) Argumentos P S Presión del vapor. P puede estar en el rango de 0, a kpa. Entropía específica del vapor. S puede estar en el rango de -0, a 11,921J/(g K). PI System Explorer Guía del usuario 243

254 Asset-Based Analytics para PI Server Devuelve Volumen específico de vapor calculado en cm 3 /g. Ejemplo Steam_VPS(40000, 6) Devuelve 8,0055 cm 3 /g Steam_VPT Calcula el volumen específico de vapor como una función de presión (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 saturación de P, la función devuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la presión crítica. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VPT(P, T) Argumentos P T Presión del vapor. P puede estar en el rango de 0, a kpa. Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Volumen específico de vapor calculado en cm 3 /g. Ejemplo Steam_VPT(50000, 500) Devuelve 3,8894 cm 3 /g Steam_VPTL Calcula el volumen específico de líquido como una función de presión (P en kpa) y la temperatura (T, en C). Para cualquier valor T superior a la temperatura de saturación de P, la función devuelve un error de fuera de rango. La función acepta, sin embargo, cualquier valor T dentro del rango de temperaturas cuando P es mayor que la temperatura crítica. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VPTL(P, T) Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. 244 PI System Explorer Guía del usuario

255 Asset-Based Analytics para PI Server T Temperatura del vapor. T puede estar en el rango de 0,0 a 800 C. Devuelve Volumen específico de líquido calculado en cm 3 /g. Ejemplo Steam_VPTL(75000, 500) Devuelve 2,308 cm 3 /g Steam_VsatP Calcula el volumen específico de vapor como una función de presión (P en kpa). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VsatP(P) Argumentos P Presión del vapor. P puede estar en el rango de 0, a kpa. Devuelve Volumen específico de vapor calculado en cm 3 /g. Ejemplo Steam_VsatP(10000) Devuelve 18,034 cm 3 /g Steam_VsatT Calcula el volumen específico de vapor saturado como una función de temperatura (T en C). Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_VsatT(T) Argumentos T Temperatura del vapor. T puede estar en el rango de 0,0 a 373,946 C. Devuelve Volumen específico de vapor saturado calculado en cm 3 /g. Ejemplo Steam_VsatT(250) PI System Explorer Guía del usuario 245

256 Asset-Based Analytics para PI Server Devuelve 50,087 cm 3 /g Steam_XPH Calcula la calidad del vapor (fracción de vapor) como una función de presión (P en kpa) y la entalpía (H, en J/g). Se utiliza solo con el vapor húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_XPH(P, H) Argumentos P H Presión del vapor. P puede estar en el rango de 0, a kpa. Entalpía del vapor. H puede estar en el rango de -0,04159 a 4160,7 J/g. Devuelve Calidad del vapor (fracción de vapor) calculada. Ejemplo Steam_XPH(10000, 2500) Devuelve 0,82888 Steam_XPS Calcula la calidad del vapor (fracción de vapor) como una función de presión (P en kpa) y la entropía (S, en J/(g K)). Se utiliza solo con el vapor húmedo. Los argumentos de entrada y los valores devueltos están, de forma predeterminada, en unidades SI. Puede cambiar las unidades de medida, por ejemplo, utilizando la función Convert. Sintaxis Steam_XPS(P, S) Argumentos P S Presión del vapor. P puede estar en el rango de 0, a kpa. Entropía específica del vapor. S puede estar en el rango de -0, a 11,921J/(g K). Devuelve Calidad del vapor (fracción de vapor) calculada. Ejemplo Steam_XPS(10000, 5) Devuelve 0, PI System Explorer Guía del usuario

257 Uso de marcos de evento para capturar eventos de proceso La captura de eventos importantes del proceso y la recopilación de datos pertinentes relacionados con esos eventos pueden ayudar a analizar el motivo por el que se han producido. Por ejemplo, puede supervisar de cerca eventos, como el período 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 recopilación de datos a lo largo de períodos 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 análisis. 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 análisis 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 período de tiempo del evento con datos de activo completos y pertinentes: Datos de evento de ejemplo En esta sección Marcos de evento Métodos de creación de marcos de evento Plantillas de marcos de evento Visualización de marcos de evento con herramientas cliente Representación de eventos en PI Asset Framework Marcos de evento Un marco de evento es una función de PI System que permite capturar, realizar un seguimiento, comparar o analizar procesos o eventos empresariales importantes y sus datos relacionados durante períodos de tiempo repetidos. Los marcos de evento representan repeticiones del proceso que los usuarios desean conocer; por ejemplo, períodos de inactividad PI System Explorer Guía del usuario 247

258 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 finalización, uno o varios atributos y uno o más 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 búsquedas 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 automática 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 históricos. 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 actualización al paquete completo de PI Server más reciente. Cuándo utilizar marcos de evento Existen dos categorías 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 rápidamente 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? Cuáles son los datos asociados para el período de tiempo concreto en que se produjo un problema o podría producirse en el futuro? Cuáles son los eventos de proceso esenciales que es necesario notificar a alguien? Existe algún estado digital para los tags de PI System que sea significativo cuando se modifica y deba iniciar alguna otra acción? En esta sección Ejemplos de marcos de evento Ventajas de PI Event Frames PI Event Frames o PI Batch? 248 PI System Explorer Guía del usuario

259 Uso de marcos de evento para capturar eventos de proceso Ejemplos de marcos de evento Ejemplo de marcos de evento en una empresa de generación de energía eólica Tomemos como ejemplo una empresa de generación de energía eólica que tiene distintos tipos de molinos en diferentes ubicaciones y utiliza PI AF para organizar sus datos. Su estructura de activos se basa en una plantilla de elementos básicos de tipo "molino" y tiene distintos elementos secundarios basados en OEM, un modelo y una potencia nominal expresada en megavatios. Es posible que el operador de energía eólica desee obtener contratos de garantía favorables demostrando que las aspas están funcionando de forma segura. O es posible que el operador necesite supervisar parámetros, como la presión del aceite lubricante, el voltaje máximo, el factor de potencia o el funcionamiento correcto de los servofrenos mecánicos y electrónicos 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 específicos. El molino de ejemplo de Asset Framework puede incluir estos atributos de activos y atributos de marcos de evento asociados: Atributo de activo RPM Voltaje Potencia Giro Paso Presión del aceite lubricante Atributo de marco de evento Velocidades instantánea y máxima Voltaje máximo Potencia en el momento actual Giro en el momento actual Paso en el momento actual Presión máxima del aceite lubricante Puesto que todos los tipos de turbina comparten atributos idénticos, 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 notación 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 creación de marcos de evento utilizando análisis basados en activos en PI Server 2014, consulte Crear de forma automática 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 superposición en un elemento de PI AF. Capturan cualquier evento; un "batch" es solo un tipo de evento capturable. Opciones de búsqueda sencillas Se pueden especificar búsquedas con cualquier número de atributos de marco de evento configurables; la especificación de un intervalo de tiempo es opcional. Por ejemplo, puede realizar búsquedas introduciendo simplemente el nombre del marco de evento. Los PI System Explorer Guía del usuario 249

260 Uso de marcos de evento para capturar eventos de proceso atributos de marco de evento buscados con más frecuencia se pueden configurar como atributos indexados mediante plantillas de marcos de evento; esto agiliza las búsquedas de los usuarios finales. Escalabilidad PI Event Frames admite un alto grado de escalamiento si bien el rendimiento disminuye con un gran número de batches (decenas de miles). PI Event Frames o PI Batch? PI Batch proporciona un procedimiento para generar datos de eventos de batch en función de PI tags. PI Event Frames proporciona un método 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 implementación 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 función de sus necesidades de proceso o empresariales, como: Es usuario de PI Batch y utiliza tendencias de superposición o RtReports. Debe continuar utilizando PI Batch. Los casos de uso típicos de PI Batch incluyen ejecuciones de calidad del papel, operaciones de proceso de batches químicos, etc. No utiliza actualmente PI Batch, pero tiene casos de uso de batches, necesita tendencias de superposición o debe utilizar RtReports. Debe utilizar PI Batch. OSIsoft ofrecerá una ruta de migración 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 típicos 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 producción porque aumentan la complejidad de la migración. Funciones de PI System no compatibles con PI Event Frames Tendencia de superposición (sustitución 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 elaboración de informes de terceros. Métodos de creación 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 análisis basados en activos de PI Server 2014 para crear marcos de evento. 250 PI System Explorer Guía del usuario

261 Mediante análisis 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 jerarquía de eventos o convertir una estructura de PI BaGen en una estructura generadora de marcos de evento. Utilice PI System Explorer o PI Builder para crear las plantillas de marcos de evento, los atributos asociados y las referencias de PI points. Para obtener instrucciones detalladas sobre la creación de eventos con PI EFGen, vea el vídeo How to Create PI EF Events, EF Attributes, and EF Templates del OSIsoft Learning Channel. Mediante PI interfaces para sistemas de ejecución por lotes y de fabricación 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 más información sobre la creación 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 creación manual de marcos de evento Uso de marcos de evento para capturar eventos de proceso OSIsoft no recomienda en absoluto la creación y la administración de marcos de evento de forma manual y recomienda utilizar PI Server 2014 junto con Asset-Based Analytics o PI Batch, en función 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 búsquedas. Por ejemplo, los eventos de inactividad tienen con frecuencia un código de motivo que es posible que los usuarios deseen buscar o filtrar durante el análisis de sus eventos de inactividad. También 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 desviación de la temperatura es probable que tenga un atributo para la temperatura máxima. PI Event Frames calculará de forma automática estos valores. Asimismo, con cada tipo de evento, puede configurar un índice para los atributos que se buscan con más frecuencia. Esto permite realizar búsquedas de manera más rápida 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 pestaña Biblioteca en el panel izquierdo pulsando con el botón secundario sobre Plantillas de marcos de evento y seleccionando Nueva plantilla. Los parámetros de sustitución 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 notación simple tiene muchos usos prácticos 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. PI System Explorer Guía del usuario 251

262 Uso de marcos de evento para capturar eventos de proceso Visualización 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 elaboración 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 exploración y la comparación de eventos jerárquicos. 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 período de inactividad. PI Coresight permite ver marcos de evento con el visor "Eventos relacionados". Para obtener más información, consulte el tema Discovering and analyzing events de la biblioteca PI Live Library. Nota: PI Coresight no admite tendencias de superposición. Para obtener más información sobre la elección entre PI Batch y PI Event Frames, consulte PI WebParts PI WebParts no incluye características específicas relacionadas con la visualización de marcos de evento. Sin embargo, puede crear un conjunto de datos en función 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 finalización, a los demás elementos web de la página. Representación de eventos en PI Asset Framework En esta sección 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 sección Crear un marco de evento 252 PI System Explorer Guía del usuario

263 Uso de marcos de evento para capturar eventos de proceso Cambiar plantillas o añadir 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 botón secundario en la colección Búsquedas 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 pestañas para poder configurarlo. La pestaña General contiene las propiedades básicas 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 botón 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 más información. 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 información almacenada en Propiedades ampliadas mediante programación con el PI AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta característica avanzada. 4. Modifique las pestañas restantes, según sea necesario. Para obtener más información, consulte Crear atributos en marcos de evento y Configurar el elemento referenciado primario. En esta sección Configurar el elemento referenciado primario Búsqueda 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 pestaña 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 verificación en el icono de elemento primer elemento referenciado añadido se establece, de forma predeterminada, como elemento referenciado primario. PI System Explorer Guía del usuario 253

264 Uso de marcos de evento para capturar eventos de proceso 1. Pulse con el botón 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 automática un nuevo elemento primario referenciado. Tendrá que repetir estos pasos para crear un elemento primario referenciado de forma manual. Búsqueda de marcos de evento Procedimiento 1. En el panel del navegador, haga clic en el botón Marcos de evento. El navegador mostrará las colecciones: Búsquedas de marcos de evento y Búsquedas de transferencias. Nota: Si ha creado recientemente un marco de evento, también se mostrará en el navegador la colección Marcos de evento recientes. Del mismo modo, si ha creado recientemente una transferencia, se mostrará la colección Transferencias recientes en el navegador. 2. Pulse con el botón secundario sobre la colección Búsquedas de marcos de evento y seleccione Nueva búsqueda en el menú que se muestra. Se abrirá la ventana Criterios de búsqueda de marcos de evento. 3. Introduzca criterios de búsqueda de marcos de evento. Observe el triángulo situado al final del campo Buscar; le permitirá alternar entre distintos operadores, como: Contiene y Empieza por. Marque la casilla de verificación En curso si desea que en los resultados se muestren solo marcos de evento sin una Hora de finalización concreta. En el campo Nombre, puede introducir caracteres especiales para encontrar coincidencias de una parte del nombre. Para obtener más información, consulte Caracteres especiales en búsquedas de nombres. Para añadir campos que permitan especificar criterios adicionales, haga clic en Añadir criterios y seleccione un parámetro de la lista. Puede utilizar el criterio Raíz de búsqueda de marco de evento para indicar que en los resultados de búsqueda solo se incluyan los marcos de evento que sean secundarios del marco de evento especificado. Puede añadir dos criterios en el campo Duración, si es necesario. Por ejemplo, si desea buscar un marco de evento cuya duración haya sido de una hora como mínimo, pero no superior a tres, defina los dos campos de duración 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 búsqueda, haga clic en Buscar. Los resultados de la búsqueda aparecerán en el área Resultados de búsqueda de la ventana Criterios de búsqueda de marcos de evento. 5. Para filtrar aún más la búsqueda, escriba en el campo de texto situado en la parte superior del área Resultados de búsqueda. A medida que escriba, se irán filtrando los resultados. 254 PI System Explorer Guía del usuario

265 Uso de marcos de evento para capturar eventos de proceso Crear atributos en marcos de evento Procedimiento 1. Localice y seleccione el marco de evento principal en el navegador. 2. Haga clic en la pestaña Atributos del visor. 3. Pulse con el botón 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á añadir un atributo a menos que la plantilla admita extensiones. 4. En el campo Nombre, introduzca un nombre para el atributo. 5. En el campo Descripción, introduzca una descripción para el atributo. 6. Seleccione la casilla de verificación Elemento de configuración de los atributos si un cambio en un valor producirá una modificación del elemento. Anule la selección de la casilla para los atributos con valores que se modificarán con el proceso. 7. Puede organizar los objetos agrupándolos en categorías. Para examinar las categorías 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 estático 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, selecciónela 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 más información sobre la configuración de las referencias de datos, consulte Referencias de datos. Cambiar plantillas o añadir una plantilla Puede cambiar la plantilla en la que se basa un marco de evento existente o añadir una plantilla a un marco de evento que no base en una plantilla. Procedimiento 1. En PI System Explorer, haga clic con el botón secundario en Marcos de evento en el panel del navegador. 2. En el navegador, haga clic con el botón secundario en la colección Búsquedas de marcos de evento y seleccione Nueva búsqueda en el menú que aparece. 3. Localice el marco de evento que desea modificar. La colección de resultados de búsqueda aparecerá en el navegador. 4. Haga clic con el botón 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. PI System Explorer Guía del usuario 255

266 Uso de marcos de evento para capturar eventos de proceso Trabajo con transferencias En este capítulo se describe cómo definir, configurar y trabajar con transferencias en PI System Explorer. En esta sección 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 finalización. Las transferencias son exclusivas de un modelo porque son temporales y solo aparecen en un modelo cuando se ha producido una transferencia de materiales. Por ejemplo, utilice transferencias para realizar un seguimiento de los movimientos de materiales dentro y fuera de las instalaciones, de las materias primas utilizadas en el proceso y los productos acabados que se almacenan y de las transferencias de materiales de tanque a tanque. Crear una transferencia Procedimiento 1. En el panel del navegador, haga clic en el botón Marcos de evento. El navegador mostrará las colecciones: Búsquedas de marcos de evento y Búsquedas de transferencias. Nota: Si ha creado recientemente un marco de evento, también se mostrará en el navegador la colección Marcos de evento recientes. Del mismo modo, si ha creado recientemente una transferencia, se mostrará la colección Transferencias recientes. 2. Pulse con el botón secundario sobre la colección Búsquedas 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 opción <Ninguna>. 4. Haga clic en Aceptar. 5. Utilice las opciones de la paleta para configurar la transferencia. Transferir propiedades - Pestaña General Transferir propiedades - Pestaña Atributos Transferir propiedades - Pestaña Puertos En esta sección Transferir propiedades - Pestaña General Transferir propiedades - Pestaña Atributos Transferir propiedades - Pestaña Puertos 256 PI System Explorer Guía del usuario

267 Uso de marcos de evento para capturar eventos de proceso Transferir propiedades - Pestaña General La pestaña General ofrece las siguientes opciones: Nombre: introduzca un nombre para la transferencia. Descripción: introduzca una descripción 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. Categorías: De solo lectura para transferencias basadas en plantillas. Puede organizar los objetos agrupándolos en categorías (opcional). Para examinar las categorías disponibles, haga clic en. Consulte Categorías para obtener más información. En los campos Hora de inicio/finalización, introduzca las horas de inicio y finalización en que tendrá lugar la transferencia. Para examinar un fecha, haga clic en. PI System Explorer admite la finalización automática 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 finalización automática 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 continuación, seleccione un atributo. Tenga en cuenta que para que aparezcan en la lista, deberá añadir primero los atributos en la pestaña 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 información almacenada en Propiedades ampliadas mediante programación con el PI AF SDK. En general, los usuarios de PI System Explorer no necesitan utilizar esta característica avanzada. Transferir propiedades - Pestaña Atributos La pestaña Atributos ofrece las siguientes opciones: Nombre Introduzca un nombre para el atributo. Descripción Introduzca una descripción para el atributo (opcional). Elemento de configuración Márquela si un cambio de valor producirá una modificación del elemento. Anule la selección de esta casilla para los atributos con valores que se modificarán con el proceso. Categorías PI System Explorer Guía del usuario 257

268 Uso de marcos de evento para capturar eventos de proceso De solo lectura para atributos basados en plantillas. Puede organizar los objetos agrupándolos en categorías (opcional). Para examinar las categorías disponibles, haga clic en. Consulte Categorías para obtener más información. 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 (Asociación de datos con activos). Transferir propiedades - Pestaña Puertos La pestaña Puertos ofrece las siguientes opciones. Puede editar los valores en las columnas o hacer clic con el botón secundario sobre el puerto nuevo, seleccionar Propiedades y rellenar el cuadro de diálogo Propiedades de puerto. Nota: Para especificar este puerto como predeterminado, debe abrir el cuadro de diálogo Propiedades. En el campo Nombre, introduzca un nombre para el puerto. En el campo Descripción, escriba una descripción del puerto. La descripción 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 Categorías permitidas, seleccione las categorías a las que puede pertenecer el puerto. En el campo Conexiones máximas, especifique el número máximo de conexiones que se pueden realizar en el puerto. Introduzca cero para un número ilimitado de conexiones. En el campo Tipo de conexión, seleccione los tipos de elemento a los que se puede conectar el puerto; por ejemplo, Nodo, Límite, Medición, 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 período de tiempo indicado. No obstante, puede utilizar Capturar valores para guardar esos valores en AF. Es posible que esta acción mejore el rendimiento, puesto que resulta más rápido mostrar los valores guardados que obtenerlos. 258 PI System Explorer Guía del usuario

269 Uso de marcos de evento para capturar eventos de proceso También puede utilizar Capturar valores para asegurarse de que los valores de atributo mostrados para los marcos de evento serán igual en el futuro que en el momento en que fueron capturados. Asimismo, el método Capturar valores permite conservar valores que es posible que no estén 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 colección Búsqueda 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 más rápido 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 botón secundario en un marco de evento o transferencia o en una colección (por ejemplo, Búsqueda de marcos de evento) y seleccione Capturar valores. (En las capturas de valores posteriores, la opción se denominará Volver a capturar valores.) Cuando aplique Capturar valores a un grupo, como una colección de búsqueda de marcos de evento o un marco de evento que contenga marcos de evento secundarios, la acción se aplicará a todos los marcos de evento de ese grupo. Bloquear un marco de evento o una transferencia Después de finalizada la acción de un marco de evento o transferencia (por ejemplo, tras finalizar un batch), el marco de evento o la transferencia seguirán abiertos y podrán 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 podrán desbloquearlo. Procedimiento 1. En PI System Explorer, haga clic con el botón secundario en Marcos de evento en el panel del navegador. 2. En el navegador, abra la colección Búsquedas de marcos de evento (o Búsquedas de transferencias) que contenga el objeto que desea bloquear. 3. Haga clic con el botón secundario sobre el objeto y seleccione Bloquear en el menú contextual. Junto al objeto bloqueado, se mostrará un icono de candado. PI System Explorer Guía del usuario 259

270 Uso de marcos de evento para capturar eventos de proceso 260 PI System Explorer Guía del usuario

271 Temas avanzados En esta sección se ofrece información de referencia, información sobre las utilidades de PI AF e instrucciones para crear tipos de referencia personalizados, administrar módulos, etc. En esta sección Cadenas de configuración de atributos Actualizaciones masivas de cadenas de configuración Sintaxis de referencia de atributo Utilidades de PI AF Persistencia Limitaciones respecto a los nombres de objetos de AF Introducción de valores para tipos de valor Creación de tipos de referencia personalizados Copiar rutas Almacenar información específica de aplicaciones Gestión de módulos Modelado de un proceso Cadenas de configuración de atributos La cadena de configuración de atributo define la totalidad del atributo de referencia de datos. La sintaxis de una cadena de configuración depende del tipo de referencia de datos. Para ver la cadena de configuración de atributo en PI System Explorer, seleccione el atributo de AF en la pestaña Atributos. La cadena de configuración se muestra en el campo situado debajo del botón 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 configuración se mostrará en el cuadro de texto situado debajo del botón Ajustes. Podrá modificar las cadenas de configuración directamente en el cuadro de texto. En la siguiente tabla se incluyen ejemplos de cadenas de configuración de distintos tipos de referencias de datos: Tipo de referencia de datos Fórmula PI Point Matriz de PI Point Generador de cadenas Búsqueda de tabla Cadena de configuración de ejemplo D=Density;V=Volume;[D*V] A=Attribute3;[A*3];UOM=cm \\My_PI_Server\sinusoid \\ \ChocMilkMeter;TimeMethod=TimeRange; RelativeTime=-1h;TimeRangeMethod=Total;ReadOnly=False \\My_PI_Server\Point.1 Point.2 Point.3 "%Attribute% value is";'attribute1'; SELECT Density FROM [Material Specifications] WHERE MaterialID PI System Explorer Guía del usuario 261

272 Temas avanzados En esta sección Cadenas de configuración para referencias de datos de PI points Especificación de PI points Configuración de valores de atributo Cadenas de configuración para creación automática de puntos Cadenas de configuración para referencias de datos de PI points En esta sección se explica la sintaxis de las cadenas de configuración de las referencias de datos de PI points. La cadena de configuración 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 configuración, separadas por punto y coma. Entre las opciones de configuración están: referencia de PI point (obligatorio, siempre al comienzo de la cadena) configuración de obtención de valor de atributo (opcional) unidades de medida (opcional) parámetros de sustitución (opcional) especificaciones de creación de punto: solo válido para las plantillas de atributos (opcional) Ejemplos: referencias de datos de PI points A continuación, se muestran algunos ejemplos: Referencia simple a un punto en un PI Server denominado MyPIServer: \\MyPIServer\sinusoid Cadena de configuración que hace referencia al mismo punto, pero con una recuperación del tiempo específica y unidades de medida concretas: \\MyPIServer\sinusoid;TimeMethod=ExactTime;UOM= C Cadena de configuración 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 configuración procedente de una plantilla de atributos que utiliza parámetros de sustitución: \\%Server%\%Element%.%Attribute% La misma cadena de configuración, pero con creación de etiquetas activada y especificación de configuración de punto: \\%Server%\%Element%.%Attribute %;ptclassname=classic;pointtype=float32;engunits=m3/ s;location1=1;location2=30;location4=1;location5=1;pointsource=r Especificación de PI points Para hacer referencia a un PI point, puede utlizar una referencia directa o indirecta. Consulte Especificación del PI point para obtener más información. En esta sección Referencia de PI point directa 262 PI System Explorer Guía del usuario

273 Temas avanzados Referencia indirecta Referencia de PI point directa En la cadena de configuración, 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 también parámetros de sustitución 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 Referencia indirecta Para hacer referencia a otro atributo, la cadena de configuración utiliza una ruta relativa. La ruta relativa identifica un atributo de referencia de datos en función de su nombre y del lugar que ocupa en la jerarquía de elementos y atributos. En el caso de la referencia de datos de PI Point, la ruta debe incluir una designación de ruta de atributo ( o..) en la cadena de configuración para que puede diferenciarse de una referencia de PI Point. En la siguiente tabla, se muestran las configuraciones típicas de las referencias indirectas: Objeto Atributo de nivel superior del mismo elemento Atributo principal.. Atributo secundario Atributo del mismo nivel (si no hay un atributo de nivel superior) De marco de evento a elemento primario Ruta completa Sintaxis de ejemplo toplevelattribute. childattribute.. siblingattribute.\elements[.] attribute \\myserver\mydatabase\myelement myattribute Consulte Sintaxis de referencia de atributo para obtener más información 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. Configuración de valores de atributo Si utiliza la configuración predeterminada, la cadena de configuración no incluirá la configuración del valor de atributo. En PI System Explorer, el valor predeterminado significa que el campo Por Tiempo se configura como Automático. Sin embargo, si establece el campo Por Tiempo en un valor distinto, la cadena de configuración incluirá esos ajustes. Por ejemplo, si selecciona Hora exacta, la cadena de configuración muestra: TimeMethod=ExactTime En el siguiente ejemplo, TimeMethod,RelativeTime, ytimerangemethod son todas opciones de cadenas de configuración. \\MyPIServer\BA:CONC. 1;TimeMethod=TimeRangeOverride;RelativeTime=-1h;TimeRangeMethod=Total;RateConversi on=day PI System Explorer Guía del usuario 263

274 Temas avanzados Los ajustes de recuperación 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 configuración de valor En la siguiente tabla se incluyen las opciones disponibles para las cadenas de configuración de valores: Opciones Sintaxis Valores Ejemplo opción de tiempo opción de tiempo relativo opciones de intervalo de tiempo porcentaje mínimo correcto del intervalo de tiempo 1 opción de base de cálculo del intervalo de tiempo 1 TimeMethod=<método de tiempo> RelativeTime=[*] + - <entero><unidad de tiempo> TimeRangeMethod=<mé todo de intervalo de tiempo> TimeRangeMinPercentG ood=<porcentaje> CalculationBasis=<base del cálculo> donde el método de cálculo del tiempo es uno de los siguientes: After AtOrAfter Before AtOrBefore Automatic ExactTime Interpolated NotSupported TimeRange TimeRangeOverride donde la unidad de tiempo es uno de estos valores: y M d h m s donde el método del intervalo de tiempo es uno de los siguientes: Maximum Minimum PopulationStandardDevi ation Range StandardDeviation StartTime Total donde la base del cálculo es una de estas opciones EventWeighted EventWeightedExcludeE arliestevent EventWeightedExclude MostRecentEvent EventWeightedIncludeB othends TimeWeighted TimeWeightedContinou s TimeWeightedDiscrete opción de conversión de RateConversion=<uom> donde uom es una velocidad 2 unidad de medida definida opción de caso case option=case Method=<método del caso> donde el método del caso es uno de los siguientes métodos: StartTime EndTime TimeRange Automatic TimeMethod=Automatic RelativeTime=-1h TimeRangeMethod=Tot al RateConversion=minute Case Method=EndTime 264 PI System Explorer Guía del usuario

275 Temas avanzados Opciones Sintaxis Valores Ejemplo opción de unidad de medida UOM=<uom> donde uom es una unidad de medida definida opción de solo lectura ReadOnly=<booleano> donde booleano es uno de estos valores: true false UOM= C ReadOnly=false 1 se utiliza al especificar una opción de intervalo de tiempo 2 se utiliza solo cuando TimeRangeMethod=Total Cadenas de configuración para creación automática de puntos Nombre ptclassname pointtype pointsource Si va a configurar una plantilla de atributos, puede utilizar la opción Creación de tag para crear de forma automática PI points para cualquier atributo que se base en esa plantilla. La cadena de configuración debe especificar, como mínimo, 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 configuración del punto utiliza los ajustes predeterminados. Cualquier cambio que realice en los valores predeterminados de configuración se incluirán en la cadena de configuración. Observe, por ejemplo, esta cadena de configuración: \\%Server%\%Element%.%Attribute %;ptclassname=classic;pointtype=float32;location4=1;location5=2;pointsource=r;span =200;zero=1100 La cadena de configuración anterior especifica los siguientes valores de creación de tags: location4 1 location5 2 Ajuste classic Float32 span 200 zero 1100 R Actualizaciones masivas de cadenas de configuración La herramienta de línea de comandos afupdatepluginconfigurations permite actualizar varias cadenas de configuración de atributos con un único comando. Cuando ejecute la herramienta: 1. Utilice el parámetro -root para especificar en qué PI System y, opcionalmente, para qué base de datos de AF se realizarán las actualizaciones. 2. Seleccione uno de los modos de actualización que se describen a continuación especificando una de estas tres opciones de actualización: -CreateConfig,-Repair o- ReplacePIServer. PI System Explorer Guía del usuario 265

276 Temas avanzados 3. (Opcional): Ejecute, en primer lugar, el comando con la opción -list. En lugar de realizar actualizaciones, la herramienta incluirá en una lista todos los atributos con los que se trabajará. 4. Después de ejecutar la herramienta, haga clic en Actualizar en PI System Explorer para ver los cambios ( ). Opción -CreateConfig La opción -CreateConfig realiza de forma masiva la misma operación que cuando se hace clic con el botón secundario en una referencia de datos de PI point y se selecciona Crear o actualizar PI points. Esta operación crea el PI point si no existe todavía 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 todavía 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 operación 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 operación CreateConfig en todos los atributos de un determinado PI System, utilice el siguiente comando: afupdatepluginconfigurations "-root:\\mypisystem" -CreateConfig Opción -Repair La opción -Repair permite corregir los atributos de referencia de datos de PI point cuya cadena de configuración almacenada ha dejado de estar sincronizada con el PI Server. Por ejemplo, porque se ha eliminado el PI point al que señala 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 configuración almacenada. La operación - Repair actualiza la cadena de configuración almacenada con el nuevo point ID. PI points con otro nombre asignado Si ha asignado otro nombre a un PI point, la cadena de configuración almacenada sigue utilizando el nombre anterior del PI point. La operación -Repair actualiza la cadena de configuración almacenada con el nuevo nombre del PI point. Atributos que no se han resuelto todavía Si no ha creado todavía el PI point al que señala la referencia de datos, la cadena de configuración almacenada no incluirá el point ID. Después de crear el PI point, puede utilizar la operación -Repair para actualizar la cadena de configuración almacenada con el nuevo point ID. El siguiente ejemplo repara las cadenas de configuración 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 Opción -ReplacePIServer La opción -ReplacePIServer permite actualizar de forma masiva el nombre del PI Server en la cadena de configuración de varios atributos. El siguiente comando actualiza todos los atributos de una base de datos de AF especificada a un nuevo PI Server: 266 PI System Explorer Guía del usuario

277 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 función de su nombre y su posición en la jerarquía de elementos y atributos. Mediante filtros, índices y comodines, puede crear una expresión para representar una ruta que encuentre un único atributo o varias rutas que obtengan una colección 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 comodín para crear una expresión que represente una ruta que devuelva un solo atributo o una colección 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 carácter 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 número exclusivo de 128 bits generado por Windows que sirve para identificar un componente, aplicación, archivo o entrada de base de datos concretos. Los GUID deben especificarse entre corchetes ({ y }). Por ejemplo: \\{5c64c379-c182-4f35-8d30-78d8c2f84502}\{5c64c379-c182-4f35-8d30-78d8c2f84503} Si especifica el nombre y el GUID, sepárelos con un punto y coma (;). El primero que se especifique tendrá prioridad en la búsqueda. 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 colección en el que está incluido un objeto Uno o varios filtros de colección Índices, para obtener un miembro concreto de una colección El carácter comodín de asterisco (*), en los nombres de los objetos Especificación del PI Server Las rutas completas deben ir precedidas de dos barras diagonales invertidas (\\) seguidas del PI System o PI Server. PI System Explorer Guía del usuario 267

278 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 colección de PI Servers, utilice el siguiente formato: \ \PIServers[MyPIServerName]. Especificación de base de datos de AF La base de datos de AF sigue la especificación 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 colección como se muestra en el siguiente ejemplo: \\MySystem \Contacts[JSmith]. Uso de parámetros 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 más de un nivel por encima del objeto actual. Un único signo de punto (.) representa al objeto actual. Utilícelo 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. También se admiten rutas a objetos dinámicos. 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 dinámico. 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 colección predeterminado. Por ejemplo, un PI System tiene una colección de bases de datos predeterminada y una base de datos de AF tiene una colección 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 268 PI System Explorer Guía del usuario

279 Temas avanzados Filtros Un filtro de colección empieza por el signo seguido del nombre del filtro. Los filtros admitidos son: Debe incluir la especificación del filtro entre corchetes ([ y ]). El siguiente ejemplo devuelve el atributo Volumede todos los elementos en la categoría,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 evaluarán 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 posición del objeto coincidente para devolver (el primer elemento está en la posición de índice 1). El filtro de índice debe ser el último índice especificado. El siguiente ejemplo devuelve la tercera base de datos en la colección 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 carácter comodín Puede colocar el carácter comodín de asterisco (*) en el nombre de cualquier objeto para que coincida con cero o más 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 cómo 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. PI System Explorer Guía del usuario 269

280 Temas avanzados Los ejemplos que figuran a continuación se refieren al dibujo de arriba. Tipo de referencia Para hacer referencia a este atributo Desde este atributo Tipo: Atributo principal Nivel Promedio Level Atributo primario principal Nivel Intervalo Level o.. o.... Atributo principal Promedio Intervalo Level Average Atributo del mismo nivel Promedio Mínimo Level Average o.. 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 sección 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 símbolo de barra vertical ( ) y utilícelo para separar niveles de atributo. Por ejemplo, la siguiente ilustración muestra los atributos de un elemento denominado Reactor1: 270 PI System Explorer Guía del usuario

281 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 símbolo 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 ningún otro tipo de notación; 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 más 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 jerarquía de atributos. Por ejemplo, para especificar el atributo principal puede utilizar:.. Puede utilizar esta notación para mover hacia arriba los elementos antecesores del atributo. Por ejemplo, para hacer referencia al atributo primario principal, utilice:.... En la siguiente ilustración se muestran los atributos de un elemento denominado Reactor1: PI System Explorer Guía del usuario 271

282 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 sería escribir: Level Nota: No puede utilizar esta notación para hacer referencia al atributo Temperature desde el atributo Average, porque este no es un descendiente del atributo Temperature. Asimismo, no podrá utilizar esta notación para hacer referencia al atributo Average desde el atributo Interval, porque Average no está en el nivel superior de la jerarquía de atributos. Para hacer referencia al atributo Level desde el atributo Interval, escriba:.... No puede utilizar esta notación 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 ilustración 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 272 PI System Explorer Guía del usuario

283 Temas avanzados No puede utilizar esta notación 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 cómo referenciar atributos de distintos elementos Puede referenciar atributos que pertenezcan a distintos elementos del siguiente modo: Directamente desde el nivel máximo de la jerarquía de elementos en la base de datos (Atributo relativo a la base de datos) Mediante la especificación del elemento principal del atributo de destino con una ruta relativa (Atributo relativo al elemento contenedor). En esta sección 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 función de una vía de acceso relativa a la raíz 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 utilícela para separar niveles de elemento. Coloque una barra vertical delante del atributo ( ). Por ejemplo: \Reactors\React1 pressure Este ejemplo supone que el elemento Reactors se encuentra en el nivel superior de la jerarquía de elementos. Puede utilizar siempre esta notación para hacer referencia a un atributo relativo al nivel superior de elementos de la base de datos. Por ejemplo, supongamos que tiene una jerarquía de elementos similar a la que se muestra en esta figura: Supongamos que desea hacer referencia a un atributo denominado pressure (presión), que pertenece al elemento NewTank. Puede escribir lo siguiente: \Tanks\Tank1\NewTank pressure Si desea representar un atributo de presión secundario, denominado temp, la referencia es: \Tanks\Tank1\NewTank pressure temp Consulte Especificar un descendiente de un atributo de referencia para obtener más detalles sobre cómo 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 jerarquía de elementos y.. para moverse hacia arriba. PI System Explorer Guía del usuario 273

284 Temas avanzados En esta ilustración, lso elementos (Tank1, Tank2, Tank3 y NewTank) tiene cada uno de ellos un atributo denominado presión: Estos ejemplos demuestran el uso de la sintaxis: Referencia a un elemento del mismo nivel: Para referirse al atributo de presión del Tank2 desde el Tank1, escriba:..\tank2 pressure Referencia a un elemento principal: Para referirse al atributo de presión del Tank1 desde el NewTank, escriba:..\ pressure Referencia a un elemento secundario: Para referirse al atributo de presión del NewTank desde el Tank1, escriba:.\newtank pressure Ejemplos de cómo 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 colección Elementos del marco de evento. Por ejemplo:.\elements[.] Temperature Utilidades de PI AF En esta sección se describen las utilidades que se suministran con PI AF. En esta sección Iniciar PSE con opciones de línea de comandos Exportar objetos de PI AF Importar objetos de PI AF AFDiag: Utilidad de diagnóstico 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 auditoría Iniciar PSE con opciones de línea de comandos PI System Explorer (PSE) se puede invocar con opciones de línea de comandos que controlen su selección inicial. La aplicación PI System Explorer se denomina AFExplorer.exe y está ubicada en la carpeta \PIPC\AF. 274 PI System Explorer Guía del usuario

285 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 parámetros: /system /database /navigator Consulte Parámetros de AFExplorer para obtener más información. Para mostrar una lista de los parámetros disponibles, escriba: afexplorer /? En esta sección Parámetros de AFExplorer Valores de parámetros de navegador Parámetros de AFExplorer La utilidad afexplorer proporciona tres parámetros. Parámetro Valor Ejemplo /system /database /navigator Establezca el parámetro del sistema en el nombre de host del servidor de PI AF al que se conectará PSE de forma predeterminada. Establezca el parámetro de la base de datos en el nombre de la base de datos de PI AF que PSE debe abrir inicialmente. Establezca el parámetro del navegador en el módulo de navegador que debe seleccionarse inicialmente en PSE. Los valores disponibles se encuentran incluidos en Valores de parámetros de navegador. afexplorer / system=myafserver afexplorer / database=myafdatabase afexplorer / navigator=elements Valores de parámetros de navegador Valor de parámetro Elements EventFrames Library UnitOfMeasure MyPI Notifications Ejemplo afexplorer /Navigator=Elements afexplorer /Navigator=EventFrames afexplorer /Navigator=Library afexplorer /Navigator=UnitOfMeasure afexplorer /Navigator=MyPI afexplorer /Navigator=Notifications PI System Explorer Guía del usuario 275

286 Temas avanzados Valor de parámetro Ejemplo AFContactNavigator afexplorer / Navigator=AFContactNavigator Exportar objetos de PI AF La utilidad AF Export es una aplicación de línea 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. También puede exportar objetos de AF desde PI System Explorer. Consulte la sección Importación y exportación 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 parámetros incluidos en Parámetros de utilidad de exportación de AF. Para mostrar todos los parámetros, escriba: AFExport /? En esta sección Parámetros de utilidad de exportación de AF Pautas para exportar colecciones Ejemplo de rutas de exportación Parámetros de utilidad de exportación de AF Parámetro <Path>A esta tabla le siguen algunos detalles adicionales y ejemplos. /File:<string> /StartTime:<string> /EndTime:<string> /AllReferences[-] /NoReferences[-] Descripción Ruta a un AFObject que se desea exportar. El formato habitual es: \\<pisystem>\<database>. Utilice '.' para exportar la base de datos predeterminada. Véase Ejemplo de rutas de exportación. Especifica un archivo de salida. Si no se especifica ninguno, la salida se transmite a la consola. (forma corta /F) Especifica una hora de inicio para exportar los marcos de evento, transferencias y casos que se encuentren entre la hora de inicio y finalización especificadas. (forma corta /T) Especifica una hora de finalización al exportar marcos de evento, transferencias y casos. (forma corta /E) Exporta cualquier objeto referenciado desde el objeto de AF que se especifique. Esta opción no se puede utilizar con la de 'No References'. (forma corta /A) No exporta ningún objeto referenciado, incluidos los objetos secundarios. Esta opción no se puede utilizar con la de 'All References'. (forma corta /N) 276 PI System Explorer Guía del usuario

287 Temas avanzados Parámetro /DefaultValues[-] /Library[-] /Security[-] /UniqueIDs[-] /Silent[-] /Summary[-] /User:<string> /Password:<string> /Version Descripción Si no se especifica esta opción, las propiedades que están configuradas con los valores predeterminados no se exportarán y el resultado será un archivo de exportación considerablemente más pequeño. La importación 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) Exporta solo los objetos de biblioteca desde una base de datos. Los objetos de biblioteca incluyen todas las categorías, plantillas, conjuntos de enumeración, tipos de referencia y tablas. (forma corta /L) Exporta información de seguridad. La exportación de información de seguridad aumenta el tiempo de exportación y los tiempos de importación posteriores. (forma corta /Y) 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 opción aumenta el tamaño del archivo de salida y puede incrementar el tiempo necesario para la importación. (forma corta /U) Modo silencioso. Impide que se muestren los mensajes informativos. Si no se especifica ningún archivo de salida, se selecciona de forma automática esta opción. (forma corta /S) Modo de resumen. Muestra solo la información mínima en curso. Esta opción no es válida con el modo 'Silent' o si no se especifica ningún archivo de salida. (forma corta /M) Utilice esta opción para especificar una cuenta de Windows diferente para conectarse al servidor de PI AF. (forma corta /user) Si especifica un nombre de usuario, indique la contraseña de las credenciales de red. (forma corta /pw) Utilícelo para mostrar información sobre la versión. Los demás parámetros se omiten. (forma corta /V) Exporta objetos jerárquicos en formato plano. La exportación sin formato puede hacer que resulte más sencillo editar los objetos con algunas herramientas. Los objetos jerárquicos que se exportarán sin formato son: atributos, plantillas de atributos, elementos y marcos de evento. (forma corta /flat) Lee el archivo de respuesta para obtener más opciones. El archivo de respuesta contiene un único parámetro por línea. Las líneas de comentarios comienzan por el carácter '#'. PI System Explorer Guía del usuario 277

288 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 colección escribiendo su nombre entre corchetes. Si no se especifica ningún nombre de colección, se asume la colección secundaria predeterminada para la ubicación de la ruta. La colección secundaria predeterminada de un servidor de PI AF es Bases de datos. La colección secundaria predeterminada de una base de datos es Elementos. La colección secundaria predeterminada de un elemento es Elementos. La colección secundaria predeterminada una base de datos de unidades de medida es UOM. Una barra vertical ( ) indica una colección de atributos o de plantillas de atributos. Ejemplo de rutas de exportación Para exportar... La base de datos predeterminada MyDatabase en el servidor de PI AF predeterminado El elemento MyElement de MyDatabase en MyPISystem Todas las plantillas de elementos de MyDatabase La plantilla de elementos T1 de MyDatabase Todos los conjuntos de enumeración de la base de datos predeterminada MyPISystem Todos los atributos de MyChildElement en la base de datos predeterminada La base de datos de unidades de medida (UOMDatabase distingue entre mayúsculas y minúsculas) Todas las tablas de la base de datos predeterminada MyPISystem...Utilice esta sintaxis Utilice '.' \\.\MyDatabase \\MyPISystem\MyDatabase\MyElement \\.\MyDatabase\ElementTemplates[] \\.\MyDatabase\ElementTemplates[T1] \\MyPISystem\.\EnumerationSets[] \\MyPISystem\MyElement\MyChildElement \Attributes[] \\.\UOMDatabase \\MyPISystem\.\Tables[] Importar objetos de PI AF La utilidad de importación de AF es una aplicación de línea de comandos que sirve para restaurar objetos de AF en una base de datos. También 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 parámetros incluidos en Parámetros de utilidad de importación de AF. Para mostrar todos los parámetros, escriba AFImport /? 278 PI System Explorer Guía del usuario

289 Temas avanzados Parámetros de utilidad de importación de AF Parámetro <Path> /File:<string> /AutoCheckIn[-] /Create[-] /Update[-] /CreateUpdatePIPoints[-] /DisableConfigStringValidation[-] /GenerateUniqueNames[-] /Paste[-] /ContinueOnError /Silent[-] /Summary[-] /User:<string> Descripción Ruta al AFObject en el que se desea realizar la importación. El formato habitual es: \ \<pisystem>\<database>. Utilice '.' para importar la base de datos predeterminada. Especifica un archivo de entrada. Si no se especifica ninguno, la operación de importación realiza la lectura desde la entrada estándar. (forma corta /F) Incorpora automáticamente los cambios durante una operación de importación. Valor predeterminado: 'True' (forma corta /A) Permite a la operación de importación crear objetos. Valor predeterminado: 'True' (forma corta /C) Permite actualizar a la operación de importación objetos existentes. Valor predeterminado: 'True' (forma corta /U) Crea o actualiza la configuración de PI Points para los elementos creados recientemente. Tenga en cuenta que esta opción puede repercutir de manera significativa en el rendimiento de la importación. (forma corta /P) Inhabilita la validación de los valores de cadena de configuración para las referencias de datos y los canales de entrada y, de esta forma, se puede agilizar la operación de importación. Sin embargo, se omitirá la búsqueda de PI Points, que corrige o añade IDs de servidor y Point IDs a las cadenas de configuración. (forma corta /D) Genera nombres exclusivos para los objetos cuando ya existe un objeto con el mismo nombre. (forma corta /G) La operación de pegar se comporta como un proceso de copiar/pegar. En función de dónde se importen los datos, determina si se generará un nombre nuevo o no. (forma corta /Pa) ContinueOnError especifica el comportamiento del proceso de importación cuando se produce un error recuperable. Las tres opciones disponibles son: Yes, No y Prompt. El valor predeterminado es Prompt, salvo en caso de una ejecución silenciosa en cuyo caso se cancelará de forma predeterminada el proceso de importación. (forma corta /CE) Modo silencioso. Impide que se muestren los mensajes informativos. (forma corta /S) Modo de resumen. Muestra solo la información mínima en curso. (forma corta /M) Utilice esta opción para especificar una cuenta de Windows diferente para conectarse al PI System. (forma corta /user) PI System Explorer Guía del usuario 279

290 Temas avanzados Parámetro /Password:<string> Descripción Si especifica un nombre de usuario, indique la contraseña de las credenciales de red. (forma corta /pw) Muestra información sobre la versión. Los demás parámetros se omiten. (forma corta /V) Lee el archivo de respuesta para obtener más opciones. El archivo de respuesta contiene un único parámetro por línea. Las líneas de comentarios comienzan por el carácter '#'. AFDiag: Utilidad de diagnóstico de PI AF PI AF Diagnostics es una utilidad de línea de comandos que sirve para activar o desactivar características del servidor de PI AF y ejecutar otras funciones administrativas. La utilidad establece una conexión 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 sección Otorgar permisos a la utilidad de diagnóstico de AF Ejecutar la utilidad AFDiag Parámetros AFDiag Activación de Pista de auditoría de AF Utilizar la opción AFDIAG EnableSQLTrace para recopilar información de perfil de SQL Gestión de proveedores de módulos de confianza Cambiar el ID del servidor de AF Otorgar permisos a la utilidad de diagnóstico de AF Para poder utilizar la utilidad PI AF Diagnostics, tiene que otorgar el rol db_afadmin al inicio de sesión en SQL Server. Procedimiento 1. En Microsoft SQL Server Management Studio, conéctese 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 continuación, expanda la carpeta Inicios de sesión. 3. Pulse con el botón secundario sobre el inicio de sesión del usuario de Windows correspondiente y seleccione Propiedades. 4. Seleccione la página Asignación de usuarios. 5. Seleccione la fila de la base de datos de PIFD. 6. Marque la casilla de verificación Asignar de la base de datos de PIFD. 7. Con la base de datos seleccionada, marque la casilla de verificación del rol db_admin, como se muestra en el siguiente dibujo. 280 PI System Explorer Guía del usuario

291 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 símbolo del sistema y cambie a la carpeta \PIPC\AF. 2. Tipo: afdiag parameter donde parameter es uno de los parámetros incluidos en Parámetros AFDiag. 3. Para mostrar una lista de los parámetros disponibles, escriba: afdiag /? PI System Explorer Guía del usuario 281