Formularios PDF r4

Interoperabilidad de los servicios telemticos de la
Pgina 1 de 34
Administracin Pblica de la CAC
MARCO DE REFERENCIA PARA LA

PLATAFORMA DE INTEROPERABILIDAD
VOLMEN IV: MANUAL DEL DESARROLLADOR
SERVICIO DE FORMULARIO PDF (FORPDF).
Rev. Fecha Descripcin
0 01/08/2010 Versin inicial

Se implementa la generacin de PDF plano al consolidar.
1 15/01/2011
Se modifica el punto 4.6 CUFPDF-6 Guardar Plantilla
Se modifica apartado 7 Diseo de Formulario e Integracin explicando todo lo
relacionado con la plantilla esttica.
Cambia el tipo de datos de los tickets generados por FORPDF, pasando de Long
2 25/03/2011
a String. Por consiguiente se actualizan los siguientes puntos:
2.1 PUBLICACIN DE FORMULARIOS, Parmetro ticket.

4.1 CU-FPDF-1 GUARDAR FORMULARIO BORRADOR: Entrada del servicio.
4.2 CU-FPDF-2: CANCELAR: Entrada del servicio.
4.3 CU-FPDF-3: OBTENER DOCUMENTO CONSOLIDADO: Entrada del servicio.
4.4 CU-FPDF-4: INICIAR FORMULARIO: Salida del servicio.
4.5 CU-FPDF-5: CANCELAR TICKET: Entrada del servicio.
Integracin con ReaderExtensions
3 02/06/2011
Se actualizan los siguientes puntos:
4.6 CU-FPDF-6: GUARDAR PLANTILLA. Entrada del servicio.
7.2 Se actualiza contenido, punto 7.2.2 PDF esttico se elimina.
Mejora del manejo de excepciones y actualizacin del punto 5. CONTROL DE
4 04/07/2011
EXCEPCIONES.
Se actualiza el nombre de algunos componentes en la descripcin del servicio.
Se cambia a ISO-8859-1 la codificacin utilizada en los XML consolidados.
Se realizan varias actualizaciones internas para mejorar el rendimiento.
Importante: Esta versin requiere que los clientes se construyan nuevamente.
Interoperabilidad de los servicios telemticos de la
Pgina 2 de 34
Administracin Pblica de la CAC
Documento : PLA-DOC-TEC-11-07-04 Servicio Formulario PDF
Ubicacin en eCarpeta
Preparado por Revisado por Aprobado por

D. Gral. de Telecomunicaciones y D. Gral. de Telecomunicaciones y D. Gral. de Telecomunicaciones y
Nuevas Tecnologas Nuevas Tecnologas Nuevas Tecnologas
Fecha: 04/07/2011 Fecha: 04/07/2011 Fecha:
Vol. IV Manual del desarrollador Servicio de
Pgina 3 de 34
Formulario PDF (FORPDF)
NDICE
1 INTRODUCCIN. ............................................................................................... 4
2 DEFINICIN DEL SERVICIO ............................................................................. 6
2.1 PUBLICACIN DE FORMULARIOS .......................................................................... 6
2.2 VALORES INICIALES DE UN FORMULARIO............................................................ 8
2.3 FIRMA DE UN FORMULARIO.................................................................................... 8
3 VERSIN DEL SERVICIO ................................................................................. 9
4 CASOS DE USO ................................................................................................ 9
4.1 CU-FPDF-1: GUARDAR FORMULARIO BORRADOR ............................................ 10
4.2 CU-FPDF-2: CANCELAR ......................................................................................... 12
4.3 CU-FPDF-3: OBTENER DOCUMENTO CONSOLIDADO ....................................... 14
4.4 CU-FPDF-4: INICIAR FORMULARIO ....................................................................... 16
4.5 CU-FPDF-5: CANCELAR TICKET ........................................................................... 21
4.6 CU-FPDF-6: GUARDAR PLANTILLA ....................................................................... 23
4.7 CU-FPDF-7: OBTENER PLANTILLA ....................................................................... 26
5 CONTROL DE EXCEPCIONES ....................................................................... 27
5.1 ERRORDEPARAMETROSEXCEPTION ........................................................................... 27
5.2 ERRORINTERNOEXCEPTION ....................................................................................... 28
5.3 TICKETNOVALIDOEXCEPTION ..................................................................................... 28
5.4 ERRORINSERCIONENSGRDEEXCEPTION ................................................................... 28
6 INFORMACION ADICIONAL DEL SERVICIO ................................................. 29
6.1 TIPOS DE DATOS.................................................................................................... 29
6.1.1DocumentoConsolidado 29
6.2 CARDINALIDAD Y HERENCIA ................................................................................ 30
7 DISEO DE FORMULARIOS E INTEGRACION ............................................. 31
7.1 HERRAMIENTA DE DISEO .......................................................................................... 31
7.2 FORMATO DE FORMULARIO A DISEAR ........................................................................ 32
7.2.1Plantilla XDP 32
7.3 PREPARAR UN NUEVO FORMULARIO PARA SER AADIDO A FORPDF ............................ 33
7.4 AADIR UN FORMULARIO A FORPDF .......................................................................... 34
Definicin funcional, implantacin y soporte operativo para la Interoperabilidad de los Servicios Telemticos de la Administracin
Pblica de la Comunidad Autnoma de Canarias
Pgina 4 de 34
1 INTRODUCCIN.
El objeto de este documento es describir en detalle y profundidad el Servicio de

