Schneider Electric DMS NS

Herramienta de configuracin de
mapeo del Adaptador PI ADMS

Manual de usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

Tabla de Contenidos
1. HISTRICO DE REVISIONES ................................................................................... 1
2. OBJETIVOS ............................................................................................................... 2

3. ALCANCE .................................................................................................................. 3
4. DEFINICIONES Y ABREVIATURAS.......................................................................... 4

5. MAPEADO DE PUNTO .............................................................................................. 5

5.1. Herramienta de Configuracin de Mapeado .................................................. 5

5.2. Mapeado de calidad de cdigos de DMS ....................................................... 8

5.3. Mapeado de marcadores de seales de SCADA ........................................... 9

5.4. Archivar Calidad de las Medidas .................................................................. 11

5.5. Mapeo del Estado del Dispositivo ................................................................ 12

5.6. Importacin Masiva va CSV.......................................................................... 13

5.7. Configuracin de Deteccin de Cambios..................................................... 14
5.7.1. Mapeo de configuracin ...................................................................... 15
5.7.2. Mapeo de punto ................................................................................... 15
6. MANIPULACIN DE CAMBIOS EN EL MISMO SERVIDOR PI ............................. 16
7. PARMETROS ........................................................................................................ 17

7.1. Actualizar Frecuencia .................................................................................... 17

7.2. Fichero a Transferir (Troceado) .................................................................... 17

I Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

1. HISTRICO DE REVISIONES

Versin Autores Fecha Comentarios

0.1 Branislav Mirkov 11-feb-2015 Versin Inicial
<0.2> Murillo Lemgruber 30-Jun-2015 <Traduccin a Espaol>

1 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

2. OBJETIVOS

La finalidad de este documento es describir la herramienta de configuracin de mapeo

del adaptador PI DMS que se usa para la configuracin de datos a transferir desde el
servidor MSSQL histrico de DMS al servidor PI OSISoft.

2 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

3. ALCANCE

Este documento describe el punto de vista del usuario sobre la herramienta de

configuracin de mapeo del adaptador PI.

3 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

4. DEFINICIONES Y ABREVIATURAS

Definicin/Abreviatura Descripcin
Sistema Avanzado del Control de la Distribucin
ADMS
( Advance Distribution Management System)
HDL Librera de Datos Histricos
PI Servidor OSIsoft PI
Base de Datos Relacional
RDBMS
(Relational Data Base Management System)
Herramienta para mapear los objetos de histricos del
MCT
ADMS y del PI .(Mapping Configuration Tool)

4 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

5. MAPEADO DE PUNTO

Ya que el nombre del punto es identificador en el servidor PI y por convenios de

nomenclatura especficos, el nombre del punto de DMS normalmente difiere del nombre
del punto en servidor PI. Para encontrar nombres en el histrico de DMS a nombres de
puntos en el servidor PI se introduce una tabla nueva. Tiene GID y un modelo de cdigo
desde DMS y nombre de punto PI y Id de punto PI en el lado del servidor PI. No se
usarn todos pero proveen diferentes maneras de identificar puntos en el servidor PI.
Por ejemplo, Nombre de punto PI es un identificador, pero si API PI se usa para
manipulacin de datos dentro del servidor PI, se debe proveer la ID del punto PI porque
API PI no puede tratar con nombres PI.

5.1. Herramienta de Configuracin de Mapeado

Configurar el punto de mapeado significa encontrar puntos ADMS y puntos PI, se

introduce la herramienta de configuracin Modelo (MCT).

La herramienta de configuracin de mapeo (MCT) conecta el servidor PI y el servidor

MSSQL para recuperar informacin que se mostrar al usuario de la aplicacin y lo
capacita para crear mapeos. Ya que la informacin del MSQQL no es significativa para
el usuario de la aplicacin, MCT hace una solicitud adicional al servicio de tiempo real
del DMS para recuperar informacin adicional perteneciente a la informacin del
MSQLL. Esta informacin adicional son seales y nombres de dispositivos para
identificadores particulares desde el servidor MSSQL que solo se puede leer por el
software DMS.

5 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

Figura 1.Arquitectura MCT

Los prototipos de herramientas van seguidos de su descripcin.

6 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

Figura 2. Pantalla principal de prototipo de la herramienta de configuracin de mapeo.

La herramienta de configuracin de mapeo de punto est dividida en tres reas. La

