INTEGRACIÓN BPM-LIFERAY SOL

Transcripción

1 INTEGRACIÓN BPM-LIFERAY SOL Mª Jesús Clemente 09/02/2015 Grupo Norte

2 Índice Participantes y Control de Modificaciones... 2 Petición... 2 Objetivo... 2 Exclusión... 2 Descripción del sistema actual Requerimientos del nuevo sistema... 2 Nuevas funcionalidades o Programas modificados... 2 Solución Propuesta: Autenticación a través de SSO Portlet de Bandeja de Entrada Portlet para creación de nuevos proyectos Condiciones Generales: Página 1 de 15

3 Participantes y Control de Modificaciones Nombre Descripción Versión Fecha Mª Jesús Clemente Versión Inicial /02/2015 Antonio Perez Revisión /02/2014 Petición Se solicitan dos portlets para integrar dentro de liferay. Objetivo Integrar Expert BPM con liferay Exclusión Descripción del sistema actual. Actualmente, Grupo Norte utiliza internamente Expert BPM de forma interna. Es decir, ni proveedores ni clientes acceden a la herramienta Expert BPM para introducir información. Requerimientos del nuevo sistema Requerimientos funcionales del nuevo sistema. 1. Dar acceso a Expert BPM a usuarios externos (clientes, proveedores, etc9 2. Disponer de portlets para ver y crear proyectos integrados dentro de la plataforma Liferay Nuevas funcionalidades o Programas modificados Nuevas funciones Página 2 de 15

4 Solución Propuesta: 1. Autenticación a través de SSO El objetivo principal es establecer un sistema de validación y autenticación de un usuario en la aplicación Expert BPM cuando la entrada a la aplicación se realiza desde Liferay o cualquier aplicación externa. Dicha entrada no debe llevar a una pantalla de login sino que debemos entrar directamente a la aplicación Expert BPM autenticados. Actualmente Datadec soluciona el acceso a Expert BPM mediante la integración de Liferay con LDAP y aplicaciones Datadec. Todos los usuarios están centralizados en LDAP, de modo que cuando se crea un usuario en Netuin (portal desarrollado en Liferay) se crea automáticamente en LDAP. El usuario en LDAP tiene como propiedad que usuario es en Expert BPM. *La solución anterior no nos sirve para el cliente Grupo Norte porque no es posible utilizar LDAP para la gestión de todos sus usuarios. Tras conversación con Mónica Martín (Neoris), una posible solución a las distintas llamadas a BPM o servicios web de BPM, sería la siguiente: Llamadas a la aplicación Expert BMP Un ejemplo de llamada sería ver el formulario asociado al proyecto desde un proyecto que aparece en el portlet de bandeja de entrada. El usuario pulsa sobre el código de proyecto y aparece una nueva ventana con el formulario definido en la tarea y las acciones que puede realizar. Para este caso la solución ideal sería utilizar CAS Client en Expert BPM pero en este caso no es posible dado que Expert BPM está desarrollada con mod_plsql. CAS Client está desarrollado para diversos lenguajes (php, java, pyton, nodejs, etc) pero no existe una solución oficial para pl/sql (en google aparecen algunas soluciones con ORDS pero no son oficiales). Creemos que la mejor solución es generar un token que identifique al usuario desde la base de datos. Esto lo podemos entender mejor explicando el funcionamiento del portlet de bandeja de entrada. El portlet obtiene los datos, en este caso los distintos proyectos, invocando a servicio web que accede a la base de datos de BPM y ahí es donde construimos la url de acceso al proyecto de BPM donde uno de sus parámetro es un token, la pantalla que muestra el formulario de la tarea se encarga de decodificar el token para autenticar al usuario. Página 3 de 15

5 En la imagen siguiente podemos ver como existe una función javascript (abrir_proy) donde uno de los parámetros es el token generado que identifica al usuario, empresa, grupo, proyecto, etc. Esta sería la url del servicio web invocado. La llamada al proyecto y que autentica al usuario según el token sería PK_SP_WEB.INI_ENTRADA? P_TOKEN=CO0ca9Hl7fEYVCjh90219iHU0Qdj03 &P_CODIGO_ACCESO=LOGCRID &P_APPL_ID=WKFLW &P_TARGET=_self &P_OCULTAR_COD_ACCESO=S &P_URL=PK_ADM_PANEL_PROYECTO.INIT{P_EMPRESA="+d+"}P_TIPO_PROYECTO=" +c+"}p_proyecto="+f+"}p_version="+a+"}p_tarea=}p_version_tarea=}p_wind OWOPEN=N *Ejecución del ws con Swagger. Conclusión, podemos establecer la autenticación en nuestra aplicación siempre y cuando la url de llamada se haya generado desde un servicio web de BPM. Página 4 de 15