Formularios Electrnicos PDF (FORPDF), el cual forma parte de la plataforma de
interoperabilidad PLATINO, dar a conocer su funcionalidad, describir los mtodos
disponibles, como tambin los mensajes a intercambiar con el servicio para
interactuar con l.
El Servicio de Formularios Electrnicos (FORPDF) est compuesto por dos mdulos:
Un servicio de web que brinda una serie de mtodos (que se enumeran y

detallan en el punto 4. CASOS DE USO) que permiten iniciar un formulario con
la posibilidad (entre otras) de precargarle datos, publicarlo (presentarlo al
ciudadano para su rellenado), recoger la informacin introducida por el
ciudadano y una vez acabado el proceso de rellenado almacenar los
formularios PDF (con sus datos XML) en el repositorio del Servicio de Gestin
de Repositorio de Documentos (SGRDE) de Platino.
Los aplicativos cliente (SEDE, BackOffice) consumidores de FORPDF han de
conectarse e invocar a los diferentes mtodos segn corresponda para
gestionar sus formularios.
El servicio ser descrito extensamente a lo largo de este documento.
Un diseador de formularios, que es la herramienta Adobe LiveCycle Designer,

con la cual un usuario (tcnico responsable) podr crear/disear nuevos
formularios (plantillas) y aadirles lgica y validaciones, para su posterior
integracin con el servicio de FORPDF.
Ntese que los dos apartados que conforman la totalidad de FORPDF tienen un
tiempo de ejecucin diferente.
El diseo es el paso inicial, cuando se crean los formularios que a posteriori rellenarn
los ciudadanos. Durante este tiempo el diseador ha de probar el correcto
funcionamiento del mismo como tambin su integracin con el servicio.
Para las tareas de prueba de los nuevos formularios el servicio dispone de algunos
mtodos tiles como son Guardar Plantilla (CU-FPDF-6), Obtener Plantilla (CU-FPDF-
7) o Iniciar Formulario (CU-FPDF-4) activando el modo de pre visualizacin.
Pgina 5 de 34
A posteriori, una vez se ha acabado con el diseo, ste ya no participa del proceso, y
el principal actor ser el propio servicio web, que otros aplicativos invocarn para
generar una nueva instancia del nuevo formulario diseado o bien guardar los datos
introducidos, o consolidar un formulario ya relleno para poder proceder a su firma.
Los formularios resultantes deben gestionarse (abrirse, rellenarse) con la herramienta

gratuita Adobe Reader o con Adobe Professional, esto implica que los usuarios que
hagan uso de los formularios PDF de Platino debern disponer de algunas de dichas
utilidades instaladas en su ordenador. La ltima versin de Adobe Reader se puede
descargar desde la siguiente direccin: http://get.adobe.com/es/reader/
Pgina 6 de 34
2 DEFINICIN DEL SERVICIO

Una de las principales tareas del servicio de FORPDF es construir de forma dinmica
(renderizar) los formularios PDF que se presentarn al ciudadano, para lo cual
FORPDF utiliza las plantillas definidas (en tiempo de diseo) ms los datos con los
que se debe pre rellenar cada formulario.
Las plantillas se disean con Adobe LiveCycle Designer, las cuales se guardan en
formato XDP (XML Data Package Specification, la cual forma parte de la Adobe XML
Architecture).
La solucin utiliza el producto (de servidor) Adobe LiveCycle Enterprise Suite para
dicha tarea, quin se encarga de fusionar la plantilla XDP y los datos XML en un PDF
dinmico.
2.1 PUBLICACIN DE FORMULARIOS

En este apartado veremos cmo el mdulo publicador genera dinmicamente
(renderiza) los formularios PDF y cmo los manipula para su correcta visualizacin.
El mdulo publicador es accesible va HTTP. Para publicar un formulario es necesario

incluir un nico parmetros en la URL donde se encuentra el modulo publicador.
Este parmetro es:
Parmetro ticket
Con este parmetro se indica al servicio el formulario que queremos visualizar
o publicar.
El ticket ha de corresponderse con el valor devuelto por el mtodo inicializar
formulario (ver CU-FPDF-4: Iniciar Formulario), el que se debe invocar
previamente para que el servicio genere el formulario y le asigne un ticket a
dicha peticin. Una vez generado el formulario (del lado del servicio de
FORPDF) se podr invocar el publicador para el ticket devuelto.
Ejemplo:
http://lena.gobiernodecanarias.net:8080/forpdf/servlet/publicar?ticket=231f4037b36c468181c3
37574f92b21f
Pgina 7 de 34
Una vez publicado el formulario, el usuario puede interactuar con l y rellenarlo.

Las acciones que el ciudadano tendr disponible en los formularios (en forma de
botones al pie del mismo) son:
Guardar
Este botn enva al servicio de FORPDF los datos introducidos hasta el
momento y devuelve el control (re direcciona) a la Sede.
Guardar los datos no implica necesariamente que se haya finalizado el
rellenado del mismo. Si la Sede as lo implementa debera de permitrsele al
ciudadano modificar un formulario anteriormente guardado (tantas veces
como se desee) volviendo a invocar al publicador, el cual presentar el
formulario con todos datos que el ciudadano haya introducido hasta ese
momento.
Cancelar
Este botn bsicamente devuelve el control a la Sede y descarta los datos
introducidos por el usuario.
Es importante mencionar que esta accin NO cancela el formulario
generado en el servicio de FORPDF, ni tampoco los datos que en ediciones
previas se hayan guardado, simplemente descarta (se ignoran) los datos
introducidos en la ltima publicacin.
Las acciones que cada botn realizan estn implementadas en los fragmentos de
control pre definidos y que se detallan en el captulo 7 DISEO DE FORMULARIOS E
INTEGRACION de este documento.
Los formularios PDF muestran en pantalla una representacin 100% fiel al resultado
del documento en papel o impreso.
Es importante mencionar que el servicio FORPDF no ser responsable de firmar