primera rea, en la parte superior izquierda es un panel de bsqueda de puntos DMS.
Se provee al usuario con la habilidad de buscar objetos alimentadores o de subestacin.
Despus de pulsar el botn buscar, se listan debajo todos los alimentadores
(subestaciones) que cumplan el criterio de bsqueda. Si el objeto deseado est en la
lista, el usuario puede simplemente seleccionarlo o llevar a cabo una nueva bsqueda.
Cuando se selecciona el objeto, la parte derecha del rea izquierda se vuelve activa y el
usuario puede buscar objetos dentro del alimentador (subestacin) seleccionado. Luego
el usuario hace clic en criterios de bsqueda para objetos dentro de alimentador
(subestacin) y llevar a cabo una bsqueda adicional. Cuando el punto DMS deseado se
muestra en la lista de resultados, el usuario lo marca como seleccionado. Para llevar a
cabo este proceso, la herramienta necesita estar conectada al servicio de tiempo real de
DMS para recuperar informacin del punto.

Lo siguiente, es necesario encontrar el punto PI. Se puede hacer en la parte superior del
rea derecha de la ventana. Simplemente introduciendo parte del nombre del punto PI

7 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

se listan debajo todos los puntos que cumplan el criterio de bsqueda. El usuario marca
el punto PI deseado o lleva a cabo una nueva bsqueda si el punto deseado no est en
la lista. Para que esto resulte, la herramienta de configuracin de mapeo debe estar
conectada al servidor PI.
Cuando necesitamos buscar los puntos PI y DMS como mapeado, debemos pulsar el
botn de flecha verde hacia abajo, y el mapeado se guarda en Mapeado y se lista en la
tabla inferior. Los puntos PI y DMS que han sido mapeados, por ejemplo, se guardan en
la configuracin de mapeo que no se listar como parte de los resultados de bsqueda
en las reas superiores porque como ya han sido mapeados no se pueden volver a
mapear. Si el usuario comete un fallo o quiere cambiar algo del mapeo, puede
seleccionar una fila del mapeo en la tabla inferior y hacer clic en el botn de la flecha
verde hacia arriba. Esto eliminar el mapeado seleccionado y ambos puntos eliminados
DMS y PI estn de nuevo disponibles para una nueva bsqueda en reas superiores y
as buscarlos de nuevo como parte de creacin de un nuevo mapeado.
El mapeo entre puntos DMS y PI reside en la base de datos de series temporales de
ADMS en tablas separadas: MAPEADO_PUNTO_PI. Las especificaciones de tablas se
dan en Apndice A: Base de datos de referencia de tabla.

5.2. Mapeado de calidad de cdigos de DMS

Se introducir el mapeado entre cdigos de calidad de DMS y PI. La misma herramienta

que ha sido implementada para el mapeado de puntos est disponible para mantener el
mapeado de cdigos de calidad. El mapeado de cdigos de calidad reside en tablas
separadas en la base de datos de series temporales de ADMS:
MAPEADO_CALIDAD_PI. Las especificaciones de tabla se dan en: Apndice A: Base
de datos de referencia de tabla.
La calidad de DMS es un nmero entero que representa la combinacin de bits que se
ha establecido. Esto significa que si tenemos los bits 1 y 3 establecidos la calidad de
DMS ser igual a 5 porque 2 elevado a 0 cuando se aade 2 elevado a 2 nos da 1 ms
4 igual a 5.

8 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

Figura 3.Prototipo de herramienta de configuracin de mapeado de cdigo de calidad

5.3. Mapeado de marcadores de seales de SCADA

Se introducir el mapeado entre cdigos de calidad de DMS y PI. La misma herramienta

que ha sido implementada para el mapeado de puntos est disponible para mantener el
mapeado de cdigos de calidad. El mapeado de marcadores de seales de SCADA que
tambin es llamado como cdigos de calidad de SCADA reside en una tabla separada
en la base de datos series temporales: MAPEO_MARCADOR_SEAL_PI. Las
especificaciones de la tabla se dan en: Apndice A: base de datos de referencia de
tabla.

Esto es mapeo de bits. Significa que el primer bit es mapeado a algn bit en el servidor
PI. Hay dos opciones:

1. Mapeado del nmero de bits. Ejemplo: 1 bit es mapeado al 4 y el 4 al 1 .

2. Mapeado de caracteres. Cada bit de DMS se mapea a cualquier carcter
particular. Ejemplo: Alarma (1 bit) es mapeado a a. Cuando un bit particular es

9 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

establecido producir el mapeo del carcter a la serie resultante que ser escrita
en PI. Si el bit no es establecido producir . (sin seal) a la serie resultante. Esto
significa que solo el bit Alarma establecido como serie resultante ser
A.................

Figura 4. Prototipo de mapeado en configuracin de mapeado de marcador de seal

10 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

5.4. Archivar Calidad de las Medidas

