SGNTJ. LexNET. Guía de uso de los Web Services de integración. (profesionales) SGNTJ - LexNET

Transcripción

1 SGNTJ LexNET Guía de us de ls Web Services de integración (prfesinales) LX8_020v15

2

3 CONTROL DE VERSIONES Versión Fecha Descripción del cambi Versión /11/2007 S.G. de Nuevas Tecnlgías Versión /12/2007 Mdificación de WS Schema Versión /01/2008 Mdificación de WS Schema Versión /03/2008 Mdificación del servici ObtenerCabeceras Versión /04/2008 Añadid nuev servici web LginServicis Versión /01/08 Mdificación del servici ObtenerCabeceras Versión /09/09 Añadids servicis Repartir, Asumir, ObtenerAceptads y ObtenerPrcuradres. Además se ha mdificad el servici ObtenerMensaje Versión /01/2010 Mdificación del element prfesinal para que incluya el códig de clegiad. Versión /04/2010 Añadids servicis ObtenerPendientesRepartir y ObtenerCabecerasPendientesRepartir. Además se ha mdificad el servici ObtenerCabeceras Versión /12/2010 Añadids servicis web de EnviAcusesSGP, ObtenerAviss. Mdificación de servicis: ObtenerCabeceras, ObtenerCabecerasPendientesRepartir, ObtenerMensaje y ObtenerPrcuradres. Se ha actualizad el schema de ls XML de petición y respuesta. Versión /08/2011 Se han añadid ls servicis web ObtenerPendientesRepartirOtrs, ObtenerCabecerasPendientesRepartirOtrs,, BuscarMensajesAuditrias, BuscarInfrmeAuditria. Asimism, se han mdificad ls servicis ObtenerCabeceras y ObtenerCabecerasPendientesRepartir incluyend fechainici y fechafin y el servici ObtenerPrcuradres, incluyend el idsujet Versión 3.0_v2 Versión 3.0_v3 26/09/2011 Se mdifica la descripción de ls parámetrs fecha,fechainici,fechafin del ws ObtenerAceptads (la descripción incluida en la versión anterir era errónea) 03/10/2011 Se intrducen crreccines en la descripción de ls servicis y en algunas etiquetas de ls mensajes de petición/respuesta

4 Versión 3.0_v4 Versión 3.0_v5 Versión 3.0_v6 Versión 3.0_v7 Versión 3.0_v8 Versión 3.0_v9 Versión 3.0_v10 Versión 3.0_v11 Versión 3.0_v12 Versión 3.0_v13 Versión 3.0_v13 Versión 3.0_v14 Versión 3.0_v15 Versión 3.0_v15_2 09/01/2012 Se incluye el apartad Ejempl de us e invcación de ls Servicis Web LexNET 27/01/2012 Se añade explicación a parámetrs de EnviarMensaje 18/01/2012 Se añade el servici web ObtenerHistricMensaje 26/04/2012 Se añade el envi de mensajes cn firma CAdES 29/06/2012 Se añade explicación de frmat de mensaje MIME/CAdES y parámetr de envi CAdES en EnviarVerificacinLecturaGeneral 28/09/2012 Se añade al ws EnviarMensaje descripción relativa a la psibilidad de enví de cpias a prfesinales 01/10/2012 Se añade ls es btenercabeceraspendientesasumir y ObtenerPendientesAsumir 08/11/2012 Se añade explicación adicinal a ObtenerCabeceras 10/12/2012 Se añade explicación adicinal a ObtenerCabecerasPendientesAsumir 03/01/2013 Se añaden ws ObtenerRles, CnfigRlPrDefect 08/03/2013 Se añaden parámetrs de entrada a ObtenerCabeceras 16/04/2013 Se añaden parámetrs de entrada a EnviarMensaje para enví de escrits de subsanación 26/07/2013 Se mdifica respuesta de ObtenerMensaje, Se añade nuevs servicis web SlicitudLginTken, LginTken, EnviarMensajeTken, EnviarVerificacinLecturaTken y EnviarBlqueTken. Se añade explicación de us de ls servicis web; se distribuyen ls servicis pr tiplgía; se añaden anexs en este dcument. Se añade explicación us distintas mdalidades de servicis web. Se añade a ls SW ObtenerDestinataris la psibilidad de filtrad de destinataris pr tip de mensaje. Se añaden rutas a ls WSDL de ls servicis web 26/07/2013 Se crrige errata en la dcumentación de ls SW EnviarMensajeTken, EnviarVerificacinLecturaTken y EnviarBlqueTken, ObtenerMensaje (camp bservacines)

