FirmaDoc BPM Gestión Documental. Firma Electrónica reconocida Expedientes Digitalización Certificada Interoperabilidad de FirmaDoc BPM

Transcripción

1 FirmaDoc BPM Gestión Documental Firma Electrónica reconocida Expedientes Digitalización Certificada Interoperabilidad de FirmaDoc BPM Berger-Levrault 0

2 Índice de contenido Interoperabilidad de FirmaDoc BPM Introducción Soporte de Estándares Integración con datos Importación/exportación de definiciones de procesos, formularios y otras estructuras Importación/exportación de datos (documentos, expedientes ) Acceso a la información custodiada en FirmaDoc BPM Integración con otras aplicaciones y sistemas AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 1

3 FirmaDoc BPM Gestión Documental Interoperabilidad de FirmaDoc BPM 1. Introducción Este documento describe el soporte de FirmaDoc BPM en cuanto a estándares en materia de gestión de documentos y expedientes electrónicos así como la interoperabilidad con otros sistemas, tanto en lo que se refiere a datos como aplicaciones. FirmaDoc BPM está estructurado en los siguientes módulos funcionales: Gestión documental: capa que abarca operaciones del ciclo de vida completo tanto de documentos como expedientes. Firma electrónica reconocida: funciones relacionadas con certificados digitales, verificación y generación de firmas electrónicas, así como obtención y custodia de evidencias electrónicas. Expedientes digitales: capa de abarca la definición formal, ejecución y monitorización de expedientes, con metodología BPM. Es importante entender que FirmaDoc BPM, además de ser un sistema de gestión de documentos y expedientes electrónicos completo y polivalente en su base, es también un sistema de gestión plenamente desarrollado e integrado con las aplicaciones verticales de Aytos Berger-Levrault, así como de terceros, para la correcta implementación del concepto de Administración Electrónica. En este sentido, por encima de las 3 capas fundamentales anteriores, FirmaDoc BPM incorpora funcionalidad específica para: Procesos de negocio relacionados con el flujo y aprobación de documentos (DocuFlow). Procesos de negocio relacionados con los expedientes electrónicos (BPM) y soporte del estándar XPDL para la definición de procesos. Procesos de negocio relacionados con la gestión electrónica en productos verticales, como Contabilidad, Padrón, Gestión Tributaria, Gestión Patrimonial, etc. Procesos de negocio exclusivos de Administración Electrónica (publicación fehaciente en Perfil del Contratante, emisión de certificados visados por la Entidad, gestión de certificados del empleado público, foliado de expedientes, integración con Registro de Entrada y Salida, notificaciones electrónicas, etc.) Integración nativa con cualquier Registro de E/S. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 2

4 Ciclo de vida completo de la factura electrónica, con soporte de estándares de factura electrónica Facturae y UBL, e integración con las plataformas de facturación electrónica INDRA, CaixaFactura y E.FACT. Digitalización certificada (software homologado por la AEAT). Portafirmas cliente/servidor (aplicación Windows de escritorio) Portafirmas web (Java) Servicios web XML y librerías para desarrolladores (APIs) Servicio de indexación y OCR Motor de automatización de procesos y reglas de negocio (BPMS/BRE) Conectores con servicios de la Administración Pública (@Firma, MAP, FNMT, CatCert, ACCV, Camerfirma, DNI electrónico, ) En el apartado siguiente de este documento, se relacionan los distintos estándares y normativas que rigen el funcionamiento de FirmaDoc BPM. A continuación se describen los mecanismos de acceso a datos, tanto del propio FirmaDoc BPM como con otras bases de datos (integración de datos). Por último se enumeran las posibilidades de integración de otras aplicaciones con FirmaDoc, en ambos sentidos (integración de procesos). 2. Soporte de Estándares Documentos electrónicos: Visualización de serie de los formatos Office (DOC, XLS, PPT), Office 2007 (DOCX, XLSX y PPTX), PDF, RTF, TXT, HTML, XML, PNG, JPEG, TIFF, GIF y BMP. Visualización opcional para formatos específicos (en total más de 450 formatos de todo tipo: ráster, 2D/3D, CAD/CAM, medicina y multimedia) Digitalización en formatos TIFF, PDF, PDF/A (ISO ), BMP, GIF, JPEG. Soporte de formatos Facturae 3.0 y 3.1 (XML). Soporte de formatos UBL 1.0 y 2.0 (XML). Conversión a PDF desde formatos HTML, DOC, RTF, TXT, PNG, TIFF, JPEG, GIF y BMP. Compatibilidad con suites de ofimática Microsoft Office y OpenOffice. Exportación de datos a Office Excel, Word, OpenOffice Calc y Writer. Plantillas de documentos diseñadas con Word, Writer, Gendoc o HTML. Expedientes electrónicos: Diseño de procedimientos según notación BPMN 1.1 Exportación a formato XPDL 2.1 AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 3

