Formato para La Transmision en Linea de Datos Al Software de MEE [PDF]

Zitiervorschau

Formato para la transmisión en línea de datos al Software de Monitoreo de Extracciones Efectivas

Santiago, septiembre 2019

Antecedentes El Software de Monitoreo de Extracciones Efectivas de Aguas es una aplicación Web, en operación a nivel nacional, que da soporte a la Dirección General de Aguas en su quehacer asociado al Monitoreo de Extracciones de aguas subterráneas/superficiales, que hacen los titulares de los derechos de aprovechamiento de aguas. A la carga de datos de extracciones, mediante archivos o interfaz de carga, se deben agregar dos nuevos canales para informar datos de extracciones, ya sean aguas de naturaleza subterránea y/o superficial:



En línea, a través de la disponibilización de un servicio que será invocado de manera automática por usuarios de los derechos de aprovechamiento de aguas.



Mediante Formulario (no abordado en este documento)

Este documento contiene los formatos de los mensajes necesarios para interactuar con el servicio web que la DGA pondrá a disposición de los titulares de los derechos de aprovechamiento de aguas para la recepción de datos en línea. Los datos a recibir son los emanados desde la capa denominada “concentradores”, capa que media entre las Obras de Captación de Aguas (Puntos de Control de Extracción) y el servicio web de la DGA.

Diagrama de la solución El Siguiente Diagrama describe las interacciones con los diferentes componentes involucrados en la solución a un alto nivel para la integración que permita recibir información de los datos asociados a Extracciones de Aguas Subterráneas y Superficiales, según corresponda.

IHS [HTTPServer]

Broker [BUS]

Id1

Id2

Concentrador

Https Soap

ODBC

DB

TCP

MQ

Http Soap

IdN

DGA disponibilizará un WebService SOAP, vía HTTPS con Certificado, para securitizar la comunicación.

El proceso del servicio web realizará en primera instancia, validación de Completitud de la Información y que sus formatos sean respetados, tales como formatos de fechas, números, cantidad de decimales. URL WebService El endpoint del WebService a consumir es el siguiente: https://snia.mop.gob.cl/controlextraccion/wsdl/datosExtraccion/SendDataExtraccionService

Documentacion WSDL sendDataExtraccionService.wsdl A continuación, se describen cada uno de los componentes y partes que definen el servicio Web encargado de recibir la información en línea de las extracciones de aguas. targetnamespac e:

http://www.mop.cl/controlextraccion/wsdl/datosExtraccion/SendDataExtraccion Service

services

bindings

porttypes

messages

types

sendDataExtrac cionService

SendDataExtrac cionBinding

SendDataExtracci onPortType

sendDataExtracci onRequest sendDataextracci onResponse

sendDataExtraccio nRequest sendDataExtraccio nResponse sendDataExtraccio nSubterranea sendDataExtraccio nSuperficial sendDataExtraccio nTraza sendDataExtraccio nTrazaType Status zdate ztime

Nombre servicio sendDataExtraccionService diagra m

ports

source

SendDataExtraccionPort binding tns:SendDataExtraccionBinding extensibili



binding SendDataExtraccionBinding diagram

type extensibili ty operation s

used by source

tns:SendDataExtraccionPortType

SendDataExtraccionOp extensibili input name="sendDataExtraccionRequest" output name="sendDataExtraccionResponse" Port SendDataExtraccionPort in Service sendDataExtraccionService









porttype SendDataExtraccionPortType diagram

operations

SendDataExtraccionOp input tns:sendDataExtraccionRequest output

used by source

binding

tns:sendDataextraccionResponse SendDataExtraccionBinding





message sendDataExtraccionRequest parts

sendDataExtraccionReq element ns:sendDataExtraccionRequest Tracking element

used by source

Operation

ns:sendDataExtraccionTraza SendDataExtraccionOp in PortType SendDataExtraccionPortType



message sendDataextraccionResponse parts used by source

sendDataExtraccionResp element ns1:sendDataExtraccionResponse Operation SendDataExtraccionOp in PortType SendDataExtraccionPortType



complexType sendDataExtraccionSubterranea diagram

namespace children used by annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest req:fechaMedicion req:horaMedicion req:totalizador req:caudal req:nivelFreaticoDelPozo element

sendDataExtraccionRequest/dataExtraccionSubterranea

Documentation Sección para envio datos extraccion de aguas Subterraneas

Sección para envio datos extraccion de aguas Subterraneas



Fecha de la medición (dd-mmyyyy).



Hora de la medición (hh:mm:ss). Formato de 24 horas.



Valor del totalizador del flujómetro en metros cúbicos. Sin decimales.