5 ÍNDICE ÍNDICE INTRODUCCIÓN ARQUITECTURAS para invcación A LOS SERVICIOS WEB DE LEXNET Arquitectura de intercnexión desde cliente (certificad de usuari) Cnexión cn LexNET Ejempl de us e invcación de ls servicis web LexNET Arquitectura de intercnexión desde servidr (certificad de servidr/aplicación) Cnexión cn LexNET Ejempl de us e invcación de ls servicis web LexNET DESCRIPCIÓN DE LOS SERVICIOS WEB LEXNET De us general (cnexión cn certificad de usuari de aplicación) Respuesta de errr LgOut ObtenerRles CnfigRlPrDefect ObtenerDestinataris ObtenerTipsPrcedimient... 50

6 ObtenerPendientes ObtenerCabeceras ObtenerMensaje ObtenerBlque TerminarDescarga ObtenerHistricMensaje ObtenerAviss Exclusivs para cnexión cn certificad de usuari Lgin EnviarMensaje EnviarBlque EnviarVerificacinLectura Exclusivs para cnexión cn certificad de aplicación SlicitudLginTken LginTken EnviarMensajeTken EnviarVerificacinLecturaTken EnviarBlqueTken De us pr Clegis de Prcuradres (cnexión cn certificad de usuari de aplicación) ObtenerPrcuradres...159

7 ObtenerCabecerasPendientesRepartir ObtenerCabecerasPendientesRepartirOtrs ObtenerPendientesRepartir ObtenerPendientesRepartirOtrs Repartir ObtenerAceptads ObtenerCabecerasPendientesAsumir ObtenerPendientesAsumir Asumir BuscarMensajesAuditrias BuscarInfrmeAuditria ANEXOS ANEXO I: Códigs usads en ls Web Service Códigs de errr devuelts pr el servidr Tips de perfil de usuari (rles) Tips de mensajes (tipmensaje) Tips de entidad (tipentidad) Tips de SGP (Sistemas de Gestión Prcesal) Tips de órgan (cdtiporgan) Tips de itineracines Tips de relacines entre mensajes...257

8 Tips de catálgs Tips de rden (idorden) Funcines de intervinientes demandas (idfuncin) Tips de materias demandas (cdigmateria) ANEXO II: Recmendacines para desarrll de cliente Descripción Entrn tecnlógic de desarrll Requisits funcinales del cliente ANEXO III: Guía de cumplimentación de las plantillas de ls mensajes de enví Mensaje frmat MIME Mensaje frmat CAdES ANEXO V: Tecnlgías LexNET. Descripción breve Firma electrónica Platafrma ASF SMIME CAdES Sellad de tiemp TSA del Ministeri de Presidencia GLOSARIO

