MARCO DE REFERENCIA PARA LA PLATAFORMA DE INTEROPERABILIDAD VOLÚMEN IV: MANUAL DEL DESARROLLADOR

Transcripción

1 Interoperabilidad de los servicios telemáticos de la Administración Pública de la CAC Página 1 de 101 MARCO DE REFERENCIA PARA LA PLATAFORMA DE INTEROPERABILIDAD VOLÚMEN IV: MANUAL DEL DESARROLLADOR SERVICIO DE GESTIÓN DEL REPOSITORIO DE DOCUMENTOS ELECTRÓNICOS Historial de revisiones en la siguiente página Documento: PLA-DOC-FIN-v4.0-Vol IV. Servicio de Gestion de Repositorio de Documentos Ubicación en eroom: Preparado por Revisado por Aprobado por D. Gral. de Telecomunicaciones y Nuevas Tecnologías. D. Gral. de Telecomunicaciones y Nuevas Tecnologías. D. Gral. de Telecomunicaciones y Nuevas Tecnologías. Fecha: 24/04/2018 Fecha: 24/04/2018 Fecha: 24/04/2018

2 Página 2 de 101

3 Página 3 de 101 ÍNDICE 1 INTRODUCCIÓN CAMBIOS DEL SERVICIO RESPECTO A LA VERSION ANTERIOR DESCRIPCIÓN DEL SERVICIO VERSIÓN DEL SERVICIO CASOS DE USO CU-RDE-01: INSERTAR DOCUMENTO CU-RDE-02: CREAR NIVEL CU-RDE-03: CREAR EXPEDIENTE CU-RDE-04: OBTENER DOCUMENTO CU-RDE-05: OBTENER DOCUMENTO NDE CU-RDE-06: OBTENER DOCUMENTO META CU-RDE-07: OBTENER DOCUMENTO META NDE CU-RDE-08: OBTENER METAINFORMACIÓN CU-RDE-09: OBTENER METAINFORMACIÓN NDE CU-RDE-10: BUSCAR DOCUMENTOS CU-RDE-11: BUSCAR DOCUMENTOS PAGINADO CU-RDE-12: CREAR ENLACE CU-RDE-13: ELIMINAR DOCUMENTO CU-RDE-14: MODIFICAR METADATOS CU-RDE-15: PASAR A EXPEDIENTE CU-RDE-16: CREAR PROCEDIMIENTO CU-RDE-17: ELIMINAR NIVEL CU-RDE-18: MODIFICAR PROCEDIMIENTO CU-RDE-19: OBTENER DOCUMENTO CON CAJA CONTROL DE EXCEPCIONES ErrorInternoException ElementoNoEncontradoException RutaNoValidaException MetaInformacionException ContenidoNoPermitidoException TamanoMaximoExcedidoException UsuarioNoValidoException ElementoIncorrectoException INFORMACIÓN ADICIONAL AL SERVICIO s de Datos...73

4 Página 4 de Contenido VersionDocumento HistoricoVersiones Interesado Interesados InformacionFirmaElectronica FirmasElectronicas Sellados InformacionSellado Procedimiento Expediente Nivel DocumentoBase DocumentoExpediente DocumentoSimple DocumentoCiudadano Documento ResultadoPaginado CARDINALIDAD Y HERENCIA TRANSMISIÓN DE ARCHIVOS ADJUNTOS POR SOAP MTOM EN LA PLATAFORMA.NET MTOM EN LA PLATAFORMA JAVA TIPOS MIME SOPORTADOS INCLUSIÓN DE CABECERAS ADICIONALES DE PLATINO...101

5 1 Página 5 de 101 INTRODUCCIÓN El objetivo de este documento es ofrecer al programador la información necesaria para hacer uso del Servicio de Gestión de Repositorio de Documentos (SGRDE) disponible en la plataforma PLATINO. El SGRDE pone a su disposición un repositorio de documentos electrónicos; en este repositorio podrá guardar, recuperar y buscar documentos. 1.1 CAMBIOS DEL SERVICIO RESPECTO A LA VERSION ANTERIOR Se añade un nuevo parámetro al método insertardocumento(datahandler contenido, ruta, DocumentoBase metainformacion,boolean limpiar) El nuevo parámetro limpiar será de tipo Boolean e indicará si se quiere que se limpien los metadatos del documento a insertar. Los posibles valores que puede tomar son: - True: SI limpia los metadatos. - False: NO limpia los metadatos. - Null: si no se indica, por defecto NO se limpiarán los metadatos,(análogo al false)

6 1.2 Página 6 de 101 DESCRIPCIÓN DEL SERVICIO Al igual que otros servicios de la plataforma PLATINO, el Servicio de Gestión de Repositorio de Documentos utiliza el intercambio de mensajes en formato XML dentro del bus de integración de servicios de PLATINO. Para que el programador pueda hacer uso del servicio deberá hacerlo a través de un punto de acceso a este bus. El bus de integración de PLATINO, basado en Apache ServiceMix, posee una buena cantidad de componentes que permiten adaptar los servicios desplegados en el bus a sistemas externos al bus. Estos componentes hacen que estén a su disposición una gran variedad de protocolos. De entre estos protocolos, en su mayoría estándares, cabe destacar SOAP, que le va a permitir consumir los servicios del bus utilizando servicios web. Este capítulo aportará la documentación para que pueda utilizar el servicio web del SGRDE publicado en el bus de integración.

7 2 Página 7 de 101 VERSIÓN DEL SERVICIO Este documento corresponde a las versiones del servicio 4.X. Para consultar la información completa de cambios del servicio ver Release_Notes.

8 3 Página 8 de 101 CASOS DE USO Las operaciones implementadas en el Servicio de Gestión de Repositorio de Documentos le permiten: realizar consultas sobre el repositorio de documentos, insertar nuevos documentos, crear nuevos niveles, crear nuevos expedientes, crear nuevos procedimientos, crear enlaces a documentos existentes en el repositorio, eliminar documentos, modificar metadatos del documento, obtener un documento, pasar documentos a un expediente, eliminar niveles. A continuación se muestra el diagrama de casos de uso del servicio.

9 Página 9 de 101 Figura 1: Casos de uso del SGRDE. Las operaciones de creación tienen como parámetro de entrada meta-información asociada al objeto que se va a crear, de esta manera el objeto queda clasificado y enriquecido en el repositorio. Las operaciones del servicio se describen a continuación.

10 3.1 Página 10 de 101 CU-RDE-01: INSERTAR DOCUMENTO Método para guardar en el repositorio un nuevo documento. Cuando desee guardar un documento en el repositorio, deberá tener en cuenta lo siguiente: La ruta donde desea localizar el documento dentro de la estructura jerárquica del repositorio, pues deberá especificarla como parámetro en la invocación de este método; si no existen los niveles (carpetas) intermedios que forman la ruta, el servicio creará cada uno de forma automática; tenga en cuenta que a esos niveles únicamente se les asociará los metadatos obligatorios; Que el tamaño del contenido del documento no sobrepasa los límites establecidos por el servicio, pues es ese caso la operación no tendría éxito, se produciría un error y la transmisión de datos se produciría en vano, La metainformación que desea asociar al documento (Ver ). No se permite guardar una nueva versión de un documento existente, en caso de que el documento que está en el repositorio esté firmado o sellado. En caso de que alguno de los niveles (carpetas) intermedios o el propio nombre del documento contengan más de 100 caracteres éstos se truncarán. Se permitirá, aún así, almacenar varios documentos cuyos 100 primeros caracteres sean los mismos puesto que dispondrán de URIs diferentes. Al obtener los metadatos de los documentos la ruta aparecerá truncada. El repositorio no utiliza la ruta para obtener documentos sino su URI. Como resultado de la operación obtendrá una cadena de caracteres con la URI que el servicio ha asignado al documento electrónico. Utilice esta cadena para identificar al documento en el resto de operaciones del servicio, allí donde se indique que se requiere la URI del documento.

