Manual de Generación de tramas

Transcripción

1 Ver Documento: 1.1 Manual de Generación de tramas XML Proyecto CCMF MTC Preparado por: Carlos Rodríguez Ivan Ticona Fecha de preparación: 20/06/2009 Fecha de revision: 05/11/2010 Página 1 de 8

2 Tabla de contenido GENERACIÓN DE TRAMAS Archivo de Transferencia de las EMV al CCMF Anexo Anexo Página 2 de 8

3 GENERACIÓN DE TRAMAS 1. ARCHIVO DE TRANSFERENCIA DE LAS EMV AL CCMF Se requiere que las EMV (Empresas de Monitoreo Vehicular) generen archivos XML de dos tipos, uno para la transmisión de tramas estándar es decir las de ubicación permanente de las unidades de transporte y otra para el evento de botón de pánico (emergencias). La frecuencia de envio para mensajes "estándar" sera máximo en intervalos de 1 minuto y para botónes de pánico de inmediato, o como sea dispuesto por el Ministerio de Transportes y Comunicaciones (MTC). Cada generación nueva contendrá solo las ultimas ocurrencias del último periodo de tiempo, si no hubo ninguna ocurrencia no se genera nada en este intervalo de tiempo (o si se prefiere se genera un XML vacío). La conformación de dichas tramas es la siguiente: a) La trama responde a la siguiente estructura: <REPORTE> < TRAMA PLACA="AD385" LONGITUD=" " LATITUD=" " RUMBO="233" VELOCIDAD="0" FECCOMUN=" T13:21:46"/> < TRAMA PLACA="AD385" LONGITUD=" " LATITUD=" " RUMBO="311" VELOCIDAD="12" FECCOMUN=" T13:22:46"/> </REPORTE> b) La trama del evento (botón de pánico) responde a la siguiente estructura: REPORTE> < TRAMA PLACA="AD785" LONGITUD=" " LATITUD=" " RUMBO="233" VELOCIDAD= "0 " FECCOMUN= " T13:21:46 "/> < TRAMA PLACA="HD384" LONGITUD=" " LATITUD=" " RUMBO="233" VELOCIDAD="0" FECCOMUN=" T13:22:46" /> </REPORTE> NOTA: ordenar las tramas por fecha de forma cronológica (desde la mas antigua a la mas reciente) c) Descripción de campos: Se presenta los campos con las características requeridas y seguidamente la tabla-01, que resume lo dicho. Definición de Campos: PLACA: Es el código de identificación de la unidad de transporte, es una cadena de caracteres. LONGITUD: Punto en el plano cartesiano, en formato decimal. LATITUD: Punto en el plano cartesiano junto con la LONGITUD arman una coordenada geográfica, en formato decimal. RUMBO: Dirección en grados de 0 a 360, indicará la orientación del vehículo, en formato decimal. VELOCIDAD: Velocidad del vehículo Km/h, en formato decimal. FECCOMUN: Fecha y hora generada por el aparato GPS instalado en la unidad de transporte. Página 3 de 8

4 2. ANEXO 01 Tabla-01 CAMPO TIPO MIN MAX REQUERID O PLACA varchar(7) No Aplica No Aplica Si LONGITUD decimal(12, 8) No Aplica No Aplica Si LATITUD decimal(12, 8) No Aplica No Aplica Si RUMBO int Si VELOCIDAD int 0 No Aplica Si FECCOMUN datetime No Aplica No Aplica Si Existen varias formas de generar archivos.xml el siguiente es un ejemplo de una de ellas con MS- TSQL 2005 A. Se debe habilitar las siguientes opciones con un usuario con privilegios. EXEC sp_configure 'show advanced options', 1; RECONFIGURE; EXEC sp_configure 'xp_cmdshell', 1; RECONFIGURE; Crear una tabla FECHATRANS que contenga un solo campo :ultima fecha de trasmision, este tiene el único objeto de guardar la ultima fecha de reporte. B. Se debe crear un archivo que contenga la sentencia que genere las tramas a ser transmitidas, (Sólo aquellas que no han sido transmitidas ya, y cada intervalo de 5 minutos), por ejemplo: C:\Agente\Sentencia.SQL este archivo puede estar en cualquier ubicación del disco y tener cualquier nombre pero debe considerarse este en el procedimiento almacenado; se recomienda crearlo en el mismo ubicación del agente de comunicaciones. C:\Agente\Sentencia.SQL :XML ON USE BASE_DE_DATOS SET NOCOUNT ON = DATE_ULTIMA_TRANSMISION FROM FECHATRANS --- Nota la tabla FECHATRANS tiene como campo DATE_ULTIMA_TRANSMISION cuyo valor es la ---- ultima fecha de transmicion. --- Modificar según la los nombres de campos para generar la trama, transmite solo la ultima trama valida por unidad en ese intervalo de tiempo Página 4 de 8