5 Gestión documental y archivística: Moreq 2 e ISO Clasificación archivística ISAD(G) y CNEDA Firma electrónica: Soporte para 39 tipos de certificados digitales diferentes (incluyendo DNI electrónico, FNMT Clase 2 CA, CatCert, ACCV, IZENPE, Camerfirma, Firmaprofesional, ANCERT, etc.) Sello de interoperabilidad #1 de CatCert Validación de certificados por CRL, OCSP y servicios web XML. Generación de firmas en formato CMS/PKCS7 detached y XADES. Generación de firmas en documentos PDF, incluyendo sello de tiempo RFC Incorporación de tokens OCSP en firmas XADES. Registro de Evidencias Electrónicas con validación de firmas. Incorporación de sello de tiempo (adjunto en firmas PKCS7 y parte del XML en XADES). Generación de firmas XADES según variantes XADES-B, C, T, L, X-L. Servicios de las Administraciones Públicas: Integración con repositorios LDAP de la FNMT y otros organismos para la validación de certificados Clase 2 CA Integración vía servicio web XML para la validación de certificados y firmas electrónicas Integración vía servicio web XML con plataforma PSIS para la validación de certificados y firmas electrónicas Integración vía servicio web XML con plataforma ACCV para la validación de certificados, firmas electrónicas y sello de tiempo RFC 3161 Integración con Portafirmas de la Junta de Andalucía Integración con E.FACT (plataforma de facturación electrónica de la AOC Administració Oberta de Catalunya). Integración con varios aplicativos de Registro de Entrada y Salida Servicios de Terceros Integración con plataforma GIS Galilego Integración con plataformas de facturación INDRA y CaixaFactura Compatibilidad con Plataformas y Navegadores: Aplicación de escritorio para Windows 2000 o superior Portafirmas y gestor de tareas web (Java) para navegadores Internet Explorer y Firefox. Servicios Windows para indexación y motor de procesos AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 4

6 3. Integración con datos Desde el punto de vista de la información, cada capa funcional (documentos, expedientes y firma) contiene definiciones de las estructuras de datos así como instancias (los propios datos en sí), custodiados en un gestor de base de datos relacional SQL Server u ORACLE. Existe una base de datos principal, denominada de Administrador, y otra dedicada a repositorio de información de FirmaDoc, denominada Biblioteca. Las definiciones, por ejemplo, los tipos de documentos, tipos de expedientes, composición del organigrama de la entidad o diagramas de procedimientos, están almenados en registros de tablas o bien en XML (almacenado en campos de tablas). En XML están descritos tanto los formularios como los procedimientos. El motivo principal de haber elegido este formato es la necesidad de crecimiento en estructura de estas dos entidades (formularios y procedimientos), lo que nos llevaría en un modelo clásico relacional a ampliar constantemente el modelo con nuevas tablas y campos. En FirmaDoc BPM, un procedimiento es una entidad compleja que aglutina un número elevado de actividades, conectores, pools, eventos, reglas de negocio, aspectos de diseño del diagrama (ubicación de los elementos, colores, formas, textos, ), propiedades de cada una de las actividades, quien las realiza, cuando, bajo qué condiciones, etc. Todas estas propiedades que permiten que un procedimiento se defina hasta el extremo de poder ejecutarse requerían de una estructura que permitiera su crecimiento sencillo y sin afectar a las versiones ya existentes. Por ello se optó para estas entidades complejas encapsular todos sus detalles en un archivo XML y almacenar este archivo en la tabla de definición de procedimientos. De forma análoga ocurre con los formularios. Éstos contienen diversos tipos de controles de entrada de datos, ubicaciones, colores, etc. que encajan perfectamente con la filosofía de XML. Las instancias sin embargo se almacenan en FirmaDoc BPM exclusivamente en registros de tablas. Estos registros pueden contener datos de los propios formularios y de expedientes, los binarios de los documentos generados e imágenes, así como metadatos y otra información necesaria que describen el estado de estas instancias. Para hacer escalable al sistema, se pueden definir volúmenes secundarios para almacenar estrictamente los documentos electrónicos, en lugar de residir en la base de datos relacional. El sistema es muy flexible en cuanto al número y condiciones de uso de los volúmenes. Éstos son recursos compartidos en uno o varios servidores, protegidos por contraseña que únicamente conoce FirmaDoc BPM, por lo que la seguridad del acceso está garantizada. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 5