11 Página 11 de 101 Interfaz: Entrada del servicio: documento Contenido del documento a guardar en el repositorio. base64binary ruta Ruta en la cual se va a introducir el documento en el repositorio. Ej: directorio/documento.pdf. metainformacion Meta-Información asociada al documento que se va a guardar. DocumentoBase limpiar Indica que se quiere que se limpien los metadatos del Boolean documento a insertar. Posibles valores:

12 Página 12 de True: si limpiar los metadatos. - False: no limpiar los metadatos. - Null: si no se indica, por defecto NO se limpiarán los metadatos,análogo al false. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:insertardocumento> <documento> <xop:include href="cid:documento@platino.gobcan.es" xmlns:xop=" /> </documento> <ruta>proc0033/expedientes/2008/ /memoria.pdf</ruta> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>TD99</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>APORT_CIUD_EN_TRAM</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <Nivel_LOPD>ALTO</Codigo_Nivel_LOPD> <Acceso>PUBLICO</Codigo_Acceso> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> <limpiar>false</limpiar> </ns2:insertardocumento> </soapenv:body> </soapenv:envelope> Salida del servicio:

13 Página 13 de 101 uri Identificador del documento insertado. Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:insertardocumentoresponse> <uri>urn:uuid:17f4fab3-a954-11dc f28d1e72c79</uri> </ns1:insertardocumentoresponse> </soapenv:body> </soapenv:envelope>

14 3.2 Página 14 de 101 CU-RDE-02: CREAR NIVEL Método para crear un nivel en el repositorio. Interfaz: Entrada del servicio: ruta ruta del repositorio en la cual se va a crear el nivel; debe incluir el nombre del nivel a crear. Ej: directorio/nivel. metainformacion Meta-Información asociada al nivel que se va a crear. Nivel Ejemplo de entrada. <?xml version="1.0"?>

15 Página 15 de 101 <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:crearnivel> <ruta>platino/procedimientoprueba/expedienteprueba/nivel</ruta> <metainformacion/> </ns2:crearnivel> </soapenv:body> </soapenv:envelope> Salida del servicio: uri URI que identifica el nivel. Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:crearnivelresponse> <uri>urn:uuid:f10362cb-a954-11dc f28d1e72c79</uri> </ns1:crearnivelresponse> </soapenv:body> </soapenv:envelope>

16 3.3 Página 16 de 101 CU-RDE-03: CREAR EXPEDIENTE Método para crear un expediente en la ruta del repositorio especificada. Interfaz: Entrada del servicio: ruta Ruta del repositorio en la cual se va a crear el expediente. Ej: expedientes/expediente. metainformacion Meta-Información asociada al expediente que se va a crear. Expediente Ejemplo de entrada. <?xml version="1.0"?>

17 Página 17 de 101 <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:crearexpediente> <ruta>platino/procedimientoprueba/expedienteprueba</ruta> <metainformacion> <Fecha_Apertura> T08:20:10</Fecha_Apertura> <Fecha_Cierre> T00:00:00</Fecha_Cierre> <Numero_Exp>CAC_876_23_76 TF543</Numero_Exp> <Desc_Exp>Descripcion del expediente</desc_exp> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> </metainformacion> </ns2:crearexpediente> </soapenv:body> </soapenv:envelope> Salida del servicio: uri URI que identifica al expediente.

18 Página 18 de 101 Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:crearexpedienteresponse> <uri>urn:uuid:8a a955-11dc f28d1e72c79</uri> </ns1:crearexpedienteresponse> </soapenv:body> </soapenv:envelope>

19 3.4 Página 19 de 101 CU-RDE-04: OBTENER DOCUMENTO Método para obtener el contenido de un documento del repositorio. Interfaz: Entrada del servicio: id La URI que Identifica el documento almacenado en el repositorio, cuyo contenido se desea obtener. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:obtenerdocumento> <id>urn:uuid:17f4fab3-a954-11dc f28d1e72c79</id> </ns2:obtenerdocumento>

20 Página 20 de 101 </soapenv:body> </soapenv:envelope> Salida del servicio: documento Contenido del documento (ver detalles en el apartado 5.3 base64binary TRANSMISIÓN DE ARCHIVOS ADJUNTOS POR SOAP). Ejemplo de salida. <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:obtenerdocumentoresponse> <documento> <xop:include xmlns:xop=" /> </documento> </ns1:obtenerdocumentoresponse> </soapenv:body> </soapenv:envelope>

21 3.5 Página 21 de 101 CU-RDE-05: OBTENER DOCUMENTO NDE Método para obtener el contenido de un documento del repositorio a partir de su NDE. Si desea recuperar el documento con el pie de página NDE, debe utilizar el método recuperardocumentoexpediente del Servicio de Soporte a la Tramitación Telemática (para obtener más información consulte el manual del desarrollador de este servicio). Interfaz: Entrada del servicio: NDE Número de Documento Electrónico del documento. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body>

22 Página 22 de 101 <ns2:obtenerdocumentonde> <NDE>1a345672fers23456ytgvdw3455redd2254</NDE> </ns2:obtenerdocumentonde> </soapenv:body> </soapenv:envelope> Salida del servicio: documento Contenido del documento.(ver detalles en 5.3) base64binary Ejemplo de salida. <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:obtenerdocumentonderesponse> <documento> <xop:include xmlns:xop=" /> </documento> </ns1:obtenerdocumentoresponse> </soapenv:body> </soapenv:envelope>

23 3.6 Página 23 de 101 CU-RDE-06: OBTENER DOCUMENTO META Método para obtener el contenido de un documento y su meta información. Interfaz: Entrada del servicio: id La URI que Identifica el documento almacenado en el repositorio, cuyo contenido se desea obtener. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:obtenerdocumentometa> <id>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</id> </ns2:obtenerdocumentometa>

24 Página 24 de 101 </soapenv:body> </soapenv:envelope> Salida del servicio: Documento Contenido del documento y meta información. (Ver ) Documento Ejemplo de salida. <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:obtenerdocumentometaresponse> <documento> <contenido> <Include href="cid:documento@platino.gobcan.es" xmlns=" </contenido> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple.xm l</ruta> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD>

25 Página 25 de 101 <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>0:11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> <Huella_Digital>11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Comentario de la versión 1.0</Comentario> </VersionDocumento> <VersionDocumento> <Numero>1.1</Numero> <Comentario>Comentario de la versión 1.1</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>1</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </documento> </ns1:obtenerdocumentometaresponse> </soapenv:body> </soapenv:envelope>

26 3.7 Página 26 de 101 CU-RDE-07: OBTENER DOCUMENTO META NDE Método para obtener el contenido de un documento y su meta información partir de su NDE. Interfaz: Entrada del servicio: NDE El NDE que identifica el documento almacenado en el repositorio, cuyo contenido se desea obtener. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body>

27 Página 27 de 101 <ns2:obtenerdocumentometande> <NDE>1a1fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> </ns2:obtenerdocumentometande> </soapenv:body> </soapenv:envelope> Salida del servicio: Documento Contenido del documento y meta información. (Ver ) Documento Ejemplo de salida. <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:obtenerdocumentometanderesponse> <documento> <contenido> <Include href="cid:documento@platino.gobcan.es" xmlns=" </contenido> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple.xm l</ruta>