los formularios. En su defecto ser la Sede quien tenga que realizar dicha tarea (ver
punto 2.3 FIRMA DE UN FORMULARIO).

Pgina 8 de 34
2.2 VALORES INICIALES DE UN FORMULARIO
Cuando se inicia un formulario (ver CU-FPDF-4 Inicializar Formulario) es posible

especificar unos valores iniciales de los campos del formulario y presentar as al
ciudadano un formulario personalizado, lo cual no es obligado. Puede no
especificarse valores iniciales y en tal caso el formulario se presentar al ciudadano
tal y como se ha diseado.
Los valores se indicarn en formato XML y seguirn el esquema descrito por la

plantilla (formulario XDP) que se quiera inicializar. Cada plantilla tendr su propia
estructura XML interna, la cual es necesario conocer para poder precargar datos
correctamente.
El diseador de cada formulario ha de conocer la estructura XML de los formularios
que disee.
Un ejemplo de valores iniciales se puede ver en la descripcin del caso de uso Iniciar
Formulario (ver CU-FPDF-4: INICIAR FORMULARIO).
2.3 FIRMA DE UN FORMULARIO
El servicio de FORPDF no ser responsable de firmar los formularios, pero s de la

preparacin de los mismos para su firma.
Cuando el ciudadano se disponga a firmar un formulario la Sede ha de invocar el

mtodo Obtener Documento Consolidado (ver CU-FPDF-3 Obtener Documento
Consolidado), donde se construir el formulario para la firma y se registrar en el
SGRDE (juntamente con el XML de datos correspondiente).
Las URIs asignadas a los documentos (PDF y XML) por el SGRDE y el contenido del
formulario sern devueltas a la Sede (como resultado de la consolidacin), siendo
esta ltima la responsable de actualizar el documento PDF generado en el SGRDE
(utilizando la URI) aadindole la firma generada por el ciudadano.
Pgina 9 de 34
3 VERSIN DEL SERVICIO
Este documento corresponde a la versin 20110704 del servicio.
4 CASOS DE USO
Los mtodos del servicio de FORPDF permiten realizar las siguientes operaciones:
Generacin dinmica de formularios electrnicos; esta operacin debe ser

invocada previamente a la presentacin del formulario al ciudadano y devolver
un ticket que debe ser utilizado para acceder por HTTP a la pgina web del
formulario requerido.
Guardar en borrador las modificaciones parciales de un formulario.
Descartar los datos introducidos en el formulario (en la ltima publicacin).
Cancelar una peticin y descartar todos sus datos relacionados almacenados
en el servicio.
Obtener un formulario NO editable para que el ciudadano lo firme.
Recuperar una plantilla.
Guardar una plantilla.
Pgina 10 de 34
La siguiente figura muestra los distintos casos de uso del servicio.
A continuacin se describen los mtodos del servicio web; ante cualquier ambigedad
o falta de precisin, se recomienda consultar su definicin en la especificacin WSDL.
4.1 CU-FPDF-1: GUARDAR FORMULARIO BORRADOR
Mtodo para guardar en la base de datos del servicio los datos introducidos por el
ciudadano en el formulario.
Este mtodo ser llamado por los formularios PDF, cuando el ciudadano presione el
botn Guardar.
Como resultado de su invocacin el mtodo devolver una url, la cual se

corresponder (en funcin si se ha guardado correctamente o no) con la url de error o
de retorno indicada al inicializar el formulario.
En este punto no se registra ningn dato en el SGRDE de Platino, todo se registra en

la base de datos de FORPDF.
Pgina 11 de 34
Interfaz:
Entrada del servicio:
Parmetro Descripcin Tipo
Ticket que identifica el formulario al que corresponden los

ticket String
datos a guardar como borrador.
Cadena de caracteres en formato XML que contiene los

xml datos a guardar. String
Ha de contener un XML vlido.
Ejemplo de Entrada
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:for="http://platino.gobcan.es/servicios/forpdf">
<soapenv:Header />
<soapenv:Body>
<for:guardarBorrador>
<ticket>231f4037-b36c-4681-81c3-37574f92b21f</ticket>
<xml>
<![CDATA[
<form>
<interesado>
<docNum>4444444A</docNum>
<nombre>Juan Pedro</nombre>
<apellido1>PEREZ</apellido1>
<apellido2>RODRIGUEZ</apellido2>
</interesado>
Pgina 12 de 34
</form>
]]>
</xml>
</for:guardarBorrador>
</soapenv:Body>
</soapenv:Envelope>
Salida del servicio

