amap-sia

Versión 1.4.1

Fecha: 27 Mazo 2019
- Exclusión de librerías bouncy castle de la versión jdk15on

Versión 1.4.0

Fecha: 25 Mazo 2019
- Creación de Implementación MOCK.
- Alineación de componentes bouncy castle a la versión jdk15on

Versión 1.3.1

Fecha: 27 Septiembre 2018
Se corrige bug en los métodos de alta y modificación de las actuacones.

Versión 1.3.0

Fecha: 20 Septiembre 2018
Se añade un nuevo campo, codigoOrigen, para altas y modificaciones de las actuacones.

Versión 1.2.0

Fecha: 17 Julio 2018
Se añade filtro para obtener actuaciones y catalogos activos
Se añade campo usuario, para la auditoría.
Cambio de implementación a httpclient.
Servicio Restful.

Versión 1.1.0

Fecha: 14 Noviembre 2017.
Se ha añadido dos campos en el método loadAdtuaciones, lo que permite elegir un rango fechas en la carga de actuaciones.

Versión 1.0.0

Fecha: 21 Septiembre 2017.
Versión inicial

<dependency>
<groupId>es.gobcantabria.amap.integracion</groupId>
<artifactId>amap-sia</artifactId>
<version>1.4.1</version>
</dependency>

Es necesario de disponer de los siguientes datos:

  • Servidor: nombre o ip del servidor donde se aloja el servidor de amap-sia

Sin recursos disponibles.

Configuración

Configuración de la factoría de servicios

Para la utilización del componente AMAP-SIA basta con añadir el jar y sus correspondientes dependencias al classpath de la aplicación y crear un servicio del siguiente modo:

SiaCliente servicio = SiaCliente.getService(url, usuarioProxy, implementación, aplicacion);

El servicio concreto a usar se definirá a partir de un fichero de properties junto con el resto de los parámetros:

KeyDescripciónEjemplo
sistemas.global.amap.sia.url.webserviceEndpoint del servicio web http://<host>/amap-sia-servidor/services/SiaWS
sistemas.global.amap.sia.url.restfulEndpoint del servicio web http://<host>/amap-sia-servidor/services/SiaRestfulWS
Los valores de las propieades aquí mostrados son meramente ilustrativos. En los entornos de desarrollo / preproducción y producción los valores de las variables han de ser externalizados tal y como se especifica en el documento Definición de acceso a propiedades de sistema

Ejemplo de contenido del fichero de propiedades:

sistemas.global.amap.sia.url.webservice=http://<host>/amap-sia-servidor/services/SiaWS
sistemas.global.amap.sia.url.restful=http://<host>/amap-sia-servidor/services/SiaRestfulWS

La configuración del componente se realiza a la hora de obtener la instancia del servicio. Los parámetros soportados son:

  • URL:  URL donde está desplegado el servicio (instancia de java.net.URL).
  • Implementacion (Opcional): existen 3 implementaciones:
    • WS: el cliente se conectará sobre los webservices SOAP de amap sia (opción por defecto).
    • RS: el cliente se conectará sobre los webservices RESTFUL de amap sia.
    • MOCK: cliente de prueba para la integración con el servicio sin necesidad de conectarse a ningún servidor (los parámetros serán ignorados).

Por lo que la forma convencional de generar un cliente, en el entorno de desarrollo, sería: 


SiaClienteInterface siaCliente = SiaCliente.getService(URL,USUARIOPROXYWS, IMPLEMENTACION, APLICACION);

Este cliente sería de tipo WS, , mientras que si queremos crear un cliente de tipo RESTFUL
la forma convencional de generar un cliente sería:


SiaClienteInterface siaCliente = SiaCliente.getService(
     new URL("http://******/amap-sia-servidor/services/SiaRestfulWS"),
     USUARIOPROXYWS,
     SiaClienteTipoImplementacion.SIA_CLIENTE_RS, APLICACION);

Una vez obtenido el servicio se podrá invocar cualquiera de sus métodos.

Para el servicio web deberemos considerar el siguiente modelo de dominio:

UML SIA 1

UML SIA 2

UML SIA 4

UML SIA 3

Nombreamap-sia
Identificadoramap-sia
Grupoes.gobcantabria.amap.integracion
Versión1.4.1
Licencia
DesarrolladorGobierno de Cantabria
Descripción

El componente cuya función básica es la de actuar como catálogo de información sobre tramitación administrativa, incluyéndose procedimientos administrativos y servicios dirigidos al ciudadano.