28 Página 28 de 101 <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>0:11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> <Huella_Digital>11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Comentario de la versión 1.0</Comentario> </VersionDocumento> <VersionDocumento> <Numero>1.1</Numero> <Comentario>Comentario de la versión 1.1</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>1</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </documento> </ns1:obtenerdocumentometanderesponse> </soapenv:body> </soapenv:envelope>

29 3.8 Página 29 de 101 CU-RDE-08: OBTENER METAINFORMACIÓN Método para obtener la meta-información asociada a un documento. Interfaz: Entrada del servicio: id URI que identifica al documento cuya meta-información quiere obtenerse. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:obtenermetadoc> <id>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</id> </ns2:obtenermetadoc> </soapenv:body>

30 Página 30 de 101 </soapenv:envelope> Salida del servicio: metainformacion Meta-Información asociada al documento. DocumentoBase Ejemplo de salida. <?xml version="1.0"?> <soap:envelope xmlns:soap=" xmlns:sgr=" <soap:body> <sgr:obtenermetadocresponse> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple.xm l</ruta> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad>

31 Página 31 de 101 <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>1a1fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> <Huella_Digital>11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Comentario de la versión 1.0</Comentario> </VersionDocumento> <VersionDocumento> <Numero>1.1</Numero> <Comentario>Comentario de la versión 1.1</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>1</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </sgr:obtenermetadocresponse> </soap:body> </soap:envelope>

32 3.9 Página 32 de 101 CU-RDE-09: OBTENER METAINFORMACIÓN NDE Método para obtener la meta-información asociada a un documento a partir de su NDE. Interfaz: Entrada del servicio: NDE NDE que identifica al documento cuya meta-información quiere obtenerse. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:obtenermetadocnde> <NDE>1a1fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE>

33 Página 33 de 101 </ns2:obtenermetadocnde> </soapenv:body> </soapenv:envelope> Salida del servicio: metainformacion Meta-Información asociada al documento. DocumentoBase Ejemplo de salida. <?xml version="1.0"?> <soap:envelope xmlns:soap=" xmlns:sgr=" <soap:body> <sgr:obtenermetadocnderesponse> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple.xm l</ruta> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso>

34 Página 34 de 101 <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>1a1fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> <Huella_Digital>11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Comentario de la versión 1.0</Comentario> </VersionDocumento> <VersionDocumento> <Numero>1.1</Numero> <Comentario>Comentario de la versión 1.1</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>1</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </sgr:obtenermetadocnderesponse> </soap:body> </soap:envelope> 3.10 CU-RDE-10: BUSCAR DOCUMENTOS Método para realizar búsquedas de documentos y enlaces en el repositorio. Invoque este método para localizar documentos en el repositorio partiendo de un criterio de búsqueda. Los criterios de búsqueda que se pueden utilizar son ruta, nombre e interesado.

35 Página 35 de 101 El parámetro RUTA acepta solo una ruta en formato platino de las carpeta padre donde se encuentran los documentos, es decir, si realizamos una búsqueda solo con la ruta obtendremos todos los documentos que existan en esa ruta. No se acepta pseudo nombres, ni rutas parciales de rutas utilizando *, sino que se debe utilizar la ruta exacta. El parámetro NOMBRE acepta un solo nombre de documento y este tiene que ser exacto, no acepta pseudo nombres, ni nombre parciales utilizando *. El parámetro INTERESADO acepta una uri del interesado, no acepta pesudo uris, ni uris parciales utilizando *. Los parámetros del método se utilizan como una lógica AND, es decir, solo se podrá utilizar los parámetros para añadir más información acerca de los documentos a buscar, y no como una lógica selectiva o OR. Interfaz: Entrada del servicio:

36 Página 36 de 101 ruta Ruta del documento en el repositorio sin el nombre nombre Nombre del documento interesado Uri de interesado maxresultados Número máximo de resultados integer Ejemplo de entrada con ruta <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope> Ejemplo de entrada con nombre <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope>

37 Página 37 de 101 Ejemplo de entrada con interesado <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope> Ejemplo de ruta y nombre <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope>

38 Página 38 de 101 Ejemplo de ruta,nombre e interesado <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope> Ejemplo de nombre e interesado <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:buscardocumentos> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <maxresultados>10</maxresultados> </sgr:buscardocumentos> </soapenv:body> </soapenv:envelope>

39 Página 39 de 101 Salida del servicio: uri Array con las URIs de los documentos que concuerdan con el criterio de búsqueda. string[]. Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:buscardocumentosresponse> <uri>urn:uuid:28bcbc8a ec-9g85-aba32fg93363</uri> <uri>urn:uuid:23bccv8a xc-9w85-wer45er84362</uri> <uri>urn:uuid:56bcde8a dc-9y85-sdf86er79351</uri> </ns1:buscardocumentosresponse> </soapenv:body> </soapenv:envelope>

40 3.11 Página 40 de 101 CU-RDE-11: BUSCAR DOCUMENTOS PAGINADO Método similar al anterior pero con paginación de resultados. Interfaz: Entrada del servicio: ruta Ruta del documento en el repositorio sin el nombre nombre Nombre del documento interesado Uri de interesado pagina Número de página a devolver (comienza en el valor 1). integer resultadosporpagina Número máximo de resultados por página integer

41 Página 41 de 101 Ejemplo de ruta. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope> Ejemplo de nombre. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope>

42 Página 42 de 101 Ejemplo de interesado. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope> Ejemplo de ruta y nombre <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope>

43 Página 43 de 101 Ejemplo de ruta,nombre e interesado <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <ruta>expedientes/p_prueba_carciuexped_21_0/2017_08_02/a369c3fb e-9aef04daf08a1f0d</ruta> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope> Ejemplo de nombre e interesado <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:buscardocumentospaginado> <nombre>r2lsifjhbwlyzxosie9mzwxpyq==_oqfon.pdf</nombre> <interesado>platino://gobcan.es/servicios/terceros/tercero/ d a874c3c232e43</interesado> <pagina>1</pagina> <maxresultados>20</maxresultados> <resultadosporpagina>2</resultadosporpagina> </ns2:buscardocumentospaginado> </soapenv:body> </soapenv:envelope> Salida del servicio:

44 Página 44 de 101 ResultadoPaginado Estructura de datos con el contenido y parametrización de una página de resultados. Ver descripción de esta estructura en ResultadoPaginado. ResultadoPaginado numpagina Número de página devuelta; su valor coincidirá con el parámetro pagina. int numresultados Número de resultados encontrados en la búsqueda. int resultadosporpagina Número de resultados por página; su valor coincidirá con int el parámetro resultadosporpagina metainformacion Array con los metadatos de los documentos que concuerdan con el criterio de búsqueda. (Ver ) DocumentoBase[]. Ejemplo de salida <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:buscardocumentospaginadoresponse> <metainformacion xmlns:xsi="

45 Página 45 de 101 xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple.xm l</ruta> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>1a1fsdfl2342kljesflk234lj2nflkkoijejxclsdl</NDE> <Huella_Digital>11fsdfl2342kljesflk234lj2nflkkoijejxclsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Comentario de la versión 1.0</Comentario> </VersionDocumento> <VersionDocumento> <Numero>1.1</Numero> <Comentario>Comentario de la versión 1.1</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> <interesado> <URI_Interesado>OTROURIBDT</URI_Interesado> <Id_Interesado> F</Id_Interesado> <Desc_Interesado>José Pérez Pérez</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>1</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> <metainformacion xmlns:xsi="