9 1. INTRODUCCIÓN El bjet de este dcument es describir las interfaces de Servicis Web dirigidas a prfesinales de la platafrma LexNET para que ls desarrlladres de aplicacines puedan integrar y utilizar ls servicis frecids pr la misma. Durante la fase de desarrll, ls integradres invcarán ls servicis web del entrn de integración del LexNet ( y cuya definición WSDL pueden encntrar en (Ej: El WSDL del servici web de lgin puede descargarse desde Una vez desarrlladas y antes de su pase a prducción, estas aplicacines habrán tenid que pasar previamente un prces de hmlgación de su aplicación en el que se cmprbará el funcinamient adecuad del cliente desarrllad cnfrme a ls requisits del RD 84/2007 reguladr del sistema LexNET. Una vez pasad el prces de hmlgación, La Subdirección General de Nuevas Tecnlgías de la Justicia asignará un identificadr únic e intransferible a la aplicación l que permitirá su intercmunicación cn LexNET pr servicis web. Este dcument cubre ls siguientes aspects: Descripción de ls distints tips de servicis web cntemplads en este dcument y la arquitectura necesaria para su invcación

10 Descripción de la interfaz de Servicis web de la platafrma LexNET mediante la especificación de mensajes XML-SOAP de slicitud y respuesta. Descripción de ejempls us e invcación de ls servicis web LexNET para la realización de ls prcess principales aprtads pr el sistema LexNET: enví y descarga de mensajes. La platafrma LexNET publicará ls siguientes Web Services de integración cn LexNET: De us general De us pr parte de Clegis de Prcuradres invcables desde ds tips de arquitecturas: Arquitecturas de intercnexión desde cliente: SSL cn certificad de usuari Arquitecturas de intercnexión desde servidr: SSL cn certificad de servidr/aplicación y slicitud de tken firmad pr el usuari Tds ls servicis web publicads cnstan de una sla peración. Tdas las peracines reciben cm únic parámetr de entrada un String cn frmat XML. Cada servici publicad dispne de un frmat de XML específic que viene definid pr el XML Schema de ls mensajes a ls Web Services. En este Schema se definen tds ls mensajes de tds ls web services, tant ls de petición, cm ls de respuesta, incluida la respuesta en cas de errr (En el

11 apartad se especifican ls códigs de errr que devuelven ls servicis web, así cm su descripción). 2. ARQUITECTURAS PARA INVOCACIÓN A LOS SERVICIOS WEB DE LEXNET LexNET psibilita la intercnexión e invcación cn ls servicis web del sistema desde ds arquitecturas que se detallan en ls siguientes apartads Arquitectura de intercnexión desde cliente (certificad de usuari) Cnexión cn LexNET La primera psibilidad que frece LexNET para la invcación de sus servicis web es la intercnexión directa desde la ubicación del cliente (usuari). En este tip de arquitecturas, utilizadas tradicinalmente pr aplicacines de escritri, es necesari crear en primer lugar un túnel segur SSL cn LexNET utilizand el certificad de usuari. A cntinuación, LexNET permite iniciar la invcación a sus servicis web, de acuerd cn las funcinalidades requeridas.

12 Figura 1 Arquitectura de intercnexión cliente-lexnet Ejempl de us e invcación de ls servicis web LexNET El us de ls principales servicis web de LexNET requiere la invcación de ls misms en un rden determinad. A cntinuación se detalla el prces de invcación para ds de ls prcess más imprtantes aprtads pr LexNET, utilizand una arquitectura de invcación desde el cliente cn su certificad. Nta: La descripción detallada de us e invcación de tds ls servicis web frecids pr LexNET se encuentra en el apartad Autenticación en LexNET y enví de mensajes El enví de un mensaje a través de LexNET requiere un prces cnsistente en ls siguientes cinc pass:

13 Figura 2 Prces enví mensajes [T1]En primer lugar se realizará un prces de Autenticación del usuari, en cas de que n se hubiera realizad previamente. Para ell, la aplicación habrá establecid cn LexNET una sesión SSL utilizand el certificad digital del usuari. A cntinuación se realizará una petición al servici web Lgin [T2] A cntinuación se iniciaría el prces de enví del mensaje. Est cnlleva la realización de peticines a ls servicis web LexNET y tareas que se detallan a cntinuación:

14 Figura 3 [T2] Enví de mensaje: detalle de peticines a ls ws LexNET [T2x] Si la aplicación n había invcad previamente al servici ObtenerTipsPrcedimient, pdría realizarl para cncer ls psibles tips de prcedimient que pdrá enviar cm asunt de su mensaje. Se recmienda realizar esta llamada de frma casinal debid a la carga de dats de este servici web y a que se trata de una infrmación cn pcs cambis a l larg del tiemp.

15 [T2y] Si la aplicación n había invcad previamente al servici ObtenerDestinataris, pdría realizarl para cncer ls dats de identificación de ls psibles destinataris de su mensaje. Se recmienda realizar esta llamada de frma casinal debid a la carga de dats de este servici web y a que se trata de una infrmación cn pcs cambis a l larg del tiemp. [T21] La aplicación realizará una petición al servici web EnviarMensaje dnde detallará ls dats previamente slicitads al usuari: destinatari del mensaje, tip/nº de prcedimient, adjunts, etc. [T22] En respuesta a esta petición, LexNET prprcinará una plantilla de mensaje MIME/CADES (dependiend del tip de firma a utilizar). [T23] La aplicación deberá cumplimentar la plantilla MIME/CADES btenida en el pas anterir. Para ell, deberá anexar a la plantilla prprcinada la siguiente infrmación: Dcument principal firmad cn el certificad digital del usuari remitente Dcuments adjunts que el usuari desee enviar (si algun). Una vez cmpletada la plantilla de enví (MIME CADES), la aplicación deberá firmarla cn el certificad digital del usuari remitente, generand un dcument de enví que remitirá a LexNET.

16 [T24..T24+n] A cntinuación, el mensaje será enviad a LexNET dividid en n blques cn n llamadas sucesivas al servici web EnviarBlque. [T25..T25+n] En respuesta a cada una de las peticines a EnviarBlque, LexNET prprcinará una respuesta [T26] Una vez btenids tds ls blques, LexNET realizará un prces de sellad de tiemp sbre el mensaje y de firma pr parte de LexNET, creand el mensaje final que será enviad al destinatari [T27] LexNET prprcinará cm respuesta al últim blque el identificadr del acuse del enví realizad así cm la fecha de sellad del mism. Este identificadr psibilitará la descarga del acuse, en cas desead. [T3] A cntinuación, en cas de que se desee descargar el acuse, el prces de descarga será similar al prces de descarga de un mensaje, tal y cm se explica en ls tiemps [T25] a [T29] del siguiente apartad (Descarga de mensajes). [T4] La aplicación finalizaría su sesión cn LexNET haciend una invcación al servici de LgOut Autenticación en LexNET y descarga de mensajes

17 La descarga de un mensaje recibid a través de LexNET requiere un prces cnsistente en ls siguientes tres pass: Figura 4 Prces de descarga de mensajes [T1]En primer lugar se realizará un prces de Autenticación del usuari, en cas de que ya n se hubiera realizad previamente. Para ell, la aplicación habrá establecid cn LexNET una sesión SSL utilizand el certificad digital del usuari. A cntinuación se realizará una petición al servici web Lgin

18 [T2] A cntinuación se iniciaría el prces de descarga del mensaje. Est cnlleva la realización de peticines a ls servicis web LexNET y tareas que se detallan a cntinuación: Figura 5 [T2] Descarga de mensaje: detalle de peticines a ls ws LexNET

19 [T21] En primer lugar, la aplicación realizará una llamada a ObtenerPendientes para cncer ls mensajes recibids nuevs que tdavía n se hubiera descargad [T22] En respuesta a la petición anterir, LexNET indicará el nº de mensajes cuy destinatari es el usuari lgad que están pendientes de descarga [T23] La aplicación pdrá slicitar la descarga de la cabecera de ls mensajes deseads. Ej: ls mensajes pendientes de descarga únicamente cualquiera que cumpla una serie de cndicines (fecha de enví, etc.) [T24] En respuesta, LexNET prprcinará la cabecera de ls mensajes slicitads (que cumplen las cndicines indicadas en la petición anterir y cuy destinatari es el usuari lgad). [T25] A cntinuación, la aplicación pdrá slicitar la descarga de un mensaje en específic cuy identificadr habrá sid btenid previamente (Ej: a través ObtenerCabeceras). Para ell, hará una slicitud al servici web ObtenerMensaje. Nta: en el cas de aquells usuaris que requieran la firma de recibí previa a la descarga de su mensaje (Ej: abgads), LexNET requerirá, previa a la slicitud de ObtenerMensaje la invcación de un cnjunt de servicis web que

20 permitirían el enví del recibí. En este cas, ver la descripción del servici web EnviarVerificacinLectura. [T26] En respuesta, LexNET prprcinará tds ls dats del mensaje así cm ls identificadres de ls dcuments principal y adjunts asciads al mensaje, l que psibilitará su descarga subsiguiente. [T27..T27+n] La aplicación pdrá slicitar la descarga en blques de ls dcuments principal y adjunts cuys identificadres fuern btenids en el pas anterir. Para ell, se realizará sucesivas llamadas al servici web ObtenerBlque. [T28..T28+n] LexNET prprcinará ls blques de ls dcuments slicitads. [T29] Una vez, descargads tds ls blques del dcument principal y de tds ls adjunts, la aplicación realizará una slicitud al servici web TerminarDescarga, para indicarle a LexNET la finalización del prces de descarga del mensaje cmplet. [T3] La aplicación finalizará su sesión cn LexNET haciend una invcación al servici de LgOut.

21 2.2. Arquitectura de intercnexión desde servidr (certificad de servidr/aplicación) Cnexión cn LexNET La segunda psibilidad de intercnexión cn LexNET es una arquitectura que psibilita la gestión de las cnexines desde un servidr de aplicacines, n siend necesaria la cnexión desde la ubicación prpia del cliente. Para ell, la aplicación establecerá en primer lugar una cnexión SSL cn LexNET utilizad el certificad de servidr de la aplicación desarrllada. Psterirmente, LexNET permite iniciar la invcación a sus servicis web, de acuerd cn las funcinalidades requeridas, slicitand el enví de un tken firmad pr el usuari, de frma periódica y en cada tip de enví que implique firma del usuari justificación de interacción del mism para el intercambi slicitad. Figura 6 Arquitectura de intercnexión cliente-servidr-lexnet

22 Ejempl de us e invcación de ls servicis web LexNET El us de ls principales servicis web de LexNET requiere la invcación de ls misms en un rden determinad. A cntinuación se detalla el prces de invcación para ds de ls prcess más imprtantes aprtads pr LexNET, utilizand una arquitectura de invcación desde servidr, habiéndse establecid previamente una cnexión SSL cn LexNET cn el certificad de servidr de dicha aplicación. Nta: La descripción detallada de us e invcación de tds ls servicis web frecids pr LexNET se encuentra en el apartad 3

23 Autenticación en LexNET La autenticación en LexNET, utilizand una arquitectura de intercnexión cn certificad de servidr, habiéndse establecid previamente SSL cn el certificad de servidr, implica ls siguientes pass: Invcación a SlicitudLginTken: la aplicación cliente iniciará la slicitud de lgin, enviand su identificadr de aplicación. LexNET, enviará cm respuesta un tken Invcación a LginTken: la aplicación cliente enviará a LexNET el tken (remitid pr LexNET en respuesta a la petición anterir) firmad cn el certificad del usuari cnectad.

24 Invcación a ls servicis web de LexNET: la aplicación cliente invcará a ls distints servicis web frecids pr LexNET. Tras un perid de caducidad, la invcación a cualquiera de ls servicis web de LexNET devlverá una respuesta de errr (errr indicativ de tken caducad y de necesidad de cnfirmar la presencia del usuari) junt cn un tken nuev que será necesari firmar. La aplicación cliente deberá firmar el nuev tken cn el certificad del usuari y enviarl de nuev a LexNET. Invcación a LginTken: la aplicación cliente enviará a LexNET el tken firmad pr el usuari. Invcación a ls servicis web de LexNET: la aplicación cliente pdrá seguir invcand ls servicis web de LexNET

25 Figura 7 Autenticación en LexNET (cnexión cn certificad de servidr)

26 Enví de mensajes El enví de mensajes a través de LexNET, utilizand una arquitectura de intercnexión cn certificad de servidr, implica ls siguientes pass: Invcación a EnviarMensajeTken: la aplicación cliente slicitará el enví de un mensaje. LexNET devlverá la plantilla de mensaje de enví (SMIME CADES) junt cn un tken. La aplicación cliente deberá generar el mensaje de enví, firmad pr el usuari y firmar el tken remitid. Invcación a EnviarBlqueTken: la aplicación cliente enviará a LexNET el mensaje, dividid en blques, a través de invcacines sucesivas a EnviarBlqueTken. En la primera de las invcacines (primer blque), la aplicación cliente remitirá a LexNET el primer blque de enví del mensaje junt cn el tken firmad.

27 Figura 8 Enví de mensajes (cnexión cn certificad de servidr) Descarga de mensajes La descarga de mensajes desde LexNET (ej.: descarga de ntificacines), utilizand una arquitectura de intercnexión cn certificad de servidr, implica ls siguientes pass:

28 Invcación a ObtenerPendientes: la aplicación cliente, slicitará cncer el nº de mensajes recibids nuevs que tdavía n se hubiera descargad Invcación a ObtenerCabeceras: la aplicación cliente, slicitará la cabecera de ls mensajes recibids Invcación a EnviarVerificacinLecturaTken (en cas de usuaris que requieran firma de recibí; ej.: abgads, graduads sciales): la aplicación cliente slicitará el enví de un recibí. LexNET devlverá la plantilla de mensaje de enví (SMIME CADES) junt cn un tken. La aplicación cliente deberá generar el mensaje de enví (recibí), firmad pr el usuari y firmar el tken remitid. Invcación a EnviarBlqueTken: la aplicación cliente enviará a LexNET el recibí, dividid en blques, a través de invcacines sucesivas a EnviarBlqueTken. En la primera de las invcacines (primer blque), la aplicación cliente remitirá a LexNET el primer blque de enví del mensaje junt cn el tken firmad. Invcación a ObtenerMensaje: la aplicación cliente slicitará la descarga del mensaje Invcación a ObtenerBlque: la aplicación cliente slicitará la descarga en blques de ls dcuments principal y adjunts del mensaje. Ls identificadres de dichs dcuments fuern btenids en el pas anterir. Para ell, se realizará sucesivas llamadas al servici web ObtenerBlque. Invcación a TerminarDescarga: una vez descargads tds ls blques del dcument principal y de tds ls adjunts, la aplicación cliente realizará una slicitud al servici

29 web TerminarDescarga, para indicarle a LexNET la finalización del prces de descarga del mensaje cmplet. Figura 9 Descarga de mensajes (cnexión cn certificad de servidr)

30 3. DESCRIPCIÓN DE LOS SERVICIOS WEB LEXNET En este apartad se detallan ls servicis Web de LexNET incluyend su descripción y parámetrs de entrada y salida. Para facilitar la integración de las aplicacines clientes, cada una de las peracines que se pueden realizar en LexNET a través de servicis web, se han definid cm un servici web independiente, cada un cn una sla peración. Cm se verá más adelante en la definición WSDL de ls servicis web, cada un de ells (cn su única peración) aceptan cm parámetr de entrada un String, el cual representa un mensaje frmatead en XML a través del cual se envían ls dats necesaris para realizar la peración que representa. Asimism, el mensaje de respuesta que envía el servidr LexNET será también un String frmatead en XML cn ls dats específics de la peración realizada, en cas de que curra algún errr, ls dats del mism. Cm la respuesta de errr es cmún para tds ls servicis, se indica el frmat de dicha respuesta de errr en el apartad De us general (cnexión cn certificad de usuari de aplicación) A cntinuación se muestran el cnjunt de servicis web de us general, que pueden ser utilizads en ls ds tips de arquitecturas explicadas en el apartad 2.

31 Respuesta de errr Descripción Se dedica este apartad al mensaje de respuesta de errr ya que es únic para tds ls servicis. Además, cm se pdrá apreciar en las definicines WSDL, ningun de ls servicis web define un mensaje default en sus peracines, est es debid a que en cas de errr se utiliza el mism mensaje de salida. Es pr est que las aplicacines clientes, al recibir una respuesta de cualquiera de ls servicis web, deberán preguntar si el mensaje es de errr de respuesta real a la peración invcada. El mensaje de errr incluye infrmación sbre el mment en que curre el errr, códigs definids (para más infrmación sbre ls códigs de errr cnsulte el apartad 4.1), un mensaje explicativ y el módul en el que curre. En el ejempl que se muestra a cntinuación se ha escenificad el siguiente errr: se slicita la peración ObtenerMensaje pr parte de un usuari que requiere el enví de una verificación de lectura previ a la petición de este servici web. El servici ObtenerMensaje devlvería un mensaje de errr, causad pr el hech de que el usuari necesitaba enviar una verificación de lectura antes de descargar el mensaje Mensaje SOAP de Respuesta <?xml versin="1.0" encding="utf-8"?> <sap:envelpe xmlns:sap=" xmlns:xsi=" xmlns:xsd=" <sap:bdy> <ObtenerMensajeOut xmlns=" <?xml versin="1.0" encding="utf-8"?>

32 <mensajews xmlns=" xmlns:xsi=" xsi:schemalcatin=" <respuestaerrr> <tiemp>[fechaerrr]</tiemp> <cdig>[cdigerrr]</cdig> <text>[text]</text> <actr>[actr]</actr> <detalle>[detalle]</detalle> <tken>[tken]</tken> </respuestaerrr> </mensajews> </ObtenerMensajeOut> </sap:bdy> </sap:envelpe> Ls elements resaltads se enumeran a cntinuación: fechaerrr: Mment en que se prduce el errr (según la hra del servidr LexNET). cdigerrr: Códig del errr. Para más infrmación sbre ls psibles códigs de errr cnsulte en el Anex, el apartad Códigs de errr devuelts pr el servidr text: Text descriptiv del errr actr: El módul que causa detecta el errr. detalle: Una descripción más detallada del errr y sus psibles causas y slucines. tken: tken que ha de ser firmad pr aquellas aplicacines centralizadas de usuari prfesinales que hagan us de ls servicis web una vez que ha terminad el tiemp máxim de us.

33 LgOut Descripción Este servici permite a una aplicación cliente de ls servicis web LexNET slicitar la descnexión del sistema. En el lad del servidr LexNET se libera tda la infrmación n permanente de la sesión, impidiend futuras peracines cn esta sesión Ruta WSDL Ruta WSDL (entrn de Pruebas): Definición WSDL <?xml versin="1.0" encding="utf-8"?> <definitins xmlns:sap=" xmlns:xs=" xmlns:impl=" targetnamespace=" xmlns=" <types> <xs:schema elementfrmdefault="qualified" targetnamespace=" <xs:element name="lgutin" type ="xs:string" /> </xs:schema> </types> <message name="lgutsapin"> <part name="lgutrequest" element="impl:lgutin" /> </message> <message name="lgutsapout" /> <prttype name="lgutprttype"> <peratin name="lgut"> <input message="impl:lgutsapin" /> <utput message="impl:lgutsapout" /> </peratin> </prttype> <binding name="lgutservicesap" type="impl:lgutprttype"> <sap:binding transprt=" style="dcument" /> <peratin name="lgut"> <sap:peratin sapactin=""/>

34 <input> <sap:bdy use="literal" /> </input> <utput> <sap:bdy use="literal" /> </utput> </peratin> </binding> <service name="lgutservice"> <prt name="lgut" binding="impl:lgutservicesap"> <sap:address lcatin=" </prt> </service> </definitins> Mensaje SOAP de Petición <?xml versin="1.0" encding="utf-8"?> <sap:envelpe xmlns:sap=" xmlns:xsi=" xmlns:xsd=" <sap:bdy> <LgutIn xmlns=" <![CDATA[ <?xml versin="1.0" encding="utf-8"?> <mensajews xmlns=" xmlns:xsi=" xsi:schemalcatin=" <slicitudlgut> <idsesin>[idsesin]</idsesin> <idaplicacin>[idaplicacin]</idaplicacin> </slicitudlgut> </mensajews> ]]> </LgutIn> </sap:bdy> </sap:envelpe> Ls elements resaltads se enumeran a cntinuación: idsesin: Identificadr de la sesión que se desea terminar. idaplicacin: Identificadr de la aplicación desde la que se hace la petición de fin de sesión.