La URL a retornar ha de corresponderse con la indicada
en el parmetro urlRetorno (al inicializar el formulario)
si el servicio logra guardar con xito los datos, en caso
urlRetorno contrario la URL retornada corresponder con la indicada String
en el parmetro urlError (ver la descripcin de los
parmetros urlError y urlRetorno en CU-FPDF-4: INICIAR
FORMULARIO).
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:guardarBorradorResponse>
<urlRetorno>http://sitio:puerto/app/urlRetorno.jsp</urlRetorno>
</for:guardarBorradorResponse>
</soapenv:Body>
</soapenv:Envelope>
4.2 CU-FPDF-2: CANCELAR
Mtodo que dado un ticket devuelve la ruta de cancelacin indicada al inicializar dicha
solicitud.
Pgina 13 de 34
Este mtodo ser llamado desde los formularios PDF, cuando el ciudadano presione
el botn Cancelar.
Se utilizar este mtodo para brindar al ciudadano la posibilidad de cancelar los datos
introducidos en una solicitud (nicamente se descartarn los datos NO guardados).
Esta accin no implica la eliminacin de la misma en el servicio. El ticket y los datos
que se hayan guardado previamente continuarn almacenados posibilitando que el
ciudadano contine rellenando la solicitud luego si as lo desea.
Interfaz:
ticket Ticket que identifica el formulario que se est cancelando. String
Ejemplo de Entrada
<soapenv:Header />
<soapenv:Body>
<for:cancelar>
</for:cancelar>
</soapenv:Body>
</soapenv:Envelope>
Pgina 14 de 34
Salida del servicio

Devuelve la URL indicada en el parmetro urlCancelar
al inicializar la solicitud correspondiente al ticket indicado
urlCancelar String
(ver la descripcin del parmetro urlCancelar en CU-
FPDF-4: INICIAR FORMULARIO).
Ejemplo de Salida
<soapenv:Header/>
<soapenv:Body>
<for:cancelarResponse>
<urlCancelar>http://sitio:puerto/app/urlCancelar.jsp</urlCancelar>
</for:cancelarResponse>
</soapenv:Body>
</soapenv:Envelope>
4.3 CU-FPDF-3: OBTENER DOCUMENTO CONSOLIDADO
Mtodo para obtener un formulario PDF de solo lectura relleno para su firma.
La consolidacin consiste en obtener los datos de un formulario (incluyendo la

informacin que el ciudadano haya grabado hasta el momento), y generar el
formulario PDF para su firma.
La consolidacin implica que el formulario generado ser de solo lectura y ser el
resultado final del proceso de inicializacin y rellenado por parte del ciudadano.
El proceso de consolidar incluye el grabado del formulario resultante y tambin de sus
datos (XML) en el Repositorio de Documentos de Platino (SGRDE).
Pgina 15 de 34
De esta forma este mtodo devuelve un objeto complejo conteniendo el PDF

generado y las URIs asignadas por el SGRDE tanto del PDF como del XML
resultante.
Interfaz:
ticket Ticket que identifica el formulario que ha de consolidarse. String
Ejemplo de Entrada
<soapenv:Header />
<soapenv:Body>
<for:obtenerDocumentoConsolidado>
</for:obtenerDocumentoConsolidado>
</soapenv:Body>
</soapenv:Envelope>
Pgina 16 de 34
Salida del servicio

Retorna el resultado de consolidar el documento
conteniendo los bytes[] del formulario PDF y las
documentoConsolidado URIs generadas en el SGRDE (ver el punto 6.1.1 DocumentoConsolidado
DocumentoConsolidado para una descripcin
detallada del tipo de datos).
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:obtenerDocumentoConsolidadoResponse>
<documentoConsolidado>
<docConsolidado>
U2VydmljaW8gZGUgRm9ybXVsYXJpb3MgRWxlY3Ry825pY29zIFBERiwgUExBVElOTyAoRGVzYXJy
b2xsYWRvIHBvciBKYXZpZXIgUGFkcvNuIE3pcmlkYSwgTmFydGV4IFNvZnR3YXJlKS4=
</docConsolidado>
<uriPDF>urn:uuid:272b8549-9993-11df-98e0-6f2bb0063f67</uriPDF>
<uriXML>urn:uuid:272b8549-9994-11df-98e4-6f2bb0063504</uriXML>
</documentoConsolidado>
</for:obtenerDocumentoConsolidadoResponse>
</soapenv:Body>
</soapenv:Envelope>
4.4 CU-FPDF-4: INICIAR FORMULARIO
Mtodo para iniciar un formulario PDF.
Este mtodo es el punto de inicio para completar un formulario ya que en primera

instancia habr de invocarse este mtodo el cual recabar toda la informacin
necesaria respecto del solicitante, organismo, datos iniciales a precargar, formulario a
Pgina 17 de 34
iniciar, ruta del SGRDE donde ha de guardarse y algunos parmetros ms que se

explican detalladamente ms abajo.
Con toda la informacin recibida este mtodo registra en su base de datos la peticin
a la cual le asigna un ticket, el cual es devuelto por el mtodo.
Interfaz:
URL a devolver por el servicio cuando se invoque los mtodos

urlRetorno cancelarTicket (CU-FPDF-5) y guardarBorrador (CU-FPDF-1) String
con xito.
URL a devolver por el servicio cuando se invoque el mtodo cancelar

urlCancelar String
(CU-FPDF-2).
Pgina 18 de 34
URL a devolver por el servicio cuando se invoque los mtodos