7 Este sistema de almacenamiento es compatible con RAID, NAS y RAS, así como con software de terceros que permiten encriptar archivos (opcional), así como con cualquier software de copias de seguridad. 4. Importación/exportación de definiciones de procesos, formularios y otras estructuras Alguna de las tablas que incluyen definiciones en FirmaDoc son: A_ORG_UOR A_ORG_UOR_TIP TDO FDT TXP GFI Estructura orgánica de la entidad Tipo de unidad orgánica Tipos de documentos Familias de tipos de documentos Tipos de expedientes Grupos de firma En la versión actual de FirmaDoc BPM (9.0) hay más de 70 tablas relacionadas con definiciones del sistema y 2 esquemas XML para formularios y procedimientos. Herramienta de exportación de definiciones Para facilitar la implantación y obtención de procedimientos FirmaDoc BPM incluye una herramienta específica de importación y exportación de datos que dispone de dos opciones principales: Exportar a disco un formulario y todos sus elementos dependientes automáticamente Exportar a disco un procedimiento y todos sus elementos dependientes automáticamente La herramienta está diseñada de forma que puede invocarse también desde las APIs, permitiendo exportar no sólo formularios y procedimientos, sino cualquier otro elemento de definición del sistema junto con todas sus dependencias. Por ejemplo, podríamos exportar un tipo de expediente y la herramienta incluiría en el archivo XML tanto los datos del tipo de expediente como por ejemplo documentación asociada requerida, hitos previstos, etc. La exportación realizada con esta herramienta genera un único archivo XML, que en algunos casos puede ocupar varias decenas de megabytes, dado que arrastra absolutamente todas las dependencias con objeto de que al ser importado quede reflejada una copia exacta del original. Por ejemplo, si exportamos el procedimiento de Resoluciones de Alcaldía, en el archivo XML se incluiría el diagrama del procedimiento, los detalles de cada una de las tareas, plantillas, formularios, campos, etc. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 6

8 También es posible generar un XML ligero con únicamente la definición del procedimiento, sin sus dependencias, lo que nos daría información únicamente del diagrama. La estructura del archivo XML ha sido definida por Aytos Berger-Levrault según las necesidades del producto, no obstante a partir de Junio de 2009 estará disponible la exportación de cualquier procedimiento en formato XPDL 2.1 (estándar internacional de definición de procesos BPM). Es importante reseñar que los procedimientos en FirmaDoc BPM son ejecutables, y por tanto contienen detalles tanto de diseño como de ejecución real. El estándar XPDL únicamente sirve para persistir el diagrama (flujograma) del procedimiento. Herramienta de importación de definiciones FirmaDoc BPM incluye una opción de Importar datos que permite seleccionar un archivo XML de exportación, analizarlo y proceder a su carga en la entidad actual. Esta herramienta realiza además un análisis previo de la información en el XML contrastándola con la que tenemos, siendo capaz de detectar si un registro será actualizado o si será insertado en la tabla correspondiente. El resultado de este análisis es mostrado al usuario pudiendo éste exportarlo a Excel o Calc, para hacer las validaciones que crea conveniente antes de confirmar la operación. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 7