Caudal medido con el flujómetro en l/s. Con 2 decimales.







Nivel freatico medido por el pozómetro en metros. Con 2 decimales.







complexType sendDataExtraccionSuperficial diagram

namespace children used by annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest req:codigoDeLaObra req:fechaMedicion req:horaMedicion req:caudal element

sendDataExtraccionRequest/dataExtraccionSuperficial

Documentation Sección para envio datos extraccion de aguas Superficial

Sección para envio datos extraccion de aguas Superficial



Fecha de la medición (dd-mmyyyy).



Hora de la medición (hh:mm:ss). Formato de 24 horas.



Caudal medido con el flujómetro en l/s. Con 2 decimales.







Altura Limnimétricas, valores enteros Positivos



complexType sendDataExtraccionTrazaType diagram

namespace children used by annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest req:codigoDeLaObra req:timeStampOrigen element

sendDataExtraccionTraza

documentation datos para ser enviados en Header

datos para ser enviados en Header



Código dado por el software cuando ingrese su Obra de captación







complexType Status diagram

namespace children used by annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionResponse resp:Code resp:Description element

sendDataExtraccionResponse/status

Documentation Estructura retorno servicio Web



Estructura retorno servicio Web



Codigo de retorno 0[cero] implica exitoso



Descripcion asociada al campo Code



element sendDataExtraccionRequest diagram

namespace properties children annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest content

complex

req:dataExtraccionSuperficial req:dataExtraccionSubterranea documentation Envio datos de extracción de aguas

Envio datos de extracción de aguas





element sendDataExtraccionTraza diagram

namespace type properties children annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest req:sendDataExtraccionTrazaType content

complex

req:codigoDeLaObra req:timeStampOrigen documentation Estructura de Datos a enviar en Header

Estructura de Datos a enviar en Header

element sendDataExtraccionResponse diagram

namespace properties children annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionResponse content

complex

resp:status Documentation Estructura respuesta servicio web

Estructura respuesta servicio web





simpleType zdate namespace type properties

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest restriction of xsi:date base

xs:date

used by facets annotation source

sendDataExtraccionSubterranea/fechaMedicion sendDataExtraccionSuperficial/fechaMedicion

elements Kind pattern

Value [^:Z]*

annotation

Documentation Definicion de fechas para validar Formato dd-mm-yyyy , sin timezone

Definicion de fechas para validar Formato dd-mm-yyyy , sin timezone



simpleType ztime namespace type properties used by facets annotation source

http://www.mop.cl/controlextraccion/xsd/datosExtraccion/SendDataExtraccionRequest restriction of xsi:string base

xs:string

elements Kind pattern

sendDataExtraccionSubterranea/horaMedicion sendDataExtraccionSuperficial/horaMedicion Value (0[0-9]|[1][0-9]|2[1-3]):([0-5][1-9]):([0-5][1-9])

annotation

Documentation Formato de horas para validar formato de horas como 11:55:05, 23:59:45 etc.

Formato de horas para validar formato de horas como 11:55:05, 23:59:45 etc.



Códigos (Status) de Retorno Para validar el éxito o error de la llamada al WebService la estructura de retorno se debe evaluar los siguientes valores. Code

Description 0

OK

10

Error Estructura Request

20

Error Tipo de Datos

30

Error Cola MQ llena

40

Error ‘codigoDeLaObra’ inválido

50

Error Datos incompletos

Nota: Cualquier Valor mayor a cero en el atributo Code, será considerado como ejecución con Error.

Código de la Obra (codigoDeLaObra) Corresponde al código dado por el software cuando el usuario ingresa su obra de captación. El formato del código consta de partes siguientes separadas por el carácter “-“

Parte

Description 1

“OB”, para obra de captación; “OR”, para obra de restitución1

2

Formado por la concatenación de los códigos DGA de la región y de la provincia donde está ubicada la obra de captación. Dos dígitos para la región y dos dígitos para la provincia. Si el código de la región o provincia es menor que 9, se completa con un 0 a la izquierda.

3

Correlativo por región y provincia. Numero entero mayor o igual a 1.

Por ejemplo, el código de obra “OB-0602-7” corresponde a la séptima obra de captación registrada para la región de O’Higgins (6), provincia de Colchagua (2).

1

Para “OR” el formato es idéntico al caso “OB” superficial.

Ejemplos mensajes request Ejemplo 1: Aguas Superficiales

OB-0303-203 2001-12-17T09:30:47Z



13-08-1967 00:01:01 12345678.12 1



Ejemplo 2: Aguas Subterráneas

OB-0303-204 2001-12-17T09:30:47Z



17-08-1967 00:01:01 1234567891 12345678.12 12345678.12