Documentaciónamap-sia (JavaDoc)
Binarioamap-sia (Jar)
Dependenciasamap-sia (Librerías)

Sin particularidades. Seguir las recomendaciones del fabricante.

Introducción

Una vez creado el servicio, tal y como se indica en el apartado de configuración, se pueden acceder a los métodos disponibles.

Servicio Web

Consultar actuaciones

Devuelve la información de las actuaciones que cumplen un determinado filtro

Consulta sin detalle de todas las actuaciones

String filtroCodigoActuacion = null;
String filtroTipo = null;
String filtroInterno = null;
String filtroEstado = null;
String filtroComunidad= null;
Boolean detallado = false;

        
ResponseActuacion actuaciones = getSiaCliente().getActuacion(filtroCodigoActuacion,
                                filtroTipo, filtroInterno, filtroEstado, 
                                filtroComunidad, detallado);

Consulta detallada de las actuaciones por codigo

String filtroCodigoActuacion = "130024";
Boolean  detallado = true;
  
ResponseActuacion actuaciones = getSiaCliente().getActuacion(filtroCodigoActuacion,
                                null, null, null,null, detallado);

Consulta sin detalle de todas las actuaciones activas con usuario auditoria

String filtroCodigoActuacion = null;
String filtroTipo = null;
String filtroInterno = null;
String filtroEstado = null;
String filtroComunidad= null;
Boolean detallado = false;
Boolean activo = true:
String usuario = "xxxxxx";
  
ResponseActuacion actuaciones = getSiaCliente().getActuacion(filtroCodigoActuacion,
                                filtroTipo, filtroInterno, filtroEstado, 
                                filtroComunidad, detallado, activo, usuario);

Consulta detallada de las actuaciones por codigo activas con usuario auditoria 

String filtroCodigoActuacion = "130024";
Boolean  detallado = true;
Boolean activo =true;
String usuario = "xxxxxx";
  
ResponseActuacion actuaciones = getSiaCliente().getActuacion(filtroCodigoActuacion,
                                null, null, null,null, detallado, activo, usuario);

Consultar forma de iniciación

Devuelve la información de las formas de iniciación

Consulta por el identificador de la forma de iniciación

String filtroId = null; 
 
ResponseCatalogoFormaIniciacion catalogo = getSiaCliente().getFormaIniciacion(filtroId);

Consulta por el identificador de la forma de iniciación activas con usuario auditoria

String filtroId = null; 
Boolean activo=true;
String usuario = "xxxxxx";
 
ResponseCatalogoFormaIniciacion catalogo = getSiaCliente().getFormaIniciacion(filtroId, activo, usuario);

Consultar tipología

Devuelve la información de las tipoligías

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoTipologia catalogo = getSiaCliente().getTipologia(filtroId);

Consulta activos por el identificador con usuario auditoria

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoTipologia catalogo = getSiaCliente().getTipologia(filtroId, activo, usuario);

Consultar administración electrónica

Devuelve la información de las administraciones electrónicas

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoNivelAdminElec catalogo = getSiaCliente().getNivelAdminElec(filtroId);

Consulta activos por el identificador con usuario auditoria

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoNivelAdminElec catalogo = getSiaCliente().getNivelAdminElec(filtroId, activo, usuario);

Consultar estado

Devuelve la información de los estados

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoEstado catalogo = getSiaCliente().getEstado(filtroId);

Consulta activos por el identificador con usuario auditoria 

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoEstado catalogo = getSiaCliente().getEstado(filtroId, activo, usuario);

Consultar canal acceso

Devuelve la información de los canales acceso

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoCanalAcceso catalogo = getSiaCliente().getCanalAcceso(filtroId);

Consulta activos por el identificador con usuario auditoria 

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoCanalAcceso catalogo = getSiaCliente().getCanalAcceso(filtroId, activo, usuario);

Consultar portal

Devuelve la información de los portales

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoPortal catalogo = getSiaCliente().getPortal(filtroId);

Consulta activos por el identificador con usuario auditoria 

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoPortal catalogo = getSiaCliente().getPortal(filtroId, activo, usuario);

Consultar temática