9 Validación de procedimientos Además, FirmaDoc BPM incluye una función imprescindible para validar procedimientos. Esta función permite seleccionar un procedimiento y detectar carencias o incongruencias que puedan afectar a su ejecución, como por ejemplo que no hayamos asignado participantes a una actividad interactiva o que un tipo de documento haya sido eliminado y por tanto pueda afectar a la ejecución del procedimiento. 5. Importación/exportación de datos (documentos, expedientes ) Todas las instancias generadas en FirmaDoc BPM se almacenan estrictamente en registro de tablas. Como opción especial se permite almacenar los binarios de los documentos en repositorios en disco (ya que son los datos que ocupan más espacio), protegidos por contraseña y mediante un sistema de distribución de carga que permite una gran flexibilidad y escalabilidad del sistema. Algunas de las tablas que alojan instancias son: IDX DOC EXP WF_PRI FIR Índice general de la biblioteca Binarios (documentos e imágenes) Expedientes Procedimientos ejecutados Firmas electrónicas AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 8

10 En la versión actual de FirmaDoc BPM (9.0) hay más de 50 tablas relacionadas con instancias de este tipo. Herramienta de exportación de documentos FirmaDoc BPM incluye una opción de exportación de documentos (guardar a disco) aplicable a una selección de documentos, y permite arrastrar anexos y firmas electrónicas asociadas. Se preserva el formato del documento original, si bien es posible especificar que se desea guardar una versión en F64 (formato tributario) o bien en PDF con datos adicionales (incluye código de verificación online y código de barras). Además permite especificar si queremos clasificarlos en carpetas en disco por su tipo de documento, así como asignarle un nombre con un contador o bien respetar el nombre del documento actual. Herramienta de exportación de expedientes (foliado) FirmaDoc BPM incluye una opción de foliado del expediente que permite seleccionar un expediente concreto y generar un índice de todos los documentos que contiene, firmar electrónicamente este índice y guardarlo en disco, junto con los documentos y formularios de datos asociados (los datos de formularios se guardan como ficheros de texto). Herramienta de importación de documentos FirmaDoc BPM incluye una opción de importación de documentos masiva, que permite incorporar al sistema todos los documentos encontrados en una carpeta. También es posible configurar una ruta de importación, que puede ser jerárquica (una carpeta por tipo de documento), con lo que basta con arrastrar archivos a dicha estructura para que se inserten automáticamente en el gestor documental. 6. Acceso a la información custodiada en FirmaDoc BPM Modelo de datos documentado El modelo de datos completo del sistema está documentado y está a disposición del cliente que lo requiera. Se entrega un documento en formato PDF para las entidades en la base de datos del Administrador y otro con las entidades en la base de datos de Biblioteca. Con la ayuda del modelo de datos y el soporte incluido en el mantenimiento del producto es posible realizar consultas directas contra la base de datos documental, extraer datos y hacer cálculos, estadísticas, etc. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 9

11 No obstante, no se permite realizar modificaciones el sistema incluye algunas medidas de seguridad para garantizar que los documentos especialmente sólo se insertan en la biblioteca a través de los cauces permitidos y se detecta además cualquier modificación directa en un registro del índice de documentos (IDX). Por ejemplo, no es posible cambiar el estado de aprobación de un documento, o modificar su estado de eliminación. El sistema detecta esta manipulación directa indebida y emite una advertencia en pantalla al operar con el documento. API Librerías de integración El producto incluye un conjunto de librerías, APIs, para desarrolladores, que junto con una documentación en PDF, permite integrar o construir aplicativos que exploten el gestor documental con plena autonomía. Más del 70% de la funcionalidad de FirmaDoc Bandeja de Entrada está disponible en las APIs, lo que incluye: digitalización, operaciones con documentos y expediente, firma electrónica, consultas de todo tipo, acceso a los objetos de administración, etc. Esta capacidad de integración es fundamental para que otros proveedores o el propio cliente puedan conectar sus aplicativos con el gestor documental y permitir así disponer de un repositorio corporativo y no segmentado. Servicios web XML Se ha diseñado una Capa de Integración basada en Servicios web XML y desarrollada 100% en Java y Apache/Axis con objeto de permitir que cualquier otro sistema, con independencia de su tecnología o arquitectura pueda llevar a cabo operaciones de gestión documental sobre FirmaDoc BPM. La Capa de Integración permite realizar tanto operaciones de bajo nivel (inserción, eliminación, actualización de metadatos, ) en documentos como en expedientes, así como acceso a interfaces de usuario para visualización, firma electrónica, etc. Las operaciones disponibles están recogidas en la siguiente tabla: Tipo de objeto Operación Notas Documentos Alta Modificación de atributos Borrado Visualización El servicio web devuelve una URL segura temporal a través de la cual la aplicación cliente puede acceder al visor completo de FirmaDoc Web limitado a este documento. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 10