6 Nota: uno de los requisitos para poder hacer esta llamada es que los usuarios de Liferay estén relacionados 1 a 1 con los de BPM. Llamadas a servicios web de BPM Un ejemplo de llamada sería la ejecución de una tarea de un proyecto que no requiere formulario o la obtención de datos de BPM (por ejemplo datos del buzón de tareas). Para este caso podríamos utilizar CAS Client ya que nuestros servicios web están desarrollados en java pero esta solución no es válida porque no queremos utilizar una pantalla de login para solicitar un ticket a CAS Server. Creemos que la mejor solución para realizar llamadas seguras a los servicios web de BPM es realizando un hook en la pantalla de login que genere un ticket desde la BBDD para las llamadas a los servicios web. A continuación describiremos los pasos del desarrollo: 1. Paso 1: El usuario entra en Liferay introduciendo su usuario y password en la pantalla de login. 2. Paso 2: El hook se dispará y hace una llamada a servicios web de BPM pasándole el usuario de Liferay y una key_bd para indicar el data source que tiene que utilizar. Si no tenemos HTTPS podemos encriptar los datos. 3. Paso 3: En la base de datos del BPM recibimos el usuario de Liferay (ej: aperez@liferay.com), generamos un ticket (por ejemplo con MD5) y guardamos en una tabla el usuario de bpm, el usuario de liferay y el ticket generado (puede tener fecha de caducidad). 4. Paso 4: El ticket es devuelto a Liferay y guardado en una variable de sesión. Mientras Liferay no pierda la sesión el ticket será valido pero en el momento en que se pierde la sesión Liferay te obliga a conectarte con lo que se repiten los pasos 1, 2 y Paso 5: El usuario ya está dentro de Liferay y navega hasta la página donde está el portlet de buzón de BPM, el portlet realiza una petición de datos utilizando el ticket generado, la petición llega a la BBDD y valida que el ticket es correcto para servir los datos. Nota: Todas las soluciones anteriores habría que revisarlas con Neoris para ver cuál es la mejor solución y con menor coste de desarrollo para ambas partes. Página 5 de 15

7 2. Portlet de Bandeja de Entrada Actualmente se dispone de un portlet de bandeja de tareas con las siguientes características: Campos a visualizar: campos genéricos (código y descripción del proyecto, fecha y usuario de creación, fecha fin, tarea stop y proyecto padre). Filtros que se aplican: se muestran los proyectos en estado En elaboración y responsabilidad Mis Tareas de todas las unidades de negocio. La empresa de trabajo es siempre una definida en el momento de configuración del portlet. Al pulsar sobre el código de un proyecto se abre la pantalla de gestión del proceso BPM. RECOMENDACIÓN: se recomienda subir la versión de Expert BPM para tener disponible la nueva vista de formularios: aspecto más moderno, usable y en la línea del entorno Liferay. Datadec instalará en el entorno de pruebas la última versión y realizará una certificación básica. Grupo Norte certificará sobre este entorno y cuando de su conformidad se actualizará el entorno de producción. Página 6 de 15

8 IMPORTANTE A TENER EN CUENTA POR PARTE DEL CLIENTE: actualmente BPM no está visible como dirección pública por lo que no se puede acceder a través de internet. Será necesario hacer público BPM para que las pantallas del formulario puedan abrirse por parte de clientes y proveedores que accederán sin utilizar VPN Selección de Empresa Se detecta la necesidad de seleccionar la empresa de la cual se quieren consultar los proyectos. Para ello tendremos dos opciones de implementación de las que el cliente deberá elegir la que más se le ajusta a sus necesidades Fijar empresa en la configuración del portlet Esta opción sería útil en el caso de que se quisiera hacer sites diferentes por empresa y en cada uno de ellos quisiéramos tener el portlet de la bandeja de la empresa en cuestión. En este caso la empresa de la cual se consultan los proyectos se configurará cuando se añada el portlet en la página o bien cambiando la configuración de la página editando los controles. Página 7 de 15

9 Al editar la configuración del portlet aparecería un diálogo donde indicar los parámetros de configuración. Las empresas que podrá configurar son todas aquellas que están aprovisionadas en BPM Filtro de empresas En este caso, solo se incluye un único punto con el portlet de la bandeja de tareas y será el usuario quien decida la empresa que quiere ver mediante un selector. En la cabecera del portlet se mostrará por defecto la empresa con la que entraría a BPM por defecto. Pulsando sobre el icono se desplegará una lista de empresas a l Página 8 de 15

10 2.2. Selección de Estado y Responsabilidad Esta opción permitirá ver otros estados diferentes al estado En Elaboración y otra responsabilidad diferente a Mis Tareas que es lo que ofrece el portlet básico. Se ampliará el portlet con una sección para seleccionar tanto el estado como la responsabilidad: Se dispondrá de un selector de estados (todos los configurados como visibles en BPM en la bandeja). Por defecto se cargará con la opción En Ejecución. Asociado al estado se mostrarán las opciones de responsabilidad. Por defecto se seleccionará la opción Mis tareas, pero el usuario podrá marcar las opciones Mis Proyectos o Todos. Al marcar una opción, se desmarcará la seleccionada anteriormente. Página 9 de 15