46 Página 46 de 101 xsi:type="sgr:documentociudadano"> <_Doc>1</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>1</Codigo_Aportado> <Desc_Aportado>Aportado por el ciudadano</desc_aportado> <Formato>Formato</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/xml</_Mime> <URI>urn:uuid:cd64fd96-271f-11dd-ad3a-85d8fdd7182f</URI> <Ruta>platino/procedimientoPrueba/expedientePrueba/Nivel/2009/documentoSimple2.x ml</ruta> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <NDE>1g234asdasd234224lj2dfg7fghkkoi234234lsdl</NDE> <Huella_Digital>1234asdasd234224lj2dfg7fghkkoi234234lsdl</Huella_Digital> <historicoversiones> <VersionDocumento> <Numero>1.0</Numero> <Comentario>Primera Version</Comentario> </VersionDocumento> </historicoversiones> <interesados> <interesado> <URI_Interesado>URIBDT</URI_Interesado> <Id_Interesado> Y</Id_Interesado> <Desc_Interesado>Ismael Morales Alcaide</Desc_Interesado> </interesado> </interesados> <Codigo_Estado>2</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T18:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </ns1:buscardocumentospaginadoresponse> </soapenv:body> </soapenv:envelope>

47 3.12 Página 47 de 101 CU-RDE-12: CREAR ENLACE Método para crear enlaces a documentos existentes en el repositorio. La creación de enlaces permite que un mismo documento aparezca en varios puntos del árbol del repositorio de documentos. Es factible por tanto crear más de un enlace al mismo documento. El comportamiento de una operación sobre un documento es el mismo tanto si se especifica la ruta del enlace como si se especifica la ruta del documento. Para eliminar un enlace debe especificarse su URI y no la del documento. La URI del enlace la devuelve este método como resultado de su ejecución. Aunque no es necesario, se recomienda utilizar en el nombre del enlace la extensión.lnk. Interfaz: Entrada del servicio:

48 Página 48 de 101 ruta Ruta en el repositorio donde se creará el enlace; incluye el nombre del enlace. id Identificador del documento a enlazar. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:crearenlace> <ruta>proc0022/exp /2008/solicitud-alta.xml.lnk</ruta> <id>urn:uuid:28bcbc8a dc-9f85-aba82bd49364</id> </ns2:crearenlace> </soapenv:body> </soapenv:envelope> Salida del servicio: uri URI que identifica al enlace que se ha creado como resultado de esta operación. Ejemplo de salida. <?xml version="1.0"?>

49 Página 49 de 101 <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:crearenlaceresponse> <uri>urn:uuid:28bcbc8a dc-9f85-aba82bd49555</uri> </ns1:crearenlaceresponse> </soapenv:body> </soapenv:envelope>

50 3.13 Página 50 de 101 CU-RDE-13: ELIMINAR DOCUMENTO Método para eliminar documentos existentes en el repositorio. El uso de este método debe restringirse a la eliminación de documentos de archivo cuando se realice un expurgo o cuando el documento a eliminar carezca de valor, por ejemplo un documento temporal. En el resto de casos el uso de este método podría lanzar una excepción indicando que no se poseen los privilegios adecuados para realizar la operación de eliminación. Interfaz: Entrada del servicio: id URI que identifica el documento a eliminar.

51 Página 51 de 101 Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soapenv:body> <ns2:eliminardocumento> <id>urn:uuid:28bcbc8a dc-9f85-aba82bd49364</id> </ns2:eliminardocumento> </soapenv:body> </soapenv:envelope> Salida del servicio: No devuelve nada. Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:eliminardocumentoresponse/> </soapenv:body> </soapenv:envelope>

52 3.14 Página 52 de 101 CU-RDE-14: MODIFICAR METADATOS Método para modificar los metadatos de un documento existente en el repositorio. En caso de los metadatos de sellado, toma de los parámetros los datos de de Sellado, de de Sellado y la firma de sellado. Se extrae de la firma el resto de datos del sellado: nif, uri, cargo, NOTA: no se debe invocar al método modificarmetadatos después de realizar un registro de entrada, ya que es el propio servicio de registro el que se encarga de rellenar los metadatos de registro. Interfaz: Entrada del servicio:

53 Página 53 de 101 id URI que identifica el documento al que se le van a modificar los metadatos. metainformacion Meta-Información a modificar. DocumentoBase Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:modificarmetadatos> <id>urn:uuid:e63ba53d dd-a004-b55f06ccbb76</id> <metainformacion xmlns:xsi=" xsi:type="sgr:documentociudadano"> <_Doc>2</_Doc> <Desc_Doc> del tipo de documento</desc_doc> <Codigo_Aportado>2</Codigo_Aportado> <Desc_Aportado>Aportado por la CAC</Desc_Aportado> <Formato>Formato2</Formato> <Admite_Versionado>true</Admite_Versionado> <_Mime>text/txt</_Mime> <Codigo_Nivel_LOPD>2</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>medio</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <Codigo_Accesibilidad>1</Codigo_Accesibilidad> <Desc_Accesibilidad>trámite</Desc_Accesibilidad> <Codigo_Estado>2</Codigo_Estado> <Desc_Estado> del estado</desc_estado> <Fecha_Alta> T08:20:10</Fecha_Alta> <Fecha_Baja> T08:20:10</Fecha_Baja> </metainformacion> </sgr:modificarmetadatos> </soapenv:body> </soapenv:envelope>

54 Página 54 de 101 Salida del servicio: No devuelve nada. Ejemplo de salida. <?xml version="1.0"?> <soap:envelope xmlns:soap=" <soap:body> <sgr:modificarmetadatosresponse xmlns:sgr=" </soap:body> </soap:envelope>

55 3.15 Página 55 de 101 CU-RDE-15: PASAR A EXPEDIENTE Este método sirve para mover un nivel del repositorio, junto con los documentos que este contenga, a otra rama del repositorio. Lo habitual es invocarlo en el momento en que la solicitud y los documentos aportados deban pasar a formar parte del expediente correspondiente, y por ello que el nivel de destino cuelgue de un expediente. Los documentos simples contenidos en el nivel de origen se convertirán en documentos de expedientes. En ese instante se heredarán del expediente los metadatos cuyo valor deba provenir del expediente al que pertenecen. Interfaz: Entrada del servicio: rutaorigen Ruta que identifica el nivel de origen.

56 Página 56 de 101 uridestino URI que identifica el nivel de destino. nombrecarpeta Si se especifica este parámetro, el nivel de origen se renombrará con nombre especificado. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns2=" <soapenv:header/> <soap:body> <ns2:pasaraexpediente> <rutaorigen>proc001/nivel</urnorigen> <uridestino>urn:uuid:fdb175be-e87b-11dd-b6bf-fd30c7286a8f</uridestino> <nombrecarpeta>nuevonombre</nombrecarpeta> </ns2:pasaraexpediente> </soap:body> </soapenv:envelope> Salida del servicio: No devuelve nada.

57 3.16 Página 57 de 101 CU-RDE-16: CREAR PROCEDIMIENTO Método para crear un nivel en el repositorio correspondiente a un procedimiento administrativo. Actualmente, el uso de este método queda restringido al Servicio de la Base de Datos de Procedimientos. La invocación se produce cuando el administrador publica un Procedimiento Administrativo. Los backoffices no tendrá permisos para invocar este método. Interfaz: Entrada del servicio: ruta Ruta del procedimiento en el repositorio, incluyendo al procedimiento. metainformacion Meta información asociada al procedimiento. Procedimiento