cancelarTicket (CU-FPDF-5) y guardarBorrador (CU-FPDF-1) y
urlError String
se produzca algn error que impida que los mtodos mencionados no se
ejecuten exitosamente.
uriTercero URI del Tercero que realiza la peticin (quien rellenar el formulario). String
idOrganismo Identificador de Organismo asociado. String
Ruta de carpeta dentro del SGRDE donde los documentos resultantes de

directorioDestino la cumplimentacin de un formulario (PDF y XML) han de guardarse. String
Ejemplo: solicitudes/FORPDF
El identificador de formulario indica la plantilla a instanciar. Este

identificador se corresponder en todos los casos con una URI del
SGRDE de PLATINO.
La URI podr indicar tambin la versin de la plantilla que se desea
utilizar, siguiendo la siguiente convencin: uri?version=x.x
Ejemplos:
URI: urn:uuid:272b8549-9993-11df-98e0-6f2bb0063f67
idFormulario String
URI Versionada: urn:uuid:272b8549-9993-11df-98e0-
6f2bb0063f67?version=1.4
En el segundo de los ejemplos (URI Versionada) se indica explcitamente

que se quiere instanciar la versin 1.4 de la plantilla
urn:uuid:272b8549-9993-11df-98e0-6f2bb0063f67. En caso de
no indicar la versin el SGRDE devolver siempre la versin ms actual.
Valores iniciales con los que rellenar el formulario al visualizarlo. Tendr

estructura de XML relativa al formulario que se va a instanciar. Un
ejemplo sera el siguiente:
<form>
<interesado>
valoresIniciales <docNum>4444444A</docNum> String
</interesado>
Pgina 19 de 34
</form>
Ser necesario entonces conocer la estructura del formulario a instanciar
para poder realizar la precargar de datos, la cual ha de conocer el
diseador de dicho formulario.
La intencin de este parmetro es permitir a los diseadores pre

visualizar las plantillas diseadas para corregir problemas y mejorar el
diseo hasta conseguir la versin final.
Entonces si se indica el valor true para este parmetro se omitir la
preview boolean
obligatoriedad del resto de parmetros excepto idFormulario.
Por el contrario este parmetro deber ser false para las peticiones
reales, es decir, para los formularios instanciados a peticin de los
ciudadanos.
Cadena de caracteres con los metadatos que va a tener el documento en

el repositorio. Tiene formato de documento XML.
Debe corresponderse con un DocumentoSimple del SGRDE.
Ejemplo:
<gd:documentoSimple
xmlns:gd="http://platino.gobcan.es/servicios/sgrde">
<Tipo_Doc>SOL</Tipo_Doc>
<Desc_Doc>Solicitud FORPDF</Desc_Doc>
<Fecha_Doc>2010-01-
28T21:25:29.125+02:00</Fecha_Doc>
<Doc_Ciudadano>false</Doc_Ciudadano>
metaInformacion <Doc_Archivo>false</Doc_Archivo> String
</gd:documentoSimple>
Este parmetro es especialmente importante, ya que l describir la
informacin que se asignar a los documentos resultantes en el SGRDE
de PLATINO.
El valor ms relevante de todos ellos es Tipo_Doc ya que ste indicar el
tipo de documento que representa el formulario instanciado y esta
informacin ser necesaria para que otros servicios puedan tramitar
correctamente los formularios (solicitudes de) generadas por este
servicio.
Los valores posibles de Tipo_Doc en este contexto son:
- SOL: Indicar que se trata de una solicitud.
- ANX: Indicar que se trata de un anexo.
Pgina 20 de 34
Ejemplo de Entrada
<soapenv:Header />
<soapenv:Body>
<for:iniciaFormulario>
<urlRetorno>http://sitio:puerto/app/urlRetorno.jsp
</urlRetorno>
<urlCancelar>http://sitio:puerto/app/urlCancelar.jsp
</urlCancelar>
<urlError>http://sitio:puerto/app/urlError.jsp</urlError>
<uriTercero>platino://gobcan.es/servicios/terceros/tercero/f242f402-
c4b9-4303-9054-61ae85dd68a9
</uriTercero>
<idOrganismo>0001</idOrganismo>
<directorioDestino>solicitudes/FORPDF</directorioDestino>
<idFormulario>urn:uuid:272b8549-9993-11df-98e0-6f2bb0063f67
</idFormulario>
<valoresIniciales>
<![CDATA[
<form>
<interesado>
<docNum>4444444A</docNum>
</interesado>
</form>
]]>
</valoresIniciales>
<preview>false</preview>
<metaInformacion>
<![CDATA[
<gd:documentoSimple
xmlns:gd="http://platino.gobcan.es/servicios/sgrde">
<Tipo_Doc>SOL</Tipo_Doc>
<Desc_Doc>Solicitud FORPDF</Desc_Doc>
<Fecha_Doc>2010-01-
28T21:25:29.125+02:00</Fecha_Doc>
<Doc_Ciudadano>false</Doc_Ciudadano>
<Doc_Archivo>false</Doc_Archivo>
</gd:documentoSimple>
]]>
</metaInformacion>
</for:iniciaFormulario>
</soapenv:Body>
Pgina 21 de 34
</soapenv:Envelope>
Salida del servicio

Ticket asociado a la instancia del formulario inicializado.
El ticket devuelto identificar la solicitud realizada dentro
ticket String
del servicio de FORPDF y ser necesario indicarlo en el
resto de mtodos.
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:iniciaFormularioResponse>
</for:iniciaFormularioResponse>
</soapenv:Body>
</soapenv:Envelope>
4.5 CU-FPDF-5: CANCELAR TICKET
Mtodo para descartar los datos asociados a un ticket en particular.
Cuando se inicializa un formulario (ver CU-FPDF-4) se almacenan una serie de datos