Devuelve la información de las temáticas 

Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoTematica catalogo = getSiaCliente().getTematica(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoTematica catalogo = getSiaCliente().getTematica(filtroId, activo, usuario);

Consultar integrado clave

Devuelve la información de integrado clave
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoIntegradoClave catalogo = getSiaCliente().getIntegradoClave(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoIntegradoClave catalogo = getSiaCliente().getIntegradoClave(filtroId, activo, usuario);

Consultar tipo actuación

Devuelve la información de los tipos de actuación
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoActuacion catalogo = getSiaCliente().getTipoActuacion(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoActuacion catalogo = getSiaCliente().getTipoActuacion(filtroId, activo, usuario);

Consultar documento común

Devuelve la información de los documentos comunes
Consulta por el identificador, entidad emisora e intermediario

String filtroId = null;
String filtroEntiEmi = null;
String filtroInter = null;
  
ResponseCatalogoDocumentoComun catalogo = getSiaCliente().getDocumentoComun(filtroId, filtroEntEmi, filtroInter);

Consulta activos por el identificador con usuario auditoria , entidad emisora e intermediario*

String filtroId = null;
String filtroEntiEmi = null;
String filtroInter = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoDocumentoComun catalogo = getSiaCliente().getDocumentoComun(filtroId, filtroEntEmi, filtroInter, activo, usuario);

Consultar sistema identificación

Devuelve la información de los sistemas de  identificación
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoSistemasId catalogo = getSiaCliente().getSistemasId(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoSistemasId catalogo = getSiaCliente().getSistemasId(filtroId, activo, usuario);

Consultar entidad emisora

Devuelve la información de las entidades emisoras
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoEntidadEmisora catalogo = getSiaCliente().getEntidadEmisora(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoEntidadEmisora catalogo = getSiaCliente().getEntidadEmisora(filtroId, activo, usuario);

Consultar destinatario

Devuelve la información de los destinatarios
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoDestinatario catalogo = getSiaCliente().getDestinatario(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoDestinatario catalogo = getSiaCliente().getDestinatario(filtroId, activo, usuario);

Consultar lista portal

Devuelve la información de lista portal
Consulta por el identificador y por código de DIR3

String filtroId = null;
String filtroDir3 = null;
  
ResponseCatalogoListaPortal catalogo = getSiaCliente().getListaPortal(filtroId, filtroDir3);

Consulta activos por el identificador con usuario auditoria  y por código de DIR3

String filtroId = null;
String filtroDir3 = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoListaPortal catalogo = getSiaCliente().getListaPortal(filtroId, filtroDir3, activo, usuario);

Consultar plazo resolución

Devuelve la información de los plazos de resolución
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoPlazoResolucion catalogo = getSiaCliente().getPlazoResolucion(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoPlazoResolucion catalogo = getSiaCliente().getPlazoResolucion(filtroId, activo, usuario);

Consultar rango

Devuelve la información de los rangos
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoRango catalogo = getSiaCliente().getRango(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoRango catalogo = getSiaCliente().getRango(filtroId, activo, usuario);

Consultar efectos silencio

Devuelve la información de los efectos silencio
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoEfectosSilencio catalogo = getSiaCliente().getEfectosSilencio(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoEfectosSilencio catalogo = getSiaCliente().getEfectosSilencio(filtroId, activo, usuario);

Consultar requisitos indentificación

Devuelve la información de los requisitos indentificación
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoRequisitosId catalogo = getSiaCliente().getRequisitosId(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoRequisitosId catalogo = getSiaCliente().getRequisitosId(filtroId, activo, usuario);

Consultar notificaciones

Devuelve la información de las notificaciones
Consulta por el identificador

String filtroId = null;
  
ResponseCatalogoNotificaciones catalogo = getSiaCliente().getNotificaciones(filtroId);

Consulta activos por el identificador con usuario auditoria  

String filtroId = null;
Boolean activo=true;
String usuario = "xxxxxx";
  
ResponseCatalogoNotificaciones catalogo = getSiaCliente().getNotificaciones(filtroId, activo, usuario);

Alta actuaciones

Manda la petición de alta las actuaciones y devuelve la información de la operación.
Este método está sobrecargado:
 - createActuaciones(List<AltaActuacionRequest> actuaciones)
 - createActuaciones(List<AltaActuacionRequest> actuaciones, String usuarioAuditoria)
Campos obligatorios:
 - Código origen
 - Interno
 - Común
 - Código tipo
 - Denominación
 - Departamento
 - Destinatario
 - Nivel administración electrónica
 - Url
 - Fin vía

Alta de una lista de actuaciones por el codigo actuación

List<AltaActuacionRequest> actuaciones = new ArrayList<AltaActuacionRequest>();
AltaActuacionRequest actuacion = new AltaActuacionRequest();

CodigoRequest codigo = new CodigoRequest();
codigo.setId(1);

List<CodigoRequest> listaDestinatarios = new ArrayList<CodigoRequest>();
listaDestinatarios.add(codigo);

actuacion.setCodigoOrigen("XXXXX");
actuacion.setInterno("N");
actuacion.setComun("N");
actuacion.setCodTipo("S");
actuacion.setDenominacion("Denominación");
actuacion.setEstadoActuacion(1);
actuacion.setDescripcion("Descripción");
actuacion.setCodTipologia(2);
actuacion.setDepartamento("XXXXXX");
actuacion.setListaDestinatarios( listaDestinatarios );
actuacion.setCodNivelAdminElectronica(1);
actuacion.setUrl("www.url.com");
actuacion.setFinVia("S");
  
actuaciones.add(actuacion);
  
DatosResponse respuesta = getSiaCliente().createActuaciones(actuaciones, "Usuario");

Modificar actuaciones

Modifica las actuaciones y devuelve la información de la operación.
Este método está sobrecargado:
 - updateActuaciones(List<AltaActuacionRequest> actuaciones);
 - updateActuaciones(List<AltaActuacionRequest> actuaciones, String usuarioAuditoria);
Campos obligatorios:
 - Código actuación
 - Código origen
 - Interno
 - Común
 - Código tipo
 - Denominación
 - Departamento
 - Destinatario
 - Nivel administración electrónica
 - Url
 - Fin vía

Si no se indica valor a un campo se borrará el valor actual de dicho campo.

Modifica una lista de actuaciones por el codigo actuación

List<ModificarActuacionRequest> actuaciones = new ArrayList<ModificarActuacionRequest>()
ModificarActuacionRequest actuacion = new ModificarActuacionRequest()
  
actuacion.setCodigoActuacion("123546");
actuacion.setCodigoOrigen("XXXXX");
actuacion.setInterno("N");
actuacion.setComun("N");
actuacion.setCodTipo("1");
actuacion.setDenominacion("1");
actuacion.setEstadoActuacion(1);
actuacion.setDescripcion("descripcion");
actuacion.setCodTipologia(2);
actuacion.setDepartamento("123456");
actuacion.setListaDestinatarios( listaDestinatarios );
actuacion.setCodNivelAdminElectronica(1);
actuacion.setUrl("www.url.com");
actuacion.setFinVia("S");
  
actuaciones.add(actuacion);
  
DatosResponse respuesta = getSiaCliente().updateActuaciones(actuaciones);

Baja actuaciones

Da de baja las actuaciones y devuelve la información de la operación
Este método está sobrecargado:
 - deleteActuaciones(List<AltaActuacionRequest> actuaciones)
 - deleteActuaciones(List<AltaActuacionRequest> actuaciones, String usuarioAuditoria)

Baja de una lista de actuaciones por el codigo actuación

List<BajaActuacionRequest> actuaciones = new ArrayList<BajaActuacionRequest>();
BajaActuacionRequest actuacion = new BajaActuacionRequest();
   
actuacion.setCodigoActuacion("201045"); 
actuaciones.add(actuacion);
   
DatosResponse respuesta = getSiaCliente().deleteActuaciones(actuaciones);

Actualiza  actuaciones

Actualiza la base de datos y devuelve la información del id de la importación.
Este método está sobrecargado:
 - loadActuaciones(String filtroFechaInicio, String filtroFechaFin)
 - loadActuaciones(String filtroFechaInicio, String filtroFechaFin, String auditoria)
Opcionalmente puede introducirse un rango de fechas: fechaInicio y filtroFechaFin, en formato dd-MM-YYYY.
Si alguno de los campos es null o vacío, se tomará como referencia la fecha de la última importación.
Actualiza la base de datos

String filtroFechaInicio=null
String filtroFechaFin=null
Long idImportacion = getSiaCliente().loadActuaciones(filtroFechaInicio, filtroFechaFin);

Actualiza  catálogos

Actualiza la base de datos y devuelve la información del id de la importación
Este método está sobrecargado:
 - loadCatalogos()
 - loadCatalogos(String auditoria)
Actualiza la base de datos

Long idImportacion = getSiaCliente().loadCatalogos("Usuario");
Etiquetas:
Creado por Administrator el 2017/03/02 13:29
© 2014 GOBIERNO DE CANTABRIA - AVISO LEGAL Y PROTECCIÓN DE DATOS