11 2.3. Selección de Unidades de Negocio, grupo y subgrupo Establecer Nivel UN-Grupo-Subgrupo en configuración Esta opción sería interesante en el caso de que se desarrollen sites con gestiones concretas que estén relacionadas con un único grupo o subgrupo de procesos. En este caso se necesitaría incluir el portlet de la bandeja configurando que se vean solo los proyectos de una serie de UN-Grupo-Subgrupos específicos. Para este caso, se ampliarán las opciones de configuración del portlet para que permita seleccionar que UN-Grupo-Subgrupos son los que se muestran en la bandeja. Dado que estos datos dependen de la empresa, será un detalle a configurar una vez la empresa ya esté indicada. Se podrá seleccionar uno o varios valores de cualquier nivel del árbol de proyectos. Se podrán utilizar las flechas de selección o bien con doble click asignar y desasignar Selector de Nivel UN-Grupo-Subgrupo en configuración En el caso de se quiera dar al usuario un portlet común para cualquier tipo de gestión, se podrá llegar a necesitar que el usuario pueda seleccionar el nivel del árbol que quiere consultar. Página 10 de 15

12 Para ello se añadirá un acceso a través del icono de UN-Grupo- Subgrupo. para abrir la capa de selección Las UN, grupos y subgrupos entre los que seleccionar serán aquellos a los que el usuario tenga acceso en BPM. La dinámica sería la misma que en el punto anterior para seleccionar niveles a visualizar Campos a Visualizar En el portlet básico se están mostrando los campos genéricos que tiene BPM (código de proyecto, descripción, fecha de creación, usuario creación, tarea stop y proyecto padre). Se detecta la necesidad de poder ampliar estos campos para que muestre los campos específicos asociados al nivel/es que estemos visualizando. Por tanto, este sería un punto a añadir una vez podemos seleccionar los niveles del árbol de proyectos. Los campos que se visualizarían serían aquellos marcados como visibles en el nivel nivel que estemos mostrando. En el caso de visualizar varios subgrupos o grupos de proyectos, se mostrarán los campos específicos de todos los grupos o subgrupos seleccionados. Página 11 de 15

13 2.5. Filtros Por último se propone la mejora de poder utilizar filtros por las columnas visibles en el momento más la opción de buscar por cualquier columna. Todos los filtros ejecutarán la búsqueda con la opción contiene el texto indicado. 3. Portlet para creación de nuevos proyectos El portlet mostrará un icono para crear que al pulsar listará los proyectos que el usuario puede crear en cualquier empresa. El listado de proyectos podrá ser filtrado para restringir el resultado de posibles tipos de proyectos a crear. Se mostrarán las empresas a las que el usuario tiene acceso y los proyectos que él puede crear. Página 12 de 15

14 Al pulsar sobre una opción concreta, se abrirá en una nueva ventana la pantalla de creación del proyecto de BPM del tipo seleccionado. IMPORTANTE A TENER EN CUENTA POR PARTE DEL CLIENTE: actualmente BPM no está visible como dirección pública por lo que no se puede acceder a través de internet. Será necesario hacer público BPM para que las pantallas del formulario puedan abrirse por parte de clientes y proveedores que accederán sin utilizar VPN Predefinir Empresa en la que se permite crear Para el caso en que se realicen sites específicas por empresa, se necesitará restringir la empresa en la que voy a permitir crear proyecto. Para ello, el administrador de la web, cuando inserte el portlet en la página, podrá configurar la empresa de la cual se obtendrá el listado de proyectos que puedo crear. La forma de configuración será la misma que la indicada en el punto Predefinir Nivel en el que Permito Crear Para el caso en que se realicen sites específicas por tipo de gestión, se necesitará restringir UN-Grupos y Subgrupos de los que voy a permitir crear proyecto. Para ello, el administrador de la web, cuando inserte el portlet en la página, podrá configurar la empresa, UN-Grupo y Subgrupo del que permito crear proyectos. La forma de configuración será la misma que la indicada en el punto Página 13 de 15

15 Condiciones Generales: Consultoría Análisis Desarrollos Documentación Juegos de prueba unitarios de Datadec Instalación Juego de pruebas de aceptación con el cliente Formación Migración / carga masiva de datos Puesta en marcha Nuevos requisitos y funcionalidad no contemplados en el presente análisis Gastos de viaje y desplazamientos Periodo de garantía de 6 meses (*) Servicios Incluidos Servicios No Incluidos Notas: Servicios realizados fuera de horario laboral de Datadec tendrán un incremento del 50% (*) finalizado el periodo de garantía se procederá al incremento de Mantenimiento Anual de las Adaptaciones, el cual será calculado según % indicado en Contrato y aplicado sobre la base de adaptaciones obtenida como el 15% del importe bruto de las mismas. Página 14 de 15