35 Validacines Este servici web n realiza ninguna cmprbación Mensaje SOAP de Respuesta El servici web n genera ninguna respuesta ObtenerRles Descripción Esta funcinalidad permite a un usuari de una aplicación cliente de ls servicis web LexNET, cnsultar ls rles que dispne en LexNET así cm cncer su rl principal, es decir, aquel cn el que accede pr defect al sistema cuand se realiza la petición de Lgin Ruta WSDL Ruta WSDL (entrn de Pruebas): Definición WSDL <?xml versin="1.0" encding="utf-8"?> <definitins xmlns:sap=" xmlns:xs=" xmlns:impl=" targetnamespace=" xmlns=" <types> <xs:schema elementfrmdefault="qualified" targetnamespace=" <xs:element name="obtenerrlesin" type ="xs:string" /> </xs:schema> </types>

36 <message name="obtenerrlessapin"> <part name="btenerrlesrequest" element="impl:obtenerrlesin" /> </message> <message name="obtenerrlessapout" /> <prttype name="obtenerrlesprttype"> <peratin name="obtenerrles"> <input message="impl:obtenerrlessapin" /> <utput message="impl:obtenerrlessapout" /> </peratin> </prttype> <binding name="obtenerrlesservicesap" type="impl:obtenerrlesprttype"> <sap:binding transprt=" style="dcument" /> <peratin name="obtenerrles"> <sap:peratin sapactin=""/> <input> <sap:bdy use="literal" /> </input> <utput> <sap:bdy use="literal" /> </utput> </peratin> </binding> <service name="obtenerrlesservice"> <prt name="obtenerrles" binding="impl:obtenerrlesservicesap"> <sap:address lcatin=" </prt> </service> </definitins> Mensaje SOAP de Petición <?xml versin="1.0" encding="utf-8"?> <sap:envelpe xmlns:sap=" xmlns:xsi=" xmlns:xsd=" <sap:bdy> <ObtenerRlesIn xmlns=" <![CDATA[ <?xml versin="1.0" encding="utf-8"?> <mensajews xmlns=" xmlns:xsi=" xsi:schemalcatin=" <slicitudobtenerrles> <idsesin>[idsesin]</idsesin> <idaplicacin>[idaplicacin]</idaplicacin> </slicitudobtenerrles> </mensajews> ]]> </ObtenerRlesIn> </sap:bdy> </sap:envelpe>