necesarios para construir el formulario correctamente. Al invocar este mtodo se
descartan todos esos datos.
Este mtodo ha de invocarse en dos circunstancias. Una es cuando el usuario no

desea seguir adelante con el rellenado del formulario y quiere descartarlo y el restante
cuando el ciudadano ha firmado la solicitud.
Pgina 22 de 34
En ambos casos ha de invocarse este mtodo para mantener as vivos nicamente

los formularios en curso, pendientes de firma o de que el ciudadano acabe de rellenar
todos los datos. En el caso de haber llamado al mtodo CU-FPDF-3 Obtener
documento consolidado, el servicio no borra los documentos PDF y XML generados
en el Repositorio de Documentos de PLATINO, ser el BackOffice o la Sede la
encargada de borrar estos documentos en caso de no necesitarlos.
Interfaz:
ticket Ticket a cancelar. String
Ejemplo de Entrada
<soapenv:Header />
<soapenv:Body>
<for:cancelarTicket>
</for:cancelarTicket>
</soapenv:Body>
</soapenv:Envelope>
Pgina 23 de 34
Salida del servicio

Devuelve la urlRetorno en caso de realizarse la
cancelacin con xito o la urlError en caso contrario
url String
(ver la descripcin de los parmetros urlError y urlRetorno
en CU-FPDF-4: INICIAR FORMULARIO).
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:cancelarTicketResponse>
<url>http://sitio:puerto/app/urlRetorno.jsp</url>
</for:cancelarTicketResponse>
</soapenv:Body>
</soapenv:Envelope>
4.6 CU-FPDF-6: GUARDAR PLANTILLA
Mtodo para guardar en el SGRDE las plantillas de formularios diseadas, en la ruta

que se indique.
Ha de guardarse la plantilla XDP.
La versin esttica del formulario (en PDF) ya no es necesaria.

De todas formas la firma del mtodo se mantendr por razones de compatibilidad con
otros aplicativos, lo cual implica que el parmetro plantillaEstatica puede indicarse
null, en caso de que ste parmetro contenga algn valor ste ser ignorado por el
servicio.
El mtodo devuelve la URI (versionada) asignada a la plantilla.
Pgina 24 de 34
Interfaz:
Contenido de la plantilla a guardar. Diseo de formulario

plantilla byte[]
en formato XDP.
Ruta dentro del SGRDE donde ha de guardarse la

plantilla. La ruta ha de incluir el nombre del documento y
NO nicamente una carpeta.
Ejemplo: formularios/PDF/miplantilla.xdp
ruta String
Si se invoca ms de una vez el mtodo indicando la
misma ruta, cada nueva invocacin generar una nueva
versin de la plantilla almacenada (ya que todas son
versionables por defecto).
Contenido del formulario PDF esttico. Diseo de

formulario en formato PDF y guardado como PDF
plantillaEstatica byte[]
Esttico (ver apartado 7. DISEO DE
FORMULARIOS E INTEGRACION).
Ejemplo de Entrada
Pgina 25 de 34
<soapenv:Header />
<soapenv:Body>
<for:guardarPlantilla>
<plantilla>
</plantilla>
<ruta>formularios/PDF/miplantilla.xdp</ruta>
</for:guardarPlantilla>
</soapenv:Body>
</soapenv:Envelope>
Salida del servicio

Devuelve la URI versionada asignada a la plantilla por el
SGRDE.
uri Ejemplo: String
urn:uuid:272b8549-9993-11df-98e0-
6f2bb0063f67?version=1.4
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:guardarPlantillaResponse>
<uri>urn:uuid:272b8549-9993-11df-98e0-
6f2bb0063f67?version=1.4</uri>
</for:guardarPlantillaResponse>
</soapenv:Body>
</soapenv:Envelope>
Pgina 26 de 34
4.7 CU-FPDF-7: OBTENER PLANTILLA

Mtodo para recuperar el contenido de una plantilla previamente almacenada en el
SGRDE.
Interfaz:
URI que identifica la plantilla a recuperar en el SGRDE.

uri String
La URI puede ser versionada o no.
Ejemplo de Entrada
<soapenv:Header />
<soapenv:Body>
<for:recuperarPlantilla>
<uri>urn:uuid:272b8549-9993-11df-98e0-6f2bb0063f67</uri>
</for:recuperarPlantilla>
</soapenv:Body>
</soapenv:Envelope>
Salida del servicio
Pgina 27 de 34
plantillaXDP Contenido de la plantilla. byte[]
Ejemplo de Salida
<soapenv:Header />
<soapenv:Body>
<for:recuperarPlantillaResponse>
<plantillaXDP>
</plantillaXDP>
</for:recuperarPlantillaResponse>
</soapenv:Body>
</soapenv:Envelope>
5 CONTROL DE EXCEPCIONES
5.1 ErrorDeParametrosException
Ocurre en caso de detectarse algn error en los parmetros con los que se ha
invocado el servicio en cuestin. Un parmetro puede ser errneo si posee un valor
no adecuado, por ejemplo en el caso de un documento XML, que este no estuviera
bien formado, como tambin la nulidad de algn parmetro imprescindible.
Pgina 28 de 34
5.2 ErrorInternoException
Excepcin que se lanza cuando se produce un error general de funcionamiento
interno del servicio.
Tambin se arroja cuando alguno de los servicios o sistemas de los que depende el
Servicio de Formularios Electrnicos PDF falla o reporta algn tipo de error al
gestionar las peticiones realizadas.
5.3 TicketNoValidoException
Excepcin que se lanza cuando el ticket indicado por parmetro no es vlido.
Esto puede ocurrir o bien porque el ticket no se ha asignado an a ninguna peticin o