Debido a que un valor nico puede tener mltiples cdigos de calidad asignados a l, es
necesario elegir una estrategia de mapeo. Hay una lista de opciones que est disponible
para poder elegir:
1) No archivar ninguna calidad. Si se elige esta opcin, la calidad no ser archivada
en el PI para valores de medida.
2) Archivar Calidad en la Misma etiqueta. Si esta opcin es elegida, el valor es
escrito si la calidad se considera Buena. Si no es as, el cdigo de calidad es
escrito y el valor no, dejando solo informacin acerca de la calidad y de lo mala
que result ser.
3) Archivar Calidad en etiquetas de PI separadas. Cuando esta opcin es elegida, el
valor es escrito en un punto PI en particular y la calidad es escrita en otro punto
PI que est conectado con el punto PI del valor aadindole un prefijo o sufijo en
particular.

Figura 5. Herramienta de Configuracin de Mapeo; Ejemplo de Estrategia de Archivar Calidades

11 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

5.5. Mapeo del Estado del Dispositivo

Los estados de los Dispositivos DMS son raramente aceptables para clientes simples.
DMS tiene estados avanzados que la mayora de los clientes no necesitan. Adems, a
menudo los estados digitales en PI cero (0) y uno (1) estn reservados para los estados
de dispositivos ABIERTO y CERRADO. En DMS estos estados son iguales a uno (1) y
(2), de esta manera transferir 1 y 2 a PI conlleva informacin incorrecta para el usuario
final PI. Para que el estado del dispositivo sea correctamente transferido a PI el Mapeo
del Estado del Dispositivo se introduce. Simplemente mapeando los estados DMS a los
Estados Digitales PI (Conjuntos de Estados) el usuario podr tener los estados DMS
deseados en un formato que es aceptable para el usuario PI.

Figura 5.6 Herramienta de Configuracin de Mapeo; Mapeo del Estado del Dispositivo

Ver que mapear Estados de Dispositivos DMS a -1 significa no transferir estos valores.
Esto es til cuando los Usuarios PI no necesitan algunos valores. A menudo las
operaciones de Trnsito no tienen sentido para el Usuario PI final.

12 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

5.6. Importacin Masiva va CSV

MCT proporciona importacin masiva con todas las validaciones necesarias. Es

validado:

1. Existencia de Puntos Remotos DMS

2. Duplicados de DMS Remotas

3. Existencia de Punto PI
4. Duplicados de Puntos PI

5. Duplicados de Mapeo
Importaciones incrementales son soportadas. Cuando se importa un nuevo CSV en
incremento es posible intentar importar el mapeo que se est usando en ese momento.
Si los mapeos ya existentes son proporcionados, stos deben ser actualizados y se
debe informar al usuario.
Adems, para las importaciones masivas e incrementales, las supresiones de CSV son
soportadas.
Esta figura representa una ventana de importacin:

13 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

Figura 7.Herramienta de Configuracin de Mapeo. Ventana de Importacin de CSV

El usuario tiene la posibilidad de guardar mapeos con la funcionalidad de Exportar CSV.

5.7. Configuracin de Deteccin de Cambios

Hay bsicamente dos tipos de mapeo: Puntos y configuracin.

El mapeo de configuracin es el proceso de mapear marcadores simples, cdigos de
calidad, mapeo de estado del dispositivo entre AMDS y el Servidor PI.
El mapeo de punto es el proceso donde un punto DMS en particular es mapeado a un
punto PI en concreto. Esto es por medida y por estado.
El primero casi nunca es cambiado. Lo ms probable es que la configuracin sea
mapeada una sola vez: cuando el sistema se instala por primera vez. Luego es ms
dinmico. La mayora de los puntos son mapeados cuando el sistema es instalado por
primera vez pero son cambiados de vez en cuando, incluso varios puntos por semana,
cuando nuevos puntos son aadidos al sistema y mucho ms. Debido a que estos tipos

14 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

de configuracin son de distinta naturaleza, son designados y tratados de forma

diferente.

5.7.1. Mapeo de configuracin

El mapeo de configuracin incluye el estado del mapeo del dispositivo, mapeo de

cdigos de calidad y mapeo de marcadores de seal. Cuando cualquiera de estos
mapeos son cambiados va MCT, el Adaptador PI (Servicio Histrico) debe ser
restaurado con el fin de que los cambios tengan efecto.

5.7.2. Mapeo de punto

