DESCARGAR MENSAJE
Este caso de uso descargará todos los adjuntos del mensaje indicado, el XML con los metadatos y el acuse que se obtiene al invocar el SW de imprimirMensaje en un zip codificado en base64. Nota: es importarte resaltar que es responsabilidad de la aplicación cliente llevar el control de la descarga, pidiendo los bloques según los vaya consolidando, ya que el Servicio Web no esperará recibir las peticiones en orden: enviará el bloque que el cliente le solicite. El servidor LexNET sí indicará cuándo el bloque que está entregando es el último para ese adjunto (no necesariamente indica que el cliente terminó la descarga, sino que indica que ese identificador de bloque es el mayor admitido para ese adjunto) de modo que el cliente pueda consolidar el fichero adjunto (si ha solicitado los bloques de forma secuencial). Una vez descargado el mensaje se deberá invocar al SW MensajeDescargadoACK para confirmar que la descarga ha sido correcta.
Validaciones
Estas son las validaciones que se aplican:
-
idAplicacion: se comprueba que el identificador de la aplicación está admitido en el entorno actual.
-
idSesion: se comprueba que el identificador de sesión es correcto.
-
idSujetoEntidadTC: se comprueba que el identificador de la entidad sea correcta y pertenezca a la aplicación. Desde la versión 3.22 solamente se podrá usar el campo idSujetoEntidadTC.
-
idLexnet: se comprueba que el valor coincide con un mensaje existente y valido.
Interfaz
A continuación se detallarán los datos de entrada necesarios que necesita este caso de uso para su ejecución. Además se describe la respuesta del servicio a la ejecución del mismo.
Entrada al servicio
El parámetro de entrada a este método del servicio es el siguiente:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ent="http://platino.gobcan.es/servicios/lexnet/entidades">
<soapenv:Header/>
<soapenv:Body>
<ent:DescargarMensaje>
<ent:DescargarMensajeIn>
<![CDATA[<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:mensajeWS xmlns:ns2="https://wslexnet.webservices.lexnet/3.26">
<solicitudGetBloque>
<idSesion>1751343571</idSesion>
<idAplicacion>PLATINO</idAplicacion>
<idSujetoEntidadTC>3501606S08</idSujetoEntidadTC>
<id>10</id>
<idBloquePedido>1</idBloquePedido>
</solicitudGetBloque>
</ns2:mensajeWS>]]>
</ent:DescargarMensajeIn>
</ent:DescargarMensaje>
</soapenv:Body>
</soapenv:Envelope>
Salida del servicio
El XML con los metadatos existente en el zip de la respuesta del SW será un objecto del tipo respuestaGetMensajeType definido en el archivo WSLexNET_3.26.xsd. Para facilitar su comprensión se adjuntan ejemplos de mensajes descargados como anexos a este documento.
Por otro lado, el nombre de los documentos dentro del ZIP se compone de la siguiente forma: sPrefijo = idLexnet del mensaje + "_"+ fechaEnvio sin espacios en blanco ni : o - Es decir, todos llevan el prefijo anterior que se monta con el idLexnet _ y la fecha de sellado sin formato. Y a partir de ese prefijo se montan los siguientes documentos: PDF de LexNET: nombrePdf = sPrefijo + ".pdf"; XML de LexNET: nombreXml = sPrefijo + ".xml";
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:DescargarMensajeResponse xmlns:ns2="http://platino.gobcan.es/servicios/lexnet/entidades">
<ns2:DescargarMensajeOut>
<![CDATA[<?xml version="1.0" encoding="ISO-8859-1"?>
<mensajeWS xmlns="https://wslexnet.webservices.lexnet/3.26"
xsi:schemaLocation="https://wslexnet.webservices.lexnet/3.26 schema.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<respuestaGetBloque>
<idBloqueEntregado>923</idBloqueEntregado>
<esUltimo>1</esUltimo>
<bytesContenido>YTM0NZomIzI2OTsmIzM0NTueYQ==</bytesContenido>
</respuestaGetBloque>
</mensajeWS>]]>
</ns2:DescargarMensajeOut>
</ns2:DescargarMensajeResponse>
</soap:Body>
</soap:Envelope>