58 Página 58 de 101 Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:crearprocedimiento> <ruta>expedientes/procedimientoprueba</ruta> <metainformacion> <Codigo>PC001</Codigo> <Titulo>Titulo del procedimiento</titulo> <Codigo_Org>ORG001</Codigo_Org> <Desc_Org>Organismo del procedimiento</desc_org> <Codigo_Unidad>UN001</Codigo_Unidad> <Desc_Unidad>Unidad administrativa del procedimiento</desc_unidad> <Version>1.0</Version> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <tipocontenido> <_Mime>text/html</_Mime> <_Mime>text/plain</_Mime> <_Mime>text/xml</_Mime> <_Mime>application/pdf</_Mime> <Max_Tam> </Max_Tam> </tipocontenido> </metainformacion> </sgr:crearprocedimiento> </soapenv:body> </soapenv:envelope> Salida del servicio:

59 Página 59 de 101 uri Identificador del procedimiento creado. Ejemplo de salida. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:ns1=" <soapenv:header/> <soapenv:body> <ns1:crearprocedimientoresponse> <uri>urn:uuid:17f4fab3-a954-11dc f28d1e72c79</uri> </ns1:crearprocedimientoresponse> </soapenv:body> </soapenv:envelope>

60 3.17 Página 60 de 101 CU-RDE-17: ELIMINAR NIVEL Método para eliminar una carpeta del repositorio correspondiente a un nivel, a un expediente o a un procedimiento. Para la eliminación de la carpeta, ésta debe encontrarse vacía. Interfaz: Entrada del servicio: ruta Ruta del nivel o carpeta a eliminar. Ejemplo de entrada.

61 Página 61 de 101 Salida del servicio: No devuelve nada. Ejemplo de salida.

62 3.18 Página 62 de 101 CU-RDE-18: MODIFICAR PROCEDIMIENTO Método para modificar los valores de los metadatos de un procedimiento en el repositorio. Actualmente, el uso de este método queda restringido al Servicio de la Base de Datos de Procedimientos. La invocación se produce cuando el administrador edita y guarda cambios en un Procedimiento Administrativo. Los backoffices no tendrá permisos para invocar este método. Interfaz: Entrada del servicio: id Ruta de la carpeta procedimiento a actualizar en el repositorio. metainformacion Meta información asociada al procedimiento. Procedimiento

63 Página 63 de 101 Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:modificarprocedimiento> <id>platino://gobcan.es/servicios/procedimientos/ c68-42e a43c7</id> <metainformacion> <Codigo>PC001</Codigo> <Titulo>Titulo del procedimiento</titulo> <Codigo_Org>ORG001</Codigo_Org> <Desc_Org>Organismo del procedimiento</desc_org> <Codigo_Unidad>UN001</Codigo_Unidad> <Desc_Unidad>Unidad administrativa del procedimiento</desc_unidad> <Version>1.0</Version> <Codigo_Nivel_LOPD>1</Codigo_Nivel_LOPD> <Desc_Nivel_LOPD>alto</Desc_Nivel_LOPD> <Codigo_Acceso>1</Codigo_Acceso> <Desc_Acceso>publico</Desc_Acceso> <tipocontenido> <_Mime>text/html</_Mime> <_Mime>text/plain</_Mime> <_Mime>text/xml</_Mime> <_Mime>application/pdf</_Mime> <Max_Tam> </Max_Tam> </tipocontenido> </metainformacion> </sgr:modificarprocedimiento> </soapenv:body> </soapenv:envelope> Salida del servicio: No devuelve nada.

64 Página 64 de 101 Ejemplo de salida.

65 3.19 Página 65 de 101 CU-RDE-19: OBTENER DOCUMENTO CON CAJA Método para obtener el contenido de un documento incluyendo la caja de firma junto con su meta información partir de su URI o NDE. Interfaz: Entrada del servicio: iddocumento Identificador del documento. Este identificador puede hacer referencia tanto a un documento por URI o por NDE IdDocumentoIte m reducible Indica si se fuerza a que el documento de solicitud se boolean reduzca. En el caso de ser nulo, será reducible dependiendo de los metadatos del documento. Plantilla Identificador de la plantilla de la caja de firma. Los valores int actuales posibles son: 1,2, 3 y 4. En función del número se elegirá las diferentes plantillas: Modelo 1 con un máximo de cuatro personas u organismos a representar en la caja de firma, entre firmantes, sellos y registros, en la última página del documento. Pudiendo darse múltiples combinaciones del tipo: 3 firmantes y 1 registros, 2 firmantes y 2 registros, 1 firmante y 3 registros, etc. En el resto de páginas caja pequeña con el NDE, código QR y URL de Verificación. Modelo 2 que crea una nueva página al final del documento original, donde no hay límites de firmantes, compulsas y registro, en todo el documento caja

66 firmado Página 66 de 101 pequeña con el NDE, código QR y URL de Verificación. Modelo 3 modelo ya existente en el que se muestra la misma caja en todas las páginas del documento. Modelo 4 muestra la misma información que aparece en la última página del modelo 1, pero en todas las páginas del documento. Cualquier otro valor numérico, provocara la selección dinámica entres los modelos 1 y 2 en función del número de firmantes, compulsas y registros, que sea si este número es inferior o igual a 4, entonces se escoge el modelo 1 y si es superior a 4 entonces se escoge el modelo2. Indica si se quiere obtener el documento con caja firmado por boolean un sello de órgano mediante una firma pades o sin firmar. - True: si firmar el documento con caja obtenido. - False: no firmar el documento con caja obtenido. Ejemplo de entrada. <?xml version="1.0"?> <soapenv:envelope xmlns:soapenv=" xmlns:sgr=" <soapenv:header/> <soapenv:body> <sgr:obtenerdocumentoconcaja> <iddocumento> <nde>111qciotnh7ypfd1111clapzq1111js6jr</nde> </iddocumento> <reducible>true</reducible> <plantilla>1</plantilla> <firmado>false</firmado> </sgr:obtenerdocumentoconcaja> </soapenv:body> </soapenv:envelope> Cabeceras Platino:

67 Página 67 de 101 En la invocación a este caso de uso, se pueden indicar las siguientes cabeceras adicionales de Platino: Cabecera uriprocedimiento Indica la uri del procedimiento en cuyos metadatos se almacena la información relacionada con el logotipo del organismo que aparecerá en el justificante así como la url de verificación de documentos electrónicos que aparecerá impresa junto a cada documento. Para ver un ejemplo de cómo incluir las cabeceras adicionales, ver apartado 5.5INCLUSIÓN DE CABECERAS ADICIONALES DE PLATINO Salida del servicio: Documento Contenido del documento y meta información. (Ver ) Documento Ejemplo de salida. <soap:envelope xmlns:soap="

68 Página 68 de 101 <soap:body> <ns2:obtenerdocumentoconcajaresponse xmlns:ns2=" <Documento> <contenido> <xop:include xmlns:xop=" </contenido> <metainformacion xsi:type="ns2:documentosimple" xmlns:xsi=" <_Doc>RES</_Doc> <Desc_Doc>DocumentoPrueba</Desc_Doc> <Codigo_Aportado>GENERADO_CAC_RED</Codigo_Aportado> <Admite_Versionado>false</Admite_Versionado> <_Mime>application/pdf</_Mime> <URI>urn:uuid:55bbaaaa-d9fc-aaaa-917a-aaaa860ed5e0</URI> <Ruta>expedientes/P_PORTAFIRMAS_SERIE_DOC/2013/03/05/doc-baaaafbb-aaaa-aaaaa258-93ede2f2a2fd.pdf</Ruta> <NDE>111QcIotnH7yPfD1111clApZq1111Js6jr</NDE> <Huella_Digital>MD5:4aaaaa21b7aaaaf397e9633aaaa1a16936</Huella_Digital> <historicoversiones/> <interesados/> <firmaselectronicas> <informacionfirmaelectronica> <URI_Firmante/> <Id_Firmante> T</Id_Firmante> <Desc_Firmante>JUAN GONZALEZ GONZALEZ</Desc_Firmante> <Cargo_Firmante>Sin cargo</cargo_firmante> <Fecha_Firma> T09:58:56Z</Fecha_Firma> </informacionfirmaelectronica> <informacionfirmaelectronica> <URI_Firmante/> <Id_Firmante> T</Id_Firmante> <Desc_Firmante>JUAN PEREZ PEREZ</Desc_Firmante> <Cargo_Firmante>Sin cargo</cargo_firmante> <Fecha_Firma> T09:58:22Z</Fecha_Firma> </informacionfirmaelectronica> <Firma><![CDATA[<?xml version="1.0" encoding="utf-8"?> <ds:signature xmlns:ds=" Id="XMLSignature2"> </ds:signature>]]></firma> </firmaselectronicas> <Fecha_Doc> T09:49:20.921Z</Fecha_Doc> <Doc_Ciudadano>false</Doc_Ciudadano> <Doc_Archivo>false</Doc_Archivo> </metainformacion>