La configuracin puede cambiarse cuando el Adaptador PI est trabajando. Nuevos
puntos pueden ser configurados para ser seguidos en Histrico y as guardar valores
adicionales para los nuevos puntos que no existen en la tabla de Mapeo de Puntos. Esto
significa que nuevas filas deben ser insertadas en la tabla PI_POINT_MAPPING para
que el Adaptador PI pueda encontrar coincidencia en el Nombre del Punto para nuevos
valores de puntos histricos, cuando sos llegan para rellenar la tabla.
Cuando un nuevo punto es aadido en el PI, ste tiene que ser emparejado usando la
herramienta de configuracin descrita en el captulo Herramienta de Ya que el nombre
del punto es identificador en el servidor PI y por convenios de nomenclatura especficos,
el nombre del punto de DMS normalmente difiere del nombre del punto en servidor PI.
Para encontrar nombres en el histrico de DMS a nombres de puntos en el servidor PI
se introduce una tabla nueva. Tiene GID y un modelo de cdigo desde DMS y nombre
de punto PI y Id de punto PI en el lado del servidor PI. No se usarn todos pero proveen
diferentes maneras de identificar puntos en el servidor PI. Por ejemplo, Nombre de
punto PI es un identificador, pero si API PI se usa para manipulacin de datos dentro del
servidor PI, se debe proveer la ID del punto PI porque API PI no puede tratar con
nombres PI.

. Una vez configurado satisfactoriamente, el Adaptador Pi es inmediatamente capaz de

insertar valores para el nuevo punto en el Servidor PI sin la necesidad de reiniciar.

Lo mismo se puede aplicar para la actualizacin de mapeo y borrado el cambio es

inmediato sin necesidad de reinicio.

15 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

6. MANIPULACIN DE CAMBIOS EN EL MISMO SERVIDOR PI

Hay situaciones donde los Administradores de PI estn cambiando la configuracin de

seguridad, nombre de puntos y ms datos en el servidor PI destino. Desde que el
Servidor PI es externo a ADMS no hay sincronizacin automtica entre los dos
sistemas.

Hay dos operaciones comunes en el Servidor PI que necesitan ser explicadas y tratadas
en MCT y en el Adaptador PI:

Borrado de un Punto PI desde el Servidor PI El Adaptador PI intentar escribir

en un Punto no existente en el Servidor. Surgir un fallo y el error quedar
registrado. No ocurrir ningn dao. Es responsabilidad del usuario de borrar
manualmente el mapeo va MCT y entonces el Adaptador PI parar de transferir
ese punto. Hasta que es borrado manualmente va MCT, el Adaptador PI
registrar errores con cada cambio de valor que venga de DMS. El archivo de
registro crecer constantemente.

Renombrar el Punto PI en el Servidor PI El Adaptador PI en el prximo reinicio

de histricos (adaptador PI) comenzar a registrar errores al igual que en el
borrado de un Punto PI. El mapeo debe ser borrado y un nuevo mapeo aadido
en sustitucin de forma manual va MCT.
Nota: si el Adaptador PI est en marcha en el momento del Renombre del Punto
en el Servidor PI, ste continuar para escribir en el nuevo (renombrado) punto
hasta que sea reiniciado. Esto es porque el Punto PI se recupera una vez que
arranca y se registra en memoria as el Adaptador PI no es consciente de que el
punto es renombrado mientras est en marcha.

16 Guia de Usuario
Herramienta de configuracin de mapeo del adaptador PI ADMS

7. PARMETROS

Los parmetros son archivados en un archivo XML y el usuario tiene el permiso de

cambiar stos de acuerdo con sus preferencias y experiencia. Los parmetros son
descritos en los siguientes subcaptulos.

7.1. Actualizar Frecuencia

El escritor PI se ejecuta en bases regulares. Actualizar Frecuencia dice cuntos

milisegundos se dormir antes de la prxima ejecucin. Es sistema estar dormido si y
solo si no hay nada que transferir, e.g. PI_TIMELINE_KEY est vaco.
Ver que una vez que despierte, el escritor PI transfiere continuamente trozos de datos
al servidor PI hasta que transfiere todas las filas de PI_TIMELINE_KEY. Si los datos
estn continuamente llegando al Adaptador PI nunca se ir a dormir.

Cuando todas las filas son transferidas al PI y no hay nada en la tabla

PI_TIMELINE_KEY, se ir a dormir de nuevo.

7.2. Fichero a Transferir (Troceado)

El Escritor PI transfiere datos en trozos porque en TIMELINE puede potencialmente

tener una gran cantidad de datos y enviarlos todos a la vez puede tener consecuencias
negativas en el funcionamiento del sistema. Por ejemplo, si durante el letargo del
Escritor PI una gran cantidad de datos viene de PI_TIMELINE_KEY, el Escritor PI
tomara una gran cantidad y lo enviara al Servidor PI y esto puede formar problemas de
servidor.

Para evitar esto, el Escritor PI enva datos a trozos que tienen un tamao configurable.
Este parmetro dice cuntas columnas pueden ser transferidas en cada llamada al PI.

17 Guia de Usuario