porque la peticin a la cual se ha asignado dicho ticket se ha cancelado.
5.4 ErrorInsercionEnSGRDEException
Esta excepcin puede ocurrir cuando el servicio de FORPDF intenta guardar el
SGRDE de Platino los diferentes documentos (plantilla, formulario PDF o XML de
datos).
Pgina 29 de 34
6 INFORMACION ADICIONAL DEL SERVICIO
6.1 TIPOS DE DATOS
6.1.1 DocumentoConsolidado
Clase que agrupa los datos generados por FORPDF en el proceso de consolidacin,
los cuales interesa devolver a quien ha invocado al servicio y pueda as disponer tanto
del formulario PDF como de las URIs asignadas por el Servicio de SGRDE al mismo
PDF y al XML de datos resultantes.
Contenido en bytes del formulario resultante (PDF plano),

docConsolidado byte[]
listo para su firma.
URI asignada por el SGRDE de Platino al formulario PDF

uriPDF String
resultante de la consolidacin.
URI asignada por el SGRDE de Platino a los datos (en

uriXML String
formato XML) correspondientes al PDF resultante.
Pgina 30 de 34
6.2 CARDINALIDAD Y HERENCIA

Es importante tener en cuenta la cardinalidad indicada en la descripcin de los
diferentes mtodos, ya que esto determina qu parmetros son requeridos
obligadamente y cules no.
Cardinalidad Descripcin
[1..1] Obligatorio y univaluado.
[0..1] Opcional y univaluado.
[1..*] Obligatorio y multivaluado.
URI asignada por el SGRDE de Platino a los datos (en

[0..*]
formato XML) correspondientes al PDF resultante.
Particularmente en el mtodo iniciarFormulario, uno de sus parmetros ha de

contener la representacin en XML de un DocumentoSimple (del SGRDE de
Platino) el cual a su vez hereda de DocumentoBase, con lo cual los campos a pasar
obligadamente en dicho parmetro sern la suma de los campos obligados de
DocumentoBase y los de DocumentoSimple.
Hay un documento completo dedicado a este apartado, llamado Anexo II.
Vocabulario de Metadatos en el rea de Formacin de Platino.
Pgina 31 de 34
7 DISEO DE FORMULARIOS E INTEGRACION
En este apartado se explican los elementos necesarios y el mecanismo para poder

disear y aadir un nuevo formulario al servicio de formularios electrnicos de
PLATINO en PDF.
7.1 Herramienta de diseo

A la hora de crear nuevos formularios (plantillas) la herramienta a utilizar es Adobe
LiveCycle Designer ES.
Se trata de un diseador visual, en el que se dispone de una paleta de controles los

que se pueden aadir al nuevo formulario con simplemente arrastrar y soltar.
Pgina 32 de 34
La herramienta dispone tambin de un lenguaje de script LiveCycle Designer ES

Scripting Reference, mediante el cual se puede controlar prcticamente todos los
aspectos de los formularios. Por ejemplo las comprobaciones usuales de que un
formulario est debidamente relleno, o de que el NIF que ha introducido el solicitante
es vlido, etc.
Conforme se disea un formulario, la herramienta permite visualizar como un PDF lo
desarrollado, lo cual facilita en tiempo de diseo la deteccin de fallos o problemas
estticos.
7.2 Formato de formulario a disear

FORPDF requiere de un diseo de formulario en formato XDP.
7.2.1 Plantilla XDP

La plantilla (una vez acabado el diseo) ha de guardarse en formato Adobe XML
Form, con extensin XDP (Adobe XML Architecture / XML Data Package
Specification), que bsicamente consiste en un fichero XML.
Pgina 33 de 34
El fichero XDP resultante ms los datos XML a precargar en cada caso (cuando el
solicitante inicie un formulario) se combinarn en tiempo de ejecucin para dar lugar a
un PDF listo para rellenar por el solicitante.
7.3 Preparar un nuevo formulario para ser aadido a FORPDF