12 Expedientes Obtención de copia Obtención de atributos Búsquedas Alta Modificación de atributos Obtención de atributos Borrado Consulta Visualización El servicio web devuelve una URL segura temporal a través de la cual la aplicación cliente puede acceder al visor completo de FirmaDoc Web limitado a este expediente. El servicio web XML ha sido diseñado para simplificar el intercambio de parámetros. Todas las operaciones son accesibles a través de un único método que acepta un único parámetro de entrada de tipo String y que debe contener un mensaje codificado en SML. Este método devuelve igualmente otro String con el resultado de la operación codificado también en SML. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 11

13 El esquema del servicio web (WSDL) es el siguiente: <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions targetnamespace=" xmlns=" xmlns:apachesoap=" xmlns:impl=" xmlns:intf=" xmlns:soapenc=" xmlns:wsdl=" xmlns:wsdlsoap=" xmlns:xsd=" <wsdl:message name="servicioresponse"> <wsdl:part name="servicioreturn" type="xsd:string"/> </wsdl:message> <wsdl:message name="serviciorequest"> <wsdl:part name="sml" type="xsd:string"/> </wsdl:message> <wsdl:porttype name="ciinterfaz"> <wsdl:operation name="servicio" parameterorder="sml"> <wsdl:input message="intf:serviciorequest" name="serviciorequest"/> <wsdl:output message="intf:servicioresponse" name="servicioresponse"/> </wsdl:operation> </wsdl:porttype> <wsdl:binding name="ciinterfazsoapbinding" type="intf:ciinterfaz"> <wsdlsoap:binding style="rpc" transport=" <wsdl:operation name="servicio"> <wsdlsoap:operation soapaction=""/> <wsdl:input name="serviciorequest"> <wsdlsoap:body encodingstyle=" namespace=" use="encoded"/> </wsdl:input> <wsdl:output name="servicioresponse"> <wsdlsoap:body encodingstyle=" namespace=" use="encoded"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <wsdl:service name="ciinterfazservice"> <wsdl:port binding="intf:ciinterfazsoapbinding" name="ciinterfaz"> <wsdlsoap:address location=" </wsdl:port> </wsdl:service> </wsdl:definitions> 7. Integración con otras aplicaciones y sistemas Acceso a datos externos FirmaDoc BPM dispone de herramientas para permitir obtener datos en formularios obtenidos desde bases de datos externas o sistemas externos. Para ello se pueden definir filtros SQL y utilizarlos en botones de búsqueda y selección, así como asociar cada columna devuelta a un campo del formulario. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 12

14 Esta vinculación puede hacerse manualmente (el usuario realiza una búsqueda) o bien automáticamente (cada vez que se visualiza el formulario se vuelven a leer los datos de la base de datos). El acceso a datos se puede realizar a través de ODBC o sin él, lo que evita crear un acceso ODBC en cada máquina que quiera acceder a la base de datos externa. Puede incluirse código VBScript asociado a cada campo para realizar cálculos entre campos del mismo formulario o del expediente, así como obtener un dato de una base de datos externa o invocar una aplicación web. El sistema es muy avanzado y en este sentido permite dotar a los formularios de un control muy refinado en cuanto a los datos que puede introducir el usuario. Por ejemplo, puede controlarse que el importe introducido no supere el saldo de una partida, no constando este dato en FirmaDoc BPM y teniendo que acceder en tiempo real a la base de datos contable. En otro ejemplo podríamos tener un formulario que a partir de una serie de datos básicos, invocase un aplicativo web para realizar cálculos sobre deuda pendiente, etc. y el importe remanente volcarlo sobre otro campo del formulario. Envío de eventos a aplicaciones web Es posible configurar que se invoque una URL junto con unos parámetros cada vez que sucede un evento, como por ejemplo que un documento sea firmado. Esta funcionalidad ha de configurarse dentro del mantenimiento de FirmaDoc BPM Eventos a notificar. Invocación de componentes externos FirmaDoc BPM dispone además de mecanismos para invocar DLLs en entornos cliente/servidor y Servicios Web de forma centralizada, mediante un sencillo y universal framework de integración que permite invocar componentes de otras aplicaciones a lo largo de un proceso BPM. Este framework permite una gran libertad hacia otros desarrolladores que, siguiendo las normas indicadas, pueden resolver una integración de FirmaDoc BPM con sus propios sistemas sin necesidad de realizar ninguna adaptación en FirmaDoc BPM. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 13