69 Página 69 de 101 </Documento> </ns2:obtenerdocumentoconcajaresponse> </soap:body> </soap:envelope>

70 4 4.1 Página 70 de 101 CONTROL DE EXCEPCIONES ErrorInternoException Ocurre si se produce un error de funcionamiento interno del servicio. 4.2 ElementoNoEncontradoException Ocurre cuando queremos realizar cualquier operación sobre un documento que no existe. 4.3 RutaNoValidaException Ocurre si la ruta especificada no es válida en el repositorio.

71 4.4 Página 71 de 101 MetaInformacionException Ocurre cuando no es válida la metainformación especificada. 4.5 ContenidoNoPermitidoException Ocurre en caso de que el formato del documento no sea admitido por el repositorio.

72 4.6 Página 72 de 101 TamanoMaximoExcedidoException Ocurre si el documento a guardar excede el tamaño máximo. 4.7 UsuarioNoValidoException Ocurre al intentar ejecutar una operación sobre un elemento del repositorio sobre el que no se dispone de permisos. 4.8 ElementoIncorrectoException Ocurre al intentar ejecutar la operación de modificación de Procedimiento sobre un elemento que no es de tipo Procedimiento. 5 INFORMACIÓN ADICIONAL AL SERVICIO En este anexo se presentan detalles acerca de los tipos de datos asociados a los procedimientos, expedientes, niveles, y documentos del repositorio.

73 Página 73 de 101 Los valores de los datos de los documentos pueden ser asignados por le del servicio, autogenerados por el servicio o heredados de otros tipos de datos. Esta información se detalla en las tablas correspondiente como Origen. También se describe el método para la transmisión de archivos adjuntos por SOAP. 5.1 s de Datos A continuación se muestran los distintos tipos de datos gestionados por el servicio: Contenido _Mime Array con los tipos mimes permitidos en la [] carpeta. Asignado por el Max_Tam Tamaño máximo permitido de los documentos en la carpeta. Long Asignado por el Origen VersionDocumento Origen Numero Número de versión del documento. Autogenerado Comentario Comentario asociado a la versión. Asignado por el

74 Página 74 de HistoricoVersiones versiondocumento Array con las distintas versiones del VersionDocumento [] Autogenerado documento Origen Interesado URI_Interesado Código de la base de datos de Terceros de Platino que identifica al interesado. Asignado por el Id_Interesado DNI, NIF, CIF del interesado Asignado por el Asignado por el Desc_Interesad Nombre o Razón Social del interesado. o Origen

75 5.1.5 Página 75 de 101 Interesados Origen interesado Array de interesados. Interesado [] Autogenerado InformacionFirmaElectronica Los datos con origen Autogenerado son obtenidos por el servicio a partir de la firma (FirmasElectronicas). URI_Firmante Código de La base de datos de Terceros de Platino que identifica al Firmante Autogenerado Id_Firmante DNI, NIF, Cif del Firmante Autogenerado Autogenerado Cargo_Firmant e del cargo que ocupa el firmante en el momento de la firma Autogenerado Fecha_Firma Fecha de la firma del documento Autogenerado Desc_Firmante Nombre o razón social del Firmante Date Origen

76 5.1.7 Página 76 de 101 FirmasElectronicas Origen informacionfirmaelec Array de InformacionFirmaElectronica [] Autogenerado tronica InformacionFirmaElectrónica. Firma electrónica en formato XMLDSig, XAdES o CAdES. El formato CADES debe estar codificado en base64. Firma Asignado por el Sellados Origen informacionsell Array de InformacionSellado. ado InformacionSellado Autogenerado [] Firma_Sellado Firma Electrónica del Sellado en formato Asignado por el