Para que un formulario XDP pueda integrarse correctamente con el servicio de
formularios PDF es necesario aadir a cada formulario (en tiempo de diseo) una
serie de campos de control.
Para facilitar esta tarea y que el diseador no necesite conocer ms detalles al
respecto, se utiliza la tecnologa de fragmentos de Adobe, la cual consiste en generar
ficheros en formato XML (denominado fragmento) que contienen trozos reutilizables
de formularios. Este fragmento al que llamaremos fragmento de control ser
suministrado por los responsables del servicio FORPDF.
De esta forma los diseadores de formularios simplemente han de aadir a su diseo
el fragmento de control suministrado, sin tener que conocer ms detalles de dicho
fragmento.
En el siguiente enlace dispone de un tutorial de Adobe que explica en detalles el
concepto de fragmentos y cmo utilizarlos: Creating and Using Fragments in Form
Designs.
Es importante tener en cuenta la ubicacin en la que se ha de incluir el fragmento de
control ya que al tratarse de XML la inapropiada ubicacin de este fragmento podra
implicar que el servicio de formulario PDF no sea capaz de localizar estos campos
dentro de la estructura XML resultante del diseo final del formulario.
La ubicacin correcta es siempre a primer nivel dentro del nodo principal form (el
nodo form ser el inicial en todos los formularios). Aadir el fragmento de control a un
formulario debe verse reflejado en la estructura del formulario diseado, tal y como se
ensea a continuacin:
Pgina 34 de 34
El nodo aadido se llama control. Si dicho nodo se encuentra como hijo del nodo
form esto indicar que el fragmento se ha aadido correctamente.
Tambin ha de aadirse otro fragmento llamado forpdf_lib, el cual ir siempre dentro
del elemento Variables, tal y como se ve en la imagen anterior. Este fragmento
contiene cdigo JavaScript de Acrobat para gestionar el mecanismo de envo de
datos, validaciones bsicas y los elementos de control.
Finalmente mencionar que los dos fragmentos a incluir en cada formulario se alojarn
en el repositorio de Adobe LiveCycle, al igual que el resto de fragmentos que los
diseadores creen con el paso del tiempo.
7.4 Aadir un formulario a FORPDF

Una vez que el formulario est diseado (con el fragmento de control aadido), ha de
registrarse en el servicio de FORPDF (el cual a su vez almacenar la plantilla en el
Servicio de SGRDE de Platino).
Para ello se utilizar el mtodo guardarPlantilla (ver CU-FPDF-6) de este
servicio.
Una vez subida la plantilla podr instanciarse utilizando el mtodo
iniciarFormulario (ver CU-FPDF-4) pasando como idFormulario la uri
devuelta por la invocacin al mtodo guardarPlantilla.

Formularios PDF r4

Cargado por

Copyright:

Formatos disponibles

Formularios PDF r4

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Formularios PDF r4

Cargado por

Copyright:

Formatos disponibles

Interoperabilidad de los servicios telemticos de la

MARCO DE REFERENCIA PARA LA

VOLMEN IV: MANUAL DEL DESARROLLADOR

SERVICIO DE FORMULARIO PDF (FORPDF).

Rev. Fecha Descripcin

0 01/08/2010 Versin inicial

2.1 PUBLICACIN DE FORMULARIOS, Parmetro ticket.

Documento : PLA-DOC-TEC-11-07-04 Servicio Formulario PDF

Preparado por Revisado por Aprobado por

El objeto de este documento es describir en detalle y profundidad el Servicio de

El Servicio de Formularios Electrnicos (FORPDF) est compuesto por dos mdulos:

Un servicio de web que brinda una serie de mtodos (que se enumeran y

Un diseador de formularios, que es la herramienta Adobe LiveCycle Designer,

Los formularios resultantes deben gestionarse (abrirse, rellenarse) con la herramienta

2 DEFINICIN DEL SERVICIO

2.1 PUBLICACIN DE FORMULARIOS

El mdulo publicador es accesible va HTTP. Para publicar un formulario es necesario

Una vez publicado el formulario, el usuario puede interactuar con l y rellenarlo.

Es importante mencionar que el servicio FORPDF no ser responsable de firmar

2.2 VALORES INICIALES DE UN FORMULARIO

Cuando se inicia un formulario (ver CU-FPDF-4 Inicializar Formulario) es posible

Los valores se indicarn en formato XML y seguirn el esquema descrito por la

2.3 FIRMA DE UN FORMULARIO

El servicio de FORPDF no ser responsable de firmar los formularios, pero s de la

Cuando el ciudadano se disponga a firmar un formulario la Sede ha de invocar el

3 VERSIN DEL SERVICIO

Este documento corresponde a la versin 20110704 del servicio.

Generacin dinmica de formularios electrnicos; esta operacin debe ser

La siguiente figura muestra los distintos casos de uso del servicio.

4.1 CU-FPDF-1: GUARDAR FORMULARIO BORRADOR

Como resultado de su invocacin el mtodo devolver una url, la cual se

En este punto no se registra ningn dato en el SGRDE de Platino, todo se registra en

Entrada del servicio:

Parmetro Descripcin Tipo

Ticket que identifica el formulario al que corresponden los

Cadena de caracteres en formato XML que contiene los

Salida del servicio

Parmetro Descripcin Tipo

4.2 CU-FPDF-2: CANCELAR

Entrada del servicio:

Parmetro Descripcin Tipo

ticket Ticket que identifica el formulario que se est cancelando. String

Salida del servicio

Parmetro Descripcin Tipo

4.3 CU-FPDF-3: OBTENER DOCUMENTO CONSOLIDADO

La consolidacin consiste en obtener los datos de un formulario (incluyendo la

De esta forma este mtodo devuelve un objeto complejo conteniendo el PDF

Entrada del servicio:

Parmetro Descripcin Tipo

ticket Ticket que identifica el formulario que ha de consolidarse. String

Salida del servicio

Parmetro Descripcin Tipo

4.4 CU-FPDF-4: INICIAR FORMULARIO

Mtodo para iniciar un formulario PDF.

Este mtodo es el punto de inicio para completar un formulario ya que en primera

iniciar, ruta del SGRDE donde ha de guardarse y algunos parmetros ms que se

Entrada del servicio:

Parmetro Descripcin Tipo

URL a devolver por el servicio cuando se invoque los mtodos