15 Integración en cliente/servidor Este modo de integración es útil cuando el aplicativo a integrar es cliente/servidor o bien cuando la integración ha de ser supervisada, confirmada o asistida por parte del usuario. En esta modalidad se procede al alta del componente a invocar en el mantenimiento de aplicaciones de FirmaDoc BPM y se configura una tarea en el proceso BPM de tipo aplicación interactiva. Al ser interactiva, el componente en cuestión sólo se ejecutará cuando el participante que corresponda inicie la tarea. Cuando la tarea de aplicación interactiva es abierta, el componente de la aplicación integrada es instanciado. Este componente ha de disponer de dos métodos públicos, PermisoAccion y EjecutaAccion. El método PermisoAcción recibe dos parámetros (ACCION y CONTEXTO) y devuelve un booleano a FirmaDoc BPM que indica si la acción particular está permitida según el contexto que es proporcionado al componente. Las acciones posibles están predefinidas: TCO_INICIAR = 1 (iniciar la operación) TCO_CANCELAR = 2 (cancelar la operación) TCO_REASIGNAR = 3 (reasignarla) TCO_REINICIAR = 4 (reiniciarla) TCO_VISUALIZAR = 5 (visualizar lo que considere oportuno el componente) TCO_FINALIZAR = 6 (finalizar la operación) TCO_CONTINUAR_MAS_TARDE = 7 (continuar más tarde la operación) TCO_REALIZAR_AUTOMATICAMENTE = 8 (Sólo en tareas que no requieran intervención del usuario) El parámetro CONTEXTO es una referencia a un objeto previamente instanciado por FIRMADOC BPM de tipo FIRMADOC0.cls_contexto. Este objeto contiene información sobre el contexto en el que se ejecuta la operación. Esta información incluye: ofirma = referencia a un objeto de API de FirmaDoc BPM (FIRMADOC0.cls_firmadoc) a través del cual es posible explotar todas las funcionalidades y datos del gestor documental. Por seguridad es necesario habilitar una opción específica en el mantenimiento de aplicaciones de FirmaDoc BPM para permitir facilitar este parámetro. oadb = referencia a un objeto de acceso a datos, a través del cuál se puede acceder directamente a la base de datos de Administrador o base de datos de Biblioteca. Por seguridad es necesario habilitar una opción específica en el mantenimiento de aplicaciones de FirmaDoc BPM para permitir facilitar este parámetro. lngexpid = Id del expediente relacionado con el proceso en el que se ejecuta la tarea. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 14

