ES PI DataLink User Guide

Manual del usuario de PI DataLinkVersin 3.1 2006-12

1992-2007 OSIsoft, Inc. Reservados todos los derechos

OSIsoft, Inc.777 Davis St., Suite 250 San Leandro, CA 94577 EE.UU. (01) 510-297-5800 (telfono principal) (01) 510-357-8136 (fax) (01) 510-297-5828 (telfono de soporte tcnico) [email protected] Houston, TX Johnson City, TN Mayfield Heights, OH Phoenix, AZ Savannah, GA Seattle, WA Yardley, PA

OSIsoft AustraliaPerth, Australia Auckland, Nueva Zelanda

OSI Software GmbHAltenstadt, Alemania

OSI Software Asia Pte Ltd.Singapur

OSIsoft Canada ULCMontreal, Canad

OSIsoft, Inc. Oficina representativaShanghai, Repblica Popular China

OSIsoft Japan KKTokio, Japn

OSIsoft Mexico S. De R.L. De C.V.Ciudad de Mxico, Mxico

Puntos de venta/DistribuidoresBrasil Oriente Medio/frica del Norte Repblica de Sudfrica Rusia/Asia central Amrica del Sur/Caribe Asia Suroriental Korea del Sur Taiwn

www.osisoft.comOSIsoft, Inc. es el propietario de las siguientes marcas comerciales y marcas comerciales registradas: PI System, PI ProcessBook, Sequencia, Sigmafine, gRecipe, sRecipe y RLINK. Todos los trminos mencionados en este manual que sean marcas comerciales o marcas de servicio irn en mayscula. Toda marca comercial que aparezca en este libro que no pertenezca a OSIsoft, Inc. es la propiedad de su propietario y su uso aqu no indica, bajo ningn concepto, una aprobacin, recomendacin o garanta de los productos de dicha parte o ningn tipo de afiliacin con la misma. LEYENDA DE DERECHOS LIMITADOS Su uso, rplica o difusin por parte del Gobierno est sujeto a las restricciones estipuladas en el subprrafo (c)(1)(ii) de la clusula de Derechos de los Datos Tcnicos y Software de Equipo en DFARS 252.227-7013

ContenidoCaptulo 1: Introduccin .............................................................................................................1 Contenido de PI DataLink..........................................................................................1 Requisitos del sistema...............................................................................................1 Instalacin..................................................................................................................3 Para el administrador de PI System ..........................................................................8 Captulo 2: Complemento para Excel......................................................................................15 Resumen..................................................................................................................15 Tutorial .....................................................................................................................16 Men PI....................................................................................................................23 Cuadros de dilogo..................................................................................................25 Tiempo en PI DataLink ............................................................................................28 Funciones de PI DataLink........................................................................................32 Detalles para las funciones y los cuadros de dilogo de PI DataLink.....................35 Escribir datos de Excel a PI.....................................................................................88 Lmites de Excel para PI DataLink ..........................................................................90 Captulo 3: Complemento para Lotus 1-2-3 ............................................................................91 Tutorial .....................................................................................................................91 Men PI..................................................................................................................101 Cuadros de dilogo................................................................................................103 Tiempo en PI DataLink ..........................................................................................108 Comandos de macro personalizados de PI DataLink ...........................................110 Detalles del cuadro de dilogo y la macro personalizada PI.................................111 Escribir datos de Lotus 1-2-3 a PI .........................................................................137 Limitaciones de PI DataLink para Lotus 1-2-3.......................................................140 Apndice A: Resolucin de problemas ...................................................................................141 El complemento de DataLink no se carga correctamente.....................................141 Problemas de conexin informados en los archivos de registro ...........................142 Apndice B: Sintaxis de expresiones......................................................................................147 Expresiones de clculo..........................................................................................147

Manual del usuario de PI DataLink

iii

Contenido

Expresiones de filtro ..............................................................................................150 Apndice C: Ejemplos de cadenas de tiempo PI....................................................................153 Hora de inicio y de finalizacin ..............................................................................153 Intervalo de tiempo ................................................................................................154 Apndice D: Argumentos de Setup.ini ....................................................................................155 Instalaciones silenciosas .......................................................................................155 Instalacin de PI SDK............................................................................................155 Instalacin de PI DataLink .....................................................................................156 Apndice E: Apndice F: Cdigos de salida ................................................................................................157 Soporte tcnico y recursos ................................................................................159 Opciones del soporte tcnico ................................................................................159 Antes de llamar o escribir solicitando ayuda .........................................................160 ndice ...........................................................................................................................................163

iv

Captulo 1: IntroduccinPI DataLink proporciona un enlace entre el servidor PI 3 o PI 2 de OSIsoft y los programas de hoja de clculo que se ejecutan en las plataformas Microsoft Windows. Con PI DataLink, un usuario que est ejecutando Microsoft Excel o Lotus 1-2-3 puede intercambiar informacin directamente con las bases de datos de PI System. Combinada con la funcionalidad de los programas de hoja de clculo, esta funcin convierte a PI DataLink en una herramienta potente y fcil de manejar para recopilar, analizar y comunicar datos PI.

Contenido de PI DataLinkPI DataLink est compuesto por los dos mdulos siguientes: Un complemento para Microsoft Excel Un complemento para Lotus 1-2-3 PI DataLink para Excel est creado con el producto PI SDK de OSIsoft. Permite que los usuarios que tengan experiencia con Microsoft Visual Basic para Aplicaciones (VBA) puedan desarrollar rutinas que abran las funciones PI SDK. PI DataLink para Lotus 1-2-3 est creado con el producto PI API de OSIsoft. Permite que los usuarios que tengan experiencia en el uso de la herramienta programacin 1-2-3 LotusScript puedan desarrollar rutinas de hojas de clculo de Lotus que abran las funciones PI API. Sin embargo, los usuarios que deseen desarrollar programas fuera de Excel o Lotus 1-2-3 deben adquirir una licencia para PI SDK o PI API diferente. Pngase en contacto con su representante de ventas de OSIsoft para obtener ms informacin.

Requisitos del sistemaPI DataLink se ejecuta en una aplicacin de hoja de clculo adecuada en un equipo cliente Microsoft Windows PC y recupera la informacin almacenada en un servidor PI a travs del software de red estndar.


1

Introduccin

Sistema operativo y software de redEl servidor PI se puede ejecutar en OpenVMS, Windows o UNIX. PI DataLink se comunica con el servidor PI a travs del protocolo TCP/IP. TCP/IP Para utilizar TCP/IP, es necesario uno de los siguientes sistemas operativos: Microsoft Windows 98, 2000, o XP Microsoft Windows NT, versin 4 SP6a Los usuarios de Microsoft Windows deben utilizar la capa TCP/IP creada en el sistema operativo. TCP/IP en OpenVMS Si el servidor PI se ejecuta en OpenVMS, en el equipo VMS ser necesario uno de los siguientes paquetes de software TCP/IP: Servicios DEC TCP/IP para OpenVMS, versin 2.0+ Software de proceso TCPWare, versin 3.1+ Cisco MultiNet, versin 3.4+ Attachmate Pathway, versin de ejecucin 1.1+

Programas de hoja de clculo compatiblesPI DataLink es compatible con los siguientes programas de hoja de datos (slo versiones de 32 bits): Microsoft Excel 2000, versin 9.0 y posterior. Lotus 1-2-3 versin 9.5 (incluida como parte de Lotus SmartSuite Millennium) y posterior.

2

Instalacin

InstalacinNota: Antes de la instalacin, cada usuario de PI DataLink debe disponer de la licencia para utilizar este producto. Para obtener ms informacin, pngase en contacto con el personal de ventas de OSIsoft.

El usuario puede instalar PI DataLink desde el CD de distribucin, ya sea localmente en un equipo o globalmente en un servidor de archivos de red. Esto ltimo lo suele llevar a cabo un administrador del sistema. Una vez que PI DataLink se haya instalado correctamente en un servidor de archivos de red, otros usuarios podrn instalar una versin independiente completa o una versin compartida de PI DataLink desde la unidad de red a un equipo local. La instalacin de una versin independiente crea una copia de los archivos de PI DataLink en el equipo local del usuario. En una instalacin de la versin compartida, los principales archivos PI DataLink permanecen en el servidor de archivos de red y los usuarios ejecutan los archivos de programa desde el servidor.

Instalacin en un servidor de archivos de redEsta opcin est ideada como un procedimiento nico para un administrador del sistema. Esta instalacin por s sola no permite que se pueda ejecutar PI DataLink. Por lo tanto, los usuarios individuales deben instalar una versin independiente o una versin compartida de PI DataLink. La instalacin en un servidor de archivos de red se realizar en un equipo local. A continuacin se resume el procedimiento para la instalacin en un servidor de archivos de red: 1. Ejecute AdminSetup.exe desde el CD de distribucin en el servidor de archivos de red. 2. Seleccione el directorio de destino (por ejemplo: C:\APPS\). El programa de instalacin crear los subdirectorios EXCEL, DAT, LIBRARY, LOTUS y SETUP en C:\APPS\PIPC. 3. Para las instalaciones compartidas, edite la seccin [COMMANDLINES] de setup.ini en el directorio SETUP: 6 = SHARED="P:\APPS\PIPC"


3

Introduccin

donde P: es la letra de unidad que todos los equipos locales especifican para indicar la unidad C: del servidor de archivos de red. Consulte Setup.ini Arguments (consulte "Argumentos de Setup.ini" en la pgina 155) para obtener ms argumentos. 4. Para crear una lista de servidores PI, realice una instalacin compartida en un equipo que disponga de derechos de escritura en el directorio P:\APPS\PIPC\DAT. Aada servidores PI como lo hara normalmente. Todos los cambios que se efecten se propagarn al resto de instalaciones compartidas. Las notas de la versin actual se encuentran en C:\APPS\PIPC\readme_datalink.txt. Las notas de la versin de las versiones anteriores se encuentran en C:\APPS\PIPC\readme_dl.txt.