77 Página 77 de 101 XMLDSig, XAdES o CAdES. El formato CADES debe estar codificado en base InformacionSellado Los datos con origen Autogenerado son obtenidos por el servicio a partir de la firma del sellado (Sellados). Origen Codigo del tipo de sellado del documento. Codigo Se (Los valores de este campo se obtienen de llado la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el del tipo de sellado del Desc Sella documento. (Los valores de este campo se do obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el Fecha_Sellado Fecha del sellado del documento Autogenerado URI_F_Sellado Código de La base de datos de Terceros de Platino que identifica al firmante del Sellado Autogenerado Id_F_Sellado DNI, NIF, Cif del Firmante del Sellado Autogenerado Autogenerado Desc_F_Sellado Nombre o razón social del Firmante Date

78 del cargo que ocupa el Cargo_F_Sellad firmante en el momento de la firma del o sellado Página 78 de 101 Asignado por el Origen Procedimiento Codigo Código de clasificación del Procedimiento (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el Campo que da nombre al Procedimiento (Los valores de este campo se obtienen de Asignado por el Titulo

79 Página 79 de 101 la tabla correspondiente en la Base de Datos de Procedimientos) Codigo_Serie Código de la Serie Documental (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Organización) Asignado por el Titulo_Serie Título de la Serie Documental (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Organización) Asignado por el Codigo_Org Código del Organismo Administrativo responsable del procedimiento. (Los valores de este campo se obtienen de la Long tabla correspondiente en la Base de Datos de Organización) Asignado por el Desc_Org Nombre del Organismo Administrativo responsable del procedimiento. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Organización) Asignado por el Codigo_Unidad Código de la unidad responsable del procedimiento. (Los valores de este campo Long se obtienen de la tabla correspondiente en la Base de Datos de Organización) Asignado por el Desc_Unidad Nombre de la unidad responsable del procedimiento. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Organización) Asignado por el URI Código de referencia que identifica de forma inequívoca el procedimiento en Platino. Calculado por el servicio. Asignado por el Ruta Ruta completa del nodo del procedimiento en el repositorio. Calculado por el servicio, del parámetro en la operación crearprocedimiento. Autogenerado Version Versión del Procedimiento Asignado por el Nivel_LOPD Código del nivel de seguridad según la Asignado por el

80 Página 80 de 101 LOPD. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Acceso Código del nivel de acceso a la información. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el tipocontenido de contenido del procedimiento. Asignado por el Contenido Expediente

81 Página 81 de 101 Nota: Los datos marcados como 'Heredados', heredan del nodo Procedimiento padre del expediente. Codigo Código de clasificación del Procedimiento. Heredado Titulo Título del Procedimiento. Heredado Codigo_Serie Código de la Serie Documental a la que pertenece el expediente. Heredado Titulo_Serie Título de la Serie Documental a la que pertenece el expediente. Heredado Codigo_Org Código del Organismo Administrativo Long responsable del expediente. Heredado Desc_Org Nombre del Organismo Administrativo responsable del expediente. Heredado Codigo_Unidad Código de la unidad responsable del Long expediente. Heredado Desc_Unidad Nombre de la unidad responsable del expediente. Heredado Version Versión del procedimiento en el momento de la creación del expediente Heredado Fecha_Apertura Fecha de apertura del expediente Date Asignado por el Fecha_Cierre Fecha de cierre del expediente Date Asignado por el Numero_Exp Código que identifica de forma única e inequívoca al expediente. Patrón: CAC_Serie_Organo_Unidad numeroe xpediente Ejs: CAC_123_44_55 1/2008 CAC_876_23_76 TF543 Asignado por el Desc_Exp Texto Asignado por el descriptivo del contenido del Origen

82 Página 82 de 101 expediente URI Código de referencia que identifica de forma inequívoca el expediente en Platino Autogenerado Ruta Ruta completa del nodo del expediente en el repositorio Autogenerado tipocontenido de contenido del expediente. Asignado por el *. Nivel_LOPD Código del nivel de seguridad según la LOPD. Heredado Acceso Código del información. Heredado nivel de acceso Contenido a la Código del estado de accesibilidad del expediente en relación a la gestión del Codigo_Accesibil archivo. (Los valores de este campo se idad obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el del estado de accesibilidad del expediente en relación a la gestión del Desc_Accesibilid archivo. (Los valores de este campo se ad obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Heredado interesados Asignado por el * Interesados asociados al expediente. Interesados Nivel En caso de no ser especificado, será heredado del nodo padre.

83 Página 83 de 101 URI Código de referencia que identifica de forma inequívoca el nivel en Platino Autogenerado Ruta Ruta completa del nodo del nivel en el repositorio Autogenerado tipocontenido de contenido del nivel. Asignado por el Origen Contenido DocumentoBase Nota: La clase DocumentoBase es de la que heredan los tres tipos de documentos (DocumentoExpediente, DocumentoSimple y DocumentoCiudadano). Los campos aquí presentados son comunes a los tres tipos de documentos. Origen _Doc al que pertenece el documento Asignado por el

84 Página 84 de 101 Desc_Doc del documento Asignado por el Codigo_Aportado Codigo que indica si el documento es aportado por el ciudadano, generado por la organización o procedente de otra administración. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el Desc_Aportado Descripcion del campo Codigo_Aportado. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Procedimientos) Asignado por el Formato Indica el formato del documento Asignado por el Admite_Versionado Indica si el documento admite versionado Boolean Asignado por el _Mime mime del documento Asignado por el URI Código de referencia que identifica de forma inequívoca el documento en Platino Autogenerado Ruta Ruta completa del nodo del documento en el repositorio Autogenerado Nivel_LOPD Código del nivel de seguridad según la LOPD. (Los valores de este campo se corresponden con la tabla correspondiente en la Base de Datos de Procedimientos) Heredado* Acceso Código del nivel de acceso a la información. (Los valores de este campo se corresponden con la tabla correspondiente en la Base de Datos de Procedimientos) Heredado* Codigo_Accesibilidad Código del estado de accesibilidad del documento en relación a la gestión del archivo. (Los valores de este campo se corresponden con la tabla correspondiente Heredado* * El origen de los campos heredados dependerá del tipo de documento. Para más información ver los apartados correspondientes a DocumentoSimple, DocumentoExpediente y DocumentoCiudadano.

85 Página 85 de 101 en la Base de Datos de Procedimientos) Desc_Accesibilidad del estado de accesibilidad del documento en relación a la gestión del archivo. (Los valores de este campo se corresponden con la tabla correspondiente en la Base de Datos de Procedimientos) Heredado* NDE Número de documentos electrónico para la verificación del documento original, es calculado por el servicio. Autogenerado Huella_Digital Huella digital del documento, es calculado por el servicio y sigue el formato: <algoritmo>:<valor codificada en hexadecimal></code> Autogenerado Ej: md5:763449d6504c0637cf2e3fffd5e9f9e7 historicoveriones Histórico de versiones del documento. HistoricoVersion Autogenerado es interesados Interesados asociados al documento. Interesados firmaselectronicas Firmas Electrónicas del documento. FirmasElectroni Asignado por el cas sellados Sellados del documento. Sellados Depende del tipo de documento. Asignado por el * El origen de los campos heredados dependerá del tipo de documento. Para más información ver los apartados correspondientes a DocumentoSimple, DocumentoExpediente y DocumentoCiudadano.

86 Página 86 de 101 DocumentoExpediente

87 Página 87 de 101 Nota: DocumentoExpediente hereda de DocumentoBase, por lo tanto contiene todos los elementos del DocumentoBase además los siguientes. Los datos marcados como 'Heredados', heredan del nodo Expediente padre del documento. Origen Codigo Código de clasificación del Procedimiento. Heredado Titulo Título del Procedimiento. Heredado Codigo_Serie Código de la Serie Documental a la que pertenece el expediente. Heredado Titulo_Serie Título de la Serie Documental a la que pertenece el expediente. Heredado Codigo_Org Código del Organismo Administrativo Long responsable del expediente. Heredado Desc_Org Nombre del Organismo Administrativo responsable del expediente. Heredado Código de la unidad responsable del expediente. (Los valores de este campo se Codigo_Unidad Long obtienen de la tabla correspondiente en la Base de Datos de Organización) Heredado Desc_Unidad Nombre de la unidad responsable del expediente. (Los valores de este campo se obtienen de la tabla correspondiente en la Base de Datos de Organización) Heredado Numero_Exp Código que identifica de forma única e inequívoca al expediente al que pertenece el documento Heredado Desc_Exp Texto descriptivo expediente Heredado Registro del contenido del Datos correspondientes a registro de entrada o salida. Patrón: _NGeneral_Contador_NRegistro_F Asignado por el

88 Página 88 de 101 echa_hora Ejs: E_12345_DGTNT_678_10/11/2008_10 :45:00 S_456789_RGED_432_15/12/2008_13:45:3 8 RI_0_RGDR_432_15/12/2008_11:30:54 Para reflejar múltiples registros sobre el mismo documento, se puede utilizar el separador coma (,) sin espacios en blanco. Ejs: E_12345_DGTNT_678_10/11/2008_10:45:00,S_456789_RGED_432_15/ 12/2008_13:45:38 Date Asignado por el Fecha_Doc Fecha del documento Doc_Ciudadan o Define si es un documento que pertenece a Boolean la carpeta de documentos administrativos Asignado por el Doc_Archivo Indica si es un Documento Administrativo de Boolean Archivo Asignado por el interesados Interesados asociados al documento. Asignado por el Interesados

89 Página 89 de 101 DocumentoSimple

90 Página 90 de 101 Nota: El DocumentoSimple hereda de DocumentoBase, por lo tanto contiene todos los elementos del DocumentoBase (Ver ) además de los siguientes: Los datos marcados como 'Heredados', heredan del nodo Procedimiento padre del documento el valor correspondiente. Origen Codigo Código de clasificación del Procedimiento. Heredado Titulo Título del Procedimiento. Heredado Codigo_Serie Código de la Serie Documental a la que pertenece el expediente. Heredado Titulo_Serie Título de la Serie Documental a la que pertenece el expediente. Heredado Codigo_Org Código del Organismo Administrativo Long responsable del expediente. Heredado Desc_Org Nombre del Organismo Administrativo responsable del expediente. Heredado Codigo_Unidad Código de la unidad responsable del Long expediente. Heredado Desc_Unidad Nombre de la unidad responsable del expediente. Heredado Registro Datos correspondientes a registro de entrada o salida. Patrón: _NGeneral_Contador_NRegistro_F echa_hora Ejs: E_12345_DGTNT_678_10/11/2008_10 :45:00 Asignado por el S_456789_RGED_432_15/12/2008_13:45:3 8 RI_0_RGDR_432_15/12/2008_11:30:54 Para reflejar múltiples registros sobre el mismo documento, se puede utilizar el

91 Página 91 de 101 separador coma (,) sin espacios en blanco. Ejs: E_12345_DGTNT_678_10/11/2008_10:45:00,S_456789_RGED_432_15/ 12/2008_13:45:38 Date Asignado por el Fecha_Doc Fecha del documento Doc_Ciudadan o Define si es un documento que pertenece a Boolean la carpeta de documentos administrativos Asignado por el Doc_Archivo Indica si es un Documento Administrativo de Boolean Archivo Asignado por el Numero_Doc Número del Documento Asignado por el interesados Interesados asociados al documento. Interesados Asignado por el

92 Página 92 de 101 DocumentoCiudadano Hay que tener en cuenta que los documentos de tipo DocumentoCiudadano serán gestionados a través del Servicio de Carpeta Ciudadana, y los backoffices que deseen trabajar con documentos de este tipo, no lo podrán hacer consumiendo directamente el. Por lo tanto, hasta que no se complete el desarrollo del Servicio de Carpeta Ciudadana, no será posible utilizar documentos del tipo DocumentoCiudadano. Nota: Al insertar un documentociudadano establecer todos los campos obligatorios, Fecha_Alta y Fecha_Baja, además de los que correspondan de DocumentoBase. El DocumentoCiudadano hereda de DocumentoBase, por lo tanto contiene todos los elementos del DocumentoBase además de los siguientes:

93 Página 93 de 101 Fecha_Alta Fecha de alta en la carpeta Date Fecha_Baja Fecha de baja en la carpeta Date interesados Interesados asociados al documento. Interesados Documento contenido Contenido del documento.(ver 5.3) base64binary metainformacion Meta-Información asociada al documento. DocumentoBase

94 Página 94 de 101 ResultadoPaginado numpagina Número de página devuelta; su valor coincidirá con el parámetro pagina del método de búsqueda. int numresultados Número de resultados encontrados en la búsqueda. int resultadosporpagina Número de resultados por página; su valor coincidirá con el parámetro resultadosporpagina del int método de búsqueda. metainformacion Array con los metadatos de los documentos que concuerdan con el criterio de búsqueda. 5.2 DocumentoBase [] CARDINALIDAD Y HERENCIA Es importante a la hora de crear documentos, procedimientos, expediente y niveles tener en cuenta la cardinalidad de los elementos que los componen:

95 Cardinalidad [1..1] Obligatorio y univaluado [0..1] Opcional y univaluado [1..*] Obligatorio y multivaluado [0..*] Opcional y multivaluado Página 95 de 101 Al crear documentos, procedimientos, expedientes y niveles, es necesario establecer todos los campos obligatorios. También es importante destacar que muchos metadatos son heredados a partir de los niveles superiores, por lo que no hace falta especificarlos. Por ejemplo al crear un expediente muchos de los metadatos son heredados del procedimiento y al insertar documentos muchos de sus metadatos son heredados del expediente. En el documento PLA-BOR-FIN Vol IV. Manual del desarrollador - Anexo II. Metadatos.pdf se recogen los distintos metadatos que se manejan en el servicio y se indican las condiciones para utilizar cada uno de ellos. 5.3 TRANSMISIÓN DE ARCHIVOS ADJUNTOS POR SOAP Para la transmisión del contenido de los documentos en las operaciones de este servicio se ha utilizado el estándar MTOM ( Con MTOM se optimiza la transmisión de archivos adjuntos por SOAP, permitiendo el acceso a los archivos adjuntos como un fujo de bytes que se van procesando a medida que se van transmitiendo por el socket de comunicación. Este estándar, junto con la especificación XOP, requiere que el mensaje SOAP venga codificado en formato MIME de múltiples partes. Habitualmente la primera parte del mensaje MIME es el documento XML del mensaje SOAP. Las partes adicionales son los archivos adjuntos, que en el caso de este servicio será el contenido del documento.

96 Página 96 de 101 En lugar de que el contenido del documento adjunto se encuentre incluido en el documento XML del mensaje SOAP, el primero habitualmente codificado en Base64, en MTOM el documento XML del mensaje SOAP solo hará referencia al identificador de la parte MIME que posee el contenido del documento adjunto. Un ejemplo de referencia al contenido del documento adjunto sería el siguiente: <xop:include href="nombreadjunto" xmlns:xop=" /> El valor del atributo href indica el identificador de la parte MIME (que en el ejemplo es nombreadjunto ) que contiene el contenido del documento ajunto. Si el programador utiliza una pila o framework de servicios web que admita MTOM, el programador no ha de preocuparse por la construcción del mensaje SOAP con partes múltiples MIME ni de especificar la referencia al contenido. El propio framework, una vez analice el WSDL del servicio, tendrá en cuenta todo lo necesario para realizar una invocación SOAP con MTOM en aquellas operaciones en el que se utilice este estándar. Lo que sí es necesario que especifique el programador es la activación de MTOM en el cliente del servicio web. MTOM debe estar activado para cualquiera de las operaciones del servicio, incluso si la operación no utiliza archivos adjuntos. Todas las respuestas del servicio web vendrán codificadas según MTOM, debido a que en la plataforma.net una vez activado MTOM esta espera que todas las respuestas se reciban con MTOM. Dependiendo de la plataforma utilizada para consumir este servicio, y del framework de servicios web con el que se generen los es del servicio, el tipo de los parámetros que representen archivos adjuntos podrá diferir entre unos y otros con estas posibilidades: array de bytes: a pesar de utilizar MTOM, el framework requiere que se carguen los datos del archivo en un array de bytes; es el caso de WSE 3.0 en la plataforma.net, flujo de bytes: el framework es capaz de transferir el contenido del archivo usando un flujo de bytes, sin requerir que se cargue el contenido del archivo en memoria; el contenido se transmite a medida que se requiere; en el caso de la

97 Página 97 de 101 plataforma Java, corresponde a un objeto de la clase javax.activation.datahandler MTOM EN LA PLATAFORMA.NET Si la plataforma de desarrollo del cliente de este servicio fuera Microsoft.NET el programador debe tener en cuenta lo siguiente: en Visual Studio 2005 no está disponible de serie el uso de MTOM ni de varios estándares WS-*, ya que el establecimiento de estos estándares fue posterior a la publicación de este producto, Microsoft ha adoptado el uso de MTOM como mecanismo de transferencia de archivos adjuntos en servicios web, dejando atrás otros candidatos propuestos, Microsoft ha publicado un paquete de software que se integra con Visual Studio 2005 para habilitar el uso de MTOM y de otros estándares WS-* en proyectos de.net desarrollados con Visual Studio 2005 que implementen o utilicen servicios web. Este paquete de software se denomina WSE 3.0 (web services enhancement, en su versión 3.0) y se puede obtener sin coste alguno desde la siguiente URL: Con este paquete de software el desarrollador podrá crear con facilidad software que consuma este servicio e invocar operaciones con archivos adjuntos. Para activar el uso de MTOM en el cliente del servicio web, es necesario marcar las casillas correspondientes de la herramienta de configuración del proyecto (Configuration Tool).

98 5.3.2 Página 98 de 101 MTOM EN LA PLATAFORMA JAVA Si la plataforma de desarrollo del cliente de este servicio se basa en la plataforma Java, en necesario que el programador identifique la implementación de la pila de servicios web que vaya a utilizar. Por ejemplo: Apache CXF Apache Axis Apache Axis2 JBossWS WSO2 WSF JWSDP (GlassFish) XINS