16 lngtxpid = Id del tipo de expediente relacionado. lngtarid = Id de la tarea de aplicación que está siendo ejecutada. lngpriid = Id del proceso (instancia) que está siendo ejecutado. lngproid = Id del tipo de proceso que está siendo ejecutado. lngdocid = Id del documento asociado a la tarea (si existiese). lngfrmid = Id del tipo de ficha asociado a la tarea (si existiese). straplparams As String = parámetros de la aplicación interactiva (definibles en el mantenimiento) A través del objeto Contexto, el componente queda situado y puede determinar las operaciones permitidas en ese momento, así como ejecutarlas. Para ejecutar la operación deseada, el componente de integración debe proporcionar el método EjecutaAccion, que también recibe dos parámetros, al igual que PermisoAccion: ACCIÓN y CONTEXTO. Cuando el participante pulsa sobre el botón Iniciar tarea, FirmaDoc BPM procede a llamar al método EjecutaAccion, el cuál debe devolver un booleano indicando si el resultado de la ejecución es correcto o no. En cuanto a los requisitos técnicos del componente de integración destacar que éste debe ser un componente ActiveX, si bien, internamente puede a su vez invocar un servicio web XML, un componente Java, Win32, etc. Integración en servidor Este modelo de integración supone que la invocación del componente de la aplicación integrada se llevará a cabo de forma silenciosa y desasistida. Al igual que ocurre en la integración en modo cliente/servidor, es necesario catalogar el componente en el mantenimiento de aplicaciones de FirmaDoc BPM. Una vez hecho esto, basta con incluir en el proceso BPM una tarea de tipo aplicación (que no aplicación interactiva ) y seleccionar el componente de la lista de aplicaciones configuradas. Las aplicaciones integradas de esta forma únicamente son invocadas desde el Servidor de Procesos (SDP), de forma totalmente desasistida y automática. Cualquier retorno de error es anotado como resultado verboso de la tarea. En cuanto a protocolo de comunicación, en este caso, el componente deberá estar accesible a través de servicio web XML. FirmaDoc permite especificar la URL del servicio web, así como el nombre del método y su espacio de nombres a invocar (ActionURI en SOAP). Este método debe aceptar un único parámetro de tipo String SML, así como devolver otro también de tipo String SML. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 15

17 El formato del parámetro String SML de entrada no es más que una estructura en XML simplificado (Simple XML o SML) que contiene dos secciones principales: cabecera y datos (<h> y <d> respectivamente): <e> <h> <id>id DE TRANSACCIÓN (valor único GUID)</id> <fe>fecha/hora DE INVOCACIÓN</fe> <op>código DE OPERACIÓN</op> <pri>id DE LA INSTANCIA DE PROCESO</pri> <tar>id DE LA TAREA EN EJECUCIÓN</tar> <exp>id DEL EXPEDIENTE (opcional)</exp> <pro>id DEL TIPO DE PROCESO</pro> </h> <d> <dat num= 1 cod= CÓDIGO DEL CAMPO val= VALOR DEL CAMPO /> <dat num= N cod= CÓDIGO DEL CAMPO val= VALOR DEL CAMPO /> </d> </e> En la parte de datos, el mensaje SML contiene una colección de pares, campo-valor, por cada dato del expediente. La interpretación de dichos datos es responsabilidad del componente invocado. La relación de campos-valor debe estar compuesta por un código nemotécnico del campo y su correspondiente valor. Ejemplo: <REG.INT.NOM>Ramiro</REG.INT.NOM>. Los valores deberán ir convenientemente codificados atendiendo a su tipología y respetando el estándar XML: Los datos de tipo String deberán ser enmascarados según las normas HTML. Ejemplo: rbol (árbol) o España (España). Los datos de tipo Numérico deberán presentarse sin separador de miles y en caso de llevar decimales con punto decimal y dos decimales (N.NN). Ejemplo: Los datos de tipo Fecha deberán presentarse en formato UTC. Ejemplo: T15:12:00+02:00. El servicio web XML deberá además devolver un valor de retorno, codificado también como otro String XML, con la siguiente estructura: <s> <h> <id>id DE TRANSACCIÓN (DEBE COINCIDIR CON EL PARÁMETRO DE ENTRADA)</id> <exito>código GENERAL DE RESULTADO: 0=error, -1=correcto)</éxito> <res>descripción DEL RESULTADO O ERROR (opcional)</res> AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 16

18 <fs>fecha/hora DE RESULTADO</fs> </h> <d> <dat num= 1 cod= CÓDIGO DEL CAMPO val= VALOR DEL CAMPO MODIFICADO /> <dat num= M cod= CÓDIGO DEL CAMPO val= VALOR DEL CAMPO MODIFICADO /> </d> </s> En el valor de salida, salvo los campos ID y ÉXITO, todos los demás son opcionales y sólo deberían indicarse si vienen devueltos con modificaciones. La correspondencia entre los campos suministrados y los devueltos modificados se lleva a cabo por el código del campo, no por el orden en el que se suministra (por tanto el atributo num es accesorio). FirmaDoc BPM actualizará los datos del expediente o de los documentos que contengan dichos campos con los valores devueltos en el mensaje de salida. AYTOS / Berger-Levrault - julio de Avenida Blas Infante 6, 2 Planta Écija (Sevilla) 17