Documente Academic
Documente Profesional
Documente Cultură
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 EE.UU.
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com
Manual del usuario de PI DataLink 2014
1992-2014 by OSIsoft, LLC. Todos los derechos reservados.
Ninguna parte de esta publicacin puede ser reproducida, almacenada en un sistema de recuperacin o
transmitida, de ninguna forma ni por ningn medio, mecnico, fotocopiado, grabado o de cualquier otro
modo, sin el consentimiento previo por escrito de OSIsoft, LLC.
OSIsoft, el logotipo de OSIsoft, PI Analytics, PI ProcessBook, PI DataLink, ProcessPoint, PI Asset
Framework (PI AF), IT Monitor, MCN Health Monitor, PI System, PI ActiveView, PI ACE, PI AlarmView, PI
BatchView, PI Coresight, PI Data Services, PI Event Frames, PI Manual Logger, PI ProfileView, PI
WebParts, ProTRAQ, RLINK, RtAnalytics, RtBaseline, RtPortal, RtPM, RtReports and RtWebParts son
todas marcas comerciales de OSIsoft, LLC. Todas las otras marcas comerciales o nombres comerciales
aqu utilizados son propiedad de sus respectivos propietarios.
DERECHOS DEL GOBIERNO DE LOS EE UU
Su uso, rplica o difusin por parte del Gobierno de EE.UU. est sujeto a las restricciones estipuladas en el
contrato de licencia de OSIsoft, LLC, de acuerdo con lo que establecen las regulaciones DFARS 227.7202,
DFARS 252.227-7013, FAR 12.212, FAR 52.227, segn proceda. OSIsoft, LLC.
Versin: 5.1.0
Publicacin: 9 de abril de 2014
Contenido
Introduccin......................................................................................................... 1
Conceptos bsicos............................................................................................... 13
Interfaz de usuario...................................................................................................................................13
Pestaa PI DataLink............................................................................................................................ 13
Paneles de tareas de funciones............................................................................................................14
Men contextual..................................................................................................................................15
Descripcin general de las funciones de PI DataLink................................................................................15
Elementos de datos.............................................................................................................................16
Campo de entrada............................................................................................................................... 17
Campos de entrada de tiempo............................................................................................................. 17
Datos aadidos................................................................................................................................... 18
Formatos de presentacin................................................................................................................... 19
Bsquedas.............................................................................................................................................. 19
Buscar elementos de datos................................................................................................................. 20
Buscar activos mediante filtros............................................................................................................24
Configuracin de preferencia.................................................................................................................. 26
Lmites de configuracin de zona horaria............................................................................................ 28
Gestionar conexiones con servidores...................................................................................................... 29
iii
Contenido
Funciones de PI DataLink..................................................................................... 51
Matrices de funcin.................................................................................................................................85
Tareas comunes relacionadas con las matrices de funcin...................................................................85
Actualizar entradas en una matriz de funcin...................................................................................... 86
Tamao de la matriz............................................................................................................................87
Redimensionar matrices...................................................................................................................... 87
Frecuencia de clculo.............................................................................................................................. 88
Funcin Actualizacin automtica.......................................................................................................88
Reclculo provocado........................................................................................................................... 89
Recalcular manualmente.....................................................................................................................90
Compartir hojas de clculo......................................................................................................................90
Definir la opcin Clculo de libro de trabajo como manual...................................................................91
Temas avanzados................................................................................................ 93
Tiempo PI................................................................................................................................................93
Abreviaturas de tiempo PI................................................................................................................... 93
Expresiones de tiempo PI.................................................................................................................... 94
Especificacin de intervalos de tiempo................................................................................................94
Especificacin de intervalos de tiempo................................................................................................ 95
Expresiones............................................................................................................................................ 96
Uso de expresiones en funciones de PI DataLink..................................................................................97
Sintaxis de las expresiones.................................................................................................................. 97
Restricciones relativas a los elementos de datos en expresiones..........................................................97
Ejemplos de expresiones..................................................................................................................... 98
Expresiones de filtro............................................................................................................................98
Entrada manual de funciones..................................................................................................................98
Definir funciones manualmente.......................................................................................................... 99
Pautas para introducir argumentos de forma manual.......................................................................... 99
Cdigos de salida...............................................................................................................................100
Funciones para escribir datos.................................................................................................................101
iv
Contenido
Tendencias........................................................................................................107
Notificaciones................................................................................................... 115
Bsqueda e insercin de notificaciones..................................................................................................115
Aadir un servidor de PI AF a la funcin Bsqueda de notificacin..................................................... 116
Ajustar la visualizacin de las notificaciones recuperadas...................................................................117
Gestionar las notificaciones recuperadas........................................................................................... 118
Notificaciones insertadas...................................................................................................................... 118
Configuracin de visualizacin de notificaciones................................................................................... 118
Referencia de funcin.........................................................................................121
Funciones de valor nico....................................................................................................................... 121
PICurrVal()......................................................................................................................................... 121
PIArcVal().......................................................................................................................................... 122
PIExpVal()..........................................................................................................................................123
PITagAtt()......................................................................................................................................... 124
Funciones de valor mltiple...................................................................................................................124
PINCompDat()...................................................................................................................................125
PINCompFilDat()............................................................................................................................... 126
PICompDat()......................................................................................................................................127
PICompFilDat()..................................................................................................................................128
PISampDat()......................................................................................................................................129
PISampFilDat().................................................................................................................................. 130
PIExpDat()......................................................................................................................................... 131
PITimeDat()....................................................................................................................................... 132
PITimeExpDat()................................................................................................................................. 133
Funciones de clculo..............................................................................................................................134
PIAdvCalcVal()................................................................................................................................... 135
PIAdvCalcFilVal()............................................................................................................................... 136
PIAdvCalcExpVal()............................................................................................................................. 137
PIAdvCalcExpFilVal()......................................................................................................................... 139
PIAdvCalcDat().................................................................................................................................. 141
PIAdvCalcFilDat().............................................................................................................................. 142
PIAdvCalcExpDat()............................................................................................................................ 144
PIAdvCalcExpFilDat().........................................................................................................................145
PITimeFilter().....................................................................................................................................147
PITimeFilterVal()............................................................................................................................... 148
Manual del usuario de PI DataLink 2014
Contenido
Funciones de tags..................................................................................................................................149
PIPointIDToTag().............................................................................................................................. 149
PIAttributeMaskToTag ()................................................................................................................... 150
Funciones de Module Database............................................................................................................. 151
PIAliasToTag()................................................................................................................................... 151
PIPropertyToValue()..........................................................................................................................152
Funciones de entrada............................................................................................................................ 152
PIPutVal() y PIPutValX().....................................................................................................................152
Resolucin de problemas....................................................................................155
Archivos de registro...............................................................................................................................155
La pestaa PI DataLink no est disponible............................................................................................. 155
Lmites de matriz y de celda.................................................................................................................. 156
Lmites de recuperacin de datos.......................................................................................................... 156
Elemento de datos no admitido por funcin.......................................................................................... 156
Existe un evento duplicado.................................................................................................................... 156
Seguridad.............................................................................................................................................. 157
Problemas de conexin de PI Server...................................................................................................... 157
Configurar un ordenador para permitir solicitudes de inicio de sesin explcitas.................................158
Activar un protocolo de autenticacin............................................................................................... 158
Eliminar error de excepcin de tiempo de espera...................................................................................159
Los datos no se actualizan..................................................................................................................... 159
vi
Introduccin
Bienvenido a PI DataLink. En esta seccin se proporciona una descripcin general de PI
DataLink, se describen las caractersticas de esta versin y se explica el procedimiento de
instalacin y configuracin.
En esta seccin
Descripcin general de PI DataLink
Acerca de esta versin
Proceso de configuracin de PI DataLink
Configuracin del complemento para Microsoft Excel
Recomendaciones de seguridad
Acerca de este documento
Introduccin
En esta seccin
Requisitos del sistema
Actualizacin de compatibilidad
Tipos de datos admitidos
Actualizacin de compatibilidad
PI DataLink es compatible con versiones anteriores. Con esta versin de PI DataLink, se pueden
leer libros creados con versiones anteriores sin necesidad de realizar ninguna conversin. Sin
embargo, lo contrario no es necesariamente cierto. Despus de modificar una hoja de clculo
en la versin actual, es posible que no funcione con versiones anteriores de PI DataLink.
Introduccin
PI DataLink 2014 utiliza PI AF SDK. PI DataLink 2010 y versiones anteriores utilizan PI SDK o
PI API. Diferentes comportamientos pueden obligarle a cambiar las hojas de trabajo existentes
creadas con PI DataLink 2010 o versiones anteriores:
Es posible que difieran los mensajes de error devueltos. Puede que necesite cambiar las
hojas de clculo que buscan determinadas cadenas (por ejemplo, en cdigo VBA o macros de
Excel).
PI DataLink no crea conexiones con PI SDK o PI API. Es posible que necesite modificar el
cdigo VBA en los libros que dependen de una conexin a PI SDK o PI API existente para
crear una nueva conexin explcita a PI SDK o PI API.
Algunos formatos de hora, como por ejemplo 10:, ya no son compatibles. Tendr que
cambiar las entradas de tiempo que utilicen formatos no compatibles.
Las conexiones de usuario predeterminadas a PI Server ya no son compatibles. Si se le
solicita, puede introducir un nombre de usuario y una contrasea. Sin embargo, OSIsoft le
recomienda configurar PI mappings para conectarse a PI Server.
La versin de 64 bits de PI DataLink 2014 no permite crear objetos de tendencia ActiveX. La
versin de 64 bits slo mostrar una imagen de la ltima tendencia en una hoja de clculo
existente y no actualizar esas tendencias.
Introduccin
En esta seccin
Instalar PI DataLink
Instalacin silenciosa
Ver PI DataLink en un idioma compatible
Preferencias de conexin a PI Server collectives
Configuracin de PI Server
Instalar PI DataLink
Inicie el programa de configuracin para instalar PI DataLink. En sistemas operativos de 64
bits, el programa de configuracin instala automticamente la versin de 32 bits y de 64 bits de
PI DataLink. Puede modificar el archivo setup.ini si desea instalar una nica versin. Si tiene
instalada una versin anterior de PI DataLink en el ordenador, el programa de configuracin
actualizar automticamente la instalacin y mantendr los ajustes de preferencia de versiones
anteriores.
Procedimiento
1. Localice el kit de configuracin. Puede:
Descargue el kit de la pgina de descargas del Servicio de asistencia tcnica de OSIsoft
(https://techsupport.osisoft.com/Downloads/All-Downloads/).
Insertar el CD de distribucin.
2. Extraiga los archivos en su ordenador.
3. Si desea instalar una nica versin (32 bits o 64 bits), modifique el archivo setup.ini.
4. Ejecute el programa setup.exe. El programa de instalacin instala PI DataLink bajo el
directorio raz de PIPC, normalmente en:
C:\Archivos de programa\PIPC\Excel
El programa instala el archivo de Ayuda en lnea en el directorio de idioma correspondiente
bajo el directorio ../PIPC/Help. Puede descargar la versin PDF y las notas de la versin
de la pgina de descargas del Servicio de asistencia tcnica de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/).
Introduccin
Qu hacer a continuacin
Para cambiar la configuracin predeterminada de PI DataLink, consulte el artculo de la
OSIsoft Knowledge Base How to change the default DataLink Settings for all users during
install or upgrade (https://techsupport.osisoft.com/Troubleshooting/KB/KB00951).
Para ver PI DataLink en un idioma que no sea el ingls, instale el paquete de idiomas MUI de
PI DataLink. Consulte Ver PI DataLink en un idioma compatible.
Para utilizar funciones de tag, funciones de base de datos de mdulo o tendencias, active de
forma manual el complemento PI DataLink (Legacy). Consulte Configuracin del
complemento para Microsoft Excel.
Instalacin silenciosa
Puede instalar este software con la funcin de instalacin silenciosa de Windows. En algunas
ocasiones denominada instalacin desatendida, la instalacin silenciosa no requiere ningn
tipo de comentario durante el proceso de configuracin. Los administradores del sistema con
una aplicacin de distribucin de software automatizada pueden utilizar la instalacin
silenciosa para implementar el software de forma automtica en un gran nmero de equipos
de la empresa.
Para iniciar una instalacin silenciosa, escriba:
Setup.exe f silent.ini
El archivo silent.ini se encuentra incluido en el kit de instalacin. Puede realice en el
archivo las modificaciones especficas del sitio que sean necesarias. Consulte el archivo
silent.ini para obtener ms informacin y descripciones de los argumentos disponibles.
Procedimiento
1. Defina el idioma que desee en Microsoft Excel.
a. Instale el paquete de idiomas de Microsoft Office.
b. Utilice la herramienta de configuracin de idiomas de Microsoft Office para cambiar el
idioma de Microsoft Excel.
2. Descargue el paquete de idioma MUI de PI DataLink en la pgina de descargas del Servicio
de asistencia tcnica de OSIsoft (https://techsupport.osisoft.com/Downloads/AllDownloads/).
3. Instale el paquete de idiomas MUI de PI DataLink.
Introduccin
Las funciones de PI DataLink establecen la preferencia como Cualquiera.
La bsqueda establece la preferencia como Cualquiera.
Gestor de conexiones (al que se accede desde el cuadro de dilogo Configuracin) establece
la preferencia como Cualquiera.
Los objetos heredados de control de tendencia establecen la preferencia como Preferir
primario.
Tag Search (al que se accede desde las funciones de tags heredados) establece la preferencia
como Preferir primario.
PI Connection Manager (al que se accede desde el Tag Search heredado) establece la
preferencia como Preferir primario.
Consulte el manual High Availability Administrator Guide para obtener ms informacin sobre
las conexiones cliente a PI Server.
Configuracin de PI Server
PI DataLink puede obtener datos de Server 3.4.380 y versiones posteriores. No obstante, PI
DataLink debe poder conectarse al PI Server adecuado y los usuarios deben tener un acceso
adecuado a los PI points. Es posible que esto exija realizar algunos cambios de configuracin
en:
Base de datos de firewall
La base de datos de firewall de cada equipo de PI Server debe configurarse para permitir el
acceso desde equipos cliente que ejecutan PI DataLink.
Autenticacin y autorizacin
Es necesario que los usuarios que utilicen PI DataLink puedan autenticar su identidad con
PI Server y tener acceso a PI Server. Asigne a los usuarios un acceso con el mnimo de
privilegios, por ejemplo, otrgueles permisos de solo lectura. Para la autenticacin, OSIsoft
recomienda utilizar PI mappings (disponibles en PI Server versin 3.4.380 y posteriores).
Tambin puede utilizar PI trusts o autenticacin de contraseas de PI. OSIsoft no
recomienda la autenticacin de contraseas de PI, porque es el mtodo menos seguro.
Definiciones de puntos
Deben definirse los puntos para conceder acceso de lectura a los usuarios autorizados y
tambin acceso de escritura, si es necesario.
Para obtener ms informacin, consulte la documentacin relativa a PI Server, incluido el
manual Configuring PI Server Security. Puede descargar la documentacin de la pgina de
descargas del Servicio de asistencia tcnica de OSIsoft (https://techsupport.osisoft.com/
Downloads/All-Downloads/).
Nombre
Ubicacin
Tipo
PI DataLink
..\PIPC\Excel\OSIsoft.PIDataLink.UI.vsto
Complemento
COM
PI DataLink
(Legacy)
..\PIPC\Excel\OSIsoft.PIDataLink.UI(Legacy).vsto
Complemento
COM
Introduccin
Nombre
Ubicacin
Tipo
PI DataLink
Notifications
..\PIPC\Excel
\OSIsoft.PIDataLink.Notifications2007.UI.vsto
Complemento
COM
Para utilizar todas las funciones de PI DataLink, estos complementos de aplicacin deben estar
activos. El programa de configuracin instala todos los complementos y activa el complemento
de PI DataLink. Si PI Notifications estn instalado en el equipo, el programa de configuracin
tambin activa el complemento de PI DataLink Notifications. En caso contrario, deber activar
ese complemento despus de instalar PI Notifications. El programa de configuracin no activa
el complemento de PI DataLink (Legacy). Debe activar el complemento si desea utilizar
funciones de tag, objetos de Module Database o tendencias.
En casos excepcionales, Microsoft Excel podra deshabilitar un complemento. Deber
habilitarlo para poder activarlo.
Nota:
Para activar el complemento de una aplicacin, debe tener privilegios de administrador
en el equipo. Si no es administrador, haga clic con el botn derecho del ratn en
Excel.exe en Windows Explorer y, a continuacin, haga clic en Ejecutar como
administrador para ejecutar Microsoft Excel como administrador.
Consulte tambin
Funciones de tags
Objetos de PI Module Database
Tendencias
Notificaciones
En esta seccin
Ver el estado de los complementos
Activar un complemento desactivado
Activar un complemento desactivado
Procedimiento
1. Haga clic e la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007, haga
clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. Busque en la lista de complementos el estado actual de un complemento. Cada
complemento se incluir en una de las siguientes categoras:
Complementos de aplicaciones activas
Complementos de aplicaciones inactivas
Complementos de aplicaciones deshabilitadas
Introduccin
Procedimiento
1. Haga clic en la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007,
haga clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Elementos deshabilitados y, a continuacin, haga clic en
Ir.
4. Seleccione la casilla de verificacin situada junto al complemento.
5. Haga clic en Habilitar.
Procedimiento
1. Haga clic en la pestaa Archivo y, a continuacin, en Opciones. (En Microsoft Excel 2007,
haga clic en el botn de Microsoft Office y, a continuacin, en Opciones de Excel.)
2. En la ventana Opciones de Excel, haga clic en Complementos.
3. En la lista Administrar, seleccione Complementos COM y, a continuacin, haga clic en Ir.
4. Seleccione la casilla de verificacin situada junto al complemento.
5. Haga clic en Aceptar.
Recomendaciones de seguridad
Su PI System puede almacenar datos confidenciales que desea proteger. OSIsoft designa sus
productos para minimizar el riesgo de accesos no autorizados. Los temas de esta seccin
describen las prcticas recomendadas para maximizar la seguridad de los datos cuando se
trabaja con PI DataLink.
En esta seccin
Seguridad de los archivos Excel
Seguridad del complemento para Excel
Privilegios de las cuentas
Prcticas de seguridad organizativa
Estrategias de registro
Introduccin
Proteger sus archivos de libro de trabajo en Excel mediante contraseas. Las contraseas
permiten que solo los usuarios autorizados puedan ver o modificar los datos del libro de
trabajo. Para obtener ms informacin, consulte el artculo de Microsoft Office Secure a
workbook with a password (http://office.microsoft.com/en-us/excel-help/secure-aworkbook-with-a-password-HP001112410.aspx).
Emplee las prcticas ms seguras para definir contraseas para sus libros de trabajo.
Defina una contrasea para abrir el libro de trabajo y otra para modificarlo.
Utilice una combinacin de maysculas y minsculas, nmeros y smbolos en sus
contraseas.
Seleccione la casilla Cifrar propiedades del documento para evitar que usuarios no
autorizados puedan ver el resumen y las propiedades personalizadas del archivo del
libro de trabajo.
Active Information Rights Management (IRM) en los libros de trabajo Excel. IRM permite a
los usuarios y administradores especificar los permisos de acceso al libro de trabajo y ayuda
a evitar que personas no autorizadas impriman, reenven o copien datos confidenciales de
PI System. Tras restringir los permisos de un archivo mediante IRM, se aplican las
restricciones de acceso y uso independientemente de la ubicacin de la informacin, porque
el permiso de acceso se guarda en el propio archivo. Para obtener ms informacin, consulte
el artculo de Microsoft Office Information Rights Management en Office 2010 (http://
office.microsoft.com/en-us/excel-help/information-rights-management-in-office-2010HA010354260.aspx). Si es necesario, puede establecer una fecha de caducidad para los
datos en el archivo Excel. En el artculo de Microsoft Office, vea el procedimiento Establecer
una fecha de caducidad para un archivo (http://office.microsoft.com/en-us/excel-help/
information-rights-management-in-office-2010-HA010354260.aspx#BMexpire).
Utilice el cifrado IPSec (Internet Protocol Security) en los enlaces entre equipos que alojan
PI DataLink y almacenes de archivos que contienen libros de trabajo Excel si se guardan
libros de trabajo Excel en unidades remotas. Para obtener ms informacin, consulte el
artculo de Microsoft TechNet Step-by-Step Guide to Internet Protocol Security (IPSec)
(http://technet.microsoft.com/en-us/library/bb742429.aspx) (disponible solo en ingls).
Aplique los permisos de proteccin de archivos a sus libros de trabajo Excel para asegurarse
de que los usuarios no autorizados no puedan acceder al contenido de estos archivos. Para
obtener ms informacin, consulte el artculo de Microsoft TechNet File and Folder
Permissions (http://technet.microsoft.com/en-us/library/bb727008.aspx) (disponible solo
en ingls).
Aplique una firma digital al archivo de libro de trabajo Excel. Para obtener ms informacin,
vea el artculo de Microsoft Office Descripcin de las firmas digitales y la firma de cdigo en
los libros de Excel (http://support.microsoft.com/kb/820738).
Introduccin
certificado PI DataLink al almacn de certificados de confianza. Consulte Aadir certificado PI
DataLink a almacn de certificados de confianza.
Para obtener ms informacin, vea el artculo de Microsoft Office Ver, administrar e instalar los
complementos de los programas de Office (http://office.microsoft.com/en-us/excel-help/
view-manage-and-install-add-ins-in-office-programs-HA010354315.aspx).
Procedimiento
1. Abra una ventana de comandos como administrador.
2. En una ventana de smbolo del sistema, desplcese al directorio que contiene el certificado
PI DataLink (pidlcert.cer).
Encontrar el certificado en la subcarpeta Excel de la carpeta de instalacin (definida por
la variable de entorno PIHOME).
3. Introduzca el siguiente comando:
C:\Windows\System32\certutil.exe -addstore TrustedPublisher
pidlcert.cer
10
Introduccin
Auditar toda la actividad administrativa y revisar de forma rutinaria los registros de
auditora. Pida a todos los administradores que efecten comprobaciones de antecedentes
antes de contratar a nuevos empleados y que realicen comprobaciones peridicas como
condicin laboral.
Prevea mltiples capas de seguridad. Confiar nicamente en la seguridad perimetral, como
los cortafuegos, incrementa el riesgo en caso de problemas en el cortafuegos. Puede prever
otra capa de proteccin diseando su red para separar los clientes menos seguros de los
clientes ms seguros. Los cortafuegos personales en equipos cliente agregan una capa
adicional. Mejore an ms la seguridad con software para la deteccin de intrusos y
software para la deteccin de intrusos basados en host que ayudan a filtrar actividades
sospechosas. La ejecucin de software antivirus es esencial. Finalmente, la formacin de los
usuarios en cuestiones de seguridad informtica es una parte crtica de una estrategia de
seguridad de la red.
Cree y mantenga lneas base seguras para todos los sistemas. Especifique todas las lneas
base con una descripcin detallada de cmo configurar y administrar el equipo. La
descripcin debe incluir todos los parmetros de configuracin pertinentes para un equipo
seguro. Para crear una lnea base segura, utilice el sistema operativo ms seguro posible. Es
ms probable que los sistemas operativos ms recientes estn diseados pensando en la
seguridad y que contengan funciones destinadas a mejorar su seguridad. Mantenga el
sistema operativo y las aplicaciones actualizados aplicando las actualizaciones de seguridad
a medida que estn disponibles.
Utilice contraseas o claves seguras. No utilice nunca contraseas en blanco. Para obtener
ms informacin sobre las contraseas, consulte el artculo de Microsoft TechNet Account
Passwords and Policies (http://technet.microsoft.com/en-us/library/cc783860.aspx)
(Contraseas de cuentas y polticas).
Controle el acceso a los archivos Excel de PI DataLink. Implemente procedimientos de
control de acceso para asegurarse de que todos los archivos Excel estn guardados en un
lugar seguro y que ningn intruso pueda modificar el contenido de los archivos o buscar
informacin en ellos.
Estrategias de registro
Las organizaciones deben desarrollar una estrategia de registro adecuada. Puede utilizar
archivos de registro para:
Seguimiento. Puede utilizar archivos de registro para ofrecer datos estadsticos sobre
transacciones.
Verificacin. Puede utilizar archivos de registro para ofrecer un registro completo de
transacciones para recrear las transacciones.
Demostrar la validez de una transaccin.
PI DataLink enva todas las solicitudes de datos a travs de PI AF SDK. Aunque PI DataLink no
mantiene archivos de registro separados, puede utilizar los archivos de registro de PI Server y
PI AF SDK para obtener informacin sobre las transacciones de PI DataLink. Consulte la
documentacin de PI Server y PI AF SDK para obtener ms informacin.
11
Introduccin
Este documento asume que tiene conocimientos sobre conceptos de PI System. Consulte la
documentacin de PI Server y PI AF para obtener ms informacin sobre esos productos.
Conocer PI Server y PI AF le ayudar a comprender los trminos que se utilizan en PI DataLink.
Es posible que los materiales de formacin puedan serle de utilidad. Los materiales incluyen
ejercicios que OSIsoft utiliza en los cursos de formacin de PI DataLink.
Puede descargar los materiales de formacin y la documentacin relativa a otros productos de
OSIsoft en la Pgina de descargas del Servicio de asistencia tcnica de OSIsoft (https://
techsupport.osisoft.com/Downloads/All-Downloads/).
12
Conceptos bsicos
Cuando utiliza PI DataLink, define funciones de PI DataLink que extraen datos de PI System en
matrices de funcin en una hoja de clculo de Excel. Una matriz de funcin es un grupo de
celdas que contiene la salida de una funcin de PI DataLink. Los siguientes apartados presentan
las funciones y conceptos bsicos de PI DataLink. Debera familiarizarse con estos apartados
entes de utilizar PI DataLink para crear hojas de clculo y recuperar datos de PI System.
Estos apartados describen:
Funciones de interfaz de usuario
Las funciones esenciales necesarias para comenzar a trabajar con PI DataLink
Los diferentes enfoques para construir una hoja de clculo con PI DataLink dependiendo de
sus objetivos, necesidades y recursos
En esta seccin
Interfaz de usuario
Descripcin general de las funciones de PI DataLink
Bsquedas
Configuracin de preferencia
Gestionar conexiones con servidores
Interfaz de usuario
PI DataLink aade comandos de men, ventanas y paneles de tareas especficos a Microsoft
Excel.
Los siguientes apartados describen los elementos fundamentales de la interfaz de PI DataLink.
En esta seccin
Pestaa PI DataLink
Paneles de tareas de funciones
Men contextual
Pestaa PI DataLink
PI DataLink inserta la pestaa PI DataLink en la cinta de Microsoft Excel.
13
Conceptos bsicos
Un panel de tareas es un panel de controles que puede mover y acoplar. Puede continuar
trabajando en una hoja de clculo mientras el panel de tareas est abierto.
Para abrir un panel de tareas de funcin:
Haga clic en la celda de salida deseada y, a continuacin, haga clic en un comando de funcin
de la pestaa PI DataLink para aadir una funcin.
Haga clic en una celda de una matriz de funcin existente para mostrar el panel de tareas
correspondiente y editar las entradas de la funcin.
Nota:
Si lo prefiere, puede desactivar la aparicin automtica de paneles de tareas. Consulte
Configuracin de preferencia.
Haga clic con el botn derecho en una celda de matriz de funcin y seleccione el nombre de
la funcin para mostrar manualmente el panel de tareas.
Una vez que est abierto un panel de tareas de funcin:
Introduzca o modifique valores y, a continuacin:
Haga clic en Aceptar para guardar los valores de entrada, escribir la matriz de funcin
resultante y cerrar el panel de tareas.
Haga clic en Aplicar para guardar los valores de entrada y escribir la matriz de funcin
resultante sin cerrar el panel de tareas.
Haga clic en el botn de flecha para seleccionar los comandos Mover, Tamao o Cerrar.
Arrastre la barra de ttulo para desacoplar el panel de tareas.
Haga doble clic en la barra de ttulo para acoplar el panel de tareas.
Coloque el cursor sobre el borde para arrastrar y redimensionar el panel.
14
Conceptos bsicos
Men contextual
PI DataLink aade varios comandos al men contextual estndar de Microsoft Excel. Puede
utilizar estos comandos para gestionar matrices de funcin que ya estn insertadas en una hoja
de clculo.
Para abrir el men contextual con los comandos de PI DataLink, haga clic con el botn derecho
del ratn en cualquier lugar de una matriz de funcin de PI DataLink.
PI DataLink aade los siguientes comandos al men contextual:
Seleccionar funcin DataLink
Selecciona la matriz de funcin completa.
Debe seleccionar una matriz antes de intentar copiarla, cortarla o arrastrarla a una nueva
ubicacin en la hoja de clculo.
Recalcular (Redimensionar) funcin
Vuelve a escribir la matriz de funcin completa: PI DataLink recupera valores nuevos de PI
Server o PI AF y redimensiona automticamente la matriz para que se ajuste a los datos
obtenidos.
Nombre de funcin
Abre el panel de tareas de funcin correspondiente y muestra las entradas de la matriz de
funcin.
Las tendencias ofrecen un men contextual alternativo.
Consulte tambin
Men contextual de tendencias
Paneles de tareas de funciones
Consulte tambin
Paneles de tareas de funciones
Entrada manual de funciones
En esta seccin
Elementos de datos
Campo de entrada
Campos de entrada de tiempo
15
Conceptos bsicos
Datos aadidos
Formatos de presentacin
Elementos de datos
Las funciones de PI DataLink devuelven datos sobre determinados elementos de datos de PI
System, ya sean PI points o atributos de PI AF. Las funciones pueden obtener valores
registrados de una base de datos o valores calculados en funcin de determinados criterios o
una expresin concreta.
Al definir una funcin, especifique las rutas de los elementos de datos con los campos
Elemento de datos, Expresin y Expresin de filtro junto con el campo opcional Ruta raz.
Puede especificar:
Rutas completas en los campos Elemento de datos, Expresin o Expresin de filtro. Una ruta
completa comienza con dos barras diagonales inversas (\\) y evala un PI point o un
atributo de PI AF.
Las rutas parciales en los campos Elemento de datos, Expresin o Expresin de filtro y la
ruta de acceso base en el campo Ruta raz. Los nombres de PI point o los nombres de
atributos de PI AF son ejemplos de rutas parciales. PI DataLink combina la ruta de acceso
base comn con la ruta parcial para establecer la ruta completa que evala un PI point o un
atributo de PI AF.
PI DataLink requiere una ruta completa para localizar el elemento de datos. Para localizar un PI
point, PI DataLink debe conocer el PI Server donde realizar la bsqueda y el nombre del
punto. Para localizar un atributo de PI AF, PI DataLink debe conocer el servidor de PI AF, la
base de datos, el elemento y todos los subelementos y atributos primarios. Utilice una barra
vertical (|) para separar los atributos de los elementos o de los atributos primarios.
Puede dejar el campo Ruta raz en blanco si los campos Elemento de datos, Expresin y
Expresin de filtro contienen una ruta completa o un PI point en el PI Server predeterminado.
Si se especifica, el campo Ruta raz indica la ruta comn de los elementos de datos
especificados.
Tipo de elemento de
datos
PI point
Atributo de PI AF
16
Conceptos bsicos
Consulte tambin
Expresiones
Campo de entrada
Los campos etiquetados como de entrada en los paneles de tareas de funcin aceptan valores
correctos para la funcin. En la mayor parte de los campos de entrada, puede introducir un
valor o una referencia a una celda de hoja de clculo que contenga el valor. Algunos campos de
entrada muestran un valor predeterminado cuando se abre el panel de tareas. Los campos de
entrada que tienen la marca (opcional) son opcionales y no requieren un valor.
En el caso de entradas con campos de edicin
, puede:
, puede:
Introducir una referencia a una celda de hoja de clculo de contenga el nombre del punto:
a. Hacer clic en el campo Elemento(s) de datos.
b. Hacer clic en la celda de la hoja de clculo.
PI DataLink introducir automticamente la referencia de la celda en el campo de
edicin.
17
Conceptos bsicos
para obtener los valores de momento especfico. Siga estas indicaciones para especificar
valores en los campos de entrada de tiempo:
Introduzca un tiempo absoluto, como 10-dic-99 19:12, o una expresin de tiempo de PI
que especifique un tiempo relativo; por ejemplo, -3h. Por ejemplo, puede introducir un
tiempo absoluto para definir un periodo de tiempo en el pasado o puede introducir una
expresin de tiempo relativa para definir un periodo de tiempo que incluya el momento
actual.
Si la hora de inicio es ms reciente que la hora de finalizacin, PI DataLink muestra los
resultados en orden cronolgico inverso.
Coloque comillas simples delante de las expresiones temporales introducidas en las celdas
para indicar que se trata de una cadena (por ejemplo, '10-dic-99 19:12 o '-3h).
Las referencias de celda tambin pueden utilizar el formato absoluto de tiempo de Excel
(como 39299.6146, equivalente a 8/5/2007 2:45:00 PM). Excel almacena las marcas de
tiempo en este formato, que representa el nmero acumulado de das desde 1900. Excel
puede mostrar las mismas marcas de tiempo utilizando cualquier formato de fecha y hora
asignado a la celda.
Algunas entradas de tiempo, como 9:45, pueden representar un tiempo vlido y un rango
vlido de filas de hoja de clculo. En el campo del panel de tareas, coloque al principio de
estas entradas comillas simples, como '9:45, para forzar a PI DataLink a interpretarlas
como una hora.
Algunas funciones de PI DataLink requieren una entrada de Intervalo de tiempo, que se
especifica con un solo valor:
Introduzca un valor y una unidad temporal, como 1d o 30m; nunca incluya una hora de
referencia. Por ejemplo, para especificar un intervalo de 32 minutos, introduzca 32m o haga
referencia a una celda que contenga esa cadena.
Para introducir intervalos en trminos de frecuencia, convierta la frecuencia a los segundos
equivalentes. Por ejemplo, una frecuencia de 25 Hz debe introducirse como un intervalo de
0,04s (=1/25 de segundo).
Nota:
PI DataLink solo admite el sistema predeterminado de fecha de 1900 admitido por Excel.
PI DataLink no admite el sistema de fecha de 1904 de Excel, y devuelve marcas de tiempo
incorrectas si se utiliza dicho sistema.
Consulte tambin
Especificacin de intervalos de tiempo
Especificacin de intervalos de tiempo
Datos aadidos
PI DataLink puede aadir informacin sobre los valores recuperados. Los datos aadidos
pueden proporcionar un contexto a los valores recuperados. Los datos aadidos pueden
incluir:
Marcas de tiempo que muestran cundo se registraron los valores
Marcas de tiempo que indican las horas de inicio y finalizacin de un intervalo
Marcas de tiempo que indican la ocurrencia de los valores mnimo y mximo
El porcentaje de valores correctos durante un intervalo de muestra
Atributos de valor
18
Conceptos bsicos
Anotaciones introducidas manualmente
Nombres de servidores fuente
PI DataLink muestra los datos aadidos especificados en las columnas (o filas) junto a los
valores principales que la funcin devuelve:
Los datos de tiempo se muestran en columnas a la izquierda (o en filas encima) de los
valores principales.
Otros datos relacionados se aaden en columnas a la derecha (o en filas debajo) de los
valores principales.
Formatos de presentacin
Utilice la ventana Configuracin para especificar los formatos de fecha y nmero que PI
DataLink utiliza para dar formato a los datos en las matrices de funcin. Hay dos
configuraciones:
Formato de nmero
El formato para los nmeros en la salida de funcin. El ajuste predeterminado, General, da
formato a los nmeros (y a todos los datos que no son marcas de tiempo) para que
coincidan con el formato de la categora General en la ventana Formato de celdas.
Formato de hora
El formato para las marcas de tiempo en la salida de funcin. El formato de fecha
predeterminado, dd-mmm-yy hh:mm:ss, coincide con el formato de marca de tiempo
estndar de PI. Puede aadir :000 al final de la cadena (dd-mmm-yy hh:mm:ss:000) para
mostrar marcas temporales por debajo de un segundo. Tenga en cuenta que Excel no admite
formatos con precisin de microsegundos.
Puede personalizar las cadenas de formato predeterminadas utilizando cualquier cdigo de
formato de Excel vlido del cuadro de dilogo Formato de celdas en Excel.
Para obtener detalles en la ventana Configuracin, consulte Configuracin de preferencia.
Tambin puede aplicar un formato de fecha y hora individual a cualquier celda de hoja de
clculo, incluidas las que contienen funciones de PI DataLink con el cuadro de dilogo Formato
de celdas. Consulte su documentacin sobre Excel para obtener ms informacin sobre cmo
dar formato a fechas y horas.
Bsquedas
PI DataLink ofrece dos formas de buscar elementos de datos:
La herramienta de bsqueda
La herramienta de bsqueda permite buscar PI points o atributos de PI AF buscando texto
coincidente o explorando un PI Server o una base de datos PI AF. Segn cmo se abra la
herramienta, inserta los puntos o atributos encontrados en hojas de clculo o en paneles de
tareas de funciones.
Funcin de bsqueda de filtro de activo
La funcin Bsqueda de filtro de activo permite buscar elementos PI AF que satisfacen unos
criterios y filtrarlos en funcin de ciertos valores de atributos. La funcin puede devolver
los elementos filtrados o atributos seleccionados de los elementos filtrados. La funcin
puede pegar los activos filtrados en la hoja de clculo como valores o como matriz de
funcin.
19
Conceptos bsicos
En esta seccin
Buscar elementos de datos
Buscar activos mediante filtros
Antes de empezar
Conctese al PI Server o al servidor de PI AF en el que desea realizar la bsqueda. Consulte
Gestionar conexiones con servidores.
Procedimiento
1. Abra la herramienta Bsqueda:
Para insertar uno o varios elementos en una hoja de clculo, seleccione la celda superior
izquierda del intervalo en la hoja de clculo donde desea insertar los elementos de datos
y, a continuacin, en la pestaa PI DataLink, en el grupo Buscar, haga clic en Buscar.
Para insertar uno o varios elementos en un panel de tareas de funcin, haga clic en el
botn
, situado junto al campo Elemento(s) de datos.
2. Defina el mbito de la bsqueda, que se muestra en la ruta en la parte superior.
Tras el primer uso, la herramienta se inicia en el nodo principal, que muestra todos los PI
Servers (indicados por ) y los servidores de PI AF (indicados por ) que aparecen
listados en el Gestor de conexiones. Debe limitar la bsqueda a un solo PI Server o un solo
servidor de PI AF e incluso an ms, a una nica base de datos en un servidor de PI AF y
despus a determinados elementos y atributos primarios.
La siguiente vez que se utiliza, la herramienta inicia la sesin con el mbito de la bsqueda
definido en el ltimo PI Server, servidor de PI AF o base de datos de PI AF utilizados en la
bsqueda.
Puede:
Utilizar el panel del navegador para limitar la bsqueda
Utilizar la ruta del mbito para limitar la bsqueda
Si define el mbito de bsqueda como un elemento o un atributo, en el panel de resultados
se incluirn los atributos secundarios inmediatos de ese elemento o atributo.
3. Segn proceda, busque elementos de datos dentro del mbito para que aparezcan listados
en el panel de resultados.
a. En el campo situado en la parte superior de la herramienta, escriba el texto que identifica
los elementos de datos que desea encontrar en el mbito seleccionado.
La herramienta aade caracteres comodn implcitos detrs del texto que escriba. Por
ejemplo:
20
Conceptos bsicos
Escriba sin para localizar todos los elementos de datos que comiencen por "sin,"
como sinusoid o sinusoidu.
Escriba * para localizar todos los elementos de datos.
b. Si el mbito de bsqueda es un PI Server, configure los campos bajo Filtros para
especificar cualquier criterio adicional que deban cumplir los PI points recuperados.
El panel incluye seis listas que contienen atributos comunes de las clases de puntos
clsicos y bsicos. Seleccione un atributo de punto de una lista y, a continuacin,
introduzca texto en el campo correspondiente para encontrar los puntos PI coincidentes
con su entrada. Puede utilizar caracteres comodn; la bsqueda no aade caracteres
comodn implcitos. Puede filtrar la lista obtenida en funcin del tipo de punto y
seleccionar el tipo de valor almacenado que desea encontrar.
Por ejemplo, seleccione Descriptor y, a continuacin, introduzca *vapor* para obtener
solo los PI points que contienen la palabra vapor en cualquier posicin del atributo de
punto descriptor
Consulte la documentacin de PI Server para obtener ms informacin sobre los
atributos de PI point.
c. Haga clic en Buscar
La herramienta busca dentro del mbito especificado los elementos de datos que
coinciden con el texto que se ha escrito y devuelve los elementos de datos encontrados
en el panel de resultados. La herramienta busca en la totalidad de la jerarqua debajo del
mbito de bsqueda. (En contraposicin, cuando se busca en la jerarqua, el panel de
resultados solo muestra los atributos secundarios inmediatos del mbito de bsqueda.)
La herramienta localiza:
PI points con nombres coincidentes.
Atributos de PI AF con nombres coincidentes.
Atributos de PI AF que tienen elementos principales con nombres, descripciones,
categoras o plantillas coincidentes.
Nota:
Las bsquedas de PI Server devuelven un mximo de 100.000 PI points. Para
asegurarse de ver todos los resultados, limite la bsqueda para que devuelva menos PI
points.
4. Si lo desea, cambie las columnas que se muestran en el panel de resultados:
Haga clic con el botn derecho del ratn en el panel de resultados y, a continuacin, haga
clic en el nombre de una columna para aadirla o eliminarla de las columnas mostradas.
Arrastre los encabezados de columna para cambiar el orden de las columnas mostradas.
5. Si lo desea, mueva el control deslizante Longitud de ruta raz para dividir la ruta de
elemento de datos entre las columnas Ruta raz y Elemento de datos:
Seleccione Mnimo para especificar una ruta completa en la columna Elemento de datos.
Seleccione Mximo para especificar solo el atributo o el nombre de punto en la columna
Elemento de datos, con el resto de la ruta en la columna Ruta raz.
Seleccione posiciones intermedias para otras divisiones de contenido entre las columnas.
El contenido de estas columnas determina el contenido que se aade a los campos del panel
de tareas o las columnas de hoja de clculo.
6. Si va a insertar elementos de datos en una hoja de clculo, especifique cmo se insertar el
contenido de Ruta raz:
21
Conceptos bsicos
Seleccione Columna o fila para insertar el contenido de las columnas Ruta raz y
Elemento de datos en las celdas de hoja de clculo designadas.
Si ambas columnas contienen datos, PI DataLink inserta siempre el contenido de Ruta
raz en la primera columna de la hoja de clculo y el contenido de Elemento de datos en
la segunda. Si nicamente la columna Elemento de datos incluye contenido (es decir, una
ruta completa), PI DataLink solo inserta esa columna en la hoja de clculo:
Seleccione Lista desplegable para insertar una lista desplegable de rutas (procedentes de
la columna Ruta raz) seguida de los elementos de datos (procedentes de la columna
Elemento de datos) en las celdas de hoja de clculo designadas.
Si referencia la lista desplegable y los elementos de datos insertados en una funcin de PI
DataLink, la hoja de clculo actualizar de forma dinmica los valores recuperados
cuando se seleccione una ruta diferente en la lista.
Nota:
PI DataLink inserta la lista de rutas raz en la columna EZ de la hoja de clculo. Si
esa columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.
7. Seleccione los elementos que desee insertar y haga clic en Aceptar.
Consulte tambin
Crear un despliegue relacionado con activos
Procedimiento
En el panel del navegador:
Haga clic en un servidor para limitar la bsqueda a ese servidor.
La herramienta actualiza la ruta del mbito en la parte superior de la venta para listar el
servidor seleccionado y actualiza el panel de navegacin. Si ha hecho clic en un servidor
de AF (indicado por ), el panel del navegador muestra todas las bases de datos de ese
servidor. Si ha hecho clic en un PI Server (indicado por ), el panel del navegador
muestra filtros que puede utilizar para limitar el nmero de PI points recuperados en
funcin de los valores de atributos.
Haga clic en una base de datos (indicado por
datos.
22
Conceptos bsicos
La herramienta actualiza el panel del navegador para mostrar todos los elementos de
primer nivel en la base de datos seleccionada y actualiza la ruta del mbito en la parte
superior de la ventana para listar la base de datos seleccionada.
Haga clic en un elemento (indicado por
La herramienta actualiza el panel del navegador para mostrar todos los elementos y
atributos principales bajo el elemento seleccionado, actualiza la ruta del mbito en la
parte superior de la ventana para listar el elemento de datos seleccionado y lista todos
los atributos bajo el elemento seleccionado en el panel de resultados.
Tenga en cuenta que el panel del navegador solo muestra atributos principales, en tanto
que el panel de resultados muestra atributos principales y no principales bajo el
elemento seleccionado.
Haga clic en un atributo (indicado por
La herramienta actualiza el panel del navegador para mostrar todos los atributos
principales bajo el elemento seleccionado, actualiza la ruta del mbito en la parte
superior de la ventana para listar el atributo seleccionado y lista todos los atributos bajo
el atributo seleccionado en el panel de resultados.
La ruta del mbito muestra la ubicacin en la que la herramienta Bsqueda busca elementos de
datos. Puede utilizar la ruta del mbito para limitar el mbito de una bsqueda. Por ejemplo,
puede limitar una bsqueda a un servidor de PI AF concreto o a una una determinada base de
datos en ese servidor o a un elemento especfico de la base de datos. A medida que navegue por
la jerarqua del servidor de PI AF en la ruta del mbito, el panel de resultados se actualizar
para mostrar los atributos directamente en la ruta de mbito seleccionada en ese momento.
Procedimiento
En la ruta del mbito:
Haga clic en Inicio para navegar al nodo principal. En el nodo principal, el panel del
navegador muestra todos los PI Servers y servidores de PI AF listados en Gestor de
conexiones. No es posible efectuar bsquedas en el nodo principal. El mbito ms amplio
para realizar bsquedas es un solo PI Server o un solo servidor de PI AF.
Haga clic en la flecha situada junto a Inicio y, a continuacin, haga clic en un servidor
concreto para restablecer el mbito a ese servidor.
Haga clic en el servidor para restablecer el mbito a ese servidor completo.
Haga clic en la flecha situada junto a un servidor de PI AF y, a continuacin, haga clic en
una determinada base de datos para restablecer el mbito a esa base de datos.
Haga clic en la base de datos para restablecer el mbito a esa base de datos completa.
Haga clic en la flecha situada junto a la base de datos y, a continuacin, haga clic en un
elemento concreto para restablecer el mbito a ese elemento.
Haga clic en un elemento para restablecer el mbito al elemento completo.
Haga clic en la flecha situada junto a un elemento y, a continuacin, haga clic en un
subelemento o atributo para restablecer el mbito a ese subelemento o atributo.
23
Conceptos bsicos
Haga clic en un atributo principal para restablecer el mbito a todos sus subatributos.
Haga clic en la flecha situada junto a un atributo principal y, a continuacin, haga clic en
un subatributo concreto para restablecer el mbito a ese subatributo.
Procedimiento
1. Seleccione la celda superior izquierda del intervalo de la hoja de clculo donde desea
insertar los activos recuperados.
2. En la pestaa PI DataLink, en el grupo Buscar, haga clic en Filtro de activo para abrir el
panel de tareas Bsqueda de filtro de activo.
3. En el campo Ruta raz introduzca la ruta comn de los elementos que desea buscar.
La ruta comn debe incluir el servidor y la base de datos, y puede contener elementos
principales. Utilice el formato \\NombreServidor\NombreBaseDatos
\NombreElementoPrincipal.
Por ejemplo, para buscar elementos en el nivel raz de la base de datos MyDatabase en el
servidor MyServer, introduzca \\MyServer\MyDatabase; para buscar elementos bajo el
elemento Calderas de la misma base de datos, introduzca \\MyServer\MyDatabase
\Calderas.
4. Especifique los elementos de PI AF que desea recuperar:
a. En la lista Plantilla de elemento, seleccione la plantilla de elementos recuperados.
Debe seleccionar una plantilla para filtrar elementos en funcin de los valores de los
atributos. Tenga en cuenta que si selecciona una plantilla base, la funcin tambin
recuperar elementos de plantillas derivadas.
b. En el campo Nombre de elemento, introduzca el nombre de los elementos que desea
recuperar. Utilice caracteres comodn para especificar parte del nombre.
c. En la lista Categora de elemento, seleccione la categora de elementos que desea
recuperar.
d. En el campo Descripcin de elemento, introduzca el texto que aparece en la descripcin
de todos los elementos que desea recuperar. Utilice caracteres comodn para especificar
parte de la descripcin.
e. Seleccione la casilla Limitar a nivel raz para recuperar nicamente elementos en el nivel
especificado en el campo Ruta raz. Desmarque la casilla para recuperar tambin
elementos secundarios.
f. Opcional: En la tabla Filtros de valor de atributo, especifique las condiciones de los
valores de atributo de los elementos que desea recuperar.
Antes de especificar una condicin de valor de atributo, debe seleccionar una plantilla de
elemento. Tambin puede filtrar con valores de atributos definidos en esa plantilla de
elementos.
Puede especificar hasta cinco condiciones. Para cada condicin, defina tres campos:
24
Conceptos bsicos
En la lista Atributo, seleccione un atributo de los elementos basados en la plantilla de
elementos seleccionada.
En la lista Operador, seleccione el operador relacional, como =, < o >. Para los atributos
que contienen valores de cadena, booleanos o enumerados, los nicos operadores
vlidos son = y <>.
En el campo Valor, escriba el valor del filtro. Puede utilizar caracteres comodn para
los atributos de cadena.
Por ejemplo, para recuperar elementos cuyo atributo Fabricante empiece por ABC y
que tengan un atributo de CdigoPostal entre 94102 y 94188 (ambos inclusive),
introduzca tres condiciones:
Fabricante =ABC*
CdigoPostal >=94102
CdigoPostal <=94188
Para obtener mejores resultados, limite los atributos a aquellos que tengan valores
almacenados en la base de datos de PI AF (es decir, omita los atributos con referencias de
datos). Si especifica un atributo con una referencia de datos, la funcin utiliza la
configuracin de las preferencias de mximo de filtros de bsqueda para limitar el
nmero de elementos en los que se buscan valores de atributo coincidentes. Consulte
Configuracin de preferencia.
5. Especifique la salida de la hoja de clculo:
a. En la lista Atributos para mostrar, seleccione los atributos que desea incluir y defina el
orden de los atributos.
Si no selecciona ningn atributo, la funcin Bsqueda de filtro de activo solo devuelve los
elementos coincidentes. Si selecciona como mnimo un atributo, la funcin devuelve los
atributos seleccionados para cada elemento.
De forma predeterminada, la lista incluye los atributos en la plantilla de elementos
seleccionada. Puede:
Marcar la casilla Seleccionar todo para incluir todos los atributos listados.
Seleccionar una casilla para incluir un atributo o deseleccionarla para excluirlo.
Escribir el nombre de un atributo junto a la casilla en blanco del final de la lista.
Seleccionar un atributo y hacer clic en
atributos visualizados.
b. Indique cmo pegar los elementos o atributos coincidentes en la hoja de clculo:
Haga clic en Columna para insertar la ruta completa de los elementos o atributos en
las celdas designadas de la hoja de clculo.
Haga clic en Lista desplegable para insertar una lista desplegable que incluya las rutas
de los atributos (es decir, el servidor nico, la base de datos y los elementos
principales) seguida de los atributos seleccionados en las celdas designadas de la hoja
de clculo.
Seleccione solo Lista desplegable si ha seleccionado como mnimo un atributo.
Manual del usuario de PI DataLink 2014
25
Conceptos bsicos
En otra funcin de PI DataLink, puede incluir una referencia a la lista desplegable
insertada desde un campo Ruta raz y a los atributos desde un campo Elemento de
datos para crear visualizaciones relacionadas con activos: la hoja de clculo
actualizar dinmicamente los valores recuperados cuando seleccione una ruta
distinta en la lista. Consulte Despliegues relacionados con activos.
c. Indique el formato de salida:
Haga clic en Matriz de funcin para pegar una matriz de funcin. Este es el formato de
salida de otras funciones de PI DataLink. Con una matriz de funcin, puede actualizar
fcilmente las entradas del panel de tareas y recalcular los resultados.
Haga clic en Valores para pegar la salida como valores. Puede copiar fcilmente
valores para utilizarlos en otro lugar.
Consejo:
Las matrices de funcin son especialmente tiles cuando los resultados de la
funcin cambian con frecuencia. Sin embargo, el reclculo de la matriz de funcin
que se produce cada vez que se abre una hoja de clculo puede ser lento. Por otra
parte, los valores son tiles cuando no se espera que cambien los resultados y no se
quiere esperar a que vuelva a calcularse la matriz de la funcin.
d. Compruebe que el campo Celda de salida contiene la celda superior izquierda del
intervalo de la hoja de clculo donde desea insertar los activos devueltos.
6. Haga clic en Aceptar para insertar los elementos o atributos en la hoja de clculo y cerrar el
panel de tareas.
Configuracin de preferencia
Utilice el cuadro de dilogo Configuracin para especificar preferencias globales y formatos
predeterminados para la salida de las funciones de PI DataLink. Estas configuraciones se
aplican a un determinado usuario o equipo.
Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin.
2. Defina el ajuste que desee y haga clic en Aceptar.
Ajuste
Descripcin
Independiente regional
26
Conceptos bsicos
Ajuste
Descripcin
Desactivar la visualizacin
automtica del panel de tareas
al hacer clic
Desactivar el mensaje
"Redimensionar para mostrar
todos los valores"
En una fila
En una columna
Formato de nmero
27
Conceptos bsicos
Ajuste
Descripcin
Formato de hora
Mximo de eventos
Calcular (F9)
Intervalo (segundos)
28
Conceptos bsicos
Las tendencias creadas con el complemento PI DataLink (Legacy) siempre muestran los
datos en la zona horaria del PI Server.
Las funciones de base de datos del mdulo de PI DataLink (funcin Alias a Tag y funcin
Propiedad para valor) no son compatibles con la configuracin de zona horaria UTC. Cuando
se selecciona la zona horaria UTC, estas funciones utilizan la zona horaria del cliente.
Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin para abrir el
cuadro de dilogo Configuracin.
2. Haga clic en Gestor de conexiones para abrir el cuadro de dilogo Servidores, que muestra
las conexiones de servidor definidas y el estado actual de esas conexiones, incluidos los
servidores predeterminados.
3. Modifique las conexiones, segn desee:
Haga clic en Aadir servidor AF para abrir el cuadro de dilogo Propiedades de servidor
AF, donde podr definir una conexin con un servidor de PI AF.
Haga clic en Aadir PI Server para abrir el cuadro de dilogo Propiedades de PI Server,
donde podr definir una conexin con un PI Server.
Seleccione un servidor que no est conectado actualmente y haga clic en Conectar para
conectarse a ese servidor.
Para conectarse a servidores de PI AF, PI DataLink utiliza las credenciales de Windows
del usuario que ha iniciado sesin. Para conectarse con PI Servers, PI DataLink puede
utilizar un PI trust o un usuario predeterminados, adems de las credenciales de
Windows del usuario que ha iniciado sesin.
Seleccione un servidor que no sea actualmente la conexin predeterminada y haga clic en
Establecer como predeterminado para que ese servidor sea la conexin predeterminada
(un PI Server o un servidor de PI AF).
Seleccione un servidor y haga clic en Propiedades para ver las propiedades de conexin
de ese servidor.
Haga clic con el botn derecho del ratn en un servidor y seleccione Eliminar para
suprimir la definicin de conexin con ese servidor.
29
Conceptos bsicos
30
En esta seccin
Proceso de creacin de hojas de clculo
Despliegues relacionados con activos
Eventos en hojas de clculo
Seleccione un enfoque
Entre las tcnicas que puede utilizar para construir una hoja de clculo estn:
Basada en funciones
Aada la funcin de PI DataLink a la hoja de clculo y cree la presentacin alrededor de
estas funciones segn sea necesario. Por ejemplo, es posible que desee aadir informacin
de punto para que le ayude a aclarar lo que representan los datos. Este puede ser el mejor
enfoque si todava est averiguando cules son sus requisitos o aprendiendo cmo funciona
PI DataLink.
Basado en estructuras
Aada una estructura cuando construya una hoja de clculo. Utilice la herramienta
Bsqueda para insertar elementos de datos que enmarquen el asunto de su hoja de clculo
y, a continuacin, aada funciones para recuperar los datos correspondientes. Este enfoque
requiere algo ms de planificacin y familiaridad con PI DataLink, pero despus de aadir
los elementos de datos a la hoja de clculo, podr utilizarlos para crear funciones ms
fcilmente mediante referencias de celda. De esta forma, podr reutilizar ms fcilmente las
hojas de clculo.
Basado en informes
Coloque las funciones de PI DataLink en la segunda hoja de clculo de un libro y referencie
los resultados de esas funciones en la primera hoja de clculo. Utilice las funciones de
31
Consulte tambin
Funciones de PI DataLink
Buscar elementos de datos
PI DataLink Server (DLS)
Procedimiento
1. Insertar un conjunto de elementos de datos con una estructura comn en la hoja de clculo.
2. Configurar una funcin de PI DataLink que haga referencia a los elementos de datos
insertados.
32
Consulte tambin
Buscar elementos de datos
Procedimiento
1. Seleccione una celda en la hoja de clculo donde va a insertar los elementos de datos.
2. En la pestaa PI DataLink, haga clic en Buscar para abrir la herramienta Bsqueda.
3. Defina el mbito de la bsqueda, especifique los elementos de datos que desea encontrar y
haga clic en Buscar
.
En el caso de los despliegues relativos a activos, es posible que desee localizar atributos de
PI AF que tengan un elemento principal comn y la misma estructura de atributos. Estos
atributos podran tener la misma plantilla de atributos. Por ejemplo, es posible que desee
localizar todos los reactores de sus instalaciones.
4. Divida la ruta de elementos de datos para que los activos del despliegue aparezcan en la
columna Ruta raz.
Desplace el control deslizante Longitud de ruta raz hasta que la columna Ruta raz muestre
los elementos exclusivos de los atributos listados. Por lo general, coincidir exactamente
con el valor Mximo o estar muy prximo a l.
33
Nota:
PI DataLink inserta la lista de rutas raz en la columna EZ de la hoja de clculo. Si esa
columna contiene datos, PI DataLink inserta las rutas en la siguiente columna
disponible a la derecha.
Procedimiento
1. Haga clic en la celda de la hoja de clculo situada junto al primer elemento de datos del
intervalo que ha insertado.
2. En la pestaa PI DataLink, haga clic en la funcin que desee utilizar para obtener valores.
El panel de tareas de funcin se abre en la celda pulsada especificada en Celda de salida.
3. En el panel de tareas de funcin, haga clic en el campo Elemento(s) de datos y, a
continuacin, seleccione el intervalo de hojas de clculo que contenga los elementos de
datos que ha insertado.
PI DataLink inserta el intervalo de celdas en el campo.
4. En el panel de tareas de funcin, haga clic en el campo Ruta raz y, a continuacin, seleccione
la celda de hoja de clculo que contenga la lista desplegable de rutas raz.
PI DataLink inserta una referencia de celda en el campo.
5. Especifique otras entradas de funcin, segn desee.
6. Haga clic en Aceptar para insertar la matriz de funcin en la hoja de clculo.
Puede seleccionar un activo diferente en la lista para ver los valores de atributo de ese
activo.
34
35
En esta seccin
Explorar los eventos relacionados con un elemento
Explorar eventos con eventos secundarios
Comparacin de eventos mediante la inclusin de eventos secundarios
Comparacin de eventos mediante la inclusin de eventos principales
Nombres de atributo reservados
36
Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Eventos, haga clic en Explorar para abrir el panel de
tareas Explorar eventos.
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizar para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Inicio de bsqueda y Fin de bsqueda especifican el perodo de tiempo en el
que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Inicio de bsqueda y * en el campo
Fin de bsqueda.
Consejo:
Para localizar eventos que tengan una relacin ms especfica con este perodo de
tiempo, como eventos iniciados o finalizados durante este perodo de tiempo,
expanda Ms opciones de bsqueda y seleccione un mtodo alternativo de la lista
Modo de bsqueda.
c. Si es necesario, especifique otros criterios para delimitar los eventos que devuelve la
funcin (que se muestran en la lista Vista previa).
Consulte Referencia del panel de tareas Explorar eventos para acceder a una lista
completa de campos disponibles.
Por ejemplo, utilice la lista Nombre de evento para limitar los eventos devueltos a
aquellos con un nombre determinado. Podra introducir *shut* para encontrar todos
los eventos que contienen shut en el nombre, como shutdown y BoilerShutdown. Si
acepta la entrada predeterminada, *, la funcin encontrar eventos con distintos
nombres.
Por ejemplo, utilice el campo Nombre de elemento para limitar los eventos devueltos a
aquellos asociados con elementos determinados. Puede introducir Boiler5 para
analizar los eventos asociados con esa caldera.
4. Especifique la salida de la hoja de clculo:
a. En la lista Columnas para mostrar, seleccione las columnas que desee incluir en la matriz
de funcin y defina el orden de las columnas.
37
lista.
Seleccione un atributo y haga clic en
Qu hacer a continuacin
Utilice las funciones de Excel para analizar los datos. Puede crear un grfico, por ejemplo.
Antes de empezar
Abra el panel de tareas Explorar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.
38
Procedimiento
1. Haga clic en
Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Eventos, haga clic en Explorar para abrir el panel de
tareas Explorar eventos.
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizar para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Inicio de bsqueda y Fin de bsqueda especifican el perodo de tiempo en el
que buscar eventos activos.
39
lista.
Seleccione un atributo y haga clic en
40
Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Eventos, haga clic en Comparar para abrir el panel de
tareas Comparar eventos.
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizar para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Inicio de bsqueda y Fin de bsqueda especifican el perodo de tiempo en el
que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Inicio de bsqueda y * en el campo
Fin de bsqueda.
41
lista.
Seleccione un atributo y haga clic en
42
Antes de empezar
Abra el panel de tareas Comparar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.
Procedimiento
1. Haga clic en
43
44
Seleccin del atributo de hora de inicio de evento secundario duplicado y evento secundario no
duplicado
Se aaden dos columnas que ofrecen resultados diferentes:
.\Phase1[1]|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del primer evento
secundario Phase1 del evento coincidente que aparece en cada fila. Si el evento
coincidente solo tiene un evento secundario con este nombre, la columna muestra la hora
de inicio de dicho evento en esta columna.
.\Phase1|Start time
En la hoja de clculo, esta columna contiene la hora de inicio del nico evento secundario
Phase1 del evento coincidente que aparece en cada fila. Si el evento coincidente tiene
ms de un evento secundario con este nombre, la columna indica Duplicate event
exists: specify index for Phase1.
45
Antes de empezar
Abra el panel de tareas Comparar eventos y especifique los eventos que desea recuperar en la
hoja de clculo.
Procedimiento
1. En la lista Columnas para mostrar del panel de tareas Comparar eventos, aada atributos de
evento principal utilizando el mtodo apropiado para el atributo:
Para insertar:
Proceda as:
El mismo nombre de
atributo en el nivel
principal
46
Proceda as:
a. Haga clic con el botn derecho del ratn en el atributo sobre el que
desea insertar el atributo de evento principal y, a continuacin, haga
clic en Insertar atributo.
PI DataLink inserta un atributo en blanco en el nivel de evento
primario (.|).
b. Introduzca la ruta y el nombre correctos del atributo de evento
principal.
Por ejemplo, para incluir el atributo Tipo del evento principal,
introduzca ..|Tipo.
Para obtener informacin sobre la sintaxis de la ruta, consulte Notacin de ruta para la
funcin Comparar eventos.
Procedimiento
1. Seleccione la celda de la hoja de clculo en la que desea que PI DataLink empiece a
introducir la matriz de funcin que contiene los eventos.
2. En la pestaa PI DataLink, en el grupo Eventos, haga clic en Comparar para abrir el panel de
tareas Comparar eventos.
3. Especifique los criterios para localizar los eventos en los que est interesado. A medida que
introduzca los criterios, la lista Vista previa se actualizar para mostrar los eventos que
coincidan con los criterios introducidos.
a. En el campo Base de datos, introduzca la base de datos de PI AF que almacena los
eventos.
Utilice el formato \\NombreServidor\NombreBaseDatos. Haga clic en el campo para
abrir una lista de bases de datos que contienen plantillas de eventos en servidores de PI
AF conectados.
b. Los campos Inicio de bsqueda y Fin de bsqueda especifican el perodo de tiempo en el
que buscar eventos activos.
Introduzca una expresin de tiempo de PI. Por ejemplo, para recuperar eventos activos
durante el ltimo mes, introduzca *-1mo en el campo Inicio de bsqueda y * en el campo
Fin de bsqueda.
47
lista.
Seleccione un atributo y haga clic en
49
50
Funciones de PI DataLink
Las funciones de PI DataLink permiten consultar cualquier PI Server o servidor de PI AF,
aplicar clculos a los resultados obtenidos y devolver valores en las celdas de la hoja de clculo.
Al igual que otras funciones de Excel, los resultados de las funciones de PI DataLink se
muestran en matrices,que pueden ser recalculadas para mostrar valores actualizados segn se
necesite Utilice los paneles de tareas de funcin para definir entradas de funciones de PI
DataLink y pegarlas en una hoja de clculo.
Las descripciones de funciones de este apartado describen entradas especficas de cada
funcin.
Consulte tambin
Paneles de tareas de funciones
Matrices de funcin
Referencia de funcin
En esta seccin
Funcin Valor actual
Funcin Valor de archivo histrico
Funcin Datos comprimidos
Funcin Datos de muestra
Funcin Datos temporizados
Funcin Datos calculados
Funcin Filtrado de tiempo
Funcin Explorar eventos
Funcin Comparar eventos
Funcin de bsqueda de filtro de activo
Funcin Propiedades
51
Funciones de PI DataLink
Entrada
Descripcin
Ruta raz
Elemento(s) de datos
Celda de salida
Haga clic en esta opcin para obtener slo valores.La funcin devuelve
valores en una columna para una columna de elementos de datos
referenciados o devuelve valores en una fila para una fila de elementos de
datos referenciados.
Tiempo a la izquierda
Haga clic en esta opcin para obtener dos columnas: la marca de tiempo en la
columna izquierda y el valor en la columna derecha.
Tiempo en la parte
superior
Haga clic en esta opcin para obtener dos filas: la marca de tiempo en la fila
de arriba y el valor en la fila de abajo.
Consulte tambin
PICurrVal()
Valor
Elemento(s) de datos
sinusoid
Tiempo a la izquierda
Seleccionado
52
Funciones de PI DataLink
Descripcin
Ruta raz
Elemento(s) de datos
Expresin(es)
Marca de tiempo
53
Funciones de PI DataLink
Entrada
Descripcin
Modo de recuperacin
Mtodo que la funcin utiliza para determinar los valores que se devolvern:
Las opciones son:
anterior
Recupera el valor que coincide exactamente o es anterior a la marca de
tiempo especificada.
solo anterior
Recupera el valor anterior a la marca de tiempo especificada.
interpolado
Recupera el valor interpolado en el tiempo especificado.
auto
Recupera el valor interpolado en el tiempo especificado o sigue el mtodo
anterior. (Utiliza el mtodo anterior para elementos de datos con
atributos de paso.)
siguiente
Recupera el valor que coincide exactamente o que sigue a la marca de
tiempo especificada.
siguiente nicamente
Recupera el valor que sigue a la marca de tiempo especificada.
tiempo exacto
Recupera nicamente un valor que coincide exactamente con la marca de
tiempo o devuelve No events found si no existe ningn valor con esa
marca de tiempo.
Disponible si selecciona la opcin Elemento de datos.
Celda de salida
Haga clic en esta opcin para obtener slo valores.La funcin devuelve
valores en una columna para una columna de elementos de datos o
expresiones referenciados o devuelve valores en una fila para una fila de
elementos de datos o expresiones referenciados.
Tiempo a la izquierda
Haga clic en esta opcin para obtener dos columnas: la marca de tiempo en la
columna izquierda y el valor en la columna derecha.
Tiempo en la parte
superior
Haga clic en esta opcin para obtener dos filas: la marca de tiempo en la fila
de arriba y el valor en la fila de abajo.
Consulte tambin
PIArcVal()
Especificar elementos de datos.
PIExpVal()
54
Funciones de PI DataLink
Especificar una expresin.
Valor
Elemento(s) de datos
sinusoid
Marca de tiempo
30-Sep-07 15:13
Modo de recuperacin
anterior
Tiempo a la izquierda
Seleccionado
Descripcin
Ruta raz
55
Funciones de PI DataLink
Entrada
Descripcin
Elemento(s) de datos
Hora de inicio
Hora de finalizacin
Nmero de valores
Atrs en el tiempo
Expresin de filtro
Tipo de lmite
Celda de salida
56
Funciones de PI DataLink
Entrada
Descripcin
Ocultar recuento
Mostrar marcas de
tiempo
Seleccione esta casilla para mostrar los bits de estado ampliados asociados
con los valores devueltos. Los bits de estado pueden ser:
A
Anotados. Indica que el valor incluye un comentario.
S
Sustituido. Indica que el valor ha cambiado y ya no presenta el valor
originariamente registrado.
Q
Cuestionable. Indica que existen razones para dudar de la precisin del
valor.
PI DataLink muestra los atributos de valor en una columna a la derecha de los
valores.
Mostrar anotaciones
Seleccione esta casilla para mostrar las anotaciones asociadas con los valores
devueltos. Las anotaciones contienen notas o comentarios que describen un
valor de datos. PI DataLink muestra las anotaciones en una columna a la
derecha de los valores.
Columna
Fila
Consulte tambin
PICompDat()
Especifique un intervalo de tiempo sin una expresin de filtro.
PICompFilDat()
Especifique un intervalo de tiempo con una expresin de filtro.
PINCompDat()
Especifique un nmero de valores sin una expresin de filtro.
PINCompFilDat()
Especifique un nmero de valores con una expresin de filtro.
57
Funciones de PI DataLink
Entrada
Valor
Nmero de valores
Seleccionado
Elemento(s) de datos
sinusoid
Hora de inicio
Nmero de valores
10
Atrs en el tiempo
Seleccionado
Tipo de lmite
interior
Seleccionado
Columna
Seleccionado
Tenga en cuenta que podra seleccionar la opcin Intervalo de tiempo y especificar la Hora de
inicio y la Hora de finalizacin adecuadas para obtener los mismos valores.
Descripcin
Ruta raz
58
Funciones de PI DataLink
Entrada
Descripcin
Elemento(s) de datos
Expresin(es)
Hora de inicio
Hora de finalizacin
Intervalo de tiempo
Expresin de filtro
Celda de salida
Mostrar marcas de
tiempo
Columna
59
Funciones de PI DataLink
Entrada
Descripcin
Fila
Consulte tambin
PISampDat()
Especifique un elemento de datos con una expresin de filtro.
PISampFilDat()
Especifique un elemento de datos sin una expresin de filtro.
PIExpDat()
Especificar una expresin.
Valor
Elemento(s) de datos
sinusoid
Hora de inicio
-1d
Hora de finalizacin
Intervalo de tiempo
3h
Seleccionado
Columna
Seleccionado
60
Funciones de PI DataLink
Descripcin
Ruta raz
Elemento(s) de datos
Expresin(es)
Marca(s) de tiempo
Las marcas de tiempo para las que devuelve valores la funcin. Introduzca
una marca de tiempo o una referencia a una o varias celdas de hoja de clculo
que contengan valores de marca de tiempo.
Necesario.
Modo de recuperacin
61
Funciones de PI DataLink
Entrada
Descripcin
Celda de salida
Consulte tambin
PITimeDat()
Especificar un elemento de datos.
PITimeExpDat()
Especificar una expresin.
Valor
Elemento(s) de datos
sinusoidu
Marcas de tiempo
Modo de recuperacin
interpolado
62
Funciones de PI DataLink
Descripcin
Ruta raz
Elemento(s) de datos
Expresin(es)
Hora de inicio
Hora de finalizacin
Intervalo de tiempo
Expresin de filtro
63
Funciones de PI DataLink
Entrada
Descripcin
Factor de conversin
Modo de clculo
Bases de clculo
El mtodo de clculo:
ponderado a tiempo
Predeterminado. La funcin pondera cada valor registrado segn el
intervalo de tiempo durante el que se aplica el valor. Para todos los modos
de clculo excepto la media, la funcin interpola los valores en los lmites
de los intervalos.
ponderado a eventos
La funcin sospesa del mismo modo cada valor registrado. Seleccione esta
opcin para los valores en lotes. Este mtodo requiere como mnimo un
valor registrado en un periodo de tiempo (dos eventos registrados para
los clculos de desviacin estndar).
64
Funciones de PI DataLink
Entrada
Descripcin
Muestreo de expresin
Mtodo que la funcin utiliza para determinar cundo evaluar una expresin:
comprimido
La funcin evala la expresin durante el periodo de tiempo en las marcas
de tiempo donde los PI points o los atributos de PI AF de la expresin han
almacenado valores.
interpolado
La funcin evala la expresin en intervalos de muestra espaciados
regularmente determinados por la Frecuencia de muestreo de expresin.
Disponible si selecciona Expresin o si especifica una Expresin de filtro.
Frecuencia de muestreo
de expresin
Porcentaje correcto
mnimo
Celda de salida
Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor devuelto. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores devueltos o en una fila
encima de ellos. Solo estar disponible si especifica Intervalo de tiempo.
Mostrar hora de
finalizacin
65
Funciones de PI DataLink
Entrada
Descripcin
Mostrar porcentaje
correcto
Columna
Fila
Consulte tambin
PIAdvCalcVal()
Especifique un elemento de datos para obtener un solo valor
PIAdvCalcFilVal()
Especifique un elemento de datos y una expresin de filtro para obtener un solo valor
PIAdvCalcExpVal()
Especifique una expresin para obtener un solo valor
PIAdvCalcExpFilVal()
Especifique una expresin y una expresin de filtro para obtener un solo valor
PIAdvCalcDat()
Especifique un elemento de datos y un intervalo de tiempo para obtener varios valores
PIAdvCalcFilDat()
Especifique un elemento de datos, un intervalo de tiempo y una expresin de filtro para
obtener varios valores
PIAdvCalcExpDat()
Especifique una expresin y un intervalo de tiempo para obtener varios valores
PIAdvCalcExpFilDat()
Especifique una expresin, un intervalo de tiempo y una expresin de filtro para obtener
varios valores
66
Funciones de PI DataLink
Valor
Elemento(s) de datos
sinusoid
Hora de inicio
Hora de finalizacin
Intervalo de tiempo
1h
Modo de clculo
intervalo
Bases de clculo
ponderado a tiempo
seleccionada
seleccionada
Columna
seleccionada
En este ejemplo, la funcin calcula el rango de cada intervalo de una hora. Puede especificar
cualquier clculo disponible a lo largo de cualquier intervalo.
67
Funciones de PI DataLink
Entrada
Descripcin
Ruta raz
Expresin(es)
Hora de inicio
Hora de finalizacin
Intervalo de tiempo
Unidades de tiempo
Celda de salida
68
Seleccione esta casilla para mostrar la hora de inicio del intervalo de tiempo
que se utiliza para calcular el valor devuelto. PI DataLink muestra la hora de
inicio en una columna a la izquierda de los valores devueltos o en una fila
encima de ellos. Solo estar disponible si especifica Intervalo de tiempo.
Mostrar hora de
finalizacin
Funciones de PI DataLink
Entrada
Descripcin
Mostrar porcentaje
correcto
Columna
Fila
Consulte tambin
PITimeFilterVal()
Devolver un nico valor.
PITimeFilter()
Especificar un intervalo de tiempo y obtener varios valores.
Valor
Expresin
'sinusoid' > 75
Hora de inicio
-7d
Hora de finalizacin
Unidades de tiempo
Seleccionado
Columna
Seleccionado
69
Funciones de PI DataLink
En este ejemplo, la funcin calcula que el valor de sinusoid ha estado por encima de 75
durante 7,85 horas a lo largo de los 7 das anteriores y que el 100% de los valores fueron
correctos durante ese periodo.
70
Funciones de PI DataLink
Entrada
Descripcin
Base de datos
Inicio de la bsqueda
Final de la bsqueda
Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raz
de la base de datos. Si desmarca esta casilla, la funcin busca eventos
coincidentes en cualquier nivel de la jerarqua.
Nombre de evento
Plantilla de eventos
Nombre de elemento
Plantilla de elemento
Categora de evento
Duracin mnima
Duracin mxima
71
Funciones de PI DataLink
Entrada
Descripcin
Modo de bsqueda
Criterio de ordenacin
72
Funciones de PI DataLink
Entrada
Descripcin
Filtros de valor de
atributo
Hasta cinco condiciones de atributo que la funcin utiliza para filtrar eventos
coincidentes.
Nota:
Antes de especificar un filtro de valor de atributo, debe especificar una
plantilla de evento.
Para cada filtro, especifique:
Atributo
Un atributo de evento para el que la funcin filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.
Operador
El operador relacional que la funcin aplica al valor de atributo
especificado. Los operadores disponibles dependen del tipo de datos del
atributo.
Valor
El valor que la funcin utiliza para buscar atributos coincidentes. Por
ejemplo, si define el valor = para el campo Operador, la funcin limita los
eventos a aquellos en los que el atributo especificado equivale a este
valor.
arriba en la lista.
Seleccione un atributo y haga clic en
abajo en la lista.
Seleccione un atributo y haga clic en
lista.
Seleccione un atributo y haga clic en Eliminar atributo para eliminar el
atributo de la lista.
73
Funciones de PI DataLink
Entrada
Descripcin
Nmero de niveles de
eventos secundarios
Celda de salida
Consulte tambin
Eventos en hojas de clculo
Aadir columnas de atributos al panel de tareas Explorar eventos
Configuracin de preferencia
Valor
Base de datos
\\AFSRV1\Produccin
Inicio de la bsqueda
*-1mo
Final de la bsqueda
Plantilla de eventos
PowerPlantDownTime
74
Funciones de PI DataLink
Utilice los campos en la parte superior del panel de tareas Comparar eventos para especificar
qu eventos de PI AF desea recuperar. A medida que especifique los criterios de bsqueda de
eventos, el panel de tareas de lista de Vista previa mostrar los eventos coincidentes. Modifique
los criterios para ajustar los eventos coincidentes antes de insertar la matriz de funcin en la
hoja de clculo. Utilice los campos de la parte inferior del panel de tareas para especificar las
columnas que desea incluir y la posicin de la matriz de funcin insertada.
Para obtener ms informacin, consulte los temas siguientes:
Eventos en hojas de clculo
PI DataLink puede mostrar datos de los eventos de PI AF con la funcin Explorar eventos o
la funcin Comparar eventos.
Comparacin de eventos mediante la inclusin de eventos secundarios
Siga este procedimiento para utilizar la funcin Comparar eventos para comparar eventos
que tienen eventos secundarios con los mismos nombres.
Comparacin de eventos mediante la inclusin de eventos principales
Siga este procedimiento para utilizar la funcin Comparar eventos para comparar eventos
de jerarquas coincidentes cuando existen eventos secundarios con nombres diferentes.
Referencia del panel de tareas Comparar eventos
Los campos del panel de tareas permiten especificar los eventos que se desea recuperar y
las columnas y los datos que se devolvern en la hoja de clculo.
Notacin de ruta para la funcin Comparar eventos
Utilice la notacin de ruta especfica en los nombres de atributos para designar la ubicacin
en la jerarqua de eventos.
Nombres de atributo reservados
Para evitar conflictos con atributos generados automticamente, no defina eventos que
utilicen nombres de atributos reservados.
Ejemplo de comparacin de eventos
Defina las entradas de la funcin Comparar eventos para comparar eventos de alerta de
temperatura.
Configuracin de preferencia
Utilice la ventana Ajustes para definir el nmero mximo de eventos que devuelve la
funcin.
Descripcin
Base de datos
75
Funciones de PI DataLink
Entrada
Descripcin
Inicio de la bsqueda
Final de la bsqueda
Seleccione esta casilla para buscar eventos coincidentes solo en el nivel raz
de la base de datos. Si desmarca esta casilla, la funcin busca eventos
coincidentes en cualquier nivel de la jerarqua.
Nombre de evento
Plantilla de eventos
Nombre de elemento
Plantilla de elemento
76
Categora de evento
Duracin mnima
Duracin mxima
Funciones de PI DataLink
Entrada
Descripcin
Modo de bsqueda
Criterio de ordenacin
El mtodo que utiliza la funcin para clasificar los eventos que se devolvern:
nombre ascendente
Permite ordenar los eventos por nombre de evento, de la A a la Z.
nombre descendente
Permite ordenar los eventos por nombre de evento, de la Z a la A.
hora de inicio ascendente
Permite ordenar los eventos por hora de inicio, del ms temprano al ms
tardo.
hora de inicio descendente
Permite ordenar los eventos por hora de inicio, del ms tardo al ms
temprano.
hora de finalizacin ascendente
Permite ordenar los eventos por hora de finalizacin, del ms temprano al
ms tardo.
hora de finalizacin descendente
Permite ordenar los eventos por hora de finalizacin, del ms tardo al
ms temprano.
77
Funciones de PI DataLink
Entrada
Descripcin
Filtros de valor de
atributo
Hasta cinco condiciones de atributo que la funcin utiliza para filtrar eventos
coincidentes.
Nota:
Antes de especificar un filtro de valor de atributo debe especificar una
plantilla de eventos.
Para cada filtro, especifique:
Atributo
Un atributo de evento para el que la funcin filtra eventos coincidentes.
Los atributos disponibles dependen de la plantilla de eventos
seleccionada.
Operador
El operador relacional que la funcin aplica al valor de atributo
especificado. Los operadores disponibles dependen del tipo de datos del
atributo.
Valor
El valor que la funcin utiliza para buscar atributos coincidentes. Por
ejemplo, si define el valor = para el campo Operador, la funcin limita los
eventos a aquellos en los que el atributo especificado equivale a este
valor.
78
Funciones de PI DataLink
Entrada
Descripcin
arriba en la lista.
Seleccione un atributo y haga clic en
abajo en la lista.
Seleccione un atributo y haga clic en
lista.
Seleccione un atributo y haga clic en Eliminar atributo para eliminar el
atributo de la lista.
Celda de salida
Consulte tambin
Eventos en hojas de clculo
Aadir atributos de eventos secundarios como columnas en el panel de tareas Comparar
eventos
Configuracin de preferencia
79
Funciones de PI DataLink
Descripcin
.|A1
..|A1
..\..|A1
.\E1|A1
Puede combinar la notacin para designar los atributos superiores de la jerarqua. Por ejemplo,
puede especificar el atributo Duracin para diferentes eventos de la jerarqua:
Evento primario principal superior: ..\..\..|Duration
Evento coincidente: .|Duration
Evento secundario denominado Phase1: .\Phase1|Duration
80
Entrada
Valor
Base de datos
\\AFSRV1\Produccin
Inicio de la bsqueda
*-1w
Final de la bsqueda
TempAlert*
Funciones de PI DataLink
Entrada
Valor
Encabezados de columna
Seleccione lo siguiente:
Nombre de evento
.|Hora de inicio
.|Hora de finalizacin
.|Duracin
.|Elemento primario
.\TempThreat|Hora de inicio*
.\TempThreat|Duracin*
.\TempThreat|Temperatura*
*Se aade a la lista desde la ventana Aadir
atributos.
Funcin Propiedades
La funcin Propiedades recupera el valor de propiedad de un elemento de datos especificado.
81
Funciones de PI DataLink
Entrada
Descripcin
Ruta raz
Elemento(s) de datos
Propiedad
Celda de salida
Consulte tambin
PITagAtt()
82
Funciones de PI DataLink
Ejemplo de propiedades
Para ver los atributos de valor de algunos de los PI points listados en la hoja de clculo, defina
las siguientes entradas para la funcin Propiedades:
Entrada
Valor
Elemento de datos
Propiedad
description (descripcin)
En este caso, los nombres de los PI points estn en una columna a la izquierda. Puede utilizar la
funcin Propiedades aparte para mostrar atributos adicionales en las columnas siguientes.
83
Funciones de PI DataLink
84
En esta seccin
Matrices de funcin
Frecuencia de clculo
Compartir hojas de clculo
Matrices de funcin
Una matriz de funcin es un grupo de celdas que contiene la salida de una funcin de PI
DataLink nica. Cuando se aade una funcin a una hoja de clculo, PI DataLink introduce la
frmula de la funcin en las celdas de salida especificadas. La funcin realiza una consulta a PI
Server o al servidor de PI AF y devuelve valores en una matriz de funcin. El tamao de la
matriz depende de la funcin, del nmero de valores coincidentes disponible, del nmero de
valores solicitado y de la salida solicitada.
La hoja de clculo muestra los valores devueltos en las celdas de una matriz de funcin. Sin
embargo, estas celdas contienen en realidad la frmula de funcin. Puede ver la frmula de
funcin en la barra de frmulas de Excel al hacer clic en una celda.
En esta seccin
Tareas comunes relacionadas con las matrices de funcin
Actualizar entradas en una matriz de funcin
Tamao de la matriz
Redimensionar matrices
85
Procedimiento
1. Abra el panel de tareas de funciones de una matriz:
Con la visualizacin automtica del panel de tareas de funciones activada, haga clic en
una o varias celdas.
Con la visualizacin automtica del panel de tareas de funciones desactivada, seleccione
una celda o varias, haga clic con el botn derecho del ratn y elija un nombre de funcin.
El panel de tareas de funciones muestra las entradas actuales de la matriz de funcin
seleccionada.
Si ha seleccionado una nica celda, PI DataLink detecta de forma automtica las matrices de
funcin adyacentes que nicamente difieren por el origen (es decir, por el elemento de
datos o la expresin) y selecciona las matrices para editar.
86
Tamao de la matriz
Cuando una funcin de PI DataLink escribe una matriz de funcin, ajusta automticamente el
tamao de la matriz para que se ajuste a los datos obtenidos. Las funciones escriben la matriz
de funcin cuando se hace clic en Aceptar o Aplicar en un panel de tareas o al hacer clic en
Recalcular (Redimensionar) funcin en el men contextual.
Otros mtodos que recalculan o actualizan un funcin no escriben una nueva matriz de funcin.
Estos mtodos solo actualizan valores de matriz; el tamao de la matriz permanece invariable.
Por ejemplo, si especifica entradas de funcin con referencias de celda y cambia el valor de una
celda, la funcin actualizar los valores devueltos, pero el tamao de la matriz seguir siendo el
mismo. La actualizacin puede devolver un nmero mayor o menor de valores que la matriz de
funcin de la hoja de clculo puede mostrar. La configuracin controla los valores devueltos
por PI DataLink.
Si la actualizacin devuelve menos valores, PI DataLink devuelve valores en blanco o #N/A
en las celdas sin valores.
Si la actualizacin devuelve ms valores de los que puede mostrar la matriz de funcin, PI
DataLink devuelve el texto Redimensionar para mostrar todos los valores en la
parte inferior de la matriz a no ser que la configuracin de preferencias inhabilite el
mensaje.
Los valores vacos pueden modificar el aspecto de una hoja de clculo. Para mantener un
tamao constante, plantese configurar entradas de funcin para limitar los datos devueltos.
Por ejemplo, en la funcin Datos comprimidos, puede especificar el nmero de valores para
recuperar en lugar del periodo de tiempo durante el cual se recuperarn todos los valores.
Consulte tambin
Frecuencia de clculo
Redimensionar matrices
Configuracin de preferencia
Redimensionar matrices
Una actualizacin o un reclculo de una funcin de PI DataLink puede mostrar ms o menos
valores de los que la matriz de funcin puede mostrar. Utilice el comando Recalcular
(Redimensionar) funcin para volver a escribir la totalidad de la matriz de funcin: PI DataLink
recupera valores nuevos de PI Server o PI AF y redimensiona automticamente la matriz para
que se ajuste a los datos obtenidos.
87
Procedimiento
Haga clic con el botn derecho del ratn en cualquier parte de una matriz de funcin y, a
continuacin, haga clic en Recalcular (Redimensionar) funcin.
La funcin vuelve a escribir la matriz de funcin, utilizando las entradas actuales, y
redimensiona automticamente la matriz para que se ajuste a los datos obtenidos.
Frecuencia de clculo
PI DataLink escribe una matriz de funcin y calcula los valores actuales de la funcin al hacer
clic en Aceptar o Aplicar en el panel de tareas de funcin. Para mantener actualizados lo datos,
debe recalcular la matriz de funcin. En las secciones posteriores se explican los mtodos para
volver a calcular una matriz de funcin.
Para obtener informacin detallada de cmo gestiona Excel el clculo, consulte el tema
Reclculo en Excel (http://msdn.microsoft.com/en-us/library/bb687891.aspx) en la biblioteca
MSDN.
En esta seccin
Funcin Actualizacin automtica
Reclculo provocado
Recalcular manualmente
Consulte tambin
Configuracin de preferencia
Activar Actualizacin automtica
Cancelacin de Actualizacin automtica
Procedimiento
En la pestaa PI DataLink, haga clic en el botn Actualizar.
Excel recalcula de forma inmediata todas las funciones de PI DataLink en todos los libros
abiertos en la sesin actual de Excel. A continuacin, Excel recalcula de forma automtica
estas funciones dentro del intervalo especificado en los ajustes de preferencia.
Cuando se habilita la funcin Actualizacin automtica, el botn Actualizar se resalta y la
barra de estado muestra un mensaje de indicador.
Consulte tambin
Configuracin de preferencia
Procedimiento
En la pestaa PI DataLink, haga clic en el botn Actualizar para anular la seleccin.
Pulse ESC para cancelar un reclculo en curso. PI DataLink finaliza el clculo de la funcin
actualmente en proceso, muestra Clculo cancelado en las celdas de matriz de funcin
sin procesar y anula la Actualizacin automtica.
Reclculo provocado
Excel vuelve a calcular funciones voltiles y cualquier funcin que haga referencia a una
funcin voltil siempre que se edita una celda de la hoja de clculo o se pulsa F9. Las funciones
voltiles incluyen las funciones de tiempo de Excel: ahora() y hoy(). La funcin Valor actual
es una funcin voltil, en tanto que otras funciones de PI DataLink no lo son. Puede iniciar el
reclculo de funciones de PI DataLink no voltiles haciendo referencia a una funcin voltil
dentro de las funciones no voltiles de PI DataLink.
89
Procedimiento
1. Utilice la barra de frmulas de Excel para introducir una funcin voltil en una celda de la
hoja de clculo.
Por ejemplo, puede utilizar (hoy()+1/3) para representar las 8 am del mismo da, o
ahora() como una referencia de celda para remplazar el tiempo PI actual, *.
Para crear una marca de tiempo absoluta que inicie actualizaciones, aada y reste ahora();
por ejemplo, 2-feb-12 00:30:30 + ahora() - ahora().
2. Haga referencia a la celda al definir las entradas Hora de inicio u Hora de finalizacin de una
funcin PI DataLink.
Recalcular manualmente
En cualquier momento, puede recalcular de forma manual funciones de PI DataLink.
Procedimiento
Pulse F9 para forzar el reclculo de todas las funciones voltiles (y cualquier funcin que
haga referencia a ellas).
Pulse Ctrl+Alt+Maysculas+F9 para forzar el reclculo de todas las funciones.
Haga clic en cualquier parte de una matriz de funcin y, a continuacin, haga clic en
Recalcular (Redimensionar) funcin. Este comando escribir la totalidad de la matriz y
redimensionar de forma automtica la raz para que se ajuste a los datos recuperados.
90
Procedimiento
1. Haga clic en la pestaa Archivo y seleccione Opciones. (En Excel 2007, haga clic en el botn
de Microsoft Office y, a continuacin, haga clic en Opciones de Excel.)
2. En el cuadro de dilogo Opciones de Excel, haga clic en Frmulas.
3. En Opciones de clculo, establezca Clculo de libro como Manual y, a continuacin, haga clic
en Aceptar.
91
92
Temas avanzados
Los temas incluidos en esa seccin ofrecen informacin til ms detallada para trabajar con las
funciones de PI DataLink.
En esta seccin
Tiempo PI
Expresiones
Entrada manual de funciones
Funciones para escribir datos
Tiempo PI
Puede utilizar una sintaxis especial, denominada tiempo PI, para especificar entradas para las
marcas de tiempo y los intervalos de tiempo. Tiempo PI utiliza abreviaturas especficas, que
puede combinar para crear expresiones temporales.
En esta seccin
Abreviaturas de tiempo PI
Expresiones de tiempo PI
Especificacin de intervalos de tiempo
Especificacin de intervalos de tiempo
Abreviaturas de tiempo PI
Al especificar un tiempo PI, puede utilizar abreviaturas concretas que representen unidades de
tiempo y referencias temporales.
Abreviaturas de unidad de tiempo
Abreviatura
Unidad de tiempo
segundo
minuto
hora
da
mo
mes
ao
semana
93
Temas avanzados
valor fraccionario, como 1.25h. No se pueden especificar valores fraccionarios con otras
unidades de tiempo.
Abreviaturas de referencias temporales
Abreviatura
Versin completa
Referencia temporal
Hora actual
hoy
ayer
dom1
domingo
jun2
junio
dic DD
diciembreDD
YYYY
M-D o M/D
DD
Expresiones de tiempo PI
Las expresiones de tiempo PI pueden incluir puntos temporales fijos, abreviaturas de
referencias temporales y desplazamientos temporales. Un desplazamiento temporal indica la
direccin del desplazamiento (+ o -) y el intervalo del desplazamiento (una abreviatura de
unidad de tiempo con un valor). Las expresiones de tiempo PI vlidas son:
Solo un punto temporal fijo, como 24-aug-2012 09:50:00
Solo una abreviatura de referencia temporal, como t
Solo un desplazamiento temporal, como +3h
Una abreviatura de referencia temporal con un desplazamiento temporal, como t+3h
Incluya un nico desplazamiento temporal en una expresin. Si incluye varios, los resultados
pueden ser imprevisibles. Por ejemplo, las siguientes expresiones temporales no son vlidas:
*+1d+4h
t-1d+12h
94
Entrada
Significado
23-ago-12 15:00:00
Temas avanzados
Entrada
Significado
25-sep-12
Significado
3-1 o 3/1
2011
25
tue
Significado
*-1h
t+8h
y-8h
mon+14.5h
sat-1m
Desplazamientos temporales
Si se introducen solos, los desplazamientos especifican un punto en el tiempo relativo a una
referencia temporal implicada. Una referencia temporal implicada puede ser la hora de reloj
actual u otra hora, en funcin de dnde introduzca la expresin.
Entrada
Significado
-1d
+6h
2:00:00
Hora de finalizacin
3:15:00
Intervalo de tiempo
30m
95
Temas avanzados
Intervalos devueltos
2:00:00 a 2:30:00
2:30:00 a 3:00:00
Los valores negativos definen intervalos que finalizan en el ltimo momento del perodo y
comienzan en o antes del primer momento del periodo.
Hora de inicio
2:00:00
Hora de finalizacin
3:15:00
Intervalo de tiempo
-30m
Intervalos devueltos
2:15:00 a 2:45:00
2:45:00 a 3:15:00
Expresiones
En PI DataLink, las expresiones son ecuaciones de rendimiento que se pueden utilizar en
funciones para incorporar operaciones matemticas y clculos basados en elementos de datos
de PI System. Por ejemplo, puede utilizar una expresin en una funcin de PI DataLink para
calcular valores a medida que se obtengan de PI Server.
Nota:
PI DataLink restringe los elementos de datos que se pueden incluir en las expresiones.
Consulte Restricciones relativas a los elementos de datos en expresiones..
Algunas funciones de PI DataLink aceptan un elemento de datos o una expresin como entrada.
Estas funciones tienen las opciones Elemento de datos y Expresin en la parte superior del
panel de tareas. Algunas funciones de DataLink tienen tambin un campo Expresin de filtro.
Especifique una expresin de filtro para limitar los valores que devuelve una funcin.
Las funciones de PI DataLink que pueden utilizar expresiones son:
Funcin Valor de archivo histrico
Funcin Datos comprimidos
Funcin Datos de muestra
Funcin Datos temporizados
Funcin Datos calculados
Funcin Filtrado de tiempo
En las siguientes secciones se proporciona informacin bsica sobre las expresiones. PI
DataLink admite la sintaxis, operadores y funciones admitidos por PI Server.
Para obtener una descripcin completa de las ecuaciones de rendimiento y ejemplos, consulte
PI Server Applications User Guide o el archivo de ayuda PI 3 Performance Equations. Puede
descargar estos documentos de la pgina de descargas del Servicio de asistencia tcnica de
OSIsoft (https://techsupport.osisoft.com/Downloads/All-Downloads/). Tambin puede
consultar estos temas en la PI Live Library (http://livelibrary.osisoft.com).
En esta seccin
Uso de expresiones en funciones de PI DataLink
Sintaxis de las expresiones
Restricciones relativas a los elementos de datos en expresiones.
Ejemplos de expresiones
Expresiones de filtro
96
Temas avanzados
Antes de empezar
Abra el panel de tareas de funcin
Procedimiento
1. Haga clic en la opcin Expresin en la parte superior del panel de tareas de funcin.
El campo Elemento(s) de datos se convierte en un campo Expresin(es). La disponibilidad
de otros campos puede variar.
2. Especifique la expresin directamente en el campo Expresin(es) o introduzca una
referencia a una celda que contenga una expresin.
Utilice referencias de celda para especificar varias expresiones para una funcin. Recuerde
que una expresin en una celda referenciada es una cadena y debe ir precedida de comillas
simples.
97
Temas avanzados
Ejemplos de expresiones
La siguientes expresin calcula el total del valor del PI point sinusoid al cubo y el valor del PI
point cdf144 dividido por 10:
(('sinusoid')^3 + 'cdf144'/10)
La expresin siguiente se evala como verdadera (distinta de cero) si el valor absoluto del PI
point mytages al menos 14,65:
(abs('mytag') >= 14.65)
La siguiente expresin se evala como true si el valor del atributo de PI AF Manufacturer es
ACME:
('\\Server\Database\Element|Manufacturer' = "ACME")
La siguiente expresin se evala como verdadera si el valor del PI point sinusoid es menor
que 45 y la raz cuadrada del valor del PI point vdf1002 es mayor que 2:
('sinusoid' < 45 and sqr('vdf1002') > 2)
Expresiones de filtro
Utilice una expresin de filtro en una funcin de PI DataLink para filtrar los valores registrados
con una ecuacin de rendimiento booleana. PI DataLink elimina los datos para los que la
expresin se evala como falsa.
PI DataLink aplica la expresin de filtro a los datos recuperados sin procesar (y no a los valores
que resultan del propio clculo). Por ejemplo, si se aade la expresin de filtro simple
'sinusoid' < 70 a la funcin Datos calculados, se eliminarn del clculo todos los valores
iguales o por encima de 70.
Las expresiones de filtro pueden contener cualquier ecuacin de rendimiento booleana vlida;
sin embargo los elementos de datos de las expresiones de filtro deben hacer referencia a un PI
point. Puede crear expresiones complejas. Por ejemplo, puede utilizar expresiones de filtro
para eliminar picos atpicos en los valores registrados.
Si est disponible, seleccione la casilla Marcar como filtrado para insertar la etiqueta Filtrado
en lugar de un valor o un bloque de valores que la funcin ha filtrado de la salida en funcin de
la expresin de filtro.
Consulte tambin
Sintaxis de las expresiones
Restricciones relativas a los elementos de datos en expresiones.
En esta seccin
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
98
Temas avanzados
Cdigos de salida
Procedimiento
1. Seleccione un intervalo adecuado en la hoja de clculo para la matriz de salida en funcin
del nmero de valores previstos.
2. Introduzca la funcin de PI DataLink y sus argumentos en la barra de frmulas de Excel.
3. Pulse Ctrl+Mays+Intro para situar la funcin de PI DataLink en las celdas de salida
seleccionadas.
Consulte la ayuda en lnea de Microsoft Excel para obtener ms informacin sobre las
frmulas de matriz.
Pauta
Funciones estndar
Cadenas
Referencias de celda
Ruta raz
99
Temas avanzados
Datos introducidos como
argumento
Pauta
Cdigos de salida
Cdigos de salida
La sintaxis de la funcin PI DataLink contiene un argumento OutCode de entero. Este
argumento toma un cdigo de salida que determina que datos aadidos devuelve la funcin y la
orientacin de las celdas de salida.
Los paneles de tareas de PI DataLink generan valores de cdigo de salida automticamente. Sin
embargo, si introduce de forma manual una funcin en la barra de frmulas de Excel, tendr
que calcular e incluir un valor de cdigo de salida adecuado.
Un cdigo de salida es una representacin con enteros de bits binarios. En PI DataLink, el
significado del bit depende de la funcin:
Significado de los bits para las funciones Valor actual y Valor de archivo
Bit
Finalidad
Finalidad
Ocultar recuento
Mostrar anotaciones
71
81
91
Con el argumento OutCode de 0, una funcin devuelve el valor en una orientacin de columna
sin datos aadidos. Para calcular el argumento OutCode, utilice la siguiente frmula:
Por ejemplo, con un argumento OutCode de 0, la funcin PISampDat() devuelve los valores de
muestra en la celda de salida designada. Con un argumento OutCode de 1, la funcin devuelve
marcas de tiempo en la columna uno y los valores de muestra en la columna dos de una matriz
n x 2. Con un argumento OutCode de 3, la funcin devuelve marcas de tiempo en la fila uno y
100
Temas avanzados
las valores de muestra en la fila dos de una matriz n x 2. (En estos resultados, n es el nmero de
los valores de muestra).
Nota:
Las funciones admiten distintos bits y, por lo tanto, valores de argumento de OutCode.
Aquellos que son vlidos para una funcin no son necesariamente vlidos para otra.
Consulte en la Referencia de funcin los bits que cada funcin admite en su especificacin
de OutCode.
Ejemplo
Supongamos que desea que la funcin Datos calculados muestre el porcentaje correcto, la hora
de inicio y el tiempo mn/mx. Para mostrar la hora de inicio y el tiempo mn/mx, debe
activar el bit mostrar marcas de tiempo. Para calcular el argumento OutCode:
101
Temas avanzados
valores de celda de los resultados de las funciones de PI DataLink. Esto produce los mismos
resultados que la entrada manual de funciones de PI DataLink en el mismo rango de celdas.
Consulte tambin
PIPutVal() y PIPutValX()
102
Funciones de tags
Un PI point es un flujo de datos en tiempo real procedentes de una fuente definida. Los
atributos de punto, incluido el Tag (es decir, el nombre del PI point) y el origen de punto,
describen un PI point.
Utilice las funciones de tags de PI DataLink para localizar los puntos que corresponden a IDs de
PI point y otros atributos de punto. Podr encontrar funciones de tag en la pestaa PI DataLink,
en el grupo Funciones de tag.
Nota:
Debe activar el complemento PI DataLink (Legacy) para utilizar estas funciones (consulte
Configuracin del complemento para Microsoft Excel).
Consulte tambin
Descripcin general de las funciones de PI DataLink
Funcin Propiedades
Tendencias
En esta seccin
Funcin Apuntar ID al Tag
Funcin Mscara de atributo para tag
Buscar PI points
Descripcin
PI Server
ID(s) de punto
Uno o varios ID de punto para los que desea que la funcin devuelva nombres
de punto.
Necesario.
Celda de salida
Consulte tambin
PIPointIDToTag()
103
Funciones de tags
Valor
ID de punto
Descripcin
PI Server
Nombre(s) de tag
Descriptor
Fuente de punto
Tipo de punto
Clase de punto
Unidades de ingeniera
Celda de salida
Columna
Fila
Consulte tambin
PIAttributeMaskToTag ()
104
Funciones de tags
Valor
Nombre de tag
BA*
Tipo de punto
Float32
Tenga en cuenta que puede utilizar comodines. Las cadenas introducidas deben coincidir con
los valores de atributo en PI Server.
Buscar PI points
Con las funciones relacionadas con la informacin de tags, utilice la ventana Bsqueda de
etiquetas para consultar el PI Server en busca de IDs o nombres de PI points para insertar en el
panel de tareas.
Procedimiento
1. En el panel de tareas, haga clic en
105
Funciones de tags
5. Haga clic en Buscar para encontrar los puntos que coincidan con los criterios especificados.
6. Seleccione el punto deseado en el panel de resultados y haga clic en Aceptar para insertar el
valor en el panel de tareas.
106
Tendencias
La versin de PI DataLink para Microsoft Office de 32 bits incluye un objeto de tendencia
ActiveX. Puede insertar una tendencia en una hoja de clculo para mostrar visualmente los
cambios en los valores registrados a lo largo del tiempo. Las tendencias pueden mostrar datos
en la hoja de clculo o de PI points seleccionados.
Nota:
Debe activar el complemento PI DataLink (Legacy) para insertar o editar tendencias
(consulte Configuracin del complemento para Microsoft Excel).
En esta seccin
Crear una tendencia
Men contextual de tendencias
Procedimiento
1. En una hoja de clculo, haga clic en la celda donde desee situar la esquina izquierda superior
de la tendencia.
Al seleccionar la celda, recuerde que la tendencia requiere de forma predeterminada
aproximadamente 14 x 8 celdas estndar.
2. En la pestaa PI DataLink, en el grupo Funciones de tag, haga clic en Insertar tendencia para
abrir el Asistente para complementos de tendencia.
3. Defina uno o varios trazos para incluir en la tendencia. Puede:
Crear un trazo de valores en la hoja de clculo.
Crear un trazo de valores de PI point obtenidos de un PI Server.
4. Ajuste el aspecto de los trazos de la tendencia. Puede:
107
Tendencias
Seleccionar la casilla de verificacin en la columna Marcadores para incluir marcadores
que indiquen la ubicacin de los puntos de datos archivados.
Nota:
Los trazos se dibujan con distintos colores. De forma predeterminada, una
tendencia incluye tambin marcadores ocultos para diferenciar los trazos en las
pantallas monocromas. Los marcadores ocultos tienen una separacin regular a lo
largo del trazo y no indican puntos de datos archivados.
Seleccionar un trazo y, a continuacin, utilizar los botones de flecha para mover el trazo
hacia arriba o abajo en la leyenda.
Seleccionar un trazo y hacer clic en X para eliminar el trazo.
Hacer clic en x todo para eliminar todos los trazos.
Seleccionar un trazo y hacer clic en Cambiar nombre para cambiar el nombre del trazo.
5. Haga clic en Siguiente.
6. Si alguno de los trazos de la tendencia contiene valores de PI point obtenidos de un PI
Server, especifique el periodo de tiempo para recuperar valores.
a. Especifique el inicio del periodo en el campo Hora de inicio y el final del periodo en el
campo Hora de finalizacin. Puede:
Seleccionar una cadena de tiempo de la lista.
Introducir un valor de tiempo en el campo.
Hacer clic en
continuacin, hacer clic en la celda de hoja de clculo que contenga una serie de
tiempo o escribir la direccin de esa celda.
Consulte Tiempo PI para ver una explicacin de las cadenas de tiempo vlidas.
b. Seleccione la casilla Activar actualizaciones para actualizar la tendencia con nuevos
datos de PI Server si el intervalo de tiempo cambia o se extiende hasta el presente.
7. Haga clic en Siguiente.
8. Especifique el ttulo y la colocacin de la tendencia:
a. En el campo Ttulo de trend, escriba un ttulo para la tendencia.
b. Anule la seleccin de la casilla Mostrar atributos de valor si no desea que los atributos de
valor aparezcan en los trazos de la tendencia.
Los iconos aparecen cuando los datos contienen valores registrados que tienen ajustados
los bits Cuestionable, Sustituido o Anotado.
c. Si lo desea, especifique una ubicacin diferente para la tendencia. Puede seleccionar:
Hoja de clculo nueva para situar la tendencia en la esquina superior izquierda de una
hoja de clculo en blanco.
Hoja de clculo existente para colocar la tendencia en la hoja de clculo actual que
empieza en la celda especificada.
Si cambia la celda, asegrese de que la celda nueva no contenga datos.
9. Haga clic en Finalizar.
Tendencias
Procedimiento
1. En el Asistente para complementos de trend, haga clic en Datos de la hoja de clculo.
2. Haga clic en el campo Rango de celdas con datos y, a continuacin, seleccione las celdas que
contengan los valores.
3. Especifique opciones adecuadas para el intervalo de celdas especificado.
Seleccione la casilla El primer elemento es el nombre de tendencia para utilizar el valor
de una celda adyacente como nombre del trazo. (Si el intervalo de celdas es una columna,
el nombre del trazo estar en la celda situada encima del primer valor; si el intervalo de
celda es una fila, el nombre del trazo estar en la celda situada a la izquierda del primer
valor.)
Seleccione la casilla Incluir todas las celdas en la matriz para incluir todas las celdas en
una matriz de funcin en el intervalo de celdas. Si selecciona esta casilla, el campo Rango
de celdas con datos solo necesita especificar una celda en una matriz de funcin.
Seleccione la casilla Escalonado trazar un plot de tendencia escalonado en lugar de un
trazo continuo Puede seleccionar esta casilla para PI points que almacenen valores
discretos.
4. Haga clic en Aadir para insertar el trazo en la tendencia.
Procedimiento
1. En el Asistente para complementos de trend, haga clic en Datos de PI.
2. En el campo Nombre de tag, especifique el nombre de PI point para el que desea recuperar
valores. Puede:
Escribir el nombre del punto.
Hacer clic en el campo y seleccionar las celdas de hoja de clculo que contengan nombres
de puntos.
Hacer clic en
para abrir la ventana Bsqueda de tags, que puede utilizar para buscar
continuacin, hacer clic en la celda de hoja de clculo que contenga un servidor o escriba
la direccin de esa celda.
4. Haga clic en Aadir para insertar el trazo en la tendencia.
109
Tendencias
Cambiar escala
Abra la ventana Cambiar escala para cambiar la escala del eje Y o el intervalo de tiempo del
eje X.
Revertir
Deshaga los cambios y vuelva a la configuracin original de la tendencia definida en el
Asistente para complementos de trend.
Barra de desplazamiento
Habilite una barra de desplazamiento en la parte inferior de la tendencia para desplazar la
pantalla por los intervalos de tiempo adyacentes.
Formato
Abra el cuadro de dilogo Propiedades de control PI Trend para modificar el aspecto de
trazos individuales o de la tendencia entera. Puede cambiar el color o el grosor de la lnea de
un trazo o aadir elementos de leyenda a la tendencia.
Definir trend
Abra la pgina de definicin de trazos del asistente de tendencias para actualizar o cambiar
los trazos.
Definir rango temporal de trend
Abra la pgina de definicin del intervalo de tiempo del asistente de tendencias para
actualizar el intervalo.
Eliminar trend
Elimine la tendencia de la hoja de clculo.
Nota:
No se puede restaurar una tendencia eliminada, solo se puede volver a crear.
Exportar datos
Abra el cuadro de dilogo Exportar datos para pegar los valores de la tendencia en filas o
columnas de la hoja de clculo. Tambin puede exportar nombres de trazos como ttulos.
Mover/Cambiar tamao
Abra el cuadro de dilogo Mover/Cambiar tamao para mover la esquina superior izquierda
de la tendencia a la celda especificada. Introduzca un intervalo de celdas para
redimensionar la tendencia.
Copiar/Pegar
Abra el cuadro de dilogo Copiar/Pegar para pegar una copia de la tendencia a una
determinada celda.
110
En esta seccin
PI Module Database y hojas de clculo
Insertar objetos de PI Module Database en la hoja de clculo
Funciones de bases de datos de mdulos
111
Procedimiento
1. Seleccione una celda y en PI DataLink haga clic en Buscar mdulo para abrir el cuadro de
dilogo Buscar mdulo.
2. Seleccione el tipo de objeto que est buscando:
Alias
Propiedad
Mdulo
3. En la lista desplegable PI Server, seleccione el PI Server conectado que contiene la base de
datos de mdulo que desea examinar.
4. En la lista Fecha de consulta, especifique la fecha y hora efectivas de la jerarqua de base de
datos de mdulo que desea ver.
5. Navegue por la jerarqua de rbol para localizar el elemento deseado.
6. Seleccione el elemento o el objeto de coleccin principal que desea copiar en la hoja de
clculo:
Seleccione un elemento para copiar en la hoja de clculo.
Seleccione un objeto principal (Alias o Propiedades) de un mdulo para copiar todos los
alias o propiedades de ese mdulo en la hoja de clculo.
7. Seleccione la casilla Copiar ruta de mdulo para copiar la ruta de mdulo completa del alias
o la propiedad en una celda de hoja de clculo adyacente.
La ruta de mdulo proporciona el contexto para el objeto seleccionado. Nota: si el ajuste
Copiar nombre de PI Server est activado, PI DataLink tambin copiar el nombre del PI
Server correspondiente.
Nota:
Si el ajuste Copiar nombre de PI Server (consulte Configuracin de preferencia) est
activado, PI DataLink tambin copiar el nombre del PI Server correspondiente.
8. Haga clic en Aceptar para copiar los elementos seleccionados en la hoja de clculo y cerrar
el cuadro de dilogo.
Consulte tambin
Descripcin general de las funciones de PI DataLink
En esta seccin
Funcin Alias para tag
Funcin Propiedad para valor
112
Descripcin
PI Server
Alias
Ruta de mdulo
Fecha de consulta
Celda de salida
Sin servidor
Servidor a la derecha
Servidor en la parte
inferior
Consulte tambin
PIAliasToTag()
Descripcin
PI Server
Propiedad(es)
113
Descripcin
Ruta de mdulo
Fecha de consulta
Celda de salida
Columna
Fila
Consulte tambin
PIPropertyToValue()
114
Notificaciones
PI DataLink incluye el complemento PI DataLink Notifications. Al activarse, este complemento
aade la funcin Bsqueda de notificacin a la pestaa PI DataLink. Utilice la funcin Bsqueda
de notificacin para recuperar notificaciones de PI System a las que se haya suscrito e insertar
estas notificaciones en hojas de clculo.
El complemento PI DataLink Notifications se ejecuta en Windows XP y sistemas operativos
posteriores y requiere Excel 2007 SP3 o versiones posteriores. PI Notifications debe estar
instalado en el ordenador para poder activar el complemento (consulte Configuracin del
complemento para Microsoft Excel).
Nota:
Debe tener una cuenta como mnimo en un servidor de PI AF 2.0 con PI Notifications 1.0 y
estar suscrito a una regla de notificacin como mnimo para recibir notificaciones. Para
obtener ms informacin sobre PI Notifications, consulte el Manual del usuario de PI
Notifications.
Para acceder a la funcin Bsqueda de notificacin, haga clic en la celda de salida de la hoja de
clculo que desee y, a continuacin, en la pestaa PI DataLink (en el grupo Notificaciones),
haga clic en Notification Search para abrir el cuadro de dilogo Notification Search.
En esta seccin
Bsqueda e insercin de notificaciones
Notificaciones insertadas
Configuracin de visualizacin de notificaciones
115
Notificaciones
Procedimiento
1. En la pestaa PI DataLink, en el grupo Notifications, haga clic en Notification Search para
abrir el cuadro de dilogo Notification Search.
2. En la pestaa Search, seleccione el servidor PI AF en el que buscar las notificaciones:
En la lista PI Systems, seleccione un servidor PI AF y haga clic en Conectar para
conectarse a ese servidor.
Si es necesario, haga clic en Mostrar lista
Antes de empezar
Suscrbase a las notificaciones en PI System Explorer.
116
Notificaciones
Procedimiento
1. En la pestaa Buscar de la ventana Bsqueda de notificacin, haga clic en Mostrar lista
junto a la lista PI Systems para abrir la ventana Servidores AF.
2. Haga clic en Aadir servidor AF para abrir el cuadro de dilogo Propiedades de servidor de PI
AF.
3. Introduzca la informacin de red pertinente para localizar el servidor PI AF y para
autenticar su equipo en ese servidor.
a. En el campo Nombre, introduzca el nombre que identificar al servidor de PI AF en la
funcin Bsqueda de notificacin.
b. Haga clic en Configurar Active Directory para configurar el acceso a Active Directory para
obtener informacin de inicio de sesin.
4. Haga clic en Aceptar para guardar las propiedades y aadirlo a la lista de servidores de PI
AF.
5. Haga clic en Aceptar para cerrar el cuadro de dilogo Servidores AF.
El servidor de PI AF aparece en la lista PI Systems. Para obtener ms informacin sobre los
servidores de PI AF, consulte la documentacin relativa a PI AF.
Procedimiento
Haga clic en las cabeceras de columna para ordenar notificaciones segn un atributo
determinado.
Haga clic con el botn derecho en los resultados para mostrar y ocultar columnas:
Haga clic en Expand All o Collapse All para expandir o contraer un grupo de
notificaciones.
Haga clic en Show Contact Events para activar y desactivar la visualizacin de los
eventos de contacto para cada notificacin.
117
Notificaciones
Procedimiento
Haga clic con el botn derecho en una notificacin y elija un comando.
Acknowledge Instance
Reconocimiento de que se ha llevado a cabo una accin en respuesta a la notificacin y de
que no es necesario escalar la notificacin. Si lo desea, introduzca un comentario y haga
clic en Aceptar.
Acknowledge Subscription
Acusar recibo de una notificacin a la que est suscrito. Si lo desea, introduzca un
comentario y haga clic en Aceptar.
Add Comment
Comentario sobre una notificacin.
View Notification Rule Summary
Muestra las propiedades de la regla de notificacin que ha desencadenado la notificacin
seleccionada.
Notificaciones insertadas
Las funciones de PI DataLink pueden hacer referencia a datos de notificaciones en celdas de
hoja de clculo. Por ejemplo, puede utilizar el valor de Start Time de una notificacin
recuperada para obtener datos de muestra que indiquen el progreso de un proceso por lotes.
Si sus notificaciones estn ajustadas para mostrar confirmaciones, dichas columnas incluyen
enlaces a pginas web de PI Notifications en las que podr confirmar o comentar una
notificacin.
Para obtener ms informacin sobre notificaciones, suscripcin y confirmacin, consulte el
Manual de usuario de PI Notifications.
118
Notificaciones
Columnas
Seleccione columnas en la lista Available columns y haga clic en Add para moverlas a la lista
Column order, que especifica los datos que se insertarn en la hoja de clculo.
Nota:
Incluya la columna Acknowledge para aadir un enlace a la hoja de clculo para
confirmar la recepcin e incluya la columna Acknowledge With Comment para aadir
un enlace en la hoja de clculo para comentar una notificacin.
Haga clic en Add All para mover todas las columnas a la lista Column order.
Seleccione columnas de la lista Column order y haga clic en los botones de flecha situados
encima de la lista para cambiar el orden de las columnas.
Seleccione columnas en la lista Column order y haga clic en Remove para eliminar las
columnas seleccionadas de la lista.
Haga clic en Clear para eliminar todas las columnas de la lista Column order.
Eventos de contacto
Seleccione la casilla Display contact events para incluir eventos de contacto relacionados
con cada notificacin, como el envo a cada destinatario, comentarios y confirmaciones.
Seleccione la casilla Indent contacts para aadir un sangrado a los eventos de contacto en la
hoja de clculo. Esto ayuda a identificarlos.
Seleccione Using separate columns para aadir una segunda columna para eventos de
contactos.
Seleccione Formatting cells para aadir un sangrado a los eventos de contacto en la
misma columna que los eventos de notificacin.
Seleccione la casilla Group notifications with Excel grouping para utilizar la funcionalidad
de agrupacin de Excel para anidar eventos de contactos bajo las notificaciones primarias
individuales que los generan.
Nota:
PI DataLink Server (DLS) no admite la agrupacin de Excel.
119
Notificaciones
Presentacin y orientacin
Seleccione la casilla Display column headers para aadir cabeceras de columna y fila sobre
los datos de notificaciones.
Seleccione la casilla Display count para aadir una fila o una columna que contenga el total
de notificaciones delante de los datos de notificaciones.
En Orient results in, seleccione Columns para mostrar los datos de notificaciones en
columnas o seleccione Rows para mostrarlos en filas.
120
Referencia de funcin
Puede generar funciones de PI DataLink en los paneles de tareas de PI DataLink (consulte
Descripcin general de las funciones de PI DataLink). La matriz de la funcin resultante
depende de las entradas. Tambin puede introducir estas mismas funciones directamente en la
barra de frmulas de Excel (consulte Entrada manual de funciones).
En esta seccin se incluye una referencia a las funciones de PI DataLink admitidas. En cada
tema, se describen la sintaxis de funcin y los argumentos; la mayor parte de los temas
incluyen un ejemplo. En las secciones siguientes, se agrupan las funciones por tipo.
En esta seccin
Funciones de valor nico
Funciones de valor mltiple
Funciones de clculo
Funciones de tags
Funciones de Module Database
Funciones de entrada
En esta seccin
PICurrVal()
PIArcVal()
PIExpVal()
PITagAtt()
PICurrVal()
Devuelve el valor actual de un PI point procedente del snapshot o un atributo de PI AF
procedente de la base de datos.
Sintaxis
PICurrVal(DataItem, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
121
Referencia de funcin
Argumento
Tipo
Descripcin
OutCode
Integer
RootPath
Cadena
Ejemplo
=PICurrVal("let439",1,"holden")
Recupera el valor actual y la marca de tiempo correspondiente para el PI point let439 del PI
Server denominado holden y coloca la marca de tiempo en la columna a la izquierda del valor.
Consulte tambin
Funcin Valor actual
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIArcVal()
Recupera el valor de un PI point o un atributo de PI AF para una marca de tiempo especfica.
Sintaxis
PIArcVal(DataItem, TimeStamp, OutCode, RootPath, Mode)
Argumentos
122
Argumento
Tipo
Descripcin
DataItem
Cadena
TimeStamp
Cadena
OutCode
Integer
RootPath
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
Mode
Cadena
Ejemplo
=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")
Recupera el valor interpolado del PI point cdep158 a las 7:20 p.m. del 11 de diciembre de 1992
procedente del PI Server denominado casaba.
Consulte tambin
Funcin Valor de archivo histrico
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIExpVal()
Recupera el valor calculado de una ecuacin de rendimiento para una marca de tiempo
especfica.
Sintaxis
PIExpVal(Expression, TimeStamp, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
TimeStamp
Cadena
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIExpVal("sqr('sinusoid')","y",0,"thevax")
Calcula la raz cuadrada del valor del PI point sinusoid procedente del PI Server denominado
thevax en la medianoche de ayer.
123
Referencia de funcin
Consulte tambin
Funcin Valor de archivo histrico
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PITagAtt()
Recupera un valor de propiedad asociado con un elemento de datos especfico.
Sintaxis
PITagAtt(DataItem, Property, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
Propiedad
Cadena
RootPath
Cadena
Ejemplo
=PITagAtt(d1,"uom",)
Recupera las unidades de ingeniera del PI point especificado en la celda D1 del PI Server
predeterminado.
Consulte tambin
Funcin Propiedades
En esta seccin
PINCompDat()
PINCompFilDat()
PICompDat()
PICompFilDat()
PISampDat()
PISampFilDat()
PIExpDat()
PITimeDat()
124
Referencia de funcin
PITimeExpDat()
PINCompDat()
Recupera un nmero especfico de valores de PI point o de atributos de PI AF a partir de una
determinada hora.
Sintaxis
PINCompDat(DataItem, STime, NumVals, OutCode, RootPath, Mode)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
NumVals
Integer
OutCode
Integer
RootPath
Cadena
Mode
Cadena
Ejemplo
=PINCompDat("cdf144","1:00:00",10,1,,"inside")
Devuelve diez valores y sus marcas de tiempo correspondientes procedentes del PI Server
predeterminado para el PI point cdf144 a partir de la 1:00 a.m. de esta maana, utilizando el
tipo de lmite interior.
Consulte tambin
Funcin Datos comprimidos
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
125
Referencia de funcin
PINCompFilDat()
Recupera un nmero especfico de valores de PI point filtrados o de atributos de PI AF filtrados
a partir de una determinada hora.
Sintaxis
PINCompFilDat(DataItem, STime, NumVals, FiltExp, FiltCode, OutCode, RootPath,
Mode)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
NumVals
Integer
FiltExp
Cadena
FiltCode
Integer
OutCode
Integer
RootPath
Cadena
Mode
Cadena
Ejemplo
=PINCompFilDat("cdf144","2:00:00",10,"'cdep158'>38",1,1,,)
126
Referencia de funcin
Devuelve diez valores y las marcas de tiempo correspondientes procedentes del PI Server
predeterminado para el PI point cdf144 a partir de las 02:00 a.m. de esta maana, cuando el
punto cdep158 es mayor que 38, utilizando el tipo de lmite interior.
La salida contiene la etiqueta Filtered entre todos los valores en los que la condicin de filtro
ha sido falsa.
Consulte tambin
Funcin Datos comprimidos
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PICompDat()
Devuelve valores de PI point o de atributos de PI AF, almacenados durante un determinado
periodo de tiempo.
Sintaxis
PICompDat(DataItem, STime, ETime, OutCode, RootPath, Mode)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
OutCode
Integer
RootPath
Cadena
Mode
Cadena
Ejemplo
=PICompDat("cdf144","1:00:00","3:00:00",1,,"inside")
127
Referencia de funcin
Devuelve valores y sus marcas de tiempo correspondientes procedentes del PI Server
predeterminado para el PI point cdf144 a partir de la 1:00 a.m. a las 3:00 a.m. de esta maana,
utilizando el tipo de lmite interior.
Consulte tambin
Funcin Datos comprimidos
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PICompFilDat()
Devuelve valores de PI point filtrados o de atributos de PI AF filtrados, almacenados durante
un determinado periodo de tiempo.
Sintaxis
PICompFilDat(DataItem, STime, ETime, FiltExp, FiltCode, OutCode, RootPath, Mode)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
FiltExp
Cadena
FiltCode
Integer
128
OutCode
Integer
RootPath
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
Mode
Cadena
Ejemplo
=PICompFilDat("cdf144","2:00:00","10:00:00","'cdep158'>38",1,1,,)
Consulte tambin
Funcin Datos comprimidos
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PISampDat()
Recupera valores interpolados, con intervalos iguales, para un PI point o un atributo de PI AF
almacenados a lo largo de un determinado periodo de tiempo.
Sintaxis
PISampDat(DataItem, STime, ETime, Interval, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
129
Referencia de funcin
Argumento
Tipo
Descripcin
OutCode
Integer
RootPath
Cadena
Ejemplo
=PISampDat("sinusoid","y","t","3h",1,)
Consulte tambin
Funcin Datos de muestra
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PISampFilDat()
Recupera valores interpolados y filtrados, con intervalos iguales, para un PI point o un atributo
de PI AF almacenados a lo largo de un determinado periodo de tiempo.
Sintaxis
PISampFilDat(DataItem, STime, ETime, Interval, FiltExp, FiltCode, OutCode,
RootPath)
Argumentos
130
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
FiltExp
Cadena
FiltCode
Integer
OutCode
Integer
RootPath
Cadena
Ejemplo
=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)
Consulte tambin
Funcin Datos de muestra
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIExpDat()
Recupera valores calculados, con intervalos iguales, de una ecuacin de rendimiento a lo largo
de un determinado periodo de tiempo.
Sintaxis
PIExpDat(Expression, STime, ETime, Interval, OutCode, RootPath)
131
Referencia de funcin
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")
Calcula la raz cuadrada del valor del PI point sinusoid recuperado del PI Server denominado
thevax a intervalos de una hora, comenzando por la medianoche de ayer hasta la medianoche
de hoy.
La funcin muestra la marca de tiempo de cada valor en la columna situada a la izquierda del
valor calculado.
Consulte tambin
Funcin Datos de muestra
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PITimeDat()
Recupera los valores de muestra reales o interpolados de un PI point o un atributo de PI AF con
determinadas marcas de tiempo.
Sintaxis
PITimeDat(DataItem, TimeStamps, RootPath, Mode)
132
Referencia de funcin
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
TimeStamps
Referencia
RootPath
Cadena
Mode
Cadena
Devoluciones
Valores con las marcas de tiempo especificadas, presentados con la misma orientacin que la
referencia de marca de tiempo. Si la referencia de marca de tiempo es una fila, la funcin
presenta valores en una fila. Si la referencia de marca de tiempo es una columna, la funcin
presenta valores en una columna. La orientacin de la matriz de salida debe coincidir con la de
la referencia de marca de tiempo.
Ejemplo
=PITimeDat("mytag",b1:b12,,"interpolated")
Recupera valores interpolados con las marcas de tiempo ubicadas en las celdas B1 a B12 para
el PI point mytag en el PI Server predeterminado.
Esta funcin requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o
B14:B25.
Consulte tambin
Funcin Datos temporizados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PITimeExpDat()
Recupera los valores de una ecuacin de rendimiento calculados para unas determinadas
marcas de tiempo.
Sintaxis
PITimeExpDat(Expression, TimeStamps, RootPath)
133
Referencia de funcin
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
TimeStamps
Referencia
RootPath
Cadena
Devoluciones
Valores con las marcas de tiempo especificadas, presentados con la misma orientacin que la
referencia de marca de tiempo. Si la referencia de marca de tiempo es una fila, la funcin
presenta valores en una fila. Si la referencia de marca de tiempo es una columna, la funcin
presenta valores en una columna. La orientacin de la matriz de salida debe coincidir con la de
la referencia de marca de tiempo.
Ejemplo
=PITimeExpDat("sqr('sinusoid')",b1:b12,)
Calcula la raz cuadrada del valor del PI point sinusoid recuperado del PI Server
predeterminado a las horas especificadas en las celdas B1 a B12.
Esta funcin requiere una matriz de salida horizontal de doce celdas; por ejemplo, C1:C12 o
B14:B25.
Consulte tambin
Funcin Datos temporizados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Funciones de clculo
Las funciones de clculo calculan nuevos valores a partir de valores de PI points, atributos de
PI AF o evaluaciones de ecuaciones de rendimiento durante un periodo de tiempo especfico.
En esta seccin
PIAdvCalcVal()
PIAdvCalcFilVal()
PIAdvCalcExpVal()
PIAdvCalcExpFilVal()
PIAdvCalcDat()
PIAdvCalcFilDat()
PIAdvCalcExpDat()
134
Referencia de funcin
PIAdvCalcExpFilDat()
PITimeFilter()
PITimeFilterVal()
PIAdvCalcVal()
Recupera un valor calculado a partir de valores de PI point o de atributo de PI AF durante un
determinado periodo de tiempo.
Sintaxis
PIAdvCalcVal(DataItem, STime, ETime, Mode, CalcBasis, MinPctGood, CFactor,
OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcVal("cdf144","y","t","total","time-weighted",50,1,4,)
135
Referencia de funcin
Devuelve un total de tiempo ponderado para el PI point cdf144 calculado a partir de los
valores del PI Server predeterminado desde ayer a hoy.
La funcin multiplica el resultado por 1 y slo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha del
total calculado.
Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcFilVal()
Recupera un valor calculado a partir de valores filtrados de PI point o de atributo de PI AF
durante un determinado periodo de tiempo.
Sintaxis
PIAdvCalcFilVal(DataItem, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
FiltExp
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
136
Referencia de funcin
Argumento
Tipo
Descripcin
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcFilVal("cdf144","y","t","'cdm158'=""Manual""","total","timeweighted","compressed","10m",50,1,4,)
Devuelve el total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores
del PI Server predeterminado, sumando los valores de ayer a hoy durante los perodos de
tiempo en que el PI point cdm158 se ha establecido como Manual.
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora el intervalo de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos del punto cdf144. La funcin solo devuelve un resultado si al menos un
50 por ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la
derecha del total calculado.
Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcExpVal()
Devuelve un valor calculado a partir de una ecuacin de rendimiento durante un determinado
perodo de tiempo.
Sintaxis
PIAdvCalcExpVal(Expression, STime, ETime, Mode, CalcBasis, SampMode, SampFreq,
MinPctGood, CFactor, OutCode, RootPath)
137
Referencia de funcin
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
138
Cadena
Referencia de funcin
Ejemplo
=PIAdvCalcExpVal("'cdf144'+'cdt158'","y","t","total","timeweighted","compressed","10m",50,1,4,)
Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcExpFilVal()
Devuelve un valor filtrado de PI point calculado en funcin de una ecuacin de rendimiento.
Sintaxis
PIAdvCalcExpFilVal(Expression, STime, ETime, FiltExp, Mode, CalcBasis, SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
FiltExp
Cadena
Mode
Cadena
139
Referencia de funcin
Argumento
Tipo
Descripcin
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcExpFilVal("'cdf144'+'cdt158'","y","t","'productid'=
"Product2"","total","time-weighted","compressed","10m",50,1,4,)
Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
140
Referencia de funcin
PIAdvCalcDat()
Recupera valores espaciados regularmente calculados a partir de valores de PI point o de
atributo de PI AF durante un determinado periodo de tiempo.
Sintaxis
PIAdvCalcDat(DataItem, STime, ETime, Interval, Mode, CalcBasis, MinPctGood,
CFactor, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
141
Referencia de funcin
Ejemplo
=PIAdvCalcDat("cdf144","y","t","3h","total","time-weighted",50, 1,4,)
Devuelve el total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores
del PI Server predeterminado en intervalos de tres horas desde la medianoche de ayer a la
medianoche de hoy.
La funcin multiplica el resultado por 1 y slo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha de
cada total calculado.
Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcFilDat()
Recupera un valores espaciados regularmente calculados a partir de valores filtrados de PI
point o de atributo de PI AF durante un determinado periodo de tiempo.
Sintaxis
PIAdvCalcFilDat(DataItem, STime, ETime, Interval, FiltExp, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
142
Argumento
Tipo
Descripcin
DataItem
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
FiltExp
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcFilDat("cdf144","y","t","3h","'cdm158'=""Manual""", "total","timeweighted","compressed","10m",50,1,4,)
Devuelve el total de tiempo ponderado para el PI point cdf144 calculado a partir de los valores
del PI Server predeterminado en intervalos de tres horas desde la medianoche de ayer a la
medianoche de hoy cuando el PI point cdf144 se ha establecido como Manual.
La funcin multiplica el resultado por 1. Dado que el modo de muestreo es compressed, la
funcin ignora el intervalo de muestreo y realiza un muestreo de la expresin de filtro en los
eventos comprimidos de cdf144. La funcin solo devuelve un resultado si al menos un 50 por
ciento de los datos son correctos. La funcin devuelve el porcentaje correcto a la derecha del
total calculado.
143
Referencia de funcin
Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcExpDat()
Devuelve valores espaciados regularmente calculados a partir de una ecuacin de rendimiento
durante un determinado perodo de tiempo.
Sintaxis
PIAdvCalcExpDat(Expression, STime, ETime, Interval, Mode, CalcBasis,SampMode,
SampFreq, MinPctGood, CFactor, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
144
Referencia de funcin
Argumento
Tipo
Descripcin
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcExpDat("'cdf144'+'cdt158'","y","t","3h","total", "timeweighted","compressed", "10m",50,1,4,)
Consulte tambin
Funcin Datos calculados
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PIAdvCalcExpFilDat()
Devuelve valores espaciados regularmente calculados a partir de una ecuacin de rendimiento
filtrada durante un determinado perodo de tiempo.
Sintaxis
PIAdvCalcExpFilDat(Expression, STime, ETime, Interval, FiltExp, Mode, CalcBasis,
SampMode, SampFreq, MinPctGood, CFactor, OutCode, RootPath)
145
Referencia de funcin
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
Interval
Cadena
FiltExp
Cadena
Mode
Cadena
CalcBasis
Cadena
El mtodo de clculo:
ponderado a tiempo
ponderado a evento
SampMode
Cadena
146
SampFreq
Cadena
MinPctGood
Nmero
CFactor
Nmero
Referencia de funcin
Argumento
Tipo
Descripcin
OutCode
Integer
RootPath
Cadena
Ejemplo
=PIAdvCalcExpFilDat("'cdf144'+'cdt158'","y","t","3h","'productid'="Product2"","tot
al","time-weighted","compressed","10m",50,1,4,)
Consulte tambin
Funcin Datos calculados
Expresiones de filtro
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PITimeFilter()
Devuelve la cantidad de tiempo durante el que una ecuacin de rendimiento se evala como
verdadera a lo largo de intervalos iguales de un determinado periodo de tiempo especificado.
Sintaxis
PITimeFilter(Expression, STime, ETime, Interval, TimeUnit, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
Cadena
ETime
Cadena
147
Referencia de funcin
Argumento
Tipo
Descripcin
Interval
Cadena
TimeUnit
Cadena
OutCode
Integer
RootPath
Cadena
Ejemplo
=PITimeFilter($A$1,"y","t","1h","seconds",65,"thevax")
Consulte tambin
Funcin Filtrado de tiempo
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
PITimeFilterVal()
Devuelve la cantidad de tiempo durante el que una ecuacin de rendimiento se evala como
verdadera a lo largo de un determinado periodo de tiempo.
Sintaxis
PITimeFilterVal(Expression, STime, ETime, TimeUnit, OutCode, RootPath)
Argumentos
Argumento
Tipo
Descripcin
Expression
Cadena
STime
148
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
ETime
Cadena
TimeUnit
Cadena
OutCode
Integer
RootPath
Cadena
Ejemplo
=PITimeFilterVal($A$1,"y","t","seconds",0,"thevax")
Consulte tambin
Funcin Filtrado de tiempo
Definir funciones manualmente
Pautas para introducir argumentos de forma manual
Funciones de tags
Las funciones le ayudan a trabajar con PI points.
En esta seccin
PIPointIDToTag()
PIAttributeMaskToTag ()
PIPointIDToTag()
Devuelve el nombre del PI point correspondiente a un ID de PI point especfico.
Sintaxis
PIPointIDToTag(PointID, PIServer)
Argumentos
Argumento
Tipo
Descripcin
PointID
Cadena
149
Referencia de funcin
Argumento
Tipo
Descripcin
PIServer
Cadena
Ejemplo
=PIPointIDToTag("123","thevax")
Busca el PI Server denominado thevax para el ID de punto 123 y devuelve el nombre de dicho
punto (el atributo Tag).
Consulte tambin
Funcin Apuntar ID al Tag
PIAttributeMaskToTag ()
Obtiene los nombres de PI Points que coinciden con uno o ms de los valores de atributos de PI
point especificados.
Sintaxis
PIAttributeMaskToTag(TagName, Descriptor, PointSource, PointType, PointClass,
EngUnits, OutCode, PIServer)
Argumentos
Argumento
Tipo
Descripcin
TagName
Cadena
Descriptor
Cadena
PointSource
Cadena
PointType
Cadena
PointClass
Cadena
EngUnits
Cadena
OutCode
Integer
PIServer
Cadena
1 Utilice el carcter comodn (*) para encontrar todas las coincidencias o las coincidencias limitadas a
determinados caracteres.
Ejemplo
=PIAttributeMaskToTag("sin*","*","*","*","*","*",0,"thevax")
La siguiente funcin devuelve los tags que empiezan por sin del PI Server denominado
thevax.
150
Referencia de funcin
Consulte tambin
Funcin Mscara de atributo para tag
PIAliasToTag()
Devuelve el nombre del PI point correspondiente a un determinado alias de PI.
Sintaxis
PIAliasToTag(Alias, ModulePath, QueryDate, OutCode, PIServer)
Argumentos
Argumento
Tipo
Descripcin
Alias
Cadena
ModulePath
Cadena
QueryDate
Integer
OutCode
Integer
PIServer
Cadena
Ejemplo
=PIAliasToTag("Temperature","\Unit1\Reactor1","*",0,"thevax")
Consulte tambin
Funcin Alias para tag
151
Referencia de funcin
PIPropertyToValue()
Devuelve el valor o valores correspondientes a una propiedad de PI especificada.
Sintaxis
PIPropertyToValue(Property, ModulePath, QueryDate, PIServer, OutCode)
Argumentos
Argumento
Tipo
Descripcin
Propiedad
Cadena
ModulePath
Cadena
QueryDate
Integer
PIServer
Cadena
OutCode
Integer
Ejemplo
=PIPropertyToValue("Implementer","\Unit1\Reactor1","*","thevax")
Consulte tambin
Funcin Propiedad para valor
Funciones de entrada
PIPutVal() y PIPutValX()
Escribe un valor en PI Server o el servidor de PI AF y devuelve una cadena que indica el estado.
Sintaxis
PIPutVal(DataItem, Value, TimeStamp, RootPath, OutCell)
PIPutValX(DataItem, Value, TimeStamp, RootPath, OutCell)
Argumentos
152
Argumento
Tipo
Descripcin
DataItem
Cadena
Referencia de funcin
Argumento
Tipo
Descripcin
Valor
Referencia
TimeStamp
Cadena
RootPath
Cadena
OutCell
Referencia
Notas
Las funciones PIPutVal y PIPutValX no pueden escribir en atributos de PI AF que sean
atributos de configuracin. Estas funciones slo pueden escribir en un atributo PI AF para el
que no est seleccionada la casilla Elemento de configuracin. Puede comprobar el estado de la
casilla en la pestaa Atributos de PI System Explorer.
Las funciones PIPutVal y PIPutValX admiten todos los tipos de datos de PI Server. Las
funciones interpretan las marcas de tiempo utilizando la informacin de la zona horaria del
ordenador cliente de PI Server a menos que se haya activado la opcin Utilizar zona horaria de
PI Server.
Las funciones no verifican el intervalo especificado por el usuario para un punto antes de
escribir el valor. El intervalo se define desde zero a zero + span, donde zero y span son atributos
de punto especificados durante la creacin del punto. La funcin devuelve una cadena Value
Written aunque Over Range o Under Range estn almacenados en PI Server.
Ejemplo
=PIPutVal("testtag",a5,"t",,e5)
153
Referencia de funcin
154
Resolucin de problemas
Consulte los temas incluidos en esta seccin si tiene alguna dificultad con el uso de PIDataLink.
Si estos temas no explican o resuelven el problema, consulte Soporte tcnico y otros recursos
para obtener ms detalles sobre cmo ponerse en contacto con el Servicio de asistencia tcnica.
En esta seccin
Archivos de registro
La pestaa PI DataLink no est disponible
Lmites de matriz y de celda
Lmites de recuperacin de datos
Elemento de datos no admitido por funcin
Existe un evento duplicado
Seguridad
Problemas de conexin de PI Server
Eliminar error de excepcin de tiempo de espera
Los datos no se actualizan
Archivos de registro
PI DataLink no genera un archivo de registro genrico. Puede utilizar los mensajes de error de
las hojas de clculo para diagnosticar problemas. Sin embargo, algunos procesos especficos no
generan archivos de registro:
Instalacin
El directorio ../pipc/dat contiene los archivos de registro de instalacin
SetupPIDataLink_x64.log y SetupPIDataLink_x86.log.
Conectividad de PI Server
Examine el archivo de registro de PI Server en PI SMT para detectar problemas de
conectividad de PI Server.
155
Resolucin de problemas
156
Resolucin de problemas
Para obtener ms informacin, consulte Aadir atributos de eventos secundarios como
columnas en el panel de tareas Comparar eventos.
Seguridad
Las funciones de seguridad de Excel para los complementos, los controles de ActiveX y las
macros controlan los tipos de componentes que se pueden ejecutar en Excel. Los parmetros
de seguridad proporcionan los medios para desactivar, activar bajo demanda o activar
completamente estos tipos de objetos.
Los parmetros de seguridad de Excel pueden entrar en conflicto con algunas funciones de PI
DataLink:
PI DataLink es un complemento para Excel. La configuracin de seguridad que desactiva los
complementos impide que PI DataLink se cargue en Excel
Las tendencias utilizan un control ActiveX firmado marcado como seguro para su
inicializacin y requieren que se activen los controles ActiveX.
Las hojas de clculo que contienen una funcin PIPutVal() o PIPutValX () utilizan
macros y requieren que estn activadas (consulte PIPutVal() y PIPutValX()).
Si aplica con regularidad la seguridad de Excel a las hojas de clculo, o encuentra problemas
utilizando estas funciones de PI DataLink, deber reducir o eliminar la configuracin de
seguridad de Excel dependiendo de cmo prevea utilizar PI DataLink.
Para ms informacin sobre la seguridad de Excel, consulte los recursos y la ayuda en lnea de
Microsoft Excel.
157
Resolucin de problemas
Este es el segundo mejor enfoque. Consulte el manual Configuring PI Server Security para
obtener informacin sobre la creacin de PI trusts. Para utilizar PI trusts, deber activar
tambin el protocolo de autenticacin de PI Trust en cada ordenador en el que se ejecute PI
DataLink.
Configurar cada ordenador para permitir una solicitud de inicio de sesin explcita cuando
no estn disponibles una PI mapping o un PI trust.
OSIsoft no recomienda este enfoque. Los inicios de sesin explcitos no son seguros.
Nota:
La introduccin de una contrasea incorrecta en una solicitud de inicio de sesin puede
generar el mismo mensaje de error.
En esta seccin
Configurar un ordenador para permitir solicitudes de inicio de sesin explcitas
Activar un protocolo de autenticacin
Procedimiento
1. Haga clic en Inicio > Todos los programas > PI System > PISDKUtility para abrir PI SDK
Utility.
2. En PI-SDK, haga clic en Conexiones para mostrar los PI Servers disponibles y actualizar los
mens de utilidades.
3. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexin.
4. Seleccione la casilla Solicitar inicio de sesin (si fallan protocolos configurados).
5. Haga clic en Aceptar.
Resultados
Se le solicitar el nombre de usuario y la contrasea cada vez que inicie una conexin nueva a
PI Server.
158
Resolucin de problemas
Procedimiento
1. Haga clic en Inicio > Todos los programas > PI System > PISDKUtility para abrir PI SDK
Utility.
2. En PI-SDK, haga clic en Conexiones para mostrar los PI Servers disponibles y actualizar los
mens de utilidades.
3. Haga clic en Conexiones > Opciones para abrir la ventana Opciones de conexin.
4. En Especificar procedimiento de autenticacin, utilice las teclas de fecha para mover y
ordenar los protocolos activados en Orden de protocolos. Liste los protocolos necesarios:
Para utilizar PI mappings, Windows Security debe estar en la lista. Debe ser el primer
protocolo en la lista Orden de protocolos.
Para utilizar PI trusts, PI Trust debe estar en la lista.
5. Haga clic en Aceptar.
Procedimiento
1. En la pestaa PI DataLink, en el grupo Recursos, haga clic en Configuracin para abrir el
cuadro de dilogo Configuracin.
2. Haga clic en Gestor de conexiones para abrir el cuadro de dilogo Servidores.
3. Haga clic con el botn derecho en el PI Server que ha devuelto el error y, a continuacin,
haga clic en Propiedades para abrir el cuadro de dilogo Propiedades de PI Server.
4. Incremente el valor del campo Tiempo de espera de datos y, a continuacin, haga clic en
Aceptar.
159
Resolucin de problemas
160
161
162