5 SELECT PLACA, LONGITUD, LATITUD, RUMBO, VELOCIDAD, FECCOMUN FROM TABLA T WHERE FECCOMUN IN( ORDER BY FECCOMUN FOR XML RAW('TRAMA'), ROOT('REPORTE') SET NOCOUNT OFF --- SELECT MAX(MEC_FECCOMUN) FROM TABLA WHERE PLACA = T.PLACA AND MEC_FECCOMUN > ULTIMA_TRANSMISION) C. Crear un procedimiento que ejecute el archivo C:\Agente\Sentencia.SQL SET ANSI_NULLS ON SET QUOTED_IDENTIFIER ON -- ============================================= -- Autor: Nombre Apellido -- Fecha de creación: 01/01/ Descripción: Generar xml -- Usuario: Cambiar por un usuario con privilegios -- Password: Cambiar por el password del usuario -- Considerar el archivo de salida para este ejemplo esta en C:\Agente\XML_TRAFICO_NORMAL\ -- y concatenado como se solicita el archivo NAÑOMESDIAHHMMSS -- ej.: N ============================================= CREATE PROCEDURE generaxml AS BEGIN SET NOCOUNT ON; VARCHAR(100) VARCHAR(100) VARCHAR(100) -- Cambiar Usuario y Password por el usuario y pass de la BD = 'SQLCMD -U Usuario -P Password -i " C:\Agente\Sentencia.SQL" -o' = 'C:\Agente\XML_TRAFICO_NORMAL\N' + CONVERT(varchar(30), GETDATE(), 112) + SUBSTRING(CONVERT(varchar(30), GETDATE(), 108), 1, 2) + SUBSTRING(CONVERT(varchar(30), GETDATE(), 108), 4, 2) + SUBSTRING(CONVERT(varchar(30), GETDATE(), 108), 7, 2) +'.xml' EXEC END Nota: usar una ruta sin espacios ya que el agente solo puede leer rutas sin espacios. D. Generar un Job que ejecute el procedimiento almacenado cada TRES minutos o al intervalo de tiempo que indique el MTC. Página 5 de 8

6 1) En new Job en la ficha General llenar los datos de Name, Owner, Categoria, Description y hacer check en Enabled, el gráfico muestra el ejemplo. 2) En new Job en la ficha Step crear uno nuevo New y en la siguiente pantalla llenar StepName, Type, Database, y en Command ejecutar el procedimiento almacenado, el grafico muestra el ejemplo. Página 6 de 8

7 3) En new Job en la ficha Schedules crear uno nuevo New en la siguiente pantalla llenar Name, Schedule type, Frequency, Daily Frequency, Difusion. Un ejemplo se muestra en el grafico. Y finalmente se generar con el botón ok del New Job. 3. ANEXO 02 Existen varias formas de generar archivos.xml el siguiente es un ejemplo de una de ellas con ORACLE DATABASE XE A. Se debe habilitar las siguientes opciones con un usuario con privilegios, en caso no lo estén. grant execute on UTL_FILE to public; --o a un Usuario. B. Se debe crear un directorio con la ruta donde se generarán los archivos XML, este directorio es el que se selecciono cuando se instalo el agente de comunicaciones para nuestro ejemplo será C:\Agente\XML_TRAFICO_NORMAL. create directory filesdir as ' C:\Agente\XML_TRAFICO_NORMAL'; grant read on directory filesdir to public; grant write on directory filesdir to public; --o a un Usuario C. Crear el procedimiento que genere las tramas. Página 7 de 8

8 -- ============================================= -- Autor: Nombre Apellido -- Fecha de creación: 01/01/ Descripción: Generar xml -- Considerar el archivo de salida para este ejemplo esta en C:\Agente\XML_TRAFICO_NORMAL\ -- y concatenado como se solicita el archivo NAÑOMESDIAHH24MMSS -- ej.: N ============================================= create or replace PROCEDURE CREAXML AS v_file Utl_File.File_Type; v_xml xmltype; RESULT1 clob; v_nomarc varchar2(19); BEGIN SELECT xmlelement("datos", xmlagg( xmlelement( "TRAMA", XMLAttributes(t.PLACA,t.LONGITUD,t.LATITUD,t.RUMBO,t.VELOCIDAD, t.feccomun) ) ) ) INTO v_xml FROM TABLA t; RESULT1 := v_xml.getclobval(); -- Nombre del archivo -- SELECT 'N' to_char(sysdate, 'yyyymmddhh24mmss') '.xml' INTO v_nomarc FROM dual; -- Escribe el archivo -- v_file := Utl_File.FOpen('FILESDIR', v_nomarc, 'w'); Utl_File.Put(v_file, RESULT1); Utl_File.FClose(v_file); END CREAXML; D. Generar el job. DECLARE X NUMBER; BEGIN SYS.DBMS_JOB.SUBMIT ( job => X,what => 'BEGIN CREAXML; END;',next_date=> to_date('24/06/ :30:00','dd/mm/yyyy hh24:mi:ss'),interval => 'SYSDATE+1/1440' -- intervalo de tiempo,no_parse => FALSE ); DBMS_OUTPUT.PUT_LINE(to_char(X)); END; Página 8 de 8