OBTENER CATALOGO GENERAL

Este servicio web, permite obtener diversos catálogos de datos de LexNET. Nota: Se recomienda consultar estos catálogos de forma periódica y no continúa en cada conexión a LexNET al tratarse de catálogos de datos con pocas variaciones a lo largo del tiempo.

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 ya que el usuario previamente lo ha debido introducir con anterioridad.

  • catalogo: se verifica que el código de catálogo solicitado existe.

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.

diagram
Figure 1. Diagrama de secuencia

Entrada al servicio

El parámetro de entrada a este método del servicio es el siguiente:

diagram
Figure 2. Campos de la petición como un diagrama de clases
Ejemplo de entrada al servicio.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ent="http://platino.gobcan.es/servicios/lexnet/entidades">
  <soapenv:Header/>
  <soapenv:Body>
    <ent:ObtenerCatalogoGeneral>
      <ent:ObtenerCatalogoGeneralIn>
        <![CDATA[<?xml version="1.0" encoding="UTF-8"?>
         <mensajeWS xmlns="https://wslexnet.webservices.lexnet/3.22"
         xsi:schemaLocation="https://wslexnet.webservices.lexnet/3.22
         schema.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
           <solicitudObtenerCatalogo>
             <idSesion>XXXXXXXXXXXXX</idSesion>
             <idAplicacion>YYYYYYYYYYYYY</idAplicacion>
             <catalogo>3212</catalogo>
             <comunidad>53</comunidad>
             <provincia>20</provincia>
           </solicitudObtenerCatalogo>
         </mensajeWS>]]>
      </ent:ObtenerCatalogoGeneralIn>
    </ent:ObtenerCatalogoGeneral>
  </soapenv:Body>
</soapenv:Envelope>

Salida del servicio

diagram
Figure 3. Campos de la respuesta como un diagrama de clases
Ejemplo de respuesta del servicio.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ns2:ObtenerCabecerasGeneralResponse xmlns:ns2="http://platino.gobcan.es/servicios/lexnet/entidades">
      <ns2:ObtenerCabecerasGeneralOut>
        <![CDATA[<?xml version="1.0" encoding="ISO-8859-1"?>
        <mensajeWS xmlns="https://wslexnet.webservices.lexnet/3.22"
        xsi:schemaLocation="https://wslexnet.webservices.lexnet/3.22 schema.xsd"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
          <respuestaObtenerCatalogo>
            <filas>
              <fila />
              <fila />
            </filas>
          </respuestaObtenerCatalogo>
        </mensajeWS>]]>
      </ns2:ObtenerCabecerasGeneralOut>
    </ns2:ObtenerCabecerasGeneralResponse>
  </soap:Body>
</soap:Envelope>

Dado que la respuesta se compone de multiples campos en función del tipo de catálogo solicitado se recomienda ver el archivo WSLexNET_3.22.xsd