Instalacin en un equipo local (independiente y compartida)Para poder utilizar PI DataLink, cada usuario debe instalar un versin independiente completa o una versin compartida. La instalacin de una versin idependiente se puede llevar a cabo desde el CD de distribucin o desde la unidad de red. La instalacin de una versin compartida nicamente se puede realizar desde la unidad de red. A continuacin se resume el procedimiento para la instalacin en un equipo local: 1. Ejecute el archivo setup.exe del CD de distribucin o del directorio de instalacin de la unidad de red (por ejemplo, P:\APPS\PIPC\SETUP\setup.exe). 2. Seleccione el directorio de destino. Las notas de la versin se encuentran en P:\APPS\PIPC\readme_datalink.txt. Las notas de las versiones anteriores se encuentran en P:\APPS\PIPC\readme_dl.txt.

Configuracin de Microsoft ExcelSi PI DataLink se va a utilizar con Microsoft Excel y se trata de la primera instalacin (no una actualizacin) de PI DataLink, tendr que aadir PI DataLink. 1. Inicie Excel. 2. Abra el administrador de complementos de Excel a travs de Herramientas > Complementos.

4

Instalacin

3. Busque y seleccione el archivo PIPC32.XLL. Para una instalacin local, el archivo PIPC32.xll se encontrar en el directorio ...\PIPC\EXCEL. Para una instalacin compartida de PI DataLink, acuda al directorio ...\PIPC\EXCEL de la unidad de red. Si PI DataLink se actualiza y se coloca en un directorio diferente al de las versiones anteriores, el administrador de complementos de Excel se deber utilizar en primer lugar para eliminar el anterior archivo PIPC32.XLL. A continuacin, se debe seleccionar el nuevo archivo PIPC32.XLL en la nueva ubicacin. Usuarios fuera de EE.UU. Para configurar el formato de nmero y de hora para fuera de EE.UU., lleve a cabo los siguientes pasos en Microsoft Excel despus de haber instalado DataLink: 1. En el men PI, haga clic en Ajustes. Se mostrar el siguiente cuadro de dilogo:

2. Modifique las entradas de Formato de nmero y Formato de hora para que reflejen el equivalente a "General" y "dd-mmm-yy hh:mm:ss" de su pas respectivamente. Las entradas para los campos de formato de nmero y de hora pueden ser cualquier cdigo de formato vlido de Excel de Formato, Celdas, Nmero, Personalizar.


5

Introduccin

Por ejemplo, en Alemania los equivalentes de "General" y "dd-mmm-yyyy hh:mm" son "Standard" y "TT-MM-JJJJ hh:mm" respectivamente.

6

Instalacin

Configuracin de Lotus 1-2-3Para configurar PI DataLink para que funcione con Lotus 1-2-3: 1. Inicie Lotus 1-2-3.2.

En el men principal, vaya a: Archivo > Complementos > Administrar complementos... en el directorio ...\lotus\addins y haga clic en Abrir.

3.

4. Compruebe el espacio situado delante de la ruta de archivo de pidl.12a y haga clic en Listo. 5. Salga de Lotus 1-2-3 y vuelva a iniciarlo. El men PI-DataLink deber estar disponible ahora. PI DataLink para Lotus 1-2-3 no es compatible con instalaciones compartidas. PI DataLink para 1-2-3 se debe instalar independientemente en cada equipo (estas instalaciones se pueden llevar a cabo desde una instalacin de red central).rar en el cuadro de dilogo Administrar complementos. 6. Seleccione pidl.12aHaga clic en Regist


7

Introduccin

Nuevas funciones para usuarios de Microsoft ExcelEn el archivo ...\PIPC\readme_datalink.txt encontrar una lista con las nuevas funciones que se incluyen en esta versin de PI DataLink.

Nuevas funciones para Lotus 1-2-3En el archivo ...\PIPC\readme_datalink.txt encontrar una lista con las nuevas funciones que se incluyen en esta versin de PI DataLink.

Correccin de erroresEn el archivo ...\PIPC\readme_datalink.txt encontrar una lista de los problemas conocidos que se han corregido en esta versin de PI DataLink.

Para el administrador de PI SystemServidor PI 2

Servicio de servidor PI Si PI DataLink se comunica con el servidor PI a travs del TCP/IP, el administrador de PI System debe llevar a cabo una configuracin nica del servicio de servidor PI. Este servicio de servidor PI lo utiliza no slo PI DataLink, sino tambin todas las aplicaciones cliente del equipo OSIsoft. Consulte el archivo PIBuild:PIServer.txt del equipo VAX/Alpha. Archivo de seguridad El servicio del servidor PI admite una combinacin de autentificacin de nodo y seguridad de nombre de usuario/contrasea para aplicaciones cliente del equipo. El archivo de acceso del servidor PI, PISysDat:PIServer.Dat, determina qu mquinas tienen acceso a los datos PI. Si no existe este archivo, se debe crear. Para la seguridad de la autentificacin de nodos, aada entradas para determinadas mquinas. Por ejemplo:

8

Para el administrador de PI System

[USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=R PINET1=RW PINET2=RW PC1=RW PC2=NONE

Las entradas anteriores de PISysDat:PIServer.Dat tienen como resultado lo siguiente: 1. Las mquinas denominadas "PINET1" y "PINET2" disponen de acceso de lectura y escritura incondicional a los datos PI. Este nivel de acceso se debe proporcionar a los nodos PINet. 2. La mquina denominada "PC1" tambin dispone de acceso de lectura y escritura incondicional a los datos PI. Este nivel de seguridad implica que cualquier persona que tenga acceso al propio "PC1" dispondr de acceso de lectura y escritura incondicional a los datos PI a travs de PI DataLink. 3. El equipo denominado "PC2" no tiene acceso a los datos PI. Este nivel de seguridad implica que nadie puede utilizar PI DataLink en "PC2" para recuperar datos en hojas de clculos. 4. El resto de equipos disponen de acceso de lectura incondicionales a los datos PI. Este nivel de seguridad implica que todos los usuarios de estas mquinas podrn obtener datos de PI, pero no escribirlos en l, con PI DataLink. 5. Para la seguridad de nombre de usuario/contrasea, aada la letra L despus del tipo de acceso: [USERDATABASE] DEFAULT=PI [CLIENTACCESS] DEFAULT=RL PINET1=RW PINET2=RW PC1=RLWL PC2=NONE Este PIServer.Dat es el mismo que el del ejemplo anterior, excepto en dos casos: La mquina denominada "PC1" dispone de acceso de lectura y escritura condicional. Este nivel de seguridad implica que slo el usuario con el nombre de usuario y contrasea adecuados puede leer y escribir en "PC1" a travs de PI DataLink. El resto de equipos disponen de acceso condicional a los datos PI. Este nivel de seguridad implica que los usuarios deben proporcionar un nombre de usuario PI y una contrasea vlidos para acceder a los datos PI y ningn usuario puede escribir de nuevo los datos en PI.

Recuerde que los nombres del nodo TCP/IP distinguen entre maysculas y minsculas. Adems, los valores de las entradas de la seccin CLIENTACCESS (es decir, R y W) tambin distinguen entre maysculas y minsculas. Para que la seguridad del nodo o del nombre de usuario/contrasea funcione correctamente, es esencial que el servidor PI pueda determinar el nombre del equipo cliente en el que se est ejecutando PI DataLink. Las siguientes secciones proporcionan informacin especfica para DECNet y los TCP/IP de los diversos proveedores.


9

Introduccin

Traduccin de nombre - UCX (o TCPIP para VMS 7.2+) En Servicios DEC TCP/IP para VMS, el servidor PI 2 solicita a UCX que le proporcione el nombre de host de una determinada conexin PI DataLink. A su vez, UCX consulta a la base de datos de host UCX de VAX/Alpha o del servidor de nombres de dominio (si est configurado). Para confirmar que UCX est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:$ ucx show device /port=545

Deber ver el nombre de host remoto incluido bajo Remoto. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este nombre de host. Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host remoto, esto querr decir que UCX (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat. Para aadir una entrada en la tabla de host UCX para un equipo:$ ucx set host "mypc" /addr=192.168.100.77

Consulte su documentacin sobre UCX para obtener ms detalles. Traduccin de nombre - MultiNet En MultiNet, el servidor PI 2 le pide a MultiNet que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, MultiNet consulta a la base de datos de host MultiNet de VAX/Alpha o del servidor de nombres de dominio (si est configurado). Para confirmar que MultiNet est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:$ multinet show

Deber ver el nombre del host local, as como el nombre del host (del equipo) externo. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host externo, esto querr decir que MultiNet (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat. Para aadir una entrada en la tabla de host Multinet del VAX/Alpha para un equipo, debe editar el archivo MultiNet:Hosts.Local. Una vez editado, debe ejecutar los siguientes comandos:$ multinet host_table compile $ @multinet:install_databases

10


Consulte su documentacin sobre Multinet para obtener ms detalles. Traduccin de nombre - PathWay En PathWay, el servidor PI 2 le pide a PathWay que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, PathWay consulta a la base de datos de host de VAX/Alpha o del servidor de nombres de dominio (si est configurado). Para confirmar que PathWay est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:$ netstat

Deber ver el nombre del host local, as como el nombre del host (del equipo) externo. PISysDat:PIServer.Dat. controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host externo, esto querr decir que PathWay (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat. Para aadir una entrada en la tabla de host PathWay de VAX para un equipo, debe editar el archivo twg$etc:Hosts. Para obtener ms detalles, consulte su documentacin de PathWay. Traduccin de nombre - TCPWare En TCPWare, el servidor PI 2 le pide a TCPWare que le suministre el nombre de host de una determinada conexin PI DataLink. A su vez, TCPWare consulta a la base de datos de host de VAX/AlphaAXP o del servidor de nombres de dominio (si est configurado). Para confirmar que TCPWare est determinando el nombre del equipo correctamente, introduzca lo siguiente de DCL una vez que PI DataLink se haya conectado al servidor PI 2:$ netcu show connections /host_names

Deber ver el nombre del host local, as como el nombre del host (del equipo) remoto. PISysDat:PIServer.Dat controla el nivel de acceso a los datos PI de este ltimo nombre de host. Si en su lugar observa un nmero (por ejemplo, 192.168.100.77) para el host remoto, esto querr decir que TCPWare (y por lo tanto el servidor PI 2) no puede determinar el nombre del equipo cliente. Por consiguiente, el servidor PI 2 utiliza el nivel de acceso DEFAULT en PISysDat:PIServer.Dat. Para aadir una entrada en la tabla de host TCPWare del VAX/Alpha para un equipo, debe editar el archivo TCPWare:Hosts. Puede que tenga que reiniciar TCPWare para que el cambio sea efectivo. Consulte su documentacin sobre TCPWare para obtener ms detalles.


11

Introduccin

Servidor PI 3

Base de datos de firewall La base de datos de firewall que se encuentre en la mquina en la que se est ejecutando el servidor PI 3 se debe configurar para que permita el acceso a los equipos en los que se est ejecutando PI DataLink. Por ejemplo,PIConfig> @table pi_gen,pifirewall PIConfig> @ostr hostmask,value PIConfig> @select hostmask=* PIconfig> @ends *.*.*.*, ALLOW

Esto indica que todos los equipos pueden conectarse al servidor PI 3.*.*.*.*, DISALLOW 192.168.100.*, ALLOW

Indica que slo est permitido que se conecten los equipos cuya direccin TCP/IP comience por 192.168.100. Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx) en "PI 3 Enterprise Server". Base de datos segura La base de datos segura que se encuentre en la mquina en la que se est ejecutando el servidor PI 3 se puede configurar para que permita el acceso, sin inicio de sesin explcito, a los equipos en los que se est ejecutando PI DataLink. Por ejemplo,PIconfig> @table pitrust PIconfig> @ostr trust,ipaddr,iphost,piuser PIconfig> @select trust=* PIconfig> @ends MyPCTrust,0.0.0.0,mypc,piadmin

Esto indica que cualquier aplicacin que se conecte al servidor PI 3 desde "mypc" obtendr privilegios piadmin de forma predeterminada. Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx) en "PI 3 Enterprise Server". Atributos de acceso de puntos/acceso de datos Cuando PI DataLink se conecta con PI 3 Server, le solicita al usuario un nombre de usuario y una contrasea. El nombre de usuario se utiliza junto con los campos PtOwner, PtAccess, DataOwner y DataAccess. Por ejemplo, si el tag SINUSOID se configura de forma que PtAccess sea O:RW, G:NONE, W:NONE y PtOwner sea USER1, los usuarios de PI DataLink deben iniciar la sesin como USER1 para poder ver este tag. De otro modo, no se podr encontrar el tag.

12


Tambin, si SINUSOID DataAccess es O:R, G:NONE, W:NONE y DataOwner es USER1, los usuarios de PI DataLink deben iniciar la sesin como USER1 para poder ver los datos de este tag. De lo contrario, aparecer un mensaje de error de acceso de lectura. No obstante, incluso al iniciar la sesin como USER1, en este caso no se permitir que PI DataLink escriba datos en SINUSOID puesto que el atributo de DataAccess es O:R (slo lectura). El administrador de PI System deber cambiar DataAccess a O:RW (lectura y escritura). nicamente cuando se haya realizado este cambio los usuarios de PI DataLink que inicien su sesin como USER1 podrn leer y escribir datos para SINUSOID. Para obtener ms informacin, consulte los manuales de usuario del servidor PI que se pueden descargar de http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx) en "PI 3 Enterprise Server".Nota: El usuario PIAdmin es un usuario superprivilegiado. Un usuario de PI DataLink que inicie la sesin como PIAdmin dispondr de acceso de lectura y escritura a todos los tags. Por este motivo, los usuarios de PI DataLink normalmente NO deberan iniciar la sesin como PIAdmin.


13

Captulo 2: Complemento para Excel

ResumenEl complemento PI DataLink para Excel proporciona a los usuarios de Microsoft Excel la capacidad de recuperar datos asociados con tags de un servidor PI directamente en una hoja de clculo. An ms, los usuarios pueden escribir valores de la hoja de clculo en PI. PI DataLink proporciona las siguientes funciones para recuperar datos de PI: Valor actual Valor en un momento determinado Atributos del tag Datos espaciados de forma uniforme (de muestra) Datos de muestra mientras una expresin determinada es verdadera Datos comprimidos (archivados) Datos comprimidos si una expresin determinada es verdadera Datos de muestra para una matriz de marcas de tiempo especificada por el usuario Datos de los clculos en las expresiones del tag PI Cantidad de tiempo mientras una expresin de tag PI era verdadera Totales, mnima, mxima, desviaciones estndar, rangos, promedios, recuentos y mtodos para tags y expresiones PI Nombre de tag de un identificador del punto especificado Nombres de tags de mscaras de atributos especificadas Valor de alias de una base de datos de mdulo Valor de propiedad de una base de datos de mdulo


15

Complemento para Excel

TutorialEl objetivo de este tutorial es iniciarle en el uso de PI DataLink en Excel lo ms rpido posible. Las funciones de PI DataLink no se desarrollan de forma detallada en este tutorial. En su lugar, servir para familiarizar al usuario con el funcionamiento general de este complemento.

Verificar comunicaciones con el servidor PIEn este primer ejemplo confirmaremos que PI DataLink se ha instalado adecuadamente y que se puede conectar con el servidor PI. Inicie Excel y asegrese de que la seleccin de men PI se encuentra en la barra de mens de Excel. Si PI no aparece en ella, tendr que utilizar el administrador de complementos de Excel. Consulte Configuracin de Microsoft Excel. Desde la barra de mens de PI, seleccione Conexiones....

Si el estado indica que el servidor PI no est conectado, haga clic en la casilla de verificacin para conectarlo. Si la cuenta de usuario predeterminada del servidor PI seleccionado requiere una contrasea, aparecer el cuadro de dilogo de inicio de sesin en el que se le solicitar la contrasea:

16

Tutorial

En este cuadro de dilogo tambin se puede modificar el nombre de usuario para el inicio de sesin y utilizar uno diferente al del usuario predeterminado. Un nombre de usuario/contrasea vlido modifica el cuadro de dilogo Estados en las conexiones y muestra el usuario con el que est conectado DataLink. Cierre el cuadro de dilogo de conexiones haciendo clic en Cancelar. Si aparece un cuadro de dilogo de fallo al iniciar la sesin, confirme que su nombre de usuario/contrasea PI sean vlidos. Si el cuadro de dilogo de fallo al iniciar la sesin aparece a pesar de que el nombre de usuario/contrasea PI son vlidos, quiere decir que PI DataLink no se puede conectar al servidor PI. Consulte la seccin Resolucin de problemas (en la pgina 141).

Atributos del tag y Valor actualEn este ejemplo obtendremos el descriptor del tag, el valor actual y las unidades de ingeniera para algunos tags. 1. Abra Excel. 2. En el men PI, seleccione Ajustes... y asegrese de que est seleccionado el botn de exclusin mtua En una columna de la seccin "Copiar elementos a la hoja". 3. A continuacin, cierre el cuadro de dilogo y site el cursor en la celda A2 de la hoja de clculo. 4. Seleccione Bsqueda de tags... en el men PI e introduzca "BA*" en el campo Mscara de tag.


17


5. Haga clic en Buscar para buscar los tags que comiencen con "BA". La lista Resultados de bsqueda debe contener al menos cinco tags: BA:ACTIVE.1, BA:CONC.1, BA:LEVEL.1, BA:PHASE.1 y BA:TEMP.1. 6. Seleccione estos cinco tags de la lista Resultados de bsqueda haciendo clic en el primer tag (BA:ACTIVE.1) y, manteniendo presionada a la vez la tecla CTRL, haciendo clic en cada uno de los otros cuatro tags. Luego haga clic en Aceptar para copiar los cinco tags en una nica columna, de A2 a A6. 7. Desplace el cursor a la celda B2. En el men PI, seleccione Atributos del tag... Haga clic en el cuadro de edicin de Nombre(s) de tag.

18

Tutorial

8. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6. 9. Escriba o seleccione "descriptor" en el cuadro desplegable bajo Atributo. 10. En el cuadro de dilogo, haga clic en Aceptar. PI DataLink recupera los descriptores del tag en las celdas B2 a B6. 11. Desplace el cursor a la celda C2. En el men PI, seleccione Valor actual.... Haga clic en el cuadro de edicin de Nombre de tag. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6. En el cuadro de dilogo, haga clic en el botn de exclusin mtua tiempo a la izquierda.


19


12. En el cuadro de dilogo, haga clic en Aceptar. PI DataLink recupera los valores actuales y sus marcas de tiempo en las columnas D y C respectivamente. 13. Site el cursor en la celda E2 de la hoja de clculo. En el men PI, seleccione Atributos del tag... de nuevo. Haga clic en el cuadro de edicin de Nombre(s) de tag. 14. Coloque el puntero del ratn sobre la celda A2 de la hoja de clculo. Haga clic y arrastre para seleccionar la referencia A2:A6. Seleccione engunits del cuadro de lista Atributo.

15. En el cuadro de dilogo, haga clic en Aceptar. A continuacin, PI DataLink recuperar unidades de ingeniera en las celdas E2 a E6.

Valores reales del servidor PIEn este ejemplo, recopilaremos datos de muestra para un solo tag. 1. Desplace el cursor a la celda C10. En el men PI, seleccione Datos de muestra.... Haga clic en el botn Bsqueda de tags. Aparecer el cuadro de dilogo Bsqueda de tags. 2. Introduzca "CD*" en el campo Mscara de tag. Haga clic en Buscar para buscar tags que comiencen con CD. Debera devolverse el tag "cdt158". Seleccione este tag y haga clic en Aceptar. 3. El tag cdt158 aparecer en el campo Nombre de tag del cuadro de dilogo Datos de muestra. Introduzca t (para medianoche de hoy) en el campo Hora de inicio, +8h (perodo de 8 horas desde la hora de inicio) en el campo Hora de finalizacin y 1h (intervalos de una hora) en el campo Intervalo de tiempo. Marque la casilla de verificacin mostrar marcas de tiempo.

20

Tutorial

4. Haga clic en Aceptar. PI DataLink recuperar los datos interpolados desde la medianoche hasta las 8:00 a.m. en intervalos de 1 hora.

Cambiar argumentos del cuadro de dilogoEn este ejemplo, modificaremos la hora de finalizacin utilizada en el ejemplo anterior.


21


1. Haga clic con el botn derecho del ratn sobre cualquier parte de la matriz creada en el ejemplo anterior. 2. Seleccione Datos de muestra...

3. Cambie la hora de finalizacin de "+8h" a "+9h" y haga clic en Aceptar. PI DataLink recuperar los datos interpolados desde la medianoche hasta las 09:00 a.m. en intervalos de 1 hora. Fjese en que el tamao de la matriz a aumentado en una fila.

Utilizar matrices antiguas como plantillasEn este ejemplo mostraremos cmo utilizar una matriz antigua como plantilla para un tag diferente. 1. Haga clic con el botn derecho del ratn sobre cualquier parte de la matriz creada en el ejemplo anterior. 2. Seleccione Datos de muestra...

22

Men PI

3. Modifique el campo de edicin del tag de "CDT158" a "SINUSOID". 4. Modifique la Celda de salida de $C$10 a $A$10 y haga clic en Aceptar. Fjese en que los datos de muestra para el tag "SINUSOID" se indican en A10.

Resumen de PI DataLinkTal y como indican los ejemplos anteriores, la forma ms rpida de utilizar PI DataLink para transferir datos entre PI y Excel es seleccionando una opcin del elemento de men PI. En ese caso aparecer un cuadro de dilogo. Introduzca los parmetros adecuados y PI DataLink recuperar los valores PI solicitados. Las siguientes secciones describen las funciones de PI DataLink con ms detalle.

Men PISi PI DataLink se aade a Excel, el elemento de men PI se aade a la barra de men de Excel.


23


En este elemeno de men se dispone de selecciones de men emergentes. stas son:Valor actual recupera el valor actual de un tag Valor de archivo histrico recupera un nico valor del archivo histrico (se puede

interpolar)Atributos del tag recupera un atributo del tag Datos comprimidos (hora de inicio/nmero) recupera datos comprimidos basndose en una

hora de inicio y en un nmero especificado de valores con una condicin de filtro opcionalDatos comprimidos (hora de inicio/de finalizacin) recupera datos comprimidos basndose

en una hora de inicio y en una hora de finalizacin con una condicin de filtro opcionalDatos de muestra recupera datos espaciados de forma uniforme (de muestra) del archivo

histrico con una opcin de filtro opcionalDatos temporizados recupera datos de muestra sincronizados con una matriz de marcas de

tiempoDatos calculados recupera totales, mnima, mxima, rangos, desviaciones estndar,

promedios y medias para mltiples perodos de tiempo

24

Cuadros de dilogo

Datos calculados avanzados es similar a datos calculados pero con ms opciones

avanzadas (esto es, evento ponderado)Filtrado de tiempo recupera la cantidad de tiempo durante la que una expresin de tag es

verdaderaIdentificador del punto para tag recupera un nombre de tag del identificador del punto

especificadoMscara de atributo para tag recupera nombres de tag de las mscaras de atributo

especificadasAlias recupera un nombre de tag de alias de la base de datos de mdulo Propiedad recupera un valor de propiedad de la base de datos de mdulo Insertar trend crea una trend que puede obtener datos directamente de PI o de la hoja de

clculoBsqueda de tags busca tags PI Module Database muestra el contenido de la base de datos de mdulo, como alias y

propiedadesConexiones gestiona las conexiones del servidor PI Ajustes muestra los ajustes y preferencias de PI DataLink Acerca de muestra la informacin de la versin PI DataLink Ayuda muestra la ayuda sobre PI DataLink

Cuadros de dilogoCampos de edicinLos campos de edicin pueden conterner la informacin de texto necesaria o referencias a las celdas que contengan la informacin de texto necesaria. PI DataLink determina el tipo de informacin introducida en el campo de edicin segn el contexto. De forma alternativa a la introduccin de la referencia de celda, tambin puede utilizar el ratn para hacer clic en el campo de edicin y luego en la celda (o hacer clic en la celda y arrastrar a las celdas adyacentes) de la hoja de clculo. En este procedimiento, Excel introduce automticamente las referencias de celdas en el campo de edicin.


25


Por ejemplo, en el siguiente cuadro de dilogo, los campos de edicin para Nombre de tag y Salida solicitan una celda de la hoja de clculo que contenga el nombre del tag y la celda de la hoja de clculo en la que desee colocar la salida del valor actual respectivamente.

Servidor PI y campos de salidaEl campo Servidor PI permite la seleccin de un servidor PI de la lista de servidores conocidos. En la lista desplegable, los servidores que se encuentran sobre la lnea de puntos son los servidores actualmente conectados y los que se encuentran por debajo de ella son los que actualmente estn desconectados. El campo Servidor PI de todos los cuadros de dilogo est etiquetado como opt. u opcional. Si el campo Servidor PI est en blanco, PI DataLink utilizar el servidor PI predeterminado. Puede modificar el servidor PI predeterminado en el cuadro de dilogo Conexiones... disponible en el men PI. El campo Salida le permite especificar la esquina superior izquierda del rango en el que PI DataLink colocar los datos resultantes.

Visualizar datos en columnas o filasPara los cuadros de dilogo que esperan devolver una matriz de valores PI (por ejemplo, Datos de muestra), existe un grupo de botones de exclusin mtua con las opciones columna(s) o fila(s). Seleccione columna(s) para visualizar los datos ya sea en una columna, en dos columnas si se mostrarn marcas de tiempo O porcentajes correctos, o en tres columnas si se mostrarn marcas de tiempo Y porcentajes correctos. Seleccione fila(s) para mostrar los datos en una, dos o tres filas.

26

Cuadros de dilogo

Para los cuadros de dilogo que esperan devolver un nico valor PI (p. ej., Valor actual), existe un grupo de botones de exclusin mtua con las opciones sin marca de tiempo, tiempo a la izquierda o tiempo en la parte superior. Seleccione tiempo a la izquierda para visualizar los datos en dos columnas. Seleccione tiempo en la parte superior para visualizar los datos en dos filas. Para los cuadros de dilogo que son compatibles con una matriz de tags, la orientacin de la matriz de tags sobrescribir su seleccin de fila/columna a la hora de determinar la orientacin de los datos de salida.

Cuadros de listaLos cuadros de lista aparecen para el campo Modo en Valor de archivo histrico..., para los campos Tipo en Datos comprimidos (nmero) y (horas)..., para los campos Modo en Datos calculados y Datos calculados avanzados..., y para los campos Unidad de tiempo en los cuadros de dilogo Filtrado de tiempo... El modo de recuperacin predeterminado de Valor de archivo... es interpolado, el tipo de lmite predeterminado de Datos comprimidos (nmero) y (horas)... es interior, el modo de clculo predeterminado de Datos calculados y Datos calculados avanzados... es total, el modo de muestreo de expresin de Datos calculados avanzados... es pto. comprimido, y la unidad de tiempo predeterminada para Filtrado de tiempo... es segundos.

Cuadro combinadoLos cuadros combinados aparecen para el campo Atributo en Atributos del tag.... El campo Clase de punto se rellena automticamente con todas las clases de punto disponibles para el servidor PI indicado. Siempre que se selecciona un nuevo servidor PI en el campo Servidor PI, el campo Clase de punto se rellena de nuevo. Siempre que se selecciona una clase de punto en el campo Clase de punto, el campo Atributo se rellena de nuevo. Si se introduce un tag vlido, su clase de punto se recuperar e introducir en el campo Clase de punto automticamente.

Buscar tags en los cuadros de dilogoEl botn , que se encuentra junto al campo de nombre de tag en los cuadros de dilogo, le permite buscar tags en la base de datos PI. Si hace clic en este botn, aparecer el cuadro de dilogo Bsqueda de tags. Si pulsa Aceptar en el cuadro de dilogo Bsqueda de tags, el primer nombre de tag seleccionado se copiar en el campo de edicin de nombre de tag. El nombre de servidor PI tambin se copiar en el campo de edicin Servidor PI si seleccion la casilla "Copiar nombre de servidor PI" en los ajustes de PI DataLink.


27


Tiempo en PI DataLinkValores devueltosLas marcas de tiempo devueltas por los cuadros de dilogo de PI DataLink se encuentran en formato Excel; es decir, el nmero representa el nmero de das desde 1900. Por ejemplo, 10-Dec-99 7:12pm se introduce en una celda con el nmero 36504.8. Sin embargo, PI DataLink formatea estas marcas de tiempo y las convierte en una cadena de tiempo PI; especficamente, dd-mmm-aa hh:mm:ss. Por ejemplo, 7:12 PM del 10 de diciembre de 1999 se muestra como 10-Dec-99 19:12:00. Puede cambiar este formato por otro seleccionando las celdas y, a continuacin, seleccionando Formato, Celdas, Nmero. Consulte su documentacin sobre Excel para obtener informacin sobre el formateo de nmeros como horas.

Formato de tiempo y nmero especificado por el usuarioSi no le gustan los cdigos de formato general y dd-mmm-aa hh:mm:ss para nmeros y horas respectivamente, puede especificar otro cdigo de formato de nmero y hora predeterminado en PI DataLink. Para ello, vaya al cuadro de dilogo PI > Configuracin...

28

Tiempo en PI DataLink

El formato de nmero "0.0" muestra los nmeros con un puesto decimal y el formato de hora "hh:mm:ss" muestra las marcas de tiempo como hora:minutos:segundos.

Introducir marcas de tiempo en PI DataLinkMuchos de los cuadros de dilogo solicitan una hora de inicio y una hora de finalizacin. En los campos de edicin, introduzca la cadena de tiempo PI que desee; por ejemplo 10-Dec-99 19:12. Recuerde que para la hora PI en el formato de tiempo relativo (por ejemplo, '-1d') la hora de referencia es diferente para la hora de inicio que para la hora de finalizacin. El reloj tiempo real actual es la hora de referencia para la traduccin de la hora relativa en el campo de hora de inicio. Sin embargo, la hora de inicio se utiliza como hora de referencia para la traduccin de la hora relativa en el campo de hora de finalizacin. Si desea utilizar referencias de celda, puede referirse tanto a las celdas que contienen una hora PI en formato de cadena (p. ej., '10-Dec-99 19:12) o a las celdas que contienen una hora Excel (por ejemplo, 36504.8, formateado en el estilo que desee). Recuerde que Excel almacena las horas como la cantidad de das desde 1900, pero las muestra segn Formato, Celdas, Nmero.


29


Para el campo de edicin de intervalo de tiempo, puede especificar un nmero seguido de una "h", una "m" o una "s" (para horas, minutos o segundos). Por ejemplo, para indicar un intervalo de tiempo de treinta y dos minutos introduzca 32m en el campo de edicin. Si desea utilizar referencias de celdas, nicamente podr referirse a las celdas que contengan una cadena de intervalo de hora PI vlida. Esto es, no puede hacer referencia a una celda que contenga una hora Excel (es decir, un nmero). Por ejemplo, para especificar un intervalo de 32 minutos, el campo de edicin de intervalo de tiempo debe hacer referncia a una celda que contenga la cadena 32m. Consulte Hora de inicio y de finalizacin (consulte "Ejemplos de cadenas de tiempo PI" en la pgina 153) e Intervalo de tiempo (en la pgina 154) para obtener ejemplos de cadenas de tiempo PI vlidas.

Casilla de verificacin Mostrar horaEn algunos cuadros de dilogo aparece la casilla de verificacin mostrar hora, cuya funcin PI generalmente devuelve una matriz de valores PI. Si selecciona esta casilla de verificacin, se devolvern las marcas de tiempo y los valores. Estas marcas de tiempo aparecen en la columna situada a la izquierda del todo, si se ha seleccionado el botn de exclusin mtua columna(s); y a lo largo de la fila superior si se seleccion fila(s). Si esta casilla no est seleccionada, PI DataLink no mostrar las marcas de tiempo. Si hace referencia a una matriz de tags en el cuadro de dilogo Datos de muestra o Datos calculados, PI DataLink devuelve un grupo comn de marcas de tiempo para todo el grupo de tags.

Colocar los datos de marca de tiempo devueltos por PI DataLinkAlgunos cuadros de dilogo que devuelven un valor nico (por ejemplo, Valor actual) disponen de botones de exclusin mtua que controlan el lugar en el que se muestran las marcas de tiempo. Seleccione sin marca de tiempo para suprimir la marca de tiempo. Seleccione tiempo a la izquierda para mostrar la marca de tiempo en una celda a la izquierda de los valores recuperados. Seleccione tiempo en la parte superior para mostrar la marca de tiempo en una celda sobre los valores recuperados.

30

Tiempo en PI DataLink

Nota: Cuando se especifica una referencia matricial en el campo Nombre de tag, los botones de exclusin mtua tiempo a la izquierda y tiempo en la parte superior producen el mismo resultado. En este caso, PI DataLink devuelve la marca de tiempo y el valor en funcin de si la referencia de nombres de tag es horizontal o vertical. Para los nombres de tag en una nica columna, las marcas de tiempo aparecern a la izquierda de los valores. Para los nombres de tag en una nica fila, las marcas de tiempo aparecern encima de los valores.

Datos de marca de tiempo para un intervalo o rango temporalAlgunos cuadros de dilogo que devuelven un nico valor a cada intervalo de tiempo (por ejemplo, Datos calculados) proporcionan casillas de verificacin que controlan qu marcas de tiempo se muestran. Si se especifica un intervalo de tiempo: Seleccione Hora de inicio para mostrar la hora de inicio del intervalo. Seleccione Hora de finalizacin para mostrar la hora de finalizacin del intervalo. Para las funciones de mnimo, mximo y rango: Seleccione Tiempo mn/mx para mostrar las marcas de tiempo para los valores mnimo y mximo del intervalo. Las marcas de tiempo se muestran segn la orientacin (por filas o por columnas) especificada. Por ejemplo, si la orientacin es por columnas y estn activadas todas las casillas de verificacin, el orden de las columnas de izquierda a derecha sera: hora de inicio, hora de finalizacin, la marca de tiempo del valor mnimo, la marca de tiempo del valor mximo. Si en el ejemplo anterior se desactiva la casilla de verificacin Hora de finalizacin, el orden de izquierda a derecha sera: hora de inicio, la marca de tiempo del valor mnimo, la marca de tiempo del valor mximo.


31


Funciones de PI DataLinkFunciones y valoresCuando un cuadro de dilogo PI DataLink transmite datos del servidor PI a Excel, no pone el valor real en una celda. En su lugar, PI DataLink pega una funcin PI personalizada en la celda. Por ejemplo, cuando se abre el cuadro de dilogo Valor actual y se introduce SINUSOID en el campo Nombre de tag, PI DataLink pega la siguiente funcin en la celda:=PICurrVal("sinusoid",0,)

Excel evala entonces esta funcin y muestra el nmero resultante. De este modo, los cuadros de dilogo PI DataLink son aplicaciones para el usuario que sirven para construir las funciones PI DataLink correspondientes y formatear el resultado. Estas funciones PI DataLink tambin se pueden introducir manualmente en las celdas de una hoja de clculo. Los argumentos de la funcin se describen ms detalladamente en Detalles para las funciones y los cuadros de dilogo PI DataLink (consulte "Detalles para las funciones y los cuadros de dilogo de PI DataLink" en la pgina 35). Debido a que la mayora de las funciones PI DataLink devuelven ms de un elemento de datos, las funciones se deben introducir en Excel como funciones de matriz. Para obtener una explicacin ms detallada de cmo se utilizan las funciones de matriz, consulte la seccin Introducir funciones PI directamente en Excel ms adelante. Estas funciones PI DataLink slo se pueden utilizar en las celdas de una hoja de clculo. No obstante, no se pueden ejecutar en un procedimiento de Excel Visual Basic. Visual Basic no reconoce las funciones PI DataLink. La nica forma de invocar las funciones PI DataLink en VBA es formular la funcin como una cadena de texto y despus establecer la frmula de propiedad de matriz para un rango de celdas de esta cadena de texto. Es lo mismo que introducir manualmente las funciones PI en el rango de celdas indicado. De este modo, el cdigo VBA puede comprobar los valores de celda de los resultados de las funciones PI. Para ver un ejemplo acerca de la introduccin de funciones PI en una hoja de clculo utilizando VBA, consulte el mdulo putval_code en el archivo piexam32.xls distribuido con PI DataLink. La funcin de salida PIPutVal() de PI DataLink es una funcin para macros de Excel y no puede utilizarse directamente en las celdas de una hoja de clculo. PIPutVal() slo se puede utilizar en una hoja de macros de Excel 4.0 o ejecutar como una macro en VBA. En VBA, utilice el mtodo application.run para invocar las funciones para macros. Para ver un ejemplo acerca de cmo invocar la funcin para macros en VBA, consulte el mdulo putval_code module en el archivo piexam32.xls.

32

Funciones de PI DataLink

Informar sobre erroresPI DataLink est escrito en C++ y Visual Basic y utiliza tanto el SDK del sistema PI como el API de Microsoft Excel. Si se produce un error en el nivel PI SDK, PI DataLink muestra el error PI SDK en la celda. Por ejemplo, si intenta encontrar el valor actual para un tag que no existe, aparecer el mensaje "PIPoint no encontrado" en la celda de salida.

Actualizar los datos PI en una hoja de clculoHay dos formas de actualizar los datos en una hoja de clculo. Una forma es hacer clic con el botn derecho del ratn en la matriz y seleccionar la funcin Recalcular (cambiar de tamao). Este mtodo funciona mejor si se dispone de una matriz de tamao variable en la que el nmero de valores devueltos puede ser diferente segn el rango de valores recuperados. Si hay pocos valores, no hay problema. Sin embargo, si se recuperan ms valores, dichos valores no se mostrarn a menos que se seleccione la funcin Recalcular. La segunda forma es realizar un cambio en los argumentos transmitidos a las funciones PI DataLink. Debido a que PI DataLink recupera datos del servidor PI a travs de las funciones, los valores de la hoja de clculo slo se actualizan cuando se cambia un argumento de funcin. Pulsar F9 en Excel no obliga a las funciones PI DataLink a obtener nuevos datos del servidor PI. La nica excepcin es la funcin Valor actual, que se actualiza siempre que Excel realiza un nuevo clculo. Esto se hizo de forma intencionada, ya que la mayora de las funciones DataLink no muestran los datos modificados cronolgicamente. No obstante, para evitar esto, Ctrl+Alt+Shift+F9 hace que todas las funciones DataLink se recalculen. La mejor forma de crear una hoja de clculo que se actualice con la mnima intervencin del usuario es utilizar algunas funciones de tiempo dinmicas de Excel como ahora() u hoy() para generar una marca temporal, p. ej. utilice (hoy()+1/3) para las 8:00 a.m. de hoy. A continuacin, consulte esta celda en el argumento de hora de inicio o de hora de finalizacin de la consulta de DataLink. Siempre que Excel recalcule (bien porque el usuario haya presionado F9 o haya cambiado alguna celda de la hoja de clculo), Excel actualizar las funciones de tiempo dinmicas, haciendo que se ejecute la funcin PI DataLink. Observe que el valor de la marca de tiempo no tiene que cambiar para que Excel desencadene la funcin PI DataLink. Siempre que se utilice la funcin de tiempo dinmico de Excel para construir la marca de tiempo y sta se utilice a su vez en el argumento de DataLink, Excel desencadenar la funcin DataLink cuando se recalcule la hoja de clculo.

Cambiar argumentos utilizando cuadros de dilogoSi es necesario cambiar un argumento, haga clic con el botn derecho del ratn en cualquier parte de la matriz y seleccione la funcin PI DataLink. Aparecer un cuadro de dilogo con todos los campos de edicin rellenados con los argumentos que previamente se haban


33


especificado para dicha matriz. Se puede modificar cualquiera de los campos de edicin y la nueva matriz reflejar dichos cambios. Si el campo de edicin de salida se modifica, existen dos comportamientos diferentes en funcin de la nueva celda a la que se haga referencia. Si la nueva celda a la que se hace referencia forma parte de la matriz original, toda la matriz se desplaza, con la celda superior a la izquierda de la matriz, a la nueva celda. Si la nueva celda a la que se hace referencia no forma parte de la matriz original, la matriz se pega, con la celda superior a la izquierda de la matriz, en la nueva celda.

Seleccionar una funcin DataLink completaSi es necesario copiar, mover o eliminar una gran matriz de funciones PI DataLink, la forma ms fcil es hacer clic con el botn derecho del ratn en cualquier parte de la matriz y seleccionar Seleccionar frmula de DataLink. A continuacin, realice la funcin deseada. Toda la matriz de funciones Excel se debe mover o eliminar, de lo contrario aparecer el error "No puede modificar parte de una matriz".

Introducir funciones PI directamente en Excel

Valores de matriz Todas las funciones PI DataLink, excepto PIPutVal(), devuelven valores matriciales. En este caso, primero debe seleccionar el rango de salida matricial apropiado. A continuacin, introduzca la funcin PI y sus argumentos en la barra de frmulas de Excel. Por ltimo, coloque la funcin PI en las celdas con la combinacin de teclas CTRL+SHIFT+ENTER. Para obtener ms informacin acerca de las funciones matriciales, consulte la ayuda en lnea de Microsoft Excel. Tenga en cuenta tambin que el Asistente para funciones de Excel slo insertar la funcin en una celda de la hoja de clculo. Por lo tanto, no es muy recomendable utilizar el asistente de funciones para introducir funciones PI en Excel. Cdigo de salida El argumento de cdigo de salida es un nmero entero que controla si se devuelven o no las marcas de tiempo y si las celdas de salida se orientan por filas o columnas. Por ejemplo, un cdigo de salida 0 en PICurrVal() produce el valor snapshot en la celda nica. Un cdigo de salida 1 coloca el tiempo de snapshot en la columna uno y el valor snapshot en la columna dos de una matriz de 1 x 2. Un cdigo de salida 2 coloca el tiempo de snapshot en la fila uno y el valor snapshot en la fila dos de una matriz de 1 x 2. Para saber el significado de su cdigo de salida, consulte la descripcin detallada de cada funcin PI individual. En general, si se especifica un rango de salida matricial mayor que el nmero de

34

Detalles para las funciones y los cuadros de dilogo de PI DataLink

valores devueltos de la funcin, las celdas adicionales se mostrarn como celdas vacas aunque tengan una frmula embebida. Argumentos de cadena Los argumentos de cadena de las funciones tienen que estar entre comillas dobles. Por ejemplo, seleccione una matriz de salida de 1 x 2 e introduzca:=PICurrVal("sinusoid", 1, "casaba")

para recuperar el tiempo y el valor snapshot del tag sinusoid desde el servidor PI "casaba". Utilizar referencias de celda en argumentos Puede utilizar referencias de celda para todos los argumentos de las funciones PI DataLink. Por ejemplo, la siguiente funcin:=PICurrVal(A1, A2, A3)

produce el mismo resultado que el ejemplo anterior cuando se almacenan los tres argumentos en las celdas A1, A2 y A3 respectivamente. Argumento de PIServer El argumento de PIServer es opcional. El PIServer predeterminado se puede cambiar en el cuadro de dilogo Conexiones. Si desea utilizar el servidor predeterminado, puede omitir el argumento de PIServer. Por ejemplo, para recuperar el valor actual para el tag sinusoid del servidor PI predeterminado, introduzca:=PICurrVal("sinusoid",0,)

en un rango de salida de 1x1.

Detalles para las funciones y los cuadros de dilogo de PI DataLinkLas siguientes secciones describen cada una de las funciones de PI DataLink con ms detalle. Cada seccin describe primero el cuadro de dilogo y, a continuacin, discute cada argumento de la correspondiente funcin (o funciones) PI personalizada.

Cuadro de dilogo Valor actualEste cuadro de dilogo obtiene el valor Snapshot actual de un tag PI.


35


Campo obligatorioNombre de tag. La referencia a un nombre de tag puede ser una matriz.

Notas especialesEsta funcin se actualiza siempre que Excel calcula o recalcula cualquier celda de la hoja de clculo. Para forzar un reclculo inmediato, pulse la tecla F9. PICurrVal() PICurrVal(tagname, outcode, PIServer)

ArgumentosArgumento Tagname (cadena) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea el valor snapshot (actual). Un cdigo de salida; 0, 1 o 2. El servidor PI.

DevolucionesCdigo de salida 0 1 Columna 1 Valor actual Marcas de tiempo Valor actual Columna 2

Un cdigo de salida 2 transpone la matriz de salida que resulta de un cdigo de salida 1.

EjemploLa siguiente frmula recupera el valor actual y la marca de tiempo correspondiente para el tag let439 del servidor PI "holden":=PICurrVal("let439",1,"holden")

36


Cuadro de dilogo Valor de archivo histricoEste cuadro de dilogo obtiene un valor a una hora especificada. Hay cinco modos de seleccin:Previous (Anterior) - Recupera el valor del archivo histrico en el momento o antes de la

marca de tiempo especificada.Previous only (Solo anterior) - Recupera el valor del archivo histrico slo antes de la

marca de tiempo especificada.Interpolated (Interpolado) - Interpola el valor en la marca de tiempo especificada, excepto

para los 4 tags de cdigo de resolucin del servidor PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso, el valor anterior simplemente se reenva.Auto - Igual que Interpolado, excepto para los 4 tags de cdigo de resolucin del servidor

PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso, se devuelve el valor en el momento o antes de la marca de tiempo especificada.Next (Posterior) - Recupera el valor del archivo histrico en el momento o despus de la

marca de tiempo especificada.Next only (Solo posterior) - Recupera el valor del archivo histrico slo despus de la

marca de tiempo especificada.Exact Time (Tiempo exacto) - Recupera el valor del archivo histrico en un tiempo especificado si existe una entrada en dicho tiempo. Si no existe ningn valor, se devuelve el mensaje "No se han encontrado eventos".

Campos obligatoriosNombre de tag o expresin Marca de tiempo Consulte tambin PIArcVal() (en la pgina 37) PIExpVal() (en la pgina 38) PIArcVal() PIArcVal(tagname, timestamp, outcode, PIServer, mode)


37


ArgumentosArgumento tagname (cadena) time stamp (cadena) outcode (entero) PIServer (cadena) mode (cadena) Explicacin El tag para el cual desea el valor de archivo histrico. La marca de tiempo PI. Un cdigo de salida; 0, 1 o 2. El servidor PI. El modo de recuperacin.

DevolucionesCdigo de salida 0 1 Columna 1 Valor de archivo histrico Marca de tiempo Valor de archivo histrico Columna 2


EjemploLa siguiente frmula recupera un valor interpolado para el tag cdep158 a las 7:20 pm del 11 de diciembre de 1992 del servidor PI "casaba":=PIArcVal("cdep158","11-dec-92 19:20",0, "casaba","interpolated")

PIExpVal() PIExpVal(expression, timestamp, PIServer) ArgumentosArgumento expression (cadena) time stamp (cadena) PIServer (cadena) Explicacin La cadena para la que desea el valor de archivo histrico. La marca de tiempo PI. El servidor PI.

38


DevolucionesCdigo de salida 0 1 Columna 1 Valor de archivo histrico Marca de tiempo Valor de archivo histrico Columna 2


EjemploLa siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI denominado THEVAX en la medianoche de ayer:=PIExpVal("sqr('sinusoid')","y","thevax")

Cuadro de dilogo Atributos del tagEste cuadro de dilogo recupera un atributo de punto para un tag determinado.

Campos obligatoriosNombre de tag Atributo de tag Para PI3, la lista de atributos de tag depende de la clase de punto seleccionada. Para obtener una lista completa de los atributos de tag, consulte los atributos incluidos en el cuadro combinado o la descripcin de atributos para cada clase de punto en los manuales del usuario del servidor PI, disponibles en http://techsupport.osisoft.com/downloadcenter.aspx (http://techsupport.osisoft.com/downloadcenter.aspx), bajo "PI 3 Enterprise Server". Para PI 2, seleccione un atributo de tag del cuadro combinado. El atributo predeterminado es descriptor. Los atributos de tag son:Atributo Descriptor Exdesc typicalvalue Units Zero Explicacin Descriptor de tag de 26 caracteres. Descriptor extendido de tag de 80 caracteres. Valor tpico. Cadena de unidades de ingeniera. Cero.


39


Atributo Span digstartcode dignumber pointtype pointsource location1 location2 location3 location4 location5 filtercode squareroot scan excdev excmin excmax archiving compressing Res compdev compmin compmax totalcode convers displaydigits instrumenttag sourcept taglong tagshort creator createdate changer changedate pointnumber

Explicacin Rango. Cdigo para la primera cadena de estado digital del tag. Nmero de estados digitales menos 1. Carcter de tipo de punto. Carcter de origen de punto. Parmetro de ubicacin 1. Parmetro de ubicacin 2. Parmetro de ubicacin 3. Parmetro de ubicacin 4. Parmetro de ubicacin 5. Cdigo de filtro. Flag de raz cuadrada. Flag de exploracin. Desviacin por excepcin en porcentaje de rango. Tiempo mnimo de excepcin en segundos. Tiempo mximo de excepcin en segundos. Flag de archivado histrico. Flag de compresin. Cdigo de resolucin. Desviacin de compresin en porcentaje de rango. Tiempo mnimo de compresin en segundos. Tiempo mximo de compresin en segundos. Cdigo de totalizacin. Factor de conversin para puntos postprocesados. Controla el formato de los valores numricos en pantallas PI basadas en terminales. Nombre de tag para un valor en otro sistema, lo utilizan algunas interfaces. Nombre de tag para la salida a otro sistema, lo utilizan algunas interfaces. Nombre de tag largo (hasta 80 caracteres). Nombre de tag de 12 caracteres. Creador del tag. Fecha de creacin del tag. Usuario que modific los atributos del tag. Fecha de modificacin del tag. Nmero de identificacin reutilizado al eliminar un punto.

40


Atributo pointid

Explicacin Nmero de identificacin interno nico que no se reutiliza al eliminar un punto.

PITagAtt() (en la pgina 41) PITagAtt()PITagAtt(tagname, attribute, PIServer)

ArgumentosArgumento tagname (cadena) attribute (cadena) PIServer (cadena) Explicacin El tag para el cual desea un atributo. El atributo del tag, consulte la lista en Cuadro de dilogo Atributos del tag (en la pgina 39). El servidor PI.

Devoluciones Atributo de tag

EjemploLa siguiente frmula recupera del servidor PI predeterminado las unidades de ingeniera para el tag situado en la celda D1:=PITagAtt(d1,"units",)

Cuadro de dilogo Datos comprimidos (hora de inicio/nmero)Este cuadro de dilogo devuelve valores comprimidos del servidor PI basndose en una hora de inicio y en un nmero especificado de puntos de datos. Si no se especifica una expresin de filtro, se ejecuta la funcin PINCompDat(). De lo contrario, se abre la funcin PINCompFilDat().

Campos obligatoriosNombre de tag Hora de inicio


41


Nmero de puntos de datos

Expresin de filtroSi se especifica una expresin de filtro, el nmero de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se ha seleccionado la opcin de marcar como filtrado, para cada grupo de valores que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

Tipo de lmiteExisten 4 tipos de lmites: Inside (Dentro) (predeterminado): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido el valor de la hora de inicio si existe un valor. Outside (Fuera): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido un punto de datos a la hora de inicio o anterior a ella. Interpolated (Interpolado): devuelve un nmero especificado de puntos de datos de una hora de inicio, incluido un punto de datos interpolado a la hora de inicio. Auto: igual que el lmite interpolado, excepto si el cdigo de resolucin para tags en el servidor PI 2 o atributo de paso est ajustado en el servidor PI 3, el comportamiento es el mismo que el de "dentro".

Casillas de verificacinSeleccione atrs en el tiempo si desea recopilar datos del archivo histrico retrocediendo a partir del momento que se introdujo en Hora de inicio. Seleccione mostrar bits si desea mostrar el estado extendido de los bits asociados con los eventos devueltos. Seleccione mostrar anotaciones si desea mostrar las anotaciones asociadas con los eventos devueltos.

Notas especialesEste cuadro de dilogo devuelve cadenas vacas si existe un nmero menor de valores que el nmero que se especific. Por ejemplo, si desea recuperar 400 valores, comenzando por la

42


medianoche de hoy, y slo existen 356 valores (incluidos los eventos filtrados), las 44 celdas finales incluirn cadenas en blanco. Si introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que los nombres de tag en las expresiones de filtro se cierran con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionadosExpresiones de filtro (en la pgina 150) PINCompDat() (en la pgina 43) PINCompFilDat() (en la pgina 44) PINCompDat()PINCompDat(tagname, stime, numvals, outcode, PIServer)

ArgumentosArgumento tagname (cadena) stime (cadena) numvals (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Devoluciones Cdigos de salida


43


EjemploLa siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes marcas de tiempo para el tag cdf144 , comenzando por 1:00 a.m. de esta maana del servidor PI predeterminado con el tipo de lmite Dentro:=PINCompDat("cdf144","1:00",10,1,,"inside")

PINCompFilDat()PINCompFilDat(tagname, stime, numvals, filtexp, filtcode, outcode, PIServer)

ArgumentosArgumento tagname (cadena) stime (cadena) numvals (entero) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. El nmero de puntos de datos comprimidos. Utilice un nmero negativo para recopilar datos del archivo histrico que retrocede desde stime. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Devoluciones Consulte Cdigos de salida.

EjemploLa siguiente frmula recupera 10 puntos de datos comprimidos y las horas correspondientes, comenzando a las 2:00 a.m. para el tag cdf144 mientras el tag cdep158 es superior a 38:=PINCompFilDat("cdf144","2:00",10,"'cdep158'>38",1,1,,)

El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos se recuperan del servidor PI predeterminado con el tipo de lmite Dentro.

44


Cuadro de dilogo Datos comprimidos (hora de inicio/hora de finalizacin)Este cuadro de dilogo devuelve valores comprimidos del servidor PI basndose en una hora de inicio y una hora de finalizacin. The number of data points retrieved for the given time period is returned in the first cell. Si no se especifica una expresin de filtro, se ejecuta la funcin PICompDat(). De lo contrario, se abre la funcin PICompFilDat().

Campos obligatoriosNombre de tag Hora de inicio Hora de finalizacin

Expresin de filtroSi se especifica una expresin de filtro, el rango de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se ha seleccionado la opcin marcar como filtrado, para cada grupo de valores que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

Tipo de lmiteExisten 4 tipos de lmites: Inside (Dentro) (predeterminado): devuelve puntos de datos a la hora de inicio y de finalizacin y entre ellas. Outside (Fuera): devuelve puntos de datos entre la hora de inicio y la hora de finalizacin, incluido un punto de datos a la hora de inicio, o anterior a ella, y un punto de datos a la hora de finalizacin, o anterior a ella. Interpolated (Interpolado): devuelve puntos de datos entre la hora de inicio y la hora de finalizacin, incluido un punto de datos interpolado a la hora de inicio y un punto de datos interpolado a la hora de finalizacin. Auto: igual que el lmite interpolado, excepto si el cdigo de resolucin para tags en el servidor PI 2 o atributo de paso est ajustado en el servidor PI 3, el comportamiento es el mismo que el de "dentro".


45


Casillas de verificacinSeleccione cuenta oculta si no desea mostrar la cantidad de eventos de datos recuperados del archivo histrico. Seleccione mostrar bits si desea mostrar el estado extendido de los bits asociados con los eventos devueltos. Seleccione mostrar anotaciones si desea mostrar las anotaciones asociadas con los eventos devueltos.

Notas especialesEste cuadro de dilogo devuelve cadenas en blanco en las celdas de salida no utilizadas si existe un nmero menor de valores en el archivo que el especificado originariamente por la matriz de salida. Esta situacin se puede producir si utiliza referencias de tiempo relativas. Por ejemplo, si recupera valores que comiencen de y a y+5h, el nmero de valores del servidor PI puede ser diferente al abrir la hoja de clculo en das diferentes. Si introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que los nombres de tag en las expresiones de filtro se cierran con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionadosExpresiones de filtro (en la pgina 150) PICompDat() (en la pgina 46) PICompFilDat() (en la pgina 47) PICompDat()PICompDat(tagname, stime, etime, outcode, PIServer)

ArgumentosArgumento tagname (cadena) Explicacin El tag para el cual desea datos comprimidos.

46


Argumento stime (cadena) etime (cadena) outcode (entero) PIServer (cadena)

Explicacin La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.

Devoluciones Consulte Cdigos de salida.

EjemploLa siguiente frmula recupera 10 puntos de datos comprimidos y las correspondientes marcas de tiempo para el tag cdf144, comenzando desde 1:00 a.m. a 3:00 a.m. de esta maana del servidor PI predeterminado con el tipo de lmite Dentro:=PICompDat("cdf144","1:00","3:00",1,,"inside")

PICompFilDat()PICompFilDat(tagname, stime, etime, filtexp, filtcode, outcode, PIServer)

ArgumentosArgumento tagname (cadena) stime (cadena) etime (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos comprimidos. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida. Para obtener ms informacin sobre los cdigos de salida, consulte Cdigos de salida. El servidor PI.


47


Devoluciones Consulte Cdigos de salida. Ejemplo La siguiente frmula recupera puntos de datos comprimidos y las horas correspondientes, comenzando desde las 2:00 a.m. y finalizando a las 10:00 a.m. para el tag cdf144 si el tag cdep158 es superior a 38:=PICompFilDat("cdf144","2:00","10:00","'cdep158'>38",1,1,,)

El estado Filtrado se muestra para las horas si la condicin del filtro es falsa. Los datos se recuperan del servidor PI predeterminado con el tipo de lmite Dentro.

Cuadro de dilogo Datos de muestraEste cuadro de dilogo recopila datos espaciados de forma uniforme, valores de muestra del archivo histrico. Si no se especifica una expresin de filtro, se ejecuta la funcin PISampDat(). De lo contrario, se abre la funcin PISampFilDat().

Campos obligatoriosNombre de tag Hora de inicio Hora de finalizacin Intervalo de tiempo

Expresin de filtroSi se especifica una expresin de filtro, el rango de valores comprimidos especificado se recupera del servidor PI mientras una determinada expresin de filtro sea verdadera. Si se selecciona la opcin marcar como filtrado, se devuelve un estado "Filtrado" para cada conjunto continuo (bloque) de valores de muestra que no satisfaga la expresin de filtro si el tag se encuentra en un servidor PI 3. Si el tag proviene de un servidor PI 2, para cada valor de muestra que no satisfaga la expresin de filtro se devolver el estado "Filtrado". Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150).

48


Notas especialesSi introduce la expresin de filtro en una celda de la hoja de clculo y hace referencia a ella en el cuadro de dilogo, asegrese de comenzar la expresin con una comilla simple para que Excel la interprete como una cadena. Puesto que el nombre de tag en las expresiones de filtro se debe cerrar con comillas simples, si la expresin de filtro comienza con un nombre de tag y va a almacenarla en una celda o en la hoja de clculo, deber iniciar dicha expresin con dos comillas simples.

Temas relacionadosExpresiones de filtro (en la pgina 150) PISampDat() (en la pgina 49) PISampFilDat() (en la pgina 50) PIExpDat() (en la pgina 51) PISampDat()PISampDat(tagname, stime, etime, interval, outcode, PIServer)

ArgumentosArgumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

DevolucionesCdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2


49


Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1. Ejemplo La siguiente frmula recupera datos de muestra para el tag ubicado en la celda B1, desde la medianoche de ayer hasta la medianoche de hoy en intervalos de 3 horas:=PISampDat(b1,"y","t","3h",1,)

Tambin se devuelven marcas de tiempo. PISampFilDat()PISampFilDat(tagname, stime, etime, interval, filtexp, filtcode, outcode, PI Server)

ArgumentosArgumento tagname (cadena) stime (cadena) etime (cadena) interval (cadena) filtexp (cadena) filtcode (entero) outcode (entero) PIServer (cadena) Explicacin El tag para el cual desea datos de muestra. La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. La expresin de filtro. Para obtener ms informacin sobre la sintaxis de la expresin de filtro, consulte Expresiones de filtro (en la pgina 150). Un cdigo de filtro, utilice 1 para devolver el estado Filtrado y 0 para omitirlo. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

DevolucionesCdigo de salida 0 1 Columna 1 Datos de muestra Marcas de tiempo Datos de muestra Columna 2

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 y el cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1.

50


Ejemplo La siguiente frmula recupera datos de muestra para SINUSOID en 11-Ene-97, 11-Ene-97 1:00AM, 11-Ene-97 2:00AM y 11-Ene-97 3:00AM:=PISampFilDat("sinusoid","11-Jan-97","+3h","1h",A1,1,1,)

Las marcas de tiempo se muestran en columna 1 y los valores en columna 2. Para los valores que no satisfacen la condicin de filtro en la celda A1 se devuelve el estado "Filtrado". PIExpDat()PIExpDat(expression, stime, etime, interval, outcode, PIServer)

ArgumentosArgumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). La hora de inicio en formato de hora PI. La hora de finalizacin en formato de hora PI. El intervalo de tiempo en formato de hora PI. Un cdigo de salida; 0, 1, 2 3. El servidor PI.

stime (cadena) etime (cadena) interval (cadena) outcode (entero) PIServer (cadena)

DevolucionesCdigo de salida 0 1 Columna 1 Datos calculados Marcas de tiempo Datos calculados Columna 2

Un cdigo de salida 2 transpone la matriz de salida resultante de un cdigo de salida 0 mientras que un cdigo de salida 3 transpone la matriz de salida resultante de un cdigo de salida 1. Ejemplo La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid del servidor PI denominado THEVAX en intervalos de una hora, comenzando por la medianoche de ayer hasta la medianoche de hoy:=PIExpDat("sqr('sinusoid')","y","t","1h",1,"thevax")

Tambin muestra las marcas de tiempo.


51


Cuadro de dilogo Datos temporizadosEste cuadro de dilogo devuelve valores de muestra de un solo tag que estn sincronizados con una matriz de marcas de tiempo. Existen dos modos de seleccin: Interpolated (Interpolado): interpola valores en las marcas de tiempo especificadas, excepto para los 4 tags de cdigo de resolucin del servidor PI 2 y los tags con atributos de paso establecidos en el servidor PI 3. En este caso especial, el valor anterior simplemente se reenva. Exact Time (Tiempo exacto): recupera el valor del archivo histrico para una hora especificada si existe una entrada en dicha hora. Si no existe ningn valor, se devuelve el mensaje "No se han encontrado eventos".

Campos obligatoriosNombre de tag Marca de tiempo. El campo de marca de tiempo tiene que ser una referencia de una matriz de tiempo. Para PI 2, las marcas de tiempo de esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes.

Temas relacionadosPITimeDat() (en la pgina 52) PITimeExpDat() (en la pgina 53) PITimeDat() PITimeDat(tagname, timestamps, PIServer, mode) ArgumentosArgumento tagname (cadena) timestamps (referencia) Explicacin El tag para el cual desea datos de muestra. Una referencia a una matriz de horas en formato PI. Para PI 2, los valores en esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. El servidor PI. El modo de recuperacin.

PIServer (cadena) mode (cadena)

52


Devoluciones Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos se devuelven en una sola fila. Ejemplo La siguiente frmula recupera datos temporizados interpolados para las horas ubicadas en las celdas B1 a B12 para el tag mytag del servidor PI predeterminado:=PITimeDat("mytag",b1:b12,,"interpolated")

PITimeExpDat()PITimeExpDat(expression, timestamps, PIServer)

ArgumentosArgumento expression (cadena) Explicacin La expresin de clculo. Para obtener ms informacin sobre la sintaxis de la expresin de clculo, consulte Expresiones de clculo (en la pgina 147). Una referencia a una matriz de horas en formato PI. Para PI 2, los valores en esta matriz de tiempo deben ser monotnicamente crecientes o monotnicamente decrecientes. El servidor PI.

timestamps (referencia)

PIServer (cadena)

Devoluciones Datos de muestra. Si las marcas de tiempo estn en una sola columna, los datos se devuelven en una sola columna. Si las marcas de tiempo estn en una sola fila, los datos se devuelven en una sola fila. Ejemplo La siguiente frmula calcula la raz cuadrada del valor del tag sinusoid para las horas ubicadas en las celdas B1 a B12 del servidor PI predeterminado:=PITimeExpDat("sqr('sinusoid')",b1:b12,)

Cuadro de dilogo Datos calculadosEste cuadro de dilogo devuelve un nico valor calculado o valores calculados espaciados de forma uniforme del archivo de datos PI. Los modos de clculo son:


53


Total Minimum (Mnimo) Maximum (Mximo) Standard deviation (Desviacin estndar) Range (Rango) Average (Promedio) Count (Cuenta) Mean (Media) Todos los modos de clculo son de tiempo ponderado, excepto la funcin principal que es de evento ponderado.

Campos obligatoriosNombre de tag Hora de inicio Hora de finalizacin Factor de conversin Modo de clculo

IntervaloPara recuperar un nico valor calculado, no especifique un intervalo y utilice la funcin PICalcVal(). Para recuperar un dato calculado espaciado de forma uniforme, el intervalo especificado determina el espaciado del clculo y se utiliza la funcin PICalcDat().

Casilla de verificacinCompruebe mostrar pctgood si desea que PI DataLink muestre el porcentaje del rango de tiempo que contiene un valor correcto. Le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El valor de porcentaje correcto se suele devolver a la derecha de la celda de valor calculado. Si selecciona la casilla de verificacin filas, el valor de porcentaje correcto se devuelve a la celda situada debajo de la celda de valor calculado.

54


Las marcas de tiempo se devuelven cuando el modo de clculo es mnimo, mximo o rango.Modo Mnimo Mximo Rango Columna 1 Tiempo del valor mn. Tiempo del valor mx. Tiempo del valor mn. Columna 2 Valor mnimo Valor mximo Tiempo del valor mx. Valor de rango Columna 3

Notas especialesSi no se especifica un intervalo y el modo es Total, Desviacin estndar, Promedio, Cuenda o Media, no se mostrarn las marcas de tiempo, aunque se haya seleccionado la casilla de verificacin Mostrar marcas de tiempo. Si se especifica un intervalo y el modo es Mx o Mn, las marcas de tiempo mostradas son la hora de inicio de cada intervalo de clculo. Cuando el modo de clculo es Total de tiempo ponderado y parte de los datos archivados en el rango son incorrectos, el valor informado es igual al valor total calculado dividido por la fraccin del perodo de tiempo con datos archivados correctos. Esta normalizacin de datos es equivalente a la suposicin de que para un rango de tiempo de datos incorrecto el valor del tag utiliza el valor promedio de todo el rango. Sin embargo, esta suposicin puede no ser vlida cuando una amplia fraccin del rango temporal contiene datos incorrectos. Por ello, le recomendamos que siempre se fije en el valor de porcentaje correcto antes de utilizar el resultado del clculo. El factor de conversin se utiliza ms a menudo cuando el modo de clculo es Total y la unidad de tiempo del tag PI que se totaliza no es la misma que la predeterminada del servidor. En todos los servidores PI 3 y en la mayora de los servidores PI 2, el valor predeterminado de totalizacin es "unidades por da". En el servidor PI 2, el tiempo de totalizacin predeterminado (totdefaulttime es la unidad de tiempo en segundos) se puede encontrar en el archivo pilink:piparams.for. La siguiente tabla muestra los factores de conversin para dos de las unidades de tiempo predeterminadas del servidor PI 2 comn frente a diversas unidades de tag de flujo.Unidad de tag de flujo Unidades/da Unidades/hora Unidades/minuto Unidades/segun do El valor predeterminado del servidor es unidades/da (totdefaulttime = 86400) 1.0 24 1440 86400 El valor predeterminado del servidor es unidades/hora (totdefaulttime = 3600) 0.041667 1 60 3600


55


Temas relacionadosPICalcVal() (en la pgina 56) PICalcDat() (en la pgina 57) PICalcVal()PICalcVal(tagname, stime, etime, mode, cfactor, outcode, PIServer)

ArgumentosArgumento tagname (cadena) stime (cadena) etime (cadena) mode (cadena) cfactor (nmero) Explicacin El tag para el cual desea el valor calculado. La hora de inicio en formato d

ES PI DataLink User Guide

Documents

Transcript of ES PI DataLink User Guide